post-script-dc% : class?

superclass: object%

extends:  dc<%>

A post-script-dc% object is a PostScript device context, that can write PostScript files on any platform. See also ps-setup%.

Be sure to use the following methods to start/end drawing:

• start-doc

• start-page

• end-page

• end-doc

Attempts to use a drawing method outside of an active page raises an exception.

See also printer-dc%.

(new post-script-dc%  [ [interactive interactive]       [parent parent]       [use-paper-bbox use-paper-bbox]       [as-eps as-eps]])

→ (is-a?/c post-script-dc%)

interactive : any/c = #t

parent   :   (or/c (is-a?/c frame%) (is-a?/c dialog%) false/c)       =   #f

use-paper-bbox : any/c = #f

as-eps : any/c = #t

If interactive is true, the user is given a dialog for setting printing parameters (see get-ps-setup-from-user); the resulting configuration is installed as the current configuration). If the user chooses to print to a file (the only possibility under Windows and Mac OS X), another dialog is given to select the filename. If the user hits cancel in either of these dialogs, then ok? returns #f.

If parent is not #f, it is used as the parent window of the configuration dialog.

If interactive is #f, then the settings returned by current-ps-setup are used. A file dialog is still presented to the user if the get-file method returns #f, and the user may hit cancel in that case so that ok? returns #f.

If use-paper-bbox is #f, then the PostScript bounding box for the output is determined by drawing commands issued to the object; such a bounding box encloses all parts of the drawing ignoring clipping regions (so the bounding box may be approximate). If use-paper-bbox is not #f, then the bounding box is determined by the current paper size (as specified by current-ps-setup), and the bounding box does not include the margin (also specified by current-ps-setup).

If as-eps is #f, then the generated PostScript does not include an Encapsulated PostScript (EPS) header, and instead includes a generic PostScript header. Otherwise, the generated PostScript includes a header that identifiers it as EPS.

See also ps-setup% and current-ps-setup. The settings for a particular post-script-dc% object are fixed to the values in the current configuration when the object is created (after the user has interactively adjusted them when interactive is true).