主页C++ Builder 资料C++ Builder 参考手册Pictures 图片TWICImage
C++ Builder 串口控件
C++ Builder 编程技巧
C++ Builder 操作指南
C++ Builder 参考手册
基础知识
cfloat 浮点数
cmath 数学函数
cstdlib 标准库函数
System 字符串
System 日期和时间
System.Math.hpp 数学函数
其他数据类型
VCL 基础类
VCL 应用程序
Pictures 图片
 • TBitmap
 • TGIFImage
 • TGraphic
 • TIcon
 • TJPEGImage
 • TMetafile
 • TPicture
 • TPngImage
 • TWICImage
Graphics 绘图
Additional 控件
System 控件
A ~ Z 字母顺序排列的目录
网友留言/技术支持
TWICImage - 使用 WIC API 处理图片,支持 bmp, jpg, png, gif, tif 等图片

说明:

TWICImage: 使用 WIC (Windows Imaging Component) API 处理图片,支持 bmp, jpg, png, gif, tif 等图片,
TImage 控件通常用这个来显示 .tif (tiff) 图片

头文件:

#include <Vcl.Graphics.hpp> (XE2 之后),#include <Graphics.hpp> (XE 之前)

 

继承关系:

TObjectTPersistentTInterfacedPersistentTGraphicTWICImage

 

属性:

属性 类型 描述
public:    
Handle _di_IWICBitmap 提供访问 IWicBitmap 的接口,可读写属性。
利用这个 Handle 属性可以调用需要 IWicBitmap 的 Windows API 函数。
ImageFormat TWICImageFormat 图像格式,可读写属性,可用的值:
wifBmp: bmp 位图
wifPng: png 图像
wifJpeg: jpg 图像
wifGif: gif 图像
wifTiff: tif 图像
wifWMPhoto: Windows Media Photo 图像
wifOther: 位置的图像类型
EncoderContainerFormat GUID 图像格式的 GUID 值,可读写属性,
用来做为参数值提供给需要 GUID 的 Windows API 函数。
ImagingFactory _di_IWICImagingFactory 提供 IWICImagingFactory 接口,只读属性。
这个接口可以用来生成 IWicBitmap 接口。
TGraphic::   TGraphic 继承过来的
Empty bool 是否包含图像数据,只读。如果不包含图像数据,此属性为 true.
Height int 图像的高度,可读写,单位:像素 (pixels)
可以用 SetSize 方法同时修改宽度和高度
Modified bool 图像是否被修改过。如果被修改过,此属性为 true.
Palette HPALETTE 调色板句柄,可读写。如果图片没有或者不需要调色板,此值为 NULL
PaletteModified bool 调色板是否被修改过,如果被修改过,此属性值为 true.
Transparent bool 图像是否存在透明部分,可读写。
Width int 图像的宽度,可读写,单位:像素 (pixels)
可以用 SetSize 方法同时修改宽度和高度
SupportsPartialTransparency bool 是否支持半透明或 Alpha 通道,只读属性。

 

方法:

