aardio 文档

gdip.graphics 库模块帮助文档

gdip 成员列表 #

gdip.graphics() #

返回对象:gdipgraphicsObject

gdip.graphics(bitmap) #

使用gdip.bitmap对象创建画板

gdip.graphics(hdc) #

使用GDI设备句柄创建画板

gdip.graphics(image) #

使用gdip.image对象创建画板

gdip.graphics(winform) #

使用窗口或控件对象创建画板

gdip.graphics 成员列表 #

gdip.graphics.fromHwnd() #

使用指定的窗口创建画板

返回对象:gdipgraphicsObject

gdip.graphics.fromImage() #

使用gdip.image对象创建画板

返回对象:gdipgraphicsObject

gdipgraphicsObject 成员列表 #

gdipgraphicsObject._bitmap #

创建画板时使用的gdip.bitmap对象

返回对象:gdipbitmapObject

gdipgraphicsObject._hdc #

创建画板时使用的设备上下文

gdipgraphicsObject._hwnd #

创建画板时使用的句柄

gdipgraphicsObject._image #

创建画板时使用的gdip.image对象

返回对象:gdipimageObject

gdipgraphicsObject.clear() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.clear(0xFFFFFFFF) #

用指定的颜色清空画板

gdipgraphicsObject.compositingMode #

gdipgraphicsObject.compositingMode = _GdipCompositingMode/*合成图像模式,SourceCopy为覆盖,SourceOver为叠加  
*/ ;

gdipgraphicsObject.compositingQuality #

gdipgraphicsObject.compositingQuality = _GdipCompositingQuality/*合成图像质量*/ ;

gdipgraphicsObject.createCachedBitmap(位图对象) #

创建缓存位图

gdipgraphicsObject.delete() #

释放图像
此对象支持自动释放,不必手工调用此函数

返回对象:gdipgraphicsObject

gdipgraphicsObject.deleteCachedBitmap(缓存位图) #

删除缓存位图

gdipgraphicsObject.drawArc() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawArc(pen,x,y,width,height,startAngle,sweepAngle) #

画圆弧
x,y指定椭圆所在矩形的左上角,width指定宽度,height指定高度,
startAngle:起始角度,以度为单位从X轴顺时针测量,水平线右侧为0度,
sweepAngle:startAngle和弧线末尾之间的扫描角度

gdipgraphicsObject.drawBackground #

画背景图

gdipgraphicsObject.drawBackground() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawBackground(位图对象,模式,绘图RECT,上,右,下,左,显示属性,dpiScaleX,dpiScaleY) #

支持模式 auto,expand,stretch,center,scale,tile,repeat-x,repeat-y
所有模式请参考 plus 控件背景模式属性说明,
auto 模式指图像超过绘图区则居中,否则缩放。
该函数不检查参数正确性,调用者有责任保证参数正确
参数 @3 可用 ::RECT 结构体指定区块参数。
可选使用参数@8指定 gdip.imageAttributes 对象设置显示属性
tile,repeat-x,repeat-y 三种模式忽略显示属性,
可选用 dpiScaleX,dpiScaleY 指定 DPI 缩放系数。
函数返回自身

gdipgraphicsObject.drawBezier #

画贝塞尔曲线

gdipgraphicsObject.drawBezier(pen,x1,y1,x2,y2,x3,y3,x4,y4) #

画贝塞尔曲线
4个坐标点分别为:起始锚点,起始控制点,结束锚点,结束控制点

gdipgraphicsObject.drawBitmapRepeatX() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawBitmapRepeatX(图像,绘图RECT,上,右,下,左) #

水平平铺
参数@1 为gdip.bitmap对象。
参数 @2 可用 ::RECT 结构体指定区块参数。
最后的四个参数指定坐标
如果指定了右坐标则忽略左坐标,
如果指定了下坐标则忽略上坐标

gdipgraphicsObject.drawBitmapRepeatY() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawBitmapRepeatY(图像,绘图RECT,上,右,下,左) #

垂直平铺
参数@1 为gdip.bitmap对象。
参数 @2 可用 ::RECT 结构体指定区块参数。
最后的四个参数指定坐标
如果指定了右坐标则忽略左坐标,
如果指定了下坐标则忽略上坐标

