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>

S> SHOW GROUPS

       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. MsgC

where

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.

SysClip Data has two formats Format 1111 010101 000000000001 101010 1000 for Layered Data and 1111 010101 000000000001 101010 11xy for single layer data.
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:
  1. 8 Zeros
  2. 4 Zeros  and the Transparency of Top Layer
  3. 4 Zeros  and the Transparency of Mid Layer
  4. 4 Zeros  and the Transparency of Base Layer

 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
  • 01 render and go to y,x+1
  • 10 render this and next pixel the same then go to y,x+2
  • 11 render this and next two pixels the same then go to y,x+3
  • 00 render this pixel then go to the next line y+1,X0
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.
  • cs=00 - Virtual Color Set
  • cs=01 - Gray-scale
  • cs=10 - (Red Set)
  • cs=11 - (Green Set)
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:
  • Consists of a 1 if sprites or 0 if not.
  • Six bit frame number for up to 64 video frames.
  • 25 bit GIMMEx32 address normally only 23 bits usable.

 Note the gimmex32 address just a filler data the actual
 data used is generated as the SysClip file is loaded
 into memory.

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
  • 01 render these three and go to y,x+3
  • 10 render each pixel twice in a row  and go to y,x+6
  • 11 repeat pattern twice then go to y,x+6
  • render these three pixels then go to the next line y+1,X0
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.
  • 00 - Next 30 Bits encode 5 sets of standard Coco3 Composite colors.
  • 01 - Next 30 Bits encode 5 sets of standard Coco3 RGB colors.
  • 10 -  Actually Shows as 01010101.data
    where the data is three eight bit colors from the Extra Color Set
    and every Word following four  eight bit colors until we encounter
    the data  blink time.
    blink time.blink time.blink time.
  • 11 - Actually Shows as 11111.GIMEx.GIMEx.GIMEx
    and every three Words following are processed together as 96 bits representing 10 consucitive pixels of 9 bits each followed by
    either 000011 to continue or 000000 to end that color scheme
    and check the next word for the new mode.
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.

FULL SCREEN MODE COMMANDS

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.