A
ps-setup% object contains configuration information for
producing PostScript files using a
post-script-dc% object.
To a lesser extent, it contains information for printing with a
printer-dc% object.
When a post-script-dc% object is created, its configuration
is determined by the current-ps-setup parameter’s
ps-setup% value. After a post-script-dc% object is
created, it is unaffected by changes to the current-ps-setup
parameter or mutations to the ps-setup% object.
Creates a new
ps-setup% object with the (platform-specific)
default configuration.
Copies the settings copy-from to a-ps-setup, excluding the
filename unless copy-filename? is true.
Historically, gets the printer command used to print a file on
Unix. The default is "lpr". This value is not currently used
by any platforms.
Gets the PostScript output filename. A
#f value (the default)
indicates that the user should be prompted for a filename when a
post-script-dc% object is created.
Reports whether Level 2 commands are output in PostScript files.
Currently, Level 2 commands are only needed to include color bitmap
images in PostScript output (drawn with draw-bitmap),
or bitmap pen and brush stipples. When Level 2 commands are disabled,
bitmaps are converted to grayscale images and stipples are not
supported.
Returns the current settings for horizontal and vertical PostScript
margins. See also
set-margin.
Gets the printing mode that determines where output is sent:
'preview, 'file, or 'printer. The default
for X is 'preview. The value in Windows and Mac OS X is
always 'file.
Gets the orientation:
'portrait or
'landscape. The
default is
'portrait. Unlike most other settings, this one
affects native printing (via
printer-dc%) as well as
PostScript output.
Landscaped orientation affects the size of the drawing area as
reported by get-size: the horizontal and vertical
sizes determined by the selected paper type are transposed and then
scaled.
Returns the name of the current paper type: "A4 210 x 297 mm",
"A3 297 x 420 mm", "Letter 8 1/2 x 11 in", or
"Legal 8 1/2 x 14 in". The default is "Letter 8 1/2 x 11 in".
The paper name determines the size of the drawing area as reported by
get-size (along with landscape transformations from
get-orientation and/or the scaling factors of
get-scaling). It also determines the bounding box
of PostScript output when a post-script-dc% context is
created with a true value for the use-paper-bbox?
initialization argument.
Gets the command used to view a PostScript file for X. The default is
"gv". This value is not used by other platforms.
Gets the scaling factor for PostScript output. The x box is filled with the horizontal scaling factor. The y box is filled with the
vertical scaling factor. The default is 0.8 by
0.8.
This scale is in addition to a scale that can be set by set-scale in a post-script-dc% context. The size reported
by get-size is the size of the selected paper type
(transposed for landscaped mode) divided by this scale.
Gets the translation (from the bottom left corner) for PostScript
output. The x box is filled with the horizontal offset.
The y box is filled with the vertical offset. The default is
0.0 and 0.0.
The translation is not scaled by the numbers returned from
get-scaling and the translation does not affect
the size of the drawing area.
Historically, sets the printer command that was used to print a file
on Unix. See
get-command.
Sets the horizontal and vertical margins used when printing an editor
with the
print method. These margins are always
used for printing, whether the drawing destination is a
post-script-dc% or
printer-dc%. The margins are in
the units of the destination
printer-dc% or
post-script-dc%. In the case of
post-script-dc%
printing, the editor margin is in addition to the PostScript margin
that is determined by
set-margin.
Sets the PostScript output filename. See
get-file.
Sets whether Level 2 commands are output in PostScript files. See
get-level-2.
Sets the horizontal and vertical PostScript margins. When drawing to a
post-script-dc%, the page size reported by
get-size subtracts these margins from the normal page area (before
taking into account scaling affects). In addition, drawing into the
post-script-dc% produces PostScript output that is offset by
the margins.
When using the output of a post-script-dc% as
Encapsulated PostScript, the margin values are effectively
irrelevant. Changing the margins moves the PostScript image in
absolute coordinates, but it also moves the bounding box.
The margins are in unscaled post-script-dc% units, which
are points. The default margins are 16 points.
Sets the printing mode controlling where output is sent. See
get-mode.
On Windows and Mac OS X, if 'preview or 'printer
is provided, an exn:fail:contract exception is raised.
Sets the scaling factor for PostScript output. See
get-scaling.
Sets the translation (from the bottom left corner) for PostScript
output. See
get-translation.