Content-type: text/html Man page of fltkwish

fltkwish

Section: User Commands (1)
Updated: Tue Nov 18 10:43:15 EST 2008
Index Return to Main Contents

NAME

fltkwish - Tcl/Fltk Windowing Shell Version 1.0.101-1

SYNOPSIS

fltkwish [options]file

DESCRIPTION

The fltkwish program is a version of the Tcl interpreter that is used to invoke the Tcl/Fltk command set extention to the Tcl scripting language. For information on the Tcl application development environment see http://www.tcl.tk.

The Tcl/Fltk extension adds a set of commands to the standard Tcl command shell that allow the development of GUI applications that make use of the widget set provided by the Fast Light Tool Kit (FLTK). The FLTK widget set is implemented in a widely distributed cross platform highly portable library. FLTK widgets are always drawn native on the target platform, and as such, provide a consistent look and feel on different platforms. Perfromance is somewhat better than alternative approached that make use of emulation layers to implement GUI portability. For more information of FLTK see http://www.fltk.org.

Invoking fltkwish starts an instance of the standard Tcl interpreter. At the command prompt, any Tcl command can be issued, or any of the available Tcl/Fltk commands may be used. Typically, applications will be implemented in script files using the combined Tcl/Fltk command set. The script files are then passed to the interpreter in the usual way by making the script file executable and invoking the fltkwish interpreter from within the script. For example:

: #!/bin/sh ; # \; exec fltkwish "$0" ${1+"$@"}

within a shell script will invoke the interpreter and pass any other lines in the script file to the interpreter. ALternately, scripts can be invoked using a command such as:

: fltkwish file

where file is the name of the file with the Tcl/Fltk commands to be executed.

OPTIONS

The fltkwish application accepts platform specific options that relate to the host GUI environment if such options exist. Under X Windows, for instance, the fltkwish command line will accept X Toolkit options. Documentation relating to these options is available in the reference material for the relevant GUI environment. Under other environments, such as Windows or Nano-X, some or all of these options may not be useful.

The fltkwish application supports the following FLTK related options:

-display: This option defines the display to use under X Windows implementations. The default value is :0.0. This option is X specific.
-title: This option can be used to specify the title of the main root window of a Tcl/Fltk application. The default name is fltkwish-1.0. Only the first top level window will respond the this option. If an application has more than one top level window, the Wm command can be used to manage the window title.
-fg: This option can be used to set the default foreground text color. By default, the default foreeground text color is black.
-bg: This option can be used to set the default window background color. By default, this color is gray.
-geometry: This option can be used to set the default geometry of the root window for an application. This option is typically of little use as application normally will size their own windows to suit their needs. However, the usual geometry format of:
: "X,Y,WxH"
: may be used to specify a default geometry.
-bg2: This option sets the secondary background color. It has some use in several widgets that need more than 1 background color. The default is gray.
-name: Sets the application name
-iconic: Makes the root window iconic
-dnd: Activates drag and drop functionality. Dnd support is not currently implemented for Tcl/Fltk widgets.
-kbd: Specifies keyboard support (Default)
-nodnd: Suppresses drag and drop functionality
-nokbd: Application has no keyboard support
-notooltips: Suppresses display of tool tips
-tooltips: Activates tool tip display (default)
-scheme: Specifies a tool kit related scheme. FLTK currently provides 2 schemes, normal, the default, and plastic. The Tcl/Fltk package provides many other schemes that can be loaded via the Scheme command.

In addition to the above options, the Tcl/Fltk extension itself provides the following options:

-namespace: This option can be used to specify a Tcl namespace name that will be prepended to all of the extension commands. By default, there is no namespace name prepended, and Tcl/Fltk commands are invoked directly. If the -namespace option is used, the all commands must be invoked using references of the form:
: name::command
: where name is the namespace name and command is the extension command. See the Tcl reference documentation on namespace for more information on this feature.
-rootwindow: This option is used to specify a root window identifier which is used to sub-class the top level windows created by the Tcl/Fltk extension. This feature is used with certain applications which embed the windows for applications within another application. The plugger extension to popular Linux/UNIX web browsers is one example. This feature can also be used to embed Tcl/Fltk windows in Tk wrappers, allowing the possibility of making use of Tcl/Fltk widgets within Tk applications.
-version: This option prints the version string for the fltkwish application and then exits.

FILES

The following files, installed in the Fltk-1.0 library directory, contain additional information:

: fltk_version.sh
: README
: LICENSE

Extensive documentation on the Tcl/Fltk command set is available for download in the form of a PDF file. Consult the download site for this distribution for this documentation or look at http://pages.infinit.net/cclients/downloads.htm

The scripts sub-directory in the library sub-directory contains a number of demonstration, test harness and application scripts that can be used to study how the development of applications can be done using this package.

ENVIRONMENT

For non-standard installations, the TCLLIBPATH environment variable can be used to specify the path to the extension package. It should be set before fltkwish is invoked.

AUTHOR

Iain B. Findleton mailto:ifindleton@videotron.ca

This document was created by man2html, using the manual pages.
Time: 15:43:15 GMT, November 18, 2008