- /**
- Copies from a source DC to this DC, specifying the destination
- coordinates, size of area to copy, source DC, source coordinates,
- logical function, whether to use a bitmap mask, and mask source
- position.
-
- @see wxDC::Blit()
- */
- bool Blit(wxCoord xdest, wxCoord ydest, wxCoord width, wxCoord height,
- wxDC* source, wxCoord xsrc, wxCoord ysrc, wxRasterOperationMode rop = wxCOPY,
- bool useMask = false, wxCoord xsrcMask = wxDefaultCoord,
- wxCoord ysrcMask = wxDefaultCoord);
-
- /**
- Adds the specified point to the bounding box which can be retrieved
- with wxDC::MinX(), wxDC::MaxX() and wxDC::MinY(), wxDC::MaxY()
- functions.
- */
- void CalcBoundingBox(wxCoord x, wxCoord y);
-
- /**
- This makes no sense in wxSVGFileDC and does nothing.
- */
- void Clear();
-
- /**
- Not Implemented.
- */
- void CrossHair(wxCoord x, wxCoord y);
-
- /**
- Not Implemented.
- */
- void DestroyClippingRegion();
-
- /**
- Convert device X coordinate to logical coordinate, using the current
- mapping mode.
- */
- wxCoord DeviceToLogicalX(wxCoord x) const;
-
- /**
- Convert device X coordinate to relative logical coordinate, using the
- current mapping mode but ignoring the x axis orientation. Use this
- function for converting a width, for example.
- */
- wxCoord DeviceToLogicalXRel(wxCoord x) const;
-
- /**
- Converts device Y coordinate to logical coordinate, using the current
- mapping mode.
- */
- wxCoord DeviceToLogicalY(wxCoord y) const;
-
- /**
- Convert device Y coordinate to relative logical coordinate, using the
- current mapping mode but ignoring the y axis orientation. Use this
- function for converting a height, for example.
- */
- wxCoord DeviceToLogicalYRel(wxCoord y) const;
-
- /**
- Draws an arc of a circle, centred on (@a xc, @a yc), with starting
- point (@a x1, @a y1) and ending at (@a x2, @a y2). The current pen is
- used for the outline and the current brush for filling the shape.
-
- The arc is drawn in a counter-clockwise direction from the start point
- to the end point.
- */
- void DrawArc(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2,
- wxCoord xc, wxCoord yc);
-
- /**
- Draw a bitmap on the device context at the specified point. If
- @a useMask is @true and the bitmap has a transparency mask, the
- bitmap will be drawn transparently.
-
- When drawing a mono-bitmap, the current text foreground colour will be
- used to draw the foreground of the bitmap (all bits set to 1), and the
- current text background colour to draw the background (all bits set to
- 0).
-
- @see wxDC::SetTextForeground(), wxDC::SetTextBackground(), wxMemoryDC
- */
- void DrawBitmap(const wxBitmap& bitmap, wxCoord x, wxCoord y,
- bool useMask = false);
-
- //@{
- /**
- Draws a check mark inside the given rectangle.
- */
- void DrawCheckMark(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
- void DrawCheckMark(const wxRect& rect);
- //@}
-
- //@{
- /**
- Draws a circle with the given centre and radius.
-
- @see wxDC::DrawEllipse()
- */
- void DrawCircle(wxCoord x, wxCoord y, wxCoord radius);
- void DrawCircle(const wxPoint& pt, wxCoord radius);
- //@}
-
- //@{
- /**
- Draws an ellipse contained in the rectangle specified either with the
- given top left corner and the given size or directly. The current pen
- is used for the outline and the current brush for filling the shape.
-
- @see wxDC::DrawCircle()
- */
- void DrawEllipse(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
- void DrawEllipse(const wxPoint& pt, const wxSize& size);
- void DrawEllipse(const wxRect& rect);
- //@}
-
- /**
- Draws an arc of an ellipse. The current pen is used for drawing the arc
- and the current brush is used for drawing the pie.
-
- @a x and @a y specify the x and y coordinates of the upper-left corner
- of the rectangle that contains the ellipse.
-
- @a width and @a height specify the width and height of the rectangle
- that contains the ellipse.
-
- @a start and @a end specify the start and end of the arc relative to
- the three-o'clock position from the center of the rectangle. Angles are
- specified in degrees (360 is a complete circle). Positive values mean
- counter-clockwise motion. If @a start is equal to @a end, a complete
- ellipse will be drawn.
- */
- void DrawEllipticArc(wxCoord x, wxCoord y, wxCoord width, wxCoord height,
- double start, double end);
-
- /**
- Draw an icon on the display (does nothing if the device context is
- PostScript). This can be the simplest way of drawing bitmaps on a
- window.
- */
- void DrawIcon(const wxIcon& icon, wxCoord x, wxCoord y);
-
- /**
- Draws a line from the first point to the second. The current pen is
- used for drawing the line.
- */
- void DrawLine(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2);
-
- //@{
- /**
- Draws lines using an array of @a points of size @a n, or list of
- pointers to points, adding the optional offset coordinate. The current
- pen is used for drawing the lines. The programmer is responsible for
- deleting the list of points.
- */
- void DrawLines(int n, wxPoint points[], wxCoord xoffset = 0,
- wxCoord yoffset = 0);
- void DrawLines(wxList* points, wxCoord xoffset = 0,
- wxCoord yoffset = 0);
- //@}
-
- /**
- Draws a point using the current pen.
- */
- void DrawPoint(wxCoord x, wxCoord y);
-
- //@{
- /**
- Draws a filled polygon using an array of @a points of size @a n,
- or list of pointers to points, adding the optional offset coordinate.
- wxWidgets automatically closes the first and last points.
-
- The last argument specifies the fill rule: @c wxODDEVEN_RULE (the
- default) or @c wxWINDING_RULE.
-
- The current pen is used for drawing the outline, and the current brush
- for filling the shape. Using a transparent brush suppresses filling.
-
- The programmer is responsible for deleting the list of points.
- */
- void DrawPolygon(int n, wxPoint points[], wxCoord xoffset = 0,
- wxCoord yoffset = 0,
- wxPolygonFillMode fill_style = wxODDEVEN_RULE);
- void DrawPolygon(wxList* points, wxCoord xoffset = 0,
- wxCoord yoffset = 0,
- wxPolygonFillMode fill_style = wxODDEVEN_RULE);
- //@}
-
- /**
- Draws a rectangle with the given top left corner, and with the given
- size. The current pen is used for the outline and the current brush
- for filling the shape.
- */
- void DrawRectangle(wxCoord x, wxCoord y, wxCoord width, wxCoord height);
-
- /**
- Draws the text rotated by @a angle degrees.
-
- The wxMSW wxDC and wxSVGFileDC rotate the text around slightly
- different points, depending on the size of the font.
- */
- void DrawRotatedText(const wxString& text, wxCoord x, wxCoord y,
- double angle);
-
- /**
- Draws a rectangle with the given top left corner, and with the given
- size. The corners are quarter-circles using the given radius. The
- current pen is used for the outline and the current brush for filling
- the shape.
-
- If @a radius is positive, the value is assumed to be the radius of the
- rounded corner. If @a radius is negative, the absolute value is assumed
- to be the @e proportion of the smallest dimension of the rectangle.
- This means that the corner can be a sensible size relative to the size
- of the rectangle, and also avoids the strange effects X produces when
- the corners are too big for the rectangle.
- */
- void DrawRoundedRectangle(wxCoord x, wxCoord y, wxCoord width,
- wxCoord height, double radius = 20);
-
- /**
- Draws a spline between all given control points, using the current pen.
- The programmer is responsible for deleting the list of points.
- The spline is drawn using a series of lines, using an algorithm taken from
- the X drawing program "XFIG".
- */
- void DrawSpline(const wxPointList* points);
-
- /**
- Draws a three-point spline using the current pen.
- */
- void DrawSpline(wxCoord x1, wxCoord y1, wxCoord x2, wxCoord y2,
- wxCoord x3, wxCoord y3);
-
- /**
- Draws a text string at the specified point, using the current text
- font, and the current text foreground and background colours.
-
- The coordinates refer to the top-left corner of the rectangle bounding
- the string. See wxDC::GetTextExtent() for how to get the dimensions of
- a text string, which can be used to position the text more precisely.
- */
- void DrawText(const wxString& text, wxCoord x, wxCoord y);
-