Skip to content

Environmental Settings Profile

Environmental Settings Profiles store a variety of settings that affect how a scene is rendered. The main advantage of environmental settings profiles is that they make it easy to load presets into a camera. Use FxCamera to load and save profiles.

Properties

NameTypeDefaultAccessDescription
atmIntensity1f1.0🟩🟥Atmospheric scattering intensity
atmMieColor1c0xFFFFFFFF🟩🟥Atmospheric scattering mie color
atmMieDensity1f1.0🟩🟥Atmospheric scattering mie density
atmOzoneColor1c0xFF69FF6E🟩🟥Atmospheric scattering ozone color
atmOzoneDensity1f1.0🟩🟥Atmospheric scattering ozone density
atmPhase1f1.0🟩🟥Atmospheric scattering phase (aka MieG)
atmRayleighColor1c0xFF2D68FF🟩🟥Atmospheric scattering rayleigh color
atmRayleighDensity1f1.0🟩🟥Atmospheric scattering rayleigh density
bgColor1c0xff555555🟩🟥Background color
bgVisible1btrue🟩🟥Turn on background
groundColor1c0xFF4444🟩🟥Ground color
groundHorizon1f0.4🟩🟥Ground horizon size
groundVisible1btrue🟩🟥Display ground
iblBlur1f0.0🟩🟥Image base lighting blur amount
iblFile1s"default"🟩🟥Image base lighting Cubemap FileID (no list, wildcard or filter)
iblIntensity1f1.0🟩🟥Image base lighting intensity
iblRotationi10🟩🟥Image base lighting cubemap rotation angle in degrees
skyModei10🟩🟥SkyMode
sunAzimuth1f-110🟩🟥Sun azimuth in degrees
sunCastShadows1btrue🟩🟥Turn on shadows cast by sun
sunColor1c0xffffffff🟩🟥Sunlight color
sunDiskVisible1btrue🟩🟥Show sun disk
sunDiskRadius1f10🟩🟥Radius of the sun disk
sunElevation1f50🟩🟥Sun inclination in degrees
sunIntensity1f0.5🟩🟥Sunlight intensity
unilightColor1c0xffffffff🟩🟥Uniform lighting color
unilightIntensity1f0.5🟩🟥Uniform lighting intensity
Details

Type
1b: boolean
1c: color (integer)
1i: integer
1f: float
1s: string
2b: 2-component boolean vector
2i: 2-component integer vector
2f: 2-component float vector
3b: 3-component boolean vector
3i: 3-component integer vector
3f: 3-component float vector

Access
🟩 : Property value can be read with FxFile.Get
🟥 : Property value can be changed with FxFile.Set
❌ : Property value is read-only and can't be changed

Create

To create a new environmental settings profile use FxFile.Create with FileType 557.

lua
profileID = FxFile.Create(557);
profileID = FxFile.Rename(557, profileID, "MyProfile"); -- rename new profile
FxFile.Open(557, profileID); -- open new profile

Files

The global environmental settings profile is located at documents\Foxel\default.fxlenv. It saves the settings of the main editing viewport. Other custom profiles are saved as shared files in Shared\EnvironmentalSettings\ with the extension .fxlenv.