.\"##
.\" $XConsortium: p260,v 5.2 94/04/17 20:57:27 rws Exp $
.\"##
.\"## 
$XMCOPY
.\"## Copyright (c) 1990, 1991 by Sun Microsystems, Inc. 
.\"## 
.\"##                         All Rights Reserved
.\"## 
.\"## Permission to use, copy, modify, and distribute this software and its 
.\"## documentation for any purpose and without fee is hereby granted, 
.\"## provided that the above copyright notice appear in all copies and that
.\"## both that copyright notice and this permission notice appear in 
.\"## supporting documentation, and that the name of Sun Microsystems,
.\"## not be used in advertising or publicity 
.\"## pertaining to distribution of the software without specific, written 
.\"## prior permission.  
.\"## 
.\"## SUN MICROSYSTEMS DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, 
.\"## INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO
.\"## EVENT SHALL SUN MICROSYSTEMS BE LIABLE FOR ANY SPECIAL, INDIRECT OR
.\"## CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF
.\"## USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
.\"## OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
.\"## PERFORMANCE OF THIS SOFTWARE.
.TH "RESTORE MODELLING CLIPPING VOLUME" 3P "29 February 1991"
.SH NAME
RESTORE MODELLING CLIPPING VOLUME \- create structure element to restore the modelling clipping volume
.IX "Modelling Clipping" "RESTORE MODELLING CLIPPING VOLUME"
.IX "Modelling and Transformation Attributes" "RESTORE MODELLING CLIPPING VOLUME"
.IX "Attributes, Modelling and Transformation Attributes" "RESTORE MODELLING CLIPPING VOLUME"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
prestore_model_clip_vol ()
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
.LP
\s-2RESTORE MODELLING CLIPPING VOLUME\s+2
creates a structure element
to restore the modelling clipping volume, undoing
the effect of \s-2SET MODELLING CLIPPING VOLUME\s+2 and
\s-2SET MODELLING CLIPPING VOLUME 3\s+2 elements in this structure.
.SS Execution
If the current edit mode is \s-2INSERT\s+2, a
\s-2RESTORE MODELLING CLIPPING VOLUME\s+2 element is inserted
into the currently open structure after
the element pointed to by the current element pointer.  If the edit
mode is \s-2REPLACE\s+2, the new element replaces the element pointed to by
the element pointer.  In either case, the element pointer is
updated to point to the new \s-2RESTORE MODELLING CLIPPING VOLUME\s+2
element.
.LP   
During traversal, a \s-2RESTORE MODELLING CLIPPING VOLUME\s+2 element resets
the current modelling clipping volume to the value of that attribute
inherited by the structure being traversed.  The attribute may have
been modified by traversal of \s-2SET MODELLING CLIPPING VOLUME\s+2 and/or
\s-2SET MODELLING CLIPPING VOLUME 3\s+2 elements.
.LP    
Modelling clipping to the volume controlled by these three elements
is enabled and disabled by \s-2SET MODELLING CLIPPING INDICATOR\s+2.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)
.SH SEE ALSO
.nf
.IP
.ta 0.5i
.SM "INQUIRE MODELLING CLIPPING FACILITIES (3P)"
.SM "SET MODELLING CLIPPING INDICATOR (3P)"
.SM "SET MODELLING CLIPPING VOLUME (3P)"
.SM "SET MODELLING CLIPPING VOLUME 3 (3P)"
.fi