Ignition was created as an attempt to simplify the command syntax of TI-Basic, but also poke fun at the person who requested it. the final product was a Programming Language that uses about 15 commands. It happens to be usable, but is pointless to code in.
The Interpreter, otherwise known as the IILE (Ignition Interpreted Language Engine), is what interprets Ignition Code. you need to supply it with the starting point of the code. this is usually handled by an external shell or another program.
All Ignition code is treated as string data (unless math operators are used, but output is returned back to a string), accessible through comments. data must be loaded into 1 of 3 temporary variables, which could be thought of as non-destructive assembly registers.
Any Ignition code begins with "Igni", and customarily ends with a Quit command. The beginning snippet ensures to the Ignition interpreter that the code being read is Ignition code. The final Quit command ensures proper end-of-file execution (as the current engine is likely to continue running past the end of the file, resulting in garbage (or a crash, for the TI-Basic implementation of the engine)). also, you can optionally include a "Name:xxx" and "Type:xxx" after the Igni header, though currently these tags are ignored.
Ignition programming etiquette
Ignition code should begin after the header and a starting label, most often ":Start". Data should come after all code execution, at the bottom of the document. the final data tag should be ":EOF", and Quit on the next line. Ignition can handle excessive new lines, but whitespacing will cause the code to be skipped, as commands and arguments are literal matches in the engine.
there are only a few executable commands and tags.
Creates a Label, similar to the Batch Label naming. in this case, you created a Label called xxx. Labels arent indexed, so jumping to one in a lengthy program can be a tad bit slow.
Jumps to the first declared label "xxx". Label searching begins from the start of the code.
Compares Var1 to Var2. If they are not the same, the interpreter skips the next line. otherwise, execution occurs as normal.
Loads the data in the line after label xxx into Var1.
Loads the data in Var# and stores it into Var#.
Loads the data from Var1 and places it in the line after label xxx. data is overwritten.
Wipes the screen of all contents.
Displays the string in Var1, and a new line.
Gets a string from the user. This data is stored into Var1.
Creates a random number between 0-#, and stores to Var1
Stops program execution.
Math ~some operator that is +,-,*,or /~
does simple math on Var1 and Var2, storing the results in Var1. If you need to use Var1 multiple times, you should store it to Var3 before using Math.
Currently, this does nothing, but an IILE in the works would allow for specific platform checking (as in "Platform:TI" returning true if the interpreter is run on a TI-83+/84+). If true, the interpreter skips the next line.
Currently, this does nothing, but an IILE in the works would allow for extensions to the programming language (perhaps making it useful). If the listed plugin is installed, then this returns true and skips the next line.
Currently, this does nothing, but an IILE in the works would allow for halting program execution for # program ticks.
Currently, this does nothing, but an IILE in the works would allow for switching between max processing speed(1) and snail speed(2)(about the speed that the TI-Basic-based interpreter processes Ignition code).
Exec xxx (xxx)
Currently, this does nothing, but an IILE in the works would allow for the current program to close and execution of another program to begin. an optional argument allows for automatic label searching, so it would jump directly to that label after opening the program.
The following are tags, and dont effect program execution:
This is essentially the program header. If you load a program into the Ignition interpreter, and this is not the first line of that program, then execution will not occur.
Currently, this does nothing, but a planned Ignition program shell would allow Ignition programs to have long (<8 character) names using this tag after the program header.
Currently, this does nothing, but a planned Ignition program shell would allow Ignition programs to have descriptions using this tag after the name tag.
Igni Name:Hello World Type:Other :Start Load Var1,Message Print Quit :Message Hello World! :EOF Quit
Random Number Guessing Game
Igni Name:Guess My Number Type:Game :Start Clear Rand 10 Swap Var1,Var2 :Game Load Var1,Msg1 Print Load Var1,Msg2 Print Input Comp Jump Win Load Var1,MsgLose Print Jump Game :Win Load Var1,MsgWin Print Quit :Msg1 Guess My Number :Msg2 Any Number 1-10 :MsgWin You Won! :MsgLose Try Again :EOF Quit
- Forum for Ignition and updates
- #Ignition on irc.efnet.net