4.0 THE "MyQL" MENUS

As the name implies, the MyQL system revolves around system settings
for your computers and personal settings, as well as facilities to fire
up file handling menus using the Q-Trans utilities for the directory
drives on your system.

At the time of writing, Launchpad's MyQL menu offers the following
menus:

Clock     - for setting the QL time and date
Display   - Set screen resolutions, colour depths, screen savers etc
Keyboard  - Set keyboard delay, repeat rate, change queue code etc
Launchpad - Set the Launchpad defaults
Mouse     - Set mouse acceleration and wake-up speed
Network   - Set QL network and Sernet defaults
System    - Set various system defaults (DATA_USE etc)
Users     - Add or remove users, change passwords etc

Plus file handler menus for the first 8 directory devices on your
system.

4.1 Clock

A simple menu for setting the time and date for the QL clock. The top
window shows the clock running, showing what date and time it's
currently set to. The 6 boxes underneath let you change the year,
month, day, hour, minutes or seconds. Just click on the box you wish to
change. The time is not altered until you actually click on the OK
button at the bottom. Should you decide you do not wish to alter the
settings at all, press the ESC key or Hit the [X] icon to abandon the
clock setting routine without actually altering the clock at all.

4.2 Display

This menu lets you select the display colour mode, screen saver
details, background colour and background image, although some of these
facilities can only be used on a version of SMSQ/E supporting the GD2
colour driver system. Note that each user can have their own settings.
If display size and/or colour depth are set here, they will override
the settings in the configuration block. For example, if the
configuration block is set to display 'As Large As Possible' but this
user has set 512x256 display, the Display menu settings will take
effect as soon as that user logs in. From version 0.91, it is possible
for a user to specify Do Not Set to keep things simple!

+---------------------------------------------------+
| [Move]              [ DISPLAY ]               [X] |
|                                                   |
| Colour mode         [4-colour (2-bit)    ]        |
| Screen saver        [Meltdown            ]        |
| Screen saver delay  [5   ] minute(s)              |
| Screen resolution   [640x480  ] pixels            |
| Background colour   [0        ]                   |
| Background image    [                    ]        |
|                                                   |
|                    [   OK    ]                    |
+---------------------------------------------------+


4.2.1 Colour Mode

Used to set the preferred colour depth on systems supporting multiple
colour depths. Displays a warning first about the possible dangers to
software inherent in changing colour depths "on the fly."

A standard QL system has just two colour modes, the familiar mode 4 and
mode 8 (4 and 8 colour modes). However, Launchpad itself will not run
in mode 8 on a standard QL, the most obvious reason being that it
cannot display CSIZE 0,0 text required by Launchpad.

More recent systems like Aurora, Q40, Q60, QXL and certain QL emulators
can utilitise what are called higher colour modes - they make use of
the GD2 Colour Driver system supplied in recent versions of SMSQ/E.

BITS           COLOURS             SYSTEMS SUPPORTING SUCH MODES
8-bit          256                 Aurora, QPC2
16-bit         65,536              QXL, Q40, Q60, QPC2
24-bit         16.7 million        None directly as yet

Hit the Colour Mode box to select the colour depth. Each Launchpad user
can specify their own preference. From the menu which appears, select
the preferred option. Once selected, your choice is written out to
system files and remembered for the next time you log into Launchpad.
If you do not want Launchpad to set any particular display mode, simply
select the Do Not Set option. Launchpad will then try to start up in
the existing computer display mode.

4.2.2 Screen Saver

Launchpad uses the LPSaver program supplied to provide its Screen Saver
utility. A screen saver is a program which detects when no mouse or
keyboard activity has occurred for a given time and in order to protect
against screen burn-in caused by non-moving pictures, it either totally
blanks the display or provides a moving graphical image of some kind to
protect the screen. Strictly speaking, many modern monitors do not
really need this level of protection against screen burn-in, but screen
savers are still popular as a means of amusement or distraction, or
simply to prevent text on a screen being viewed by the casual observer.

Full instructions for the LPsaver program and how to write your own
screen saver modules for use with it are given in the LPsaver manual.

Hit the Screen Saver box to select the type from the menu which
appears.

Hit the Screen Saver Delay box to set the number of minutes of
inactivity which has to occur before the screen saver cuts in.

Once a screen saver module has started, simply press a key on the
keyboard or move the mouse to stop the screen saver.

