Next: Form object
Prev: fl
Up: fl
Top: Top
9.3.1. Functions defined in module fl
Module fl
defines the following functions. For more information
about what they do, see the description of the equivalent C function
in the FORMS documentation:
- make_form (type, width, height) -- function of module fl
-
Create a form with given type, width and height. This returns a
form object, whose methods are described below.
- do_forms () -- function of module fl
-
The standard FORMS main loop. Returns a Python object representing
the FORMS object needing interaction, or the special value
FL.EVENT
.
- check_forms () -- function of module fl
-
Check for FORMS events. Returns what
do_forms
above returns,
or None
if there is no event that immediately needs
interaction.
- set_event_call_back (function) -- function of module fl
-
Set the event callback function.
- set_graphics_mode (rgbmode, doublebuffering) -- function of module fl
-
Set the graphics modes.
- get_rgbmode () -- function of module fl
-
Return the current rgb mode. This is the value of the C global
variable
fl_rgbmode
.
- show_message (str1, str2, str3) -- function of module fl
-
Show a dialog box with a three-line message and an OK button.
- show_question (str1, str2, str3) -- function of module fl
-
Show a dialog box with a three-line message and YES and NO buttons.
It returns
1
if the user pressed YES, 0
if NO.
- show_choice (str1, str2, str3, but1, but2, but3) -- function of module fl
-
Show a dialog box with a three-line message and up to three buttons.
It returns the number of the button clicked by the user
(
1
, 2
or 3
).
The but2 and but3 arguments are optional.
- show_input (prompt, default) -- function of module fl
-
Show a dialog box with a one-line prompt message and text field in
which the user can enter a string. The second argument is the default
input string. It returns the string value as edited by the user.
- show_file_selector (message, directory, pattern, default) -- function of module fl
-
Show a dialog box inm which the user can select a file. It returns
the absolute filename selected by the user, or
None
if the user
presses Cancel.
- get_directory () -- function of module fl
-
- get_pattern () -- function of module fl
-
- get_filename () -- function of module fl
-
These functions return the directory, pattern and filename (the tail
part only) selected by the user in the last
show_file_selector
call.
- qdevice (dev) -- function of module fl
-
- unqdevice (dev) -- function of module fl
-
- isqueued (dev) -- function of module fl
-
- qtest () -- function of module fl
-
- qread () -- function of module fl
-
- qreset () -- function of module fl
-
- qenter (dev, val) -- function of module fl
-
- get_mouse () -- function of module fl
-
- tie (button, valuator1, valuator2) -- function of module fl
-
These functions are the FORMS interfaces to the corresponding GL
functions. Use these if you want to handle some GL events yourself
when using
fl.do_events
. When a GL event is detected that
FORMS cannot handle, fl.do_forms()
returns the special value
FL.EVENT
and you should call fl.qread()
to read the
event from the queue. Don't use the equivalent GL functions!
- color () -- function of module fl
-
- mapcolor () -- function of module fl
-
- getmcolor () -- function of module fl
-
See the description in the FORMS documentation of
fl_color
,
fl_mapcolor
and fl_getmcolor
.