CHARACTERS ---------- The following special characters are defined: # The hashtag is the default character for starting a command and is subsequently known as the command character or tintin character. When loading a command file the command character is set to the first character in the file. The character can also be redefined using #config. It's adviced not to redefine the command character. ; The semi-colon is used as the command separator and can be used to separate two commands. Multiple commands can be strung together as well. Trailing semi-colons are ignored when reading a script file as this is a common error. { } Curly brackets aka braces are used for seperating multi word command arguments, nesting commands, and nesting variables. Braces cannot be escaped using \{ \}, to escape { } use \x7B \x7D " " Quote characters are used for strings in the #math, #if, #switch, and #case commands. Instead of " " you can use an extra set of braces { } to define strings, this is suggested if you are expecting input to contain " characters. ! The exclamation sign is used to repeat commands, see #help history. The character can be redefined using #config. \ An input line starting with a backslash is send verbatim if you are connected to a server. This character can be configured with #config. SUBSTITUTIONS ------------- $&*@ All variable and function names must begin with an alphabetic character, followed by any number of alphanumeric characters and underscores. $ The dollar sign is used to retrieve the value of a variable. & The ampersand sign is used to retrieve the index of a variable. * The astrix sign is used to retrieve the name of a variable. @ The at sign followed by an alphanumeric string is used for functions. [ ] Brackets are used for nested variables which function as an associative array. Associative arrays are also known as tables and maps. Regex can be used within brackets to match multiple variables. Variables are ordered alphanumerically. + - The plus and minus sign is used to access variables by their index, with the first variable having index 1, and the last variable having index -1. %0- %99 The percent sign followed by a number is used for arguments by the following triggers: alias, action, button, delay, event, function, substitute, and tick. &0- &99 The ampersand sign followed by a number is used for arguments in the regex and replace commands. <000> Three alphanumeric characters encapsulated by the less- and greater- than signs are used for 4 and 8 bit color codes. <0000> Either a B (background) or F (foreground) followed by three hexadecimal characters encapsulated by < > signs are used for 12 bit color codes. Requires truecolor capable terminal. <0000000> Either a B (background) or F (foreground) followed by six hexadecimal characters encapsulated by < > signs are used for 24 bit color codes. Requires truecolor capable terminal. More information is available at #help color. \ The back slash is used to escape a character. All available options are listed at #help escape. Escapes are typically escaped when text leaves the client, by being send to a server, the shell, or being displayed on the screen. Escapes try to mimic escapes in PCRE when possible. \a 07 bell character. \t 08 horizontal tab character. \n 10 line feed character. \v 11 vertical tab character. \r 13 carriage return character. \e 27 escape character. \c 6 bit control character, \ca for ctrl-a. \x 8 bit character using 2 hexadecimal numbers. \u 16 bit unicode character, \uFFFD for example. \U 21 bit unicode character, \U02AF21 for example. All variables and functions can be escaped by doubling the sign, like $$variable_name or @@function_name. To escape a variable twice use $$$var_name. One escape is removed each time tintin needs to substitute a variable or function. All trigger arguments can be escaped by double the ampersand, like %%1. One escape is removed each time tintin substitutes trigger arguments. All command arguments can be escaped by doubling the ampersand, like &&1. One escape is removed each time tintin substitutes command arguments. COORDINATES ----------- When the 0,0 coordinate is in the upper left corner TinTin++ uses a y,x / rows,cols notation, starting at 1,1. Subsequently -1,-1 will indicate the bottom right corner. This type of argument is used by the #showme command. When the 0,0 coordinate is in the bottom left corner tintin uses a standard x,y notation. This type of argument is used by the #map jump command. SQUARES ------- A square argument takes 2 coordinates. The first coordinate defines the upper left corner, the last two coordinates define the bottom right corner. The upper left corner of the terminal is defines as 1,1 and the bottom right corner as -1,-1. This type of argument is used by #draw, #button and #map offset. PANES ----- A pane argument takes 4 size values, which are: top pane, bottom pane, left pane, right pane. When a negative value is provided the size is the maximum size, minus the value. This type of argument is used by the #split command. MATH ---- Operators Priority Function ------------------------------------------------ ! 0 logical not ~ 0 bitwise not * 1 integer multiply ** 1 integer power / 1 integer divide // 1 integer root % 1 integer modulo d 1 integer random dice roll + 2 integer addition - 2 integer subtraction << 3 bitwise shift >> 3 bitwise shift > 4 logical greater than >= 4 logical greater than or equal < 4 logical less than <= 4 logical less than or equal == 5 logical equal (can use regex) != 5 logical not equal (can use regex) === 5 string equal !== 5 string not equal & 6 bitwise and ^ 7 bitwise xor | 8 bitwise or && 9 logical and ^^ 10 logical xor || 11 logical or ? : The ? : symbols can be used for simple ternary operations. M,K,m,u These four metric suffixes are allowed for numbers. { } Braces can be used in #math to perform string operations. {a} > {b} This checks if the string "a" is greater than "b". , Commas in numbers are ignored, as well as spaces and tabs. . Dots can be used in #math to perform floating point calculations. The precision is set to the highest precision number used in the calculation. ( ) Braces can be used in #math to prioritize a calculation. STATEMENTS ---------- TT++ has the following commands which behave like statements. #break #case {value} {true} #continue #default {commands} #else {commands} #elseif {expression} {true} #foreach {list} {variable} {commands} #if {expression} {true} #loop {min} {max} {variable} {commands} #parse {string} {variable} {commands} #return {value} #switch {expression} {commands} #while {expression} {commands} REGEX ----- ^ force match of start of line. $ force match of end of line. \ escape one character. %1-%99 lazy match of any text, available at %1-%99. %0 should be avoided in triggers, and if left alone lists all matches. { } embed a raw regular expression, matches are stored to %1-%99. %!{ } embed a raw regular expression, matches are not stored. [ ] . + | ( ) ? * are treated as normal text unlessed used within braces. Keep in mind that { } is replaced with ( ) automatically unless %!{ } is used. Of the following the (lazy) match is available at %1-%99 %w match zero to any number of word characters. %W match zero to any number of non word characters. %d match zero to any number of digits. %D match zero to any number of non digits. %s match zero to any number of spaces. %S match zero to any number of non spaces. %? match zero or one character. %. match one character. %+ match one to any number of characters. %* match zero to any number of characters. %i matching becomes case insensitive. %I matching becomes case sensitive (default). ESCAPE ------ \a beep the terminal. \c send a control character, \ca for ctrl-a. \e start an escape sequence. \n send a line feed. \r send a carriage return. \t send a horizontal tab. \x print an 8 bit character using hexadecimal, \xFF for example. \x7B send the '{' character. \x7D send the '}' character. \u print a 16 bit unicode character, \uFFFD for example. \U print a 21 bit unicode character, \U02AF21 for example. \v send a vertical tab COLOR CODES ----------- with x, y, z being parameters Parameter 'x': VT100 code 0 - Reset all colors and codes to default 1 - Bold 2 - Dim 4 - Underscore 5 - Blink 7 - Reverse 8 - Skip (use previous code) Parameter 'y': Foreground color Parameter 'z': Background color 0 - Black 5 - Magenta 1 - Red 6 - Cyan 2 - Green 7 - White 3 - Yellow 8 - Skip 4 - Blue 9 - Default For xterm 256 colors support use to for RGB foreground colors and to for RGB background colors. For the grayscale foreground colors use to , for grayscale background colors use to . The tertiary colors are as follows: - Azure - Jade - Violet - Lime - Pink - Orange Example: #showme Azure Jade Violet Example: #showme Lime Pink Orange For 12 bit truecolor use to for foreground colors and to for background colors. For 24 bit truecolor use to for foreground colors and to for background colors. HELP ---- [ ] Argument is optional. < > Argument is required. { } Argument is literal. | Used to separate arguments with multiple options.