Units

About

• Header File: c4d_xtensions/description/prefsunits.h
• Description Category: Preferences. A preferences object. See GetWorldContainer().

Parameters

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

---

Parameter: Show Units

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

---

Parameter: Automatic Conversion

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

---

Parameter: Display

• Parameter ID: PREF_UNITS_BASIC
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Kilometers (PREF_UNITS_BASIC_KM)
  • Meters (PREF_UNITS_BASIC_M)
  • Centimeters (PREF_UNITS_BASIC_CM)
  • Millimeters (PREF_UNITS_BASIC_MM)
  • Micrometers (PREF_UNITS_BASIC_MICRO)
  • Nanometers (PREF_UNITS_BASIC_NM)
  • Miles (PREF_UNITS_BASIC_MILE)
  • Yards (PREF_UNITS_BASIC_YARD)
  • Feet (PREF_UNITS_BASIC_FOOT)
  • Inches (PREF_UNITS_BASIC_INCH)

---

Parameter: Animation

• Parameter ID: PREF_UNITS_ANIMATION
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Frames (PREF_UNITS_ANIM_FPS)
  • Seconds (PREF_UNITS_ANIM_SEC)
  • SMPTE (PREF_UNITS_ANIM_SMPTE)

---

Parameter: Store Last Layout

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

---

Parameter: RGB Range

• Parameter ID: PREF_UNITS_RGBRANGE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • 0...100% (PREF_UNIT_RANGE_PERCENT)
  • 0...1 (PREF_UNIT_RANGE_1)
  • 0...255 (PREF_UNIT_RANGE_255)
  • 0...65535 (PREF_UNIT_RANGE_65535)

---

Parameter: Compact Mode

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

---

Parameter: Special Mode

• Parameter ID: PREF_UNITS_COLORMODE_SPECIAL
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Off (PREF_UNITS_COLORMODE_SPECIAL_DISABLED)
  • Color Wheel (PREF_UNITS_COLORMODE_SPECIAL_COLORWHEEL)
  • Spectrum (PREF_UNITS_COLORMODE_SPECIAL_SPECTRUM)
  • Color from Picture (PREF_UNITS_COLORMODE_SPECIAL_PICTURE)

---

Parameter: Color Wheel Size

• Parameter ID: PREF_UNITS_COLORMODE_WHEEL_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_COLORMODE_SIZE_SMALL)
  • Medium (PREF_UNITS_COLORMODE_SIZE_MEDIUM)
  • Large (PREF_UNITS_COLORMODE_SIZE_LARGE)

---

Parameter: Color Wheel Swatch Size

• Parameter ID: PREF_UNITS_COLORMODE_WHEEL_SWATCH_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_COLORMODE_SIZE_SMALL)
  • Medium (PREF_UNITS_COLORMODE_SIZE_MEDIUM)
  • Large (PREF_UNITS_COLORMODE_SIZE_LARGE)

---

Parameter: Spectrum Size

• Parameter ID: PREF_UNITS_COLORMODE_SPECTRUM_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_COLORMODE_SIZE_SMALL)
  • Medium (PREF_UNITS_COLORMODE_SIZE_MEDIUM)
  • Large (PREF_UNITS_COLORMODE_SIZE_LARGE)

---

Parameter: Picture Mode Swatch Size

• Parameter ID: PREF_UNITS_COLORMODE_PICTURE_SWATCH_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_COLORMODE_SIZE_SMALL)
  • Medium (PREF_UNITS_COLORMODE_SIZE_MEDIUM)
  • Large (PREF_UNITS_COLORMODE_SIZE_LARGE)

---

Parameter: RGB

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

---

Parameter: HSV

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

---

Parameter: Temperature

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

---

Parameter: Color Mixer

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

---

Parameter: Hexadecimal

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

---

Parameter: Color Swatches

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

---

Parameter: Show Group Names

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

---

Parameter: Swatch Size

• Parameter ID: PREF_UNITS_COLORMODE_SWATCHES_SWATCH_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_COLORMODE_SIZE_SMALL)
  • Medium (PREF_UNITS_COLORMODE_SIZE_MEDIUM)
  • Large (PREF_UNITS_COLORMODE_SIZE_LARGE)

---

Parameter: Linear Numeric Values

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

---

Parameter: Gradient Size

• Parameter ID: PREF_UNITS_GRADIENT_SIZE
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Small (PREF_UNITS_GRADIENT_SIZE_SMALL)
  • Medium (PREF_UNITS_GRADIENT_SIZE_MEDIUM)
  • Large (PREF_UNITS_GRADIENT_SIZE_LARGE)

---

Parameter: Selection Handles

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

---

Parameter: Grid Color

• Parameter ID: PREF_UNITS_ALPHA_GRIDCOLOR
• Parameter Type: maxon::Int32 (Basic Data Types)
• Cycle Values:
  • Light (PREF_UNITS_ALPHA_GRIDCOLOR_LIGHT)
  • Medium (PREF_UNITS_ALPHA_GRIDCOLOR_MEDIUM)
  • Dark (PREF_UNITS_ALPHA_GRIDCOLOR_DARK)