NAME

SET BACK INTERIOR COLOUR - create a structure element to set the back interior colour

SYNOPSIS

C Syntax

void

pset_back_int_colr ( colour )

Pgcolr

* colour;

back interior colour

FORTRAN Syntax

SUBROUTINE psbico ( 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 BACK INTERIOR COLOUR creates a structure element to set the back interior colour.

When the current back interior colour Aspect Source Flag (ASF) is set to INDIVIDUAL, the current value of this attribute defines the back 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

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

The following data types are predefined in phigs.h.

colour

The colour model. 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   Colour Index Specified
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 back

interior colour. This value is not used if COLMOD is greater than zero.

COLR(3)

An array of reals containing the back interior colour. This array is unused if COLMOD is equal to zero or 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 BACK INTERIOR COLOUR element with the value back interior 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 BACK INTERIOR COLOUR element.

Back face attributes (such as back area properties, back interior colour, back interior reflectance equation, back interior shading method, back interior style, and back interior style index) are used only when the face distinguishing mode has the value Yes and are applied to only the back facing portion of area defining primitives. See SET FACE DISTINGUISHING MODE (3PP) for details on front and back face determination.

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

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

ERRORS

005

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

SEE ALSO

SET INTERIOR COLOUR (3PP)

SET FACE DISTINGUISHING MODE (3PP)

SET INDIVIDUAL ASF (3P)

SET INTERIOR REPRESENTATION PLUS (3PP)