Builders API The builders module provides the names used by objects.create_object(), aliases for ergonomic naming, layout constants, and standard builder registration.
Method Method How to use it Why it exists builders.register_standard() -> int Call once after engine.init() and before creating objects. Registers every built-in native builder with the current engine registry.
Constant Native Builder Name Why / Use builders.CANVAS CanvasBuilder Free-draw surface for pixels, primitives, text, buffers, and sprites. builders.CHOICE ChoiceBuilder Selectable option list. builders.INPUT InputBuilder Single-line text input. builders.PROGRESSBAR ProgressBarBuilder Progress bar widget. builders.TEXT TextBuilder Inline text label/content. builders.BOX BoxBuilder Framed box container. builders.DIVIDER DividerBuilder Horizontal or vertical divider. builders.BADGE BadgeBuilder Compact badge label. builders.BUTTON ButtonBuilder Clickable and keyboard-activatable button. builders.TAG TagBuilder Chip-style tag label. builders.STATUS StatusBuilder Status label with semantic levels. builders.MENU MenuBuilder Interactive menu. builders.SCROLL_CONTAINER ScrollContainerBuilder Viewport-backed scroll container. builders.ROW RowBuilder Horizontal stack layout parent. builders.COLUMN ColumnBuilder Vertical stack layout parent. builders.SPLITPANE SplitPaneBuilder Two-pane split layout. builders.SPLIT_PANE SplitPaneBuilder Alias for SPLITPANE. builders.GRID GridBuilder Fixed/weighted grid layout. builders.CHECKBOX CheckboxBuilder Toggle checkbox. builders.LISTVIEW ListViewBuilder Viewport-backed selectable list. builders.LIST_VIEW ListViewBuilder Alias for LISTVIEW. builders.TEXTAREA TextAreaBuilder Multiline text area. builders.TEXT_AREA TextAreaBuilder Alias for TEXTAREA. builders.DIALOG DialogBuilder Modal dialog container.
Layout And Grid Constants Constant Value Why / Use builders.AXIS_NONE 0 No axis / unset orientation. builders.AXIS_HORIZONTAL 1 Horizontal orientation. builders.AXIS_VERTICAL 2 Vertical orientation. builders.JUSTIFY_START 0 Pack children at main-axis start. builders.JUSTIFY_CENTER 1 Center children on the main axis. builders.JUSTIFY_END 2 Pack children at main-axis end. builders.JUSTIFY_SPACE_BETWEEN 3 Distribute extra space between children. builders.ALIGN_START 0 Align children at cross-axis start. builders.ALIGN_CENTER 1 Center children on the cross axis. builders.ALIGN_END 2 Align children at cross-axis end. builders.ALIGN_STRETCH 3 Stretch children across the cross axis. builders.ALIGN_AUTO -1 Inherit/default child alignment. builders.GRID_TRACK_FIXED 0 Fixed-size grid track. builders.GRID_TRACK_WEIGHT 1 Weighted/flexible grid track.
Usage engine.init()
builders.register_standard()
scenes.init_scene('Main')
scenes.select_scene('Main')
uid = objects.create_object(builders.GRID, 'Main', 0.9, 0.6, 0.1, 0.05)
grid = objects.get_object_by_uid(uid)
objects.tuix_grid_set_columns(grid, [(builders.GRID_TRACK_WEIGHT, 1)])