ImageMagick – 向量圖形 - ImageMagick 圖像庫

MVG 概述 • 繪圖基元

本規格定義了 Magick 向量圖形 (MVG) 的功能和語法，這是一種用於在 ImageMagick 中描述二維向量和混合向量/點陣圖形的模組化語言。您可以使用該語言從命令列、MVG 檔案、SVG - 可縮放向量圖形檔案或 ImageMagick 程式介面中的一個進行繪製。例如，使用以下命令來繪製弧形

magick -size 100x60 canvas:skyblue -fill white -stroke black \
  -draw "path 'M 30,40  A 30,20  20  0,0 70,20 A 30,20  20  1,0 30,40 Z '" \
  arc.png

結果如下

當繪圖變得足夠複雜時，我們建議您將圖形基元組裝到 MVG 檔案中。對於我們的範例，我們使用 piechart.mvg

push graphic-context
  viewbox 0 0 624 369
  affine 0.283636 0 0 0.283846 -0 -0
  push graphic-context
    push graphic-context
      fill 'darkslateblue'
      stroke 'blue'
      stroke-width 1
      rectangle 1,1 2199,1299
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 600,1100 'Average: 20.0'
    pop graphic-context
    push graphic-context
      fill 'red'
      stroke 'black'
      stroke-width 5
      path 'M700.0,600.0 L340.0,600.0 A360.0,360.0 0 0,1 408.1452123287954,389.2376150414973 z'
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 1400,140 'MagickWand for PHP'
    pop graphic-context
    push graphic-context
      font-size 30
      fill 'white'
      stroke-width 1
      text 1800,140 '(10.0%)'
    pop graphic-context
    push graphic-context
      fill 'red'
      stroke 'black'
      stroke-width 4
      rectangle 1330,100 1370,140
    pop graphic-context
    push graphic-context
      fill 'yellow'
      stroke 'black'
      stroke-width 5
      path 'M700.0,600.0 L408.1452123287954,389.2376150414973 A360.0,360.0 0 0,1 976.5894480359858,369.56936567559273 z'
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 1400,220 'MagickCore'
    pop graphic-context
    push graphic-context
      font-size 30
      fill 'white'
      stroke-width 1
      text 1800,220 '(29.0%)'
    pop graphic-context
    push graphic-context
      fill 'yellow'
      stroke 'black'
      stroke-width 4
      rectangle 1330,180 1370,220
    pop graphic-context
    push graphic-context
      fill 'fuchsia'
      stroke 'black'
      stroke-width 5
      path 'M700.0,600.0 L976.5894480359858,369.56936567559273 A360.0,360.0 0 0,1 964.2680466142854,844.4634932636567 z'
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 1400,300 'MagickWand'
    pop graphic-context
    push graphic-context
      font-size 30
      fill 'white'
      stroke-width 1
      text 1800,300 '(22.9%)'
    pop graphic-context
    push graphic-context
      fill 'fuchsia'
      stroke 'black'
      stroke-width 4
      rectangle 1330,260 1370,300
    pop graphic-context
    push graphic-context
      fill 'blue'
      stroke 'black'
      stroke-width 5
      path 'M700.0,600.0 L964.2680466142854,844.4634932636567 A360.0,360.0 0 0,1 757.853099990584,955.3210081341651 z'
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 1400,380 'JMagick'
    pop graphic-context
    push graphic-context
      font-size 30
      fill 'white'
      stroke-width 1
      text 1800,380 '(10.6%)'
    pop graphic-context
    push graphic-context
      fill 'blue'
      stroke 'black'
      stroke-width 4
      rectangle 1330,340 1370,380
    pop graphic-context
    push graphic-context
      fill 'lime'
      stroke 'black'
      stroke-width 5
      path 'M700.0,600.0 L757.853099990584,955.3210081341651 A360.0,360.0 0 0,1 340.0,600.0 z'
    pop graphic-context
    push graphic-context
      font-size 40
      fill 'white'
      stroke-width 1
      text 1400,460 'Magick++'
    pop graphic-context
    push graphic-context
      font-size 30
      fill 'white'
      stroke-width 1
      text 1800,460 '(27.5%)'
    pop graphic-context
    push graphic-context
      fill 'lime'
      stroke 'black'
      stroke-width 4
      rectangle 1330,420 1370,460
    pop graphic-context
    push graphic-context
      font-size 100
      fill 'white'
      stroke-width 1
      text 100,150 'ImageMagick'
    pop graphic-context
    push graphic-context
      fill 'none'
      stroke 'black'
      stroke-width 5
      circle 700,600 700,960
    pop graphic-context
  pop graphic-context
