Skip to content

@orillusion/core


Class: EarthAtmRenderer

Defined in: src/components/renderer/EarthAtmRenderer.ts:14

Earth Atm Renderer Component Renders atmospheric scattering for Earth atmosphere Supports both view from space (looking at Earth) and view from ground (looking at sky)

Extends

Constructors

Constructor

new EarthAtmRenderer(): EarthAtmRenderer

Defined in: src/components/renderer/MeshRenderer.ts:26

Returns

EarthAtmRenderer

Inherited from

MeshRenderer.constructor

Properties

object3D

object3D: Object3D = null

Defined in: src/components/ComponentBase.ts:29

owner object3D

Inherited from

MeshRenderer.object3D


isDestroyed

isDestroyed: boolean = false

Defined in: src/components/ComponentBase.ts:77

Inherited from

MeshRenderer.isDestroyed


earthAtmMaterial

earthAtmMaterial: EarthAtmMaterial

Defined in: src/components/renderer/EarthAtmRenderer.ts:18

The material used in the Earth Atmosphere.


receiveShadow

receiveShadow: boolean

Defined in: src/components/renderer/MeshRenderer.ts:23

Enabling this option allows the grid to display any shadows cast on the grid.

Inherited from

MeshRenderer.receiveShadow


morphData

morphData: MorphTargetData

Defined in: src/components/renderer/MeshRenderer.ts:24

Inherited from

MeshRenderer.morphData


instanceCount

instanceCount: number = 0

Defined in: src/components/renderer/RenderNode.ts:35

Inherited from

MeshRenderer.instanceCount


lodLevel

lodLevel: number = 0

Defined in: src/components/renderer/RenderNode.ts:36

Inherited from

MeshRenderer.lodLevel


alwaysRender

alwaysRender: boolean = false

Defined in: src/components/renderer/RenderNode.ts:37

Inherited from

MeshRenderer.alwaysRender


instanceID

instanceID: string

Defined in: src/components/renderer/RenderNode.ts:38

Inherited from

MeshRenderer.instanceID


drawType

drawType: number = 0

Defined in: src/components/renderer/RenderNode.ts:39

Inherited from

MeshRenderer.drawType


isRenderOrderChange?

optional isRenderOrderChange?: boolean

Defined in: src/components/renderer/RenderNode.ts:55

Inherited from

MeshRenderer.isRenderOrderChange


needSortOnCameraZ?

optional needSortOnCameraZ?: boolean

Defined in: src/components/renderer/RenderNode.ts:56

Inherited from

MeshRenderer.needSortOnCameraZ


shadowCacheMode

shadowCacheMode: "auto" | "static" | "dynamic" = 'auto'

Defined in: src/components/renderer/RenderNode.ts:437

Shadow cache classification.

  • 'auto' (default): renderer is drawn to the shadow map every frame as part of the single-pass render — matches historical behaviour.
  • 'static': renderer is drawn only to the cached static depth layer, rebuilt lazily when the light moves or the scene explicitly marks the static cache dirty. Use for buildings, terrain, prop meshes that don't move.
  • 'dynamic': renderer is drawn every frame on top of the copied-in static layer. Use for characters, physics objects, anything that moves.

Only consulted when engine.setting.shadow.enableStaticCache === true; otherwise all renderers behave as 'auto'.

Inherited from

MeshRenderer.shadowCacheMode

Accessors

visibleLayer

Get Signature

get visibleLayer(): number

Defined in: src/components/ComponentBase.ts:46

Composition-layer membership bitmask. The pass / camera / collector filters via

(component.visibleLayer & pass.layerMask & camera.cullingMask) !== 0

Defaults to VisibleLayer.Default (bit 0) so a fresh subclass is visible to passes whose layerMask is VisibleLayer.All (which includes bit 0). Application code can assign project-specific bits (1..31) to organise the scene into composition layers.

Returns

number

Set Signature

set visibleLayer(value): void

Defined in: src/components/ComponentBase.ts:50

Parameters
value

number

Returns

void

Inherited from

