xbmbrowser1x

Editing the displayed current directory string on the main application window.

Selecting a directory from a popup menu, by pressing a mouse button over the displayed current directory string. This is the recommended method when you are moving around a directory tree that you know very well.

Clicking with the first (left-most) mouse button on a directory file symbol.

Or even through one of the user configurable popup menu actions (See below). This is usfull to define a specific directory that you wish to change to regularly.

Display (or not) the filenames under the icon or symbols shown.

Resource: XbmBrowser.label_all: False

Only display (or not) the actual icons (bitmaps and pixmaps) found in the current directory. In other words do not display and file symbols for directories or other files found in the current directory. This option is provided to allow the user to turn of the display of a large number of file symbols that can appear at times, and return xbmbrowser back to the `older' version style.

Resource: XbmBrowser.icons_only: False

Display (or not) directory symbols for any sub-directories found. The ".." directory symbol will also be removed.

Resource: XbmBrowser.show_dir: True

Display (or not) any pixmaps which failed to load properly. This Pixmaps usally couldn't be displayed as they were unable to allocate enough colors on the current display. To display these, try quiting some other applications, removing any root background image you may have on your display, or even delete or move other pixmaps in the current directory elsewhere.

Resource: XbmBrowser.show_xpmbad: True

Display (or not) the other files found in the current directory. As part of the attempt to load these files as icons for display, xbmbrowser has determined weather or not these files are either binary, plain text, or some other special file type. It will use an appropiate file symbol to show the user its findings. NOTE: Picture Image formats such as gif and jpeg will appear as binary files.

Resource: XbmBrowser.show_other: False

Include in the display (or not) the UNIX hidden (or `dot') files found in the directory. Note that this only allows these hidden files to be shown, other options (above) may or may not permit these files to be visible. EG: hidden directories will not be visible in the display if either hidden files or directories are not visible.

Resource: XbmBrowser.show_hidden: False

Controls if the non-icon file symbols are to be displayed in a shaped window or as a boxed symbol. Note that by default this is initially set equal to the value of the XbmBrowser.solid_bgnd: (see -solid commandline option above) unless overridden by your own resource setting (IE: True on color displays False on monocrome).

Label only the file symbols. The XbmBrowser.label_all: resource (see -(no)label commandline option above) can override this value if it is True.

The colors to display file symbols and their labels on the display.

The colors to display bitmap icons and their labels with.

This is the color used for the transparent (or `None') pixmap color when not using a solid background color (and shaped windows). It is also the color of the pixmaps label.

The the solid background color to use.

This is a very light color to use with the foreground color (usally black) when creating the background stipple pattern. This color is usally not used as the stipple pattern is normall used on monocrome display only.

ASIDE: The forground color of the stipple pattern currently is set to whatever the border color of the iconbox widget is set to. If you don't want it to be black you can change it with the resource XbmBrowserconbox.borderColor. In a future release you may be able to set this color and maybe the stripple pattern used, just like the other resources above.

This resource will cause xbmbrowser to place any and all Labels above the images displayed instead of below as is normal. This is not strictly a xbmbrowser resource but one for the unusal Widget it uses to handle the display of the Bitmaps and Pixmaps.

A comment line which is completely ignored. Comments can appear at the end of any (non-continued) line.

Add any new menu elements (see below) to this menu. Only specific menus are allowed and will be titled using the optional second argument. The menus, if defined, will be poped up when the appropriate mouse button is pressed on a displayed icon ot file symbol. If the menu is not defined the program will `beep' the user. The following are the menus which the user may define:-

Just insert a line into the menu at this point.

Insert a item into the current menu which will execute the sequence builtin functions (see below). As it is posible for a very long sequences to be required for some menu items, the menu lines can be continued onto the next line by `backslashing' (\) the return character at the end of the line.

Each function may or may-not require some quoted string arguments, with the quote being either single or double, allowing the other quote to be used freely with the argument.

Each argument can contain any number of macro substitutions which consist of a % character followed by a single letter. A percent character can be substituted with %%.

Exit xbmbrowser. Need I say more?

Completely scan the current directory (Again). (See rescan() below)

Do a fast rescan of the current directory. Note that X pixmaps which failed to load will NOT be loaded by this command, to avoid slowing the rescan() in a directory of unloadable X pixmaps. This occurance is actually common on a directory of pixmaps which do not follow a standard color table.

To attempt to load these Pixmaps use either a full scan(), touch the failed pixmap when more colors are available, or convert that pixmap to a common color table. Alturnatively, display the pixmap in a secondary image viewer (converting it if nessary).

Change directory to the given directory. If the directory change succeeds xbmbrowser will automatically do a full scan() of the new directory. If this fails, no scan() will be performed.

Execute the given bourne shell command. Any output by the command executed will be to the standard output (or error) of xbmbrowser, usally the users terminal.

Ask the user to confirm action before continuing the next function. If the user presses ``cancal'' the current function sequence will be aborted.

Ask the user for some input, giving the user the "initial" string to start with. The result entered by the user will be returned in the substitution marco %i (see below). The ``cancal'' button will abort the current function sequence.

If the user pointer was NOT over an icon or symbol then abort the current sequence with a popup error. This function is not usful in anything but the "global" menu, as in the other menus an icon is either always or never selected.

The current directory of the browser. Note that a the directory seperator '/' have been pre-added to this substition macro.

The filename of the icon (or file) selected by the user.

The basename (suffix removed) of the current filename.

The suffix of the current filename EG: ".xbm"

The users input of the last input() function (see above).

The Users Home directory (do NOT use ~ in an argument for this). Note that a the directory seperator '/' have been pre-added to this substition macro.

The Initial Startup Directory. This is either the directory XbmBrowser was started in or was given to it as an command line argument.

Substitutes a percent character, just in case you really do need it.