Layer.stretchCopy

功能/含义
缩放复制
类型
Layer类的成员方法
语法
stretchCopy(dleft, dtop, dwidth, dheight, src, sleft, stop, swidth, sheight, type=stNearest)
参数
dleft  指定复制目标矩形的左端位置(目标层的图像坐标位置),以像素为单位。
dtop  指定复制目标矩形的顶端位置(目标层的图像坐标位置),以像素为单位。
dwidth  指定目标矩形的宽度(目标层的图像坐标位置),以像素为单位。
dheight  指定目标矩形的高度(目标层的图像坐标位置),以像素为单位。
src  指定要复制的层对象。
sleft  指定要复制的矩形的左端位置(在来源图层的图像坐标位置),以像素为单位。
stop  指定要复制的矩形的顶端位置(在来源图层的图像坐标位置),以像素为单位。
swidth  指定要复制的矩形的宽度(在来源层的图像坐标位置),以像素为单位。
sheight  指定要复制的矩形的高度(在来源层的图像坐标位置),以像素为单位。
type  指定缩放的类型。
stNearest : 使用最邻近点法
stFastLinear : 使用低精度线性插值(部分实现)
stLinear : 使用线性插值(未实现)
stCubic : 使用三维插值(未实现)
 速度按 stNearest > stFastLinear > stLinear > stCubic 的顺序由高到低,而画质随速度提高而降低。
 对于stFastLinear、stLinear、stCubic,可以和stRefNoClip进行按位或运算进行旗标追加,在这种情况下,允许参照要复制的位图的区域外的部分来合成颜色。如果未指定,则即使源位图周围有余量,也不会参照源位图的范围外(超出范围的颜色将被视为最接近的像素颜色)的颜色。
返回值
无 (void)
说明
 将指定的来源层矩形复制到目标(执行方法的层)矩形。如果来源矩形和目标矩形的大小不同,则放大或缩小。
 在当前版本中,stFastLinear中的线性插值的起作用的是,叠加层(执行方法)的Layer.face 属性为dfAlpha(或dfBoth)或dfAddAlpha的情况。此外,当Layer.face 属性为 dfOpaque 且Layer.holdAlpha 属性为假值时,也可以进行线性插值。
 此外,在当前版本中,指定stLinear或stCubic仅在目标矩形不出现在图层之外时,且不存在水平/垂直翻转才有效。
 如果目标(执行方法)层的 Layer.face 属性为 dfAlpha (或是 dfBoth) 或是 dfAddAlpha,则同时复制主图像和遮罩图像。
 对于dfOpaque (或是 dfMain) ,Layer.holdAlpha属性为真值时仅复制主图像,为假值时同时复制主图像和遮罩图像。