2008-03-08 08:52:38 -05:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
// Name: dcsvg.h
|
2008-03-10 11:24:38 -04:00
|
|
|
// Purpose: interface of wxSVGFileDC
|
2008-03-08 08:52:38 -05:00
|
|
|
// Author: wxWidgets team
|
|
|
|
// RCS-ID: $Id$
|
2010-07-13 09:29:13 -04:00
|
|
|
// Licence: wxWindows licence
|
2008-03-08 08:52:38 -05:00
|
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
|
|
/**
|
|
|
|
@class wxSVGFileDC
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-04-19 04:12:58 -04:00
|
|
|
A wxSVGFileDC is a device context onto which graphics and text can be
|
2012-09-15 19:18:47 -04:00
|
|
|
drawn, and the output produced as a vector file, in SVG format.
|
|
|
|
|
|
|
|
This format can be read by a range of programs, including a Netscape plugin
|
|
|
|
(Adobe) and the open source Inkscape program (http://inkscape.org/). Full
|
|
|
|
details are given in the W3C SVG recommendation (http://www.w3.org/TR/SVG/).
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
The intention behind wxSVGFileDC is that it can be used to produce a file
|
2008-04-19 04:12:58 -04:00
|
|
|
corresponding to the screen display context, wxSVGFileDC, by passing the
|
2012-09-15 19:18:47 -04:00
|
|
|
wxSVGFileDC as a parameter instead of a wxDC. Thus the wxSVGFileDC
|
2008-04-19 04:12:58 -04:00
|
|
|
is a write-only class.
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-04-19 04:12:58 -04:00
|
|
|
As the wxSVGFileDC is a vector format, raster operations like GetPixel()
|
|
|
|
are unlikely to be supported. However, the SVG specification allows for PNG
|
|
|
|
format raster files to be embedded in the SVG, and so bitmaps, icons and
|
|
|
|
blit operations in wxSVGFileDC are supported.
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-04-19 04:12:58 -04:00
|
|
|
A more substantial SVG library (for reading and writing) is available at
|
|
|
|
the wxArt2D website <http://wxart2d.sourceforge.net/>.
|
2008-03-08 09:43:31 -05:00
|
|
|
|
2008-03-08 08:52:38 -05:00
|
|
|
@library{wxcore}
|
2008-04-19 04:12:58 -04:00
|
|
|
@category{dc}
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
class wxSVGFileDC : public wxDC
|
|
|
|
{
|
|
|
|
public:
|
2008-04-20 19:50:56 -04:00
|
|
|
/**
|
|
|
|
Initializes a wxSVGFileDC with the given @a f filename with the given
|
|
|
|
@a Width and @a Height at @a dpi resolution.
|
|
|
|
*/
|
2008-11-13 16:32:53 -05:00
|
|
|
wxSVGFileDC(const wxString& filename, int width = 320, int height = 240, double dpi = 72);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
|
|
|
Destructor.
|
|
|
|
*/
|
2008-09-27 07:21:10 -04:00
|
|
|
virtual ~wxSVGFileDC();
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
2008-04-20 19:50:56 -04:00
|
|
|
Does nothing.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
void EndDoc();
|
|
|
|
|
|
|
|
/**
|
2008-04-20 19:50:56 -04:00
|
|
|
Does nothing.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
|
|
|
void EndPage();
|
|
|
|
|
|
|
|
/**
|
2009-01-10 18:07:44 -05:00
|
|
|
This makes no sense in wxSVGFileDC and does nothing.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2009-01-10 18:07:44 -05:00
|
|
|
void Clear();
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
/**
|
2009-01-10 18:07:44 -05:00
|
|
|
Does the same as wxDC::SetLogicalFunction(), except that only wxCOPY is
|
|
|
|
available. Trying to set one of the other values will fail.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2009-01-10 18:07:44 -05:00
|
|
|
void SetLogicalFunction(wxRasterOperationMode function);
|
2008-03-08 08:52:38 -05:00
|
|
|
|
|
|
|
//@{
|
|
|
|
/**
|
2009-01-10 18:07:44 -05:00
|
|
|
Functions not implemented in this DC class.
|
2008-03-08 08:52:38 -05:00
|
|
|
*/
|
2009-01-10 18:07:44 -05:00
|
|
|
void CrossHair(wxCoord x, wxCoord y);
|
|
|
|
void DestroyClippingRegion();
|
|
|
|
bool FloodFill(wxCoord x, wxCoord y, const wxColour& colour,
|
|
|
|
wxFloodFillStyle style = wxFLOOD_SURFACE);
|
2008-11-15 06:37:43 -05:00
|
|
|
void GetClippingBox(wxCoord *x, wxCoord *y, wxCoord *width, wxCoord *height) const;
|
2008-10-13 07:09:56 -04:00
|
|
|
bool GetPixel(wxCoord x, wxCoord y, wxColour* colour) const;
|
2008-03-08 08:52:38 -05:00
|
|
|
void SetClippingRegion(wxCoord x, wxCoord y, wxCoord width,
|
|
|
|
wxCoord height);
|
2008-03-08 09:43:31 -05:00
|
|
|
void SetClippingRegion(const wxPoint& pt, const wxSize& sz);
|
|
|
|
void SetClippingRegion(const wxRect& rect);
|
|
|
|
void SetClippingRegion(const wxRegion& region);
|
2008-03-08 08:52:38 -05:00
|
|
|
void SetPalette(const wxPalette& palette);
|
|
|
|
bool StartDoc(const wxString& message);
|
2009-01-10 18:07:44 -05:00
|
|
|
//@}
|
2008-03-08 08:52:38 -05:00
|
|
|
};
|
2008-03-10 11:24:38 -04:00
|
|
|
|