[OpenSPARC-T2-SAM] / sam-t2 / devtools / v9 / html / python / lib / module-fl.html

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<link rel="STYLESHEET" href="lib.css" type='text/css' />
<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
<link rel='start' href='../index.html' title='Python Documentation Index' />
<link rel="first" href="lib.html" title='Python Library Reference' />
<link rel='contents' href='contents.html' title="Contents" />
<link rel='index' href='genindex.html' title='Index' />
<link rel='last' href='about.html' title='About this document...' />
<link rel='help' href='about.html' title='About this document...' />
<link rel="next" href="module-fl-constants.html" />
<link rel="prev" href="module-cd.html" />
<link rel="parent" href="sgi.html" />
<link rel="next" href="node807.html" />
<meta name='aesop' content='information' />
<title>20.4 fl -- FORMS library for graphical user interfaces</title>
</head>
<body>
<DIV CLASS="navigation">
<div id='top-navigation-panel' xml:id='top-navigation-panel'>
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="20.3.2 Parser Objects"
  href="cd-parser-objects.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="20. SGI IRIX Specific"
  href="sgi.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="20.4.1 Functions Defined in"
  href="node807.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="cd-parser-objects.html">20.3.2 Parser Objects</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="sgi.html">20. SGI IRIX Specific</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node807.html">20.4.1 Functions Defined in</A>
</div>
<hr /></div>
</DIV>
<!--End of Navigation Panel-->

<H1><A NAME="SECTION0022400000000000000000">
20.4 <tt class="module">fl</tt> --
         FORMS library for graphical user interfaces</A>
</H1>

<P>
<A NAME="module-fl"></A>  
<p class="availability">Availability: <span
 class="platform">IRIX</span>.</p>

<P>
This module provides an interface to the FORMS Library<a id='l2h-5112' xml:id='l2h-5112'></a> by Mark Overmars<a id='l2h-5113' xml:id='l2h-5113'></a>.  The source for the
library can be retrieved by anonymous ftp from host
"<tt class="samp">ftp.cs.ruu.nl</tt>", directory <span class="file">SGI/FORMS</span>.  It was last tested
with version 2.0b.

<P>
Most functions are literal translations of their C equivalents,
dropping the initial "<tt class="samp">fl_</tt>" from their name.  Constants used by
the library are defined in module <tt class="module"><a href="module-fl-constants.html">FL</a></tt>
described below.

<P>
The creation of objects is a little different in Python than in C:
instead of the `current form' maintained by the library to which new
FORMS objects are added, all functions that add a FORMS object to a
form are methods of the Python object representing the form.
Consequently, there are no Python equivalents for the C functions
<tt class="cfunction">fl_addto_form()</tt> and <tt class="cfunction">fl_end_form()</tt>, and the
equivalent of <tt class="cfunction">fl_bgn_form()</tt> is called
<tt class="function">fl.make_form()</tt>.

<P>
Watch out for the somewhat confusing terminology: FORMS uses the word
<i class="dfn">object</i> for the buttons, sliders etc. that you can place in a form.
In Python, `object' means any value.  The Python interface to FORMS
introduces two new Python object types: form objects (representing an
entire form) and FORMS objects (representing one button, slider etc.).
Hopefully this isn't too confusing.

