Light Object

About

Parameters

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


Parameter: Convert to Redshift


Parameter: Color


Parameter: Use Temperature


Parameter: Color Temperature


Parameter: Intensity


Parameter: Type

  • Parameter ID: LIGHT_TYPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Omni (LIGHT_TYPE_OMNI)
    • Spot (LIGHT_TYPE_SPOT)
    • Infinite (LIGHT_TYPE_DISTANT)
    • Area (LIGHT_TYPE_AREA)
    • Square Spot (LIGHT_TYPE_SPOTRECT)
    • Parallel (LIGHT_TYPE_PARALLEL)
    • Parallel Spot (LIGHT_TYPE_PARSPOT)
    • Square Parallel Spot (LIGHT_TYPE_PARSPOTRECT)
    • IES (LIGHT_TYPE_PHOTOMETRIC)

Parameter: Shadow

  • Parameter ID: LIGHT_SHADOWTYPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_SHADOWTYPE_NONE)
    • Shadow Maps (Soft) (LIGHT_SHADOWTYPE_SOFT)
    • Raytraced (Hard) (LIGHT_SHADOWTYPE_HARD)
    • Area (LIGHT_SHADOWTYPE_AREA)

Parameter: Visible Light

  • Parameter ID: LIGHT_VLTYPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_VLTYPE_NONE)
    • Visible (LIGHT_VLTYPE_VISIBLE)
    • Volumetric (LIGHT_VLTYPE_VOLUMETRIC)
    • Inverse Volumetric (LIGHT_VLTYPE_INVERSEVOLUMETRIC)

Parameter: No Illumination


Parameter: Show Illumination


Parameter: Ambient Illumination


Parameter: Show Visible Light


Parameter: Diffuse


Parameter: Show Clipping


Parameter: Specular


Parameter: Separate Pass


Parameter: GI Illumination


Parameter: Export to Compositing


Parameter: Use Inner Value


Parameter: Inner Angle


Parameter: Inner Radius


Parameter: Outer Angle


Parameter: Outer Radius


Parameter: Aspect Ratio


Parameter: Contrast


Parameter: Shadow Caster


Parameter: Area Shape

  • Parameter ID: LIGHT_AREADETAILS_SHAPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Disc (LIGHT_AREADETAILS_SHAPE_DISC)
    • Rectangle (LIGHT_AREADETAILS_SHAPE_RECTANGLE)
    • Line (LIGHT_AREADETAILS_SHAPE_LINE)
    • Sphere (LIGHT_AREADETAILS_SHAPE_SPHERE)
    • Cylinder (LIGHT_AREADETAILS_SHAPE_CYLINDER)
    • Cylinder (Perpendicular) (LIGHT_AREADETAILS_SHAPE_PCYLINDER)
    • Cube (LIGHT_AREADETAILS_SHAPE_CUBE)
    • Hemisphere (LIGHT_AREADETAILS_SHAPE_HEMISPHERE)
    • Object / Spline (LIGHT_AREADETAILS_SHAPE_OBJECT)

Parameter: Object


Parameter: Size X


Parameter: Size Y


Parameter: Size Z


Parameter: Falloff Angle


Parameter: Infinite Angle


Parameter: Samples


Parameter: Add Grain (Slow)


Parameter: Show in Render


Parameter: Show as Solid in Viewport


Parameter: Show in Specular


Parameter: Show in Reflection


Parameter: Visibility Multiplier


Parameter: Falloff

  • Parameter ID: LIGHT_DETAILS_FALLOFF
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_DETAILS_FALLOFF_NONE)
    • Inverse Square (Physically Accurate) (LIGHT_DETAILS_FALLOFF_INVERSESQUARE)
    • Linear (LIGHT_DETAILS_FALLOFF_LINEAR)
    • Step (LIGHT_DETAILS_FALLOFF_STEP)
    • Inverse Square Clamped (LIGHT_DETAILS_FALLOFF_INVERSESQUARE_CLAMPED)

