NAME

SET EDGE COLOUR - create structure element to set current edge direct colour attribute

SYNOPSIS

C Syntax

void

pset_edge_colr ( colour )

Pgcolr

* colour;

edge colour

FORTRAN Syntax

SUBROUTINE pseco ( COLMOD, ICOLR, COLR )

INTEGER      COLMOD       colour model
INTEGER      ICOLR        colour table index
REAL         COLR(3)      colour triple

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

SET EDGE COLOUR creates a structure element to set the current edge direct colour attribute.

When the current edge colour Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute applies to the following output primitives:

FILL AREA SET

FILL AREA SET 3

FILL AREA SET 3 WITH DATA

NON-UNIFORM B-SPLINE SURFACE

SET OF FILL AREA SET 3 WITH DATA

QUADRILATERAL MESH 3 WITH DATA

TRIANGLE STRIP 3 WITH DATA

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

C Input Parameter

colour

Edge colour. Pgcolr is defined as:

typedef struct {

Pint

type;

/* indirect, RGB, CIE, HSV, HLS * /

union {

Pint

index;

/* colour table index * /

struct {

      Pfloat          x;       /* red, hue, and so on * /
      Pfloat          y;       /* green, saturation, lightness,
                                  and so on * /
      Pfloat          z;       /* blue, value, saturation, and
                                  so on * /
 } general;
} val;

} Pgcolr;

FORTRAN Input Parameters

The following data types are predefined in phigs77.h.

COLMOD

The colour model. The predefined values are:

0   PINDIR   Indirect
1   PRGB     Red, Green, and Blue
2   PCIE     CIE Colour Model
3   PHSV     Hue, Saturation, and Value
4   PHLS     Hue, Lightness, and Saturation

ICOLR An integer index into the workstation colour table for determining the edge

colour. This value is only used if COLMOD is equal to PINDIR.

COLR(3)

An array of reals containing the edge colour. This array is unused if COLMOD is equal to PINDIR.

COLR(1 )= Red, Hue, and so on

COLR(2 )= Green, Saturation, Lightness, and so on

COLR(3 )= Blue, Value, Saturation, and so on

Execution

Depending on the edit mode, a SET EDGE COLOUR element with the value edge colour in the specified colour model is inserted into the open structure after the element pointer or replaces the element pointed at by the element pointer. The element pointer is then updated to point to this SET EDGE COLOUR element.

When the current edge colour ASF is set to INDIVIDUAL, filled area output primitives that follow in the structure network are drawn using the current edge colour.

When the current edge colour ASF is set to BUNDLED, the edge colour is taken from the workstation extended representation indicated by the current edge index. In this case, the edge colour set with SET EDGE COLOUR has no effect.

The standard PHIGS function SET EDGE COLOUR INDEX is equivalent to calling to SET EDGE COLOUR with type INDIRECT.

ERRORS

005

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

SEE ALSO

COLOUR (7P)

SET EDGE REPRESENTATION PLUS (3PP)

SET EDGE COLOUR INDEX (3P)