|
Foxit PDF SDK
|
Public 类型 | |
| enum | Orientation { Orientation.e_OrientationNone = 0, Orientation.e_OrientationNormal = 1, Orientation.e_OrientationFlipH = 2, Orientation.e_OrientationRotate180 = 3, Orientation.e_OrientationFlipV = 4, Orientation.e_OrientationRotate90FlipH = 5, Orientation.e_OrientationRotate90 = 6, Orientation.e_OrientationRotate270FlipH = 7, Orientation.e_OrientationRotate270 = 8 } |
| 图像方向的枚举。 更多... | |
| enum | Type { Type.e_Unknown = -1, Type.e_None = 0, Type.e_BMP = 1, Type.e_JPG = 2, Type.e_PNG = 3, Type.e_GIF = 4, Type.e_TIF = 5, Type.e_JPX = 6, Type.e_JBIG2 = 8, Type.e_WEBP = 9 } |
| 图像类型的枚举。 更多... | |
Public 成员函数 | |
| Image () | |
| 构造函数。 更多... | |
| Image (string path) | |
| 构造函数,从现有图像文件路径。 更多... | |
| Image (global::System.IntPtr buffer, uint length) | |
| 构造函数,从内存缓冲区。 更多... | |
| Image (FileReaderCallback file_read) | |
| 构造函数,使用文件读取回调对象。 更多... | |
| Image (Image other) | |
| 构造函数,使用另一个图像对象。 更多... | |
| bool | AddFrame (Bitmap bitmap) |
| 添加位图作为帧。(不支持的DIB格式:foxit.common.Bitmap.DIBFormat.e_DIBRgb565 和 foxit.common.Bitmap.DIBFormat.e_DIB8bppMask ) 更多... | |
| Bitmap | GetFrameBitmap (int index) |
| 根据索引获取帧位图。 更多... | |
| int | GetFrameCount () |
| 获取帧数。 更多... | |
| int | GetHeight () |
| 获取图像高度。 更多... | |
| Image.Orientation | GetOrientation () |
| 获取图像方向。 更多... | |
| Image.Type | GetType () |
| 获取图像类型。 更多... | |
| int | GetWidth () |
| 获取图像宽度。 更多... | |
| int | GetXDPI () |
| 获取X轴的DPI。 更多... | |
| int | GetYDPI () |
| 获取Y轴的DPI。 更多... | |
| bool | IsEmpty () |
| 检查当前对象是否为空。 更多... | |
| bool | SaveAs (string file_path) |
| 将当前图像保存为图像文件。 更多... | |
| bool | SaveAs (StreamCallback file, string file_extension) |
| 将当前图像保存为图像文件。 更多... | |
| void | SetDPIs (int x_dpi, int y_dpi) |
| 设置X轴和Y轴的DPI。 更多... | |
Foxit PDF SDK提供以下图像类型:
BMP:位图图像格式。只支持单帧。Foxit PDF SDK支持从BMP图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
JPG:联合图像专家组图像格式。只支持单帧。Foxit PDF SDK支持从JPG图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
PNG:便携式网络图形图像格式。只支持单帧。Foxit PDF SDK支持从PNG图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
GIF:图形交换格式。支持多帧。Foxit PDF SDK支持从GIF图像文件加载图像, 获取其大小,获取其位图,更改其位图并将其保存为图像文件。
TIF:标签图像文件格式。支持多帧。Foxit PDF SDK支持从TIF图像文件加载图像, 获取一些基本信息,获取其位图,更改其位图并将其保存为图像文件。
JPX:JPEG-2000图像格式。只支持单帧。Foxit PDF SDK支持从JPX图像文件加载图像, 获取其大小,获取其位图,更改其位图并将其保存为图像文件。
JBIG2:JBIG2图像格式。只支持单帧。Foxit PDF SDK支持从JBIG2图像文件加载图像, 获取其大小,并将其保存为图像文件。Foxit PDF SDK尚不支持获取其帧位图。
|
strong |
图像方向的枚举。
此枚举的值应单独使用。
|
strong |
图像类型的枚举。
此枚举的值应单独使用。
| 枚举值 | |
|---|---|
| e_Unknown | 未知图像类型。 |
| e_None | 尚未有图像类型。
|
| e_BMP | 图像类型是BMP。 |
| e_JPG | 图像类型是JPG或JPEG。 |
| e_PNG | 图像类型是PNG。 |
| e_GIF | 图像类型是GIF。 |
| e_TIF | 图像类型是TIF或TIFF。 |
| e_JPX | 图像类型是JPX或JPEG-2000。 |
| e_JBIG2 | 图像类型是JBIG2。
|
| e_WEBP | 图像类型是webp。
|
|
inline |
构造函数。
此构造函数用于构造一个新的图像对象(不包含任何数据)。 此构造的图像对象的图像类型为 foxit.common.Image.Type.e_None 。
|
inline |
构造函数,从现有图像文件路径。
| [in] | path | 现有图像文件的完整路径。不应为空字符串。 |
|
inline |
构造函数,从内存缓冲区。
| [in] | buffer | 内存缓冲区。图像文件数据应完全加载到此内存缓冲区中。 不应为 null。 |
| [in] | length | 内存缓冲区的大小。应大于0。 |
|
inline |
构造函数,使用文件读取回调对象。
| [in] | file_read | 用户实现的 foxit.common.fxcrt.FileReaderCallback 对象,用于加载图像文件。 不应为 null。 |
|
inline |
构造函数,使用另一个图像对象。
| [in] | other | 另一个图像对象。 |
|
inline |
添加位图作为帧。(不支持的DIB格式:foxit.common.Bitmap.DIBFormat.e_DIBRgb565 和 foxit.common.Bitmap.DIBFormat.e_DIB8bppMask )
目前此函数不支持类型为 foxit.common.Image.Type.e_JBIG2 或 foxit.common.Image.Type.e_Unknown 的图像。
对于支持的图像类型:
如果当前图像的类型为 foxit.common.Image.Type.e_TIF 、foxit.common.Image.Type.e_GIF 或 foxit.common.Image.Type.e_None ,此函数将添加新位图 作为新的最后一帧。
如果当前图像的类型为其他类型之一,只包含单帧, 此函数将使用新位图替换第一帧。
| [in] | bitmap | 要添加或设置的有效位图帧。 |
|
inline |
根据索引获取帧位图。
目前此函数不支持类型为 foxit.common.Image.Type.e_JBIG2 的图像。 此函数只能支持获取以下格式的帧位图:
foxit.common.Bitmap.DIBFormat.e_DIB8bppMask 、foxit.common.Bitmap.DIBFormat.e_DIB8bpp 、 foxit.common.Bitmap.DIBFormat.e_DIBRgb 、foxit.common.Bitmap.DIBFormat.e_DIBRgb32 、 foxit.common.Bitmap.DIBFormat.e_DIBArgb 。
对于其他不支持的DIB格式,此函数将返回一个位图对象, 其函数 Bitmap.IsEmpty 返回 true。
| [in] | index | 帧的索引。有效范围:从0到(count-1)。 count 由函数 Image.GetFrameCount 返回。 |
|
inline |
|
inline |
获取图像高度。
如果图像有多帧,通常第一帧的大小将被视为图像大小。
|
inline |
获取图像方向。
此函数只支持类型为 foxit.common.Image.Type.e_JPG 和 foxit.common.Image.Type.e_TIF 的图像。
|
inline |
获取图像类型。
如果当前图像是新图像(不是从任何图像文件构造的),其类型为 foxit.common.Image.Type.e_None 。
|
inline |
获取图像宽度。
如果图像有多帧,通常第一帧的大小将被视为图像大小。
|
inline |
获取X轴的DPI。
目前此函数不支持类型为 foxit.common.Image.Type.e_JPX 、 foxit.common.Image.Type.e_GIF 、foxit.common.Image.Type.e_JBIG2 或 foxit.common.Image.Type.e_WEBP 的图像。
对于新图像(不是从任何图像文件构造的),X轴的默认DPI为96。
|
inline |
获取Y轴的DPI。
目前此函数不支持类型为 foxit.common.Image.Type.e_JPX 、 foxit.common.Image.Type.e_GIF 、foxit.common.Image.Type.e_JBIG2 或 foxit.common.Image.Type.e_WEBP 的图像。
对于新图像(不是从任何图像文件构造的),Y轴的默认DPI为96。
|
inline |
检查当前对象是否为空。
当前对象为空时,表示当前对象无用。
|
inline |
将当前图像保存为图像文件。
如果当前图像的类型为 foxit.common.Image.Type.e_TIF 、foxit.common.Image.Type.e_GIF 或 foxit.common.Image.Type.e_None ,且保存的图像文件类型不支持多帧, 则只有当前图像的第一帧会被保存到图像文件中。
如果保存的图像文件类型为 foxit.common.Image.Type.e_WEBP ,当前图像的位图格式 应为 foxit.common.Bitmap.DIBFormat.e_DIBRgb 、 或 。
对于图像对象(不是从任何图像文件构造的),请确保在使用此函数之前 至少向图像对象添加一个有效的帧位图; 否则此函数将失败。
| [in] | file_path | 保存的图像文件的完整路径。不应为空字符串。 目前此函数支持以下扩展名: .bmp、.jpg、.jpeg、.png、.tif、.tiff、.jpx、.jp2。 |
使用当前函数将当前图像对象保存到临时文件。这里,此临时文件 命名为"temp.tmp"。
确保当前图像对象已析构。
删除"org.bmp"并将"temp.tmp"重命名为"org.bmp"。
|
inline |
将当前图像保存为图像文件。
如果当前图像的类型为 foxit.common.Image.Type.e_TIF 、foxit.common.Image.Type.e_GIF 或 foxit.common.Image.Type.e_None ,且保存的图像文件类型不支持多帧, 则只有当前图像的第一帧会被保存到图像文件中。
如果保存的图像文件类型为 foxit.common.Image.Type.e_WEBP ,当前图像的位图格式 应为 foxit.common.Bitmap.DIBFormat.e_DIBRgb 、 或 。
对于图像对象(不是从任何图像文件构造的),请确保在使用此函数之前 至少向图像对象添加一个有效的帧位图; 否则此函数将失败。
| [in] | file | 用户实现的 foxit.common.fxcrt.StreamCallback 对象,用于保存图像文件。 |
| [in] | file_extension | 保存的图像文件的完整路径。不应为空字符串。 目前此函数支持以下扩展名: .bmp、.jpg、.jpeg、.png、.tif、.tiff、.jpx、.jp2。 |
使用当前函数将当前图像对象保存到临时文件。这里,此临时文件 命名为"temp.tmp"。
确保当前图像对象已析构。
删除"org.bmp"并将"temp.tmp"重命名为"org.bmp"。
|
inline |
设置X轴和Y轴的DPI。
目前此函数不支持类型为 foxit.common.Image.Type.e_JPX 、 foxit.common.Image.Type.e_GIF 、foxit.common.Image.Type.e_JBIG2 或 foxit.common.Image.Type.e_WEBP 的图像。
| [in] | x_dpi | X轴的DPI。应大于0。 |
| [in] | y_dpi | Y轴的DPI。应大于0。 |