Magick::Montage 類別

蒙太奇是由縮圖組成的單一影像，這些縮圖以均勻的網格排列。蒙太奇影像的大小由個別縮圖的大小以及網格中的行數和列數決定。

下圖顯示了一個蒙太奇，它由三列和兩行縮圖組成，呈現在灰色背景上

蒙太奇可以是「純色」（未裝飾的縮圖）或「框架」（裝飾的縮圖）。為了更容易理解提供給 MontageImages() 的選項，蒙太奇選項由兩個不同的類別提供：Magick::Montage 和 Magick::MontageFramed。

純色蒙太奇

Magick::Montage 是提供蒙太奇選項的基類，並提供設定渲染簡單（未框架）蒙太奇所需的所有選項的方法。如果您想建立框架蒙太奇，請參閱 Magick::MontageFramed。

未框架的縮圖由四個部分組成：縮圖影像、縮圖邊框、可選的縮圖陰影和可選的縮圖標籤區域。

蒙太奇方法

方法	回傳類型	簽章	說明
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 方法」表格中顯示的方法。

框架縮圖由四個部分組成：縮圖影像、縮圖框架、縮圖邊框、可選的縮圖陰影和可選的縮圖標籤區域。

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