Gallery Utility

Quick contents

Overview

Gallery is a utility for managing files for functions, contours, surfaces and images.

Gallery

The program is invoked as:

gallery (filename1 filename2 filename3 ...)

A window is displayed as in Figure 1, showing a preview of each file supplied as an argument on the command line.

A gallery screen

Figure 1 - A gallery screen

Supported file types

The following file types are supported.

.func
function file, versions 1.0 and 1.1
.fset
function set file (currently unsupported by cpfg on Linux)
.con
contour file, versions 1.0 and 1.1
.cset
contour set file (currently unsupported by cpfg on Linux)
.s
bezier surface file
.sset
bezier surface set file (currently unsupported by cpfg and lpfg)
.bmp .gif .jpeg .mng .pbm .pgm .png .ppm .xbm .xpm
image file (support dependant on the Qt image fileters and may vary by version and installation)
.iset
image file set

Managing items

Double-clicking an item will open it into its repsective VLAB editor (funcedit, cuspy or bezieredit as appropriate) or xv for image files. After editing, the preview may be updated using the Refresh entry in the context menu.

The order of the items is the same as they appear on the command-line. The order can be changed by dragging items to the left or right.

Items can be added to the set with the Create New Item entry in the context menu. If the supplied filename referes to an existing file, the gallery will add that file as a new item. If the filename refers to a file that does not exist, a new file of the selected type will be created and added as an item. Note that newly created files need to be added to the specification file for the object program to save it to oofs.

An item may be removed from the gallery using the Remove Item entry in the context menu. Removal does not delete the file.

Managing sets

Items from function, contour and surface sets are opened as seperate items in the gallery. Since the editors are not comaptible with the set formats, saving the sets must be done after editing of an item through the context menu.

A new set can be created from all the open items of the same type. To create a new set, select the Save As Set entry from the context menu.

Configuration

The gallery program may by configured by options in the 'gallery' file in the VLAB configuration directory (VLABCONFIGDIR).

Allowed configuration entries

VSize
The vertical size of the gallery as an integer percentage of the vertical screen size.
HSize
The horizontal size of the gallery as an integer percentage of the horizontal screen size.
DragColor
The colour used for the background of items that are being dragged as three component values in the range 0 to 255.
ItemWidth
The width of items in pixels.

Credits

Colin Smith - gallery - Implementation and documentation



Last updated August 27, 2001 by Colin Smith