图像图元
图像对象提供用于 (位图加载和保存光栅图像的方法) 和矢量图像 (图元文件) 。
可以从各种文件类型（包括 BMP、ICON、GIF、JPEG、Exif、PNG、TIFF、WMF 和 EMF）构造图像对象。 图元文件对象定义图形图元文件。 图元文件包含描述图形 API 调用序列的记录。 可以构造(录制)图元文件显示(播放)。图元文件对象简称图元| 中文名称 | 英文名称 | 示例 | 作用 |
| 文件载图 | GdipLoadImageFromFile | 文件载图(文件名,@图像) | 根据文件创建图像对象。 |
| 配置载图 | GdipLoadImageFromFileICM | 配置载图(文件名,@图像) | 根据ICM文件创建图像对象。 |
| 数据载图 | GdipLoadImageFromStream | 数据载图(流,@图像) | 根据文件流创建图像对象。 |
| 配流载图 | GdipLoadImageFromStreamICM | 配流载图(文件流,@图像) | 根据ICM文件流创建图像对象。 |
| 克隆图像 | GdipCloneImage | 克隆图像(图像,@新图) | 创建一个新的图像对象，并使用此图像对象的内容进行初始化。 |
| 释放图像 | GdipDisposeImage | 释放图像(图像) | 释放图像对象使用的资源。 |
| 添加存图 | GdipSaveAdd | 添加存图(图像,编码) | 将所选帧从多帧图像保存到文件流。 |
| 添加新图 | GdipSaveAddImage | 添加新图(图像,新图,编码) | 将所选帧从多帧图像保存到文件流。 |
| 文件存图 | GdipSaveImageToFile | 文件存图(图像,宽文件名,类号,编码) | 将图像保存到文件。 |
| 数据存图 | GdipSaveImageToStream | 数据存图(图像,流,类号,编码) | 将图像保存到流对象。 |
| 图像类型 | GdipGetImageType | 图像类型(图像,@类型) | 获取此图像对象的类型。 |
| 图像宽度 | GdipGetImageWidth | 图像宽度(图像,@宽度) | 获取此图像对象的宽度。 |
| 图像高度 | GdipGetImageHeight | 图像高度(图像,@高度) | 获取此图像对象的高度。 |
| 图像边界 | GdipGetImageBounds | 图像边界(图像,矩形,@单位) | 获取此图像对象的边界矩形。 |
| 图像宽高 | GdipGetImageDimension | 图像宽高(图像,@宽度,@高度) | 获取此图像对象的宽度和高度(小数值)。 |
| 图像横值 | GdipGetImageHorizontalResolution | 图像横值(图像,@宽度) | 获取此图像的水平分辨率（以英寸为单位）。 |
| 图像竖值 | GdipGetImageVerticalResolution | 图像竖值(图像,@高度) | 获取此图像的垂直分辨率（以英寸为单位）。 |
| 图像标志 | GdipGetImageFlags | 图像标志(图像,@标志) | 获取此图像对象的标志。 |
| 图像标识 | GdipGetImageRawFormat | 图像标识(图像,@类号) | 获取此图像对象的全局唯一标识符（GUID）。 |
| 图像格式 | GdipGetImagePixelFormat | 图像格式(图像,@格式) | 获取此图像对象的像素格式。 |
| 图像缩略 | GdipGetImageThumbnail | 图像缩略(图像,宽,高,@小图,回调,附加) | 从图像对象获取缩略图。回调函数 |
| 编码表长 | GdipGetEncoderParameterListSize | 编码表长(图像,类号,@大小) | 获取指定图像编码器的参数列表的大小（以字节为单位）。 |
| 编码列表 | GdipGetEncoderParameterList | 编码列表(图像,类号,大小,@缓冲区) | 获取指定图像编码器支持的参数列表。 |
| 图像帧长 | GdipImageGetFrameDimensionsCount | 图像帧长(图像,类号,@大小) | 获取此图像对象中的帧尺寸（GUID）数。 |
| 图像帧类 | GdipImageGetFrameDimensionsList | 图像帧类(图像,@类号,大小) | 获取此图像对象的帧尺寸（GUID）的标识符 |
| 图像帧数 | GdipImageGetFrameCount | 图像帧数(图像,类号,@数量) | 获取此图像对象中指定尺寸（GUID）的帧数。 |
| 图像选帧 | GdipImageSelectActiveFrame | 图像选帧(图像,类号,索引) | 选择由标识（GUID）和索引指定的此图像对象中的帧。 |
| 图像旋转 | GdipImageRotateFlip | 图像旋转(图像,类型) | 旋转和翻转此图像。旋转翻转类型 |
| 图像取板 | GdipGetImagePalette | 图像取板(图像,色板,大小) | 获取此图像对象的色板数组。 |
| 图像改板 | GdipSetImagePalette | 图像改板(图像,色板) | 获取此图像对象的色板数组。 |
| 图像板长 | GdipGetImagePaletteSize | 图像板长(图像,@大小) | 获取此图像对象的调色板大小。 |
| 图像项数 | GdipGetPropertyCount | 图像项数(图像,@数量) | 获取此图像对象的属性项数量。 |
| 图像项列 | GdipGetPropertyIdList | 图像项列(图像,数量,@数组) | 获取此图像对象的元数据中使用的属性标识符的列表。 |
| 图像项长 | GdipGetPropertyItemSize | 图像项长(图像,序号,@大小) | 获取此图像对象的的指定属性项的大小（以字节为单位）。 |
| 图像项值 | GdipGetPropertyItem | 图像项值(图像,序号,大小,@数据) | 获取此图像对象的定的属性项一段元数据。 |
| 图像总项 | GdipGetPropertySize | 图像总项(图像,@大小,@项数) | 获取此图像对象存储的所有属性项数和总大小（以字节为单位）。 |
| 图像全项 | GdipGetAllPropertyItems | 图像全项(图像,大小,项数,项数组) | 获取此图像对象的元数据的全部属性项。 |
| 图像删项 | GdipRemovePropertyItem | 图像删项(图像,序号) | 从图像对象中删除属性项 (元数据) 片段。 |
| 图像改项 | GdipSetPropertyItem | 图像改项(图像,属性项) | 设置此图像对象元数据的一个属性项。 |
| 图像首项 | GdipFindFirstImageItem | 图像首项(图像,数据项) | 检索此图像对象中第一个元数据项的说明和数据大小。 |
| 图像次项 | GdipFindNextImageItem | 图像次项(图像,数据项) | 检索此图像对象中下一个元数据项的说明和数据大小。 |
| 图像取项 | GdipGetImageItemData | 图像取项(图像,数据项) | 从此图像对象中获取一段元数据项。 |
| 图像中止 | GdipImageSetAbort | 图像中止(图像,@中止) | 设置在耗时的呈现操作期间定期调用 中止 函数(无参数)。 |
| 图像验证 | GdipImageForceValidation | 图像项数(图像,@数量) | 此函数强制验证映像。 |
| 图元转强 | GdipConvertToEmfPlus | 图元转强(图形,图元,@成功,类型,描述,@强元) | 将此 图元 对象转换为 EMF+ 格式。描述为可选宽字符 |
| 图元强文 | GdipConvertToEmfPlusToFile | 图元增强(图形,图元,@成功,宽名,类型,描述,@强元) | 将此 图元文件 对象转换为 EMF+ 格式。描述为可选宽字符 |
| 图元强流 | GdipConvertToEmfPlusToStream | 图元转强(图形,图元,@成功,流,类型,描述,@强元) | 将此 图元流 对象转换为 EMF+ 格式。描述为可选宽字符 |
| 图元标头 | GdipGetMetafileHeaderFromWmf | 图元标头(元窗口,标头,@副本) | 获取图元标头。 |
| 强元标头 | GdipGetMetafileHeaderFromEmf | 强元标头(元窗口,@标头) | 获取强图元标头。 |
| 文件标头 | GdipGetMetafileHeaderFromFile | 文件标头(宽文件名,@标头) | 获取文件标头。 |
| 取流标头 | GdipGetMetafileHeaderFromStream | 取流标头(流,@标头) | 获取流对象标头。 |
| 取元标头 | GdipGetMetafileHeaderFromMetafile | 取元标头(图元,@标头) | 获取图元文件标头。 |
| 图元窗口 | GdipGetHemfFromMetafile | 图元窗口(图元,@窗口) | 获取增强型图元文件 (EMF) 文件的窗口句柄。 |
| 新建图元 | GdipCreateMetafileFromWmf | 新建图元(窗口,删除,图元类,@图元) | 创建用于录制的 Windows GDI+ 图元文件对象。 |
| 新建强元 | GdipCreateMetafileFromEmf | 新建强元(窗口,是否删除,@图元) | 创建可以进行播放增强型图元文件 (EMF) 文件。 |
| 文件图元 | GdipCreateMetafileFromFile | 文件图元(宽文件名,@图元) | 从文件创建用于播放的图元文件对象。 |
| 流建图元 | GdipCreateMetafileFromStream | 流建图元(流,@图元) | 从流创建用于播放的图元文件对象。 |
| 录制图元 | GdipRecordMetafile | 录制图元(设备,边框,单位,类型,描述,@图元) | 创建用于录制的图元文件对象。边框矩形为小数,描述为可选宽字符 |
| 记录图元 | GdipRecordMetafileI | 记录图元(设备,边框,单位,类型,描述,@图元) | 创建用于录制的图元文件对象。边框矩形为整数,描述为可选宽字符 |
| 录制文元 | GdipRecordMetafileFileName | 录制文元(宽名,设备,边框,单位,类型,描述,@图元) | 从宽文件名创建用于录制的图元文件对象。边框矩形为小数,描述为可选宽字符 |
| 记录文元 | GdipRecordMetafileFileNameI | 记录文元(宽名,设备,边框,单位,类型,描述,@图元) | 从宽文件名创建用于录制的图元文件对象。边框矩形为整数,描述为可选宽字符 |
| 录制流元 | GdipRecordMetafileStream | 录制流元(流,设备,边框,单位,类型,描述,@图元) | 从流对象创建用于录制的图元文件对象。边框矩形为小数,描述为可选宽字符 |
| 记录流元 | GdipRecordMetafileStreamI | 记录流元(流,设备,边框,单位,类型,描述,@图元) | 从流对象创建用于录制的图元文件对象。边框矩形为整数,描述为可选宽字符 |
| 元改分辨 | GdipSetMetafileDownLevelRasterizationLimit | 元改分辨(图元,分辨率) | 设置存储在此图元文件中的某些画笔位图的分辨率。 |
| 元取分辨 | GdipGetMetafileDownLevelRasterizationLimit | 元取分辨(图元,@分辨率) | 获取存储在此图元文件中的某些画笔位图的分辨率。 |
框架单位-MetafileFrameUnit 枚举指定图元文件框架矩形的度量单位。
| 英文名称 | 数值 | 作用 |
| MetafileFrameUnitPixel | 2 | 指定单位为 1 像素。 |
| MetafileFrameUnitPoint | 3 | 指定单位为 1 磅。 |
| MetafileFrameUnitInch | 4 | 指定单位为 1 英寸。 |
| MetafileFrameUnitDocument | 5 | 指定单位为 1/300 英寸。 |
| MetafileFrameUnitMillimeter | 6 | 指定单位为 1 毫米。 |
| MetafileFrameUnitGdi | 7 | 指定单位为 0.01 毫米。 提供此元素是为了与 GDI 兼容。 |
图元类型-EmfType 枚举指定放置在增强型图元文件 (EMF) 文件中的记录的性质。
| 英文名称 | 数值 | 作用 |
| EmfTypeEmfOnly | 0 | 指定图元文件中的所有记录都是 EMF 记录，这些记录可由 GDI 或 GDI+ 显示。 |
| EmfTypeEmfPlusOnly | 1 | 指定图元文件中的所有记录都是 EMF+ 记录，这些记录可由 GDI+ 显示，但不能由 GDI 显示。 |
| EmfTypeEmfPlusDual | 2 | 指定图元文件中所有的 EMF+ 记录都与一个替换的 EMF 记录相关联。 EmfTypeEmfPlusDual 类型的图元文件可由 GDI 或 GDI+ 显示。 |
图像标志-ImageFlags 枚举指定图像对象中包含的像素数据的属性。
| 英文名称 | 数值 | 作用 |
| ImageFlagsNone | 0 | 不指定格式信息。 |
| ImageFlagsScalable | 0x0001 | 指定可以缩放映像。 |
| ImageFlagsHasAlpha | 0x0002 | 指定像素数据包含 alpha 值。 |
| ImageFlagsHasTranslucent | 0x0004 | 指定此像素数据有不同于 0（透明）和 255（不透明）的 alpha 值。 |
| ImageFlagsPartiallyScalable | 0x0008 | 指定像素数据可部分缩放，但存在一些限制。 |
| ImageFlagsColorSpaceRGB | 0x0010 | 指定使用 RGB 颜色空间存储图像。 |
| ImageFlagsColorSpaceCMYK | 0x0020 | 指定使用 CMYK 颜色空间存储图像。 |
| ImageFlagsColorSpaceGRAY | 0x0040 | 指定图像为灰度图像。 |
| ImageFlagsColorSpaceYCBCR | 0x0080 | 指定使用 YCBCR 颜色空间来存储图像。 |
| ImageFlagsColorSpaceYCCK | 0x0100 | 指定使用 YCCK 颜色空间来存储图像。 |
| ImageFlagsHasRealDPI | 0x1000 | 指定在图像中存储每英寸点数信息。 |
| ImageFlagsHasRealPixelSize | 0x2000 | 指定在图像中存储像素大小。 |
| ImageFlagsReadOnly | 0x00010000 | 指定像素数据为只读。 |
| ImageFlagsCaching | 0x00020000 | 指定可以缓存像素数据以加快访问速度。 |
旋转翻转-RotateFlipType 枚举指定图像的旋转方向和用于翻转图像的轴。
| 英文名称 | 数值 | 作用 |
| RotateNoneFlipNone | 0 | 指定无旋转和不翻转。 |
| Rotate90FlipNone | 1 | 指定不翻转的 90 度旋转。 |
| Rotate180FlipNone | 2 | 指定不翻转的 180 度旋转。 |
| Rotate270FlipNone | 3 | 指定不翻转的 270 度旋转。 |
| RotateNoneFlipX | 4 | 指定无旋转和水平翻转。 |
| Rotate90FlipX | 5 | 指定后跟水平翻转的 90 度旋转。 |
| Rotate180FlipX | 6 | 指定后跟水平翻转的 180 度旋转。 |
| Rotate270FlipX | 7 | 指定后跟水平翻转的 270 度旋转。 |
| RotateNoneFlipY | 8 | 指定无旋转和垂直翻转。 |
| Rotate90FlipY | 9 | 指定后跟垂直翻转的 90 度旋转。 |
| Rotate180FlipY | 10 | 指定后跟垂直翻转的 180 度旋转。 |
| Rotate270FlipY | 11 | 指定后跟垂直翻转的 270 度旋转。 |
| RotateNoneFlipXY | 12 | 指定无旋转、水平翻转和垂直翻转。 |
| Rotate90FlipXY | 13 | 指定 90 度旋转，然后水平翻转，然后垂直翻转。 |
| Rotate180FlipXY | 14 | 指定 180 度旋转，然后水平翻转，然后垂直翻转。 |
| Rotate270FlipXY | 15 | 指定 270 度旋转，然后水平翻转，然后垂直翻转。 |
图像完成
| 中文名字 | 英文名称 | 参数 | 作用解释 |
| 图像完成 | Imageabort | 1 | 在应用程序中实现的回调函数的签名。在创建或检索缩略图或绘制图像的过程中，GDI+ 会调用此函数来中止该过程。 |
| 图像完成——参数表 | |||
|---|---|---|---|
| 附加 | unnamedParam1 | 整数 | 定义回调函数时程序指定的附加数据。 |
属性项类
| 中文名字 | 英文名称 | 长度 | 作用解释 |
| 属性项类 | PropertyItem | 14 | 包含一段图像元数据。 |
| 属性项类——成员表 | |||
|---|---|---|---|
| 编号 | propId | 整数 | 标识存储在此结构中的元数据类型。 |
| 长度 | Length | 整数 | 值数组的大小（以字节为单位）。 |
| 分类 | type | 整形 | 标识值数组中值的数据类型。 |
| 项值 | value | 整数 | 指向值数组的指针。数组中的每个值都具有由分类数据成员指定的数据类型。 |
数据类型-RotateFlipType 枚举指定图像的旋转方向和用于翻转图像的轴。
| 英文名称 | 数值 | 作用 |
| PropertyTagTypeByte | 1 | 指定 值 数据成员是字节数组。 |
| PropertyTagTypeASCII | 2 | 指定 值 数据成员是以 null 结尾的 ASCII 字符串。如果设置此值则应将长度数据成员设置为字符串的长度，包括 0 终止符。 例如，字符串 HELLO 的长度为 6。 |
| PropertyTagTypeShort | 3 | 指定 值 数据成员是无符号短 (16 位) 整数的数组。 |
| PropertyTagTypeLong | 4 | 指定 值 数据成员是无符号长 (32 位) 整数的数组。 |
| PropertyTagTypeRational | 5 | 指定 值 数据成员是无符号长整数对的数组。 每对表示一个分数;第一个整数是分子，第二个整数是分母。 |
| PropertyTagTypeUndefined | 7 | 指定 值 数据成员是可以保存任何数据类型的值的字节数组。 |
| PropertyTagTypeSLONG | 9 | 指定 值 数据成员是带符号长 (32 位) 整数的数组。 |
| PropertyTagTypeSRational | 10 | 指定 值 数据成员是带符号长整数对的数组。 每对表示一个分数;第一个整数是分子，第二个整数是分母。 |
图项数据类
| 中文名字 | 英文名称 | 长度 | 作用解释 |
| 图项数据类 | ImageItemData | 28 | 用于存储和检索自定义图像元数据。 |
| 图项数据类——成员表 | |||
|---|---|---|---|
| 大小 | Size | 整数 | 指定此结构大小(28)。 |
| 位置 | Position | 整数 | 数据位置 枚举的元素，该元素指定图像文件中应存储一段自定义元数据的位置。 |
| 描述 | Desc | 整数 | 您创建的用于标识一段自定义元数据的字节序列。JPEG是一字节。PNG为四字节。GIF为11 字节。 |
| 字数 | DescSize | 整数 | 指定描述指向的标识符的大小（以字节为单位）的整数。JPEG 设置为 1，PNG 设置为 4，GIF 设置为 11。 |
| 数据 | Data | 整数 | 指向包含元数据的缓冲区的指针。 |
| 长度 | DataSize | 整数 | 指定数据缓冲区的大小（以字节为单位）。 |
| 身份 | Cookie | 整数 | 由 GDI+ 在内部使用。 |
数据位置-ItemDataPosition 枚举用于指定自定义元数据在图像文件中的位置。
| 英文名称 | 数值 | 作用 |
| ItemDataPositionAfterHeader | 0x0 | 指定自定义元数据存储在文件标头之后。 对 JPEG、PNG 和 GIF 有效。 |
| ItemDataPositionAfterPalette | 0x1 | 指定自定义元数据存储在调色板之后。 对 PNG 有效。 |
| ItemDataPositionAfterBits | 0x2 | 指定自定义元数据存储在像素数据之后。 对 GIF 和 PNG 有效。 |