cairomm 1.18.0
|
A QuartzSurface provides a way to render within Apple Mac OS X. More...
#include <cairomm/quartz_surface.h>
Public Member Functions | |
QuartzSurface (cairo_surface_t *cobject, bool has_reference=false) | |
Create a C++ wrapper for the C instance. More... | |
~QuartzSurface () override | |
CGContextRef | get_cg_context () const |
Returns the CGContextRef associated with this surface, or NULL if none. More... | |
Public Member Functions inherited from Cairo::Surface | |
Surface (cairo_surface_t *cobject, bool has_reference=false) | |
Create a C++ wrapper for the C instance. More... | |
Surface (const Surface &)=delete | |
Surface & | operator= (const Surface &)=delete |
virtual | ~Surface () |
const unsigned char * | get_mime_data (const std::string & mime_type, unsigned long & length) |
Return mime data previously attached to surface using the specified mime type. More... | |
void | set_mime_data (const std::string & mime_type, unsigned char *data, unsigned long length, const SlotDestroy & slot_destroy) |
Attach an image in the format mime_type to surface. More... | |
void | unset_mime_data (const std::string & mime_type) |
Remove the data from a surface. More... | |
void | get_font_options (FontOptions & options) const |
Retrieves the default font rendering options for the surface. More... | |
void | finish () |
This function finishes the surface and drops all references to external resources. More... | |
void | flush () |
Do any pending drawing for the surface and also restore any temporary modifications cairo has made to the surface's state. More... | |
void | mark_dirty () |
Tells cairo to consider the data buffer dirty. More... | |
void | mark_dirty (int x, int y, int width, int height) |
Marks a rectangular area of the given surface dirty. More... | |
void | set_device_offset (double x_offset, double y_offset) |
Sets an offset that is added to the device coordinates determined by the CTM when drawing to surface. More... | |
void | get_device_offset (double & x_offset, double & y_offset) const |
Returns a previous device offset set by set_device_offset(). More... | |
void | set_device_scale (double x_scale, double y_scale) |
Sets a scale that is multiplied to the device coordinates determined by the CTM when drawing to surface. More... | |
void | set_device_scale (double scale) |
Sets x and y scale to the same value. More... | |
void | get_device_scale (double & x_scale, double & y_scale) const |
Returns a previous device scale set by set_device_scale(). More... | |
double | get_device_scale () const |
Returns the x and y average of a previous device scale set by set_device_scale(). More... | |
void | set_fallback_resolution (double x_pixels_per_inch, double y_pixels_per_inch) |
Set the horizontal and vertical resolution for image fallbacks. More... | |
void | get_fallback_resolution (double & x_pixels_per_inch, double & y_pixels_per_inch) const |
This function returns the previous fallback resolution set by set_fallback_resolution(), or default fallback resolution if never set. More... | |
Type | get_type () const |
Content | get_content () const |
This function returns the content type of surface which indicates whether the surface contains color and/or alpha information. More... | |
void | copy_page () |
Emits the current page for backends that support multiple pages, but doesn't clear it, so that the contents of the current page will be retained for the next page. More... | |
void | show_page () |
Emits and clears the current page for backends that support multiple pages. More... | |
bool | has_show_text_glyphs () const |
Returns whether the surface supports sophisticated Context::show_text_glyphs() operations. More... | |
void | write_to_png (const std::string & filename) |
Writes the contents of surface to a new file filename as a PNG image. More... | |
void | write_to_png_stream (const SlotWriteFunc & write_func) |
Writes the Surface to the write function. More... | |
RefPtr< Device > | get_device () |
This function returns the device for a surface. More... | |
cobject * | cobj () |
Provides acces to the underlying C cairo surface. More... | |
const cobject * | cobj () const |
Provides acces to the underlying C cairo surface. More... | |
Static Public Member Functions | |
static RefPtr< QuartzSurface > | create (CGContextRef cg_context, int width, int height) |
Creates a Quartz surface that wraps the given CGContext. More... | |
static RefPtr< QuartzSurface > | create (Format format, int width, int height) |
Creates a Quartz surface backed by a CGBitmap. More... | |
Static Public Member Functions inherited from Cairo::Surface | |
static RefPtr< Surface > | create (const RefPtr< Surface > other, Content content, int width, int height) |
Create a new surface that is as compatible as possible with an existing surface. More... | |
static RefPtr< Surface > | create (const RefPtr< Surface > & target, double x, double y, double width, double height) |
Create a new surface that is a rectangle within the target surface. More... | |
Additional Inherited Members | |
Public Types inherited from Cairo::Surface | |
enum class | Type { IMAGE = CAIRO_SURFACE_TYPE_IMAGE , PDF = CAIRO_SURFACE_TYPE_PDF , PS = CAIRO_SURFACE_TYPE_PS , XLIB = CAIRO_SURFACE_TYPE_XLIB , XCB = CAIRO_SURFACE_TYPE_XCB , GLITZ = CAIRO_SURFACE_TYPE_GLITZ , QUARTZ = CAIRO_SURFACE_TYPE_QUARTZ , WIN32 = CAIRO_SURFACE_TYPE_WIN32 , WIN32_SURFACE = CAIRO_SURFACE_TYPE_WIN32 , BEOS = CAIRO_SURFACE_TYPE_BEOS , DIRECTFB = CAIRO_SURFACE_TYPE_DIRECTFB , SVG = CAIRO_SURFACE_TYPE_SVG , OS2 = CAIRO_SURFACE_TYPE_OS2 , WIN32_PRINTING = CAIRO_SURFACE_TYPE_WIN32_PRINTING , QUARTZ_IMAGE = CAIRO_SURFACE_TYPE_QUARTZ_IMAGE , SCRIPT = CAIRO_SURFACE_TYPE_SCRIPT , QT = CAIRO_SURFACE_TYPE_QT , RECORDING = CAIRO_SURFACE_TYPE_RECORDING , VG = CAIRO_SURFACE_TYPE_VG , GL = CAIRO_SURFACE_TYPE_GL , DRM = CAIRO_SURFACE_TYPE_DRM , TEE = CAIRO_SURFACE_TYPE_TEE , XML = CAIRO_SURFACE_TYPE_XML , SKIA = CAIRO_SURFACE_TYPE_SKIA , SUBSURFACE = CAIRO_SURFACE_TYPE_SUBSURFACE } |
Cairo::Surface::Type is used to describe the type of a given surface. More... | |
enum class | Format { ARGB32 = CAIRO_FORMAT_ARGB32 , RGB24 = CAIRO_FORMAT_RGB24 , A8 = CAIRO_FORMAT_A8 , A1 = CAIRO_FORMAT_A1 , RGB16_565 = CAIRO_FORMAT_RGB16_565 } |
Cairo::Surface::Format is used to identify the memory format of image data. More... | |
typedef sigc::slot< ErrorStatus(const unsigned char *, unsigned int)> | SlotWriteFunc |
For example: ErrorStatus my_write_func(unsigned char* data, unsigned int length); More... | |
typedef sigc::slot< ErrorStatus(unsigned char *, unsigned int)> | SlotReadFunc |
This is the type of function which is called when a backend needs to read data from an input stream. More... | |
typedef sigc::slot< void()> | SlotDestroy |
For instance, void on_destroy();. More... | |
typedef cairo_surface_t | cobject |
The underlying C cairo surface type. More... | |
Protected Attributes inherited from Cairo::Surface | |
cobject * | m_cobject |
The underlying C cairo surface type that is wrapped by this Surface. More... | |
A QuartzSurface provides a way to render within Apple Mac OS X.
If you want to draw to the screen within a Mac OS X application, you should use this Surface type.
|
explicit |
Create a C++ wrapper for the C instance.
This C++ instance should then be given to a RefPtr.
cobject | The C instance. |
has_reference | whether we already have a reference. Otherwise, the constructor will take an extra reference. |
|
override |
|
static |
Creates a Quartz surface that wraps the given CGContext.
The CGContext is assumed to be in the standard Cairo coordinate space (that is, with the origin at the upper left and the Y axis increasing downward). If the CGContext is in the Quartz coordinate space (with the origin at the bottom left), then it should be flipped before this function is called. The flip can be accomplished using a translate and a scale; for example:
All Cairo operations are implemented in terms of Quartz operations, as long as Quartz-compatible elements are used (such as Quartz fonts).
cg_context | the CGContext to create a surface for |
|
static |
Creates a Quartz surface backed by a CGBitmap.
The surface is created using the Device RGB (or Device Gray, for A8) color space. All Cairo operations, including those that require software rendering, will succeed on this surface.
format | format of pixels in the surface to create |
width | width of the surface, in pixels |
height | height of the surface, in pixels |
CGContextRef Cairo::QuartzSurface::get_cg_context | ( | ) | const |
Returns the CGContextRef associated with this surface, or NULL if none.
Also returns NULL if the surface is not a Quartz surface.