GameBasic for Sega Saturn instruction / functional list ***** THIS IS A WORK IN PROGRESS DOCUMENT ********* This document represents most of the commands commonly used in Gamebasic and a brief description of what is does. Translated text by Hurrycane Version 2 Text originally downloaded from a Japanese site. Translated with software and reworded and optimized by Hurrycane. All corrections and additions are welcome, just inform gamebasic@seganet.com Of the new change and upload it to the web. Format of commands: PAGE NUMBER (Sega GAMEBASIC BOOK) - COMMAND ----- SHORT DEFINITION E.g. PAGE NO. COMMAND DEFINITION 24 ABS - where the absolute value is returned ** Note all references marked with ****** are extremely rough translations *** *** Things left to do **** The OBJ sections are still in the roughest state and need to be moved around and optimized. Need to Fix all the definitions with ****'s Possibly add examples to the definitions... =-=-=-=-=-=-=--=-=-==-=-= * Fixed point type, floating point type function ------- - General instructions 24 ABS - where the absolute value is returned 29 CINT - Rounding the decimal part, to integer where the value which is done to convert is returned 38 FIX - Cutting down the decimal part, to integer where the value which is converted is returned 38 FKEY - where the function key in the keyboard is defined 39 FOTOSTEP- Start of pool processing 75 RND - where random number value is returned ******** 77 SGN - it was specified the mark of the ‚¿ which is inhaled is returned ******* 77 SHIFT - state of the shift key of the Sega Saturn keyboard is inspected - File function 113 DSKF - where empty capacity of the device which is specified is returned * Fixed point type function ------------- - Generality instruction 24 ACS - where the character code is returned 35 EPL - where line number of the error which is generated immediately before the is returned 35 ERR - where number of the error which is generated immediately before is returned 40 FRAC - where it returns the decimal part of the numerical value 40 FRE - Remaining capacity of variable area and where size of user area and file area is returned 50 INSTR - Retrieves the character string, and where it returns the information of position 53 LEN - returns the length in the character string *********** 64 where state of the propellant-actuated device Sega Saturn itself control terminal is returned *********** 67 PEEK - where the data of 1 byte is read out from user area 69 POS - where cursor position of the text picture is returned 89 VAL - where the character string is converted to numerical value 89 VERSIONBASIC - where version of the of BASIC is returned 93 XATN - returns the opposite tangent (the arc tangent) 93 XCOS - Returns the cosine (the cosine) 94 XDIST - Returns the Calculated distance from starting point 94 XSIN - Returns the sine (sign) 95 XTAN - Returns the tangent (the tangent) -BG/ text / video type function 157 GETCHR - where the pattern name data is loaded from the character pattern picture 158 PALATTE - Acquisition pallet value 159 POINT - where color in the coordinate which the bit map picture specifies is detected 162 RGB -It calculates palette value and the data of the color which is specified at the time of 32768 color mode, from each color component 163 RGBADD - calculates palette value and the color data which is specified at the time of 32768 color mode, in every color component increase and decrease value 164 RGBTO - It is close in the value which designates palette value and the data of the color which is specified at the time of 32768 color mode, as target Calculating ‚ column value, which it returns -OBJ instruction / function 20 (link structure: the parent OBJECT:@PARENT) the related attaching of the OBJECT (the PARENT) 198 where it specifies 21 (link structure: the child OBJECT@CHILD) the related attaching of the OBJECT (the CHILD) 204 where it returns 23 (link structure: the younger brother OBJECT:@RIGHT) the related attaching of the OBJECT (the RIGHT) 205 where it returns 56 (the X position:@XD which is projected on the picture) as for the OBJECT when being projected on the picture, 210 where coordinate is read out 57 (the Y position:@YD which is projected on the picture) as for the OBJECT when being projected on the picture, 210 where coordinate is read out 58 (the Z position:@ZD from on the picture) as for the OBJECT when being projected on the picture, 210 where coordinate is read out 59 (the RADIUS/ZD:@RD) as for the OBJECT when being projected on the picture, 210 where coordinate is read out 62 (the contact flag and the distance:@COLIDIST) 212 where result of collision decision of the OBJECT is inspected 63 (the OBJECT number:@COLIOBJ which contacted) 213 where the OBJECT number which collides with collision decision of the OBJECT is acquired 64 (the matrix M00 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 65 (the matrix M01 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 66 (the matrix M02 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 67 (the matrix M10 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 68 (the matrix M11 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 69 (the matrix M12 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 70 (the matrix M20 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 71 (the matrix M21 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 72 (the matrix M22 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 73 (the matrix M30 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 74 (the matrix M31 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out 75 (the matrix M32 at the time of perspective conversion) 214 where matrix value at the time of perspective conversion of the OBJECT is read out - ƒX ply To / 3 D functions 224 ATRID - where the unused attribute ID is returned 224 POLYGONID - where contents of polygon are read out 225 TEXID - where contents of the texture ID are read out 226 VERTEX - where contents of the apex ID are read out - Instruction related to sound 267 MMLSTAT () - where the parameter which is in the midst of performing is acquired 272 PLAYSTAT() - where whether or not the sequence number which is specified, while performing you inspect 283 SFRE () - where the free area of ƒ\ƒ"ƒO data area is returned 307 TFRE () - where the free area of timbre data area is returned 309 TPROP ()- where read-out of command of the timbre data is done * Floating point type function ------------ - Generality instruction 25 ATN - returns the opposite tangent (the arc tangent) 31 COS - returns the cosine for angle (the cosine) 36 EXP - specified function (the digital wood which designates the E as the bottom you express and starts and power) it calculates 56 LOG - where natural logarithm of the numerical value which is specified is returned 78 SIN - Returns the sine (sign) 80 SQR - square root is returned 83 TAN - returns (the tangent) 95 XSQR - square root is returned - File function 115 LOC - reading and writing position acquisition of the file which is been open 115 LOF - where the terminal of reading and writing position of the file which is been open is returned * Character string type function -------- - Generality instruction 25 BIN$ - numerical value is converted to the character string of binary veneration type 26 BINHEX$- where the character string of binary format is converted to the character string of hexadecimal format 27 BITW$ - where it converts the bit width of the data in the character string 28 CHR$ - where the character which corresponds to the character code which is specified is returned 32 DATE$ - where the time of day information is acquired from the built-in clock 42 HEX$ - where the numerical value is converted to the character string of hexadecimal format 43 HEXBIN$ - where the character string of hexadecimal format is converted to the character string of binary format 47 INKEY$ - where information of entry of the key 1 character is read from the keyboard 49 INPUT$ - where it waits until there is entry of specified character several parts 53 LEFT$ - where it returns the character string of the length which is specified from the left side in the character string. 58 MID$ - where it fetches the length from the digit position which specifies the portion in character string 68 PEEK$ - where the data is read out as the character string from user area 75 RIGHT$ - where it returns from the right flank in the character string, fetching the character string of the length which is specified 79 SPACE$ - where the character string of nul of the length which is specified is returned 80 STR$ - numerical value is converted to the character string of decimal format 81 STRING$ - where the character string which repeated the character which is specified is returned 82 STRW$ - the character string which repeated the data which is specified is returned 90 WADD$ - the character string which said the addition and subtraction vis-a-vis the character string is returned 90 WANDOR$ - the character string which said the operation with the AND and the OR vis-a-vis the character string is returned 91 WMUL$ - where the character string which said multiplication vis-a-vis the character string is returned 92 WXOR$ - where the character string which said the operation with the XOR vis-a-vis the character string is returned - File function 114 FILES$ - where it returns the character string of the file name which agrees retrieving the file -BG/ text / video type function 160 READCHR$ - where the pattern generator data is sent from the character picture 161 READHEX$ - where the character string of hexadecimal is converted to the character string of reading binary format from the data statement * Direct executive order and indirect executive order -------------- - Generality instruction 29 CLEAR - Guaranty of variable and initialization and user area and file area of stack 33 DIM - where dominant string variable is declared 25 END - End of program 36 ERROR - where generation of error is simulated 43 IFGOTO - deciding the conditional system which is specified, with the authenticity processing where it branches 44 IFTHENELSEENDUF - deciding the conditional system which is specified, with the authenticity processing where it branches 48 INPUT - where entry in the optional character string is accepted from the keyboard 51 INT - where the maximum integer value which does not exceed the ‚ tie which is specified is returned 54 LET - where value of the formula which is given to the right-hand side, is substituted to the variable of the left-hand side 55 LOCATE - where cursor position of the text picture is specified 56 LOCK - where interruption processing is prohibited ********* 57 where from the digit position which specifies the contents of MI D$ character variable, it replaces to the optional character string 59 NEXT - end of FOR looping processing 68 POKE - where the data is written to the address which user area specifies 69 PRINT - where character is displayed in the text picture 70 PRINTUSING - character is displayed with the format which is specified to the text picture 71 RANDOMIZE - Setting of random number system ********The 72#0101 which shows the start of the REM notes statement ' 72 where start of the notes statement is shown 74 RESUME End of error processing 76 RUN - where the program is executed 79 SKCLOSE - where the software keyboard is closed 83 SWAP - where contents of variable are replaced 85 UNLOCK - where interruption processing is permitted 88 USERDATA () - where status of instruction is returned 91 WIDTH - where the display screen of the text picture is set - File instruction 98 BLOADCLEAR - where the file is written to contents of the user area which is guaranteed in instruction 99 BSAVECLEAR - where it starts writing the contents of the user area which is guaranteed in instruction to the file 100 CLOSE - End of file access 100 FILES - Retrieving the file, where it displays the file name which exists 101 FORMAT - where the device which is specified is initialized 102 FREAD - where from file area the data is written to character variable 102 FWRITE - where the data is written to file area 103 GLOAD - where it loads to the logical BG which specifies the bit map data which is specified ************ 106 BG - the file name which specifies the bitmap data of the logical BG which is specified 106 GSAVE - where it writes out as the data ************ 108 KILL - where the file which is specified is deleted 108 LOAD - You read the program list and are dense 110 OPEN - where it prepares in order to read and write the data vis-a-vis the file 112 SEEK - where reading and writing position of the file is specified -BG/ text / video type instruction system 117 ACTIVE - Setting of default number of default logical BG 118 CCOPY - Transfer of the picture data of the rectangular area which deals with the character picture 120 CIRCLE - where a circle is drawn in the bit map picture 121 CLS - where the picture is erased 122 COLOR - where indicatory color and peripheral color et cetera of the picture are set 122 COLOROFSBG - where it colors the picture and the ƒX ply To picture 124 DISPLAYBG - where the ON/OFF of picture display is done 125 GCOPY - Transfer of the picture data of the rectangular area which deals with the bit map picture 127 KLOAD - where display of Chinese character is made possible 128 KPRINT - Display to bit map picture of Chinese character 132 LINE - where the straight line or rectangle is drawn in the bit map picture 133 MOSAICBG - where the mosaic is applied vis-a-vis the picture 134 PAINT - where it paints with the color which specifies the area of the bit map picture 136 PALETTE - Modification of pallet value 137 PRIORITY - where the precedence where the picture is displayed is set 139 PSET - where the point is displayed in the coordinate which the bit map picture specifies 139 PUTCHAR - Entry of pattern name craftsman/teacher data to character picture 142 ROTATE - where indicatory angle of the rotary picture is set 142 ROTCENTER - where central position of the rotary picture is set 143 ROTOVER - revolution area of surface display setting of part outside 144 ROTPOS - where distance to the center of the rotary picture is set from point of view 145 ROTZOOM - Zoom of rotary BG picture (ƒX The k ring) where it does Enlargement ratio to the respective direction of the surface of revolution is set. 146 SCREEN - Initialization of picture and setting of picture mode 151 SCROLL - usually scroll of the picture 152 SETCHR - where the pattern data which is used in the character picture is written 154 VSYNC - waits until the VSYNC the time when it specifies elapses 155 WINDOW - where the range which is drawn in bit map drawing instruction is specified 156 ZOOM - usually enlargement of the picture - ƒX ply To / 3 D instructions ******** 166 CAMERAOBJECT - The case where the camera is displayed setting of camera angle the position it is dense 167 PUTSPRITE - ƒX ply To is displayed ********* 169 SETDISP - It projects to the front which extent of the picture plane of the polygon which it sees. 169 SETLIGHT - where the illuminant is set 170 SETPERS - where it sets the angle of view of range of vision 170 SETFONT - where the character data of polygon is defined 172 SETPOLYGON - polygon surface group (the polygon surface list) where it defines ********** 174 SETSPRITE - where ƒX ply To is displayed ********** 175 SETVERTEX - where the apex group which is used with polygon is defined ********** 177 SPRITE$ - ƒX ply To's pattern definition 178 SPRWINDOW - where ƒX ply To, and the range which restricts the display of polygon are set *********** -OBJ instruction / function ******** 215 OBJATROBJECT - where the attribute ID and the polygon ID are specified to the OBJATROBJECT " Parentage " of the OBJLINKOBJECT 215 where it specifies " Relative position " from the OBJPOS parent OBJECT 216 where it specifies 216 OBJROT - From angle of the parent OBJECT relative " turning angle " 216 OBJTURN -where it specifies angle of the parent OBJECT relative " turning angle " 217 where it specifies 217 where the OBJTYPEOBJECT is specified 218 OBJZOOMOBJECT - Specifies the "Indicatory magnification ratio " 218 SETATR - where the attribute which is given to each surface of polygon is defined 222 SETTEX - where the texture is defined - Instruction related to sound ************ 252 BEEP - alarm is sounded. The ƒ\ƒ"ƒO number "0 " where the error sound which is registered is reset to default warning sound 253 BGMSETSONG - instruction, where the MML which is already registered to sound memory is sounded 254 DSP - where it controls DSP 256 EFFECTMML - Performs the music which is specified in the character string (effective sound) *********** 259 EGEG - (the envelope generator) the which sets parameter 263 LFOLFO - where it sets parameter The music which is specified in the PLAYMML character string (effective sound) it performs.Performance 1 instruction at a time ending Waiting 270 where it performs 272 PLAYCONTPLAYPAUSE - where the performance which is stopped at one time is reopened 273 PLAYFADE - using the sequence number which is specified, where it modifies the volume of the sound which it performs gradually 274 PLAYINIT - which initializes sound memory, modifies the block allotment of MML area 279 PLAYPAN - using the sequence number which is specified, where it modifies the generation direction of the sound which it performs 280 PLAYPAUSE - using the sequence number which is specified, where it stops the sound which it performs at one time 280 PLAYSTOP - using the sequence number which is specified, where it stops the sound which it performs 280 PLAYTEMPO - using the sequence number which is specified, where it modifies the speed of the sound which it performs 285 TARG - Rearrangement of timbre data, and register of original sound source 308 TLIST - where simple explanation of the timbre data file is displayed 309 TPROP() - where it rewrites the command of the timbre data 317 VOLUME - where volume is adjusted * Direct executive order, indirect executive order and fixed point type function -------------- -OBJ instruction / function ******* 181 Structural body for ƒX ply To display of OBJ 2 D and 3 D 0 (the OBJECT type:@TYPE) 187 where method of presentation of the OBJECT is specified 1 (the auxiliary flag:@FLAG) the case where the OBJECT is displayed 191 where operation is specified 2 (the OBJECT group:@GROUP) 192 where the group for collision decision of the OBJECT is specified 4 (the X position:@XP) from the parent OBJECT the XP (relative position (X coordinate)) 193 where it specifies 5 (the Y position:@YP) from the parent OBJECT the YP (relative position (the Y-coordinate)) 193 where it specifies 6 (the Z position:@ZP) from the parent OBJECT the ZP (relative position (Z coordinate)) 193 where it specifies 8 (the X angle of rotation:@XR) the XR of the OBJECT (the turning angle for the X axis) specification 194 9 (the Y angle of rotation:@YR) the YR of the OBJECT (the turning angle for the Y-axis) specification 194 10 (the Z angle of rotation:@ZR) the ZR of the OBJECT (the turning angle for the Z axis) specification 194 12 (the X scale:@XS) the XS of the OBJECT (magnification ratio of X axial direction) 194 where it specifies 13 (the Y scale:@YS) the YS of the OBJECT (magnification ratio of Y-axis direction) 194 where it specifies 14 (the Z scale:@ZS) the ZS of the OBJECT (magnification ratio of Z axial direction) the 194#0101 which is specified 16 (the attribute ID number:@ATR) the ATR (ƒX ply To and the ID number of surface information of polygon which are produced in SETATR instruction ) 196 where it specifies 17 (the polygon ID number:@POLYGON) the POLYGON (position information ID number of the polygon which produces in SETPOLYGON instruction) 196 where it specifies 18 (the portable rotational transform sequence:@ORDER) the ORDER (conversion sequence of 3 DOBJECT) 196 where it specifies 19 (the indicatory time:@TIME) indicatory time of the OBJECT (the TIME) 197 where it specifies 24 (the X speed:@XV) the value which is added to the X coordinate of the OBJECT (XV) 205 where it gives 25 (the Y speed:@YV) the value which is added to the Y-coordinate of the OBJECT (the YV) 205 where it gives 26 (the Z speed:@ZV) the value which is added to the Z coordinate of the OBJECT (the ZV) 205 where it gives 28 (the X accelerating:@XA) X speed of the OBJECT (XV) the acceleration which is added (the XA) 206 where it gives 29 (the Y accelerating:@YA) Y speed of the OBJECT (the YV) the acceleration which is added (the XA) 206 where it gives 30 (the Z accelerating:@ZA) Z speed of the OBJECT (the ZV) the acceleration which is added (the XA) 206 where it gives In order 32 (the X speed limiter:@XL) X speed of the OBJECT (XV) for absolute value not to exceed this value, 207 where it specifies In order 33 (the Y speed limiter:@YL) Y speed of the OBJECT (the YV) for absolute value not to exceed this value, 207 where it specifies In order 34 (the Z speed limiter:@ZL) Z speed of the OBJECT (the ZV) for absolute value not to exceed this value, 207 where it specifies 36 (the X rotary speed:@XRV) the XR of the OBJ (the turning angle for the X axis) 208 where the value which is added is given 37 (the Y rotary speed:@YRV) the YR of the OBJ (the turning angle for the Y-axis) 208 where the value which is added is given 38 (the Z rotary speed:@ZRV) the ZR of the OBJ (the turning angle for the Z axis) 208 where the value which is added is given 48 (4 point specified ƒX ply To apex X0:@X P0) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 49 (4 point specified ƒX ply To apex Y0:@Y P0) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 50 (4 point specified ƒX ply To apex X1:@X P1) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 51 (4 point specified ƒX ply To apex Y1:@Y P1) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 52 (4 point specified ƒX ply To apex X2:@X P2) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 53 (4 point specified ƒX ply To apex Y2:@Y P2) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 54 (4 point specified ƒX ply To apex X3:@X P3) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 55 (4 point specified ƒX ply To apex Y3:@Y P3) 2 D ƒX ply To's of TYPE= 3 display (4 point specifications) 209 where position is specified 60 (the specified:@GTEST of the collision decision group) the collision decision group ‚» 211 where it specifies 61 (the radius:@RADIUS for contact decision) 212 where radius of the collision which is used with the GTEST is specified * Direct executive order ------------- - Generality instruction 31 CONT - reopening the program which is discontinued 33 DELETE - where the program list of specified line is deleted 34 EDIT - where variable of the program list is done 37 FIND - Seeking string or programming where the character string is retrieved 55 LIST - where the program list is displayed 58 NEW - where the program list is erased from memory 73 RENUM - Re-allocation of line numbers - File instruction 111 SAVE - where the program list is retained * Indirect executive order --------- - Generality instruction 31 DATA - where it defines constant as the data 41 GOSUB - where subroutine processing is accessed 41 GOTO - where it moves to the forefront of the line which is specified 51 INTERVAL - where the interval timer is set 59 ONERRORGOTO - where error processing program is specified 60 ONGOSUB - where the subroutine which responds to the value of system is returned 61 ONGOTO - where it moves to the forefront of the line which responds to the value of system 62 ONINTERVAL - where the processing which is accessed with the interval timer interruption is set 63 ONRESTORE - where position of the data which is loaded the by the value of the numerical system which is specified, is specified 64 ONTIMER - where the processing which is accessed with the countdown timer interruption is specified 72 READDATA - where the data which is defined at amount is read out 73 RESTORE - Specification of data read-out position 74 RETURN - Carriage return from subroutine processing 80 STOP - execution of the program is discontinued 94 TIMER - where the countdown timer is set 86 USRDATA - Using user area, where it accesses DATA statement format - Instruction related to sound *********** 260 ONMMLSTATGOSUBMML - Control command of the (you monitor "!") with the interruption, when value returns, you execute 269 SETSONGDATA - The where bull program is set Batching converting the MML which is defined in the statement, where it registers to sound memory Note * It specified the part of the explanation that the " logical BG " with it has rewritten " < the logical BG> " and so on, it is specified with option.* As for MML another text * It creates side width with half angle 100 character (C)1998 Asciicorp./bitslaboratory/espinc.