com.tapina.robe.swi
Class OS

java.lang.Object
  com.tapina.robe.runtime.Block
      com.tapina.robe.runtime.DataBlock
          com.tapina.robe.module.Module
              com.tapina.robe.swi.SWIHandler
                  com.tapina.robe.swi.OS

public final class OS

extends SWIHandler

Created by IntelliJ IDEA. User: gareth Date: Aug 21, 2003 Time: 6:12:53 PM

Field Summary

Fields inherited from class com.tapina.robe.swi.SWIHandler

log, METHOD_PARAMETERS

Method Summary

void	Args(Environment env)
int	args(int reasonCode, int handle, int attribute)
void	Byte(Environment env)
void	ChangeDynamicArea(Environment env)
void	CLI(Environment env)
void	cli(java.lang.String command)
static long	convertTo5ByteTime(java.util.Date date)
static java.util.Date	convertToDate(long fiveByteTime)
void	deleteVarVal(java.lang.String name)
void	EnterOS(Environment env)
void	Exit(Environment env)
void	exit(int rc)
void	File(Environment env)
void	file1(java.lang.String filename, int loadAddress, int execAddress, int attributes)
void	file10(java.lang.String filename, int filetype, ByteArray data)
DirectoryEntry	file5(java.lang.String filename, java.lang.String path) This SWI is used to read catalogue information for a named object.
void	file8(java.lang.String filename)
void	Find(Environment env)
int	find(int action, int handle)
int	find(int action, java.lang.String filename, java.lang.String path, boolean dirError, boolean missingError)
void	FSControl(Environment env)
java.lang.String	fsControl(int reasonCode, java.lang.String pathname, java.lang.String path)
void	GBPB(Environment env)
DirectoryEntry[]	gbpb11(int reasonCode, java.lang.String dirName, int offset, int count, java.lang.String match)
int	gbpb4(int reasonCode, int fileHandle, byte[] buffer, int offset, int count)
void	GenerateError(Environment env)
void	generateError(int errorNumber, java.lang.String errorMessage)
static int	getBase()
AppEnvironment	getEnv()
void	GetEnv(Environment env)
static OS	getInstance()
static java.lang.reflect.Method	getMethod(java.lang.Integer offset)
java.lang.String	getName()
void	GSTrans(Environment env) This SWI is equivalent to a call to OS_GSInit, followed by repeated calls to OS_GSRead .
java.lang.String	gsTrans(java.lang.String in, boolean spaceTerminates, boolean convertControlCodes, boolean stripQuotes)
void	IntOff(Environment env)
void	IntOn(Environment env)
static void	main(java.lang.String[] args)
void	Module(Environment env)
void	newLine()
void	NewLine(Environment env)
int[]	osByte(int reasonCode, int r1, int r2)
char	readC()
void	ReadC(Environment env)
void	ReadModeVariable(Environment env)
void	ReadUnsigned(Environment env)
int	readUnsigned(int defaultInputBase, java.lang.String input) Convert a String to an integer.
void	ReadVarVal(Environment env) This SWI returns type and value of a variable.
java.lang.String	readVarVal(java.lang.String varName)
int	readVduVariable(int number)
void	ReadVduVariables(Environment env) Entry: => R0 = pointer to input block R1 = pointer to output block (can be same as R0) The input block is a list of variable numbers (words) terminated by -1.
void	SetVarVal(Environment env) This SWI sets a variable's value to that specified, or deletes the variable.
void	setVarVal(java.lang.String name, java.lang.String value, int valueType)
void	SpriteOp(Environment env)
void	spriteOp(int operation, SpriteArea spriteArea, Sprite sprite)
void	spriteOp(int operation, SpriteArea spriteArea, java.lang.String spriteName)
java.awt.image.BufferedImage	spriteOp40(SpriteArea spriteArea, java.lang.String spriteName)
void	Write0(Environment env)
void	write0(java.lang.String s)
void	writeC(char c)
void	WriteC(Environment env)

Methods inherited from class com.tapina.robe.module.Module

getBytes, getHelp, getSize, setSize

Methods inherited from class com.tapina.robe.runtime.Block

getAddress, setAddress

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getInstance

public static OS getInstance()

getBase

public static int getBase()

getName

public java.lang.String getName()

Overrides:

getName in class Module

getMethod

public static java.lang.reflect.Method getMethod(java.lang.Integer offset)
                                          throws java.lang.NoSuchMethodException

Throws:

java.lang.NoSuchMethodException

WriteC

public final void WriteC(Environment env)

writeC

public final void writeC(char c)

NewLine

public final void NewLine(Environment env)

newLine

public final void newLine()

ReadC

public final void ReadC(Environment env)

readC

public final char readC()

Write0

public final void Write0(Environment env)

write0

public final void write0(java.lang.String s)

CLI

public final void CLI(Environment env)

cli

public final void cli(java.lang.String command)

Byte

public final void Byte(Environment env)

osByte

public final int[] osByte(int reasonCode,
                          int r1,
                          int r2)

File

public final void File(Environment env)

file5

public final DirectoryEntry file5(java.lang.String filename,
                                  java.lang.String path)

This SWI is used to read catalogue information for a named object.

Parameters:

filename -

path -

file1

public void file1(java.lang.String filename,
                  int loadAddress,
                  int execAddress,
                  int attributes)

file8

public final void file8(java.lang.String filename)

file10

