PlaceableSelectionUI

Tabbed, grid-based UI for selecting placeables and sequences. Loads content from configured folders via PlacementAssetResolver and integrates with GridPlacementHost to enter placement mode on selection. Prefer instancing the shipped starter scene, which wires the required internal nodes: var selection_ui_scene = preload("res://templates/grid_placement_templates/ui/placement_selection/placeable_selection_ui.tscn") var selection_ui := selection_ui_scene.instantiate() as PlaceableSelectionUI selection_ui.placeables_folder = "res://my_placeables" selection_ui.category_profiles_folder = "res://my_profiles" selection_ui.fixed_template_height = 48 selection_ui.fixed_icon_size = 40 A custom scene must assign ui_root and tab_container before the node enters the tree.

Source: addons/grid_placement/ui/placeable/single/placeable_selection_ui.gd

Syntax

class PlaceableSelectionUI extends PlacementControl

Members

Name	Kind	Summary
valid_changed	Signal	Emitted when UI validity changes.
placeable_activated	Signal	Emitted whenever a placeable entry is clicked, including when read_only_catalog suppresses the built-in dispatch. 3D sessions listen to this.
category_selected	Signal	Emitted when the visible category changes or its tabs are rebuilt.
icon_single	Property	Icon for the single-cell tool button.
icon_line	Property	Icon for the line tool button.
icon_rectangle_fill	Property	Icon for the filled rectangle tool button.
icon_rectangle_outline	Property	Icon for the rectangle outline tool button.
category_profiles_folder	Property	Folder of category tag resources, loaded into category_profiles.
placeables_folder	Property	Folder of placeable resources, loaded into placeables.
sequences_folder	Property	Folder of sequence resources, loaded into sequences.
category_profiles	Property	Extra category tags combined with category_profiles_folder.
placeables	Property	Extra placeables combined with placeables_folder.
sequences	Property	Extra sequences combined with sequences_folder; variants cycle in one grid slot.
grid_columns	Property	Grid column count; 1 gives a single-column list.
placeable_entry_template	Property	Template for individual entries; a PlaceableView showing icon and name.
sequence_entry_template	Property	Template for sequence entries; a PlaceableListEntry that cycles variants.
fixed_template_height	Property	Fixed template height in pixels; 0 disables enforcement. Individual PlaceableView nodes may still enforce their own fixed_view_height.
fixed_icon_size	Property	Fixed icon width and height in pixels; 0 uses template defaults.
show_category_tab_names	Property	Whether category tab titles render; when false only icons/grid show.
hide_ui_on_selection	Property	Hides the UI after an item is selected.
read_only_catalog	Property	Renders catalog entries without entering placement mode on click. Use for demos whose placement pipeline does not yet support the entry type.
ui_root	Property	Root control shown and hidden as a whole.
tab_container	Property	Tab per category tag, each holding a grid of matching entries.
tool_shape_container	Property	Container for brush-shape buttons; null hides tool selection.
get_mode_state	Method
resolve_placement_dependencies	Method
resolve_placement_runtime	Method
rebuild	Method
clear	Method
set_active_placeable	Method
get_active_placeable	Method
clear_active_selection	Method
available_object_tools	Method
get_runtime_issues	Method