SET FACE CULLING MODE(3P+) — MISC. REFERENCE MANUAL PAGES

NAME

SET FACE CULLING MODE − create a structure element to set the face culling mode

SYNOPSIS

C Syntax

void
psetfacecullmode ( mode )
Pcullmodemode;culling mode

FORTRAN Syntax

SUBROUTINE psfcm ( MODE )
INTEGERMODEculling 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 DISTIGUISHING MODE (3P+) for details on front and back face determination.

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

C Input Parameters

All of the following data types are predefined in phigs.h.

modeA pointer to a Pcullmode structure. A Pcullmode structure is defined as:

typedef enum {
PCULL_NONE,
PCULL_BACKFACE,
PCULL_FRONTFACE
} Pcullmode;

FORTRAN Input Parameters

All of the following data types are predefined in phigs77.h.

MODE
The culling mode. Predefined values are:

0PCULNONone
1PCULBFBackface Culling
2PCULFFFrontface 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

005Ignoring function, function requires state (PHOP, ∗, STOP, ∗)

Museum