CoCreate OneSpace Designer - Commands Reference Manual

CREATE_VP_DUMP interrupt action

CREATE_VP_DUMP produces a hardcopy of the contents of a specified viewport.

Syntax


                       +----------------------<---------------------+
                       |                                            |
---->(CREATE_VP_DUMP)--+----------------------->--------------------+---->
                       |                                            |
                       +->(:VIEWPORT)--+--|viewport|-------------+--+
                       |               |                         |  |
                       |               +------------>------------+  ^
                       |                                            |
                       +->(:PRINTER)---+--|printer|--------------+--+
                       |               |                         |  |
                       |               +------------>------------+  ^
                       |                                            |
                       +->(:SBFILE)----+--|Filename|-------------+--+
                       |                                            |
                       +->(:PSFILE)-------|Filename|----------------+
                       |                                            |
                   (1) +->(:BACKGROUND-ON)--------------------------+
                       |                                            |
                   (1) +->(:BACKGROUND-OFF)-------------------------+
                       |                                            |
                   (1) +->(:COLOR-ON)-------------------------------+
                       |                                            |
                   (1) +->(:COLOR-OFF)------------------------------+

                   (1) Options are only meaningful for :PSFILE

Options

The following options are available to dump the contents of the active viewport.

:VIEWPORT - specifies the viewport you want to take a snapshot of.
:PRINTER - specifies the printer to produce the hard copy.
:SBFILE - specifies a filename for the dump.
:PSFILE - specifies a filename for the postscript dump.
- :BACKGROUND-ON - specifies to include the background (1)
- :BACKGROUND-OFF - specifies to exclude the background (1)
- :COLOR-ON - specifies color mode (1)
- :COLOR-OFF - specifies black and white mode (1)

When to use

Use this action to produce a hard copy of a specified viewport.

Example

The following parameter sequence creates a dump of the specified viewport.

CREATE_VP_DUMP :VIEWPORT "vport1" :PRINTER "Paintj- XL300"
COMPLETE

CREATE_VP_DUMP :VIEWPORT "vport1" :PSFILE "/tmp/out.ps"
:BACKGROUND-OFF :COLOR-ON COMPLETE