sam-t2/devtools/v8plus/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>