summaryrefslogtreecommitdiff
path: root/xc/unsupported/doc/PHIGS/man3/p064
blob: 93b311eb990b3e83dec3d37198847b222898ac88 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
.\"##
.\" $XConsortium: p064,v 5.1 91/02/16 09:37:50 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 "GENERALIZED STRUCTURE ELEMENT" 3P "29 February 1991"
.\" Commenting out the string definition of "I".
.\" This is very bad style and may be causing bugs downstream.
.\" The string is not used anywhere else.
.\" -- JH (05-15-89)
.\" .ds I \s-2INTRO INTERNATIONALIZATION\s+2 
.ds \s-2C\s+2 \s-2ESCAPE\s+2 -7 \fIinquire character set facilities\fP 
.ds F \s-2ESCAPE\s+2 -8 \fIinquire fonts for character set\fP
.\".ds x \s-2ESCAPE\s+2 -9, \s-2INQUIRE TEXT EXTENT PLUS \s+2
.\".ds t \s-2ESCAPE\s+2 -10, \s-2SET FONT TEXT REPRESENTATION PLUS \s+2 
.\".ds T \s-2ESCAPE\s+2 -11 \fIINQUIRE FONT TEXT REPRESENTATION PLUS\fP 
.SH NAME
GENERALIZED STRUCTURE ELEMENT \- create a generalized structure element
.IX "Generalized Structure Elements" "GENERALIZED STRUCTURE ELEMENT"
.IX "Highlighting" "GENERALIZED STRUCTURE ELEMENT"
.IX "Set Highlight Colour Index" "GENERALIZED STRUCTURE ELEMENT"
.IX "Set Character Set for Codeset" "GENERALIZED STRUCTURE ELEMENT"
.IX "Set Font for Codeset" "GENERALIZED STRUCTURE ELEMENT"
.IX "Set Text Slant Angle" "GENERALIZED STRUCTURE ELEMENT"
.IX "Set Annotation Text Slant Angle" "GENERALIZED STRUCTURE ELEMENT"
.IX "Character Sets" "GENERALIZED STRUCTURE ELEMENT"
.IX "Fonts" "GENERALIZED STRUCTURE ELEMENT"
.IX "GSE" "GENERALIZED STRUCTURE ELEMENT"
.IX "Elements" "GENERALIZED STRUCTURE ELEMENT"
.IX "Implementation-Specific Functions" "GENERALIZED STRUCTURE ELEMENT"
.SH SYNOPSIS
.SS C Syntax
.ft B
.ta 1.25i 3i
.nf
void
pgse ( id, gse )
Pint	id;	\fIgse identifier\fP 
Pgse_data	*gse;	\fIgse data record\fP
.fi
.ft R
.SS Required PHIGS Operating States
(PHOP, *, STOP, *)
.SH DESCRIPTION
.SS Purpose
\s-2GENERALIZED STRUCTURE ELEMENT\s+2 creates an implementation dependent structure element.
There are no \s-2GSE\s+2s implemented in the \s-2PEX-SI\s+2 graphics library.
.SS C Input Parameters
.IP \fIid \fP
The identifier of the generalized structure element to insert. 
.sp
.IP \fIgse\fP
A pointer to a Pgse_data union containing the information
needed to perform the function specified by \fIid\fP.
Pgse_data is defined in phigs.h as:
.nf
.sp .4
.ta .5i +.5i +.75i
typedef union {
	struct {
.sp .2
		Pint	unused;	
.sp .2
	} gse_r1;
	Pdata	 unsupp;	/* unsupported GSE data record */
.sp .2
} Pgse_data;
.SS Execution
.LP
If the current edit mode is \s-2INSERT\s+2, then \s-2GENERALIZED STRUCTURE
ELEMENT\s+2 is inserted into the currently open structure after the
element currently pointed to by the element pointer. If the edit mode is
\s-2REPLACE\s+2, then \s-2GENERALIZED STRUCTURE ELEMENT\s+2 replaces the
element pointed to by the element pointer. 
In either case, the element pointer is updated to
point to the new element.
.SH ERRORS
.IP 005
Ignoring function, function requires state (\s-2PHOP, *, STOP, *\s+2)