GIMode

Types

• enum LightmapScale
• enum ShadowCastingSetting
• enum VisibilityRangeFadeMode

Type members

• class var godotClassName: StringName

Instance members

• var castShadow: GeometryInstance3D.ShadowCastingSetting

  The selected shadow casting flag. See ShadowCastingSetting for possible values.

• var customAabb: AABB

  Overrides the bounding box of this node with a custom one. This can be used to avoid the expensive AABB recalculation that happens when a skeleton is used with a MeshInstance3D or to have fine control over the MeshInstance3D’s bounding box. To use the default AABB, set value to an AABB with all fields set to 0.0. To avoid frustum culling, set customAabb to a very large AABB that covers your entire game world such as AABB(-10000, -10000, -10000, 20000, 20000, 20000). To disable all forms of culling (including occlusion culling), call instanceSetIgnoreCulling(instance:enabled:) on the GeometryInstance3D’s RID.

• var extraCullMargin: Double

  The extra distance added to the GeometryInstance3D’s bounding box (AABB) to increase its cull box.

• var giLightmapScale: GeometryInstance3D.LightmapScale

  The texel density to use for lightmapping in LightmapGI. Greater scale values provide higher resolution in the lightmap, which can result in sharper shadows for lights that have both direct and indirect light baked. However, greater scale values will also increase the space taken by the mesh in the lightmap texture, which increases the memory, storage, and bake time requirements. When using a single mesh at different scales, consider adjusting this value to keep the lightmap texel density consistent across meshes.

• var giMode: GeometryInstance3D.GIMode

  The global illumination mode to use for the whole geometry. To avoid inconsistent results, use a mode that matches the purpose of the mesh during gameplay (static/dynamic).

• var ignoreOcclusionCulling: Bool

  If true, disables occlusion culling for this instance. Useful for gizmos that must be rendered even when occlusion culling is in use.

• var lodBias: Double

  Changes how quickly the mesh transitions to a lower level of detail. A value of 0 will force the mesh to its lowest level of detail, a value of 1 will use the default settings, and larger values will keep the mesh in a higher level of detail at farther distances.

• var materialOverlay: Material?

  The material overlay for the whole geometry.

• var materialOverride: Material?

  The material override for the whole geometry.

• var transparency: Double

  The transparency applied to the whole geometry (as a multiplier of the materials’ existing transparency). 0.0 is fully opaque, while 1.0 is fully transparent. Values greater than 0.0 (exclusive) will force the geometry’s materials to go through the transparent pipeline, which is slower to render and can exhibit rendering issues due to incorrect transparency sorting. However, unlike using a transparent material, setting transparency to a value greater than 0.0 (exclusive) will not disable shadow rendering.

• var visibilityRangeBegin: Double

  Starting distance from which the GeometryInstance3D will be visible, taking visibilityRangeBeginMargin into account as well. The default value of 0 is used to disable the range check.

• var visibilityRangeBeginMargin: Double

  Margin for the visibilityRangeBegin threshold. The GeometryInstance3D will only change its visibility state when it goes over or under the visibilityRangeBegin threshold by this amount.

• var visibilityRangeEnd: Double

  Distance from which the GeometryInstance3D will be hidden, taking visibilityRangeEndMargin into account as well. The default value of 0 is used to disable the range check.

• var visibilityRangeEndMargin: Double

  Margin for the visibilityRangeEnd threshold. The GeometryInstance3D will only change its visibility state when it goes over or under the visibilityRangeEnd threshold by this amount.

• var visibilityRangeFadeMode: GeometryInstance3D.VisibilityRangeFadeMode

  Controls which instances will be faded when approaching the limits of the visibility range. See VisibilityRangeFadeMode for possible values.

• func getInstanceShaderParameter(name: StringName) -> Variant

  Get the value of a shader parameter as set on this instance.

• func setInstanceShaderParameter(name: StringName, value: Variant)

  Set the value of a shader uniform for this instance only (per-instance uniform). See also setShaderParameter(param:value:) to assign a uniform on all instances using the same ShaderMaterial.