<P>
There are no `free objects' in the Python interface to FORMS, nor is
there an easy way to add object classes written in Python.  The FORMS
interface to GL event handling is available, though, so you can mix
FORMS with pure GL windows.

<P>
<strong>Please note:</strong> importing <tt class="module">fl</tt> implies a call to the GL
function <tt class="cfunction">foreground()</tt> and to the FORMS routine
<tt class="cfunction">fl_init()</tt>.

<P>

<p><br /></p><hr class='online-navigation' />
<div class='online-navigation'>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>

<UL CLASS="ChildLinks">
<LI><A href="node807.html">20.4.1 Functions Defined in Module <tt class="module">fl</tt></a>
<LI><A href="form-objects.html">20.4.2 Form Objects</a>
<LI><A href="forms-objects.html">20.4.3 FORMS Objects</a>
</ul>
<!--End of Table of Child-Links-->
</div>

<DIV CLASS="navigation">
<div class='online-navigation'>
<p></p><hr />
<table align="center" width="100%" cellpadding="0" cellspacing="2">
<tr>
<td class='online-navigation'><a rel="prev" title="20.3.2 Parser Objects"
  href="cd-parser-objects.html"><img src='../icons/previous.png'
  border='0' height='32'  alt='Previous Page' width='32' /></A></td>
<td class='online-navigation'><a rel="parent" title="20. SGI IRIX Specific"
  href="sgi.html"><img src='../icons/up.png'
  border='0' height='32'  alt='Up One Level' width='32' /></A></td>
<td class='online-navigation'><a rel="next" title="20.4.1 Functions Defined in"
  href="node807.html"><img src='../icons/next.png'
  border='0' height='32'  alt='Next Page' width='32' /></A></td>
<td align="center" width="100%">Python Library Reference</td>
<td class='online-navigation'><a rel="contents" title="Table of Contents"
  href="contents.html"><img src='../icons/contents.png'
  border='0' height='32'  alt='Contents' width='32' /></A></td>
<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
  border='0' height='32'  alt='Module Index' width='32' /></a></td>
<td class='online-navigation'><a rel="index" title="Index"
  href="genindex.html"><img src='../icons/index.png'
  border='0' height='32'  alt='Index' width='32' /></A></td>
</tr></table>
<div class='online-navigation'>
<b class="navlabel">Previous:</b>
<a class="sectref" rel="prev" href="cd-parser-objects.html">20.3.2 Parser Objects</A>
<b class="navlabel">Up:</b>
<a class="sectref" rel="parent" href="sgi.html">20. SGI IRIX Specific</A>
<b class="navlabel">Next:</b>
<a class="sectref" rel="next" href="node807.html">20.4.1 Functions Defined in</A>
</div>
</div>
<hr />
<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
</DIV>
<!--End of Navigation Panel-->
<ADDRESS>
See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
</ADDRESS>
</BODY>
</HTML>
Commit	Line	Data
920dae64 AT	1	<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
	2	<html>
	3	<head>
	4	<link rel="STYLESHEET" href="lib.css" type='text/css' />
	5	<link rel="SHORTCUT ICON" href="../icons/pyfav.png" type="image/png" />
	6	<link rel='start' href='../index.html' title='Python Documentation Index' />
	7	<link rel="first" href="lib.html" title='Python Library Reference' />
	8	<link rel='contents' href='contents.html' title="Contents" />
	9	<link rel='index' href='genindex.html' title='Index' />
	10	<link rel='last' href='about.html' title='About this document...' />
	11	<link rel='help' href='about.html' title='About this document...' />
	12	<link rel="next" href="module-fl-constants.html" />
	13	<link rel="prev" href="module-cd.html" />
	14	<link rel="parent" href="sgi.html" />
	15	<link rel="next" href="node807.html" />
	16	<meta name='aesop' content='information' />
	17	<title>20.4 fl -- FORMS library for graphical user interfaces</title>
	18	</head>
	19	<body>
	20	<DIV CLASS="navigation">
	21	<div id='top-navigation-panel' xml:id='top-navigation-panel'>
	22	<table align="center" width="100%" cellpadding="0" cellspacing="2">
	23	<tr>
	24	<td class='online-navigation'><a rel="prev" title="20.3.2 Parser Objects"
	25	href="cd-parser-objects.html"><img src='../icons/previous.png'
	26	border='0' height='32' alt='Previous Page' width='32' /></A></td>
	27	<td class='online-navigation'><a rel="parent" title="20. SGI IRIX Specific"
	28	href="sgi.html"><img src='../icons/up.png'
	29	border='0' height='32' alt='Up One Level' width='32' /></A></td>
	30	<td class='online-navigation'><a rel="next" title="20.4.1 Functions Defined in"
	31	href="node807.html"><img src='../icons/next.png'
	32	border='0' height='32' alt='Next Page' width='32' /></A></td>
	33	<td align="center" width="100%">Python Library Reference</td>
	34	<td class='online-navigation'><a rel="contents" title="Table of Contents"
	35	href="contents.html"><img src='../icons/contents.png'
	36	border='0' height='32' alt='Contents' width='32' /></A></td>
	37	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
	38	border='0' height='32' alt='Module Index' width='32' /></a></td>
	39	<td class='online-navigation'><a rel="index" title="Index"
	40	href="genindex.html"><img src='../icons/index.png'
	41	border='0' height='32' alt='Index' width='32' /></A></td>
	42	</tr></table>
	43	<div class='online-navigation'>
	44	<b class="navlabel">Previous:</b>
	45	<a class="sectref" rel="prev" href="cd-parser-objects.html">20.3.2 Parser Objects</A>
	46	<b class="navlabel">Up:</b>
	47	<a class="sectref" rel="parent" href="sgi.html">20. SGI IRIX Specific</A>
	48	<b class="navlabel">Next:</b>
	49	<a class="sectref" rel="next" href="node807.html">20.4.1 Functions Defined in</A>
	50	</div>
	51	<hr /></div>
	52	</DIV>
	53	<!--End of Navigation Panel-->
	54
	55	<H1><A NAME="SECTION0022400000000000000000">
	56	20.4 <tt class="module">fl</tt> --
	57	FORMS library for graphical user interfaces</A>
	58	</H1>
	59
	60	<P>
	61	<A NAME="module-fl"></A>
	62	<p class="availability">Availability: <span
	63	class="platform">IRIX</span>.</p>
	64
65	<P>
66	This module provides an interface to the FORMS Library<a id='l2h-5112' xml:id='l2h-5112'></a> by Mark Overmars<a id='l2h-5113' xml:id='l2h-5113'></a>. The source for the
67	library can be retrieved by anonymous ftp from host
68	"<tt class="samp">ftp.cs.ruu.nl</tt>", directory <span class="file">SGI/FORMS</span>. It was last tested
69	with version 2.0b.
70
71	<P>
72	Most functions are literal translations of their C equivalents,
73	dropping the initial "<tt class="samp">fl_</tt>" from their name. Constants used by
74	the library are defined in module <tt class="module"><a href="module-fl-constants.html">FL</a></tt>
75	described below.
76
77	<P>
78	The creation of objects is a little different in Python than in C:
79	instead of the `current form' maintained by the library to which new
80	FORMS objects are added, all functions that add a FORMS object to a
81	form are methods of the Python object representing the form.
82	Consequently, there are no Python equivalents for the C functions
83	<tt class="cfunction">fl_addto_form()</tt> and <tt class="cfunction">fl_end_form()</tt>, and the
84	equivalent of <tt class="cfunction">fl_bgn_form()</tt> is called
85	<tt class="function">fl.make_form()</tt>.
86
87	<P>
88	Watch out for the somewhat confusing terminology: FORMS uses the word
89	<i class="dfn">object</i> for the buttons, sliders etc. that you can place in a form.
90	In Python, `object' means any value. The Python interface to FORMS
91	introduces two new Python object types: form objects (representing an
92	entire form) and FORMS objects (representing one button, slider etc.).
93	Hopefully this isn't too confusing.
94
95	<P>
96	There are no `free objects' in the Python interface to FORMS, nor is
97	there an easy way to add object classes written in Python. The FORMS
98	interface to GL event handling is available, though, so you can mix
99	FORMS with pure GL windows.
100
101	<P>
102	<strong>Please note:</strong> importing <tt class="module">fl</tt> implies a call to the GL
103	function <tt class="cfunction">foreground()</tt> and to the FORMS routine
104	<tt class="cfunction">fl_init()</tt>.
105
106	<P>
107
108	<p><br /></p><hr class='online-navigation' />
109	<div class='online-navigation'>
110	<!--Table of Child-Links-->
111	<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></a>
112
113	<UL CLASS="ChildLinks">
114	<LI><A href="node807.html">20.4.1 Functions Defined in Module <tt class="module">fl</tt></a>
115	<LI><A href="form-objects.html">20.4.2 Form Objects</a>
116	<LI><A href="forms-objects.html">20.4.3 FORMS Objects</a>
117	</ul>
118	<!--End of Table of Child-Links-->
119	</div>
120
121	<DIV CLASS="navigation">
122	<div class='online-navigation'>
123	<p></p><hr />
124	<table align="center" width="100%" cellpadding="0" cellspacing="2">
125	<tr>
126	<td class='online-navigation'><a rel="prev" title="20.3.2 Parser Objects"
127	href="cd-parser-objects.html"><img src='../icons/previous.png'
128	border='0' height='32' alt='Previous Page' width='32' /></A></td>
129	<td class='online-navigation'><a rel="parent" title="20. SGI IRIX Specific"
130	href="sgi.html"><img src='../icons/up.png'
131	border='0' height='32' alt='Up One Level' width='32' /></A></td>
132	<td class='online-navigation'><a rel="next" title="20.4.1 Functions Defined in"
133	href="node807.html"><img src='../icons/next.png'
134	border='0' height='32' alt='Next Page' width='32' /></A></td>
135	<td align="center" width="100%">Python Library Reference</td>
136	<td class='online-navigation'><a rel="contents" title="Table of Contents"
137	href="contents.html"><img src='../icons/contents.png'
138	border='0' height='32' alt='Contents' width='32' /></A></td>
139	<td class='online-navigation'><a href="modindex.html" title="Module Index"><img src='../icons/modules.png'
140	border='0' height='32' alt='Module Index' width='32' /></a></td>
141	<td class='online-navigation'><a rel="index" title="Index"
142	href="genindex.html"><img src='../icons/index.png'
143	border='0' height='32' alt='Index' width='32' /></A></td>
144	</tr></table>
145	<div class='online-navigation'>
146	<b class="navlabel">Previous:</b>
147	<a class="sectref" rel="prev" href="cd-parser-objects.html">20.3.2 Parser Objects</A>
148	<b class="navlabel">Up:</b>
149	<a class="sectref" rel="parent" href="sgi.html">20. SGI IRIX Specific</A>
150	<b class="navlabel">Next:</b>
151	<a class="sectref" rel="next" href="node807.html">20.4.1 Functions Defined in</A>
152	</div>
153	</div>
154	<hr />
155	<span class="release-info">Release 2.4.2, documentation updated on 28 September 2005.</span>
156	</DIV>
157	<!--End of Navigation Panel-->
158	<ADDRESS>
159	See <i><a href="about.html">About this document...</a></i> for information on suggesting changes.
160	</ADDRESS>
161	</BODY>
162	</HTML>