GPPLSM - Set Polyline Shading Method

Purpose

Use GPPLSM to insert a Set Polyline Shading Method structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Polyline Shading Method structure element depending on the current edit mode.

During structure traversal, the graPHIGS API sets the current polyline shading method in the traversal state list and uses this shading method when rendering subsequent Polyline Set 3 With Data (GPPLD3) primitives. If the specified polyline shading method is 1=POLYLINE_SHADING_NONE and Polyline Set 3 With Data specifies vertex colors in its primitive definition, then the graPHIGS API uses the i ^th vertex color to color the i ^th line of the polyline. If the current polyline shading method is 2=POLYLINE_SHADING_COLOR and Polyline Set 3 With Data specifies vertex colors in its primitive definition, then the graPHIGS API interpolates the color along each line between the colors specified at the endpoints of the line. If the GPPLSM primitive definition does not specify a vertex color, then the graPHIGS API renders the entire primitive using the current polyline color and GPPLSM has no effect.

The traversal default for polyline shading method is 1=POLYLINE_SHADING_NONE

If the specified polyline shading method is not within the allowable range, then the shading method defaults to a value of 1=POLYLINE_SHADING_NONE

Parameters