SET EDIT MODE(3P) — SUNPHIGS LIBRARY

NAME

SET EDIT MODE − set the edit mode controlling how new structure elements are added to the open structure

SYNOPSIS

C Syntax

void
pseteditmode ( mode )
Peditmodemode;edit mode

FORTRAN Syntax

SUBROUTINE psedm ( EDITMO )
INTEGEREDITMOedit mode (PINSRT, PREPLC)

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

The SET EDIT MODE subroutine sets the edit mode controlling how PHIGS subroutines that create new structure elements will add the new element to the open structure. The mode may be INSERT or REPLACE. INSERT is the default.

C Input Parameter

modeAn enumerated variable specifying the edit mode to be used to add new elements to the open structure. Valid values (defined in phigs.h) are:

PEDIT_INSERT
PEDIT_REPLACE

FORTRAN Input Parameter

EDITMO
An enumerated variable specifying the edit mode to be used to add new elements to the open structure. Valid values (defined in phigs77.h) are:

PINSRT(insert)
PREPLC(replace)

Execution

The SET EDIT MODE subroutine sets the edit mode in the PHIGS state list to INSERT or REPLACE. The value in this entry controls how PHIGS subroutines that create new structure elements add the new element to the currently open structure. While the edit mode is INSERT, new structure elements are inserted into the open structure after the element pointed to by the current element pointer. While the edit mode is REPLACE, new structure elements replace the element in the open structure pointed to by the current element pointer.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

Museum