MUSHclient documentation: WindowDrawImage

WindowDrawImage

WindowDrawImage
Script function world.WindowDrawImage Read about scripting Type Method Summary Draws an image into a miniwindow Prototype `long WindowDrawImage(BSTR Name, BSTR ImageId, long Left, long Top, long Right, long Bottom, short Mode, long SrcLeft, long SrcTop, long SrcRight, long SrcBottom);` View list of data type meanings Description This copies an image to the miniwindow. Note that changes to miniwindows will not become visible until the output window is redrawn. This happens when new (visible) lines arrive from the MUD, or if you call WindowShow, or Redraw. Parameters: Name - the name of an existing miniwindow. ImageId - an image id that you have loaded. Left, Top, Right, Bottom - describes the rectangle to be drawn to. Mode - the method of drawing the image: 1 - Copy without stretching to the destination position. The image is not clipped, so only the Left and Top parameters are used - the full image is copied to that position. To copy less than the full image you would need to use the SrcLeft, SrcTop, SrcRight, SrcBottom parameters to specify a smaller part of the image. 2 - Stretch or shrink the image appropriately to fit into the rectangle: Left, Top, Right, Bottom. 3 - Copy without stretching to the position Left, Top. However this is a transparent copy, where the pixel at the left,top corner (pixel position 0,0) is considered the transparent colour. Any pixels that exactly match that colour are not copied. WARNING - do not choose black or white as the transparent colour as that throws out the calculations. Choose some other colour (eg. purple) - you won't see that colour anyway. SrcLeft, SrcTop, SrcRight, SrcBottom - the source rectangle in the original image (use 0,0,0,0 to get the whole image). Negative numbers for the SrcRight and SrcBottom parameters represent an offset from the bottom or right edge. The intention of allowing sub-images was so that you could make up a map by having lots of small images (eg. houses, trees, rocks). Now instead of having to load hundreds of tiny image files into memory, which would doubtless take a while to open all those files, you open a single, larger, file in which the various sub-images are "tiled". For example, you might allocate a 32 x 32 pixel square for each image. Now by selecting the appropriate tile you can copy the sub-image from the main image. For more information, see: http://www.gammon.com.au/mushclient/mw_images.htm To draw images which have alpha channels, see WindowDrawImageAlpha. Note that if you draw a monchrome image, such as one set up by WindowCreateImage then the pen colour from the most recent drawing operation is used as the foreground colour, and the brush colour for the background colour. Thus you may want to draw a small rectangle (eg. 1 x 1 pixel) with WindowCircleOp to establish those colours first. Lua example `WindowDrawImage (win, "im", 20, 20, 0, 0, 1) -- straight copy WindowDrawImage (win, "im", 20, 20, -20, -20, 2) -- stretch WindowDrawImage (win, "im", 20, 20, -20, -20, 3) -- transparent` Return value `eNoSuchWindow - no such miniwindow eImageNotInstalled - that image was not loaded with WindowLoadImage or WindowLoadImageMemory eBadParameter - drawing mode not in list above eOK - completed OK` View list of return code meanings See Also ... Topic Mini Windows Functions GetDeviceCaps (Gets screen device capabilities) SetCursor (Changes the shape of the mouse cursor) TextRectangle (Specifies the size of the rectangle in which text is displayed in the output window.) WindowAddHotspot (Adds a hotspot to a miniwindow) WindowArc (Draws an arc in a miniwindow) WindowBezier (Draws a Bézier curve in a miniwindow) WindowBlendImage (Blends an image into a miniwindow, using a specified blending mode) WindowCircleOp (Draws ellipses, filled rectangles, round rectangles, chords, pies in a miniwindow) WindowCreate (Creates a miniwindow) WindowCreateImage (Creates an image in a miniwindow) WindowDelete (Deletes a miniwindow) WindowDeleteAllHotspots (Deletes all hotspots from a miniwindow) WindowDeleteHotspot (Deletes a hotspot from a miniwindow) WindowDragHandler (Adds a drag handler to a miniwindow hotspot) WindowDrawImage (Draws an image into a miniwindow) WindowDrawImageAlpha (Draws an image into a miniwindow respecting the alpha channel) WindowFilter (Performs a filtering operation over part of the miniwindow.) WindowFont (Loads a font into a miniwindow) WindowFontInfo (Returns information about a font) WindowFontList (Lists all fonts loaded into a miniwindow) WindowGetPixel (Gets the colour of a single pixel in a miniwindow) WindowGradient (Draws a gradient in a rectangle) WindowHotspotInfo (Returns information about a hotspot) WindowHotspotList (Lists all hotspots installed into a miniwindow) WindowHotspotTooltip (Changes the tooltip text for a hotspot in a miniwindow) WindowImageFromWindow (Creates an image from another miniwindow) WindowImageInfo (Returns information about an image) WindowImageList (Lists all images installed into a miniwindow) WindowImageOp (Draws an ellipse, rectangle or round rectangle, filled with an image) WindowInfo (Returns information about a miniwindow) WindowLine (Draws a line in a miniwindow) WindowList (Lists all miniwindows) WindowLoadImage (Loads an image into a miniwindow from a disk file) WindowMenu (Creates a pop-up menu inside a miniwindow) WindowMergeImageAlpha (Merges an image into a miniwindow based on an alpha mask) WindowPolygon (Draws a polygon in a miniwindow) WindowPosition (Moves a miniwindow) WindowRectOp (Draws a rectangle in a miniwindow) WindowSetPixel (Sets a single pixel in a miniwindow to the specified colour) WindowShow (Shows or hides a miniwindow) WindowText (Draws text into a miniwindow) WindowTextWidth (Calculates the width of text in a miniwindow) WindowWrite (Writes the contents of a miniwindow to disk as a graphics file) (Help topic: function=WindowDrawImage) Documentation contents page

