NAME

SET POLYLINE SHADING METHOD - create structure element that sets current polyline shading method

SYNOPSIS

C Syntax

void

pset_line_shad_meth ( method )

Pint

method;

shading method

FORTRAN Syntax

SUBROUTINE psplsm ( METHOD )

INTEGER

METHOD

shading method

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

SET POLYLINE SHADING METHOD places a polyline structure element with the value polyline shading method into the open structure. When the current polyline shading method Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute applies to the following output primitives:

POLYLINE

POLYLINE 3

POLYLINE SET 3 WITH DATA

NON-UNIFORM B-SPLINE CURVE

This is a SunPHIGS Extension function based on PHIGS PLUS and is not part of the PHIGS standard.

C Input Parameter

The following data type is predefined in phigs.h.

method The polyline shading method.

1   PSD_NONE       No Shading
2   PSD_COLOUR     Colour Interpolation Shading

FORTRAN Input Parameter

The following data type is predefined in phigs77.h.

METHOD

The value of the shading method.

1   PSDNON     No Shading
2   PSDCOL     Colour Interpolation Shading

Execution

Depending on the edit mode, a SET POLYLINE SHADING METHOD element is inserted into the open structure after the element pointer, or replaces the element pointed to by the element pointer. In either case, the element pointer is updated to point to the newly created SET POLYLINE SHADING METHOD element.

When the structure is traversed, the current polyline shading method entry in the traversal state list is set to the specified value. This value is used with subsequent line output primitives when the current polyline shading method ASF entry in the traversal state list is INDIVIDUAL. During traversal, if the specified shading method is not available on a workstation, method one will be used on that workstation.

When the current polyline shading method ASF is set to BUNDLED, the polyline shading method is taken from the workstation extended representation indicated by the current polyline index. In this case, the polyline shading method set with SET POLYLINE SHADING METHOD has no effect.

When the shading method is NONE, each segment of the polyline or curve will be drawn in a single colour. If the primitive specifies per-vertex colour, then each segment will be drawn using the colour associated with the first vertex of the segment.

ERRORS

005

Ignoring function, function requires state (PHOP, * ,STOP, * )

SEE ALSO

INTRO (3PP)

POLYLINE SET 3 WITH DATA (3PP)

PHIGS WORKSTATION DESCRIPTION TABLE (7P)

NON-UNIFORM B-SPLINE CURVE (3PP)