pop graphic-context

使用以下命令繪製圓餅圖

magick mvg:piechart.mvg piechart.png

產生以下渲染結果

但是，一般來說，MVG 使用起來相當困難，您可能希望使用程式以 SVG 格式生成圖形。 ImageMagick 會自動將 SVG 轉換為 MVG 並渲染您的影像，例如，我們使用以下命令渲染 piechart.svg

magick mvg:piechart.svg piechart.jpg

產生與我們使用 MVG 語言建立的圓餅圖相同的結果。

繪圖功能也可以從許多 ImageMagick 程式介面中使用。 ImageMagick 會將繪圖 API 呼叫轉換為 MVG 並進行渲染。以下是用 MagickWand 語言編寫的範例程式碼

(void) PushDrawingWand(draw_wand);
{
  const PointInfo points[6] =
  {
    { 180,504 },
    { 282.7,578.6 },
    { 243.5,699.4 },
    { 116.5,699.4 },
    { 77.26,578.6 },
    { 180,504 }
  };

  DrawSetStrokeAntialias(draw_wand,True);
  DrawSetStrokeWidth(draw_wand,9);
  DrawSetStrokeLineCap(draw_wand,RoundCap);
  DrawSetStrokeLineJoin(draw_wand,RoundJoin);
  (void) DrawSetStrokeDashArray(draw_wand,0,(const double *)NULL);
  (void) PixelSetColor(color,"#4000c2");
  DrawSetStrokeColor(draw_wand,color);
  DrawSetFillRule(draw_wand,EvenOddRule);
  (void) PixelSetColor(color,"#800000");
  DrawSetFillColor(draw_wand,color);
  DrawPolygon(draw_wand,6,points);
}
(void) PopDrawingWand(draw_wand);

MVG 概述

MVG 會忽略命令之間的所有空白字元。這允許每行使用多個 MVG 命令。通常的做法是在每個 MVG 命令後加上換行符號，以使 MVG 更易於編輯和閱讀。此語法說明在 MVG 序列中使用縮排以幫助理解。支援縮排，但並非必要。

圖元檔包裝器語法（支援獨立 MVG 檔案）

push graphic-context
  viewbox 0 0 width height
  [ any other MVG commands ]
pop graphic-context

圖樣語法（儲存和還原上下文）

push pattern id x,y width,height
 push graphic-context
  [ drawing commands ]
 pop graphic-context
pop pattern

範例如下（%s 是識別字串）

push defs
 push pattern %s 10,10 20,20
  push graphic-context
   fill red
   rectangle 5,5 15,15
  pop graphic-context
  push graphic-context
   fill green
   rectangle 10,10 20,20
  pop graphic-context
 pop pattern
pop defs

對於影像平鋪，請使用

push pattern id x,y width,height
 image Copy ...
pop pattern

請注意，您可以將圖樣用於填滿或筆觸，例如

