Difference between revisions of "OSBYTE &A3"

From BeebWiki
Jump to: navigation, search
m (1 revision)
(Added Plus 1 Support call.)
Line 1: Line 1:
 
[[Category:OSBYTE]]
 
[[Category:OSBYTE]]
OSBYTE &A3 (163) - X=242   (Acornsoft GXR 1.20)
+
===OSBYTE &A3 (163) - Application support===
 +
  On entry:
 +
    X = application identifier
 +
        X=128 Electron Plus 1
 +
        X=242 Graphics Extension Support
 +
        X=243 65Tube
 +
        X=255 VIEW
 +
    Y = parameter
 +
  On exit:
 +
    X = return value
 +
    Y = return value
  
     Y=0     resets the dot-dash pattern & length to defaults
+
===X=128 Plus 1 Support===
     Y=1..64 set dot dash pattern repeat length
+
  On entry:
     Y=65    return status returns X=b0..5 current dot dash pattern repeat
+
     Y=0 enable printer/ADC
                                          length (0 means 64 though)
+
     Y=1 disable printer/ADC
                                    b6    if set flood fill is always active
+
     Y=2 enable serial port
                                    b7    if set GXR ROM is turned on
+
    Y=3 disable serial port
                                  Y=number of pages allocated to sprites
+
    Y=4 restore ROM table
     Y=66    return info on current sprite returns X=pixel width
+
  On exit:
                                                  Y=pixel height
+
     If Y<4 on entry,
            if X=Y=0 then the ROM is not fitted, or no sprite is selected
+
      X=0 if enabled, X<>0 if disabled
 +
    If Y=4 on entry,
 +
      X=default language in X, b7 set if no default language
  
    X=242   (RISC OS 1.00)
+
===X=242 Graphics Extension Support (GSX, RISC OS)===
     Y=0    resets the dot-dash pattern & length to defaults
+
  On entry:
 +
     Y=0    resets the dot-dash pattern and length to defaults
 
     Y=1..64 set dot dash pattern repeat length
 
     Y=1..64 set dot dash pattern repeat length
     Y=65    return status returns X=b0..5 current dot dash pattern repeat  
+
  On entry:
                                          length (0 means 64 though)
+
     Y=65    return status returns
                                    b6    if set flood fill is always active
+
  On exit:
                                    b7    if set sprites are always active
+
    X=b0..5 current dot dash pattern repeat length (0 means 64)
     Y=66    return info on current sprite returns X=pixel width  
+
      b6    if set flood fill is always active
                                                  Y=pixel height  
+
      b7    if set GXR ROM is turned on
 +
    Y=number of pages allocated to sprites
 +
  On entry:
 +
     Y=66    return info on current sprite returns
 +
  On exit:
 +
    X=pixel width  
 +
    Y=pixel height
 +
    if X=Y=0 then the ROM is not fitted, or no sprite is selected
  
    X=243   (65Tube emulator)
+
===X=243 65Tube emulator===
     Y=4    find code address, on exit if Y<>0, XY=address to jump to.
+
  On entry:
            Called on Tube reset, *BASIC and NMIs to ask for any code
+
     Y=4    find code address
            entry address
+
  On exit:
     Y=6    find *command to execute, on exit if Y<>0, XY=>*command to
+
    if Y<>0, XY=address to jump to
            execute. Called on Tube reset to ask for any startup command.
+
    Called on Tube reset, *BASIC and NMIs to ask for any code entry address.
 +
  On entry:
 +
     Y=6    find *command to execute
 +
  On exit:
 +
    if Y<>0, XY=>*command to execute
 +
    Called on Tube reset to ask for any startup command.
  
    X=255   (VIEW)
+
===X=255 VIEW===
     Y=1    read VIEW's ROM workspace byte at &DF0+romnum.
+
  On entry:
     Y=&81  set VIEW's ROM workspace byte at &DF0+romnum to &80.
+
     Y=&01  read VIEW's ROM workspace byte at &DF0+num
 +
     Y=&81  set VIEW's ROM workspace byte at &DF0+num to &80
 +
  On exit:
 +
    X=VIEW's ROM workspace byte at &DF0+num
  
 
==See Also==
 
==See Also==

Revision as of 02:17, 14 January 2016

OSBYTE &A3 (163) - Application support

 On entry:
   X = application identifier
       X=128 Electron Plus 1
       X=242 Graphics Extension Support
       X=243 65Tube
       X=255 VIEW
   Y = parameter
 On exit:
   X = return value
   Y = return value

X=128 Plus 1 Support

 On entry:
   Y=0 enable printer/ADC
   Y=1 disable printer/ADC
   Y=2 enable serial port
   Y=3 disable serial port
   Y=4 restore ROM table
 On exit:
   If Y<4 on entry,
     X=0 if enabled, X<>0 if disabled
   If Y=4 on entry,
     X=default language in X, b7 set if no default language

X=242 Graphics Extension Support (GSX, RISC OS)

 On entry:
   Y=0     resets the dot-dash pattern and length to defaults
   Y=1..64 set dot dash pattern repeat length
 On entry:
   Y=65    return status returns
 On exit:
   X=b0..5 current dot dash pattern repeat length (0 means 64)
     b6    if set flood fill is always active
     b7    if set GXR ROM is turned on
   Y=number of pages allocated to sprites
 On entry:
   Y=66    return info on current sprite returns
 On exit:
   X=pixel width 
   Y=pixel height
   if X=Y=0 then the ROM is not fitted, or no sprite is selected

X=243 65Tube emulator

 On entry:
   Y=4     find code address
 On exit:
   if Y<>0, XY=address to jump to
   Called on Tube reset, *BASIC and NMIs to ask for any code entry address.
 On entry:
   Y=6     find *command to execute
 On exit:
   if Y<>0, XY=>*command to execute
   Called on Tube reset to ask for any startup command.

X=255 VIEW

 On entry:
   Y=&01   read VIEW's ROM workspace byte at &DF0+num
   Y=&81   set VIEW's ROM workspace byte at &DF0+num to &80
 On exit:
   X=VIEW's ROM workspace byte at &DF0+num

See Also

Jgharston 22:16, 26 May 2009 (UTC)