Magick::Montage 类

拼接是一个单一的图像，由以均匀网格排列的缩略图组成。拼接图像的大小由单个缩略图的大小以及网格中的行数和列数决定。

以下插图显示了一个拼接，它包含三列两行的缩略图，渲染在灰色背景上

拼接可以是 "plain"（未装饰的缩略图）或 "framed"（装饰的缩略图）。为了更容易理解提供给 MontageImages() 的选项，拼接选项由两个不同的类提供：Magick::Montage 和 Magick::MontageFramed.

普通拼接

Magick::Montage 是提供拼接选项的基类，并提供设置渲染简单（无框）拼接所需所有选项的方法。如果您想创建有框拼接，请参阅 Magick::MontageFramed.

无框缩略图由四个部分组成：缩略图图像、缩略图边框、可选的缩略图阴影和可选的缩略图标签区域。

拼接方法

方法	返回类型	签名	描述
拼接		void	默认构造函数
backgroundColor	void	const Color &backgroundColor_	指定缩略图所处的背景颜色。
	颜色	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_	指定用于标签文本的填充颜色。
	颜色	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 相同）。
	颜色	void
pointSize	void	size_t pointSize_	指定缩略图标签字号。
	size_t	void
shadow	void	bool shadow_	启用/禁用缩略图上的投影。
	bool	void
stroke	void	const Color &pen_	指定用于标签文本的描边颜色。
	颜色	void
texture	void	std::string texture_	指定用作拼接背景的纹理图像。内置纹理 "granite" 和 "plasma" 可用。纹理与背景图像相同。
	std::string	void
tile	void	const Geometry &tile_	指定拼接中拼接列和行的最大数量。拼接是通过在前进到下一行之前填充一行中的所有单元格来构建的。一旦拼接达到列和行的最大数量，就会启动一个新的拼接图像。
	Geometry	void
transparentColor	void	const Color &transparentColor_	指定要设置为透明的拼接颜色。此选项可以设置为与背景颜色相同，以便缩略图在渲染到 HTML 页面时没有背景。为了获得最佳效果，请确保所选的透明颜色在渲染的缩略图颜色中没有出现。
	颜色	void

带框拼接

Magick::MontageFramed 提供了在需要在图像缩略图周围装饰框架时指定拼接选项的方法。MontageFramed 继承自 Montage，因此提供了 Montage 的所有方法以及表格 "MontageFramed 方法" 中显示的方法。

带框缩略图由四个部分组成：缩略图图像、缩略图框架、缩略图边框、可选的缩略图阴影和可选的缩略图标签区域。

MontageFramed 方法

方法	返回类型	签名	描述
MontageFramed		void	默认构造函数（通过 frameGeometry 启用框架）。
borderColor	void	const Color &borderColor_	指定缩略图框架内的背景颜色。
	颜色	void
borderWidth	void	size_t borderWidth_	指定在缩略图及其周围框架之间放置的边框（以像素为单位）。此选项仅在启用缩略图框架（通过 frameGeometry）并且缩略图几何规范没有也指定缩略图边框宽度时生效。
	size_t	void
frameGeometry	void	const Geometry &frame_	指定要放置在缩略图周围的框架的几何规范。如果未指定此参数，则拼接将不带框。
	Geometry	void
matteColor	void	const Color &matteColor_	指定缩略图框架颜色。
	颜色	void