MaximumImagePixelSize财产

总结

从本文档中的页面获取图像数据时使用的最大宽度或高度(以像素为单位)。

语法

c++

Java

公共intMaximumImagePixelSize {得到；集；｝

公共财产MaximumImagePixelSize ()作为整数得到集

公共：财产intMaximumImagePixelSize｛intget ()无效集(int价值）｝

公共intgetMaximumImagePixelSize ()公共无效setMaximumImagePixelSize (int值)

属性值

从本文档中的页面获取图像数据时使用的最大宽度或高度(以像素为单位)。默认值为0，即使用原始大小。

讲话

这个值将被用作创建文档的默认值DocumentImages。MaximumImagePixelSize．

的DocumentPage。GetImage，DocumentPage。GetSvg而且DocumentPage。GetSvgBackImage方法用于获取文档中页面的光栅或SVG文档表示。当的值MaximumImagePixelSize为0(默认值)，那么图像或SVG对象返回的大小将与页面相同。

当原始文档的像素大小很大时，这可能不是理想的行为。例如，如果文档库由内存大小有限的移动应用程序使用。限制返回图像的最大大小还可以提高任何类型应用程序的性能。文档和应用程序之间传输的数据的大小更小，因此可以更快地获取和呈现数据。

要限制图像和SVG对象的最大大小，请设置值MaximumImagePixelSize到所需的像素大小。在那之后，任何呼叫GetImage，GetSvg或GetSvgBackImage将导致光栅或SVG图像达到但不超过MaximumImagePixelSize宽度或高度。框架通过在保持纵横比的同时调整数据的大小来实现这一点。

示例:页面大小为8.5 × 11英寸(DocumentPage。大小是6120乘7920)。典型分辨率为300的像素大小为2550 × 3300。

调用GetImage设置为默认值0将导致不重新调整大小。获得的图像对象的大小为2550 * 3300像素。使用的比例值为1.0。

如果的值MaximumImagePixelSize设置为1024，则图像将在返回之前调整大小，从而导致大小为792 * 1024像素。这是把计算出来的最佳原始尺寸变成允许的最大尺寸，同时保持长宽比。使用的比例值是3.223。

但是，如果的值MaximumImagePixelSize设置为4096，则图像将不会调整大小，因为原始大小符合最大值。使用的比例值为1.0。

在所有情况下，将在中设置所使用的缩放值DocumentPage。ImageScale．应用程序可以使用这个值来确定图像是否被缩放，并用于涉及结果图像像素和页面单位之间坐标转换的计算。LEADTOOLS文档查看器在图像查看器控件内的页面的每个项的图像比例中设置此值。

上面描述的相同行为将发生在GetSvg(结果SVG文档被调整大小)和GetSvgBackImage (RasterColor)在任何时候。

需求

目标平台

另请参阅