extension legend

From Wiki

Jump to: navigation, search
(anchors)
Line 3: Line 3:
 
<onlyinclude>
 
<onlyinclude>
 
*An asterisk (*) indicates an extension is undocumented (within this page)
 
*An asterisk (*) indicates an extension is undocumented (within this page)
*A "binary statement" means a representation of 1 or 0. It may be the Arabic numerals 1 or 0, yes or no, on or off, and some additional semantical operations not elaborated upon here.
+
*{{anchor|do}}A "binary statement" means a representation of 1 or 0. It may be the Arabic numerals 1 or 0, yes or no, on or off, and some additional semantical operations not elaborated upon here.
*A "string of text" means anything in your wildest imagination you can type into a text editor.
+
*{{anchor|text}}A "string of text" means anything in your wildest imagination you can type into a text editor.
*A "language and country code pair" is an [[ISO-639]] language code and [[ISO-3166]] country code pair. For example Sword of Moonlight's pair is ja_JP for Japanese in Japan.
+
*{{anchor|ll_CC}}A "language and country code pair" is an [[ISO-639]] language code and [[ISO-3166]] country code pair. For example Sword of Moonlight's pair is ja_JP for Japanese in Japan.
*A "real number" is Arabic digits with an optional decimal point. So named because they are the foil to "imaginary" numbers, even though there is nothing particularly real about a partial number. C style scientific notation will also probably work, but is not recommended.
+
*{{anchor|real|decimal}}A "real number" is Arabic digits with an optional decimal point. So named because they are the foil to "imaginary" numbers, even though there is nothing particularly real about a partial number. C style scientific notation will also probably work, but is not recommended.
*A "whole number" is Arabic digits no more no less. It can't represent a half of something for example.  
+
*{{anchor|whole|integer}}A "whole number" is Arabic digits no more no less. It can't represent a half of something for example.  
 
*A positive real or whole number excludes negative numbers (elusive evil twin anti-numbers).  
 
*A positive real or whole number excludes negative numbers (elusive evil twin anti-numbers).  
 
*Unless required to be positive, real and whole numbers can be made negative by adding a single minus (-) sign to the front. Effects may vary.
 
*Unless required to be positive, real and whole numbers can be made negative by adding a single minus (-) sign to the front. Effects may vary.
*As for "hexadecimal", see [[Hexadecimal]]. Numerals a~f must be lowercase.  
+
*{{anchor|hexadecimal|hex}} As for "hexadecimal", see [[Hexadecimal]]. Numerals a~f must be lowercase.  
*A "hexadecimal colour code" is a hexadecimal value (must be lowercase) which can include between 1 and 8 digits. Depending upon how many digits are provided the colour will be interpreted differently. Examples follow.<br/>
+
*{{anchor|color|colour}}A "hexadecimal colour code" is a hexadecimal value (must be lowercase) which can include between 1 and 8 digits. Depending upon how many digits are provided the colour will be interpreted differently. Examples follow.<br/>
 
1 digit colour is one of 16 predefined brushes. The brushes are the same as a Microsoft Window's [[cmd.exe]] console.<br/>
 
1 digit colour is one of 16 predefined brushes. The brushes are the same as a Microsoft Window's [[cmd.exe]] console.<br/>
 
2 digit colour is 4bit opacity + brush. Opacity ranges from 0 (fully transparent) to f (fully opaque).<br/>
 
2 digit colour is 4bit opacity + brush. Opacity ranges from 0 (fully transparent) to f (fully opaque).<br/>
Line 20: Line 20:
 
7 digit colour is not allowed.<br/>
 
7 digit colour is not allowed.<br/>
 
8 digit colour is 8bit opacity + 8bit RGB colour. Opacity ranges from 00 (fully transparent) to ff (fully opaque).<br/>
 
