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

GPESC - Set Edge Scale Factor

GPESC (edgesf)

Purpose

Use GPESC to insert a Set Edge Scale Factor structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Edge Scale Factor structure element depending on the current edit mode.

This structure element specifies a value that the graPHIGS API uses to determine how wide to draw the edges of subsequent output primitives to which this attribute applies. At structure traversal time, the graPHIGS API uses this scale factor to determine the width of the edge when the edge scale factor aspect source flag is set to 2=INDIVIDUAL and additionally for polygon output primitives when the corresponding edge flag is set to 2=ON

The edge scale factor element specifies the edge's width as a fraction of the nominal edge width. The device support multiplies this scale factor by the nominal width of a line on the corresponding device to determine the requested width. The graPHIGS API maps the calculated value to the closest width available on the device. A scale factor of 1.0, which is the traversal default, generates a nominal size line on any workstation.

Parameters

edgesf -- specified by user, short floating-point number

Edge scale factor, specified as a fraction of the nominal linewidth.

Error Codes

5
FUNCTION REQUIRES STATE STOP OR NROP (NOT STCL)

Related Subroutines

GPASF
Attribute Source Flag Setting
GPQEF
Inquire Edge Facilities
GPQPER
Inquire Predefined Edge Representation
GPQXER
Inquire Extended Edge Representation
GPXER
Set Extended Edge Representation

RCP code

201328903 (X'0C000907')


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