{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"text":"XML Structure","type":"text"}]},{"type":"paragraph","content":[{"text":"Any item within a frames list of type \"shape\", corresponding to a ","type":"text"},{"text":"Document Object Model - ShapeFrame","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - ShapeFrame","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411915"}}]},{"text":" object:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n\n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"ShapeFrame XML","type":"text"}]},{"type":"paragraph","content":[{"text":"The main definition of a shape comes from its \"paths\" property (see lower). An important note is that when updating or creating such a frame through XML, you must:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Have all path points in positive coordinates (x/y), including if possible any bezier curves, and start one point at x=0, and one (or the same) at y=0","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Set the frame's width and height to the bounding coordinates (maximum x/y of any point, including any bezier curves)","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Ensure that the proportions of width/height match the proportions of the bounding coordinates of the path points","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"These same notes apply when editing the clippingPath of a TextFrame object, or the frameClippingPath of an ImageFrame.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Paths XML","type":"text"}]},{"type":"paragraph","content":[{"text":"The Paths XML corresponds to an object of type ","type":"text"},{"text":"Document Object Model - Paths","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - Paths","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411908"}}]},{"text":". This (hierarchically) contains:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Path items: ","type":"text"},{"text":"Document Object Model - Path","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - Path","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411903"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Path Points: ","type":"text"},{"text":"Document Object Model - PathPoints","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - PathPoints","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411905"}}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Path Point Items: ","type":"text"},{"text":"Document Object Model - PathPoint","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Document Object Model - PathPoint","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1411906"}}]}]}]}]}]}]}]}]},{"type":"paragraph","content":[{"text":"An individual Path Point has a \"type\" property (","type":"text"},{"text":"Editor Enumerations - PathPointType","type":"text","marks":[{"type":"link","attrs":{"__confluenceMetadata":{"isRenamedTitle":true,"linkType":"page","contentTitle":"Editor Enumerations - PathPointType","versionAtSave":"1"},"href":"/wiki/spaces/CPDOC/pages/1413814"}}]},{"text":"), where:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"line\" (the default) only requires x and y","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"\"bezier\" also requires controlLeftX, controlLeftY, controlRightX, and controlRightY","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"All coordinates of a path point are relative to its parent's topleft coordinate (eg a ShapeFrame). Starting a line in that corner would be x=0 and y=0","type":"text"}]},{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Important update if you create/modify path points of shape frames in the XML!","type":"text"}]},{"type":"paragraph","content":[{"text":"From version 2021.0.0.8/6.3.0.6 onwards, frames for which the path bounds and frame bounds are not aligned will be moved/resized to get them aligned. The paths are not touched, but the frames are updated. This means that visually there will be no difference, but it could impact your document if other frames are anchored to the updated frames.","type":"text"}]},{"type":"paragraph","content":[{"text":"The path bounds and frame bounds are always aligned for shape frames created by CHILI publisher, so frames will only be updated if you create/modify path points of shape frames in the XML.","type":"text"}]}]}],"version":1}

Browser not supported