Shaded Image of the Work View

Synopsis

SOLPIX / 'filename' [,SIZE,num,num] [,METHOD,num][,RESULT,numa][,IFERR,label:]

Description

Allows you to create the image file used to display shaded images of surfaces and solids. You can interactively retrieve this file in NX to display your shaded model.

The SOLPIX statement was designed to run in BATCH mode as the generation time for an image file can be lengthy, depending on the various parameters that are set.

Parameters

Parameter

Description

'filename'

The name of the image file to be created. If no extension is specified, the system adds the extension .TIF.

SIZE

Minor word that specifies the size of the device screen in pixels. Specify two values greater than zero. The first value represents the number of pixel columns (the number of pixels in the X axis). The second value represents the number of pixel rows (the number of pixels in the Y axis). For example, specifying SIZE,150,150 would give you a device screen of 150 x 150 pixels. This parameter is not necessary if the program is being run interactively; in which case, the system queries the device in use as to its size. In GRIP Batch, however, if this parameter is not programmed, the default used is 256 X the aspect ratio.

METHOD

Minor word that indicates that the high quality shading method number is to follow.

numa

Number indicating the method of high quality shading to be used, as specified according to the following:

0 – Flat
1 – Gouraud
2 – Phong
3 – Improved
4 – Preview
5 – Photo-realistic
6 – Ray Traced

RESULT

Minor word that indicates the following field provides a return area for error codes.

numa

Return area for error codes. An error code of the value 1 is a warning only; although it activates the IFERR condition, the system still creates the shaded image file.

Error code values are as follows:

Value	Error message
0	No errors
1	Unsupported High Quality parameters were ignored.
2	At least one value is out of range
3
4
5	Existing file
6	File access error (CFI error)

IFERR,label:

Specifies a label to which program execution jumps if an error occurs, for example, if a parameter value is specified that is out of the acceptable range.