[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPLNR - Set Linetype Rendering

GPLNR (wsid, ltype, style, data)

Purpose

Use GPLNR to set the line rendering attributes for the specified line type table entry. The specified attributes are applied as part of rendering a line primitive. These attributes control the appearance of line primitives when rendered on the display.

The line rendering styles are:

  • 1=WORKSTATION_DEPENDENT_RENDERING

    Use the line type representation entry to render the line. The final appearance of the line is workstation-dependent and depends on the capabilities of the workstation.

  • 2=SCALED_TO_FIT_RENDERING

    Use the line type representation entry to render the line as follows:

    1. If the length of the line is less than the specified minimum threshold, then the graPHIGS API renders the line as a solid line.

    2. The line type pattern in the specified entry of the workstation's line type table is scaled such that the graPHIGS API renders the line using a whole number of repetitions of the scaled pattern. (The pattern may be scaled larger or smaller to fit.)

      3. The line rendering style for line table entry 1 cannot be changed. It always defines the solid line pattern.

      Parameters

      wsid -- specified by user, fullword integer

      Workstation identifier.

      ltype -- specified by user, fullword integer

      Line type. This parameter specifies the line type table entry to which the rendering attributes are applied (>=2)

      style -- specified by user, fullword integer

      Rendering style identifier (1=WORKSTATION_DEPENDENT_RENDERING, 2=SCALED_TO_FIT_RENDERING )

      data -- specified by user, array of data

      Rendering style definition data. Depending on the style parameter values you specified, rendering definition data is as follows:

      If style=1 (WORKSTATION_DEPENDENT_RENDERING )

      N/A (No data is required for workstation dependent rendering)

      If style=2 (SCALED_TO_FIT_RENDERING )

      The following data is required:

    3. Minimum threshold size (DC)

      A short floating-point number that specifies the minimum threshold size for scaling the line pattern (>=0)

    4. Line pattern unit size (DC)

      A short floating-point number that specifies the length of the line pattern unit of the specified entry of the line type representation table (>0)

      5. Error Codes

      25
      SPECIFIED WORKSTATION DOES NOT EXIST
      35
      WORKSTATION HAS ONLY INPUT CAPABILITIES
      63
      LINETYPE VALUE < ONE
      64
      SPECIFIED LINETYPE NOT AVAILABLE ON WORKSTATION
      71
      FIELD IN DEFINITION DATA IS INVALID
      274
      THIS FUNCTION IS NOT SUPPORTED BY THE WORKSTATION
      275
      SPECIFIED ENTRY CANNOT BE CHANGED
      297
      LINE RENDERING STYLE IS INVALID

      Related Subroutines

      GPLT
      Set Linetype
      GPLTR
      Set Linetype Representation
      GPQLNR
      Inquire List of Line Rendering Styles

      RCP code

      201329427 (X'0C000B13')

      [ Previous | Next | Contents | Glossary | Home | Search ]