SPrompt Commands
This is not a complete list but rather enough at least to include all the examples on the website.
Commands shown in bold items in {} to be replaced by a value.B connection to a PC.
S>X
If the S prompt is being accessed from CPU#0 this command closes the S prompt returning to the X prompt.
Example:>
S>X
X>
Examples of how it works are on
the page that discusses the GIMMEx32.
On screen replace background by color
blocks to show which screen group owns that section of the monitor.
This is a chart of the color codes.
A |
![]() |
Coco Green |
C |
![]() |
Cyan |
D |
![]() |
Dark Green |
E |
![]() |
Evergreen |
F |
![]() |
Fusha |
G |
![]() |
Gold |
H |
![]() |
Hot Pink |
J |
![]() |
Jade |
K |
![]() |
Kite Sky Blue |
L |
![]() |
Lavender |
M |
![]() |
Mauve |
N |
![]() |
Noir |
O |
![]() |
Orange |
P |
![]() |
Purple |
Q |
![]() |
White |
R |
![]() |
Red |
S |
![]() |
S Silver |
T |
![]() |
Tan |
The Background is denoted with a dark Blue
as above.
S> ASSIGN {screen group code} {system device}
Where the {screen group code} of the form. MsgCwhere
Sysclip format:
SysClips are a graphic in a special format held in set of 32
bit strings stored in HiDef Video Memory.
Sysclips may be loaded by a virtual CoCo into a tempory memory buffer and
then through an XAPI transfered to HiDef Video Memory by
the GIMMEx32 the originating virtual CoCo then no longer has any
connection with the Sysclip which is then managed completely by CPU#1 and
the GIMMEx32.
The Format for a static SysClip is described below.
It makes the most sense when broken down to 32 Bit Long Words we will
describe the SysClip in terms of it's data content in Long Words using the
following notation. LW(0) is the initial longword LW(1)
the second longword ect.
Word # | Word Format | Comments: |
---|---|---|
0 | 1111 010101 000000000001 101010 1100 | Clip Data Identifier Code for multi layer data 32 bits. |
1 | 0000 rows(12bits) column(12bits) 0000 | This 32 Bit word defines the size of the data. |
2 | 00000000 0000ToTL 0000ToML 0000ToBL | This word consists of four bytes these are:
The Transparency data is only used if the Virtual Color Set is selected. |
3 |
blink color.blink time.file size | blink color.=Clip blink color. color.blink=Clip blink time. file size=Clip File Size in 256 byte blocks as a 16 bit integer. |
4 |
0000 x-offset(12bits) y-offset(12bits) 0000 | These are the X and Y coordinates of the start point of the
rendered data We will call these Xo and Yo |
5 |
Top Layer(10bits)Mid Layer(10bits)Base Layer(10bits) inc | So the 10 Bit color codes for each layer followed by inc inc means Increment If you start by rendering at Yo,Xo and x>Xo and y>Yo
|
6 | Command | This is an X prompt command to be executed when the SysClip is
clicked on by the System Mouse. Alternately up to three commands
using the syntax: command1 | command 2 | command 3 in which case right clicking on the Right Center or Left part of the Clip will execute commands 1 2 or 3. If you left click the command instead you put CPU #0 in focus and the command is put at the X prompt where you can either press enter to confirm or edit the command before confirming. |
Single Layer SysClip Data format.
Word # | Word Format | Comments: |
---|---|---|
0 | 1111 010101 000000000001 101010 10cs | Clip Data Identifier Code for a single layer SysClip TheClip Data Identifier Code these thirty bits specific. followed by a two byte color set code cs.
|
1 | 0000 rows(12bits) column(12bits) 000x | The first 32 Bit word of the data defines the size of the data. If x=1 "Extra Color Set enabled." |
2 | sprites?+frame# + gimmex32 address. |
Animation Info:
Note the gimmex32 address just a filler
data the actual |
3 |
blink color.blink time.file size | 11blink color.=Clip blink color. color.blink=Clip blink time. file size=Clip File Size in 256 byte blocks as a 16 bit integer. |
4 |
0000 x-offset(12bits) y-offset(12bits) 0000 | These are the X and Y coordinates of the start point of the
rendered data We will call these Xo and Yo |
5 |
* Depends on color set used. So we will enumerate the
options as 5a,5b,5c ect. |
|
5a |
If (Red
Set) , (Green Set) or (Virtual Color Set if "Extra Color Set not enabled." ) P1(10bits)P2(10bits)P3(10bits) inc |
10 bit color codes for each of three pixels
followed by inc. inc. means Increment If you start by rendering at Yo,Xo and x>Xo and y>Yo
|
5b |
If Gray-scale Set P1.P2.P3.P4.rt.rn |
A 7 bit code for each of four pixels followed by a "rt" single bit
"Repeat Type" with two values 0=each 1=pattern and a four bit "rn"
"Repeat number indicating how many times to repeat "each" pixel or
the 4 pixel pattern. |
5c |
If Virtual Set and
"Extra Color Set enabled." then format
mode.data |
The mode is one of the data determines how it will be
processed. In all cases each case though there are no repeats and the picture uses the FRAME SIZE DATA at the end of the file to determine when to wrap to the next line.
|
6 | A Text String Corresponding to up to three alternative commands each seperated by " | ". | This is an X prompt command to be executed when the SysClip is
clicked on by the System Mouse. Alternately up to three commands
using the syntax: command1 | command 2 | command 3 in which case right clicking on the Right Center or Left part of the Clip will execute commands 1 2 or 3. If you left click the command instead you put CPU #0 in focus and the command is put at the X prompt where you can either press enter to confirm or edit the command before confirming. |
S> SAVE ASSIGNED
All Screen Group Assignments can be saved in the file SGA.CFG on u0: which if u0: is Nitros9 format is /ud0/NVR/sga.cfg or if u0: is DOS A:NVR\SGA.CFG .
S> RESTORE ASSIGNED
All Screen Group Assignments are restored by this command with previous assignments droped.
S> APPEND ASSIGNED {OVERWRITE}
Screen Group Assignments stored in SGA.CFG are added to current
assignments skipping conflicting assignments unless the OVERWRITE
option is evoked.
An example of a conflict would be if there was an entry VsgD #3 but VsgD
had already bin assigned in the X> during this session.
S> LAYOUT
This command will popup a screen layout in the monitor it was typed in.
So supposing it was typed on the VGA screen which happens to be 960x720
mode.
We might get this.
If we happened to be on the Composite Screen at the time the command S> LAYOUT VGA could be used instead to start a screen layout window on the VGA Monitor.
If however you were on the VGA monitor and wanted to work on the
Composite Monitors layout you could type S> LAYOUT CMP
the following window would popup on the Composite Monitor.
Based on further details you can read on the GIMMEx32 page of this site
you can see that we could reconfigure the VGA screen in several ways.
Let's first see how we could close all screen groups on the VGA screen.
S> VGA S
short form for SCREEN VGA SAVE see above.
Aside from dividing up the screen into screen groups there are commands
to temporary give full screen access to the screen.
To exit full screen use the hot key combo [[Right-SHIFT][ESC}[CLEAR]].
[[Right-SHIFT][ESC}[CLEAR]] means (hold down the right
shift key and then while keeping it held down hold down the escape key
and while continuing to hold these down press CLEAR) .
S> COMPOSITE {Screen Group Code}
Shows that screen group
in full screen on the Composite Monitor.
The original screen group may come from either
the composite or VGA monitor.
S> COMPOSITE ASSIGN ALL TO FOCUS
Shows the virtual CoCo in FOCUS in full screen on the Composite Monitor.
S> VGA ASSIGN ALL TO FOCUS
Shows the virtual CoCo in FOCUS in full screen on the VGA Monitor.
S> {monitor} {cpu}
Shows the main screen
of virtual CoCo controled by {cpu} on {monitor}
{monitor} may be one of V C or A that is
V for VGA, C for Composite or A for Adapter.
S> {monitor 1} MIRROR {monitor 2}
Sets {monitor 2} to mirror the
contents of {monitor 1} if {monitor 2} is capable of
reseting to the required resolution and
if not does nothing but place the error message "Maximum
Resolution Supported is {res}" at the S prompt.