PrevNextUpHome BREW C++ Class Library & GUI Framework & XML Middleware : SophiaFramework 4.1
SFXGraphics
Class for drawing graphics.
#include <SFXGraphics.h.hpp>
class SFXGraphics;
SFMTYPEDEFCLASS(SFXGraphics)

Collaboration diagram

 Collaboration diagram of SFXGraphicsClass

Description

The SFXGraphics class is the class that abstracts the SFBGraphics and SFBDisplay classes, and is used to draw graphics.

The SFXGraphics class makes it easy to move the origin of coordinate, perform clipping, set colors, etc. To use the SFXGraphics class, first of all create the SFXGraphics instance by the SFXGraphics::GetInstance function.

[Note] Note
You do not need to destroy the SFXGraphics instance.
[Caution] Caution

If the SFBDisplay class is used directly, there is a possibility that the content of settings might be overwritten.

Reference

SFBGraphics | SFBDisplay

Member

Public Functions
Void BitBlt( SFXRectangleConstRef rectangle , SFBBitmapSmpConstRef bitmap , SFXGridConstRef grid , AEERasterOp raster = AEE_RO_COPY )
BitBlt( SFXRectangleConstRef rectangle , SFBBitmapSmpConstRef bitmap , AEERasterOp raster = AEE_RO_COPY )
Transfer the bitmap to the rectangular area.
Void ClearRectangle( SFXRectangleConstRef rectangle )
ClearRectangle( SFXRectangleConstRef rectangle , SFXRGBColorConstRef color )
Clear a rectangular area by filling it with the background color.
SFBBitmapSmp CloneBitmap( SFXRectangleConstRef param )
Create a new bitmap based on the content of the currently drawn bitmap.
static
SFBBitmapSmp
CreateBitmap( SFXSizeConstRef param )
Create a bitmap that is compatible with the device bitmap.
Void DrawArc( SFXArcConstRef arc )
DrawArc( SFXArcConstRef arc , SFXRGBColorConstRef color )
Draw an arc.
Void DrawBevel( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color , Bool left , Bool top , Bool right , Bool bottom )
Draw the bevel.
Void DrawBevelBottom( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, right, and bottom edges of the bevel.
Void DrawBevelHorizontal( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the top and bottom edges of the bevel.
Void DrawBevelLeft( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, top, and bottom edges of the bevel.
Void DrawBevelRectangle( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw all the edges of the bevel.
Void DrawBevelRight( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the top, right, and bottom edges of the bevel.
Void DrawBevelTop( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, top, and right edges of the bevel.
Void DrawBevelVertical( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left and right edges of the bevel.
SFCError DrawBitmap( SFBBitmapSmpConstRef bitmap , SFXRectangleConstRef rectangle , AEERasterOp raster = AEE_RO_COPY )
DrawBitmap( SFBBitmapSmpConstRef bitmap , SFXGridConstRef grid , AEERasterOp raster = AEE_RO_COPY )
Draw a bitmap.
Void DrawCircle( SFXCircleConstRef circle )
DrawCircle( SFXCircleConstRef circle , SFXRGBColorConstRef color )
Draw a circle.
Void DrawEllipse( SFXEllipseConstRef ellipse )
DrawEllipse( SFXEllipseConstRef ellipse , SFXRGBColorConstRef color )
Draw an ellipse.
Void DrawEllipticalArc( SFXRectangleConstRef rectangle , SInt16 anchor , SInt16 degree )
DrawEllipticalArc( SFXRectangleConstRef rectangle , SInt16 anchor , SInt16 degree , SFXRGBColorConstRef color )
Draw an elliptical arc.
Void DrawFrame( SFXRectangleConstRef rectangle , SFXFrameColorConstRef color )
Draw a rectangle frame.
Void DrawImage( SFBImageSmpConstRef image , SFXGridConstRef grid )
DrawImage( SFBImageSmpConstRef image , SFXGridConstRef grid , AEERasterOp raster )
Draw an image.
Void DrawLine( SFXLineConstRef line )
DrawLine( SFXLineConstRef line , SFXRGBColorConstRef color )
Draw a line.
Void DrawPie( SFXPieConstRef pie )
DrawPie( SFXPieConstRef pie , SFXRGBColorConstRef color )
Draw a pie.
Void DrawPixel( SFXPixelConstRef pixel )
DrawPixel( SFXPixelConstRef pixel , SFXRGBColorConstRef color )
Draw a pixel.
Void DrawPolygon( SFXPolygonConstRef polygon )
DrawPolygon( SFXPolygonConstRef polygon , SFXRGBColorConstRef color )
Draw a polygon.
Void DrawPolyline( SFXPolylineConstRef polyline )
DrawPolyline( SFXPolylineConstRef polyline , SFXRGBColorConstRef color )
Draw a polyline.
Void DrawRectangle( SFXRectangleConstRef rectangle )
DrawRectangle( SFXRectangleConstRef rectangle , SFXRGBColorConstRef color )
Draw a rectangle.
Void DrawRoundRectangle( SFXRectangleConstRef rectangle , SFXSizeConstRef size )
DrawRoundRectangle( SFXRectangleConstRef rectangle , SFXSizeConstRef size , SFXRGBColorConstRef color )
Draw a rectangle with round conners.
Void DrawString( SFXWideStringConstRef string , SFXRectangleConstRef rectangle , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE , SInt16 margin = 0 )
DrawString( SFXWideStringConstRef string , SFXRectangleConstRef rectangle , UInt32 align = IDF_ALIGN_NONE , SInt16 margin = 0 )
Draw a string that is automatically turned back in a specified rectangle.
Void DrawText( SFXWideStringConstRef string , SInt32 length , SFXGridConstRef grid , SFXRectangleConstRef rectangle , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXGridConstRef grid , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXGridConstRef grid , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXRectangleConstRef rectangle , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXRectangleConstRef rectangle , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXGridConstRef grid , SFXRectangleConstRef rectangle , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SFXGridConstRef grid , SFXRectangleConstRef rectangle , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SInt32 length , SFXGridConstRef grid , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SInt32 length , SFXGridConstRef grid , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SInt32 length , SFXRectangleConstRef rectangle , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SInt32 length , SFXRectangleConstRef rectangle , SFXRGBColorConstRef color , UInt32 align = IDF_ALIGN_NONE )
DrawText( SFXWideStringConstRef string , SInt32 length , SFXGridConstRef grid , SFXRectangleConstRef rectangle , UInt32 align = IDF_ALIGN_NONE )
Draw a text.
Void DrawTriangle( SFXTriangleConstRef triangle )
DrawTriangle( SFXTriangleConstRef triangle , SFXRGBColorConstRef color )
Draw a triangle.
Void FillBevel( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color , Bool left , Bool top , Bool right , Bool bottom )
Draw the bevel and fill it out.
Void FillBevelBottom( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, right, and bottom edges of the bevel, and fill it out.
Void FillBevelHorizontal( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the top and bottom edges of the bevel, and fill it out.
Void FillBevelLeft( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, top, and bottom edges of the bevel, and fill it out.
Void FillBevelRectangle( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw all the edges of the bevel, and fill it out.
Void FillBevelRight( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the top, right, and bottom edges of the bevel, and fill it out.
Void FillBevelTop( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left, top, and right edges of the bevel, and fill it out.
Void FillBevelVertical( SFXRectangleConstRef rectangle , SFXBevelColorConstRef color )
Draw the left and right edges of the bevel, and fill it out.
Void FillCircle( SFXCircleConstRef circle , SFXRGBColorConstRef color )
Draw a circle and fill it out.
Void FillEllipse( SFXEllipseConstRef ellipse , SFXRGBColorConstRef color )
Draw an ellipse and fill it out.
Void FillEllipticalArc( SFXRectangleConstRef rectangle , SInt16 anchor , SInt16 degree , SFXRGBColorConstRef color )
Draw an elliptical arc and fill it out.
Void FillPie( SFXPieConstRef pie , SFXRGBColorConstRef color )
Draw a pie, and fill it out.
Void FillPolygon( SFXPolygonConstRef polygon , SFXRGBColorConstRef color )
Draw a polygon, and fill it out.
Void FillRectangle( SFXRectangleConstRef rectangle , SFXRGBColorConstRef color )
Draw a rectangle, and fill it out.
Void FillRoundRectangle( SFXRectangleConstRef rectangle , SFXSizeConstRef size , SFXRGBColorConstRef color )
Draw a round rectangle, and fill it out.
Void FillTriangle( SFXTriangleConstRef triangle , SFXRGBColorConstRef color )
Draw a triangle, and fill it out.
AEEAlgorithmHint GetAlgorithmHint( Void )
Get the hint of the current drawing algorithm.
SFXRGBColor GetBackColor( Void )
Get background color.
SFXRectangle GetClip( Void )
Get the clipping area.
UInt08 GetColorDepth( Void )
Get the color depth of the device.
SFBBitmapSmp GetDestination( Void )
Get the bitmap the drawing destination.
static
SFBBitmapSmp
GetDeviceBitmap( Void )
Get the bitmap of the device(screen).
static
SFXRectangle
GetDeviceRectangle( Void )
Get the screen rectangle of the device.
static
SFXSize
GetDeviceSize( Void )
Get the screen size of the device.
SFXRGBColor GetFillColor( Void )
Get the fill color.
Bool GetFillMode( Void )
Get the fill mode.
AEEFont GetFont( Void )
Get the font to be set.
SInt16 GetFontAscent( Void )
Get the font ascent.
static
SInt16
GetFontAscent( AEEFont param )
Get the font ascent.
SInt16 GetFontDescent( Void )
Get the font descent.
static
SInt16
GetFontDescent( AEEFont param )
Get the font descent.
SInt16 GetFontHeight( Void )
Get the font height.
static
SInt16
GetFontHeight( AEEFont param )
Get the font height.
SFXRGBColor GetForeColor( Void )
Get the foreground color.
static
SFXGraphicsPtr
GetInstance( Void )
Get the instance that is automatically generated when application starts.
AEEPaintMode GetPaintMode( Void )
Get the current drawing mode.
UInt08 GetPixelSize( Void )
Get the number of pixels for the current point size.
SFBDisplaySmpConstRef GetSFBDisplay( Void )
Get the SFBDisplay instance used internally.
SFBGraphicsSmpConstRef GetSFBGraphics( Void )
Get the SFBGraphics instance used internally.
AEEStrokeStyle GetStrokeStyle( Void )
Get the stroke style.
WChar GetSymbol( AEESymbol symbol )
Get the character corresponding to a specified symbol.
static
WChar
GetSymbol( AEEFont font , AEESymbol symbol )
Get the character corresponding to a specified symbol.
SFXGrid GetTranslate( Void )
Get the amount to move the origin.
SInt16 MeasureString( SFXWideStringConstRef string , SInt16 width , SInt16 margin = 0 )
Measure the height of a specified string when drawn.
static
SInt16
MeasureString( AEEFont font , SFXWideStringConstRef string , SInt16 width , SInt16 margin = 0 )
Measure the height of a specified string when drawn.
SInt16 MeasureText( SFXWideStringConstRef string )
MeasureText( SFXWideStringConstRef string , SInt16 limit , SInt16Ptr fit )
MeasureText( SFXWideStringConstRef string , SInt32 length , SInt16 limit , SInt16Ptr fit )
Measure the width of a specified string when drawn.
static
SInt16
MeasureText( AEEFont font , SFXWideStringConstRef string )
MeasureText( AEEFont font , SFXWideStringConstRef string , SInt16 limit , SInt16Ptr fit )
MeasureText( AEEFont font , SFXWideStringConstRef string , SInt32 length , SInt16 limit , SInt16Ptr fit )
Measure the width of a specified string when drawn.
SFCError RegisterFont( AEECLSID id )
Associate AEEFont with a ClassID.
static
SFCError
RegisterFont( AEEFont font , AEECLSID id )
Associate AEEFont with a ClassID.
Void ResetClip( Void )
Reset the clipping.
Void ResetDestination( Void )
Reset the bitmap of the drawing destination with default value.
Void ResetTranslate( Void )
Reset to move the origin.
Void SetAlgorithmHint( AEEAlgorithmHint param )
Set the hint of the current drawing algorithm.
Void SetAnnunciators( UInt16 value , UInt16 mask )
Turn the specified annunciators on (or off).
Void SetBackColor( SFXRGBColorConstRef param )
Set the background color.
Void SetBacklight( Bool active )
Set the back light of the device.
Void SetClip( SFXRectangleConstRef param )
Set the clipping area.
SFCError SetDestination( SFBBitmapSmpConstRef param )
Set the bitmap of the drawing destination.
Void SetFillColor( SFXRGBColorConstRef param )
Set the fill color.
Bool SetFillMode( Bool param )
Set the fill mode.
Void SetFont( AEEFont param )
Set the font.
Void SetForeColor( SFXRGBColorConstRef param )
Set the foreground color.
AEEPaintMode SetPaintMode( AEEPaintMode param )
Set the current drawing mode.
UInt08 SetPixelSize( UInt08 param )
Set the number of pixels of the point size.
AEEStrokeStyle SetStrokeStyle( AEEStrokeStyle param )
Set the stroke style.
Void SetTranslate( SFXGridConstRef param )
Set the amount to move the origin.
SFCError UnregisterFont( Void )
Dissolve the current association between AEEFont and the ClassID(current font).
static
SFCError
UnregisterFont( AEEFont font )
Dissolve the current association between AEEFont and the ClassID(current font).
Void Update( Void )
Notify the display hardware of the update after the drawing operation is performed.

SFXGraphics::BitBlt
Transfer the bitmap to the rectangular area.
[ public ]
Void BitBlt(
    SFXRectangleConstRef rectangle     // destination rectangle
    SFBBitmapSmpConstRef bitmap        // source bitmap
    SFXGridConstRef grid               // upper left coordinate of source bitmap
    AEERasterOp raster = AEE_RO_COPY   // transfer mode
);
[ public ]
Void BitBlt(
    SFXRectangleConstRef rectangle     // destination rectangle, upper left coordinate of source bitmap
    SFBBitmapSmpConstRef bitmap        // source bitmap
    AEERasterOp raster = AEE_RO_COPY   // transfer mode
);

Reference

SFXGraphics::Update | AEERasterOp


SFXGraphics::ClearRectangle
Clear a rectangular area by filling it with the background color.
[ public ]
Void ClearRectangle(
    SFXRectangleConstRef rectangle   // rectangular area
);
[ public ]
Void ClearRectangle(
    SFXRectangleConstRef rectangle   // rectangular area
    SFXRGBColorConstRef color        // background color
);

Description

If the color argument is specified, change the background color with the specified color first and then fill the rectangular area with new background color.

Reference

SFXGraphics::DrawRectangle


SFXGraphics::CloneBitmap
Create a new bitmap based on the content of the currently drawn bitmap.
[ public, const ]
SFBBitmapSmp CloneBitmap(
    SFXRectangleConstRef param   // source rectangule
);

Reference

SFXGraphics::CreateBitmap


SFXGraphics::CreateBitmap
Create a bitmap that is compatible with the device bitmap.
[ public, static ]
SFBBitmapSmp CreateBitmap(
    SFXSizeConstRef param   // size of the new bitmap
);

Reference

SFXGraphics::CloneBitmap


SFXGraphics::DrawArc
Draw an arc.
[ public ]
Void DrawArc(
    SFXArcConstRef arc   // arc to be drawn
);
[ public ]
Void DrawArc(
    SFXArcConstRef arc          // arc to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

If the drawing color is specified, the foreground color will be changed.

Reference

SFXArc


SFXGraphics::DrawBevel
Draw the bevel.
[ public ]
Void DrawBevel(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
    Bool left                        // whether or not to draw left edge
    Bool top                         // whether or not to draw top edge
    Bool right                       // whether or not to draw right edge
    Bool bottom                      // whether or not to draw bottom edge
);

Description

Whether or not to draw the left, top, right, and bottom edges of the bevel can be specified by the "left", "top", "right", and "bottom" arguments, respectively.

The left and top edges of the bevel are drawn with the light color of the "color" argument, while the right and bottom edges are drawn with the dark color of the "color" argument.

When both of the top and right edges are drawn at the same time, the upper-right vertex is drawn with the base color of the "color" argument. Similarly, when both of the left and bottom edges are drawn at the same time, the lower-left vertex is also drawn with the base color of the "color" argument.

[Note] About Bevel

A bevel is a 3D-looking rectangle with the bright edges(left and top) and dark edges(right and bottom).

Reference

SFXGraphics::FillBevel


SFXGraphics::DrawBevelBottom
Draw the left, right, and bottom edges of the bevel.
[ public ]
Void DrawBevelBottom(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, true, false, true, true);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelBottom


SFXGraphics::DrawBevelHorizontal
Draw the top and bottom edges of the bevel.
[ public ]
Void DrawBevelHorizontal(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, false, true, false, true);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelHorizontal


SFXGraphics::DrawBevelLeft
Draw the left, top, and bottom edges of the bevel.
[ public ]
Void DrawBevelLeft(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, true, true, false, true);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelLeft


SFXGraphics::DrawBevelRectangle
Draw all the edges of the bevel.
[ public ]
Void DrawBevelRectangle(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, true, true, true, true);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelRectangle


SFXGraphics::DrawBevelRight
Draw the top, right, and bottom edges of the bevel.
[ public ]
Void DrawBevelRight(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, false, true, true, true);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelRight


SFXGraphics::DrawBevelTop
Draw the left, top, and right edges of the bevel.
[ public ]
Void DrawBevelTop(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, true, true, true, false);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelTop


SFXGraphics::DrawBevelVertical
Draw the left and right edges of the bevel.
[ public ]
Void DrawBevelVertical(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::DrawBevel(rectangle, color, true, false, true, false);.

Reference

SFXGraphics::DrawBevel | SFXGraphics::FillBevelVertical


SFXGraphics::DrawBitmap
Draw a bitmap.
[ public ]
SFCError DrawBitmap(
    SFBBitmapSmpConstRef bitmap        // source bitmap to draw
    SFXRectangleConstRef rectangle     // rectangular area (drawing destination)
    AEERasterOp raster = AEE_RO_COPY   // transfer mode
);
[ public ]
SFCError DrawBitmap(
    SFBBitmapSmpConstRef bitmap        // source bitmap to draw
    SFXGridConstRef grid               // coordinate (drawing destination)
    AEERasterOp raster = AEE_RO_COPY   // transfer mode
);

Return value

  • Success : SFERR_NO_ERROR
  • If size cannot be recognized : SFERR_UNSUPPORTED

SFXGraphics::DrawCircle
Draw a circle.
[ public ]
Void DrawCircle(
    SFXCircleConstRef circle   // circle to be drawn
);
[ public ]
Void DrawCircle(
    SFXCircleConstRef circle    // circle to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

If the drawing color is not specified, the circle will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the circle will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXCircle | SFXGraphics::FillCircle


SFXGraphics::DrawEllipse
Draw an ellipse.
[ public ]
Void DrawEllipse(
    SFXEllipseConstRef ellipse   // ellipse to be drawn
);
[ public ]
Void DrawEllipse(
    SFXEllipseConstRef ellipse   // ellipse to be drawn
    SFXRGBColorConstRef color    // drawing color
);

Description

If the drawing color is not specified, the ellipse will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the ellipse will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXEllipse | SFXGraphics::FillEllipse


SFXGraphics::DrawEllipticalArc
Draw an elliptical arc.
[ public ]
Void DrawEllipticalArc(
    SFXRectangleConstRef rectangle   // circumscription rectangle of ellipse
    SInt16 anchor                    // beginning angle of the arc (in degrees)
    SInt16 degree                    // extent angle of the arc (in degrees)
);
[ public ]
Void DrawEllipticalArc(
    SFXRectangleConstRef rectangle   // circumscription rectangle of ellipse
    SInt16 anchor                    // beginning angle of the arc (in degrees)
    SInt16 degree                    // extent angle of the arc (in degrees)
    SFXRGBColorConstRef color        // drawing color
);

Description

If the drawing color is specified, the foreground color will be changed.

Reference

SFXGraphics::FillEllipticalArc


SFXGraphics::DrawFrame
Draw a rectangle frame.
[ public ]
Void DrawFrame(
    SFXRectangleConstRef rectangle   // rectangle to be drawn
    SFXFrameColorConstRef color      // drawing color
);

Description

[Warning] Notes

When the SFXGraphics::DrawFrame function is executed, both of the foreground color and the fill mode are also changed.


SFXGraphics::DrawImage
Draw an image.
[ public ]
Void DrawImage(
    SFBImageSmpConstRef image   // source image to draw
    SFXGridConstRef grid        // coordinate (drawing destination)
);
[ public ]
Void DrawImage(
    SFBImageSmpConstRef image   // source image to draw
    SFXGridConstRef grid        // coordinate (drawing destination)
    AEERasterOp raster          // transfer mode
);

Description

[Warning] Notes

When the SFXGraphics::DrawImage function is executed, the drawing destination of the source image is changed. If the transfer mode is set, the transfer mode of the source image is also changed.


SFXGraphics::DrawLine
Draw a line.
[ public ]
Void DrawLine(
    SFXLineConstRef line   // line to be drawn
);
[ public ]
Void DrawLine(
    SFXLineConstRef line        // line to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

If the drawing color is specified, the foreground color will be changed.

Reference

SFXLine


SFXGraphics::DrawPie
Draw a pie.
[ public ]
Void DrawPie(
    SFXPieConstRef pie   // pie to be drawn
);
[ public ]
Void DrawPie(
    SFXPieConstRef pie          // pie to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

If the drawing color is not specified, the pie will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the pie will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXPie | SFXGraphics::FillPie


SFXGraphics::DrawPixel
Draw a pixel.
[ public ]
Void DrawPixel(
    SFXPixelConstRef pixel   // pixel to be drawn
);
[ public ]
Void DrawPixel(
    SFXPixelConstRef pixel      // pixel to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

Setting the drawing color will change the foreground color.

Reference

SFXPixel


SFXGraphics::DrawPolygon
Draw a polygon.
[ public ]
Void DrawPolygon(
    SFXPolygonConstRef polygon   // polygon to be drawn
);
[ public ]
Void DrawPolygon(
    SFXPolygonConstRef polygon   // polygon to be drawn
    SFXRGBColorConstRef color    // drawing color
);

Description

If the drawing color is not specified, the polygon will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the polygon will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXPolygon | SFXGraphics::FillPolygon


SFXGraphics::DrawPolyline
Draw a polyline.
[ public ]
Void DrawPolyline(
    SFXPolylineConstRef polyline   // polyline to be drawn
);
[ public ]
Void DrawPolyline(
    SFXPolylineConstRef polyline   // polyline to be drawn
    SFXRGBColorConstRef color      // drawing color
);

Description

If the drawing color is specified, the foreground color will be changed.

Reference

SFXPolyline


SFXGraphics::DrawRectangle
Draw a rectangle.
[ public ]
Void DrawRectangle(
    SFXRectangleConstRef rectangle   // rectangle to be drawn
);
[ public ]
Void DrawRectangle(
    SFXRectangleConstRef rectangle   // rectangle to be drawn
    SFXRGBColorConstRef color        // drawing color
);

Description

If the drawing color is not specified, the rectangle will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the rectangle will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXRectangle | SFXGraphics::FillRectangle


SFXGraphics::DrawRoundRectangle
Draw a rectangle with round conners.
[ public ]
Void DrawRoundRectangle(
    SFXRectangleConstRef rectangle   // circumscribed rectangle
    SFXSizeConstRef size             // width and height of the ellipse in the conner
);
[ public ]
Void DrawRoundRectangle(
    SFXRectangleConstRef rectangle   // circumscribed rectangle
    SFXSizeConstRef size             // width and height of the ellipse in the conner
    SFXRGBColorConstRef color        // drawing color
);

Description

If the drawing color is not specified, the circumscribed rectangle will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the circumscribed rectangle will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXGraphics::FillRoundRectangle


SFXGraphics::DrawString
Draw a string that is automatically turned back in a specified rectangle.
[ public ]
Void DrawString(
    SFXWideStringConstRef string     // string to be drawn
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXRGBColorConstRef color        // drawing color
    UInt32 align = IDF_ALIGN_NONE    // alignment
    SInt16 margin = 0                // margin
);
[ public ]
Void DrawString(
    SFXWideStringConstRef string     // string to be drawn
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    UInt32 align = IDF_ALIGN_NONE    // alignment
    SInt16 margin = 0                // margin
);

Description

alignment can be set as one of the followings: IDF_ALIGN_LEFT, IDF_ALIGN_CENTER, IDF_ALIGN_RIGHT, IDF_ALIGN_TOP,IDF_ALIGN_MIDDLE, IDF_ALIGN_BOTTOM.


SFXGraphics::DrawText
Draw a text.
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SInt32 length                    // text length
    SFXGridConstRef grid             // Drawing coordinates

    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    SFXRGBColorConstRef color        // drawing color
    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SInt32 length                    // text length
    SFXGridConstRef grid             // Drawing coordinates

    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SInt32 length                    // text length
    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    SFXRGBColorConstRef color        // drawing color
    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SInt32 length                    // text length
    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string    // text to be drawn
    SInt32 length                   // text length
    SFXGridConstRef grid            // Drawing coordinates

    SFXRGBColorConstRef color       // drawing color
    UInt32 align = IDF_ALIGN_NONE   // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string    // text to be drawn
    SInt32 length                   // text length
    SFXGridConstRef grid            // Drawing coordinates

    UInt32 align = IDF_ALIGN_NONE   // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SFXGridConstRef grid             // Drawing coordinates

    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    SFXRGBColorConstRef color        // drawing color
    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SFXGridConstRef grid             // Drawing coordinates

    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    SFXRGBColorConstRef color        // drawing color
    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string     // text to be drawn
    SFXRectangleConstRef rectangle   // drawing range (rectangle)

    UInt32 align = IDF_ALIGN_NONE    // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string    // text to be drawn
    SFXGridConstRef grid            // Drawing coordinates

    SFXRGBColorConstRef color       // drawing color
    UInt32 align = IDF_ALIGN_NONE   // alignment
);
[ public ]
Void DrawText(
    SFXWideStringConstRef string    // text to be drawn
    SFXGridConstRef grid            // Drawing coordinates

    UInt32 align = IDF_ALIGN_NONE   // alignment
);

Reference

SFBDisplay::DrawText


SFXGraphics::DrawTriangle
Draw a triangle.
[ public ]
Void DrawTriangle(
    SFXTriangleConstRef triangle   // triangle to be drawn
);
[ public ]
Void DrawTriangle(
    SFXTriangleConstRef triangle   // triangle to be drawn
    SFXRGBColorConstRef color      // drawing color
);

Description

If the drawing color is not specified, the triangle will be drawn with the foreground color, fill mode, and fill color to be set.

If the drawing color is specified, the triangle will not be filled out. At this time, both of the foreground color and the fill mode will be changed.

Reference

SFXTriangle | SFXGraphics::FillTriangle


SFXGraphics::FillBevel
Draw the bevel and fill it out.
[ public ]
Void FillBevel(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
    Bool left                        // whether or not to draw left edge
    Bool top                         // whether or not to draw top edge
    Bool right                       // whether or not to draw right edge
    Bool bottom                      // whether or not to draw bottom edge
);

Description

Whether or not to draw the left, top, right, and bottom edges of the bevel can be specified by the "left", "top", "right", and "bottom" arguments, respectively.

The left and top edges of the bevel are drawn with the light color of the "color" argument, while the right and bottom edges are drawn with the dark color of the "color" argument.

When both of the top and right edges are drawn at the same time, the upper-right vertex is drawn with the base color of the "color" argument. Similarly, when both of the left and bottom edges are drawn at the same time, the lower-left vertex is also drawn with the base color of the "color" argument.

Moreover, the bevel is filled with the base color of the "color" argument.

[Note] About Bevel

A bevel is a 3D-looking rectangle with the bright edges(left and top) and dark edges(right and bottom).

Reference

SFXGraphics::DrawBevel


SFXGraphics::FillBevelBottom
Draw the left, right, and bottom edges of the bevel, and fill it out.
[ public ]
Void FillBevelBottom(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, true, false, true, true);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelBottom


SFXGraphics::FillBevelHorizontal
Draw the top and bottom edges of the bevel, and fill it out.
[ public ]
Void FillBevelHorizontal(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, false, true, false, true);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelHorizontal


SFXGraphics::FillBevelLeft
Draw the left, top, and bottom edges of the bevel, and fill it out.
[ public ]
Void FillBevelLeft(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, true, true, false, true);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelLeft


SFXGraphics::FillBevelRectangle
Draw all the edges of the bevel, and fill it out.
[ public ]
Void FillBevelRectangle(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, true, true, true, true);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelRectangle


SFXGraphics::FillBevelRight
Draw the top, right, and bottom edges of the bevel, and fill it out.
[ public ]
Void FillBevelRight(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, false, true, true, true);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelRight


SFXGraphics::FillBevelTop
Draw the left, top, and right edges of the bevel, and fill it out.
[ public ]
Void FillBevelTop(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, true, true, true, false);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelTop


SFXGraphics::FillBevelVertical
Draw the left and right edges of the bevel, and fill it out.
[ public ]
Void FillBevelVertical(
    SFXRectangleConstRef rectangle   // rectangular area (drawing destination)
    SFXBevelColorConstRef color      // color for base, light, and dark
);

Description

Same as SFXGraphics::FillBevel(rectangle, color, true, false, true, false);.

Reference

SFXGraphics::FillBevel | SFXGraphics::DrawBevelVertical


SFXGraphics::FillCircle
Draw a circle and fill it out.
[ public ]
Void FillCircle(
    SFXCircleConstRef circle    // circle to be drawn
    SFXRGBColorConstRef color   // drawing color
);

Description

[Warning] Notes

When the SFXGraphics::FillCircle function is executed, the foreground color, fill mode, and fill color are changed.

Reference

SFXCircle | SFXGraphics::DrawCircle


SFXGraphics::FillEllipse
Draw an ellipse and fill it out.
[ public ]
Void FillEllipse(
    SFXEllipseConstRef ellipse   // ellipse to be drawn
    SFXRGBColorConstRef color    // drawing color
);

Description

[Warning] Notes

When the SFXGraphics::FillEllipse function is executed, the foreground color, fill mode, and fill color are changed.

Reference

SFXEllipse | SFXGraphics::DrawEllipse


SFXGraphics::FillEllipticalArc
Draw an elliptical arc and fill it out.
[ public ]
Void FillEllipticalArc(
    SFXRectangleConstRef rectangle   // circumscription rectangle of the ellipse
    SInt16 anchor                    //  beginning angle of the arc (in degrees)
    SInt16 degree                    // extent angle of the arc (in degrees)
    SFXRGBColorConstRef color        // drawing color
);

Description

[Warning] Notes

When the SFXGraphics::FillEllipticalArc function is executed, the foreground color, fill mode, and fill color are changed.

Reference

SFXGraphics::DrawEllipticalArc


SFXGraphics::FillPie
Draw a pie, and fill it out.
[ public ]
Void FillPie(
    SFXPieConstRef pie          // pie to be drawn
    SFXRGBColorConstRef