[ Main Menu ] [ Extension Tools Menu ] [ Professional Edition Menu ]

<iIMAGESTRETCH> Tag


<iIMAGESTRETCH
DSTNAME=""
SRCNAME=""
X1=""
Y1=""
X2=""
Y2=""
W1=""
H1=""
W2=""
H2=""
>

UsageThis tag copies a rectangular portion of one image to another image. DSTNAME is the destination image, SRCNAME is the source image identifier. If the source and destination coordinates and width and heights differ, appropriate stretching or shrinking of the image fragment will be performed. The coordinates refer to the upper left corner. This function can be used to copy regions within the same image (if DSTNAME is the same as SRCNAME) but if the regions overlap the results will be unpredictable.
The X1 and Y1 arguments specify the point in the destination image to which the region will be copied. The X2 and Y2 arguments specify the upper left corner of the region in the source image. The W1 and H1 arguments specify the width and height of the destination region. The W2 and H2 arguments specify the width and height of the source region and can differ from the destination size allowing a region to be scaled during the copying process.
Important note on copying between images: since images do not necessarily have the same color tables pixels are not simply set to the same color index values to copy them. iIMAGECOPY will attempt to find an identical RGB value in the destination image for each pixel in the copied portion of the source image.


Top