gdipgraphicsObject.drawBitmapTile() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawBitmapTile(图像,RECT区块) #

绘图,重复平铺显示。
参数 @2 可用 ::RECT 结构体指定区块参数。
注意该函数会在执行时设置裁剪区域
执行完重置裁剪区域

gdipgraphicsObject.drawCachedBitmap(缓存位图,x,y) #

输出缓存位图

gdipgraphicsObject.drawCurve(画笔,任意个坐标数值参数) #

画曲线
可添加任意个成对的数值参数指定曲线经过的坐标点

gdipgraphicsObject.drawCurve2(画笔,曲线强度,任意个坐标参数) #

画曲线
曲线强度为0画出来的就是直线,设为0.5则相当于调用drawCurve画出来的弯曲程度,
参数@3开始可添加2个以上的::POINTF结构体参数指定曲线经过的坐标点,也可以在参数@3里用一个 ::POINTF 结构体数组替代

注意drawCurve的参数是多个数值,而drawCurve2的参数是多个 ::POINTF 结构体,
而且要注意是::POINTF,不是::POINT

gdipgraphicsObject.drawEllipse() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawEllipse(pen,x,y,width,height) #

画圆形、或椭圆
x,y指定椭圆所在矩形的左上角,width指定宽度,height指定高度

gdipgraphicsObject.drawImage() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImage(图像,左,上,显示属性) #

绘图
可使使用参数@2,参数@3指定输出坐标
可选使用参数@4指定gdip.imageAttributes对象设置显示属性,
注意此函数忽略原图DPI

gdipgraphicsObject.drawImageCenter() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageCenter(图像,RECT区块,显示属性) #

绘图,保持图片大小并绝对居中显示。
参数 @2 可用 ::RECT 结构体指定区块参数。
可选使用参数@3指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImageExpand #

九宫格绘图,九宫格切图后边角四格固定,中间五格拉伸
该函数不会严格检查参数、并忽略执行错误,调用该函数前必须保证参数正确

gdipgraphicsObject.drawImageExpand() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageExpand(图像,绘图RECT,上,右,下,左,显示属性) #

参数@1为gdip.image或gdip.bitmap对象
参数@2使用::RECT结构体指定目标区块,
参数@3,@4,@5,@6指定九宫格切图坐标
可选使用参数@7指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImagePoint() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImagePoint(图像,RECT区块,x,y) #

绘图。
参数 @2 可用 ::RECT 结构体指定区块参数。
x,y指定偏移坐标
如果为0到1之间的值则为剩余空间百分比
如果为负数则为右下角坐标

gdipgraphicsObject.drawImagePointRect() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImagePointRect(图像, 输出左,输出上,左,上,宽,高) #

将图像的指定区块输出到指定坐标
注意该函数会受PNG,JPG的DPI设置影响输出大小

gdipgraphicsObject.drawImageRect() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageRect(图像,左,上,宽,高,显示属性) #

画图
参数@2,@3,@4,@5指定目标区块,
可选使用参数@6指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImageRectRect() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageRectRect(图像,输出左,输出上,输出宽,输出高,左,上,宽,高,显示属性) #

将图像的指定区块输出到指定区块
参数@2,@3,@4,@5指定目标区块,
参数@6,@7,@8,@9指定图像区块,
可选使用参数@10指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImageScale() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageScale(图像,RECT区块,显示属性) #

绘图
保持比例缩放到合适大小。
参数 @2 可用 ::RECT 结构体指定区块参数。
可选使用参数@3指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImageStretch() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageStretch(图像,RECT区块,显示属性) #

绘图,拉伸图片到区块大小。
参数 @2 可用 ::RECT 结构体指定区块参数。
可选使用参数@3指定gdip.imageAttributes对象设置显示属性

gdipgraphicsObject.drawImageWithDpi() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawImageWithDpi(图像,左,上) #

绘图
可使使用参数@2,参数@3指定输出坐标
注意该函数会受PNG,JPG的DPI设置影响输出大小

gdipgraphicsObject.drawLine #

画线

