ImageMagick 日本語ドキュメント
⚠️ これは 非公式の翻訳サイトです。ImageMagick Studio LLC とは無関係です。正確な情報は 原文（https://imagemagick.org/magick-vector-graphics/） を参照してください。

Magick ベクターグラフィックス

MVG 概要 • 描画プリミティブ

この仕様は、ImageMagick で 2 次元ベクターおよびベクター/ラスター混在グラフィックスを記述するためのモジュール化された言語、Magick Vector Graphics（MVG）の機能と構文を定義します。この言語を使って、コマンドラインから、MVG ファイルから、SVG（Scalable Vector Graphics）ファイルから、または ImageMagick のプログラムインターフェースの 1 つから描画できます。たとえば、弧を描画するには次のコマンドを使います:

$ 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

結果は次のとおりです:

arc

描画が十分に複雑になったら、グラフィックプリミティブを 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

これは次のレンダリングを生成します:

piechart

ただし一般に、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 はコマンド間のすべての空白を無視します。これにより 1 行に複数の 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

なお、パターンは次のように fill または stroke のどちらにも使えます:

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 sx,rx,ry,sy,tx,ty
arc x0,y0 x1,y1 a0,a1
bezier x0,y0 ... xn,yn Bezier（スプライン）は、形状を定義するのに 3 つ以上の x,y 座標を必要とする。最初と最後の点はノット（保持される座標）で、中間の座標は制御点。制御点が 2 つ指定されると、各端ノットとそれに順に対応する制御点の間の線が、その端での曲線の接線方向を決める。制御点が 1 つなら、端ノットからその 1 つの制御点への線が各端の接線方向を決める。制御点が 2 つを超えると、追加の制御点が組み合わさって曲線の中間形状を決める。複雑な曲線を描くには、Path プリミティブを使うか、各連続セグメントの開始・終了ノットを繰り返した複数の 4 点ベジエセグメントを描くことを強く推奨する。
border-color color
circle originx,originy perimeterx,perimetery
clip-path url(name)
clip-rule rule 次のルールタイプから選ぶ:
evenodd
nonzero
clip-units units 次の単位タイプから選ぶ:
userSpace
userSpaceOnUse
objectBoundingBox
color x,y method 次のメソッドタイプから選ぶ:
point
replace
floodfill
filltoborder
reset
compliance type 次の準拠タイプから選ぶ: MVG または SVG
decorate type 次の装飾タイプから選ぶ:
none
line-through
overline
underline
ellipse centerx,centery radiusx,radiusy arcstart,arcstop
fill color これらの色のいずれかから選ぶ。
fill-opacity opacity 不透明度は 0.0（完全透明）〜1.0（完全不透明）、またはパーセント（例: 50%）。
fill-rule rule 次のルールタイプから選ぶ:
evenodd
nonzero
font name
font-family family
font-size point-size
font-stretch type 次のストレッチタイプから選ぶ:
all
normal
ultra-condensed
extra-condensed
condensed
semi-condensed
semi-expanded
expanded
extra-expanded
ultra-expanded
font-style style 次のスタイルから選ぶ:
all
normal
italic
oblique
font-weight weight 次のウェイトから選ぶ:
all
normal
bold
100
200
300
400
500
600
700
800
900
gradient-units units 次の単位から選ぶ:
userSpace
userSpaceOnUse
objectBoundingBox
gravity type 次の gravity タイプから選ぶ:
NorthWest
North
NorthEast
West
Center
East
SouthWest
South
SouthEast
image compose x,y width,height 'filename' 次の合成操作から選ぶ:
メソッド説明
clear出力先の色とアルファの両方がクリアされる。ソースも出力先も入力として使われない。
srcソースが出力先にコピーされる。出力先は入力として使われない。
dst出力先は手つかずのまま。
src-over ソースが出力先の上に合成される。
dst-over出力先がソースの上に合成され、結果が出力先を置き換える。
src-in出力先の内側にあるソースの部分が出力先を置き換える。
dst-inソースの内側にある出力先の部分が出力先を置き換える。
src-out出力先の外側にあるソースの部分が出力先を置き換える。
dst-outソースの外側にある出力先の部分が出力先を置き換える。
src-atop出力先の内側にあるソースの部分が出力先に合成される。
dst-atopソースの内側にある出力先の部分がソースの上に合成され、出力先を置き換える。
multiplyソースが出力先で乗算され、出力先を置き換える。結果の色は常に 2 つの構成色のいずれよりも暗い。任意の色と黒の乗算は黒を生む。任意の色と白の乗算は元の色を変えない。
screenソースと出力先が補色化されてから乗算され、出力先を置き換える。結果の色は常に 2 つの構成色のいずれよりも明るい。任意の色と白のスクリーンは白を生む。任意の色と黒のスクリーンは元の色を変えない。
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ソースが出力先に加算され、出力先を置き換える。この演算子は 2 つの画像間のディゾルブをアニメーションするのに有用。
add'plus' と同様だが透明度データはマット値として扱われる。そのためどちらかの画像の透明領域は透明のまま残る。
minusソース画像の色を出力先画像から減算する。透明度が関わる場合、不透明領域が出力先の不透明領域から減算される。
subtractソース画像の色を出力先画像から減算する。透明度が関わる場合、透明領域が減算され、ソースの不透明領域のみが出力先で不透明のまま残る。
difference2 つの構成色のうち暗い方を明るい方から減算する。白で塗ると出力先の色が反転する。黒で塗っても変化なし。
exclusion'difference' に似た効果だが、より低コントラストに見える。白で塗ると出力先の色が反転する。黒で塗っても変化なし。
xor出力先の外側にあるソースの部分と、ソースの外側にある出力先の部分が結合される。
copy-*ソース画像の指定チャンネルを出力先画像の同じチャンネルにコピーする。ソース画像に指定チャンネルが存在しない場合（'copy-opacity' か 'copy-black' でのみ起こりうる）、ソース画像はコピーする値の特別なグレースケールチャンネル画像と仮定される。
change-maskソース画像のピクセルに（現在の -fuzz 係数で定義される）似た出力先ピクセルを、透明で置き換える。
interline-spacing pixels
interword-spacing pixels
kerning pixels
line x,y x1,y1
matte x,y method 次のメソッドから選ぶ:
point
replace
floodfill
filltoborder
reset
offset offset
opacity opacity パーセントを使う（例: 50%）。
path path
point x,y
polygon x,y x1,y1, ..., xn,yn
polyline x,y x1,y1, ..., xn,yn
pop clip-path
pop defs
pop gradient
pop graphic-context
pop pattern
push clip-path "name"
push defs
push gradient id linear x,y x1,y1
push gradient id radial xc,cy xf,yf radius
push graphic-context { "id" } id は任意
push pattern id x,y width,height
rectangle x,y x1,y1
rotate angle
roundrectangle x,y x1,y1 width,height
scale x,y
skewX angle
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 x1,y1

なお、プリミティブは大文字小文字を区別します。たとえば viewBox ではなく viewbox を使ってください。

原文: https://imagemagick.org/magick-vector-graphics/