AnyaBasic 0.5.1: C:/Programming/doxygen/AnyaBasic/instructions.h File Reference

Detailed Description

Coding in AnyaBasic is as straightfoward as it can get. Just follow the instructions below...

1. Open you trusty code editor.

2. Type some code

     start
        print("hello world!")
     end

3. Save your file on the same directory as AnyaBasic.jar

4. Issue this command on the console:

     java -cp AnyaBasic.jar net.phatcode.rel.main.AnyaBasicMain filename.ext

Programmer's Guide

Programs should begin with the START keyword and end with the END keyword.
```
    start
        print(1)
    end
```

Code blocks should also begin with the START keyword and end with the END keyword.

    start
        Repeat(0 to 20 STEP 2)
        Start
            print(1)
            print(2)
        End
    end

Conditional contructs and Loop constructs support single statements and code blocks.
All of the IF-THEN-ELSE constructs below are equivalent.

    if( a < 10 ) then print(a)
    else print(b)

    if( a < 10 ) then 
        print(a)
    else 
        print(b)

    if(a < 10) then 
    start
        print(a)
    end
    else 
    start
        print(b)
    end

You need the START and END block to execute more than 1 statement in a loop or conditional.

    if( a < 10 ) then 
    start
        write("a = ")
        print(a)
    end
    else 
    start
        write("b = ")
        print(b)
    end

    while( x < 20 ) 
    start
        write("*")
        x = x + 1
    end

You can define and instantiate variables using the VAR keyword.

    start
        VAR x              #instantiates a number or string#
        VAR foo = "Rel"    #instantiates a string with a value of "Rel"#
        VAR bar = 10       #instantiates a number with a value of 10#
        VAR as[10]         #instantiates an array of ten elements#
        VAR bs[] = {"rel", "anya", "rose"}  #instantiates an array strings#
        VAR bs[] = {"rel", 0, 10}           #instantiates a combination array#
    end

Named user defined functions are defined using the TYPE keyword.
Member fields/variables are accessed using the dot(.) operator.

    start
        Type Vector2D       # Name of the type #
        start
            x = 0           # Member field with initialization# 
            y = 0
        end

        Vector2D v          # Initializes a typed variable# 
        Vector2D va[21]     # Initializes a typed array variable with 21 elements #
        Vector2D v2d[10][5] # Initializes a typed array variable with 10 rows and 5 columns #

        Var x = v.x         # assigns the value held by v.x to x #
        Var y = va[10].y    # assigns the value held by v[10].y to y #
    end

Function Var arguments are passed byval while arrays and types are passed byref.

    start
        Function add(a, b)
        Start
            return a + b
        End
        var a = 20
        var b = 30
        print(add(a,b))
    end

All variables are visible inside functions as long as they are declared before the function definition.

    start
        a = 42
        Function PrintA()
        Start
            Print(a)
        End
        PrintA()
    end

Arrays can be declared 2 ways.
Initialization with lists or an empty initialization where the elements are filled with 0's:

    start
        var numbers[] = {1,2,99,20.1}
        var strings[] = {"Anya", "BASIC","Relminator"}
        var empty[10]
        var array2d[5][20]  # 5 rows, 20 column array #
    end

Arrays can be hold both strings and numbers.

    start
        var combo[] = {"rel",1,"anya",2,"kobe",99,"Ginebra",20.1}
    end

This feature can be useful when trying to emulate types/structures.
vector3D(treat every element triplet as a type).

    start
        var vector3D[] = {1,1,1,2,2,2,3,3,3,4,4,4}
    end

PersonType(Name, Address, age).

    start
        var Person[] = {"Rel","Iloilo",41,"Anya","Zarraga",16,"Rose","Philippines",53}
    end

Variables can hold both strings and numbers. They can even be SWAPped with each other.

    start
        var a = 20
        var b = "Eric"
        SWAP(a,b)
    end

Associative Arrays(They are technically hashmaps).
Associative arrays only accepts Strings as keys in a Key:Value pair. Values can be anothing though.
In fact values can be arrays, types or functions. :)

    start
       Type Vec2D
       start
           x = 20
           y = 30
       end
       Vec2D v
       v.x = 45
       v.y = 23
       Var a[10][10]
       a[1][1] = "AnyaBasic"
       var map{:}               # This is how you declare Associative arrays #
       map{"rel"} = 999         # Put a number value #
       map{"anya"} = v          # Put a user defined type value #
       map{"Lilytte"} = a       # A 2D array this time #
       var x 
       x = map{"rel"}           # Retrieve a value #
       x = map{"anya"}
       print(x.x)
       print(x.y)
       var y = map{"Lilytte"}
       print(y[1][1])
       print(containsKey(map,"anya"))   # Check if a key is contained in the associative array #
       print(sizeOf(map))               # Print its size #
    end

Graphics functions can only be used after you initialize a graphics screen.
Only PNG image files are supported as of the moment.
Using any of the graphics commands before a screen gets initialized would result in an exception.

    Screen(800,600)
    while( !(KeyDown(1)) && !WindowClosed() ) 
     start 
         setColor(1,0,1,0.5) 
         drawString(0,0, format("%.2f",  timer()) ) 
         drawString(100,550,1,1,0,1,"RELMINATOR" ) 
         delay(14) 
         screenFlip() 
     end 
     exit(0)

Sound functions can only be used after you initialize the sound engine via SoundInit().
The sound engine only supports WAV files for now.
Using any of the sound commands before initializing the sound engine would result in an exception.
```
    soundInit()
    soundLoad("samples/sounds/bg.wav",1)
    soundPlay("samples/sounds/bg.wav")

    var a
    input(a)

    exit(0)
```

