Foxit PDF SDK
FSImageSettings类 参考
类 FSImageSettings 继承关系图:
FSBase

构造函数

(id) - init
 构造函数。
更多...
 
(id) - initWithOther:
 构造函数,使用另一个图像设置对象。
更多...
 
(BOOL) - isEmpty
 检查当前对象是否为空。
更多...
 
(void) - setBackgroundDownScale:
 设置有损压缩模式的背景降采样值,用于优化PDF文档中的彩色图像。
更多...
 
(void) - setCompressionMode:
 设置用于优化PDF文档中彩色/灰度图像的压缩模式。
更多...
 
(void) - setForegroundDownScale:
 设置有损压缩模式的前景降采样值,用于优化PDF文档中的彩色图像。
更多...
 
(void) - setImageDPI:
 设置DPI值作为压缩PDF文档中彩色/灰度图像的目标压缩值。
更多...
 
(void) - setImageDPILimit:
 设置彩色/灰度图像的下限DPI值,以决定是否在PDF文档中压缩图像。
更多...
 
(void) - setQuality:
 设置有损压缩模式的质量,用于优化PDF文档中的彩色/灰度图像。
更多...
 
(void) - setStretchMode:
 设置用于优化PDF文档中彩色/灰度图像的拉伸模式。
更多...
 
(void) - setTextSensitivity:
 设置有损压缩模式的文本敏感度,用于优化PDF文档中的彩色图像。
更多...
 
(void) - setTileSize:
 设置JPEG2000压缩模式的瓦片大小,用于优化PDF文档中的彩色/灰度图像。
更多...
 

详细描述

此类表示彩色和灰度图像的降采样/重压缩设置。 此类对象可以设置到 FSOptimizerSettings 类,然后用于优化PDF文档。

参见
FSOptimizerSettings

函数文档

◆ init()

- (id) init

构造函数。

此构造函数用于构造具有默认设置选项的彩色/灰度图像设置对象。 用户也可以调用此类中的"set"方法来更改这些设置选项。 有关默认值的更多详细信息,请参考这些"set"方法的注释。

◆ initWithOther:()

- (id) initWithOther: (FSImageSettings*)  other

构造函数,使用另一个图像设置对象。

参数
[in]other另一个图像设置对象。

◆ isEmpty()

- (BOOL) isEmpty

检查当前对象是否为空。

当当前对象为空时,意味着当前对象无用。

返回
YES 表示当前对象为空,而 NO 表示不为空。

◆ setBackgroundDownScale:()

- (void) setBackgroundDownScale: (int)  down_scale

设置有损压缩模式的背景降采样值,用于优化PDF文档中的彩色图像。

此函数用于降低背景图像的分辨率。

参数
[in]down_scale有损压缩模式的背景降采样值。应该大于0。 如果值为1,则不降低背景分辨率。 如果值大于1,值越高,背景分辨率越低。 如果不调用此函数来设置此选项,那么将使用3作为此选项的默认值。
返回
无。

◆ setCompressionMode:()

- (void) setCompressionMode: (FSImageSettingsImageCompressMode)  mode

设置用于优化PDF文档中彩色/灰度图像的压缩模式。

对于新构造的对象,如果不调用此函数来设置选项, 那么将使用 FSImageSettingsImageCompressjpeg 作为此选项的默认值。

参数
[in]mode图像压缩模式。请参考从 FSImageSettingsImageCompressHigh 开始的值, 并且应该是这些值中的一个。
返回
无。

◆ setForegroundDownScale:()

- (void) setForegroundDownScale: (int)  down_scale

设置有损压缩模式的前景降采样值,用于优化PDF文档中的彩色图像。

此函数用于降低前景图像的分辨率。

参数
[in]down_scale有损压缩模式的前景降采样值。应该大于0。 如果值为1,则不降低前景分辨率。 如果值大于1,值越高,前景分辨率越低。 如果不调用此函数来设置此选项,那么将使用3作为此选项的默认值。
返回
无。

◆ setImageDPI:()

- (void) setImageDPI: (int)  dpi

设置DPI值作为压缩PDF文档中彩色/灰度图像的目标压缩值。

当图像可以被压缩时,此图像的分辨率将被压缩到当前函数设置的DPI值。
对于新构造的对象,如果不调用此函数来设置选项, 则表示使用150作为此选项的默认值。

参数
[in]dpi设置为目标压缩DPI值的DPI值。
返回
无返回值。

◆ setImageDPILimit:()

- (void) setImageDPILimit: (int)  dpi_limit

设置彩色/灰度图像的下限DPI值,以决定是否在PDF文档中压缩图像。

如果PDF文档中图像的分辨率高于下限DPI值,则此图像将被压缩到 由函数 FSImageSettings::setImageDPI: 设置的目标压缩DPI值。
对于新构造的对象,如果不调用此函数来设置选项, 那么将使用一个DPI值(目标压缩DPI值的1.5倍)作为 此选项的默认值。

参数
[in]dpi_limit作为下限的DPI值。此值应该是正数。建议范围: 大于目标压缩DPI值(通过函数 FSImageSettings::setImageDPI: 设置), 最大值是目标压缩DPI值的10倍。
如果输入值不大于目标压缩DPI值,将使用比目标压缩DPI值多1的DPI值。
如果输入值大于最大值,将使用最大值。
返回
无。

◆ setQuality:()

- (void) setQuality: (FSImageSettingsImageCompressQuality)  quality

设置有损压缩模式的质量,用于优化PDF文档中的彩色/灰度图像。

对于新构造的对象,如果不调用此函数来设置此选项, 那么将使用 FSImageSettingsImageCompressQualityMinimum 作为 此选项的默认值。

参数
[in]quality有损压缩模式的质量值。请参考从 FSImageSettingsImageCompressQualityMinimum 开始的值,应该是这些值中的一个。
返回
无。

◆ setStretchMode:()

- (void) setStretchMode: (FSImageSettingsStretchMode)  mode

设置用于优化PDF文档中彩色/灰度图像的拉伸模式。

对于新构造的对象,如果不调用此函数来设置此选项, 则表示使用 FSImageSettingsStretchBicubic 作为此选项的默认值。

参数
[in]mode拉伸模式。请参考从 FSImageSettingsStretchOff 开始的值, 这应该是这些值中的一个。
返回
无返回值。

◆ setTextSensitivity:()

- (void) setTextSensitivity: (int)  text_sensitivity

设置有损压缩模式的文本敏感度,用于优化PDF文档中的彩色图像。

此函数影响将图像分割为前景(通常是文本)和背景。 如果不调用此函数来设置此选项,那么将使用60作为此选项的默认值。

参数
[in]text_sensitivity文本敏感度值。较高的敏感度值 会使更多内容在前景中表示。此值在处理低对比度文档 以及背景中包含图案、图像或颜色的文档时特别重要。 相反,对于具有高对比度、清晰明亮背景和锐利暗色符号的 简单文本文档,影响较小。 有效值:从0到100。
返回
无。

◆ setTileSize:()

- (void) setTileSize: (int)  size

设置JPEG2000压缩模式的瓦片大小,用于优化PDF文档中的彩色/灰度图像。

对于新构造的对象,如果不调用此函数来设置此选项, 那么将使用256作为此选项的默认值。

参数
[in]size瓦片的大小,此值只能在128到2048之间。
注解
此方法仅在 FSImageSettingsImageCompressjpeg2000 压缩模式下有效。
返回
无。