ducpy.builders.block_utils

Functions

_get_base(element)
instantiate_block(...)	Creates an instance of a block at a specific position.

Module Contents

ducpy.builders.block_utils._get_base(element)

ducpy.builders.block_utils.instantiate_block(state: ducpy.classes.DataStateClass.ExportedDataState, block_id: str, position_x: float, position_y: float, instance_id: str | None = None) → ducpy.classes.DataStateClass.DucBlockInstance

Creates an instance of a block at a specific position.

This function: 1. Creates a DucBlockInstance metadata object. 2. Finds all elements associated with the block_id. 3. Clones those elements. 4. Updates their positions relative to the new insertion point. 5. Sets their instance_id. 6. Adds the cloned elements and the block instance to the state.

Args:

state: The ExportedDataState object to modify. block_id: The ID of the block to instantiate. position_x: The X coordinate for the instance insertion point. position_y: The Y coordinate for the instance insertion point. instance_id: Optional custom ID for the instance. If None, one is generated.

Returns:

The created DucBlockInstance object.