stroke url(#%s)

或

fill url(#%s)

剪裁路徑定義了一個剪裁區域，只有包含在其中的區域才會被繪製。剪裁區域外的區域將被遮罩。

push defs
 push clip-path "myClipPath"
  push graphic-context
   rectangle 10,10 20,20
  pop graphic-context
 pop clip-path
pop defs
clip-path url(#myClipPath)

繪圖基元

以下是 MVG 繪圖基元的完整說明

基元

說明

affine s_x,r_x,r_y,s_y,t_x,t_y

arc x₀,y₀ x₁,y₁ a₀,a₁

bezier x₀,y₀ ... x_n,y_n

貝茲曲線（樣條曲線）需要三個或更多個 x,y 座標來定義其形狀。第一個和最後一個點是節點（保留的座標），任何中間座標都是控制點。如果指定了兩個控制點，則每個端點和其依次對應的控制點之間的線條決定了曲線在該端點的切線方向。如果指定了一個控制點，則從端點到該控制點的線條決定了曲線在兩端的切線方向。如果指定了兩個以上的控制點，則額外的控制點將共同作用以決定曲線的中間形狀。為了繪製複雜的曲線，強烈建議使用 Path 基元或繪製多個四點貝茲曲線段，並重複每個連續段的起始和結束節點。

border-color 顏色

circle 圓心_x,圓心_y 周長_x,周長_y

clip-path url(名稱)

clip-rule 規則

從以下規則類型中選擇

evenodd
nonzero

clip-units 單位

從這些單位類型中選擇

userSpace
userSpaceOnUse
objectBoundingBox

color x,y 方法

從這些方法類型中選擇

point
replace
floodfill
filltoborder
reset

compliance 類型

從這些合規性類型中選擇：MVG 或 SVG

decorate 類型

從這些裝飾類型中選擇

none
line-through
overline
underline

ellipse 中心點_x,中心點_y 半徑_x,半徑_y 弧形_起始,弧形_終止

fill 顏色

從任何這些顏色中選擇。

fill-opacity 透明度

透明度範圍從 0.0（完全透明）到 1.0（完全不透明）或以百分比表示（例如 50%）。

fill-rule 規則

從以下規則類型中選擇

evenodd
nonzero

font 名稱

font-family 字體

font-size 點數

font-stretch 類型

從這些拉伸類型中選擇

all
normal
ultra-condensed
extra-condensed
condensed
semi-condensed
semi-expanded
expanded
extra-expanded
ultra-expanded

font-style 樣式

從這些樣式中選擇

all
normal
italic
oblique

font-weight 粗細

從這些粗細中選擇

all
normal
bold
100
200
300
400
500
600
700
800
900

gradient-units 單位

從這些單位中選擇

userSpace
userSpaceOnUse
objectBoundingBox

gravity 類型

從這些重力類型中選擇

NorthWest
North
NorthEast
West
Center
East
SouthWest
South
SouthEast

image compose x,y 寬度,高度 '檔案名稱'

從這些合成操作中選擇

方法	說明
clear	目標的顏色和 Alpha 值都將被清除。來源和目標都不會被用作輸入。
src	來源將被複製到目標。目標不會被用作輸入。
dst	目標將保持不變。
src-over	來源將被合成在目標之上。
dst-over	目標將被合成在來源之上，結果將替換目標。
src-in	來源中位於目標內部的部分將替換目標。
dst-in	目標中位於來源內部的部分將替換目標。
src-out	來源中位於目標外部的部分將替換目標。
dst-out	目標中位於來源外部的部分將替換目標。
src-atop	來源中位於目標內部的部分將被合成到目標上。
dst-atop	目標中位於來源內部的部分將被合成在來源之上，並替換目標。
multiply	來源將與目標相乘並替換目標。結果顏色始終至少與兩種成分顏色中較暗的一種一樣暗。任何顏色與黑色相乘都會產生黑色。任何顏色與白色相乘都將保持原始顏色不變。
screen	來源和目標將進行互補，然後相乘，並替換目標。結果顏色始終至少與兩種成分顏色中較亮的一種一樣亮。任何顏色與白色進行屏幕混合都會產生白色。任何顏色與黑色進行屏幕混合都將保持原始顏色不變。
overlay	根據目標顏色，對顏色進行相乘或屏幕混合。來源顏色會覆蓋目標，同時保留其高光和陰影。目標顏色不會被替換，而是與來源顏色混合以反映目標的亮度或暗度。
darken	選取目標和來源顏色中較暗的顏色。當來源顏色較暗時，目標顏色將被替換為來源顏色，否則將保持不變。
lighten（變亮）	選取目標和來源顏色中較亮的顏色。當來源顏色較亮時，目標顏色將被替換為來源顏色，否則將保持不變。
linear-light（線性光）	稍微增加對比度，影響前景的色調值。
color-dodge（色彩增亮）	增亮目標顏色以反映來源顏色。使用黑色繪製不會產生任何變化。
color-burn（色彩加深）	加深目標顏色以反映來源顏色。使用白色繪製不會產生任何變化。
hard-light（強光）	根據來源顏色值，將顏色相乘或相加。如果來源顏色亮於 0.5，則目標顏色會變亮，如同被加亮。如果來源顏色暗於 0.5，則目標顏色會變暗，如同被相乘。變亮或變暗的程度與來源顏色和 0.5 之差成正比。如果等於 0.5，則目標顏色保持不變。使用純黑色或純白色繪製會產生黑色或白色。
soft-light（柔光）	根據來源顏色值，將顏色變暗或變亮。如果來源顏色亮於 0.5，則目標顏色會變亮。如果來源顏色暗於 0.5，則目標顏色會變暗，如同被加深。變暗或變亮的程度與來源顏色和 0.5 之差成正比。如果等於 0.5，則目標顏色保持不變。使用純黑色或純白色繪製會產生明顯的暗區或亮區，但不會產生純黑色或純白色。
plus（相加）	將來源顏色添加到目標顏色，並替換目標顏色。此運算子適用於製作兩個影像之間的溶解動畫。
add（添加）	與「plus」相同，但透明度資料會被視為遮罩值。因此，任何一張影像中的透明區域都會保持透明。
minus（相減）	從目標影像中減去來源影像的顏色。當涉及透明度時，將從任何目標不透明區域中減去不透明區域。
subtract（減去）	從目標影像中減去來源影像的顏色。當涉及透明度時，將減去透明區域，因此只有來源中的不透明區域在目標影像中保持不透明。
difference（差異）	從較亮的顏色中減去兩種構成顏色中較暗的顏色。使用白色繪製會反轉目標顏色。使用黑色繪製不會產生任何變化。
exclusion（排除）	產生類似於「difference」的效果，但對比度較低。使用白色繪製會反轉目標顏色。使用黑色繪製不會產生任何變化。
xor（互斥或）	將來源中位於目標外部的部分與目標中位於來源外部的部分組合起來。
copy-*（複製-）	將來源影像中的指定通道複製到目標影像中的相同通道。如果來源影像中指定的通道不存在（這只會發生在「`copy-opacity`」或「`copy-black`」方法中），則假設來源影像是要複製值的特殊灰階通道影像。
change-mask（更改遮罩）	將任何與來源影像像素相似的目標像素（由目前的 -fuzz 因數定義）替換為透明。

interline-spacing 像素

interword-spacing 像素

kerning 像素

line x,y x₁,y₁

matte x,y 方法

從這些方法中選擇

point
replace
floodfill
filltoborder
reset

offset 偏移

opacity 不透明度

使用百分比（例如 50%）。

path 路徑

point x,y

polygon x,y x₁,y₁, ..., x_n,y_n

polyline x,y x₁,y₁, ..., x_n,y_n

pop clip-path

pop defs

pop gradient

pop graphic-context

pop pattern

push clip-path "name"

push defs

push gradient id linear x,y x₁,y₁

push gradient id radial x_c,c_y x_f,y_f radius

push graphic-context { "id" }

id 是可選的

push pattern id x,y width,height

rectangle x,y x₁,y₁

rotate angle

roundrectangle x,y x₁,y₁ width,height

scale x,y

skewX angle

stop-color color offset

stroke color

stroke-antialias 0 • 1

stroke-dasharray none • numeric-list

stroke-dashoffset offset

stroke-linecap type

從這些線帽類型中選擇

butt
round
square

stroke-linejoin type

從這些連接類型中選擇

bevel
miter
round

stroke-miterlimit limit

stroke-opacity opacity

透明度範圍從 0.0（完全透明）到 1.0（完全不透明）或以百分比表示（例如 50%）。

stroke-width width

text "text"

text-antialias 0 • 1

text-undercolor color

translate x,y

use "url(#id)"

viewbox x,y x₁,y₁

注意，這些基本指令是區分大小寫的，例如，使用 viewbox，而不是 viewBox。