XFPIXMAP(1)

NAME
xfpixmap - a small icon editor for Xpm 3 files

SYNOPSIS
xfpixmap [xfpixmap options]

xfpixmap options:

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

DESCRIPTION

Xfpixmap allows drawing pixmaps based upon the Xpm 3 format. To use the program, the wish that is used must contain the TkPixmap patch. This patch implements the pinfo command. The functionality of xfpixmap is restricted to a basic functionality, and the performance is not very good especially for big pictures (big == >40x40). This program is part of the XF distribution, and is used to manipulate pixmaps.

To set a color, the left mouse button is clicked at the pixel cell. The middle mouse button is used to set the transparent (background) color, and the right mouse button is used to set the drawing color to the color of the pixel cell under the mouse pointer. The current drawing color can be selected by pressing at the color button in the color array.

To change the color value for a color in the palette, this color is made the active color. Then the button that contains the name of the current color right over the palette is pressed. The new color can now be selected in the color selection box. By pressing at the button that contains the current transparent color, a new transparent color is selected.

The size of the picture can be changed with the scales at the left side. When a new width, height and pixel cell size have been selected, the button (Set raster) is pressed. The array of nine arrows is used to manipulate the drawing space in various ways. The buttons (Fill) and (Clear) do what they are supposed to do.

OPTIONS

The following options can be controlled from the command line.

-size <widthxheight>

    This option allows you to specify the size of the pixmap.

-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.

filename

    The named file is loaded into the draw space. This may take a while, especially for big pictures.

ENVIRONMENT

DISPLAY
    The default display to be used.

XF_COLOR_FILE
    This variable 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).

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

•   Currently you can only define the color values for the pixmap. You cannot specify the monochrome and grayscale mapping.

•   Be careful with the transparent color. As this is really a color for xfpixmap you cannot use this color as drawing color.

•   For big pictures (>40x40) the loading and creating does take a long time. Please do not forget that this program is only a 5 day hack :-).

SEE ALSO

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

AUTHOR

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