Table of Contents

Enum ManipulationPhase

Namespace
MoonBark.GridPlacement.Core.Types
Assembly
MoonBark.GridPlacement.Core.dll

Phase states for manipulation operations. Represents the lifecycle progression of a manipulation operation from start to finish.

For the complete state machine diagram, see: docs/core/guides/application-state-pattern.md → State Machine Lifecycle

Guidance:

  • IsActivePhase(ManipulationPhase): Starting, Active, Finalizing
  • IsTerminalPhase(ManipulationPhase): Completed, Cancelled
  • CanCancel(ManipulationPhase): Starting, Active only

The phase is primarily managed by the manipulation system internally. UI and simulation code typically check IsActive on ManipulationApplicationState rather than inspecting the phase directly.

public enum ManipulationPhase
Extension Methods

Fields

Active = 2

Active preview mode. User is moving cursor/previewing. Target updates occur. This is the longest phase (typically 0.1–5 seconds).

Cancelled = 5

Manipulation cancelled by user (Escape key, right-click). Ghost removed, original restored. Terminal phase; next call to Start() required for new manipulation.

Completed = 4

Manipulation completed successfully. Entity moved/rotated/flipped/built. Terminal phase; next call to Start() required for new manipulation.

Finalizing = 3

Finalizing the manipulation. Ghost is being committed to world state. Brief transitional phase (one frame or less) before terminal state.

None = 0

No active manipulation. Initial state.

Starting = 1

Manipulation has been initiated. Ghost entity created, input capture enabled. Brief transitional phase before Active.