Comments should start and end with the character "#".

    start
        #
            This is a multi-line comment.
            Put something here... 
        #

        # ******************************
            This is a better looking 
            multi-line comment. 
            Put something here...
        #
        
        var a = 20   # This is a single line comment #
        
    end

File paths are relative to AnyaBasic.jar and not your codefile.

English -> Jejemon -> Tagalog equivalents

    print -> phr!nt -> ilimbag  
    
    write -> wr!t3 -> isulat 
    
    delay -> d3l4ey -> bagalan 
    
    input -> inp0wtz -> itakda 
    
    start -> szt4rt -> umpisa 
    
    end -> ehnd -> wakas 
    
    while -> wh!ll3 -> habang 
    
    if -> e!f -> kung 
    
    then -> th3n -> dapat 
    
    else -> ellsz3 -> pagiba 
    
    for -> fh0wr -> kada 
    
    to -> t0h -> hanggang 
    
    step -> szt3hp -> hakbang 
    
    repeat -> r3p34th -> ulitin 
    
    free -> fw33y -> palayain 
    
    function -> fuwnct!own -> gawain 
    
    type -> th4yph -> uri 
    
    return -> r3ht0hrn -> ibalik 
    
    exit -> bY3ph0exz -> paalamna 
    
    swap -> zw4hp -> ipalit 
    
    break -> bhr34k -> walangforever 
    
    var -> v4hr -> baryabol

Keycode values(taken from LWJGL)

 CHAR_NONE              0
 EVENT_SIZE             18
 KEY_0                  11
 KEY_1                  2
 KEY_2                  3
 KEY_3                  4
 KEY_4                  5
 KEY_5                  6
 KEY_6                  7
 KEY_7                  8
 KEY_8                  9
 KEY_9                  10
 KEY_A                  30
 KEY_ADD                78
 KEY_APOSTROPHE         40
 KEY_APPS               221
 KEY_AT                 145
 KEY_AX                 150
 KEY_B                  48
 KEY_BACK               14
 KEY_BACKSLASH          43
 KEY_C                  46
 KEY_CAPITAL            58
 KEY_CIRCUMFLEX         144
 KEY_COLON              146
 KEY_COMMA              51
 KEY_CONVERT            121
 KEY_D                  32
 KEY_DECIMAL            83
 KEY_DELETE             211
 KEY_DIVIDE             181
 KEY_DOWN               208
 KEY_E                  18
 KEY_END                207
 KEY_EQUALS             13
 KEY_ESCAPE             1
 KEY_F                  33
 KEY_F1                 59
 KEY_F10                68
 KEY_F11                87
 KEY_F12                88
 KEY_F13                100
 KEY_F14                101
 KEY_F15                102
 KEY_F2                 60
 KEY_F3                 61
 KEY_F4                 62
 KEY_F5                 63
 KEY_F6                 64
 KEY_F7                 65
 KEY_F8                 66
 KEY_F9                 67
 KEY_G                  34
 KEY_GRAVE              41
 KEY_H                  35
 KEY_HOME               199
 KEY_I                  23
 KEY_INSERT             210
 KEY_J                  36
 KEY_K                  37
 KEY_KANA               112
 KEY_KANJI              148
 KEY_L                  38
 KEY_LBRACKET           26
 KEY_LCONTROL           29
 KEY_LEFT               203
 KEY_LMENU              56
 KEY_LMETA              219
 KEY_LSHIFT             42
 KEY_LWIN               219
 KEY_M                  50
 KEY_MINUS              12
 KEY_MULTIPLY           55
 KEY_N                  49
 KEY_NEXT               209
 KEY_NOCONVERT          123
 KEY_NONE               0
 KEY_NUMLOCK            69
 KEY_NUMPAD0            82
 KEY_NUMPAD1            79
 KEY_NUMPAD2            80
 KEY_NUMPAD3            81
 KEY_NUMPAD4            75
 KEY_NUMPAD5            76
 KEY_NUMPAD6            77
 KEY_NUMPAD7            71
 KEY_NUMPAD8            72
 KEY_NUMPAD9            73
 KEY_NUMPADCOMMA        179
 KEY_NUMPADENTER        156
 KEY_NUMPADEQUALS       141
 KEY_O                  24
 KEY_P                  25
 KEY_PAUSE              197
 KEY_PERIOD             52
 KEY_POWER              222
 KEY_PRIOR              201
 KEY_Q                  16
 KEY_R                  19
 KEY_RBRACKET           27
 KEY_RCONTROL           157
 KEY_RETURN             28
 KEY_RIGHT              205
 KEY_RMENU              184
 KEY_RMETA              220
 KEY_RSHIFT             54
 KEY_RWIN               220
 KEY_S                  31
 KEY_SCROLL             70
 KEY_SEMICOLON          39
 KEY_SLASH              53
 KEY_SLEEP              223
 KEY_SPACE              57
 KEY_STOP               149
 KEY_SUBTRACT           74
 KEY_SYSRQ              183
 KEY_T                  20
 KEY_TAB                15
 KEY_U                  22
 KEY_UNDERLINE          147
 KEY_UNLABELED          151
 KEY_UP                 200
 KEY_V                  47
 KEY_W                  17
 KEY_X                  45
 KEY_Y                  21
 KEY_YEN                125
 KEY_Z                  44
 KEYBOARD_SIZE          256