CESDK/CE.SDK/Engine/API Reference/Block
Types
Get to know all available block types and their properties
The following tables document the currently available blocks and their properties.
Block properties#
audio#
audio#| Member | Type | Default | Description |
|---|---|---|---|
Member fileURI | Type string | Default "" | Description A URI referencing an audio file. |
cutout#
cutout#| Member | Type | Default | Description |
|---|---|---|---|
Member offset | Type float | Default 0.0 | Description The offset from path at which to draw the cutout line. |
Member path | Type string | Default "" | Description The path string, accepts a subset of SVG path strings. |
Member smoothing | Type float | Default 0.0 | Description Pixel threshold by which to round out the path's corners. |
Member type | Type CutoutType | Default Default | Description The type of cutout line. |
graphic#
graphic#No block-specific properties.
group#
group#No block-specific properties.
metrics#
metrics#No block-specific properties.
page#
page#| Member | Type | Default | Description |
|---|---|---|---|
Member margin | Type OuterMargin2D(float left, float top, float right, float bottom) | Default OuterMargin2D(10.0) | Description Left, up, right, down page margins in local coordinates. |
Member marginEnabled | Type bool | Default false | Description Whether the bleed margin should be applied. |
Member titleTemplate | Type string | Default string("Page {{ubq.page_index}}") | Description Page title label template. Can include custom text and/or these template variables: {{ubq.page_index}}, {{ubq.separator}}, and {{ubq.name}}. The separator is automatically extended with spaces. |
stack#
stack#A convenience block, that overrides its childrens position and sorting order to bring them all in a single line along its axis. An optional spacing allows evenly spacing the items via additional elements. The stack relies on our layouting defaults: flex wrap: no wrap, align content: flex start, and align items: stretch
| Member | Type | Default | Description |
|---|---|---|---|
Member axis | Type uint enum : {'Horizontal', 'Vertical', 'Depth'} | Default Horizontal | Description The direction of the main stack axis, either horizontal or vertical. |
Member spacing | Type float | Default 0. | Description Adds an explicit spacing between the stacks children. This is only added between the "inner" children & doesn't add spacing towards the stacks outer edges. Negative spacing is not supported. |
Member spacingInScreenspace | Type bool | Default true | Description Whether to interpret the spacing value as pixels in screen space instead of design units. During export, the spacing is always interpreted in design units. |
text#
text#| Member | Type | Default | Description |
|---|---|---|---|
Member automaticFontSizeEnabled | Type bool | Default false | Description Whether the font size should be automatically determined to fit the entire text within the block's frame. |
Member clipLinesOutsideOfFrame | Type bool | Default true | Description Whether or not to display lines outside the frame. |
Member externalReference | Type string | Default "" | Description An external reference that may hint at the source that was used to populate fontFileURI |
Member fontFileUri | Type string | Default {} | Description The URI of a font file. |
Member fontSize | Type float | Default 10. | Description The font size in points. |
Member horizontalAlignment | Type uint enum : {'Left', 'Right', 'Center'} | Default Left | Description The horizontal text alignment. |
Member letterSpacing | Type float | Default 0.0 | Description Relative to the original spacing. |
Member lineHeight | Type float | Default 1.0 | Description The line height relative to the font size. |
Member maxAutomaticFontSize | Type float | Default -1 | Description The upper font size limit if the font size is automatically calculated. |
Member minAutomaticFontSize | Type float | Default -1 | Description The lower font size limit if the font size is automatically calculated. |
Member paragraphSpacing | Type float | Default 0.0 | Description The additional spacing between paragraphs relative to the font size. |
Member text | Type string | Default "" | Description The text content. |
Member verticalAlignment | Type uint enum : {'Top', 'Bottom', 'Center'} | Default Top | Description The vertical text alignment. |
track#
track#| Member | Type | Default | Description |
|---|---|---|---|
Member automaticallyManageBlockOffsets | Type bool | Default true | Description Whether the track should automatically remove gaps between its child blocks. |
scene#
scene#| Member | Type | Default | Description |
|---|---|---|---|
Member aspectRatioLock | Type bool | Default true | Description Wether the ratio of the pageDimensions' width and height should remain constant when changing either dimension. Example: A page of 400x300 with aspect ratio lock ON should be resized to 800x600 when the user sets its width to 800, to maintain the aspect ratio of 4/3. |
Member designUnit | Type DesignUnit | Default Pixel | Description The unit type in which the page values (size, distances, etc.) are defined. |
Member dpi | Type float | Default 300. | Description The DPI value to use when exporting and when converting between pixels and inches or millimeter units. For all of our purposes, this is synonymous with PPI. |
Member layout | Type SceneLayout | Default Free | Description A value describing how the scenes children are laid out. |
Member mode | Type SceneMode | Default Design | Description The mode of this scene and all elements inside of it. |
Member pageDimensions | Type Size2(float width, float height) | Default Size2(1, 1) | Description The dimension of all pages in this scene. |
Member pageFormatId | Type string | Default "" | Description The identifier of the page format configuration that was most recently selected for the pages in this scene. |
Member pixelScaleFactor | Type float | Default 1. | Description A scale factor that is applied to the final export resolution if the design unit is Pixel. |