Here you will find documentation on all the descriptions that Cinema 4D currently has. You can list them Alphabetically, by Type or Plugin . The sample Python and C++ code is automatically generated and in some cases may not be 100% correct. If something doesn't work then please refer to the official Cinema 4D SDK documentation for more information.

Description Mgirealsky

IDs and information for Mgirealsky

Mgirealsky

Attributes

Elements

ID UI Name Type Parameters Cycle
GI_REAL_SKY_PAGE_LOCATION Location BOOL
HIDDEN
PAGE
PARENTMSG GI_REAL_SKY_GROUP_LOCATION
GI_REAL_SKY_PAGE_GLOBAL Global BOOL
HIDDEN
PAGE
PARENTMSG GI_REAL_SKY_GROUP_GLOBAL
GI_REAL_SKY_PAGE_SKY Sky BOOL
HIDDEN
PAGE
PARENTMSG GI_REAL_SKY_GROUP_SKY
GI_REAL_SKY_PAGE_SUN Sun BOOL
HIDDEN
PAGE
PARENTMSG GI_REAL_SKY_GROUP_SUN
GI_REAL_SKY_PAGE_ATM Atm BOOL
HIDDEN
PAGE
PARENTMSG GI_REAL_SKY_GROUP_ATM
GI_REAL_SKY_LATITUDE Latitude REAL
UNIT DEGREE
CUSTOMGUI LONG_LAT
MIN -90
MAX 90
GI_REAL_SKY_LONGITUDE Longitude REAL
UNIT DEGREE
CUSTOMGUI LONG_LAT
MIN -180
MAX 180
LONGITUDE
GI_REAL_SKY_DATETIME Time DATETIME
TIME_CONTROL
DATE_CONTROL
TIME_NOW
ANIM MIX
GI_REAL_SKY_TIME_ZONE TimeZoneOffset LONG
MIN -12
MAX 12
MINSLIDER -12
MAXSLIDER 12
STEP 1
FIT_H
GI_REAL_SKY_HUD ShowLocationHUD BOOL ANIM
GI_REAL_SKY_TURBIDITY Turbidity REAL
UNIT REAL
MIN 2.0
MAX 16.0
MINSLIDER 2.0
MAXSLIDER 16.0
STEP 0.1
CUSTOMGUI REALSLIDER
GI_REAL_SKY_OZONE Ozone REAL
UNIT REAL
MIN 0.0
MAX 8.0
MINSLIDER 0.0
MAXSLIDER 8.0
STEP 0.1
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_ENABLED Enabled BOOL  
GI_REAL_SKY_SKY_HORIZON HorizonLine BOOL  
GI_REAL_SKY_SKY_WARM_COLORS UseWarmColors BOOL  
GI_REAL_SKY_SKY_CHROMA UseChromaColorMap BOOL  
GI_REAL_SKY_SKY_INTENSITY Intensity REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_INTENSITY_NIGHT NightIntensityRatio REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_SATURATION SaturationCorrection REAL
UNIT PERCENT
MIN 0.0
MAX 200.0
MAXSLIDER 200.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_HUE HueCorrection REAL
UNIT REAL
MIN 0.0
MAX 1.0
MINSLIDER 0.0
MAXSLIDER 1.0
STEP 0.01
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_GAMMA GammaCorrection REAL
UNIT REAL
MIN 0.1
MAX 10.0
MINSLIDER 0.1
MAXSLIDER 10.0
STEP 0.1
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SKY_SEEN_RATIO AsSeenIntensityRatio REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_COLOR PreviewColor COLOR ANIM
GI_REAL_SKY_SUN_ENABLED Enabled BOOL  
GI_REAL_SKY_SUN_WARM_COLORS UseWarmColors BOOL  
GI_REAL_SKY_SUN_SHADOW_COLOR ShadowColor COLOR  
GI_REAL_SKY_SUN_INTENSITY Intensity REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_SATURATION SaturationCorrection REAL
UNIT PERCENT
MIN 0.0
MAX 200.0
MAXSLIDER 200.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_HUE HueCorrection REAL
UNIT REAL
MIN 0.0
MAX 1.0
MINSLIDER 0.0
MAXSLIDER 1.0
STEP 0.01
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_GAMMA GammaCorrection REAL
UNIT REAL
MIN 0.1
MAX 10.0
MINSLIDER 0.1
MAXSLIDER 10.0
STEP 0.1
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_SIZE_RATIO SizeRatio REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_SEEN_RATIO AsSeenIntensityRatio REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_SUN_SAMPLING_SAMPLES SamplingCount LONG
ANIM OFF
MIN 16
MAX 16384
MINSLIDER 16
MAXSLIDER 4096
STEP 16
CUSTOMGUI LONGSLIDER
FIT_H
SCALE_H
GI_REAL_SKY_SUN_SAMPLING_QUALITY SamplingQuality REAL
ANIM OFF
MIN 0.0
MAX 100.0
MINSLIDER 0.0
MAXSLIDER 100.0
STEP 1.0
UNIT PERCENT
CUSTOMGUI REALSLIDER
FIT_H
SCALE_H
GI_REAL_SKY_ATM_ENABLED Enabled BOOL  
GI_REAL_SKY_ATM_INTENSITY Intensity REAL
UNIT PERCENT
MIN 0.0
MAX 1000.0
MAXSLIDER 1000.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_ATM_SATURATION SaturationCorrection REAL
UNIT PERCENT
MIN 0.0
MAX 200.0
MAXSLIDER 200.0
CUSTOMGUI REALSLIDER
GI_REAL_SKY_ATM_HUE HueCorrection REAL
UNIT REAL
MIN 0.0
MAX 1.0
MINSLIDER 0.0
MAXSLIDER 1.0
STEP 0.01
CUSTOMGUI REALSLIDER
GI_REAL_SKY_ATM_GAMMA GammaCorrection REAL
UNIT REAL
MIN 0.1
MAX 10.0
MINSLIDER 0.1
MAXSLIDER 10.0
STEP 0.1
CUSTOMGUI REALSLIDER
GI_REAL_SKY_ATM_SCALE_RATIO SceneScaleRatio REAL
UNIT PERCENT
MIN 0.0
MAX 10000.0
MAXSLIDER 10000.0
CUSTOMGUI REALSLIDER

