Scatter Placement

About

• Header File: tool_system_hybrid/description/toolscatterplacement.h
• Description Category: Tools. An interactive tool. See Active Tool.

Parameters

Parameters are accessed with C4DAtom::GetParameter()/ C4DAtom::SetParameter(). See page_maxonapi_getting_started_foundations_cinema_parameters.

---

Parameter: Mode

• Parameter ID: TOOL_MODE_INTERACTION
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Add (TOOL_MODE_SCATTER)
  • Remove (TOOL_MODE_ERASE)

---

Parameter: Radius

• Parameter ID: TOOL_PLACEMENT_OUTER_RADIUS
• Parameter Type: maxon::Float (Basic Data Types)

---

Parameter: Object Spacing

• Parameter ID: TOOL_EXCLUSION_RADIUS
• Parameter Type: maxon::Float (Basic Data Types)

---

Parameter: Use Splats

• Parameter ID: TOOL_USE_SPLATS
• Parameter Type: maxon::Bool (Basic Data Types)

---

Parameter: Splat Spacing

• Parameter ID: TOOL_INTER_SPLAT_SEP_DISTANCE
• Parameter Type: maxon::Float (Basic Data Types)

---

Parameter: Count

• Parameter ID: TOOL_PLACEMENT_ATTEMPTS_PER_SPLAT
• Parameter Type: maxon::Int32 (Basic Data Types)

---

Parameter: Density

• Parameter ID: TOOL_PLACEMENT_DENSITY
• Parameter Type: maxon::Float (Basic Data Types)

---

Parameter: Source

• Parameter ID: TOOL_MODE_OBJECT_SOURCE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Selection (TOOL_MODE_SOURCE_SELECTION)
  • Object Palette (TOOL_MODE_SOURCE_PALETTE)

---

Parameter: Random Order

• Parameter ID: TOOL_RANDOMIZE_ORDER
• Parameter Type: maxon::Bool (Basic Data Types)

---

Parameter: Seed

• Parameter ID: TOOL_RANDOM_SEED
• Parameter Type: maxon::Int32 (Basic Data Types)

---

Parameter: Align To

• Parameter ID: TOOL_MODE_ALIGN_TO
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Stroke (TOOL_MODE_ALIGN_STROKE)
  • Object (TOOL_MODE_ALIGN_OBJECT)

---

Parameter: Reference Point

• Parameter ID: TOOL_ALIGN_REFERENCE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Axis (TOOL_REF_AXIS)
  • Bounding Box (TOOL_REF_BOUNDINGBOX)

---

Parameter: Position Min/Max

• Parameter ID: TOOL_MIN_MAX_Y_OFFSET
• Parameter Type: maxon::Vector32 (Vectors)

---

Parameter: Rotation Range

• Parameter ID: TOOL_ROTATION_RANGE
• Parameter Type: maxon::Vector32 (Vectors)

---

Parameter: Scale Min/Max

• Parameter ID: TOOL_MIN_MAX_SCALE
• Parameter Type: maxon::Vector32 (Vectors)

---

Parameter: Show mouse region preview

• Parameter ID: TOOL_SHOW_PREVIEW_REGION
• Parameter Type: maxon::Bool (Basic Data Types)

---

Parameter: Show Placements

• Parameter ID: TOOL_SHOW_PLACEMENTS
• Parameter Type: maxon::Bool (Basic Data Types)

---

Parameter: Show Splat Regions

• Parameter ID: TOOL_SHOW_SPLAT_REGIONS
• Parameter Type: maxon::Bool (Basic Data Types)

---

Parameter: End Stroke

• Parameter ID: TOOL_BUTTON_END_SESSION
• Parameter Type: A button. See Attribute Manager Interaction