Magick::Montage クラス

モンタージュとは、均一なグリッドに配置されたサムネイル画像で構成される単一の画像です。モンタージュ画像のサイズは、個々のサムネイルのサイズとグリッドの行と列の数によって決まります。

次の図は、灰色の背景にレンダリングされた、3列2行のサムネイルで構成されるモンタージュを示しています。

モンタージュは、「プレーン」（装飾のないサムネイル）または「フレーム付き」（装飾されたサムネイル）のいずれかです。 `MontageImages()` に渡されるオプションをより理解しやすくするために、モンタージュオプションは2つの異なるクラスによって提供されます: `Magick::Montage` と `Magick::MontageFramed`。

プレーンモンタージュ

`Magick::Montage` は、モンタージュオプションを提供するための基本クラスであり、単純な（フレームなしの）モンタージュをレンダリングするために必要なすべてのオプションを設定するためのメソッドを提供します。フレーム付きモンタージュを作成する場合は、`Magick::MontageFramed` を参照してください。

フレームなしのサムネイルは、4つのコンポーネントで構成されます。サムネイル画像、サムネイルの境界線、オプションのサムネイルの影、およびオプションのサムネイルラベル領域です。

モンタージュメソッド

メソッド	戻り値の型	シグネチャ	説明
Montage		void	デフォルトコンストラクタ
backgroundColor	void	const Color &backgroundColor_	サムネイルが描画される背景色を指定します。
	Color	void
compose	void	CompositeOperator compose_	サムネイルの画像合成アルゴリズムを指定します。これは、サムネイル画像を背景に配置する方法を制御するアルゴリズムです。透明度を持つ画像には、OverCompositeOpの使用をお勧めします。このオプションは、透明度のない画像に対しては負の副作用をもたらす可能性があります。
	CompositeOperator	void
fileName	void	std::string fileName_	生成されたモンタージュ画像に使用される画像ファイル名を指定します。複数のモンタージュ画像が生成される場合を処理するために、ファイル名に `printf` スタイルのフォーマットを埋め込むことができます。たとえば、ファイル名の指定が image%02d.miff の場合、モンタージュ画像は image00.miff、image01.miff などと名前が付けられます。
	std::string	void
fill	void	const Color &pen_	ラベルテキストに使用される塗りつぶしの色を指定します。
	Color	void
font	void	std::string font_	サムネイルラベルのフォントを指定します。
	std::string	void
geometry	void	const Geometry &geometry_	生成されるサムネイルのサイズを指定します。
	Geometry	void
gravity	void	GravityType gravity_	指定されたジオメトリ領域内でのサムネイルの位置を指定します。サムネイルがいずれかの次元でジオメトリよりも小さい場合、この指定に従って配置されます。
	GravityType	void
label	void	std::string label_	画像ラベルに使用される形式を指定します。 特殊なフォーマット文字 をフォーマット文字列に埋め込んで、画像に関する情報を含めることができます。
	std::string	void
penColor	void	const Color &pen_	ラベルテキストに使用されるペンの色を指定します（`fill` と同じ）。
	Color	void
pointSize	void	size_t pointSize_	サムネイルラベルのフォントサイズを指定します。
	size_t	void
shadow	void	bool shadow_	サムネイルのドロップシャドウを有効/無効にします。
	bool	void
stroke	void	const Color &pen_	ラベルテキストに使用されるストロークの色を指定します。
	Color	void
texture	void	std::string texture_	モンタージュの背景として使用するテクスチャ画像を指定します。組み込みテクスチャ「granite」と「plasma」が利用可能です。テクスチャは背景画像と同じです。
	std::string	void
tile	void	const Geometry &tile_	モンタージュの最大列数と行数を指定します。モンタージュは、次の行に進む前に、行のすべてのセルを埋め尽くすことによって構築されます。モンタージュが最大列数と行数に達すると、新しいモンタージュ画像が開始されます。
	Geometry	void
transparentColor	void	const Color &transparentColor_	透明に設定するモンタージュの色を指定します。サムネイルがHTMLページにレンダリングされたときに背景なしで表示されるように、このオプションを背景色と同じに設定できます。最適な効果を得るには、選択した透明色がレンダリングされたサムネイルの色に出現しないようにしてください。
	Color	void

フレーム付きモンタージュ

`Magick::MontageFramed` は、画像サムネイルの周囲に装飾的なフレームを配置する場合に、モンタージュオプションを指定する手段を提供します。 `MontageFramed` は `Montage` から継承しているため、`Montage` のすべてのメソッドと、「MontageFramed メソッド」テーブルに示されているメソッドを提供します。

フレーム付きサムネイルは、4つのコンポーネントで構成されます。サムネイル画像、サムネイルフレーム、サムネイルの境界線、オプションのサムネイルの影、およびオプションのサムネイルラベル領域です。

MontageFramed メソッド

メソッド	戻り値の型	シグネチャ	説明
MontageFramed		void	デフォルトコンストラクタ（`frameGeometry` を介してフレームを有効にする）。
borderColor	void	const Color &borderColor_	サムネイルフレーム内の背景色を指定します。
	Color	void
borderWidth	void	size_t borderWidth_	サムネイルとその周囲のフレームの間に配置する境界線（ピクセル単位）を指定します。このオプションは、サムネイルフレームが有効になっている（`frameGeometry` を介して）場合にのみ有効になり、サムネイルジオメトリの指定でサムネイルの境界線の幅も指定されていない場合に有効になります。
	size_t	void
frameGeometry	void	const Geometry &frame_	サムネイルの周囲に配置するフレームのジオメトリ仕様を指定します。このパラメータが指定されていない場合、モンタージュはフレームなしになります。
	Geometry	void
matteColor	void	const Color &matteColor_	サムネイルフレームの色を指定します。
	Color	void