Skip to content

Commit

Permalink
QPC 4.04 commands added.
Browse files Browse the repository at this point in the history
  • Loading branch information
@NormanDunbar
NormanDunbar committed Nov 7, 2016
1 parent 942e23e commit bef116f
Show file tree
Hide file tree
Showing 8 changed files with 670 additions and 78 deletions.
2 changes: 2 additions & 0 deletions sphinx/source/Introduction.clean.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -89,6 +89,7 @@ We have covered the commands contained in the following sources:
- AtariDOS and ATARI\_REXT |copyright| Jochen Merz Software
- Turbo Toolkit (freeware) |copyright| The Turbo Team, David Gilham & Mark Knight
- DJToolkit 1.16 (freeware) |copyright| Norman Dunbar & Dilwyn Jones
- QPC version 4.04 specific commands |copyright| Marcel Kilgus.
- As many Public Domain Toolkits as we can find and understand.

We have covered the Toolkit II and Hotkey System II because it is a
Expand Down Expand Up @@ -118,6 +119,7 @@ Contributing Authors
- Peter Jager
- Rich Mellor
- Norman Dunbar - DJToolkit 1.16 additions.
- Norman Dunbar - QPC 4.04 additions.
- (Norman Dunbar - HTML conversion, tidyup etc.)

Installing Toolkits
Expand Down
85 changes: 85 additions & 0 deletions sphinx/source/KeywordsD.clean.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -11,6 +11,7 @@ TODO
- There are two DIVs in this section. Both will have the same section URL. Fix.
- There are two DRAWs in this section. Both will have the same section URL. Fix.
- DISP_COLOUR is referenced from KeywordsI (Ink) but is not in this file.
- DOS_DRIVE and DOS_DRIVE$ have the same URL.


DATA
Expand Down Expand Up @@ -4710,6 +4711,90 @@ channels (see `EX <KeywordsE.clean.html#ex>`__).

--------------

DOS\_USE
========

+----------+-------------------------------------------------------------------+
| Syntax | DOS\_USE device$ |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

DOS\_USE may be used to set the name of the DOS device. The name should be three characters long, in upper or lower case.

**Example**

::

DOS_USE mdv
The DOS device is renamed MDV.

::
DOS_USE DOS
The DOS device is restored to DOS.

::
DOS_USE
The DOS device is restored to DOS.


--------------


DOS\_DRIVE
==========

+----------+-------------------------------------------------------------------+
| Syntax | DOS\_DRIVE drive%, directory$ |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This changes the directory the DOS device is connected to.

By default, DOS1\_ corresponds to C:\\, DOS2\_ to D:\\ and so on, but the base can be freely chosen in the configuration dialog or even at runtime::

DOS_DRIVE 2, "C:\WINDOWS"
will assign DOS2\_ to the windows directory on the host's C:\\ drive.

::

PRINT DOS_DRIVE$(2)
would now return "C:\\WINDOWS".

--------------


DOS\_DRIVE$
===========

+----------+-------------------------------------------------------------------+
| Syntax | directory$ = DOS\_DRIVE$(drive%) |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This reads back the currently connected directory of the DOS device.

**Example**

If we continue from the example above for `DOS\_DRIVE <KeywordsD.clean.html#dos-drive>`__\ , then::

PRINT DOS_DRIVE$(2)
Will print "C:\\WINDOWS".


--------------


DOTLIN
======

Expand Down
85 changes: 77 additions & 8 deletions sphinx/source/KeywordsF.clean.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,7 @@ TODO
- FGET% and FGET$ have the same URL. Fix.
- FPUT% and FPUT$ have the same URL. Fix.
- FILL and FILL$ have the same URL. Fix.
- FLP_DRIVE and FLP_DRIVE$ have the same URL. Fix.
- FREAD and FREAD$ have the same URL. Fix.
- FWRITE and FWRITE$ have the same URL. Fix.

Expand Down Expand Up @@ -1561,7 +1562,9 @@ FLP\_DENSITY
+----------+-------------------------------------------------------------------+
| Syntax | FLP\_DENSITY density (density = S, D, H or E) |
+----------+-------------------------------------------------------------------+
| Location | Gold Cards, SMS |
| Syntax | FLP\_DENSITY (SMSQ/E for QPC only) |
+----------+-------------------------------------------------------------------+
| Location | Gold Cards, SMS, SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

There are four types of floppy disk drives which can be connected to
Expand All @@ -1573,11 +1576,11 @@ emulator). The command FLP\_DENSITY sets the type for use with FORMAT:
+========+=========+========+==========+==============+
| Single | Double | SSDD | 360 Kb | S |
+--------+---------+--------+----------+--------------+
| Double | Double | DSDD | 720 Kb | D |
| Double | Double | DSDD | 720 Kb | D (Not QPC) |
+--------+---------+--------+----------+--------------+
| Double | High | DSHD | 1440 Kb | H |
+--------+---------+--------+----------+--------------+
| Double | Extra | DSED | 3240 Kb | E |
| Double | Extra | DSED | 3240 Kb | E (Not QPC) |
+--------+---------+--------+----------+--------------+

