Sorry your browser is not supported!

---Math
Add VAR, INT/FLOAT : Will add the given int/float value to the given variable.
Sub VAR, INT/FLOAT : Will subtract the given int/float value from the given variable.


---Array commands
Dim array_name, arrary_size : will create an array or resize a currently existing array.
Undim array_name : will erase the given array and all of its contained data from memory.
@array_name, array_index : Can be used in a similarly to a vairable in the way that it will either return the stored data or, if used first, set the stored data of the given index in the given array.


---System
Do...loop : Code within do and loop will be run repeatedly, until the loop is exited.
For $VAR = INT to INT...Next $VAR : This works like an ordinary loop, only every loop the given variable which is initially set to the first INT given will be incremented by 1. When the variable reaches the second INT given, the loop will exit when it gets to Next.
Exit : This will exit the current loop.
End : This will immediately end the program.
If...Endif : Will execute the script within if the given if statement is true. An Else condition can be placed between If and Endif to run a script if the condition is false.
Message INT/FLOAT/STRING : Will dispay the given message in the form of a windows 'OK' dialog box. Handy for debugging.
Runiscript : Will run the initial script for entities within the current AGM level.
Runlscript : Will run the loop script for entities within the current AGM level.
Runescript : Will run the end script for entities within the current AGM level.
Updatedelta : Will update the delta value for the Delta() command.


---File
Write file INT, INT/FLOAT/STRING : This will write to the specified file the specified data.
Delete file String : This will delete the specified file.

---3D
Sync on : This will turn off automatic sync.
sync off : This will turn off user set syncs.
sync rate INT : This will define the maximum sync rate.
Sync : If sync has been activated via sync on, this will update the screen.
Set agm load distance FLOAT : This will set the AGM load distance. This is at 25 by default.
Set BBa FLOAT : This will set the distance that an object will be replaced by a billboard by multiplying the number given by that of the objects size.
Set BBb FLOAT : This will set the distance that a billboard will be deleted by multiplying the number given by that of the objects size.
Agm distance load : This will gradually load the objects of an AGM level based on their size and distance from the camera.
Load agm level STRING : This will load the given AGM level. If a level is currently open then it will be closed automatically.

--Camera
Mcc INT/FLOAT : This is a premade mouse to camera control function.
Position camera FLOAT, FLOAT, FLOAT : This will position the camera at the given xyz coordinates.
Move camera FLOAT : This will move the camera forward or backwards.
Xrotate camera FLOAT : This will rotate the camera by the value on the x axis.
Yrotate camera FLOAT : This will rotate the camera by the value on the y axis.
Zrotate camera FLOAT : This will rotate the camera by the value on the z axis.
Turn camera left INT, FLOAT : This will rotate the camera left by the given value.
Turn camera right INT, FLOAT : This will rotate the camera right by the given value.
Rotate camera FLOAT, FLOAT, FLOAT : This will rotate the camera by the given xyz angles.
Point camera FLOAT, FLOAT, FLOAT : This will point the camera towards the given xyz position.
Set camera range FLOAT, FLOAT : This will set the cameras near far range of visibility.
Backdrop on : This will activate the 3D backdrop.
Backdrop off : This will deactivate the 3D backdrop.
Color backdrop INT : This will set the backdrop color.
Fog on : This will turn fog on.
Fog off : This will turn fog off.
Fog distance FLOAT : This will set the fog distance.
Color fog : This will set the fog color.

