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,上,右,下,左)
支持模式 auto,expand,stretch,center,scale,tile,repeat-x,repeat-y
所有模式请参考 plus 控件背景模式属性说明，
auto 模式指图像超过绘图区则居中，否则缩放。
该函数不检查参数正确性,调用者有责任保证参数正确
参数 @3 可用 ::RECT 结构体指定区块参数。
可选使用参数@8指定 gdip.imageAttributes 对象设置显示属性
tile,repeat-x,repeat-y 三种模式忽略显示属性,
函数返回自身
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
gdipgraphicsObject.width
宽度
graphics 成员列表
该变量名仅适用于表示gdip.graphics对象
返回对象:gdipgraphicsObject
Markdown 格式