User Tools

Site Tools


jwlua:enigmastrings

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
jwlua:enigmastrings [2013/10/18 20:13]
jariw [Text Inserts]
jwlua:enigmastrings [2014/11/30 10:26] (current)
jariw [Fonts]
Line 4: Line 4:
  
 A double caret ''​^^''​ in an Enigma string will insert a single ''​^''​ to the printed text. A double caret ''​^^''​ in an Enigma string will insert a single ''​^''​ to the printed text.
 +
 +Only the text strings that support formatting are stored as Enigma strings in Finale. For example: a Staff name is an Enigma string, a Bookmark name is not.
 +
 +===== Examples =====
 +
 +Full Enigma string might look like this:
 +
 +| ''​^fontMus(Font0,​0)^size(24)^nfx(0)F''​ | "​mf"​ (mezzoforte) text expression marking using the category'​s default font name. |
 +| ''​^fontTxt(Times New Roman,​4096)^size(12)^nfx(2)subito ^fontMus(Font0,​0)^size(24)^nfx(0)p''​ | "​subito p" text expression (with font change before "​p"​) |
 +| ''​^font(Times New Roman,​4096)^size(12)^nfx(0)^title()''​ | A text with a "​title"​ text insert. |
 +===== Text Storage =====
 +
 +Enigma strings are saved to different text pools depending on the object data that requires the string. Text blocks use a different storage pool compared to text expressions,​ for example.
  
 ===== Fonts ===== ===== Fonts =====
Line 15: Line 28:
 === ^nfx(integer) === === ^nfx(integer) ===
  
-The font styles as a bit set coded as an integer. Use ''​FCFontInfo:​CreateEnigmaStyleString()''​ to get the string to use from an existing style.+The font styles as a bit set coded as an integer. Use ''​FCFontInfo:​CreateEnigmaStyleString()''​ to get the string to use from an existing style. The ''​FCFontInfo.EnigmaStyles''​ property can get/set the numerical style data directly in a FCFontInfo object.
  
 ''​^nfx(0)''​ would mean a plain font style. ''​^nfx(0)''​ would mean a plain font style.
 +
 +Other bit style numbers are:
 +^ Decimal ^ Hexadecimal ^ Font style ^
 +| 1 | 0x01 | Bold |
 +| 2 | 0x02 | Italic |
 +| 4 | 0x04 | Underline |
 +| 32 | 0x20 | Strikeout |
 +| 64 | 0x40 | Fixed font size |
 +| 128 | 0x80 | Hidden |
  
 === ^size(integer) === === ^size(integer) ===
Line 31: Line 53:
 | ''​^fontNum''​ | The category number font | | ''​^fontNum''​ | The category number font |
  
-In addition to using traditional font names (such as ^fontTxt(Times New Roman, 0)), these commands can also use a "​special"​ font name called ''​Font0'',​ that would represent the default category font (such as ''​^fontTxt(Font0,​0)''​).+In addition to using traditional font names (such as ''​^fontTxt(Times New Roman, 0)''​), these commands can also use a "​special"​ font name called ''​Font0'',​ that would represent the default category font (such as ''​^fontTxt(Font0,​0)''​).
 ===== Formatting ===== ===== Formatting =====
  
Line 41: Line 63:
 ===== Text Inserts ===== ===== Text Inserts =====
  
-These commands will insert special contents to the string:+These commands will insert special contents to the string. Some text inserts might not make sense for certain types of Enigma strings.
  
 | ''​^arranger()'' ​ | The arranger name text insert (defined in the File Info). | | ''​^arranger()'' ​ | The arranger name text insert (defined in the File Info). |
jwlua/enigmastrings.1382127181.txt.gz ยท Last modified: 2013/10/18 20:13 by jariw