Example Code

The following code does not use the correct values when setting the data. You should check directly in C4D for the correct values that you should use in place of the ones that are shown. This code is just to show you how to access the values for getting and setting the parameters.

Python

import c4d
from c4d import gui
def main():
    material = c4d.BaseMaterial(c4d.Mgirealsky)
    
    #You can set parameters two different ways. 
    #First way              
    material[c4d.GI_REAL_SKY_PAGE_LOCATION] = True
    material[c4d.GI_REAL_SKY_PAGE_GLOBAL] = True
    material[c4d.GI_REAL_SKY_PAGE_SKY] = True
    material[c4d.GI_REAL_SKY_PAGE_SUN] = True
    material[c4d.GI_REAL_SKY_PAGE_ATM] = True
    material[c4d.GI_REAL_SKY_LATITUDE] = 0.1
    material[c4d.GI_REAL_SKY_LONGITUDE] = 0.1
    material[c4d.GI_REAL_SKY_TIME_ZONE] = 1
    material[c4d.GI_REAL_SKY_HUD] = True
    material[c4d.GI_REAL_SKY_TURBIDITY] = 0.1
    material[c4d.GI_REAL_SKY_OZONE] = 0.1
    material[c4d.GI_REAL_SKY_SKY_ENABLED] = True
    material[c4d.GI_REAL_SKY_SKY_HORIZON] = True
    material[c4d.GI_REAL_SKY_SKY_WARM_COLORS] = True
    material[c4d.GI_REAL_SKY_SKY_CHROMA] = True
    material[c4d.GI_REAL_SKY_SKY_INTENSITY] = 0.1
    material[c4d.GI_REAL_SKY_SKY_INTENSITY_NIGHT] = 0.1
    material[c4d.GI_REAL_SKY_SKY_SATURATION] = 0.1
    material[c4d.GI_REAL_SKY_SKY_HUE] = 0.1
    material[c4d.GI_REAL_SKY_SKY_GAMMA] = 0.1
    material[c4d.GI_REAL_SKY_SKY_SEEN_RATIO] = 0.1
    material[c4d.GI_REAL_SKY_SUN_ENABLED] = True
    material[c4d.GI_REAL_SKY_SUN_WARM_COLORS] = True
    material[c4d.GI_REAL_SKY_SUN_INTENSITY] = 0.1
    material[c4d.GI_REAL_SKY_SUN_SATURATION] = 0.1
    material[c4d.GI_REAL_SKY_SUN_HUE] = 0.1
    material[c4d.GI_REAL_SKY_SUN_GAMMA] = 0.1
    material[c4d.GI_REAL_SKY_SUN_SIZE_RATIO] = 0.1
    material[c4d.GI_REAL_SKY_SUN_SEEN_RATIO] = 0.1
    material[c4d.GI_REAL_SKY_SUN_SAMPLING_SAMPLES] = 1
    material[c4d.GI_REAL_SKY_SUN_SAMPLING_QUALITY] = 0.1
    material[c4d.GI_REAL_SKY_ATM_ENABLED] = True
    material[c4d.GI_REAL_SKY_ATM_INTENSITY] = 0.1
    material[c4d.GI_REAL_SKY_ATM_SATURATION] = 0.1
    material[c4d.GI_REAL_SKY_ATM_HUE] = 0.1
    material[c4d.GI_REAL_SKY_ATM_GAMMA] = 0.1
    material[c4d.GI_REAL_SKY_ATM_SCALE_RATIO] = 0.1
    
    #Second way, using the base container.
    bc = material.GetDataInstance()
    bc.SetBool(c4d.GI_REAL_SKY_PAGE_LOCATION,True)
    bc.SetBool(c4d.GI_REAL_SKY_PAGE_GLOBAL,True)
    bc.SetBool(c4d.GI_REAL_SKY_PAGE_SKY,True)
    bc.SetBool(c4d.GI_REAL_SKY_PAGE_SUN,True)
    bc.SetBool(c4d.GI_REAL_SKY_PAGE_ATM,True)
    bc.SetFloat(c4d.GI_REAL_SKY_LATITUDE,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_LONGITUDE,0.1)
    bc.SetInt32(c4d.GI_REAL_SKY_TIME_ZONE,1)
    bc.SetBool(c4d.GI_REAL_SKY_HUD,True)
    bc.SetFloat(c4d.GI_REAL_SKY_TURBIDITY,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_OZONE,0.1)
    bc.SetBool(c4d.GI_REAL_SKY_SKY_ENABLED,True)
    bc.SetBool(c4d.GI_REAL_SKY_SKY_HORIZON,True)
    bc.SetBool(c4d.GI_REAL_SKY_SKY_WARM_COLORS,True)
    bc.SetBool(c4d.GI_REAL_SKY_SKY_CHROMA,True)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_INTENSITY,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_INTENSITY_NIGHT,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_SATURATION,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_HUE,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_GAMMA,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SKY_SEEN_RATIO,0.1)
    bc.SetBool(c4d.GI_REAL_SKY_SUN_ENABLED,True)
    bc.SetBool(c4d.GI_REAL_SKY_SUN_WARM_COLORS,True)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_INTENSITY,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_SATURATION,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_HUE,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_GAMMA,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_SIZE_RATIO,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_SEEN_RATIO,0.1)
    bc.SetInt32(c4d.GI_REAL_SKY_SUN_SAMPLING_SAMPLES,1)
    bc.SetFloat(c4d.GI_REAL_SKY_SUN_SAMPLING_QUALITY,0.1)
    bc.SetBool(c4d.GI_REAL_SKY_ATM_ENABLED,True)
    bc.SetFloat(c4d.GI_REAL_SKY_ATM_INTENSITY,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_ATM_SATURATION,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_ATM_HUE,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_ATM_GAMMA,0.1)
    bc.SetFloat(c4d.GI_REAL_SKY_ATM_SCALE_RATIO,0.1)