Parameter: Falloff Inner Radius


Parameter: Falloff Radius / Decay


Parameter: Colored Edge Falloff


Parameter: Z Direction Only


Parameter: Use Gradient


Parameter: Color

  • Parameter ID: LIGHT_DETAILS_GRADIENT
  • Parameter Type: Gradient

Parameter: Use Near Clipping


Parameter: Near Clipping from


Parameter: Near Clipping to


Parameter: Use Far Clipping


Parameter: Far Clipping from


Parameter: Far Clipping to


Parameter: VL Use Falloff


Parameter: VL Falloff


Parameter: VL Use Edge Falloff


Parameter: VL Edge Falloff


Parameter: VL Colored Edge Falloff


Parameter: VL Inner Distance


Parameter: VL Outer Distance


Parameter: VL Relative Scale


Parameter: VL Sample Distance


Parameter: VL Brightness


Parameter: VL Dust


Parameter: VL Dithering


Parameter: VL Use Gradient


Parameter: VL Color

  • Parameter ID: LIGHT_VISIBILITY_GRADIENT
  • Parameter Type: Gradient

Parameter: VL Additive


Parameter: VL Adapt Brightness


Parameter: Shadow

  • Parameter ID: LIGHT_SHADOWTYPE_VIRTUAL
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_SHADOWTYPE_NONE)
    • Shadow Maps (Soft) (LIGHT_SHADOWTYPE_SOFT)
    • Raytraced (Hard) (LIGHT_SHADOWTYPE_HARD)
    • Area (LIGHT_SHADOWTYPE_AREA)

Parameter: Shadow Density


Parameter: Shadow Color


Parameter: Shadow Transparency


Parameter: Shadow Clipping Influence


Parameter: Shadow Map

  • Parameter ID: LIGHT_SHADOW_MAPSIZE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • 250x250 (LIGHT_SHADOW_MAPSIZE_250)
    • 500x500 (LIGHT_SHADOW_MAPSIZE_500)
    • 750x750 (LIGHT_SHADOW_MAPSIZE_750)
    • 1000x1000 (LIGHT_SHADOW_MAPSIZE_1000)
    • 1250x1250 (LIGHT_SHADOW_MAPSIZE_1250)
    • 1500x1500 (LIGHT_SHADOW_MAPSIZE_1500)
    • 1750x1750 (LIGHT_SHADOW_MAPSIZE_1750)
    • 2000x2000 (LIGHT_SHADOW_MAPSIZE_2000)
    • Custom (LIGHT_SHADOW_MAPSIZE_USER)

Parameter: Shadow Map Size X


Parameter: Shadow Map Size Y


Parameter: Shadow Sample Radius


Parameter: Sampling Radius Boost

  • Parameter ID: LIGHT_SHADOW_SAMPLEBOOST
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_SHADOW_SAMPLEBOOST_NONE)
    • Low (2x) (LIGHT_SHADOW_SAMPLEBOOST_2)
    • Medium (4x) (LIGHT_SHADOW_SAMPLEBOOST_4)
    • High (8x) (LIGHT_SHADOW_SAMPLEBOOST_8)

Parameter: Shadow Absolute Bias


Parameter: Shadow Bias (Rel)


Parameter: Shadow Bias (Abs)


Parameter: Shadow Parallel Width


Parameter: Outline Shadow


Parameter: High Quality


Parameter: Shadow Cone


Parameter: Shadow Cone Angle


Parameter: Shadow Soft Cone


Parameter: Area Shadow Width


Parameter: Accuracy


Parameter: Minimum Samples


Parameter: Maximum Samples


Parameter: Photometric Intensity


Parameter: Intensity


Parameter: Units

  • Parameter ID: LIGHT_PHOTOMETRIC_UNIT
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Lumen (lm) (LIGHT_PHOTOMETRIC_UNIT_LUMEN)
    • Candela (cd) (LIGHT_PHOTOMETRIC_UNIT_CANDELA)
    • Lux (lx) (LIGHT_PHOTOMETRIC_UNIT_LUX)