gdipgraphicsObject.drawLine() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawLine(pen,x1,y1,x2,y2) #

画线
参数 @pen 为 gdip.pen 对象,
参数 @x1,@y1,@x2,@y2 为坐标

gdipgraphicsObject.drawPath #

画路径

gdipgraphicsObject.drawPath() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawPath(pen,path) #

画路径
参数 @pen 为 gdip.pen 对象,
参数 @path 为 gdip.path 对象

gdipgraphicsObject.drawPie() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawPie(pen,x,y,width,height,startAngle,sweepAngle) #

画扇形、或椭圆
startAngle:起始角度,以度为单位从X轴顺时针测量,水平线右侧为0度,
sweepAngle:startAngle和弧线末尾之间的扫描角度

gdipgraphicsObject.drawPolygon() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawPolygon(pen,...) #

绘制多边形
pen 为画刷对象,
可使用一个数组,或多个参数指定多个绘图时经过的 ::POINTF 坐标对象

gdipgraphicsObject.drawRectangle #

画方块

gdipgraphicsObject.drawRectangle() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawRectangle(pen,x1,y1,width,height) #

画方块
参数 @pen 为 gdip.pen 对象,
参数 @x1,@y1 为坐标,
@width 为宽度,
@height 为高度

gdipgraphicsObject.drawString #

输出文本

gdipgraphicsObject.drawString() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawString(str,font,rectf,format,brush) #

输出文本
@str 参数为要输出的文本
@font 参数为 gdip.font字体对象,
@rectf 为RECTF结构体,也可以通过RECT结构体的float函数转换而得,
@format 为gdip.stringformat对象,用于指定输出格式,
@brush为 gdip.solidBrush创建的画刷对象

gdipgraphicsObject.fastDrawBitmap() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fastDrawBitmap(位图对象,x,y) #

快速绘图
x,y为可选参数,默认为0
返回自身

gdipgraphicsObject.fillEllipse() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillEllipse(brush,x,y,width,height) #

填充圆形、或椭圆
x,y指定椭圆所在矩形的左上角,width指定宽度,height指定高度

gdipgraphicsObject.fillPath() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillPath(brush,path) #

填充路径
brush为画刷对象,path为gdip.path路径对象

gdipgraphicsObject.fillPie() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillPie(brush,x,y,width,height,startAngle,sweepAngle) #

填充扇形、或椭圆
startAngle:起始角度,以度为单位从X轴顺时针测量,水平线右侧为0度,
sweepAngle:startAngle和弧线末尾之间的扫描角度

gdipgraphicsObject.fillPolygon #

画多边形

gdipgraphicsObject.fillPolygon() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillPolygon(brush,fillMode,...) #

填充多边形
brush 为画刷对象,fillMode使用_gdipFillMode前缀的常量指定,可省略
可使用一个数组,或多个参数指定多个绘图时经过的 ::POINTF 坐标对象

gdipgraphicsObject.fillRectangle #

填充方块

gdipgraphicsObject.fillRectangle() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillRectangle(brush,x1,y1,width,height) #

填充方块
参数 @pen 为 gdip.pen 对象,
参数 @x1,@y1 为坐标,
@width 为宽度,
@height 为高度

gdipgraphicsObject.getDc() #

返回GDI兼容设备句柄
注意返回的句柄一定要调用releaseDc函数释放

gdipgraphicsObject.getDpi() #

返回设备DPI
默认为96,96

gdipgraphicsObject.interpolationMode #

gdipgraphicsObject.interpolationMode = _GdipInterpolationMode/*放大缩小时使用的插值模式*/ ;

gdipgraphicsObject.measureString #

计算输出文本区块

gdipgraphicsObject.measureString() #

返回对象:rectfObject

gdipgraphicsObject.measureString(str,theFont,layoutRect,stringFormat) #

计算输出文本区块
@str 要计算的字符串
@theFont 字体,gdip.font 对象
@layoutRect ::RECTF 结构体
@stringFormat gdip.stringformat 文本格式对象

返回值 boundingBox RECTF 结构体,表示围绕输出字符串的边界
返回值 codepointsFitted 输出字符数
返回值 linesFilled 输出行数

gdipgraphicsObject.pageUnit #

gdipgraphicsObject.pageUnit = _GdipUnit/*页面单位,例如打印时指定_UnitPixel则使用像素作为单位*/ ;

gdipgraphicsObject.pixelOffsetMode #

gdipgraphicsObject.pixelOffsetMode = _GdipPixelOffsetMode/*像素偏移模式*/;

gdipgraphicsObject.releaseDc(hdc) #

释放GDI兼容设备句柄

gdipgraphicsObject.resetClip() #

取消剪辑

返回对象:gdipgraphicsObject

gdipgraphicsObject.resetTransform() #

重置所有画布变换
用于恢复scale,rotate,translate等画布变换效果,

返回对象:gdipgraphicsObject

gdipgraphicsObject.restore(/*状态索引*) #

恢复到指定状态,
状态索引值由save()函数的返回值获得
不指定参数则撤消最近一次存储状态

gdipgraphicsObject.rotate #

旋转画布

gdipgraphicsObject.rotate() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.rotate(旋转角度,选项) #

以左上角坐标为参考点旋转画布
参数@2可省略,选项默认为 _GdipMatrixOrderPrepend

gdipgraphicsObject.rotateRect #

旋转画布

gdipgraphicsObject.rotateRect(rect,angle,order) #

以 @rect 指定的区块中点为参考点旋转画布,
@rect 参数可用 ::RECT 结构体指定区块位置。
参数 @angle 为旋转角度
参数 @3 可省略,选项默认为 _GdipMatrixOrderPrepend

gdipgraphicsObject.save() #

存储状态,并返回状态索引( 可作为restore()函数的参数 )

gdipgraphicsObject.scale #

缩放画布

gdipgraphicsObject.scale() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.scale(宽度缩放比例,高度缩放比例,选项) #

缩放画布
参数@3可省略,默认为 _GdipMatrixOrderPrepend

gdipgraphicsObject.scaleRect #

居中缩放画布

gdipgraphicsObject.scaleRect() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.scaleRect(区块,宽度缩放比例,高度缩放比例,选项) #

在参数@1中使用::RECT结构体指定区块,并以该区块的中点为中心缩放画布
参数@3可省略,默认为 _GdipMatrixOrderPrepend

gdipgraphicsObject.setClipPath() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.setClipPath(路径对象,选项 #

设置剪切路径
选项默认为 _GdipCombineModeReplace

gdipgraphicsObject.setClipRect() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.setClipRect(左,上,宽,高,选项) #

设置一块剪辑区域,用于限制绘图范围
选项使用 GdipCombineMode_ 前缀的常量指定

gdipgraphicsObject.setClipRegion(region,combineMode) #

设置一块剪辑区域,用于限制绘图范围。
参数 @region 指定 gdip.region 区域对象。
参数 @combineMode 可指定为 _GdipCombineMode 前缀的常量

gdipgraphicsObject.smoothingMode #

gdipgraphicsObject.smoothingMode = _GdipSmoothingMode/*平滑模式,可用于抗锯齿, 文本抗锯齿请使用textRenderingHint*/;

gdipgraphicsObject.textRenderingHint #

gdipgraphicsObject.textRenderingHint = _GdipTextRenderingHint/*文本的呈现模式,可用于抗锯齿*/;

gdipgraphicsObject.transform() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.transform(变换模式,图像,RECT区块,x,y) #

变换画布
变换以后必须假定画布左上角坐标为0,画布大小为图像大小,
变换模式为字符串参数,支持 point,stretch,center,scale,含义与 plus 控件相同
模式为"expand"时转换为"stretch",传入其他模式忽略并返回null,
否则执行变换并返回画布对像自身,

如果指定了point模式,必须同时指定x,y参数,用法与plus控件相同。
可用 ::RECT 结构体指定 RECT 区块参数

gdipgraphicsObject.translate #

水平偏移画布

gdipgraphicsObject.translate() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.translate(水平偏移像素,垂直偏移像素,选项) #

平移画布
参数@3可省略,默认为 _GdipMatrixOrderPrepend

graphics 成员列表 #

该变量名仅适用于表示gdip.graphics对象

返回对象:gdipgraphicsObject

Markdown 格式