This surface is not rendered to the screen but instead renders the drawing to a PostScript file on disk.
Public Member Functions | |
void | dsc_begin_page_setup () |
This function indicates that subsequent calls to dsc_comment() should direct comments to the PageSetup section of the PostScript output. | |
void | dsc_begin_setup () |
This function indicates that subsequent calls to dsc_comment() should direct comments to the Setup section of the PostScript output. | |
void | dsc_comment (std::string comment) |
Emit a comment into the PostScript output for the given surface. | |
PsSurface (cairo_surface_t *cobject, bool has_reference=false) | |
Create a C++ wrapper for the C instance. | |
void | set_size (double width_in_points, double height_in_points) |
Changes the size of a PostScript surface for the current (and subsequent) pages. | |
virtual | ~PsSurface () |
Static Public Member Functions | |
static RefPtr< PsSurface > | create (cairo_write_func_t write_func, void *closure, double width_in_points, double height_in_points) |
Creates a PsSurface with a specified dimensions that will be written to the given write function instead of saved directly to disk. | |
static RefPtr< PsSurface > | create (std::string filename, double width_in_points, double height_in_points) |
Creates a PsSurface with a specified dimensions that will be saved as the given filename. |
Cairo::PsSurface::PsSurface | ( | cairo_surface_t * | cobject, | |
bool | has_reference = false | |||
) | [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. |
virtual Cairo::PsSurface::~PsSurface | ( | ) | [virtual] |
static RefPtr<PsSurface> Cairo::PsSurface::create | ( | cairo_write_func_t | write_func, | |
void * | closure, | |||
double | width_in_points, | |||
double | height_in_points | |||
) | [static] |
Creates a PsSurface with a specified dimensions that will be written to the given write function instead of saved directly to disk.
write_func | The function to be called when the backend needs to write data to an output stream | |
closure | closure data for the write function | |
width_in_points | The width of the PostScript document in points | |
height_in_points | The height of the PostScript document in points |
static RefPtr<PsSurface> Cairo::PsSurface::create | ( | std::string | filename, | |
double | width_in_points, | |||
double | height_in_points | |||
) | [static] |
Creates a PsSurface with a specified dimensions that will be saved as the given filename.
filename | The name of the PostScript file to save the surface to | |
width_in_points | The width of the PostScript document in points | |
height_in_points | The height of the PostScript document in points |
void Cairo::PsSurface::dsc_begin_page_setup | ( | ) |
This function indicates that subsequent calls to dsc_comment() should direct comments to the PageSetup section of the PostScript output.
This function call is only needed for the first page of a surface. It should be called after any call to dsc_begin_setup() and before any drawing is performed to the surface.
void Cairo::PsSurface::dsc_begin_setup | ( | ) |
This function indicates that subsequent calls to dsc_comment() should direct comments to the Setup section of the PostScript output.
This function should be called at most once per surface, and must be called before any call to dsc_begin_page_setup() and before any drawing is performed to the surface.
void Cairo::PsSurface::dsc_comment | ( | std::string | comment | ) |
Emit a comment into the PostScript output for the given surface.
See the cairo reference documentation for more information.
comment | a comment string to be emitted into the PostScript output |
void Cairo::PsSurface::set_size | ( | double | width_in_points, | |
double | height_in_points | |||
) |
Changes the size of a PostScript surface for the current (and subsequent) pages.
This function should only be called before any drawing operations have been performed on the current page. The simplest way to do this is to call this function immediately after creating the surface or immediately after completing a page with either Context::show_page() or Context::copy_page().
width_in_points | new surface width, in points (1 point == 1/72.0 inch) | |
height_in_points | new surface height, in points (1 point == 1/72.0 inch) |