--Object
Delete object INT : Will delete the specified object from memory.
Set build position FLOAT, FLOAT, FLOAT : This will set the default xyz position for all objects that are created/load.
Set build rotation FLOAT, FLOAT, FLOAT : This will set the default xyz rotation for all objects that are created/load.
Position object INT, FLOAT, FLOAT, FLOAT : This will position the specified object at the given xyz coordinates.
Move object INT, FLOAT : This will move the specified object forward or backwards.
Move object left INT, FLOAT : This will move the specified object left.
Move object right INT, FLOAT : This will move the specified object right.
Move object up INT, FLOAT : This will move the specified object up.
Move object down INT FLOAT : This will move the specified object down.
Xrotate object INT, FLOAT : This will rotate the specified object by the given value on the x axis.
Yrotate object INT, FLOAT : This will rotate the specified object by the given value on the y axis.
Zrotate object INT, FLOAT : This will rotate the specified object by the given value on the z axis.
Turn object left INT, FLOAT : This will rotate the specified object left by the given value.
Turn object right INT, FLOAT : This will rotate the specified object right by the given value.
Rotate object INT, FLOAT, FLOAT, FLOAT : This will rotate the specified object by the given xyz angles.
Rotateobjecttopoint INT, FLOAT, FLOAT, FLOAT, FLOAT : Will rotate the specified object towards the given xyz coordinates gradually, based on the given smoothness value at the end.
Point object INT, FLOAT, FLOAT, FLOAT : This will point the specified object towards the given xyz position.
Play object INT, FLOAT, FLOAT : This will play the specified object from the given frame to the second given frame.
Loop object INT, FLOAT, FLOAT : This will loop the specified object from the given frame to the second given frame.
Stop object INT : This will stop the specified object from playing its animation.
Set object frame INT, FLOAT : This will set the given object to the given frame.
Set object speed INT, FLOAT : This will set the given objects animation speed.
Set object visible INT : Will set the visibility for the current object. 1 for visible and 0 for not visible. An invisible object won't be picked up by the Objectundermouse command.
-Collision
Set object collision INT, INT : This will set the given objects collision on(1) or off(0).
Runcollision INT : Will calculate the collision for the given object and reposition it accordingly.
Runxintersections INT : Will calculate the collision for the given object on the x axis and reposition it accordingly.
Runyintersections INT : Will calculate the collision for the given object on the y axis and reposition it accordingly.
Runzintersections INT : Will calculate the collision for the given object on the z axis and reposition it accordingly.

---2D
Print INT/FLOAT/STRING : This will print the specified data to the set cursor position on screen.
Set cursor INT, INT : This will set the cursor for the print command.
Text INT, INT, INT/FLOAT/STRING : This will print the specified data to the screen at the at the specified x and y screen positions.
Position Mouse INT, INT : Will set the mouse position to that of the given X and Y screen position.
Set Mouse Visible INT : This will set the visibility of the mouse. 1 being visible and 0 being invisible.
Draw box INT, INT, INT, INT, INT, INT, INT, INT : Will draw a box from the given xy position to the given xy position. The additional values are for ethe colour of each corner.
Draw line INT, INT, INT, INT : Will draw a line from the given xy position to the given xy position.
Draw dot INT, INT, INT : Will draw a dot at the given xy position. The additional value is for the colour of the dot.

--Image
Delete image INT : Will delete the specified image from memory.
Draw image INT, INT, INT : Will display the specified image at the given xy screen position.

---Sound
Delete sound INT : This will delete the specified sound from memory.
Play sound INT : This will play the specified sound.
Loop sound INT : This will loop the specified sound.
Pause sound INT : This will pause the specified sound.
Stop sound INT : This will stop the specified sound.


---Music
Delete music INT : This will delete the specified music from memory.
Play music INT : This will play the specified music.
Loop music INT : This will loop the specified music.
Pause music INT : This will pause the specified music.
Stop music INT : This will stop the specified music.


--Client/Server
Net_Update : Will check for new messages and update the return commands in preperation for them.
Net_Send_String INT, STRING : Will send the given the string using the given INT as a label for the message type.
Net_Send_Position_XY_Y FLOAT, FLOAT, FLOAT : Will send the given XY coords and the Y angle of the clients object.
Net_Send_Position_XYZ_Y FLOAT, FLOAT, FLOAT : Will send the given XYZ coords and the Y angle of the client object.
Net_Send_Position_XYZ_XYZ FLOAT, FLOAT, FLOAT : Will send the given XYZ coords and the XYZ angles of the client object.


   ~~~   Functions that return a value   ~~~   