MeshRenderer.visibleLayer


eventDispatcher

Get Signature

get eventDispatcher(): CEventDispatcher

Defined in: src/components/ComponentBase.ts:63

Returns

CEventDispatcher

Set Signature

set eventDispatcher(value): void

Defined in: src/components/ComponentBase.ts:68

Parameters
value

CEventDispatcher

Returns

void

Inherited from

MeshRenderer.eventDispatcher


isStart

Get Signature

get isStart(): boolean

Defined in: src/components/ComponentBase.ts:79

Returns

boolean

Inherited from

MeshRenderer.isStart


transform

Get Signature

get transform(): Transform

Defined in: src/components/ComponentBase.ts:89

Return the Transform component attached to the Object3D. Null before the component is attached — addComponent assigns object3D only after construction — so constructor-time callers can probe safely via this.transform?..

Returns

Transform

Inherited from

MeshRenderer.transform


enable

Get Signature

get enable(): boolean

Defined in: src/components/ComponentBase.ts:113

Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.

Returns

boolean

Set Signature

set enable(value): void

Defined in: src/components/ComponentBase.ts:96

Enable/disable components. The enabled components can be updated, while the disabled components cannot be updated.

Parameters
value

boolean

Returns

void

Inherited from

MeshRenderer.enable


radius

Get Signature