if __name__=='__main__':
    main()

C++

#include "c4d.h"
#include "../advanced_render/description/mgirealsky.h"
void SampleFunction()
{
    BaseDocument *pDoc = GetActiveDocument();
    BaseMaterial *pMaterial = BaseMaterial::Alloc(Mgirealsky);  
    
    //You can set parameters two different ways. 

    //First way              
    //Some objects do not store all their data in the container. You need to use GetParameter()/SetParameter() instead. 

    DESCFLAGS_SET flags = DESCFLAGS_SET_PARAM_SET;
    pMaterial->SetParameter(DescID(GI_REAL_SKY_PAGE_LOCATION),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_PAGE_GLOBAL),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_PAGE_SKY),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_PAGE_SUN),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_PAGE_ATM),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_LATITUDE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_LONGITUDE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_TIME_ZONE),GeData(1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_HUD),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_TURBIDITY),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_OZONE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_ENABLED),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_HORIZON),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_WARM_COLORS),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_CHROMA),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_INTENSITY),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_INTENSITY_NIGHT),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_SATURATION),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_HUE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_GAMMA),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SKY_SEEN_RATIO),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_ENABLED),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_WARM_COLORS),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_INTENSITY),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_SATURATION),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_HUE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_GAMMA),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_SIZE_RATIO),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_SEEN_RATIO),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_SAMPLING_SAMPLES),GeData(1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_SUN_SAMPLING_QUALITY),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_ENABLED),GeData(true),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_INTENSITY),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_SATURATION),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_HUE),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_GAMMA),GeData(0.1),flags);
    pMaterial->SetParameter(DescID(GI_REAL_SKY_ATM_SCALE_RATIO),GeData(0.1),flags);
    pMaterial->Message(MSG_UPDATE);            

    //Second way, using the base container.
    BaseContainer *bc =     pMaterial->GetDataInstance();
    bc->SetBool(GI_REAL_SKY_PAGE_LOCATION,true);
    bc->SetBool(GI_REAL_SKY_PAGE_GLOBAL,true);
    bc->SetBool(GI_REAL_SKY_PAGE_SKY,true);
    bc->SetBool(GI_REAL_SKY_PAGE_SUN,true);
    bc->SetBool(GI_REAL_SKY_PAGE_ATM,true);
    bc->SetFloat(GI_REAL_SKY_LATITUDE,0.1);
    bc->SetFloat(GI_REAL_SKY_LONGITUDE,0.1);
    bc->SetInt32(GI_REAL_SKY_TIME_ZONE,1);
    bc->SetBool(GI_REAL_SKY_HUD,true);
    bc->SetFloat(GI_REAL_SKY_TURBIDITY,0.1);
    bc->SetFloat(GI_REAL_SKY_OZONE,0.1);
    bc->SetBool(GI_REAL_SKY_SKY_ENABLED,true);
    bc->SetBool(GI_REAL_SKY_SKY_HORIZON,true);
    bc->SetBool(GI_REAL_SKY_SKY_WARM_COLORS,true);
    bc->SetBool(GI_REAL_SKY_SKY_CHROMA,true);
    bc->SetFloat(GI_REAL_SKY_SKY_INTENSITY,0.1);
    bc->SetFloat(GI_REAL_SKY_SKY_INTENSITY_NIGHT,0.1);
    bc->SetFloat(GI_REAL_SKY_SKY_SATURATION,0.1);
    bc->SetFloat(GI_REAL_SKY_SKY_HUE,0.1);
    bc->SetFloat(GI_REAL_SKY_SKY_GAMMA,0.1);
    bc->SetFloat(GI_REAL_SKY_SKY_SEEN_RATIO,0.1);
    bc->SetBool(GI_REAL_SKY_SUN_ENABLED,true);
    bc->SetBool(GI_REAL_SKY_SUN_WARM_COLORS,true);
    bc->SetFloat(GI_REAL_SKY_SUN_INTENSITY,0.1);
    bc->SetFloat(GI_REAL_SKY_SUN_SATURATION,0.1);
    bc->SetFloat(GI_REAL_SKY_SUN_HUE,0.1);
    bc->SetFloat(GI_REAL_SKY_SUN_GAMMA,0.1);
    bc->SetFloat(GI_REAL_SKY_SUN_SIZE_RATIO,0.1);
    bc->SetFloat(GI_REAL_SKY_SUN_SEEN_RATIO,0.1);
    bc->SetInt32(GI_REAL_SKY_SUN_SAMPLING_SAMPLES,1);
    bc->SetFloat(GI_REAL_SKY_SUN_SAMPLING_QUALITY,0.1);
    bc->SetBool(GI_REAL_SKY_ATM_ENABLED,true);
    bc->SetFloat(GI_REAL_SKY_ATM_INTENSITY,0.1);
    bc->SetFloat(GI_REAL_SKY_ATM_SATURATION,0.1);
    bc->SetFloat(GI_REAL_SKY_ATM_HUE,0.1);
    bc->SetFloat(GI_REAL_SKY_ATM_GAMMA,0.1);
    bc->SetFloat(GI_REAL_SKY_ATM_SCALE_RATIO,0.1);
    pMaterial->Message(MSG_UPDATE);                                                      
}