page(canvas, pagename=None, paperformat=None, rotated=0, centered=1, fittosize=0, margin=1 * unit.t_cm, bboxenlarge=1 * unit.t_pt, bbox=None)¶
Construct a new
page from the given
canvas instance. A string
pagename and the paperformat can be defined. See below, for a list of known
paper formats. If rotated is set, the output is rotated by 90 degrees on the
page. If centered is set, the output is centered on the given paperformat. If
fittosize is set, the output is scaled to fill the full page except for a
given margin. Normally, the bounding box of the canvas is calculated
automatically from the bounding box of its elements. Alternatively, you may
specify the bbox manually. In any case, the bounding box is enlarged on all
sides by bboxenlarge.
document can be written to a file using one of the following methods:
writeEPSfile(file, title=None, strip_fonts=True, text_as_path=False, mesh_as_bitmap=False, mesh_as_bitmap_resolution=300)¶
Write a single page
document to an EPS file or to stdout if file is
set to -. title is used as the document title, strip_fonts enabled
font stripping (removal of unused glyphs), text_as_path converts all text
to paths instead of using fonts in the output, mesh_as_bitmap converts
meshs (like 3d surface plots) to bitmaps (to reduce complexity in the
output) and mesh_as_bitmap_resolution is the resolution of this conversion
in dots per inch.
writePSfile(file, writebbox=False, title=None, strip_fonts=True, text_as_path=False, mesh_as_bitmap=False, mesh_as_bitmap_resolution=300)¶
writePDFfile(file, title=None, author=None, subject=None, keywords=None, fullscreen=False, writebbox=False, compress=True, compresslevel=6, strip_fonts=True, text_as_path=False, mesh_as_bitmap=False, mesh_as_bitmap_resolution=300)¶
document to a PDF file or to stdout if file is set to -.
author, subject, and keywords are used for the document author,
subject, and keyword information, respectively. fullscreen enabled
fullscreen mode when the document is opened, writebbox enables writing of
the crop box to each page, compress enables output stream compression and
compresslevel sets the compress level to be used (from 1 to 9). All other
parameters are identical to the
writeSVGfile(file, text_as_path=True, mesh_as_bitmap_resolution=300)¶
document to a SVG file or to stdout if file is set to -.
The text_as_path and mesh_as_bitmap_resolution have the same meaning as
writeEPSfile(). However, not the different default for
text_as_path due to the missing SVG font support by current browsers.
In addition, there is no mesh_as_bitmap flag, as meshs are always stored
using bitmaps in SVG.
writetofile(filename, *args, **kwargs)¶
Determine the file type (EPS, PS, PDF, or SVG) from the file extension of filename and call the corresponding write method with the given arguments arg and kwargs.
paperformat(width, height, name=None)¶
paperformat with the given width and height and the
Predefined paperformats are listed in the following table
||A0||840 mm||1188 mm|
||910 mm||1370 mm|
||A1||594 mm||840 mm|
||A2||420 mm||594 mm|
||A3||297 mm||420 mm|
||A4||210 mm||297 mm|
||A5||148.5 mm||210 mm|
||Letter||8.5 inch||11 inch|
||Legal||8.5 inch||14 inch|