SYNOPSIS
   C Syntax    void

pset_int_colr ( colour )

                    Pgcolr   * colour;  interior colour

FORTRAN Syntax

SUBROUTINE psico ( COLMOD, ICOLR, COLR )

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

Required PHIGS

(PHOP, * ,STOP, * )

Operating States

DESCRIPTION
        Purpose    SET INTERIOR COLOUR creates a structure element to set the interior colour attribute.

When the current interior colour Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute defines the interior colour to be applied to the following output primitives:

FILL AREA

FILL AREA 3

FILL AREA SET

FILL AREA SET 3

FILL AREA SET 3 WITH DATA

NON-UNIFORM B-SPLINE SURFACE

POLYHEDRON 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 Parameters

The following data types are predefined in phigs.h.

colour

Interior 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 interior

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

COLR(3)

An array of reals containing the colours for the interior. 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 INTERIOR COLOUR element 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 INTERIOR COLOUR element.

When the current interior colour ASF is set to INDIVIDUAL, filled-area output primitives, which follow in the structure network are filled using the current interior colour.

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

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

ERRORS

005

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

SEE ALSO

COLOUR (7P)

SET INTERIOR REPRESENTATION PLUS (3PP)

SET INTERIOR COLOUR INDEX (3P)