极语言3-17 公用图面对象、公用调色对象、公用剪辑对象、公用颜色对象、公用渐变对象——方法表

117 阅读6分钟
英文名字中文名称作用解释
IDirectDrawSurface7公用图面对象使用驱动显示面接口的方法创建图面对象并使用系统级变量。
公用图面对象——方法表
QueryInterface接口(标识,@指针)检索指向对象上支持的接口的指针。
AddRef计数递增对象上接口的引用计数。 对于指向对象上接口的指针的每个新副本,应调用此方法。
Release释放递减对象上接口的引用计数。前三项COM对象通用
AddAttachedSurface添加图面(接口)将指定的 z 缓冲区图面连接到此图面。
AddOverlayDirtyRect添加覆盖(矩形)此方法当前未实现。
Blt位传(目标矩形,图面,源矩形,标志,光栅)执行位块传输。标志:200=顺序异步;200=顺序异步;400=填充颜色;800指定光栅类型;800指定光栅类型;1000丢弃光栅;2000使用目标颜色键;2000使用目标颜色键;4000指定目标颜色键;8000使用源颜色键;8000使用源颜色键; 10000指定源颜色键;20000指定光栅操作功能;20000指定光栅操作功能;40000指定旋转角度;$8000000=返回传输状态
BltBatch批传(位块组,操作数,0)此方法当前未实现。
BltFast快传(x,y,图面,矩形,标志)使用源颜色键或目标颜色键执行源复制位块或透明位块。标志:0=普通复制;1按源透明色;2用目标透明;$10等待忙完
DeleteAttachedSurface分离(0,图面)分离一个或多个附加表面。
EnumAttachedSurfaces枚举图面(传参,@回附加面)枚举连接到此图面的所有图面。
EnumOverlayZOrders枚举覆面(模式,传参,@回附加面)枚举指定目标上的覆盖图面。模式:0=从后到前;1=从前到后;
Flip翻转(图面,标志)使与后台缓冲区图面关联的表面内存与前缓冲区表面相关联。标志:1=尝试等待;2=偶数场视频;4奇数视频;8不同步;10=立体声;10=立体声;20=不需等待; 2000000=每秒垂直同步翻转;2000000=每秒垂直同步翻转;3000000=隔三同步;$4000000=隔四同步
GetAttachedSurface取附加图(功能,@图面)获取具有指定功能的附加图面,并递增检索到的接口的引用计数
GetBltStatus取块传(标志)获取位块传输 (bitblt) 操作的状态。标志:1=传输开始;2=传输完成;返回:0成功;0x88760082=无效对象;0x8876023F=无问题;0x887601AE=线程锁定被拒; 0x887601C2=图面不存在;0x8876021C=正在传输或图面不完整;0x80070057=错误参数;0x80004001=不支持操作。
GetCaps获取功能(@功能)检索图面的功能。
GetClipper取剪辑(剪辑器)索与此图面关联的剪辑器对象,并递增返回的剪辑器的引用计数。
GetColorKey取颜色键(标志,色键)检索此图面的颜色键值。标志:2=块传目标色键;4=覆盖目标色键;8=块传源键;$10覆盖源键
GetDC取设备(@设备)为此图面创建设备上下文的 GDI 兼容句柄。
GetFlipStatus取翻转(标志)检索有关此图面是否已完成翻转过程的状态。标志:1=传输开始;2=传输完成;返回:0成功;0x88760082=无效对象;0x8876023F=无问题; 0x887601AE=线程锁定被拒;0x887601C2=图面不存在;0x8876021C=正在传输或图面不完整;0x80070057=错误参数;0x80004001=不支持操作。
GetOverlayPosition取坐标(@x,@y)检索可见的活动覆盖图面的显示坐标。
GetPalette取调色板(@色板)检索与此图面关联的调色板对象,并递增返回的调色板的引用计数。
GetPixelFormat像素格式(格式)检索此图面的颜色和像素格式。
GetSurfaceDesc图面说明(图面说明类)检索此图面在其当前条件下的说明。调用前只需初始化结构大小
Initialize初始化(对象,图面说明类)初始化图面对象。
IsLost丢弃确定是否释放了与图面对象关联的表面内存。返回:0=尚未释放;0x88760082=无效对象;0x80070057=错误参数;0x887601C2=图面不存在;
Lock锁定(矩形,图面类,标志,0)获取指向表面内存的指针。矩形为0是整个画面,标志:1=尝试等待;10=只读画面;10=只读画面;20=启用写入;800=不互斥锁;800=不互斥锁;1000=不写引用顶点;2000=重写顶点;2000=重写顶点;4000=不需等待;
ReleaseDC释放设备(设备)释放以前使用"取设备"方法获取的设备上下文的句柄。
Restore还原图面还原已丢失的图面。当与图面对象关联的面内存已释放时,将发生这种情况。
SetClipper改剪辑(剪辑器)将剪辑器对象附加到此图面或从中删除一个对象(参数为0)。
SetColorKey顶级行为(模式,颜色键)设置图面对象的颜色键值。模式:1=含颜色空间;2=位传目标颜色;4=覆盖目标颜色;8=位传源颜色;$10=覆盖源颜色
SetOverlayPosition改坐标(x,y)设更改覆盖图面的显示坐标。
SetPalette改调色板(色板)将调色板对象附加到图面或从图面分离一个对象。
Unlock解锁(矩形)通知绘图对象直接图面操作已完成。矩形为0是整个图面
UpdateOverlay更新覆盖(源矩形,图面,目标矩形,标志,DDFX)重新定位或修改覆盖图面的视觉属性。 标志:2=覆盖目标透明通道数值;4=指定目标透明度;8=覆盖目标透明通道地址;10=边框透明通道;10=边框透明通道;20=附加像素格式透明; 40=源透明通道数值;40=源透明通道数值;80=指定源透明度;100=源透明通道地址;100=源透明通道地址;200=关闭覆盖面;400=目标关联颜色键;400=目标关联颜色键;800=目标覆盖颜色键;1000=源关联颜色键;1000=源关联颜色键;2000=源覆盖颜色键; 4000=显示覆盖面;4000=显示覆盖面;8000=添加矩形到覆盖面;10000=重绘覆盖面矩形;10000=重绘覆盖面矩形;20000=重绘整个覆盖面;80000=FX定义特效;80000=用FX定义特效;100000=垂直同步自动翻转;200000=隔行扫描无断帧;200000=隔行扫描无断帧; 400000=隔行编码持久有效;800000=交错内存数据;800000=交错内存数据;1000000=硬件隔行扫描编码;2000000=包含ARGB缩放因子;2000000=包含ARGB缩放因子;4000000=ARGB缩放因子可降级
UpdateOverlayDisplay更新显示(预留)方法当前未实现。
UpdateOverlayZOrder更新层序(标志,图面)设置覆盖的z顺序。标志:0=移到前面;1移到后面;2=前移一层;3=后移一层;4插到前面;5插到后面;4和5插入时需要指定图面
GetDDInterface取接口(@接口)检索用于创建此图面的绘图对象的接口。(版本>=2.0)
PageLock锁定分页(0)防止系统内存图面在位块传输时分页,直接使用内存访问 (DMA) 传输。(版本>=2.0)
PageUnlock解锁分页(0)解锁系统内存图面,然后允许将其分页。(版本>=2.0)
SetSurfaceDesc设置图面(图面说明类,0)设置现有图面的特征。(版本>=3.0)
GetPrivateData图面数据(类标识,@缓冲,@大小)将与此图面关联的专用数据复制到提供的缓冲区。(版本>=4.0)
FreePrivateData释放数据(类标识)释放与此图面关联的指定私有数据。(版本>=4.0)
GetUniquenessValue图面键值(@键值)检索此图面的当前唯一性值。(版本>=4.0)
ChangeUniquenessValue更换键值手动更新此图面的唯一性值。(版本>=4.0)
SetPriority改优先(级)为此托管纹理分配纹理管理优先级。(版本>=7.0)
GetPriority取优先(@级)获取此托管纹理的纹理管理优先级。(版本>=7.0)
SetLOD改细节(级)设置托管纹理mipmap图面的最大细节级别LOD。(版本>=7.0)
GetLOD取细节(@级)获取托管纹理mipmap图面的最大细节级别LOD。(版本>=7.0)
英文名字中文名称作用解释
IDirectDrawPalette公用调色对象应用程序使用调色板接口的方法来创建调色板对象,并使用系统级变量。
公用调色对象——方法表
QueryInterface接口(标识,@指针)检索指向对象上支持的接口的指针。
AddRef计数递增对象上接口的引用计数。 对于指向对象上接口的指针的每个新副本,应调用此方法。
Release释放递减对象上接口的引用计数。前三项COM对象通用
GetCaps功能(@标志)检索调色板对象的功能。标志:1四位(16色);2引用8位色;4=八位(256色); 10连正面;10连正面;20左视图;40定义256;40定义256色;80刷新率同步;100一位(黑白);100一位(黑白);200=二位(四色);$400=透明通道
GetEntries取色板(0,开头,数目,色板组)从调色板对象检索调色板值。
Initialize初始化(对象,0,0)初始化调色板对象。
SetEntries改色板(0,开头,数目,色板组)立即更改调色板对象中的条目。
英文名字中文名称作用解释
IDirectDrawClipper公用剪辑对象应用程序使用剪辑器接口的方法来管理剪辑列表。
公用剪辑对象——方法表
QueryInterface接口(标识,@指针)检索指向对象上支持的接口的指针。
AddRef计数递增对象上接口的引用计数。 对于指向对象上接口的指针的每个新副本,应调用此方法。
Release释放递减对象上接口的引用计数。前三项COM对象通用
GetClipList取副本(矩形,@区块组,@大小)检索剪辑器对象关联的剪辑列表的副本。矩形为0取整个画面,区块为0取数据大小
GetHWnd取窗口(@窗口)检索与剪辑器对象关联的窗口句柄。
Initialize初始化(对象,0)初始化调色板对象。
IsClipListChanged列表状态(@真假)如果窗口句柄与剪辑器对象关联,则检索剪辑列表的状态是否更改。
SetClipList改副本(区块组,0)设置或删除剪辑器父对象所附加到的图面上使用的剪辑列表。
SetHWnd改窗口(@真假)设置剪辑器对象用于获取剪辑信息的窗口句柄。
英文名字中文名称作用解释
IDirectDrawColorControl公用颜色对象应用程序使用颜色控件接口的方法获取和设置颜色控件。
公用颜色对象——方法表
QueryInterface接口(标识,@指针)检索指向对象上支持的接口的指针。
AddRef计数递增对象上接口的引用计数。 对于指向对象上接口的指针的每个新副本,应调用此方法。
Release释放递减对象上接口的引用计数。前三项COM对象通用
GetColorControls取色控(@颜色控制)检索与覆盖或主图面关联的当前颜色控制设置。
SetColorControls改色控(颜色控制)设置覆盖或主图面的颜色控制选项。
英文名字中文名称作用解释
IDirectDrawGammaControl公用渐变对象应用程序使用伽玛渐变控件接口的方法来调整主图面的红色、绿色和蓝色伽玛渐变级别。
公用渐变对象——方法表
QueryInterface接口(标识,@指针)检索指向对象上支持的接口的指针。
AddRef计数递增对象上接口的引用计数。 对于指向对象上接口的指针的每个新副本,应调用此方法。
Release释放递减对象上接口的引用计数。前三项COM对象通用
GetGammaRamp取渐变(0,@色素)检索主图面的红色、绿色和蓝色伽玛渐变
SetGammaRamp改渐变(标志,色素)设置主图面的红色、绿色和蓝色伽玛渐变。标志:1=物理校准;0不校准