XFHARDCOPY(1)

NAME
xfhardcopy - interactive Tk hardcopy program

SYNOPSIS
xfhardcopy [xfhardcopy options]

xfhardcopy options:

    [-xfBindPath <filename>] [-xfColorFile <filename>] [-xfCursorFile <filename>] [-xfFontFile <filename>] [-xfLoading] [-xfLoadPath <pathname>] [-xfModelColor] [-xfModelMono] [-xfNoLoading] [-xfStartup <filename>]

DESCRIPTION

XFhardcopy allows to interactively select Tk applications and path names inside these applications, for dumping to a file. The program uses different external programs to implement the hardcopy commands (xgrabsc 2.1, xwd), and it provides access to the Tk postscript command for canvas widgets (this command is new in Tk 3.0). If the hardcopy commands that come with the distribution do not work or if there exist more appropriate programs, the hardcopy commands can be adapted by the user. This program is part of the XF distribution, and is used to make hardcopies from the program that is built with XF.

The Tk application which should be hardcopied can be selected from the upper left list, and a widget path inside of this application from the upper right list. To make a hardcopy of the selected widget tree (application), one of the hardcopy commands from the bottom list is selected with a double click. By default the hardcopy is written into the current directory under the name xfHardCopy. To specify a different output file name, the hardcopy is made with the menu item named (File | Hardcopy to...).

HARDCOPY COMMANDS
To modify the currently selected hardcopy command the menu item (File | Modify hardcopy command) is activated. The following parameters can occur in the hardcopy commands and are substituted when the hardcopy command is activated:

$height
    The height of the selected widget

$id The X window id of the selected widget

$outputFile
    The name of the specified output file

$rootx
    The absolute x position of the widget

$rooty
    The absolute y position of the widget

$widget
    The Tk widget name of the selected widget

$width
    The width of the selected widget

$x  The relative x position of the widget

$y  The relative y position of the widget

OPTIONS

The following options can be controlled from the command line.

-xfBindFile filename
    This option specifies a file containing class bindings that implement a default behavior of all widgets.

-xfColorFile filename
    This option specifies a file containing a list of all known colors. This file is automatically created when XF is installed, so please set this variable to the location of the Colors file of the installed XF (usually in the directory ./lib inside the XF distribution).

-xfCursorFile filename
    This option specifies a file containing a list of all known cursors. This file is automatically created when XF is installed, so please set this variable to the location of the Cursors file of the installed XF (usually in the directory ./lib inside the XF distribution).

-xfFontFile filename
    This option specifies a file containing a list of all known fonts. This file is automatically created when XF is installed, so please set this variable to the location of the Fonts file of the installed XF (usually in the directory ./lib inside the XF distribution).

-xfLoading
    This option specifies that the program reports the source filenames that it loads. This is useful when the program automatically accesses archives in the development phase.

-xfLoadPath pathname
    This option specifies a list of pathnames (separated by ":") where the Tcl source files can be found. In order to find the Tcl source files they must be stored in one of these directories.

-xfModelColor
    This option starts the application in color mode.

-xfModelMono
    This option starts the application in monochrome mode.

-xfNoLoading
    This option specifies that the program does not report the source filenames that it loads.

-xfStartup filename
    This option specifies a file containing additional Tcl/Tk code that is loaded at startup.

ENVIRONMENT

DISPLAY
    The default display to be used.

XF_LOAD_PATH
    This variable specifies a list of pathnames (separated by ":") where the Tcl source files can be found. In order to find the Tcl source files they must be stored in one of these directories.

BUGS

•   Surely there are many bugs.

SEE ALSO

Tcl(3), Tk-manuals(3), XF-documentation

AUTHOR

Sven Delmas
TU Berlin, Germany
garfield@cs.tu-berlin.de