RAPTOR Basic - Latest Version

[+CyranoJ]

The latest version of RAPTOR Basic can be found on the Reboot website, at the following link:

Ver 0.1.8 - http://reboot.atari.org/new-reboot/binaries/RAPTOR_Basic_-_v0_1_8.zip

Ver 0.1.7 - http://reboot.atari.org/new-reboot/binaries/RAPTOR_Basic_-_v0_1_7.zip

Ver 0.1.6 - http://reboot.atari.org/new-reboot/binaries/RAPTOR_Basic_-_v0_1_6.zip

Ver 0.1.5 - http://reboot.atari.org/new-reboot/binaries/RAPTOR_Basic_-_v0_1_5.zip

Ver 0.1.4 - http://reboot.atari.org/new-reboot/binaries/RAPTOR_Basic_-_v0_1_4.zip

Included in the zipfile is:

• A copy of RAPTOR (minus the manual)
  
• A stripped down copy of U235 Sound Engine (with just the required files)
  
• RMAC/RLN - for assembling/linking the project
  
• VirtualJaguar - for testing
  
• An example RAPTOR Basic game
  

RAPTOR Basic requires assets to be imported using the _RAPPIXL.S and _RAPU235.S files, and RAPTOR Lists to be created using _RAPINIT.S.

For their full explanation please consult the RAPTOR API manual.

Your BASIC code should be placed in TEST.BAS. Run BUILD.BAT to make the project.

Please note: RAPTOR Basic is free, you can do what you want with it... however... RAPTOR API, U235 SoundEngine, VirtualJaguar and EhBASIC all have their own licences, and anything created with RAPTOR Basic must conform to these licences.

Enjoy, and happy coding everyone!

Update:

Matthias' Enhanced Basic manual is available here: http://atariage.com/forums/topic/232480-raptor-basic-calling-all-testers-and-programmers/?do=findComment&comment=3127460

RAPTOR Basic is based off Enhanced 68k BASIC 3.52.

A nice EhBasic manual can be located on the 6502.org forums, here: http://forum.6502.or...ile.php?id=1053 in this thread.

Along with a full set of commands from that version, we have added the following commands to interface it with RAPTOR and also provide some additional functionality.

RPRINT("STR",X,Y,FONTSIZE,INDEX)

This maps directly to the RAPTOR_print function - please see the RAPTOR documentation for description of use.

U235PAD(x)

This reads the state of the Jagpad specified (1 or 2) and returns a 32bit integer bitfield of the buttons held down - please see the U235 documentation for description on how to decode the returned result.

RGETOBJ(x,y)

This returns the RAPTOR Object field value for Object (x), offset (y) - For a list of offsets please consult the RAPTOR documentation.

RSETOBJ(x,y,z)

This sets the RAPTOR Object field value for Object (x), offset (y) with value (z) - For a list of offsets please consult the RAPTOR documentation.

RUPDALL(x)

• RUPDALL(0) - Update all objects NOW
  
• RUPDALL(1) - Enable Vertical Blank updating (auto updating each vbl, no need to RUPDALL inline)
  
• RUPDALL(2) - Disable VB Updating
  

RSETLIST(x)

This switches RAPTOR Lists to List (x) - Please consult the RAPTOR documentation for a description on Lists and List creation.

RHIT(w,x,y,z)

This calls the RAPTOR Collision Detection routines, with w and x being the source low and high Object IDs, and y and z being the low and high target IDs - please consult the RAPTOR documentation for further explanation.

U235MOD(x)

Plays the specified module file (x).

U235SND(x,y)

Plays the specified sound sample (x) on channel (y)

CLS

Clears the screen

SETCUR(x,y)

Positions the cursor at row x, column y.

LOCATE(x,y)

Returns the character at x,y in a string, eg A$=LOCATE(0,0)

COLOUR(x)

Set plot colour to colour x (0-15) - Colour is taken from the PARTIPAL.BMP file.

PLOT(x,y)

Plot a pixel of colour set by COLOUR(x) command at X,Y on the screen (x=0 to 319, y=0 to 200) - no bounds checking is performed.

RPARTI(IDX,x,y)

Fire off Particle Effect (IDX) at position (x,y)

RSETMAP(x,y)

Set the tilemap to position (x,y)

Edited December 18, 2014 by CyranoJ

[+CyranoJ]

v0.1.5:

 

Fixed bug in CLS - screen was cleared but cursor was not homed.

Fixed bug in LOCATE - result returned was one character to the left.

[+CyranoJ]

v0.1.6:

Added COLOUR(x) command.

Added PLOT(x,y) command.

[+CyranoJ]

v0.1.7:

 

RSETOBJ / RGETOBJ index values are relative to start of current list, not start of list 0

Memory increased to 128k

Inner interpreter loop optimized for extra speed

RBASIC now contained in an object file (RBASIC.O)

 

BUILD.BAT now accepts a file name - no longer forced ot use TEST.BAS (eg BUILD RALLY.BAS or BUILD PIXELS.BAS)

[+CyranoJ]

V0.1.8:

 

Project folders - Each project folder contains the four .S files plus projname.BAS - you build the projects with BUILD <projname> - eg, BUILD RALLY or BUILD TILEMAP

 

RUPDALL(x)

 

Modified command to take a parameter:

 

• RUPDALL(0) - Update all objects NOW
• RUPDALL(1) - Enable Vertical Blank updating (auto updating each vbl, no need to RUPDALL inline)
• RUPDALL(2) - Disable VB Updating

RPARTI(IDX,x,y)

 

Fire off Particle Effect (IDX) at position (x,y) - see SPRITES project for an example

 

RSETMAP(x,y)

 

Set the tilemap to position (x,y) - see the TILEMAP project for an example

 

NOTE: The BIN folder contains a 64bit version of VirtualJaguar - for 32bit systems please download and replace this file with the 32bit executable.

 

This will be the last update for a while, working on something with ggn

[+CyranoJ]

After a discussion today we have decided to focus purely on RB+ going forward, as such the above version of RB will be the final one.

 

Having two dialects of BASIC, when one is clearly more powerful and quicker than the other makes no real sense.

[sh3-rg]

Goodbye, Raptor BASIC. I never knew you, but you paved the way for what came later.

 

Farewell. RIP.