4.2.3 Screen Resolution

To change screen resolution, simply hit the Screen Resolution box, and
select a resolution from the menu which appears. A selection of screen
sizes is shown, from the standard 512x256 pixel QL screeen resolution
up to 1024x768 pixel (XGA) resolution. If the particular resolution
required isn't shown, hit the OTHER command. When the next menu
appears, type in the horizontal and vertical resolution (in pixels)
into the two boxes shown, then click on OK. There is also a Do Not Set
option if you do not require Launchpad to change display resolution.

4.2.4 Background Colour

Background colour sets the screen background colour. It may only be
used on versions of SMSQ/E that support background colours. Hit the
Background Colour box and a colour selection menu appears.

+-----------------------------------------+
| [Move]     [BACKGROUND COLOUR]      [X] |
| [ Black ] [ Blue  ] [  Red  ] [Magenta] |
| [ Green ] [ Cyan  ] [Yellow ] [ White ] |
|                                         |
|          RED       GREEN       BLUE     |
|        +-----+    +-----+    +-----+    |
| 255    |     |    |     |    |     |    |
|        |     |    |     |    |     |    |
|        |     |    |     |    |     |    |
|  0     |     |    |     |    |     |    |
|        +-----+    +-----+    +-----+    |
|          v ^        v ^        v ^      |
|                                         |
|  Colour [     ]                         |
| DEC 1.677696E7               [  OK  ]   |
| HEX 00FFFF00                            |
+-----------------------------------------+

Background colours are generally specified as 24-bit colour values, but
for the purposes of Launchpad it is easier to think of the colour as
being made up of various levels of red, green and blue. By adjusting
the values of those three colours in the boxes shown, you can come up
with your preferred shade of colour to use as a screen background. The
mixed colour made up of the three primaries is shown in the COLOUR box
below, along with the decimal and hexadecimal colour values that would
be used in a BGCOLOUR_24 command in SBASIC. When you have found the
colour you require, click the OK button to implement the colour. If
you'd like to use one of the 8 familar colours, black, blue, red,
magenta, green, cyan, yellow or white, click on the colour names at the
top. If you don't want a background colour, 0 will ensure the screen is
the normal QL black.

4.2.5 Background Image

If you'd like to apply a background image - a picture which is used as
a backing, sometimes called Wallpaper on other computer systems - click
on the Background Image command in the Display menu to bring up the
file selection menu. Select a screen or PIC file of appropriate
dimensions and saved in the colour mode you prefer to use with
Launchpad. Ensure that the picture is a QL screen or a pointer
environment PIC file. The same constraints apply as for the BGIMAGE
command in SBASIC.

4.3 Keyboard

This menu lets you set the keyboard auto repeat delay, frequency,
change queue code and for SMSQ/E based systems, and the keyboard
language table.