Parameter: Photometric Data


Parameter: Filename


Parameter: Photometric Size


Parameter: Surface Caustics


Parameter: Surface Energy


Parameter: Surface Photons


Parameter: Volume Caustics


Parameter: Volume Energy


Parameter: Volume Photons


Parameter: Caustics Falloff

  • Parameter ID: LIGHT_VOLCAUSTIC_FALLOFF
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_VOLCAUSTIC_FALLOFF_NONE)
    • Linear (LIGHT_VOLCAUSTIC_FALLOFF_LINEAR)
    • Inverse (LIGHT_VOLCAUSTIC_FALLOFF_INVERSE)
    • Inverse Square (LIGHT_VOLCAUSTIC_FALLOFF_INVERSESQUARE)
    • Inverse Cubic (LIGHT_VOLCAUSTIC_FALLOFF_INVERSECUBIC)
    • Step (LIGHT_VOLCAUSTIC_FALLOFF_STEP)

Parameter: Caustics Inner Distance


Parameter: Caustics Outer Distance


Parameter: Noise

  • Parameter ID: LIGHT_NOISETYPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • None (LIGHT_NOISETYPE_NONE)
    • Illumination (LIGHT_NOISETYPE_ILLUM)
    • Visibility (LIGHT_NOISETYPE_VISIBLE)
    • Both (LIGHT_NOISETYPE_BOTH)

Parameter: Noise Type

  • Parameter ID: LIGHT_NOISE_TYPE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Noise (LIGHT_NOISE_TYPE_NOISE)
    • Soft Turbulence (LIGHT_NOISE_TYPE_SOFTTURBULENCE)
    • Hard Turbulence (LIGHT_NOISE_HARDTURBULENCE)
    • Wavy Turbulence (LIGHT_NOISE_WAVYTURBULENCE)

Parameter: Noise Octaves


Parameter: Noise Velocity


Parameter: Noise Brightness


Parameter: Noise Contrast


Parameter: Noise Local


Parameter: Noise Visibility Scale


Parameter: Noise Illumination Scale


Parameter: Noise Wind


Parameter: Noise Wind Velocity


Parameter: FX Glow

  • Parameter ID: LIGHT_LENSEFFECTS_LENSGLOW
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Inactive (LIGHT_LENSEFFECTS_LENSGLOW_INACTIVE)
    • Custom (LIGHT_LENSEFFECTS_LENSGLOW_CUSTOM)
    • Default (LIGHT_LENSEFFECTS_LENSGLOW_DEFAULT)
    • Cinema 4D R4 (LIGHT_LENSEFFECTS_LENSGLOW_CINEMAR4)
    • Wideangle (LIGHT_LENSEFFECTS_LENSGLOW_WIDEANGLE)
    • Zoom (LIGHT_LENSEFFECTS_LENSGLOW_ZOOM)
    • Hi-8 (LIGHT_LENSEFFECTS_LENSGLOW_HI8)
    • Camcorder (LIGHT_LENSEFFECTS_LENSGLOW_CAMCORDER)
    • Searchlight (LIGHT_LENSEFFECTS_LENSGLOW_SEARCHLIGHT)
    • Artifact (LIGHT_LENSEFFECTS_LENSGLOW_ARTIFACT)
    • Star 1 (LIGHT_LENSEFFECTS_LENSGLOW_STAR1)
    • Star 2 (LIGHT_LENSEFFECTS_LENSGLOW_STAR2)
    • Star 3 (LIGHT_LENSEFFECTS_LENSGLOW_STAR3)
    • Purple (LIGHT_LENSEFFECTS_LENSGLOW_PURPLE)
    • Flashlight (LIGHT_LENSEFFECTS_LENSGLOW_FLASHLIGHT)
    • Sun 1 (LIGHT_LENSEFFECTS_LENSGLOW_SUN1)
    • Sun 2 (LIGHT_LENSEFFECTS_LENSGLOW_SUN2)
    • Grey (LIGHT_LENSEFFECTS_LENSGLOW_GREY)
    • Blue 1 (LIGHT_LENSEFFECTS_LENSGLOW_BLUE1)
    • Blue 2 (LIGHT_LENSEFFECTS_LENSGLOW_BLUE2)
    • Red (LIGHT_LENSEFFECTS_LENSGLOW_RED)
    • Yellow-Green 1 (LIGHT_LENSEFFECTS_LENSGLOW_YELLOWGREEN1)
    • Yellow-Green 2 (LIGHT_LENSEFFECTS_LENSGLOW_YELLOWGREEN2)
    • Candle (LIGHT_LENSEFFECTS_LENSGLOW_CANDLE)

