------------------NOTICE-------------------------------* Software ID: graphex.ew Version: 0.10.5 29/November/2006 Copyright: (c) 2006 Gary Shingles All rights reserved. Licence: This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. 2. If you use this software in a product, acknowedgement in the product's documenation and binary are required. 3. Altered source versions, and works substantially derived from the it, must... a) be plainly be marked as such, b) not be misrepresented as the original software, c) include this notice, unaltered. ------------------End of NOTICE------------------------*
Topic | Description |
Index | Alphabetical list of all items. |
0_StartHere | The graphex.ew system is generalised buffered drawing system on top of win32lib. |
1_Goals | The main aim of graphex is to ease the use of simple graphics in a win32lib application. |
2_Contributors | Many thanks to RDS for Euphoria, the community at EUForum and the win32lib team. |
3_History | A brief chronology, see also changelog.txt: |
Colour | How to use colours with graphex.ew |
Data | Accessing data associated with a gfx object |
Drawing | Information about the gfx_draw(..) routine. |
Font | Drawing text on a gfx. |
Internal | Info for people interested in the internals of graphex.ew |
Misc | Misc stuff :) |
Painting | There are two ways to draw with this system, rely on AutoPainting see setGfxAutoPaint or call doGfxPaint to do all needed painting at one time (which is usually better) |
Shape | Shapes are shapes, sprites have a location |
Sprite | A sprite is a shape with starting coordinates |
TODO | List of things to do to improve this system. |
Utils | Useful routines |
var
] Controls whether auto painting will occur or notvar
] Empty gfx objectproc
] removes all references to gfxid from the dirty_rects structurevar
] Compass point directions for (currently faulty) gfxSpriteOverlapvar
] tracks currently selected fontvar
] A sequence of areas that need redrawing during every WM_PAINTproc
] Have Windows draw any updates to any gfx in the specified windowvar
] Sequence indices for the dirty rectangle systemfunc
] Get a list of known font namesvar
] Routines dealing with getting the gfx's drawnvar
] This is the calculated width of a font charactervar
] This is the calculated height of the font charactersproc
] forces repainting of all gfxs in the specified windowproc
] Manually add a dirty rectangle to the system (see DR_*)proc
] Attach a handler for an event to the gfxfunc
] Get the win32lib id of the Pixmap buffer of the gfxproc
] Draw a single character of colour at x,y on the gfxproc
] Clears a gfx to the specified colourfunc
] Synonym for gfxColourfunc
] Retreive a colour from the gfx_colour sequence using Euphoria colour constantsfunc
] Get the id of the Bitmap control associated with the gfxproc
] Destroy a gfx when you are finished with itvar
] sequence holding sequences of gfx-fontsfunc
] Get the height of the gfx objectfunc
] Returns w32True if the gfx object is hiddenproc
] Set the hidden status of the gfx object. Supply w32True or w32Falsefunc
] Get the parent win32lib id of the gfxfunc
] Determine if point_x, point_y is inside the rectangle rectfunc
] Call to determine whether point_x, point_y is within a sprite (which is a shape data with location coordinates in the form of {x, y, {shape_data}}. Not to be confused with gfxPointInRect which determines if a point is in a rectangular area.proc
] Analogue of repaintRect :proc
] Resize the gfx to new width, new heightvar
] func
] Scales a shape in sizefunc
] Finds the bounding rectangle dimensions of shape datafunc
] Finds the actual bounding rectangle coordinates of a spritefunc
] Find out how, if at all, sprite1 overlaps sprite2.proc
] Draw text in the line drawing font at x,y in one colour on the gfxproc
] Update the internal state of a gfx after changing the size or location of the gfx controlfunc
] Get the width of a Gfx objectfunc
] Get the X coordinate of the gfx object in its parentfunc
] Get the Y coordinate of the gfx object in its parentvar
] var
] Synonym for gfx_colourvar
] Global sequence of 'DOS like' coloursproc
] The main generalised drawing procedurefunc
] The w32HPaint hander for each gfx objectvar
] Sequence length verificationfunc
] get the index into the gfxs sequence of the gfx with id gfx_idconst
] GP are constants for "graphex primitives"var
] Synonym for GRAYfunc
] Round to nearest integervar
] unique id counter for gfxsfunc
] Creates a new gfx objectvar
] Routine id of the character drawing routinefunc
] Get the full screen height availablefunc
] Get the full screen size available widthproc
] Turn on or off AutoPaintingfunc
] Select the font by name.func
] Change the size of the font characters that will be drawn by a gfxCharOutAt or gfxTextOutAtfunc
] Find the greatest encompassing rectangle of all the dirty_rects