Bitbybit Docs
    Preparing search index...

    Class BabylonMaterialSky

    由大气设置而非图像计算得到的程序化白天天空:太阳在哪里、空气有多朦胧、天空有多亮。将该材质放在环绕场景的大型内翻长方体或球体上,用 inclinationazimuth 或显式的 sunPosition 移动太阳。

    Index

    Constructors

    create

    • 根据大气设置创建天空材质;只有你给出的值会覆盖默认值。

      inclination 从 -0.5 到 0.5 将太阳从地平线抬起,azimuth 从 0 到 1 使其绕天空转动;turbidity 增加雾霾,luminance 设置整体亮度。

      Parameters

      Returns SkyMaterial

      天空材质

      const sky = bitbybit.babylon.material.skyMaterial.create({ luminance: 1, turbidity: 10, rayleigh: 2, mieCoefficient: 0.005, mieDirectionalG: 0.8, distance: 500, inclination: 0.49, azimuth: 0.25, sunPosition: [0, 100, 100], useSunPosition: false, cameraOffset: [0, 0, 0], up: [0, 1, 0], dithering: false });
      const dome = bitbybit.babylon.meshBuilder.createSphere({ diameter: 1000, segments: 32, sideOrientation: Bit.Inputs.BabylonMesh.sideOrientationEnum.backside, enableShadows: false });
      bitbybit.babylon.mesh.setMaterial({ babylonMesh: dome, material: sky, includeChildren: false });

    get

    • 读取天空材质的整体亮度。

      Parameters

      Returns number

      亮度

    • 读取天空材质的空气有多雾。

      Parameters

      Returns number

      浑浊度

    • 读取天空材质的瑞利散射强度,即决定其蓝色的设置。

      Parameters

      Returns number

      瑞利散射值

    • 读取天空材质在太阳周围的雾霾量。

      Parameters

      Returns number

      米氏散射系数

    • 读取天空材质的雾霾光晕在太阳周围聚集的紧密程度。

      Parameters

      Returns number

      米氏散射方向值

    • 读取天空材质中天空穹顶距相机多远。

      Parameters

      Returns number

      距离

    • 读取天空材质中太阳的高度,从 -0.5 到 0.5。

      Parameters

      Returns number

      倾角

    • 读取天空材质中太阳在地平线周围的位置,从 0 到 1。

      Parameters

      Returns number

      方位角

    • 读取天空材质的太阳方向;useSunPosition 关闭时它反映倾角和方位角。

      Parameters

      Returns Vector3

      太阳位置向量

    • 读取天空材质是根据 sunPosition 而不是根据倾角和方位角放置太阳。

      Parameters

      Returns boolean

      当使用显式太阳位置时为 true

    • 读取天空材质是否对其渐变进行抖动以隐藏色带。

      Parameters

      Returns boolean

      当启用抖动时为 true

    set

    • 更改天空材质的整体亮度,在 0 和 1 之间。

      Parameters

      Returns void

    • 更改天空材质的空气有多雾;雾霾越多,天空越发白,太阳的光晕越散开。

      Parameters

      Returns void

    • 更改天空材质以使晴空呈蓝色的方式散射光的强度;越高蓝色越深、越亮。

      Parameters

      Returns void

    • 更改天空材质在太阳周围的雾霾量,在 0 和 0.1 之间;越多光晕越宽、越白。

      Parameters

      Returns void

    • 更改天空材质的雾霾光晕在太阳周围聚集的紧密程度;接近 1 的值形成小而亮的光环,更低的值使其散开。

      Parameters

      Returns void

    • 更改天空材质中天空穹顶距相机多远,这会改变地平线的观感。

      Parameters

      Returns void

    • 更改天空材质中太阳的高度,从 -0.5 表示地平线以下,经 0 表示地平线,到 0.5 表示头顶正上方;useSunPosition 打开时忽略。

      Parameters

      Returns void

      bitbybit.babylon.material.skyMaterial.setInclination({ material: sky, inclination: 0.1 });
      
    • 更改天空材质中太阳在地平线周围的位置,从 0 到 1 为一整圈;useSunPosition 打开时忽略。

      Parameters

      Returns void

    • 将天空材质的太阳放置在一个明确的方向向量上;仅当 useSunPosition 打开时生效,否则由倾角和方位角决定。

      Parameters

      Returns void

      bitbybit.babylon.material.skyMaterial.setUseSunPosition({ material: sky, useSunPosition: true });
      bitbybit.babylon.material.skyMaterial.setSunPosition({ material: sky, sunPosition: [0, 50, 100] });
    • 选择天空材质是根据 sunPosition(为 true 时)还是根据倾角和方位角(为 false 时)放置太阳。

      Parameters

      Returns void

    • 按偏移向量移动天空材质的地平线,使天空相对相机可以更高或更低。

      Parameters

      Returns void

    • 更改天空材质视为向上的方向,通常为 [0, 1, 0];为使用其他轴作为向上方向的场景更改它。

      Parameters

      • inputs: UpDto

        材质和上方向向量

      Returns void

    • 为天空材质打开或关闭抖动;打开时会添加细微噪点,以隐藏平滑渐变中的色带。

      Parameters

      Returns void