---Math
Rnd( INT ) : Will return a random number between 0 and the given number, including 0 and the given number in the calculation.
Rgb ( INT, INT, INT ) : Will convert the given red, green and blue values into one value, for use with commands like fog color.
Delta( INT/FLOAT ) : Will return the delta value of the given number. This can be used in conjunction with Updatedelta to ensure that objects or other entities are moved at the same speed, regardless of the FPS.


---Variable commands
var_switch_flag VAR : Will return the switched flag of the given variable.
var_min VAR, INT : will return the corrected value of the given variable based on the minimum number.
var_max VAR, INT : will return the corrected value of the given variable based on the maximum number.


---System
Timer$() : Will return the computers internal system time.
Screen fps() : Will return the current ammount of frames per second.

---File
File read( STRING ) : Will open the specified file for reading and return the number of the file.
File write( STRING ) : Will open the specified file for writing and return the number of the file.
File exist( STRING ) : Will return a 1 if the specified exists.
Read file( INT ) : Will return a line from the specified open file.

---3D

--Camera
Camera position x() : Will return the current position of the camera on the x axis.
Camera position y() : Will return the current position of the camera on the y axis.
Camera position z() : Will return the current position of the camera on the z axis.
Camera angle x() : Will return the current angle of the camera on the x axis.
Camera angle y() : Will return the current angle of the camera on the y axis.
Camera angle z() : Will return the current angle of the camera on the z axis.

--Object
Loadobject( STRING ) : Will load the specified object into memory and return its number.
Makebox( FLOAT, FLOAT, FLOAT ) : Will create a box using the given xyz values as size data and return its number.
Makecube( FLOAT ) : Will create a cube using the given vale as size data and return its number.
Makesphere( FLOAT ) : Will create a sphere using the given value as size data and return its number.
Makeplain( FLOAT ) : Will create a plain using the given value as size data and return its number.
Object position x( INT ) : Will return the current position of the specified object on the x axis.
Object position y( INT ) : Will return the current position of the specified object on the y axis.
Object position z( INT ) : Will return the current position of the specified object on the z axis.
Object angle x( INT ) : Will return the current angle of the specified object on the x axis.
Object angle y( INT ) : Will return the current angle of the specified object on the y axis.
Object angle z( INT ) : Will return the current angle of the specified object on the z axis.
Object screen x( INT ) : Will return the current position of the specified objects on the screens x axis.
Object screen y( INT ) : Will return the current position of the specified objects on the screens y axis.
Object collision( INT, INT ) : Will return a 1 if the specified objects are colliding with eachother.
Objectundermouse : Will return the number of the object currently undereath the cursor.
Returnxintersections( INT ) : Will calculate the collision for the given object on the x axis and reposition it accordingly. Will then return the value that the object has been moved by on the x axis.
Returnyintersections( INT ) : Will calculate the collision for the given object on the y axis and reposition it accordingly. Will then return the value that the object has been moved by on the y axis.
Returnzintersections( INT ) : Will calculate the collision for the given object on the z axis and reposition it accordingly. Will then return the value that the object has been moved by on the z axis.
Lineclear( FLOAT, FLOAT, FLOAT, FLOAT, FLOAT, FLOAT ) : Will check if the line from the given xyz to the second given xyz is blocked, and if so, the distance from the start of the line to the blockage is returned.
Objectlineclear( INT, FLOAT, FLOAT, FLOAT ) : Will check if the line from the given object to the given xyz position is blocked, and if so, the distance from the start of the line to the blockage is returned.
Objectslineclear( INT, INT ) : Will check if the line from the given object to the second given object is blocked, and if so, the distance from the start of the line to the blockage is returned.
Withinrange( FLOAT, FLOAT, FLOAT, FLOAT, FLOAT, FLOAT, FLOAT ) : Will return a 1 if the the given xyz position is within the second xyz positions range. The range to check for is the last float given.
Objectwithinrange( INT, FLOAT, FLOAT, FLOAT, FLOAT ) : Will check if the given object is within range of the given xyz position. The range to check for is the last float given.
Objectswithinrange( INT, INT, FLOAT ) : Will check if the given object is within range of the second given object by the range given. The range to check for is the last float given.
Distance(FLOAT, FLOAT, FLOAT, FLOAT, FLOAT, FLOAT) : Will return the distance from the first given xyz coordinates to the second.
Objectdistance(INT, FLOAT, FLOAT, FLOAT) : Will return the distance from the object to the given xyz coordinates.
Objectsdistance(INT, INT) : Will return the distance between the two given objects.
Pointingtoposition( INT, FLOAT, FLOAT, FLOAT, FLOAT ) : Will check if the given object is pointing towards the given xyz position by a certain angle range. The angle range to check for is the last float given.