方法 描述
public:  
TWICImage __fastcall virtual TWICImage(void);
构造函数
~TWICImage __fastcall virtual ~TWICImage(void);
析构函数
Assign virtual void __fastcall Assign(System::Classes::TPersistent* Source);
把 Source 的图像数据赋值 (格式转换) 到当前图像。
LoadFromStream virtual void __fastcall LoadFromStream(System::Classes::TStream* Stream);
从流加载图像。
SaveToStream virtual void __fastcall SaveToStream(System::Classes::TStream* Stream);
把图像数据保存到流。
LoadFromClipboardFormat virtual void __fastcall LoadFromClipboardFormat(System::Word AFormat, NativeUInt AData, HPALETTE APalette);
从剪贴板加载图像数据,AFormat 为剪贴板数据格式,例如 CF_BITMAP,AData 为图像数据,APalette 为调色板句柄。【请参考 TBitmap 的例子:从剪贴板加载位图
SaveToClipboardFormat virtual void __fastcall SaveToClipboardFormat(System::Word &AFormat, NativeUInt &AData, HPALETTE &APalette);
把当前的图像数据转为剪贴板格式的数据,可以把这些数据放入剪贴板。
【请参考 TBitmap 的例子:把位图放在剪贴板里面
TGraphic:: TGraphic 继承过来的
Equals virtual bool __fastcall Equals(System::TObject* Obj);
比较当前图像是否和 Obj 的图像数据相同。
LoadFromFile virtual void __fastcall LoadFromFile(const System::UnicodeString Filename);
从文件加载图像。
SaveToFile virtual void __fastcall SaveToFile(const System::UnicodeString Filename);
把当前图像储存为文件。
SetSize virtual void __fastcall SetSize(int AWidth, int AHeight);
修改图像的大小为:宽度 = AWidth,高度 = AHeight,单位为像素 (pixels)
operator
_di_IStreamPersist()
operator System::Classes::_di_IStreamPersist()
{
  System::Classes::_di_IStreamPersist intf;
  this->GetInterface(intf);
  return intf;
}
类型转换操作符,转为 _di_IStreamPersist 类型。
protected:  
AssignTo virtual void __fastcall AssignTo(System::Classes::TPersistent* Dest);
把当前图像数据赋值 (格式转换) 到 Dest 的图像数据
Draw virtual void __fastcall Draw(TCanvas* ACanvas, const System::Types::TRect &Rect);
把当前图像数据显示到画布 ACanvas 的 Rect 位置。
GetEmpty virtual bool __fastcall GetEmpty(void);
返回图像数据是否为空。
GetHeight virtual int __fastcall GetHeight(void);
返回图像的高度,单位:像素 (pixels)。
GetWidth virtual int __fastcall GetWidth(void);
返回图像的宽度,单位:像素 (pixels)。
SetHeight virtual void __fastcall SetHeight(int Value);
把图像高度修改为 Value,单位:像素 (pixels)
SetWidth virtual void __fastcall SetWidth(int Value);
把图像宽度修改为 Value,单位:像素 (pixels)
RequireBitmap void __fastcall RequireBitmap(void);
初始化内部使用的 TBitmap 位图,这个方法由 TWICImage 内部使用。
TGraphic:: TGraphic 继承过来的
Changed virtual void __fastcall Changed(System::TObject* Sender);
当图像数据被修改的时候,会自动调用 Changed 方法。
Changed 方法会把 Modified 属性置为 true,并且触发 OnChange 事件。
DefineProperties virtual void __fastcall DefineProperties(System::Classes::TFiler* Filer);
重载 TPersistent 的 DefineProperties,用于 ReadData 和 WriteData 方法读写流图像数据。
DrawTransparent virtual void __fastcall DrawTransparent(TCanvas* ACanvas, const System::Types::TRect &Rect, System::Byte Opacity);
把当前图像数据显示到画布 ACanvas 的 Rect 位置,和画布 Rect 位置原来的显示内容混合在一起,Opacity 为混合的比例,用来实现图像的透明效果,即 Opacity 为图像不透明的程度。
Equals HIDESBASE virtual bool __fastcall Equals(TGraphic* Graphic)/* overload */;
比较当前图像是否和 Obj 的图像数据相同。
GetPalette virtual HPALETTE __fastcall GetPalette(void);
返回调色板句柄。
GetTransparent virtual bool __fastcall GetTransparent(void);
返回图像是否存在透明部分。
Progress DYNAMIC void __fastcall Progress(System::TObject* Sender, TProgressStage Stage, System::Byte PercentDone, bool RedrawNow, const System::Types::TRect &R, const System::UnicodeString Msg);
当图像改变时 (加载、存储、转换的过程中),会调用这个方法来触发 OnProgress 事件。
ReadData virtual void __fastcall ReadData(System::Classes::TStream* Stream);
从 Stream 里面读取图像数据。
SetPalette virtual void __fastcall SetPalette(HPALETTE Value);
调色板改为使用 Value 句柄的调色板。
SetTransparent virtual void __fastcall SetTransparent(bool Value);
设为是否需要把图像显示为透明。
WriteData virtual void __fastcall WriteData(System::Classes::TStream* Stream);
把图像数据写到 Stream 里面
GetSupportsPartialTransparency virtual bool __fastcall GetSupportsPartialTransparency(void);
返回是否支持半透明或 Alpha 通道。

 

事件:

事件 描述
public:  
TGraphic:: TGraphic 继承过来的
OnChange __property System::Classes::TNotifyEvent OnChange = {read=FOnChange, write=FOnChange};
• 当加载的图像发生变化时产生的事件,如果正在显示这个图片,需要刷新显示。
• 对于 gif 动画,需要显示下一帧的时候,会产生这个事件,需要在这个事件里面刷新显示
例:直接在画布上显示 gif 动画
OnProgress __property TProgressEvent OnProgress = {read=FOnProgress, write=FOnProgress};
当加载、存储、转换的过程中,会产生这个事件,表示这个过程的进度。

 

相关链接:

jpg, gif, png, bmp 之间的格式转换
bmp 转 gif 图片和动画
显示 gif 图片和动画
gif 的每一帧提取出来,每一帧存为一个 bmp 图片
屏幕截图

◤上一页:TPngImage

C++ 爱好者 -- Victor Chen 的个人网站 www.cppfans.com 辽ICP备11016859号