Parameter: FX Glow Brightness


Parameter: FX Glow Aspect Ratio


Parameter: FX Glow Settings


Parameter: FX Reflexes

  • Parameter ID: LIGHT_LENSEFFECTS_LENSREFL
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Inactive (LIGHT_LENSEFFECTS_LENSREFL_INACTIVE)
    • Custom (LIGHT_LENSEFFECTS_LENSREFL_CUSTOM)
    • Default (LIGHT_LENSEFFECTS_LENSREFL_DEFAULT)
    • Cinema 4D R4 (LIGHT_LENSEFFECTS_LENSREFL_CINEMAR4)
    • Wideangle (LIGHT_LENSEFFECTS_LENSREFL_WIDEANGLE)
    • Zoom (LIGHT_LENSEFFECTS_LENSREFL_ZOOM)
    • Hi-8 (LIGHT_LENSEFFECTS_LENSREFL_HI8)
    • Camcorder (LIGHT_LENSEFFECTS_LENSREFL_CAMCORDER)
    • Searchlight (LIGHT_LENSEFFECTS_LENSREFL_SEARCHLIGHT)
    • Artifact (LIGHT_LENSEFFECTS_LENSREFL_ARTIFACT)
    • Star 1 (LIGHT_LENSEFFECTS_LENSREFL_STAR1)
    • Star 2 (LIGHT_LENSEFFECTS_LENSREFL_STAR2)
    • Star 3 (LIGHT_LENSEFFECTS_LENSREFL_STAR3)
    • Purple (LIGHT_LENSEFFECTS_LENSREFL_PURPLE)
    • Flashlight 1 (LIGHT_LENSEFFECTS_LENSREFL_FLASHLIGHT1)
    • Flashlight 2 (LIGHT_LENSEFFECTS_LENSREFL_FLASHLIGHT2)
    • Flashlight 3 (LIGHT_LENSEFFECTS_LENSREFL_FLASHLIGHT3)

Parameter: FX Reflection Brightness


Parameter: FX Reflection Aspect Ratio


Parameter: Edit...


Parameter: FX Scale


Parameter: FX Rotation


Parameter: FX Reference Size


Parameter: FX Use Light Parameters


Parameter: FX Fade if Near Border


Parameter: FX Fade if Behind Object


Parameter: FX Fade if Approaching Object


Parameter: FX Glow Distance Scale


Parameter: FX Reflex Distance Scale


Parameter: Mode

  • Parameter ID: LIGHT_EXCLUSION_MODE
  • Parameter Type: maxon::Int32 (Basic Data Types)
  • Cycle Values:
    • Include (LIGHT_EXCLUSION_MODE_INCLUDE)
    • Exclude (LIGHT_EXCLUSION_MODE_EXCLUDE)

Parameter: Objects

  • Parameter ID: LIGHT_EXCLUSION_LIST
  • Parameter Type: InExcludeData

Parameter: PyroCluster Illumination


Parameter: PyroCluster Shadow Casting