http://wiki.spheredev.org/index.php?action=history&feed=atom&title=Legacy%3AFunctions%2FImages 2026-11-08T01:02:16Z Revision history for this page on the wiki MediaWiki 1.43.9 http://wiki.spheredev.org/index.php?title=Legacy:Functions/Images&diff=482&oldid=prev 2013-05-22T17:34:23Z

<p>created</p> <p><b>New page</b></p><div>== Images ==<br /> <br /> * Sphere [[API:Image|Image]] object: Holds a 2D bitmap for displaying.<br /> * [[API:LoadImage|LoadImage]](&#039;&#039;filename&#039;&#039;): Load an image from &#039;&#039;filename&#039;&#039;.<br /> * [[API:GrabImage|GrabImage]](&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;, &#039;&#039;width&#039;&#039;, &#039;&#039;height&#039;&#039;): Grab the screen contents at (&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;, &#039;&#039;width&#039;&#039;, &#039;&#039;height&#039;&#039;) and store it in a new Image object.<br /> <br /> === System images ===<br /> <br /> * [[API:GetSystemArrow|GetSystemArrow]](): Get the right-pointing arrow image that comes with the Sphere engine.<br /> * [[API:GetSystemUpArrow|GetSystemUpArrow]](): Get the up-pointing arrow image that comes with the Sphere engine.<br /> * [[API:GetSystemDownArrow|GetSystemDownArrow]](): Get the down-pointing arrow image that comes with the Sphere engine.<br /> <br /> === Image object ===<br /> <br /> * [[API:Image/clone|Image.clone]](): returns a copy of &#039;image_object&#039;<br /> <br /> ==== Blitting (drawing) images ====<br /> <br /> * [[API:Image/blit|Image.blit]](&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;): Draw the image with the top-left corner at (&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;).<br /> * [[API:Image/blitMask|Image.blitMask]](&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;, &#039;&#039;mask&#039;&#039;): Draw the image at (&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;) with &#039;&#039;mask&#039;&#039; as the tinting color.<br /> * [[API:Image/rotateBlit|Image.rotateBlit]](&#039;&#039;center_x&#039;&#039;, &#039;&#039;center_y&#039;&#039;, &#039;&#039;angle&#039;&#039;): Draw the image centered at (&#039;&#039;center_x&#039;&#039;, &#039;&#039;center_y&#039;&#039;), rotated by &#039;&#039;angle&#039;&#039; radians.<br /> * [[API:Image/rotateBlitMask|Image.rotateBlitMask]](&#039;&#039;center_x&#039;&#039;, &#039;&#039;center_y&#039;&#039;, &#039;&#039;angle&#039;&#039;, &#039;&#039;mask&#039;&#039;): [[API:Image/rotateBlit|rotateBlit]] + mask.<br /> * [[API:Image/zoomBlit|Image.zoomBlit]](&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;, &#039;&#039;factor&#039;&#039;): Draw the image zoomed by &#039;&#039;factor&#039;&#039; with the top-left corner at (&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;).<br /> * [[API:Image/zoomBlitMask|Image.zoomBlitMask]](&#039;&#039;x&#039;&#039;, &#039;&#039;y&#039;&#039;, &#039;&#039;factor&#039;&#039;, &#039;&#039;mask&#039;&#039;): [[API:Image/zoomBlit|zoomBlit]] + mask.<br /> * [[API:Image/transformBlit|Image.transformBlit]](&#039;&#039;x1&#039;&#039;, &#039;&#039;y1&#039;&#039;, &#039;&#039;x2&#039;&#039;, &#039;&#039;y2&#039;&#039;, &#039;&#039;x3&#039;&#039;, &#039;&#039;y3&#039;&#039;, &#039;&#039;x4&#039;&#039;, &#039;&#039;y4&#039;&#039;): Draw the image with top-left (&#039;&#039;x1&#039;&#039;, &#039;&#039;y1&#039;&#039;), top-right (&#039;&#039;x2&#039;&#039;, &#039;&#039;y2&#039;&#039;), bottom-right (&#039;&#039;x3&#039;&#039;, &#039;&#039;y3&#039;&#039;) and bottom-left (&#039;&#039;x4&#039;&#039;, &#039;&#039;y4&#039;&#039;).<br /> * [[API:Image/transformBlitMask|Image.transformBlitMask]](&#039;&#039;x1&#039;&#039;, &#039;&#039;y1&#039;&#039;, &#039;&#039;x2&#039;&#039;, &#039;&#039;y2&#039;&#039;, &#039;&#039;x3&#039;&#039;, &#039;&#039;y3&#039;&#039;, &#039;&#039;x4&#039;&#039;, &#039;&#039;y4&#039;&#039;, &#039;&#039;mask&#039;&#039;): Draw the image stretched to fit 4 coordinates clockwise from the top-left, with a masking color.<br /> <br /> ==== Surface conversion ====<br /> <br /> * [[API:Image/createSurface|Image.createSurface]](): Create a new [[API:Surface|Surface]] using the picture data in the image.</div>

Apollolux