Differences

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

Link to this comparison view

Both sides previous revision Previous revision
multi-line_text [2015/10/20 13:01]
gds [Multi-line Text]
multi-line_text [2015/10/20 13:09] (current)
gds
Line 12: Line 12:
 == Text Importer Rules == == Text Importer Rules ==
  
 +The text importing process can be customized through the use of text processing rules defined in the last section of the parameter configuration UI.
  
 +Each entry in the list has text fields to specify a UTI (uniform type identifier),​ a space-separated list of file extensions, and a reference to a text processing rule, stored as a file in the product’s **Assets**.
  
 +When a text file is imported by the user, FxFactory will evaluate rules in the list until it finds a match. The conditions for matching a rule to a given file are evaluated from left to right, and they are increasingly restrictive:​
 +  - If a UTI has been provided, the rule will be applied only if the imported file matches that type. Leave the UTI field empty if the rule should be applied to any imported file.
 +  - If a list of space-separated file extensions has been provided, the rule is applied only if the file has one of those extensions. Leave the “File Extensions” value empty to have the rule applied regardless of the file extension.
 +
 +It is best to have no rules with overlapping/​conflicting criteria, because the list is evaluated in no guaranteed order, and only the first matching rule is applied.
 +
 +Currently, only **XSLT** files (ending with the "​.xsl"​ extension) can be selected for the **Rule Asset** value. XSLT (Extensible Stylesheet Language Transformations) defines a standard for manipulating XML documents to generate other XML documents, HTML, plain text, etc.
 +
 +[[https://​en.wikipedia.org/​wiki/​XSLT|XSLT on Wikipedia]]
  
 ==== On-screen Control ==== ==== On-screen Control ====
  
 Multi-line text parameters are available via on-screen UI in Final Cut Pro X and Motion 5. By default, a single button lets the user choose edit the text associated with the parameter. Users can hold down the Option key to import an existing text file instead. Multi-line text parameters are available via on-screen UI in Final Cut Pro X and Motion 5. By default, a single button lets the user choose edit the text associated with the parameter. Users can hold down the Option key to import an existing text file instead.
Trace: