PICTURES - Ultramarine.com

PICTURES - Ultramarine.com PICTURES

As mentioned above, one can obtain a picture of the current situation by issuing the command the &PICTURE command. This command is used to get pictures of everything, and as a result, it has options to control:

The type of data used in the picture,
The title of the picture,
The portion of global space to paint,
The "annotation" of the picture,
The production of a deflected shape picture,
The use of color in the picture, and
The names of things included in the picture.

Once something is specified on a &PICTURE command, it is remembered through out a MOSES session, unless however, it is changed. There are Tool Bar controls for all of the things on the picture command as well as a set of keyboard shortcuts to make life easier.

There is quite a bit of data which can be defined to create a picture which is precisely what one wants. To make it easier to reproduce these pictures, MOSES employs the concept of a "user defined view". One defines a view with the command:


     &PI_VIEW -OPTION, V_NAME, ......

Here, V_NAME is the name which will be given to the view, and the data which follows is any data which can be placed on the &PICTURE command. The -OPTION may be either -ADD or -DELETE. For -DELETE, only V_NAME is required. Now, once a view has been defined, a picture can be produced with

     &PICTURE, V_NAME, ....

Here, V_NAME is the name of a view defined via &PI_VIEW, and what follows can be nothing or any valid &PICTURE data. If additional data is specified, it modifies the picture defined in V_NAME. To make it easy to plot all of "your" views, you can use the string function:

     &NAMES(PI_VIEW)

which returns all of the user defined views.

The form of the command is:


     &PICTURE, VIEW_DATA  -OPTIONS

With so much going on here, it is easy to get a picture which is worthless. The option:



     -RESET

will reset the defaults so that something appears.

By default, the current title and subtitle are placed at the top of the picture. The options -TITLE and -SUBTITLE can be used to alter these values.



     -TITLE, M_TITLE


     -SUBTITLE, S_TITLE

The



     -RENDER R_TYPE

option defines the manner in which the picture will be rendered. If you are in the GUI user interface, you can specify a R_TYPE of SOLID to have the picture rendered as a picture of solid objects. Alternative, a R_TYPE of WF will render the pictures as a "wire frame". WF rendering is the only thing available with a WIN interface. When rendering a solid picture, connectors are rendered as lines so that they will appear regardless of their diameter and/or distance. If, however, you exercise the option



     -CON_SOLID YES/NO

with a value of YES, then they will be rendered as round elements with the proper diameter.

Finally, a picture that has been created may be written to a file for later processing by using the option



     -SAVE_PIC

The file used by this command is specified on the -SECONDARY option of the &DEVICE command.