Parameters other than the four letters S, D, H and E, (including
Expand Down Expand Up @@ -1654,6 +1657,18 @@ FLP\_DENSITY overrides the in-built trial-and-error density detection
which is slow for HD drives and even slower with ED drives. This can
however cause problems when FORMATting DSDD disks - see FORMAT!

**NOTE 7**

On SQMS/E for QPC, the same code letters may be added (after a \*) to the end of the medium name to force a particular density format. (For compatibility with older drivers, if the code letter is omitted after the \*, single sided format is assumed).

- FORMAT 'FLP1\_Disk23' Format at highest density or as specified by `FLP\_DENSITY <KeywordsF.clean.html#flp-density>`__\ .

- FORMAT 'FLP1\_Disk24\*' Format single sided
- FORMAT 'FLP1\_Disk25\*S' Format single sided
- FORMAT 'FLP1\_Disk25\*D' Format double sided, double density

Also, FLP\_DENSITY on it's own resets automatic density selection.

**CROSS-REFERENCE**

The same effect as `FLP\_DENSITY <KeywordsF.clean.html#flp-density>`__ can be
Expand All @@ -1666,6 +1681,54 @@ functions.

--------------

FLP\_DRIVE
==========

+----------+-------------------------------------------------------------------+
| Syntax | FLP\_DRIVE drive%, drive$ |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This changes the drive/image the floppy device is connected to.

**Example**

::

FLP_DRIVE 2,"C:\FLOPPY.IMG"
Now FLP2\_ is assigned to the floppy image FLOPPY.IMG on the host computer's C:\\ drive.

::

FLP_DRIVE 2,"B:\"

FLP2\_ is assigned to the physical B:\\ floppy drive of the host computer.

--------------

FLP\_DRIVE$
===========

+----------+-------------------------------------------------------------------+
| Syntax | drive$ = FLP\_DRIVE$(drive%) |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This reads back the current connection of the floppy device.

**Example**

::

PRINT FLP_DRIVE$(2)
will tell you the current setting for flp2\_.

--------------

FLP\_EXT
========

Expand Down Expand Up @@ -1741,7 +1804,7 @@ FLP\_SEC
+----------+-------------------------------------------------------------------+
| Syntax | FLP\_SEC level |
+----------+-------------------------------------------------------------------+
| Location | Gold Cards, Trump Card, SMS, THORs |
| Location | Gold Cards, Trump Card, SMS, THORs, SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

The Gold Card, Trump Card and Thor range of computers, together with
Expand Down Expand Up @@ -1788,15 +1851,21 @@ Security Level 2
FLP\_SEC has no effect - the security level is fixed at 2, the most
secure.

**SMSQ/E for QPC NOTE**

FLP\_SEC has no effect - the security level is fixed at 2, the most
secure.

--------------

FLP\_START
==========

+----------+-------------------------------------------------------------------+
| Syntax | FLP\_START time |
| Syntax | FLP\_START time |
+----------+-------------------------------------------------------------------+
| Location | Gold Cards, Trump Card, THORs, ST/QL (level D.02+ drivers), SMS |
| Location | Gold Cards, Trump Card, THORs, ST/QL (level D.02+ drivers), SMS, |
| | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

The disk system always tries to read data from a disk as soon as it
Expand Down Expand Up @@ -1835,7 +1904,7 @@ FLP\_STEP
+----------+-------------------------------------------------------------------+
| Syntax | FLP\_STEP [drive,] rate |
+----------+-------------------------------------------------------------------+
| Location | Disk Interfaces, Gold Cards, SMS |
| Location | Disk Interfaces, Gold Cards, SMS, SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

The step rate enables the computer to known how quickly to step
Expand Down Expand Up @@ -1929,7 +1998,7 @@ FLP\_USE
+----------+-------------------------------------------------------------------+
| Syntax | FLP\_USE [device] |
+----------+-------------------------------------------------------------------+
| Location | Gold Cards, Trump Card, THORs, ST/QL, SMS |
| Location | Gold Cards, Trump Card, THORs, ST/QL, SMS, SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

Software which was written in the early days of the QL tended to
Expand Down
42 changes: 41 additions & 1 deletion sphinx/source/KeywordsM.clean.rst
View file
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ MACHINE
+----------+-------------------------------------------------------------------+
| Syntax | MACHINE |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E |
| Location | SMSQ/E, SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This function returns a value corresponding to the type of system on
Expand Down Expand Up @@ -2675,6 +2675,46 @@ and::
VIEW flp1_test_bas


--------------

MOUSE\_SPEED
============

+----------+------------------------------------------------------------------+
| Syntax | MOUSE\_SPEED [#ch,] acceleration, wakeup |
+----------+------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+------------------------------------------------------------------+

This function adjusts the mouse acceleration and wake up factor. The acceleration factor is of no consequence to QPC2. The wakeup values, however, may still be set. They range from 1 to 9, with 1 being the most sensitive.

--------------

MOUSE\_STUFF
============

+----------+-------------------------------------------------------------------+
| Syntax | MOUSE\_STUFF [#ch,] hot$ |
+----------+-------------------------------------------------------------------+
| Location | SMSQ/E for QPC |
+----------+-------------------------------------------------------------------+

This function adjusts the string that is stuffed into the keyboard queue when the middle mouse button is pressed (or both left and right buttons are pressed simultaneously). The string cannot be longer than two characters, but this is enough to trigger any hotkey, which in turn, can do almost anything.

**Example**

::

MOUSE_STUFF '.'
Generates a dot if middle mouse button is pressed.

::

MOUSE_STUFF CHR$(255) & '.'
Generates hotkey <Alt><.> which will activate whatever has been defined on that key combination.

--------------

MOVE
Expand Down

0 comments on commit bef116f

Please sign in to comment.