_________ __ __ / _____// |_____________ _/ |______ ____ __ __ ______ \_____ \\ __\_ __ \__ \\ __\__ \ / ___\| | \/ ___/ / \| | | | \// __ \| | / __ \_/ /_/ > | /\___ \ /_______ /|__| |__| (____ /__| (____ /\___ /|____//____ > \/ \/ \//_____/ \/ ______________________ ______________________ T H E W A R B E G I N S Stratagus - A free fantasy real time strategy game engine
#include <graphics.h>
Public Types | |
enum | { LEFT = 0, CENTER, RIGHT } |
Public Member Functions | |
Graphics () | |
virtual | ~Graphics () |
virtual void | _beginDraw () |
virtual void | _endDraw () |
virtual bool | pushClipArea (Rectangle area) |
virtual void | popClipArea () |
virtual const ClipRectangle & | getCurrentClipArea () |
virtual void | drawImage (const Image *image, int srcX, int srcY, int dstX, int dstY, int width, int height)=0 |
virtual void | drawImage (const Image *image, int dstX, int dstY) |
virtual void | drawPoint (int x, int y)=0 |
virtual void | drawLine (int x1, int y1, int x2, int y2)=0 |
virtual void | drawRectangle (const Rectangle &rectangle)=0 |
virtual void | fillRectangle (const Rectangle &rectangle)=0 |
virtual void | setColor (const Color &color)=0 |
virtual const Color & | getColor ()=0 |
virtual void | setFont (Font *font) |
virtual void | drawText (const std::string &text, int x, int y, unsigned int alignment=LEFT, bool is_normal=true) |
Protected Attributes | |
std::stack< ClipRectangle > | mClipStack |
Font * | mFont |
Used for drawing graphics. It contains all vital functions for drawing. We include implemented Graphics classes for some common platforms like the Allegro library, the OpenGL library and the SDL library. To make Guichan usable under another platform, a Graphics class must be implemented.
In Graphics you can set clip areas to limit drawing to certain areas of the screen. Clip areas are put on a stack, which means that you can push smaller and smaller clip areas onto the stack. All coordinates will be relative to the topmost clip area. In most cases you won't have to worry about the clip areas, unless you want to implement some really complex widget. Pushing and poping of clip areas are handled automatically by container widgets when their child widgets are drawn.
IMPORTANT: Remember to pop each clip area that you pushed on the stack after you are done with it.
If you feel that Graphics is to restrictive for your needs, there is no one stopping you from using your own code for drawing in Widgets. You could for instance use pure SDL in the drawing of Widgets bypassing Graphics. This might however hurt portability of your application.
If you implement a Graphics class not present in Guichan we would be very happy to add it to Guichan.
gcn::Graphics::Graphics | ( | ) |
|
inlinevirtual |
|
inlinevirtual |
Initializes drawing. Called by the Gui when Gui::draw() is called. It is needed by some implementations of Graphics to perform preparations before drawing. An example of such an implementation would be OpenGLGraphics.
NOTE: You will never need to call this function yourself. Gui will do it for you.
Reimplemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
inlinevirtual |
Deinitializes drawing. Called by the Gui when a Gui::draw() is done. done. It should reset any state changes made by _beginDraw().
NOTE: You will never need to call this function yourself. Gui will do it for you.
Reimplemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
pure virtual |
Draws a part of an Image.
NOTE: Width and height arguments will not scale the Image but specifies the size of the part to be drawn. If you want to draw the whole Image there is a simplified version of this function.
EXAMPLE:
Will draw a rectangular piece of myImage starting at coordinate (10, 10) in myImage, with width and height 40. The piece will be drawn with it's top left corner at coordinate (20, 20).
image | the Image to draw. |
srcX | source Image x coordinate. |
srcY | source Image y coordinate. |
dstX | destination x coordinate. |
dstY | destination y coordinate. |
width | the width of the piece. |
height | the height of the piece. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
virtual |
Draws an image. A simplified version of the other drawImage. It will draw a whole image at the coordinate you specify. It is equivalent to calling:
|
pure virtual |
Ddraws a line.
x1 | the first x coordinate. |
y1 | the first y coordinate. |
x2 | the second x coordinate. |
y2 | the second y coordinate. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
pure virtual |
Draws a single point/pixel.
x | the x coordinate. |
y | the y coordinate. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
pure virtual |
Draws a simple, non-filled, Rectangle with one pixel width.
rectangle | the Rectangle to draw. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
virtual |
Draws text.
text | the text to draw. |
x | the x coordinate where to draw the text. |
y | the y coordinate where to draw the text. |
alignment | Graphics::LEFT, Graphics::CENTER or Graphics::RIGHT. |
|
pure virtual |
Draws a filled Rectangle.
rectangle | the filled Rectangle to draw. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
pure virtual |
Gets the Color to use when drawing.
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
virtual |
Gets the current ClipArea. Usefull if you want to do drawing bypassing Graphics.
|
virtual |
Removes the topmost clip area from the stack.
Exception | if the stack is empty. |
Reimplemented in gcn::SDLGraphics.
|
virtual |
Pushes a clip area onto the stack. The x and y coordinates in the Rectangle will be relative to the last pushed clip area. If the new area falls outside the current clip area, it will be clipped as necessary.
area | the clip area to be pushed onto the stack. |
Reimplemented in gcn::SDLGraphics.
|
pure virtual |
Sets the Color to use when drawing.
color | a Color. |
Implemented in gcn::SDLGraphics, and MyOpenGLGraphics.
|
virtual |
Sets the font to use when drawing text.
font | the Font to use when drawing. |
|
protected |
|
protected |