get radius(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:49

Get the radius of earth sky sphere

Returns

number

Set Signature

set radius(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:57

Set the radius of earth sky sphere Should be larger than atmosphereRadius to ensure proper rendering

Parameters
value

number

Returns

void


earthRadius

Get Signature

get earthRadius(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:69

Get Earth radius in meters

Returns

number

Set Signature

set earthRadius(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:76

Set Earth radius in meters (default: 6371000)

Parameters
value

number

Returns

void


atmosphereRadius

Get Signature

get atmosphereRadius(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:84

Get atmosphere outer radius in meters

Returns

number

Set Signature

set atmosphereRadius(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:92

Set atmosphere outer radius in meters Typically earthRadius + 100000 for 100km atmosphere

Parameters
value

number

Returns

void


earthCenter

Get Signature

get earthCenter(): Vector3

Defined in: src/components/renderer/EarthAtmRenderer.ts:100

Get Earth center position in world space

Returns

Vector3

Set Signature

set earthCenter(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:107

Set Earth center position in world space

Parameters
value

Vector3

Returns

void


sunDirection

Get Signature

get sunDirection(): Vector3

Defined in: src/components/renderer/EarthAtmRenderer.ts:117

Get sun direction (normalized vector pointing towards the sun)

Returns

Vector3

Set Signature

set sunDirection(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:124

Set sun direction (will be normalized)

Parameters
value

Vector3

Returns

void


sunIntensity

Get Signature

get sunIntensity(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:132

Get sun intensity

Returns

number

Set Signature

set sunIntensity(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:139

Set sun intensity (default: 22.0)

Parameters
value

number

Returns

void


rayleighCoeff

Get Signature

get rayleighCoeff(): Vector3

Defined in: src/components/renderer/EarthAtmRenderer.ts:149

Get Rayleigh scattering coefficients (wavelength dependent - RGB)

Returns

Vector3

Set Signature

set rayleighCoeff(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:157

Set Rayleigh scattering coefficients Default: (5.5e-6, 13.0e-6, 22.4e-6) for Earth-like atmosphere

Parameters
value

Vector3

Returns

void


mieCoeff

Get Signature

get mieCoeff(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:165

Get Mie scattering coefficient

Returns

number

Set Signature

set mieCoeff(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:172

Set Mie scattering coefficient (default: 21e-6)

Parameters
value

number

Returns

void


rayleighScale

Get Signature

get rayleighScale(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:180

Get Rayleigh scale height in meters

Returns

number

Set Signature

set rayleighScale(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:187

Set Rayleigh scale height (default: 8000 meters)

Parameters
value

number

Returns

void


mieScale

Get Signature

get mieScale(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:195

Get Mie scale height in meters

Returns

number

Set Signature

set mieScale(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:202

Set Mie scale height (default: 1200 meters)

Parameters
value

number

Returns

void


mieG

Get Signature

get mieG(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:210

Get Mie scattering asymmetry factor (g)

Returns

number

Set Signature

set mieG(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:219

Set Mie scattering asymmetry factor (default: 0.758) Values close to 1 give strong forward scattering (sun glare) Values close to 0 give isotropic scattering

Parameters
value

number

Returns

void


exposure

Get Signature

get exposure(): number

Defined in: src/components/renderer/EarthAtmRenderer.ts:229

Get exposure value for tone mapping

Returns

number

Set Signature

set exposure(value): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:236

Set exposure value for tone mapping (default: 1.0)

Parameters
value

number

Returns

void


geometry

Get Signature

get geometry(): GeometryBase

Defined in: src/components/renderer/MeshRenderer.ts:53

The geometry of the mesh determines its shape

Returns

GeometryBase

Set Signature

set geometry(value): void

Defined in: src/components/renderer/MeshRenderer.ts:57

Parameters
value

GeometryBase

Returns

void

Inherited from

MeshRenderer.geometry


material

Get Signature

get material(): Material

Defined in: src/components/renderer/MeshRenderer.ts:99

material

Returns

Material

Set Signature

set material(value): void

Defined in: src/components/renderer/MeshRenderer.ts:103

Parameters
value

Material

Returns

void

Inherited from

MeshRenderer.material


batchMode

Get Signature

get batchMode(): BatchMode

Defined in: src/components/renderer/RenderNode.ts:118

Returns

BatchMode

Set Signature

set batchMode(value): void

Defined in: src/components/renderer/RenderNode.ts:122

Parameters
value

BatchMode

Returns

void

Inherited from

MeshRenderer.batchMode


rendererMask

Get Signature

get rendererMask(): number

Defined in: src/components/renderer/RenderNode.ts:156

Returns

number

Set Signature

set rendererMask(value): void

Defined in: src/components/renderer/RenderNode.ts:160

Parameters
value

number

Returns

void

Inherited from

MeshRenderer.rendererMask


renderOrder

Get Signature

get renderOrder(): number

Defined in: src/components/renderer/RenderNode.ts:164

Returns

number

Set Signature

set renderOrder(value): void

Defined in: src/components/renderer/RenderNode.ts:168

Parameters
value

number

Returns

void

Inherited from

MeshRenderer.renderOrder


materials

Get Signature

get materials(): Material[]

Defined in: src/components/renderer/RenderNode.ts:177

Returns

Material[]

Set Signature

set materials(value): void

Defined in: src/components/renderer/RenderNode.ts:181

Parameters
value

Material[]

Returns

void

Inherited from

MeshRenderer.materials


castShadow

Get Signature

get castShadow(): boolean

Defined in: src/components/renderer/RenderNode.ts:413

Returns

boolean

Set Signature

set castShadow(value): void

Defined in: src/components/renderer/RenderNode.ts:417

Parameters
value

boolean

Returns

void

Inherited from

MeshRenderer.castShadow


castGI

Get Signature

get castGI(): boolean

Defined in: src/components/renderer/RenderNode.ts:440

Returns

boolean

Set Signature

set castGI(value): void

Defined in: src/components/renderer/RenderNode.ts:444

Parameters
value

boolean

Returns

void

Inherited from

MeshRenderer.castGI


castReflection

Get Signature

get castReflection(): boolean

Defined in: src/components/renderer/RenderNode.ts:448

Returns

boolean

Set Signature

set castReflection(value): void

Defined in: src/components/renderer/RenderNode.ts:452

Parameters
value

boolean

Returns

void

Inherited from

MeshRenderer.castReflection

Methods

start()

start(): void

Defined in: src/components/ComponentBase.ts:162

Returns

void

Inherited from

MeshRenderer.start


stop()

stop(): void

Defined in: src/components/ComponentBase.ts:163

Returns

void

Inherited from

MeshRenderer.stop


onUpdate()?

optional onUpdate(view?): any

Defined in: src/components/ComponentBase.ts:166

Parameters

view?

View3D

Returns

any

Inherited from

MeshRenderer.onUpdate


onLateUpdate()?

optional onLateUpdate(view?): any

Defined in: src/components/ComponentBase.ts:167

Parameters

view?

View3D

Returns

any

Inherited from

MeshRenderer.onLateUpdate


onBeforeUpdate()?

optional onBeforeUpdate(view?): any

Defined in: src/components/ComponentBase.ts:168

Parameters

view?

View3D

Returns

any

Inherited from

MeshRenderer.onBeforeUpdate


onGraphic()?

optional onGraphic(view?): any

Defined in: src/components/ComponentBase.ts:170

Parameters

view?

View3D

Returns

any

Inherited from

MeshRenderer.onGraphic


onParentChange()?

optional onParentChange(lastParent?, currentParent?): any

Defined in: src/components/ComponentBase.ts:171

Parameters

lastParent?

Object3D

currentParent?

Object3D

Returns

any

Inherited from

MeshRenderer.onParentChange


onAddChild()?

optional onAddChild(child): any

Defined in: src/components/ComponentBase.ts:172

Parameters

child

Object3D

Returns

any

Inherited from

MeshRenderer.onAddChild


onRemoveChild()?

optional onRemoveChild(child): any

Defined in: src/components/ComponentBase.ts:173

Parameters

child

Object3D

Returns

any

Inherited from

MeshRenderer.onRemoveChild


init()

init(): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:25

Returns

void

Overrides

MeshRenderer.init


setSunPosition()

setSunPosition(azimuth, elevation): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:248

Set sun position using spherical coordinates

Parameters

azimuth

number

Azimuth angle in radians (horizontal angle from north)

elevation

number

Elevation angle in radians (angle above horizon)

Returns

void


configureForGroundView()

configureForGroundView(): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:259

Configure for ground view (camera on Earth surface) Sets appropriate defaults for viewing sky from ground

Returns

void


configureForSpaceView()

configureForSpaceView(): void

Defined in: src/components/renderer/EarthAtmRenderer.ts:271

Configure for space view (camera in space looking at Earth) Sets appropriate defaults for viewing Earth from space

Returns

void


onEnable()

onEnable(): void

Defined in: src/components/renderer/MeshRenderer.ts:30

Returns

void

Inherited from

MeshRenderer.onEnable


onDisable()

onDisable(): void

Defined in: src/components/renderer/MeshRenderer.ts:34

Returns

void

Inherited from

MeshRenderer.onDisable


cloneTo()

cloneTo(obj): void

Defined in: src/components/renderer/MeshRenderer.ts:38

clone component data to target object3D

Parameters

obj

Object3D

target object3D

Returns

void

Inherited from

MeshRenderer.cloneTo


copyComponent()

copyComponent(from): this

Defined in: src/components/renderer/MeshRenderer.ts:43

Parameters

from

this

Returns

this

Inherited from

MeshRenderer.copyComponent


setMorphInfluence()

setMorphInfluence(key, value): void

Defined in: src/components/renderer/MeshRenderer.ts:110

Set deformation animation parameters

Parameters

key

string

value

number

Returns

void

Inherited from

MeshRenderer.setMorphInfluence


setMorphInfluenceIndex()

setMorphInfluenceIndex(index, value): void

Defined in: src/components/renderer/MeshRenderer.ts:119

Parameters

index

number

value

number

Returns

void

Inherited from

MeshRenderer.setMorphInfluenceIndex


onCompute()

onCompute(view, command): void

Defined in: src/components/renderer/MeshRenderer.ts:128

Parameters

view

View3D

command

GPUCommandEncoder

Returns

void

Inherited from

MeshRenderer.onCompute


destroy()

destroy(force?): void

Defined in: src/components/renderer/MeshRenderer.ts:157

Parameters

force?

boolean

Returns

void

Inherited from

MeshRenderer.destroy


attachSceneOctree()

attachSceneOctree(octree): void

Defined in: src/components/renderer/RenderNode.ts:87

Parameters

octree

Octree

Returns

void

Inherited from

MeshRenderer.attachSceneOctree


detachSceneOctree()

detachSceneOctree(): void

Defined in: src/components/renderer/RenderNode.ts:92

Returns

void

Inherited from

MeshRenderer.detachSceneOctree


addMask()

addMask(mask): void

Defined in: src/components/renderer/RenderNode.ts:144

Parameters

mask

RendererMask

Returns

void

Inherited from

MeshRenderer.addMask


removeMask()

removeMask(mask): void

Defined in: src/components/renderer/RenderNode.ts:148

Parameters

mask

RendererMask

Returns

void

Inherited from

MeshRenderer.removeMask


hasMask()

hasMask(mask): boolean

Defined in: src/components/renderer/RenderNode.ts:152

Parameters

mask

RendererMask

Returns

boolean

Inherited from

MeshRenderer.hasMask


addRendererMask()

addRendererMask(tag): void

Defined in: src/components/renderer/RenderNode.ts:232

Parameters

tag

RendererMask

Returns

void

Inherited from

MeshRenderer.addRendererMask


removeRendererMask()

removeRendererMask(tag): void

Defined in: src/components/renderer/RenderNode.ts:236

Parameters

tag

RendererMask

Returns

void

Inherited from

MeshRenderer.removeRendererMask


refreshRenderClassification()

refreshRenderClassification(): void

Defined in: src/components/renderer/RenderNode.ts:270

Recompute renderOrder from current pass states and re-bucket this renderer in EntityCollect (opaque vs transparent map).

Called when a material's alphaMode flips at runtime — the pass.renderOrder changes (3000 ↔ 0), but EntityCollect classifies once at addRenderNode time. Without this nudge the renderer stays in its old list and gets drawn through the wrong pipeline (e.g. WBOIT continues drawing a HASH-toggled material).

Materials hop into this via Reference.getReference(material) to find every renderer holding them; sample code can also call it directly after manual state changes.

Returns

void

Inherited from

MeshRenderer.refreshRenderClassification


selfCloneMaterials()

selfCloneMaterials(key): this

Defined in: src/components/renderer/RenderNode.ts:295

Parameters

key

string

Returns

this

Inherited from

MeshRenderer.selfCloneMaterials


renderPass()

renderPass(view, passType, renderContext): void

Defined in: src/components/renderer/RenderNode.ts:456

Parameters

view

View3D

passType

PassType

renderContext

RenderContext

Returns

void

Inherited from

MeshRenderer.renderPass


renderPass2()

renderPass2(view, passType, rendererPassState, clusterLightingBuffer, encoder, useBundle?): void

Defined in: src/components/renderer/RenderNode.ts:528

render pass at passType

Parameters

view

View3D

passType

PassType

rendererPassState

RendererPassState

clusterLightingBuffer

ClusterLightingBuffer

encoder

GPURenderPassEncoder

useBundle?

boolean = false

Returns

void

Inherited from

MeshRenderer.renderPass2


recordRenderPass2()

recordRenderPass2(view, passType, rendererPassState, clusterLightingBuffer, encoder, useBundle?): void

Defined in: src/components/renderer/RenderNode.ts:586

Parameters

view

View3D

passType

PassType

rendererPassState

RendererPassState

clusterLightingBuffer

ClusterLightingBuffer

encoder

GPURenderPassEncoder

useBundle?

boolean = false

Returns

void

Inherited from

MeshRenderer.recordRenderPass2


preInit()

preInit(_rendererType): boolean

Defined in: src/components/renderer/RenderNode.ts:624

Parameters

_rendererType

PassType

Returns

boolean

Inherited from

MeshRenderer.preInit


beforeDestroy()

beforeDestroy(force?): void

Defined in: src/components/renderer/RenderNode.ts:741

before release this component, object refrences are not be set null now.

Parameters

force?

boolean

Returns

void

Inherited from

MeshRenderer.beforeDestroy