NAME

SET FACE CULLING MODE - create structure element to set face culling mode

SYNOPSIS

C Syntax

void

pset_face_cull_mode ( mode )

Pcull_mode

mode;

culling mode

FORTRAN Syntax

SUBROUTINE psfcm ( MODE )

INTEGER

MODE

culling mode

Required PHIGS Operating States

(PHOP, * ,STOP, * )

DESCRIPTION

Purpose

SET FACE CULLING MODE creates a structure element to set the face culling mode. The attribute face culling mode defines control over the visibility of front and back facing portions of area defining primitives. See SET FACE DISTINGUISHING MODE (3PP) for details on front and back face determination.

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.

mode

A pointer to a Pcull_mode structure. A Pcull_mode structure is defined as:

typedef enum {

PCULL_NONE,

PCULL_BACKFACE,

PCULL_FRONTFACE

} Pcull_mode;

FORTRAN Input Parameters

The following data types are predefined in phigs77.h.

MODE The culling mode. Predefined values are:

0   PCULNO     None
1   PCULBF     Backface Culling
2   PCULFF     Frontface Culling

Execution

Depending on the edit mode, a SET FACE CULLING MODE 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 FACE CULLING MODE element.

When face culling mode is None, both front and back facing portions are visible. When face culling mode is Backface, back facing portions are invisible. When it is Frontface, front facing portions are invisible.

ERRORS

005

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

SEE ALSO

SET FACE DISTINGUISHING MODE (3PP)