{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"Concept","type":"text"}]},{"type":"paragraph","content":[{"text":"Most objects within a CHILI document inherit from ","type":"text"},{"text":"Document Object Model - DocumentBase","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - DocumentBase","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411951"}}]},{"text":". These objects are totally under CHILI's own control. To leverage the text rendering capabilities, however, we have chosen to implement some basic objects within our object model. The most important is the \"TextFlow\" object, containing the description of a running text and its formatting.","type":"text"}]},{"type":"paragraph","content":[{"text":"While this is used as the basic object for running texts, it is not a \"pure\" TextFlow implementation:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Not all properties of TextFlow are supported within the context of CHILI documents","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"A large amount of additional functionalities have been built around the basic text editing capabilities","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Lower on this page you can find a list of the supported properties (both basic and CHILI-extended). In addition to that, TextFrames, ViewPreferences, Story Editor and many more objects contain more settings to influence text editing within those contexts.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Uses","type":"text"}]},{"type":"paragraph","content":[{"text":"The three main uses for TextFlow objects in XML are:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On a ","type":"text"},{"text":"Document Object Model - TextFrame","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - TextFrame","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411930"}}]},{"text":" object:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"textFlow property","type":"text"}]}]}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"On a ","type":"text"},{"text":"FormattedText Variable","type":"text","marks":[{"type":"link","attrs":{"href":"https://chilipublishdocs.atlassian.net/wiki/spaces/CPDOC/pages/1412111/Variable+Settings#Formatted-Text"}}]},{"text":":","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"the \"value\" property can contain a string representing a TextFlow","type":"text"}]}]}]}]}]},{"type":"paragraph","content":[{"text":"See ","type":"text"},{"text":"TextFrame XML","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"TextFrame XML","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1413867"}}]},{"text":" and ","type":"text"},{"text":"Variables XML","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Variables XML","versionAtSave":"4"},"href":"/wiki/spaces/CPDOC/pages/1413860"}}]},{"text":" for more information.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"TextFlow","type":"text"}]},{"type":"paragraph","content":[{"text":"A TextFlow Object consists of XML describing the text and its formatting. It should contain at a minimum the following content:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

SOME TEXT

\n","type":"text"}]},{"type":"paragraph","content":[{"text":"In this structure, the \"TextFlow\" root node can contain multiple paragraph (\"p\") sub-nodes, and each paragraph can contain multiple span nodes.","type":"text"}]},{"type":"paragraph","content":[{"text":"Basic formatting","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"The formatting of each individual span can inherit values from the paragraph. Note that a span does NOT inherit values from a previous span (although this would be enforced internally if the user edits text formatting through the Editor which creates a new span)","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

15 points, 10 points, from paragraph20 points

\n","type":"text"}]},{"type":"paragraph","content":[{"text":"See lower for a list of the various formatting attributes","type":"text"}]},{"type":"paragraph","content":[{"text":"Special Characters","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Each span node can also contain \"br\" or \"tab\" nodes to indicate soft returns and tabs within the paragraph:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

SOMETEXT
Across multiple lines

\n","type":"text"}]},{"type":"paragraph","content":[{"text":"Custom Properties","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Paragraph and span nodes can contain any custom attribute as well. While these objects do not inherit from DocumentBase (and therefore can't have a \"privateData\" sub-node, any attribute not recognized during parsing will be maintained:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n

Some Text

\n","type":"text"}]},{"type":"paragraph","content":[{"text":"IMPORTANT NOTE, however: to prevent conflicts with internal naming (currently in use or to be added in the future), it is STRONGLY recommended to add a unique prefix to the attribute names","type":"text"}]},{"type":"paragraph","content":[{"text":"Unrecognized sub-nodes will be ignored and lost during serialization (and may in fact even cause errors within the Editor)","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ITextLayoutFormat","type":"text"}]},{"type":"paragraph","content":[{"text":"This object is mainly used as a placeholder for the various formatting options which are TextFlow specific (non-CHILI objects) of Character and Paragraph Styles. In both cases, a \"format\" property exists, which holds the various supported properties:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n\n","type":"text"}]},{"type":"paragraph","content":[{"text":"See lower for a list of the supporrted properties","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Property Overview","type":"text"}]},{"type":"paragraph","content":[{"text":"IMPORTANT NOTE: when a document is saved by CHILI Editor, other values may be added to the TextFlow or format in the document's XML. These should NOT be modified. They contain either values for internal use, or default values of the TextFlow which are not supported/tested within CHILI's context. When creating or updating the XML, you should only use the following list of properties.","type":"text"}]},{"type":"paragraph","content":[{"text":"Similarly, some property values may appear in other locations (eg: \"fontFamily\" might also be present in a paragraph node). While this would pose less of an issue, it is recommended to only apply them on the locations marked relevant below.","type":"text"}]},{"type":"table","attrs":{"layout":"full-width"},"content":[{"type":"tableRow","content":[{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"Name","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"p","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"span","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"ITextLayoutFormat","type":"text"}]}]},{"type":"tableHeader","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Description","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"fontFamily","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"A reference to a font within the document, using that font's family + \"_\" + style. ","type":"text"},{"type":"hardBreak"},{"text":"So, for , ","type":"text"},{"type":"hardBreak"},{"text":"the \"fontFamily\" in a textFlow should be \"Arial_Bold\". (see lower)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"fontSize","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"The font size. ","type":"text"},{"type":"hardBreak"},{"text":"Default = 12 ","type":"text"},{"type":"hardBreak"},{"text":"Value must be a number (points are assumed)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"baselineShift","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"The baseline shift of the characters. Valid values are: ","type":"text"},{"type":"hardBreak"},{"text":"- a number ","type":"text"},{"type":"hardBreak"},{"text":"- \"superscript\" ","type":"text"},{"type":"hardBreak"},{"text":"- \"subscript\"","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"color ","type":"text"},{"type":"hardBreak"},{"text":"my_color","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"Only \"color\", as an uint/hex value ","type":"text"},{"type":"hardBreak"},{"text":"The reference to the CHILI color is maintained ","type":"text"},{"type":"hardBreak"},{"text":"on the containing style as a separate property.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"The \"color\" and \"my_color\" properties should be combined in a textFlow, with: ","type":"text"},{"type":"hardBreak"},{"text":"- my_color containing the ID of the CHILI color (NOTE: gradient colors are not currently supported) ","type":"text"},{"type":"hardBreak"},{"text":"- color containing the uint/hex RGB display value of that color","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"my_characterStyle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"ID of the linked CHILI CharacterStyle (see lower)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"my_paragraphStyle","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"ID of the linked CHILI ParagraphStyle (see lower)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"lineHeight","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Matches the \"leading\" setting in the editor (Character Settings Panel) ","type":"text"},{"type":"hardBreak"},{"text":"Default = \"120%\" ","type":"text"},{"type":"hardBreak"},{"text":"Only percentage values are allowed","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"trackingRight","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Matches the \"tracking\" setting in CHILI Editor (Character Settings Panel) ","type":"text"},{"type":"hardBreak"},{"text":"Default = 0 ","type":"text"},{"type":"hardBreak"},{"text":"Value must be a number (points are assumed)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"textAlign ","type":"text"},{"type":"hardBreak"},{"text":"textAlignLast","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"par. style only","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Alignment of the text in a paragraph (and alignment of the last line of a paragraph) ","type":"text"},{"type":"hardBreak"},{"text":"Valid values are: ","type":"text"},{"type":"hardBreak"},{"text":"- left ","type":"text"},{"type":"hardBreak"},{"text":"- center ","type":"text"},{"type":"hardBreak"},{"text":"- right ","type":"text"},{"type":"hardBreak"},{"text":"- justify","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"typographicCase","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Matches the \"Case\" setting in CHILI Editor (Character Settings Panel) ","type":"text"},{"type":"hardBreak"},{"text":"Valid values are: ","type":"text"},{"type":"hardBreak"},{"text":"- default ","type":"text"},{"type":"hardBreak"},{"text":"- uppercase ","type":"text"},{"type":"hardBreak"},{"text":"- lowercase","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"paragraphSpaceBefore ","type":"text"},{"type":"hardBreak"},{"text":"paragraphSpaceAfter","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"par. style only","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Additional space (vertically) before and after the paragraph ","type":"text"},{"type":"hardBreak"},{"text":"Default = 0 ","type":"text"},{"type":"hardBreak"},{"text":"Value must be a number (points are assumed)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"textIndent ","type":"text"},{"type":"hardBreak"},{"text":"paragraphStartIndent ","type":"text"},{"type":"hardBreak"},{"text":"paragraphEndIndent","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"par. style only","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Indent settings (horizontal) for the paragraph. ","type":"text"},{"type":"hardBreak"},{"text":"These respectively match the following in CHILI Editor (Paragraph Styles Panel): ","type":"text"},{"type":"hardBreak"},{"text":"- Indent ","type":"text"},{"type":"hardBreak"},{"text":"- Left Margin ","type":"text"},{"type":"hardBreak"},{"text":"- Right Margin ","type":"text"},{"type":"hardBreak"},{"text":"Default = 0 ","type":"text"},{"type":"hardBreak"},{"text":"Value must be a number (points are assumed)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"direction","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"par. style only","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Text direction ","type":"text"},{"type":"hardBreak"},{"text":"Default = ltr ","type":"text"},{"type":"hardBreak"},{"text":"Valid values are: ","type":"text"},{"type":"hardBreak"},{"text":"- ltr ","type":"text"},{"type":"hardBreak"},{"text":"- rtl ","type":"text"},{"type":"hardBreak"},{"text":"for Left to Right and Right to Left text rendering","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"alignToBaseLine","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"par. style only","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"If set to \"true\", the paragraph will be aligned to the appropriate baseline grid ","type":"text"},{"type":"hardBreak"},{"text":"(from the TextFrame or Document)","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"id","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"For paragraphs: matches the \"tag\" setting in CHILI Editor (Paragraph Settings Panel) ","type":"text"},{"type":"hardBreak"},{"text":"Any string is valid","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"textOverprint","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"If \"true\", the text will be set to overprint when exporting to PDF","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"kerning","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"Mathes the \"Enable Kerning\" checkbox in CHILI Editor ","type":"text"},{"type":"hardBreak"},{"text":"Default = on ","type":"text"},{"type":"hardBreak"},{"text":"Valid Values are: ","type":"text"},{"type":"hardBreak"},{"text":"- on (or empty) ","type":"text"},{"type":"hardBreak"},{"text":"- off","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"lineThrough","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"If \"true\", the text has a strike-through effect","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"textDecoration","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"if \"underline\", the text has an underline effect","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[231.0]},"content":[{"type":"paragraph","content":[{"text":"ANY_CUSTOM_PROP","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[27.0]},"content":[{"type":"paragraph","content":[{"text":"yes","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[527.0]},"content":[{"type":"paragraph","content":[{"text":"no","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[986.0]},"content":[{"type":"paragraph","content":[{"text":"When serializing/deserializing a TextFlow, all other attributes are maintained ","type":"text"},{"type":"hardBreak"},{"text":"(see higher, under \"TextFlow\", for more details)","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"See ?","type":"text"},{"text":"Fonts XML","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Fonts XML","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1413857"}}]},{"text":" for more details on referencing fonts.","type":"text"}]},{"type":"paragraph","content":[{"text":"A color inside a TextFlow consists of two separate attributes:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"my_color: the ID of the CHILI color (in document/colors ), which can be CMYK, RGB, LAB, ...","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"color: the \"TextFlow\" value, which in XML can be either a hex value (\"#FF0000\") or a uint (0x12345). Google can help you convert hex to uint (and vice versa) in your development environment, if needed. This hex/uint value is the RGB representation of the color, used for display within the editor","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Note that setting references to CHILI Objects inside a TextFlow XML in itself is not always enough (currently) to also enforce the application of the various properties/settings of that referenced object. When setting my_color, my_characterStyle or my_paragraphStyle, the safest bet is to also apply the relevant applied settings of those liked objects (the \"color\" uint/hex value, and the various paragraph/character style format settings).","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"TextFormat Object","type":"text"}]},{"type":"paragraph","content":[{"text":"For internal purposes, and for use through the JavaScript API, there is a helper CHILI object which encapsulates most of the supported text properties (and where you can find some more documentation): ?","type":"text"},{"text":"Document Object Model - TextFormat","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - TextFormat","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411927"}}]},{"text":". This object is however NOT used to serialize/deserialize XML. So several differences exist:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"color/characterStyle/paragraphStyle/font can internally be set using CHILI object references, whereas that is NOT the case in XML (except using the matching \"my_XXX\" properties, as documented higher)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"various properties in TextFormat are of type \"unit\", whereas in a TextFlow or TextLayoutFormat, they are numeric (point) values. CHILI internally translates those values. See ?","type":"text"},{"text":"General XML Concepts","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"General XML Concepts","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1413855"}}]},{"text":" and ?","type":"text"},{"text":"Measurement Units","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Measurement Units","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1412014"}}]},{"text":" for more information on how you can perform these calculations yourself","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"textDecoration does not exist, but is replaced by a \"underLine\" boolean property","type":"text"}]}]}]}],"version":1}

Browser not supported