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/*ARGB 颜色值*/) #

用指定的颜色清空画板

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 模式指图像超过绘图区则居中,否则缩放。
expand 模式可选使用 上,右,下,左参数指定切图位置。
repeat-x,repeat-y 可选使用 上,右,下,左 指定输出边距。

此函数不检查参数正确性,调用者有责任保证参数正确
参数 @3 可用 ::RECT 结构体指定区块参数。
可选使用参数 @8 指定 gdip.imageAttributes 对象设置显示属性
tile,repeat-x,repeat-y 三种模式忽略显示属性,
可选用 dpiScaleX,dpiScaleY 指定 DPI 缩放系数。
函数返回自身

gdipgraphicsObject.drawBezier #

画贝塞尔曲线

gdipgraphicsObject.drawBezier(pen,point1,point2,point3,point4) #

画贝塞尔曲线。
参数 @point1 到 @point4 可指定为 ::POINTF 结构体或者包含 x,y 字段的普通表对象。
四个坐标点分别为:起始锚点,起始控制点,结束锚点,结束控制点。

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(pen,points...) #

画曲线。

gdipgraphicsObject.drawCurve(pen,x1,y1,y2,y2...) #

画曲线。

gdipgraphicsObject.drawCurve2(pen,tension,points...) #

画曲线。

gdipgraphicsObject.drawCurve2(pen,tension,x1,y1,y2,y2...) #

画曲线。

gdipgraphicsObject.drawEllipse() #

返回对象:gdipgraphicsObject

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

画圆形、或椭圆。
参数 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,pioint1,point1) #

画线。

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

画线。

gdipgraphicsObject.drawPath #

画路径

gdipgraphicsObject.drawPath() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawPath(pen,path) #

画路径

gdipgraphicsObject.drawPie() #

返回对象:gdipgraphicsObject

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

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

gdipgraphicsObject.drawPolygon #

绘制闭合的多边形。
如果要绘制不闭合的多段线(折线)请改用 drawPolyline 方法。

gdipgraphicsObject.drawPolygon() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawPolygon(pen,points...) #

绘制多边形。

gdipgraphicsObject.drawPolygon(pen,x1,y1,y2,y2...) #

绘制多边形。

gdipgraphicsObject.drawPolyline #

绘制折线(多段线)。
注意 drawPolyline 方法绘制的多段线是不闭合的,而 drawPolygon 方法绘制的多边形是闭合的。

gdipgraphicsObject.drawPolyline(pen,points...) #

gdipgraphicsObject.drawPolyline(pen,x1,y1,y2,y2...) #

gdipgraphicsObject.drawRectangle #

画方块

gdipgraphicsObject.drawRectangle() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.drawRectangle(pen,rect) #

画方块
参数 @pen 为 gdip.pen 对象,
参数 @rect 可指定 ::RECT 或 RECTF 结构体。

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,rect) #

填充圆形、或椭圆。
参数 @rect 可指定 ::RECT 或 RECTF 结构体。

gdipgraphicsObject.fillEllipse(brush,rectt) #

填充圆形、或椭圆。
参数 @rect 可指定 ::RECT 或 RECTF 结构体。

gdipgraphicsObject.fillPath #

填充路径

gdipgraphicsObject.fillPath() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillPath(brush,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,points...) #

填充多边形。

gdipgraphicsObject.fillPolygon(brush,fillMode,x1,y1,y2,y2...) #

填充多边形。

gdipgraphicsObject.fillPolygon(brush,points,fillMode) #

填充多边形。

gdipgraphicsObject.fillRectangle #

填充方块

gdipgraphicsObject.fillRectangle() #

返回对象:gdipgraphicsObject

gdipgraphicsObject.fillRectangle(brush,rect) #

填充方块
参数 @pen 为 gdip.pen 对象,
参数 @rect 可指定 ::RECT 或 RECTF 结构体。

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 为旋转角度,省略或传 null 值则设为 0。
参数 @order 可省略,选项默认为 _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 格式