+---------------------------------+
| [Move]       KEYBOARD       [X] |
|                                 |
| Auto-repeat delay      [ 25 ]   |
| Auto-repeat frequency  [ 3  ]   |
| Change queue key code  [ 3  ]   |
| (e.g. 3=CTRL C)                 |
|                                 |
| SMSQ/E keyboard language table  |
| (e.g. 1=USA, 33=France, 44=GB,  |
| 49=Germany,-1=don't set  [ -1 ] |
|                                 |
|             [  OK  ]            |
+---------------------------------+

Initially, the menu offers the current keyboard speed (as read from the
system variables). If you would prefer a slightly different keyboard
auto-repeat speed, experiment a little with the values in the Delay and
Frequency boxes. Don't change th evalues too much or the keyboard may
become uncontrollably fast or too slow.

The Change Queue Code is the key combination used to switch between
jobs by the operating system. Normally, this is set as CTRL C, but may
be changed if really required, for example the old QL program
Taskmaster does this, although I don't know why, and I don't really
know why anyone would want to change it, unless it was deliberately to
disguise or disable task switching via CTRL C. I don't expect anyone
will want to alter any of these three settings, but they're available
for you if you really wish to do so.

The fourth option lets you set the SMSQ/E keyboard language table. The
values entered here follows the usual SMSQ/E conventions of using the
international telephone codes - 1 for USA keyboards, 33 for French, 44
for British, 49 for German and so on. Enter a value of -1 if you'd
rather that Launchpad didn't try to set this. British users running
SMSQ/E or QPC with a laptop computer keyboard may find it useful to try
the USA setting if having problems with certain characters not
appearing on the expected keys, although this is probably best set from
QPC2's own opening configuration dialogue box.

4.4 Launchpad

This menu lets you set certain Launchpad default settings. Some of
these take global effect (i.e. they affect all users) while others
apply to the current user only.

4.4.1 Prompt to access system files - Yes or No.
This was originally included just for testing purposes, but one early
user found a reason for keeping it. Floppy disk (or other removable
media) users need to be prompted to insert a system floppy disk to save
Launchpad's system files. Even if you are a hard disk user, you may
wish to temporarily set Launchpad to save system files to floppy disk
as a backup. Affects all users.

4.4.2 Default drive/directory for Launchpad system files.
This is the directory to which Launchpad saves its system files.
Normally there is no need to alter this setting as you will have
already configured it into the software. I used this for testing the
program during program development and it has been left there - it may
be useful for temporarily changing default drives to make backups of
system files, although making a manual backup of the LAUNCHPADx_dat and
LAUNCHPAD_pwl files is generally just as easy if not easier. Affects
all users.

4.4.3 Launch program from drive/directory
The name of the drive and directory where you store your executable
programs. Launchpad uses this as the default drive for the file
selection menus. Affects current user only.

4.4.4 Default printer port.
Used for printing the list of current Launchpad settings. Affects
current user only.

4.4.5 Sound on or off.
Toggles the error beeps etc off or on. Affects current user only.

4.5 Mouse

Lets you alter the mouse characteristics - acceleration and wake-up
speed. Hit the box you'd like to change, enter the value and then press
OK to implement the new values.

4.6 Network

If your system is used as part of either a QL network or a Sernet
network, this menu lets you set the network station number and start
the network server (which may be removed by any standard job removal
command or utility, such as the RJOB command from Toolkit 2 or the
QPAC2 RJOB menu). If your system has no network facility, it is best to
leave the station numbers at the default value of 1. For a 2 computer
system, both computers may be station 1 if required.

4.7 System

This menu lets you set the system defaults, drive aliases etc on an
'ad-hoc' basis. All told, you can set the DATA_USE, PROG_USE, DEST_USE,
DEV1, DEV2, DEV_USE, FLP_USE, RAM_USE, ROM_USE (Romdisq), WIN_USE,
PAR_USE and SER_USE values (where these exist on your system). Simply
click in the box required and type in the new setting, which is
actually applied when you click on the Apply Settings button.

Note that these settings are GLOBAL, they affect all users of
Launchpad, but they are only set on an ad-hoc basis and the settings
are not preserved for the next time you log into Launchpad, unless you
click on the Save Settings - if you wish the changes to be temporary
only, click on the Apply Settings button.

The System menu is mainly intended for you to restore settings quickly
after they have been changed by another program. For example, when I
use Xchange I normally set DATA_USE and PROG_USE to the values used for
where I have installed my copy of Xchange (so that it can find its help
files, printer drivers and so on). But as Xchange does not restore the
previous defaults afterwards, I find it useful to dive into the System
menu to reset those to the normal defaults for other programs.

A good example is the use of Theirry Godefroy's Archivers Control
Panel. This is a front end for archivers like the Zip ad Unzip
programs. Archivers Control Panel looks on the default drives for the
archivers when needed. I store mine in a directory called WIN1_EXEC_
with PROG_USE defaulting to this directory. When I use Xchange, it
alters DATA_USE and PROG_USE to WIN1_XCHANGE_, so when I next use
Archivers Control Panel it can't find Zip and Unzip until I restore
PROG_USE to WIN1_EXEC_.

Do bear in mind that QDOS and SMSQ/E have only one global set of
xxx_USE values. Change the values and all programs may be able to see
the changes. Therefore, any changes to DATA_USE, PROG_USE etc apply to
all of the system, not on a per-job basis.

+----------------------------------------------------------+
| [Move]          [ RESTORE SYSTEM DEFAULTS ]         [X]  |
|                                                          |
| DATA_USE [                                             ] |
| PROG_USE [                                             ] |
| DEST_USE [                                             ] |
| DEV 1    [                                             ] |
| DEV 2    [                                             ] |
| SUB DRIVE[                                             ] |
| SUB 1    [                                             ] |
| SUB 2    [                                             ] |
| DEV_USE  [   ] FLP_USE [   ] RAM_USE [   ] ROM_USE [   ] |
| SUB_USE  [   ] WIN_USE [   ] PAR_USE [   ] SER_USE [   ] |
| WIN2 (X) [                                             ] |
| WIN2 (Y) [                                             ] |
|                                                          |
|        [ Apply settings ]       [ Save settings ]        |
|                                                          |
+----------------------------------------------------------+


4.8 Users
See the description of the Users menu above. This is the same as the
Users command in the File menu.

4.9 The Directory Devices Icons

The bottom half of the MyQL menu is taken up by icons for the directory
devices on your system - floppy disk, hard disk, ramdisk, romdisq and
so on. Clicking on one off the icons for these drives starts a Q-Trans
program session to display files on this drive in one of the two
Q-Trans file list windows. Note that only drive 1 of each directory
device is listed here, should you wish to access RAM2_ instead of RAM1_
for example, select drive 2 in Q-Trans once it has started.

5.0 The Menus Menu

With this menu you can rename any of the four desktop menus, or select
which one is displayed. To change a name, simply click in the box
containing the name of the appropriate menu and type in the new name.
To switch to one of the other menus, click on the icon to the right of
its name. This is essentially the same as clicking on one of the four
names at the top right of the main Launchpad display.

6.0 The Help Menu

The Help menu uses the Launchpad Text File Viewer to display the help
text files, essentially the Launchpad manual. Launchpad must be able to
find the Text File Viewer program called PTRVIEW_OBJ (it normally lives
in the default Launchpad system directory) and the plain text file
versions of the instructions (filenames ending with _TXT) for the Help
system to work, or an error will be reported if these cannot be found.
The following help texts are used by the Help system:

README_TXT     - Quick start guide to installing and using Launchpad
LAUNCH1_TXT    - Main Launchpad manual, part 1
LAUNCH2_TXT    - Main Launchpad manual, part 2
PASSWORDS_TXT  - Passwords program documentation
CALCULATOR_TXT - The Calculator accessory program
CALENDAR_TXT   - The Calendar accessory program
CHARPICK_TXT   - The Character Picker accessory program
DECIVADR_TXT   - The Decimal Invaders accessory game
HEXPAWN_TXT    - The Hexpawn accessory game
LPSAVER_TXT    - The Launchpad Screeen Saver accessory
PICVIEW_TXT    - The Graphics Viewer accessory program
PTRVIEW_TXT    - The Text File Viewer accessory program
QTRANS_TXT     - The Q-Trans file handler accessory
SNATCH4_TXT    - The Screen Grabber accessory program
STATUS_TXT     - The System Status accessory program
FILELIST_TXT   - List of files supplied
HISTORY_TXT    - Program development history and version numbers


7.0 New Directory Creation

From the File menu, select the Create New Directory Command. This lets
you create a new directory on your hard disk, as you would with the
command MAKE_DIR from BASIC.

Click on the directory name box to enter the name of the directory to
be created. Launchpad tries to be helpful by offering the same drive
name as the drive on which it is located, assuming that this is your
main hard disk. Obviously, you can erase this drive name and type in
another. If it suggests WIN1_ and you wish to create a directory called
FRED, you would type in WIN1_FRED_ or just FRED_ if it already offers
the correct drive name. Press ENTER once you have type it in. The
directory is not actually created until you click on the [OK] button.
If the directory name already exists, an error message is displayed -
click on [OK] to remove the message.


8.0 SBASIC Programs

For use on systems running SMSQ/E, there is a special way of handling
BASIC programs. On QDOS systems BASIC programs are started via File
Info 2 in much the same way as any other data file. The presence of
SBASIC allows Launchpad to offer you a choice of three ways of
launching SBASIC programs (defined as files with names ending with _BAS
or _SAV).

8.1 EXEC

SBASIC allows you to EXECute BASIC programs as a separate job to the
normal job 0 main BASIC interpreter. This first option does the
equivalent of EXEC filename_bas.

8.2 FileInfo 2

Assuming FileInfo 2 is set up to recognise BASIC programs, the program
is executed as a datafile via File Info 2. Obviously, File Info 2 must
be installed on your system for this to work.

8.3 LRUN

This third option tries to pick BASIC (job 0 - the main BASIC
interpreter) and sends as a command the equivalent of LRUN
filename$&CHR$(10). The outcome depends on what BASIC is doing at the
time - it may well work if BASIC is expecting command line input. If a
program is running, the results may be unpredictable!

