Opt-in 3D placement presentation: preview-ghost material response and a ground contact ring. Presentation only. A profile never changes validation, the resolved mount or transform, commit behavior, or save/restore semantics; it only changes how the existing authoritative preview is drawn. A null profile keeps the built-in validity tint and adds no extra visuals, so existing projects and the lightweight path are unchanged.
Source: addons/grid_placement/resources/presentation/placement_presentation_profile_3d.gd
Syntax
class PlacementPresentationProfile3D extends ResourceMembers
| Name | Kind | Summary |
|---|---|---|
ghost_alpha_scale | Property | Multiplies the settings valid/invalid color alpha for the preview ghost. |
ghost_detail_tint | Property | Blend of each ghost surface toward the validity color. 1.0 is a flat silhouette tint; lower values keep more of the authored material detail. |
ghost_valid_emission | Property | Emission added to valid previews (alpha is the energy multiplier; 0 disables). Keeps the ghost readable over dark, textured surfaces. |
ghost_blocked_emission | Property | Emission added to blocked previews (alpha is the energy multiplier). |
ghost_rim_strength | Property | Rim light strength (0 disables). A rim reads the piece silhouette against busy backgrounds without obscuring its surface. |
ghost_rim_tint | Property | How much the rim is tinted by the surface albedo (0 is white, 1 is albedo). |
enable_contact_ring | Property | Draw a ring on the ground under the footprint. Presentation only; it sits at the authoritative support height and never implies a different surface. Governs GRID previews; SMOOTH previews use the settings-level smooth_enable_contact_ring flag and share these colors and shape. |
ring_valid_color | Property | Ring color while the pending placement is valid. |
ring_blocked_color | Property | Ring color while the pending placement is blocked. |
ring_inner | Property | Inner radius fraction of the ring (0.78 leaves a 22% band at the edge). |
ring_softness | Property | Ring edge softness in UV units. |
ring_pad | Property | Extra radius beyond the preview's horizontal extent, in meters. |
ring_pulse_speed | Property | Pulse speed in radians per second; 0 disables the pulse. |
ring_pulse_amount | Property | Pulse depth as a fraction of ring alpha. |
ring_shader | Property | Optional custom ring shader. It must expose the `ring_color`, `ring_inner`, `ring_softness`, `pulse_speed`, and `pulse_amount` uniforms. |