gqlx

a gui front end uqlx

Contents

Overview

gqlx provides facilities for uqlx users:

Usage

gqlx requires the gtk (Gimp Tool Kit) and vdk (Visual Development Kit) libraries. These libraries are freely available for all Unix platforms.

Of course, you require a copy of Richard Zidlicky's (rdzidlic@cip.informatik.uni-erlangen.de) uqlx package, which is available here. It is necessary to apply a small set of patches to allow gqlx to swallow the uqlx window. gqlx is invocated as 'gqlx'; it takes no options.

On startup, gqlx displays the following window. Boring isn't it?

Initial picture of gulqx

However, it can be configured to automatically run uqlx in your desired resolution.

Another picture of gulqx

In this quintessent state, gqlx has read the standard .uqlxrc file. It therefore knows about screen sizes defined by SIZE_X, SIZE_XX, SIZE_XX. ROMs offered are those found by searching the ROMDIR directory for files of exactly 48Kb.

The initial RAM is taken from RAMTOP. If the ROM does not start 'min' (case independent), then the screen is constrained to 512x256 and the maximum RAM is 4096Kb.

At this stage, you could go to the Run menu and start uqlx.

Menus

Files

The Files menu contains the following options.

The menu options do the following:

Default

(Re)loads the users default settings, as defined by $UQLX_CFG or ~/.uqlxrc.

Load

Displays a file request dialog. If the user selects a file, gqlx will attempt to load the settings from that file.

Save

Saves the current settings to the last loaded file name (default file if none implicitly loaded).

Save As

Displays a file request dialog. If the user selects a file, gqlx will attempt to save the current settings from to file.

Properties

Opens the properties dialogs. These are described below.

Background

Puts gqlx into the background. The program is detached from its controlling terminal.

Quit

Terminates the gqlx program.

Edit

The Files menu contains the following options.

The menu options do the following:

Paste

Pastes the X paste clipboard into the current QDOS keyboard queue.

Capture

Opens a file requestor dialog for a file name to save a screen dump of the current QDOS screen. Requires a program called import on your path. import is part of the ImageMagick package.

CPU Hog

ROM Break

Switch Key

Perform the appropriate uqlx action, see the uqlx manual for more details. The toggled state is indocated by a blue dot to the right of the menu item.

Force Redraw

Requests uqlx to redraw the screen.

Run

The Files menu contains the following options.

The menu options do the following:

512x256

Size 1

Size 2

Size 3

Defines the display size for the next Run command. Note that the display will not change until the next Run or Reboot command is issued. Note also that if the display is resized smaller, than the window must be manually resized after the subsequent Run/Reboot. The Size n options refer to the size options in the .uqlxrc file, which can be changed by the properties page.

Run

Runs uqlx in the selected screen size and setting defined by the current properties.

Stop

Stops the current uqlx, returning to a blank screen.

Reboot

Stops the current uqlx, and starts a new one, withe selected screen size and setting defined by the current properties. Note that Run and Stop/Reboot will be greyed out as appropriate.

uqlx Messages

Displays uqlx console messages in a window.

AutoRun

If AutoRun is set (denoted by the blue dot after the option), then a uqlx session will be started with the current default size and settings when gqlx is run.

Edit

The help menu contains a single option, 'About', which display copyright information.

Properties Editor

Rom Tab
The properties editor is invoked from the Files/Properties menu option and displays a tabbed dialog box. The ROM tab offers the following:

The ROM directory item defined the directory where the system and expansion ROMs may be found. You can enter the directory name directly, or press the browse button. The ROM item provides a combo box listing the ROMs available to uqlx. These ROMs are found by searching the ROM directory for files of exactly 48Kb, for example:

The Memory item provides a spin button to change the RAM available to uqlx.

The Flags item provides six check boxes to change some flags defining uqlx behaviour, and a text field to change the switch key.

The Expansion ROMS item provides a list of expansion ROMS available to uqlx. Holding down the Left Mouse Button displays a popup menu.

The add and edit items invoke the following dialog.

The Add item is enabled by holding down LMB on a blank line.

Enter the ROM name and address; a rom image may be choosen via a file requestor by clicking 'Browse...'. gqlx will perform some sanity checks on the file size (must be 16Kb) and the address chosen.

File Systems Tab
The FileSystems tab offers a dialog to edit the file systems available to uqlx.

Holding down the Left Mouse Button displays a popup menu.

The add and edit items invoke the following dialog.

Enter the QDOS name, Unix name and flags; a Unix directory may be choosen via a file requestor by clicking 'Browse...'. Flags are choosen from the following combo box.

gqlx will perform some sanity checks on the selected values.

The Add item is enabled by holding down LMB on a blank line.

Devices Tab
The Devices tab offers a dialog to invoke an editor for character devices and screen sizes.

Clicking on a line will invoke a dialog editor, similar to the ROM editor above.

Global Changes
The OK and Cancel buttons in displayed at the botton of each tabbed dialog page will exit the configuration editor. If you click OK, then the current settings are updated and will be used for any subsequent Run or Reboot or Save / Save As command.

Author & Licence

gqlx is distributed under the GPL "GNU Public Licence". For your convenience, a copy of this is provided as the file 'COPYING'.

gqlx is (c) Jonathan R Hudson (jrhudson@bigfoot.com). You can always find the latest version on his home page.