Script function

world.WindowDrawImage

Read about scripting

Type

Method

Summary

Draws an image into a miniwindow

Prototype

long WindowDrawImage(BSTR Name, BSTR ImageId, long Left, long Top, long Right, long Bottom, short Mode, long SrcLeft, long SrcTop, long SrcRight, long SrcBottom);

View list of data type meanings

Description

This copies an image to the miniwindow.



Note that changes to miniwindows will not become visible until the output window is redrawn. This happens when new (visible) lines arrive from the MUD, or if you call WindowShow, or Redraw.



Parameters:



Name - the name of an existing miniwindow.



ImageId - an image id that you have loaded.



Left, Top, Right, Bottom - describes the rectangle to be drawn to.



Mode - the method of drawing the image:



1 - Copy without stretching to the destination position. The image is not clipped, so only the Left and Top parameters are used - the full image is copied to that position.



To copy less than the full image you would need to use the SrcLeft, SrcTop, SrcRight, SrcBottom parameters to specify a smaller part of the image.



2 - Stretch or shrink the image appropriately to fit into the rectangle: Left, Top, Right, Bottom.



3 - Copy without stretching to the position Left, Top. However this is a transparent copy, where the pixel at the left,top corner (pixel position 0,0) is considered the transparent colour. Any pixels that exactly match that colour are not copied. WARNING - do not choose black or white as the transparent colour as that throws out the calculations. Choose some other colour (eg. purple) - you won't see that colour anyway.



SrcLeft, SrcTop, SrcRight, SrcBottom - the source rectangle in the original image (use 0,0,0,0 to get the whole image). Negative numbers for the SrcRight and SrcBottom parameters represent an offset from the bottom or right edge.



The intention of allowing sub-images was so that you could make up a map by having lots of small images (eg. houses, trees, rocks). Now instead of having to load hundreds of tiny image files into memory, which would doubtless take a while to open all those files, you open a single, larger, file in which the various sub-images are "tiled". For example, you might allocate a 32 x 32 pixel square for each image. Now by selecting the appropriate tile you can copy the sub-image from the main image.



For more information, see:



http://www.gammon.com.au/mushclient/mw_images.htm



To draw images which have alpha channels, see WindowDrawImageAlpha.



Note that if you draw a monchrome image, such as one set up by WindowCreateImage then the pen colour from the most recent drawing operation is used as the foreground colour, and the brush colour for the background colour. Thus you may want to draw a small rectangle (eg. 1 x 1 pixel) with WindowCircleOp to establish those colours first.

Lua example

WindowDrawImage (win, "im", 20, 20, 0, 0, 1)  -- straight copy

WindowDrawImage (win, "im", 20, 20, -20, -20, 2)  -- stretch

WindowDrawImage (win, "im", 20, 20, -20, -20, 3)  -- transparent

Return value

eNoSuchWindow - no such miniwindow

eImageNotInstalled - that image was not loaded with WindowLoadImage or WindowLoadImageMemory

eBadParameter - drawing mode not in list above

eOK - completed OK