public final void file10(java.lang.String filename,
                         int filetype,
                         ByteArray data)

Args

public final void Args(Environment env)

args

public final int args(int reasonCode,
                      int handle,
                      int attribute)

GBPB

public final void GBPB(Environment env)

gbpb4

public final int gbpb4(int reasonCode,
                       int fileHandle,
                       byte[] buffer,
                       int offset,
                       int count)

gbpb11

public final DirectoryEntry[] gbpb11(int reasonCode,
                                     java.lang.String dirName,
                                     int offset,
                                     int count,
                                     java.lang.String match)

Find

public final void Find(Environment env)

find

public final int find(int action,
                      java.lang.String filename,
                      java.lang.String path,
                      boolean dirError,
                      boolean missingError)

find

public final int find(int action,
                      int handle)

GetEnv

public final void GetEnv(Environment env)

convertTo5ByteTime

public static final long convertTo5ByteTime(java.util.Date date)

convertToDate

public static final java.util.Date convertToDate(long fiveByteTime)

getEnv

public final AppEnvironment getEnv()

Exit

public final void Exit(Environment env)

exit

public final void exit(int rc)

IntOn

public final void IntOn(Environment env)

IntOff

public final void IntOff(Environment env)

EnterOS

public final void EnterOS(Environment env)

Module

public final void Module(Environment env)

ReadUnsigned

public final void ReadUnsigned(Environment env)

readUnsigned

public final int readUnsigned(int defaultInputBase,
                              java.lang.String input)

Convert a String to an integer. If the String starts with &, base 16 is assumed. If the String starts with base_, this base is used. If no base is given or the base is invalid, the base in defaultInputBase is used. The terminating character in the string is the first character that is inconsistent with the base being used.

Parameters:

defaultInputBase - base to use if none is specified in the string

input - String to convert

Returns:

ReadVarVal

public final void ReadVarVal(Environment env)

This SWI returns type and value of a variable. To check if it exists or find its length, call with R2 < 0. If the variable does not exist R2 will be 0. Otherwise the length is given by NOT(R2), although for anything other than a string variable (type 0) this is the unexpanded length. For either case an error will be returned.

Parameters:

env - IN: R0 = pointer to wildcarded name R1 = pointer to buffer R2 = length of buffer, or -ve to check existence/read length R3 = name pointer, or 0 for 1st call R4 = 3 to expand macros and numbers to strings. OUT: if R2 was -ve (read length) R0 corrupt (pointer to error) R2 = NOT (length), or 0 if variable does not exist. if R2 was +ve (read value) R0 preserved R2 = bytes read In both cases: R3 = new name pointer R4 = Variable type

readVarVal

public final java.lang.String readVarVal(java.lang.String varName)

SetVarVal

public final void SetVarVal(Environment env)

This SWI sets a variable's value to that specified, or deletes the variable. The name may be wildcarded for deletion and update (using '*' and '#'). Code variables will not be deleted unless R4 = 16. Literal strings do not need to be null terminated, as R2 is used for the length.

Parameters:

env - IN: R0 = pointer to name R1 = pointer to value to set to R2 = length, or -1 to delete R3 = name pointer (0 for 1st call) R4 = variable type (0 = string, 1 = integer, 2 = macro, 3 = expression, 4 = literal string, +16 code) OUT: R3 = new name pointer R4 = variable type

setVarVal

public void setVarVal(java.lang.String name,
                      java.lang.String value,
                      int valueType)

deleteVarVal

public void deleteVarVal(java.lang.String name)

GSTrans

public final void GSTrans(Environment env)

This SWI is equivalent to a call to OS_GSInit, followed by repeated calls to OS_GSRead . It reads and translates a whole string.

 CTRL(num)
  system variable str
 ]]>
 

Parameters:

env -

gsTrans

public final java.lang.String gsTrans(java.lang.String in,
                                      boolean spaceTerminates,
                                      boolean convertControlCodes,
                                      boolean stripQuotes)

FSControl

public final void FSControl(Environment env)

fsControl

public final java.lang.String fsControl(int reasonCode,
                                        java.lang.String pathname,
                                        java.lang.String path)

ChangeDynamicArea

public final void ChangeDynamicArea(Environment env)

GenerateError

public final void GenerateError(Environment env)

generateError

public final void generateError(int errorNumber,
                                java.lang.String errorMessage)
                         throws SWIError

Throws:

SWIError

SpriteOp

public final void SpriteOp(Environment env)

spriteOp40

public final java.awt.image.BufferedImage spriteOp40(SpriteArea spriteArea,
                                                     java.lang.String spriteName)

spriteOp

public final void spriteOp(int operation,
                           SpriteArea spriteArea,
                           java.lang.String spriteName)

spriteOp

public final void spriteOp(int operation,
                           SpriteArea spriteArea,
                           Sprite sprite)

ReadVduVariables

public final void ReadVduVariables(Environment env)

Entry: => R0 = pointer to input block R1 = pointer to output block (can be same as R0) The input block is a list of variable numbers (words) terminated by -1. Each variable is read, and its value is written as a word into the output block. Note: You can also read the mode variables with this call.

Parameters:

env -

readVduVariable

public final int readVduVariable(int number)

ReadModeVariable

public void ReadModeVariable(Environment env)

main

public static void main(java.lang.String[] args)
                 throws UnknownSWIException

Throws:

UnknownSWIException