/////////////////////////////////////////////////////////////////////////////
// Name: graphics.h
-// Purpose: documentation for wxGraphicsPath class
+// Purpose: interface of wxGraphicsPath
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
public:
//@{
/**
-
+
*/
void AddArc(wxDouble x, wxDouble y, wxDouble r,
wxDouble startAngle,
//@{
/**
-
+
*/
void AddCurveToPoint(wxDouble cx1, wxDouble cy1, wxDouble cx2,
wxDouble cy2,
//@{
/**
-
+
*/
void AddLineToPoint(wxDouble x, wxDouble y);
void AddLineToPoint(const wxPoint2DDouble& p);
Returns @true if the point is within the path.
*/
bool Contains(const wxPoint2DDouble& c,
- int fillStyle = wxODDEVEN_RULE);
- bool Contains(wxDouble x, wxDouble y,
- int fillStyle = wxODDEVEN_RULE);
+ int fillStyle = wxODDEVEN_RULE) const;
+ const bool Contains(wxDouble x, wxDouble y,
+ int fillStyle = wxODDEVEN_RULE) const;
//@}
//@{
/**
Gets the bounding box enclosing all points (possibly including control points).
*/
- wxRect2DDouble GetBox();
- void GetBox(wxDouble* x, wxDouble* y, wxDouble* w,
- wxDouble* h);
+ wxRect2DDouble GetBox() const;
+ const void GetBox(wxDouble* x, wxDouble* y, wxDouble* w,
+ wxDouble* h) const;
//@}
//@{
/**
Gets the last point of the current path, (0,0) if not yet set.
*/
- void GetCurrentPoint(wxDouble* x, wxDouble* y);
- wxPoint2DDouble GetCurrentPoint();
+ void GetCurrentPoint(wxDouble* x, wxDouble* y) const;
+ const wxPoint2DDouble GetCurrentPoint() const;
//@}
/**
Returns the native path (CGPathRef for Core Graphics, Path pointer for GDIPlus
and a cairo_path_t pointer for cairo).
*/
- void * GetNativePath();
+ void* GetNativePath() const;
//@{
/**
some deallocations necessary (eg on cairo the native path returned by
GetNativePath is newly allocated each time).
*/
- void UnGetNativePath(void* p);
+ void UnGetNativePath(void* p) const;
};
+
/**
@class wxGraphicsObject
@wxheader{graphics.h}
@library{wxcore}
@category{FIXME}
- @seealso
- wxGraphicsBrush, wxGraphicsPen, wxGraphicsMatrix, wxGraphicsPath
+ @see wxGraphicsBrush, wxGraphicsPen, wxGraphicsMatrix, wxGraphicsPath
*/
class wxGraphicsObject : public wxObject
{
Returns the renderer that was used to create this instance, or @NULL if it has
not been initialized yet
*/
- wxGraphicsRenderer* GetRenderer();
+ wxGraphicsRenderer* GetRenderer() const;
/**
Is this object valid (@false) or still empty (@true)?
*/
- bool IsNull();
+ bool IsNull() const;
};
+
/**
@class wxGraphicsContext
@wxheader{graphics.h}
A wxGraphicsContext instance is the object that is drawn upon. It is created by
- a renderer using the CreateContext calls.., this can be either directly using a renderer
- instance, or indirectly using the static convenience CreateXXX functions of
- wxGraphicsContext that always delegate the task to the default renderer.
+ a renderer using wxGraphicsRenderer::CreateContext(). This can be either directly
+ using a renderer instance, or indirectly using the static convenience Create()
+ functions of wxGraphicsContext that always delegate the task to the default renderer.
+
+ @code
+ void MyCanvas::OnPaint(wxPaintEvent &event)
+ {
+ // Create paint DC
+ wxPaintDC dc(this);
+
+ // Create graphics context from it
+ wxGraphicsContext *gc = wxGraphicsContext::Create( dc );
+
+ if (gc)
+ {
+ // make a path that contains a circle and some lines
+ gc->SetPen( *wxRED_PEN );
+ wxGraphicsPath path = gc->CreatePath();
+ path.AddCircle( 50.0, 50.0, 50.0 );
+ path.MoveToPoint(0.0, 50.0);
+ path.AddLineToPoint(100.0, 50.0);
+ path.MoveToPoint(50.0, 0.0);
+ path.AddLineToPoint(50.0, 100.0 );
+ path.CloseSubpath();
+ path.AddRectangle(25.0, 25.0, 50.0, 50.0);
+
+ gc->StrokePath(path);
+
+ delete gc;
+ }
+ }
+ @endcode
+
@library{wxcore}
@category{FIXME}
- @seealso
- wxGraphicsRenderer:: CreateContext
+ @see wxGraphicsRenderer::CreateContext(), wxGCDC, wxDC
*/
class wxGraphicsContext : public wxGraphicsObject
{
public:
- //@{
/**
- Clips drawings to the rectangle.
+ Creates a wxGraphicsContext from a wxWindow.
+
+ @see wxGraphicsRenderer::CreateContext()
+ */
+ static wxGraphicsContext* Create( wxWindow* window ) ;
+
+ /**
+ Creates a wxGraphicsContext from a wxWindowDC
+
+ @see wxGraphicsRenderer::CreateContext()
+ */
+ static wxGraphicsContext* Create( const wxWindowDC& dc) ;
+
+ /**
+ Creates a wxGraphicsContext from a wxMemoryDC
+
+ @see wxGraphicsRenderer::CreateContext()
+ */
+ static wxGraphicsContext * Create( const wxMemoryDC& dc) ;
+
+ /**
+ Creates a wxGraphicsContext from a wxPrinterDC. Under
+ GTK+, this will only work when using the GtkPrint
+ printing backend which is available since GTK+ 2.10.
+
+ @see wxGraphicsRenderer::CreateContext(), @ref overview_unixprinting "Printing under Unix"
+ */
+ static wxGraphicsContext * Create( const wxPrinterDC& dc) ;
+
+ /**
+ Clips drawings to the region
*/
void Clip(const wxRegion& region);
+
+ /**
+ Clips drawings to the rectangle.
+ */
void Clip(wxDouble x, wxDouble y, wxDouble w, wxDouble h);
- //@}
/**
Concatenates the passed in transform with the current transform of this context
*/
void ConcatTransform(const wxGraphicsMatrix& matrix);
- //@{
- /**
- Creates a wxGraphicsContext from a wxWindow.
-
- @sa wxGraphicsRenderer:: CreateContext
- */
- wxGraphicsContext* Create(const wxWindowDC& dc);
- wxGraphicsContext* Create(wxWindow* window);
- //@}
/**
Creates a native brush from a wxBrush.
*/
- wxGraphicsBrush CreateBrush(const wxBrush& brush);
+ wxGraphicsBrush CreateBrush(const wxBrush& brush) const;
/**
Creates a native graphics font from a wxFont and a text colour.
*/
wxGraphicsFont CreateFont(const wxFont& font,
- const wxColour& col = wxBLACK);
+ const wxColour& col = wxBLACK) const;
/**
Creates a wxGraphicsContext from a native context. This native context must be
eg a CGContextRef for Core Graphics, a Graphics pointer for GDIPlus or a
cairo_t pointer for cairo.
-
- Creates a wxGraphicsContext from a native window.
-
- @sa wxGraphicsRenderer:: CreateContextFromNativeContext
+
+ @see wxGraphicsRenderer:: CreateContextFromNativeContext
*/
- wxGraphicsContext* CreateFromNative(void * context);
+ wxGraphicsContext* CreateFromNative(void* context);
/**
- @sa wxGraphicsRenderer:: CreateContextFromNativeWindow
+ Creates a wxGraphicsContext from a native window.
+
+ @see wxGraphicsRenderer:: CreateContextFromNativeWindow
*/
- wxGraphicsContext* CreateFromNativeWindow(void * window);
+ wxGraphicsContext* CreateFromNativeWindow(void* window);
/**
Creates a native brush, having a linear gradient, starting at (x1,y1) with
wxDouble x2,
wxDouble y2,
const wxColouramp;c1,
- const wxColouramp;c2);
+ const wxColouramp;c2) const;
/**
Creates a native affine transformation matrix from the passed in values. The
wxDouble c = 0.0,
wxDouble d = 1.0,
wxDouble tx = 0.0,
- wxDouble ty = 0.0);
+ wxDouble ty = 0.0) const;
/**
Creates a native graphics path which is initially empty.
*/
- wxGraphicsPath CreatePath();
+ wxGraphicsPath CreatePath() const;
/**
Creates a native pen from a wxPen.
*/
- wxGraphicsPen CreatePen(const wxPen& pen);
+ wxGraphicsPen CreatePen(const wxPen& pen) const;
/**
Creates a native brush, having a radial gradient originating at (xo,yc) with
wxDouble yc,
wxDouble radius,
const wxColour& oColor,
- const wxColour& cColor);
+ const wxColour& cColor) const;
/**
Draws the bitmap. In case of a mono bitmap, this is treated as a mask and the
Returns the native context (CGContextRef for Core Graphics, Graphics pointer
for GDIPlus and cairo_t pointer for cairo).
*/
- void * GetNativeContext();
+ void* GetNativeContext();
/**
- Fills the @e widths array with the widths from the beginning of
- @e text to the corresponding character of @e text.
+ Fills the @a widths array with the widths from the beginning of
+ @a text to the corresponding character of @e text.
*/
void GetPartialTextExtents(const wxString& text,
- wxArrayDouble& widths);
+ wxArrayDouble& widths) const;
/**
Gets the dimensions of the string using the currently selected font.
@e string is the text string to measure, @e w and @e h are
- the total width and height respectively, @e descent is the
+ the total width and height respectively, @a descent is the
dimension from the baseline of the font to the bottom of the
- descender, and @e externalLeading is any extra vertical space added
+ descender, and @a externalLeading is any extra vertical space added
to the font by the font designer (usually is zero).
*/
void GetTextExtent(const wxString& text, wxDouble* width,
wxDouble* height,
wxDouble* descent,
- wxDouble* externalLeading);
+ wxDouble* externalLeading) const;
/**
Gets the current transformation matrix of this context.
*/
- wxGraphicsMatrix GetTransform();
+ wxGraphicsMatrix GetTransform() const;
/**
Resets the clipping to original shape.
};
+
/**
@class wxGraphicsRenderer
@wxheader{graphics.h}
A wxGraphicsRenderer is the instance corresponding to the rendering engine
- used. There may be multiple instances on a system, if there are different rendering engines present, but there is always one instance per engine, eg there is ONE core graphics renderer instance on OSX. This instance is pointed back to by all objects created by it (wxGraphicsContext, wxGraphicsPath etc). Therefore you can create ag additional instances of paths etc. by calling GetRenderer() and then using the appropriate CreateXXX function.
+ used. There may be multiple instances on a system, if there are different
+ rendering engines present, but there is always only one instance per engine.
+ This instance is pointed back to by all objects created by it (wxGraphicsContext,
+ wxGraphicsPath etc) and can be retrieved through their wxGraphicsObject::GetRenderer()
+ method. Therefore you can create an additional instance of a path etc. by calling
+ wxGraphicsObject::GetRenderer() and then using the appropriate CreateXXX function
+ of that renderer.
+
+ @code
+ wxGraphicsPath *path = // from somewhere
+ wxGraphicsBrush *brush = path->GetRenderer()->CreateBrush( *wxBLACK_BRUSH );
+ @endcode
@library{wxcore}
@category{FIXME}
{
public:
/**
- Creates a native brush from a wxBrush.
+ Creates a wxGraphicsContext from a wxWindow.
*/
- wxGraphicsBrush CreateBrush(const wxBrush& brush);
+ virtual wxGraphicsContext* CreateContext(wxWindow* window) = 0;
+
+ /**
+ Creates a wxGraphicsContext from a wxWindowDC
+ */
+ virtual wxGraphicsContext * CreateContext( const wxWindowDC& dc) = 0 ;
+
+ /**
+ Creates a wxGraphicsContext from a wxMemoryDC
+ */
+ virtual wxGraphicsContext * CreateContext( const wxMemoryDC& dc) = 0 ;
+
+ /**
+ Creates a wxGraphicsContext from a wxPrinterDC
+ */
+ virtual wxGraphicsContext * CreateContext( const wxPrinterDC& dc) = 0 ;
- //@{
/**
- Creates a wxGraphicsContext from a wxWindow.
+ Creates a native brush from a wxBrush.
*/
- wxGraphicsContext * CreateContext(const wxWindowDC& dc);
- wxGraphicsContext * CreateContext(wxWindow* window);
- //@}
+ wxGraphicsBrush CreateBrush(const wxBrush& brush);
+
/**
Creates a wxGraphicsContext from a native context. This native context must be
- eg a CGContextRef for Core Graphics, a Graphics pointer for GDIPlus or a cairo_t pointer for cairo.
+ eg a CGContextRef for Core Graphics, a Graphics pointer for GDIPlus or a cairo_t
+ pointer for cairo.
*/
- wxGraphicsContext * CreateContextFromNativeContext(void * context);
+ wxGraphicsContext* CreateContextFromNativeContext(void* context);
/**
Creates a wxGraphicsContext from a native window.
*/
- wxGraphicsContext * CreateContextFromNativeWindow(void * window);
+ wxGraphicsContext* CreateContextFromNativeWindow(void* window);
/**
Creates a native graphics font from a wxFont and a text colour.
Returns the default renderer on this platform. On OS X this is the Core
Graphics (a.k.a. Quartz 2D) renderer, on MSW the GDIPlus renderer, and on GTK we currently default to the cairo renderer.
*/
- wxGraphicsRenderer* GetDefaultRenderer();
+ static wxGraphicsRenderer* GetDefaultRenderer();
};
+
/**
@class wxGraphicsBrush
@wxheader{graphics.h}
};
+
/**
@class wxGraphicsFont
@wxheader{graphics.h}
};
+
/**
@class wxGraphicsPen
@wxheader{graphics.h}
};
+
/**
@class wxGraphicsMatrix
@wxheader{graphics.h}
public:
//@{
/**
-
+
*/
void Concat(const wxGraphicsMatrix* t);
void Concat(const wxGraphicsMatrix& t);
/**
Returns the component values of the matrix via the argument pointers.
*/
-#define void Get(wxDouble* a=@NULL, wxDouble* b=@NULL, wxDouble* c=@NULL,
- wxDouble* d=@NULL, wxDouble* tx=@NULL,
- wxDouble* ty=@NULL) /* implementation is private */
+ void Get(wxDouble* a = NULL, wxDouble* b = NULL, wxDouble* c = NULL,
+ wxDouble* d = NULL, wxDouble* tx = NULL,
+ wxDouble* ty = NULL) const;
/**
Returns the native representation of the matrix. For CoreGraphics this is a
CFAffineMatrix pointer. For GDIPlus a Matrix Pointer and for Cairo a cairo_matrix_t pointer.
*/
- void * GetNativeMatrix();
+ void* GetNativeMatrix() const;
/**
Inverts the matrix.
/**
Returns @true if the elements of the transformation matrix are equal.
*/
- bool IsEqual(const wxGraphicsMatrix& t);
+ bool IsEqual(const wxGraphicsMatrix& t) const;
/**
Return @true if this is the identity matrix.
*/
- bool IsIdentity();
+ bool IsIdentity() const;
/**
Rotates this matrix (radians).
Sets the matrix to the respective values (default values are the identity
matrix)
*/
-#define void Set(wxDouble a = 1.0, wxDouble b = 0.0, wxDouble c = 0.0,
- wxDouble d = 1.0, wxDouble tx = 0.0,
- wxDouble ty = 0.0) /* implementation is private */
+ void Set(wxDouble a = 1.0, wxDouble b = 0.0, wxDouble c = 0.0,
+ wxDouble d = 1.0, wxDouble tx = 0.0,
+ wxDouble ty = 0.0);
/**
Applies this matrix to a distance (ie. performs all transforms except
translations)
*/
- void TransformDistance(wxDouble* dx, wxDouble* dy);
+ void TransformDistance(wxDouble* dx, wxDouble* dy) const;
/**
Applies this matrix to a point.
*/
- void TransformPoint(wxDouble* x, wxDouble* y);
+ void TransformPoint(wxDouble* x, wxDouble* y) const;
/**
Translates this matrix.
*/
void Translate(wxDouble dx, wxDouble dy);
};
+
projects / wxWidgets.git / blobdiff