---2D

--Text
asc( STRING ) : Will return the ascii number for the provided letter. If more than one letter is given, then the ascii number for the first letter will be returned.
chr$( INT ) : Will return the charater that the given ascii number represents.
Mid$( STRING, INT ) : Will return the the selected character from the given string.
Left$( STRING, INT ) : Will return the charaters from the left of the string up to the one specified.
Right$( STRING, INT ) : Will return the charaters from the right of the string up to the one specified.

--Image
Loadimage( STRING ) : Will load the specified image into memory and return its number.


---Sound
Loadsound( STRING ) : Will load the specified sound into memory and return its number.


---Music
Loadmusic( STRING ) : Will load the specified music into memory and return its number.


---Input
keystate( INT ) : Will return a 1 if the key for the given number is being pressed.
mouseclick( INT ) : Will return a 1 if the given mouse button is being pressed.
Mousex() : will return the position of the mouse on the screens 2D x axis.
Mousey() : will return the position of the mouse on the screens 2D y axis.
Mousemovex() : Will return the distance that the mouse has moved on the screens x axis since this command was last called.
Mousemovey() : Will return the distance that the mouse has moved on the screens y axis since this command was last called.


--Client/Server
Net_Connect STRING : Will connect to the given IP address. This should be the address of the server.
Net_Message_Type : Will return the current message type.
Net_Message_String : Will return the current message string.
Net_Message_Float : Will return the current message float.

backdrop on
sync on
sync rate 60

load agm level "temp.amp"

agm distance load

$movementspeed=7.0
$switch=0
$maxbounce=6.0
$bounce=0.0
$walknow=0
$camheight=75.0


rotate camera 270,0,0
move camera $camheight
rotate camera 0,0,0

do

`" Update variables"
$walknow=0
$mmx=mousemovex()
$mmy=mousemovey()

`" Debug info"
set cursor 10, 10
print "FPS: " + screen fps()
print "AGM simple environment test;"
print "Press [esc] when you're done."
print "Bounce: "+$bounce
print "Rotx: "+camera angle x()
print "Roty: "+camera angle y()

`" Bounce control (rest of code at end of loop!)"
if $bounce>=$maxbounce
$bounce=$maxbounce-0.1
$switch=1
endif
if $bounce<=0.0
$bounce=0.1
$switch=0
endif


`" Mouselook, with weirdness as a work around"
`" for strangely behaving 0's in current build of agm."
if camera angle y()+$mmx=0
yrotate camera 359.0
else
yrotate camera camera angle y()+$mmx
endif
if camera angle x()+$mmy=0
xrotate camera 359.0
else
xrotate camera camera angle x()+$mmy
endif


`" We steal from old people."
`" Walking, strafing. Stuff."
$oldx=camera angle x()
$oldy=camera angle y()

if keystate(17)=1
rotate camera 0,$oldy,0
move camera $movementspeed
rotate camera $oldx,$oldy,0
$walknow=1
endif
if keystate(31)=1
rotate camera 0,$oldy,0
move camera 1-$movementspeed-1
rotate camera $oldx,$oldy,0
$walknow=1
endif
if keystate(30)=1
rotate camera 0,$oldy-90.0,0
move camera $movementspeed
rotate camera $oldx,$oldy,0
$walknow=1
endif
if keystate(32)=1
rotate camera 0,$oldy+90.0,0
move camera $movementspeed
rotate camera $oldx,$oldy,0
$walknow=1
endif

`" BOUNCE CALCULATION"
`" We only bounce when we walk."
`" print 'REM' is used to comment out two"
`" functions as float handling is slightly borked"
`" in AGM atm, resulting in sinking rather"
`" than bouncing. >.>"
if $walknow=1
if $switch=0
$bounce=$bounce+0.1
rotate camera 90,0,0
print "REM move camera 0.1"
rotate camera $oldx,$oldy,0
endif
if $switch=1
$bounce=$bounce-0.1
rotate camera 270,0,0
print "REM move camera 0.1"
rotate camera $oldx,$oldy,0
endif

endif

`" Duhhhh."
sync
loop

