Skip to content

Class

ObjectPlacementSpanGhosts3D

Generated GDScript class reference for GridPlacement.ObjectPlacementSpanGhosts3D.

Status
Draft
Version
v6.0
Updated
Development docs generated from GDScript source

This is unreleased documentation in active development. APIs, class names, and behavior may change before the final release.

Pooled drag-span ghost pass for [ObjectPlacementService3D]. One pooled ghost per candidate of a CELL or EDGE drag span, tinted from the verdicts the release follows, plus the shared machinery both span paths need: pool preparation, the per-ghost pose/tint/track step, and the tail that hides the surplus ghosts and publishes the span's validity. This lives outside the service because it is presentation over an already resolved candidate set, never authority: the service still owns validation, the ghost, the tint, the contact ring, and the preview cell/mount it writes. The service's [method ObjectPlacementService3D.update_preview_cell_span], [method ObjectPlacementService3D.resolve_cell_span] and [method ObjectPlacementService3D._update_preview_edge_span] delegate here. Before this pass existed, a CELL LINE/RECTANGLE drag left only the single cursor ghost in place, so the preview showed one object where the release stamped a whole run. CELL and EDGE now share one implementation, so neither path can drift back into previewing less than it commits.

Source: addons/grid_placement/systems/building/3d/object_placement_span_ghosts_3d.gd

Syntax

class ObjectPlacementSpanGhosts3D extends RefCounted

Members

NameKindSummary
preview_cell_spanMethod
entryProperty
validsProperty
all_validProperty
cellProperty
validProperty
validationProperty
ghostProperty
preview_edge_spanMethod
entryProperty
validsProperty
all_validProperty
cellProperty
edgeProperty
ghostProperty
posedProperty
issuesProperty
validProperty
resolve_cell_spanMethod
resultsProperty
entryProperty
ghostProperty