8 digit colour is 8bit opacity + 8bit RGB colour. Opacity ranges from 00 (fully transparent) to ff (fully opaque).<br/>
*A "keyboard key" is a context insensitive [[Direct Input Key]] code.
+
*{{anchor|key}}A "keyboard key" is a context insensitive [[Direct Input Key]] code.
*A "keyboard macro" is a context sensitive combination and or sequence of [[Direct Input Key]] codes. The codes can be a 2 digit hexadecimal number or the [[ASCII]] identifier with the DIK_ part not included. A complex macro syntax has not been forthcoming. Consequently only context-free single code macros can be described by the [[INI]] file for the time being. A keyboard macro can also be an alias. Refer to the [[#Action]] section for details.
+
*{{anchor|macro}}A "keyboard macro" is a context sensitive combination and or sequence of [[Direct Input Key]] codes. The codes can be a 2 digit hexadecimal number or the [[ASCII]] identifier with the DIK_ part not included. A complex macro syntax has not been forthcoming. Consequently only context-free single code macros can be described by the [[INI]] file for the time being. A keyboard macro can also be an alias. Refer to the [[#Action]] section for details.
*A "pseudo button" is a whole number greater than zero (0) representing the buttons on a human interface device or a virtual button when the number exceeds the number of buttons on a device. Game controllers use the [[Direct Input]] numbering shown in the [[Windows]] Control Panel. Non-button features, analog sticks and point-of-view hats for instance, are assigned pseudo buttons. Pseudo buttons are assigned keyboard macros.
+
**{{anchor|button}}A "pseudo button" is a whole number greater than zero (0) representing the buttons on a human interface device or a virtual button when the number exceeds the number of buttons on a device. Game controllers use the [[Direct Input]] numbering shown in the [[Windows]] Control Panel. Non-button features, analog sticks and point-of-view hats for instance, are assigned pseudo buttons. Pseudo buttons are assigned keyboard macros.
*A "synthetic font" is a description of a hybrid font constructed out of one or more typefaces assigned to one or more Unicode character ranges. At present when there are multiple typefaces they must be separated by commas. A typeface has four parts separated by spaces. Each part is optional.  
+
**{{anchor|font}}A "synthetic font" is a description of a hybrid font constructed out of one or more typefaces assigned to one or more Unicode character ranges. At present when there are multiple typefaces they must be separated by commas. A typeface has four parts separated by spaces. Each part is optional.  
 
#The first part is a scale factor in the form of a percentage. It must be a positive whole number including a percent sign, ie. ''120%'' scales the typeface by 120 percent.  
 
#The first part is a scale factor in the form of a percentage. It must be a positive whole number including a percent sign, ie. ''120%'' scales the typeface by 120 percent.  
 
#The second part is a number between 0 and 1000 that specifies the weight (or boldness) of the typeface. Sword of Moonlight uses 1000 or maximum boldness for its MS Mincho fonts.  
 
#The second part is a number between 0 and 1000 that specifies the weight (or boldness) of the typeface. Sword of Moonlight uses 1000 or maximum boldness for its MS Mincho fonts.  

Revision as of 04:02, 18 January 2013


  • An asterisk (*) indicates an extension is undocumented (within this page)
  • A "binary statement" means a representation of 1 or 0. It may be the Arabic numerals 1 or 0, yes or no, on or off, and some additional semantical operations not elaborated upon here.
  • A "string of text" means anything in your wildest imagination you can type into a text editor.
  • A "language and country code pair" is an ISO-639 language code and ISO-3166 country code pair. For example Sword of Moonlight's pair is ja_JP for Japanese in Japan.
  • A "real number" is Arabic digits with an optional decimal point. So named because they are the foil to "imaginary" numbers, even though there is nothing particularly real about a partial number. C style scientific notation will also probably work, but is not recommended.
  • A "whole number" is Arabic digits no more no less. It can't represent a half of something for example.
  • A positive real or whole number excludes negative numbers (elusive evil twin anti-numbers).
  • Unless required to be positive, real and whole numbers can be made negative by adding a single minus (-) sign to the front. Effects may vary.
  • As for "hexadecimal", see Hexadecimal. Numerals a~f must be lowercase.
  • A "hexadecimal colour code" is a hexadecimal value (must be lowercase) which can include between 1 and 8 digits. Depending upon how many digits are provided the colour will be interpreted differently. Examples follow.

1 digit colour is one of 16 predefined brushes. The brushes are the same as a Microsoft Window's cmd.exe console.
2 digit colour is 4bit opacity + brush. Opacity ranges from 0 (fully transparent) to f (fully opaque).
3 digit colour is a 4bit RGB colour. Each colour plane ranges from 0 (black) to f (saturated).
4 digit colour is 4bit opacity + 4bit RGB colour.
5 digit colour is not allowed.
6 digit colour is an 8bit RGB colour. Each colour plane ranges from 00 (black) to ff (saturated).
7 digit colour is not allowed.
8 digit colour is 8bit opacity + 8bit RGB colour. Opacity ranges from 00 (fully transparent) to ff (fully opaque).

  • A "keyboard key" is a context insensitive Direct Input Key code.
  • A "keyboard macro" is a context sensitive combination and or sequence of Direct Input Key codes. The codes can be a 2 digit hexadecimal number or the ASCII identifier with the DIK_ part not included. A complex macro syntax has not been forthcoming. Consequently only context-free single code macros can be described by the INI file for the time being. A keyboard macro can also be an alias. Refer to the #Action section for details.
    • A "pseudo button" is a whole number greater than zero (0) representing the buttons on a human interface device or a virtual button when the number exceeds the number of buttons on a device. Game controllers use the Direct Input numbering shown in the Windows Control Panel. Non-button features, analog sticks and point-of-view hats for instance, are assigned pseudo buttons. Pseudo buttons are assigned keyboard macros.
    • A "synthetic font" is a description of a hybrid font constructed out of one or more typefaces assigned to one or more Unicode character ranges. At present when there are multiple typefaces they must be separated by commas. A typeface has four parts separated by spaces. Each part is optional.
  1. The first part is a scale factor in the form of a percentage. It must be a positive whole number including a percent sign, ie. 120% scales the typeface by 120 percent.
  2. The second part is a number between 0 and 1000 that specifies the weight (or boldness) of the typeface. Sword of Moonlight uses 1000 or maximum boldness for its MS Mincho fonts.
  3. The third part is the name of a font. The name is embedded in a font file. Usually a file has more than one name per font stored in the file. For non-English non-Unicode fonts there is often an ANSI name using the native language of the font as well as an ASCII name. Names are sometimes permitted to be incomplete also. The name can be placed in double (") or single (') quotes to resolve ambiguities just in case, however it is probably unnecessary to do so, even if the name has spaces in it.
  4. The fourth part maps the typeface to one or more Unicode character ranges. It looks like U+0000-007F. In this example the typeface is mapped to characters 0 through 127 or the ASCII character range.