This thread has up-to-date information on what gets fixed, changed, updated and added to AGE. Now you know what to expect for the next version and I actually keep a change log.

Changed 'updatedelta' command to 'update delta' - Also updated scripts to for next version.

Fixed bug where functions that return data would not get along well with the rest of the code due to empty brackets. You can now run code like 'camera angle y() + $random' with no errors.

Added 'draw timage' command. Works in same way as the 'draw image' command only it takes transparency in images to consideration. Requested by Planky for his menu system.

Added 'set screen', 'screen x()' and 'screen y()' commands. I hope the explanations make sense.
Set Screen $X, $Y, $Depth, $mode : This will set the display options for the AGE engine. $X is the width of the window or screen. $Y is height for the window or screen. $Depth sets the colour depth for the engine - usually 32 as this allows varying levels of transparency. A $mode setting of one will use a window at the given $X $Y size. A $mode setting of 1 will maximize the window with those settings, while a setting of 0 will make the engine run in fullsreen mode using the given $X and $Y as the resolution. It is recommended that the reolution and screen type is set before anything else takes place in the engine.
Screen X() : will return the current screen or window width.
Screen Y() : will return the current screen or window height.

Fixed bug where saving your project would not update the title bar. Now if you save a map called 'map.amp', your title bar will look like 'map.amp - AGE - Beta 2'.

Fixed bug where hitting return to make an object or entity without holding a mouse button down would not show the made object before using the mouse again. Now you can see the object as soon as it is made.

Added ability to define two build and select keys inside of config.ini file. The build key is still set to Return by default, and now the Enter key too. The select key is either Control button.

Fixed incredibly slow script and entity saving code. Now whenever you save or compile a script or entity, a special function is called to extract code from a string line by line, removing chr(13) and chr(10), enabling perfect saving of scripts and entities. I just saved a level with several objects and the rpg player entity in about half a second - great improvement on five seconds.

You can now select objects and entities, defaults button being either control. You can move, rotate and change the entity data of your selection. Pressing the build key (defaults to return) will produce a copy of your object in that position, as if your selected object is a brush. Selecting another object/entity or picking a new brush in the file trees will build your current selection where ever and however you left it. Pressing the delete key will remove your current selection.

There is now a 'ghost brush' checkbox in the bottom of the 'Level construction' window. It is selected by default (can be changed in the config.ini file). While active it will apply the ghost effect that to your brush object, allowing you to see what's behind it. When deselected it will show the object in its full non-ghosted glory.

There is now an 'angle brush' checkbox underneath the 'ghost brush' one. Off by default, can be set in the 'config.ini' file. It basically rotates the brush object to that of the canvas objects current vertex angle. Allows you to make grass look like it's coming out of the ground and walls that gradually decline with a hillside. Saves slowly rotating every object you place on a terrain to look right.

Added a load of new collision commands, all powered by Sparky's excellent DBP collision plugin. They allow for automatic sliding collsion using a sphere shaped collision method, returning of normal, position and slide data from any collision commands and general speed.

Font settings for the text editors in AGE can now be changed. You can set the font colour, back ground colour, size, whether or not you want it bold, and the font itself. This can all be handled inside the config.ini file.