🎨 表面与纹理

Genesis 为渲染提供材质和纹理配置。

表面类型

表面	描述
Rough	哑光，无反光（roughness=1.0）
Smooth	抛光塑料（roughness=0.1）
Reflective	高反光（roughness=0.01）
Glass	带折射的透明材质
Metal	金属表面（铁、金等）
Water	水状表面
Emission	发光表面

基本用法

import genesis as gs

scene.add_entity(
    morph=gs.morphs.Sphere(pos=(0, 0, 1), radius=0.5),
    surface=gs.surfaces.Smooth(color=(0.8, 0.2, 0.2)),
)

表面属性

gs.surfaces.Smooth(
    color=(1.0, 1.0, 1.0),    # RGB（0-1）
    roughness=0.1,            # 0=镜面，1=哑光
    metallic=0.0,             # 0=介电质，1=金属
    opacity=1.0,              # 透明度
    emissive=(0.0, 0.0, 0.0), # 自发光
    ior=1.5,                  # 折射率
)

金属表面

# 预定义金属
gs.surfaces.Iron()
gs.surfaces.Gold()
gs.surfaces.Copper()
gs.surfaces.Aluminium()

# 自定义金属
gs.surfaces.Metal(metal_type="gold", roughness=0.15)

透明表面

# 玻璃
gs.surfaces.Glass(
    color=(0.9, 0.9, 1.0, 0.7),  # RGBA
    roughness=0.1,
    ior=1.5,
)

# 水
gs.surfaces.Water()

纹理

颜色纹理

gs.textures.ColorTexture(color=(1.0, 0.0, 0.0))

图像纹理

gs.textures.ImageTexture(
    image_path="textures/checker.png",
    encoding="srgb",  # 或 "linear" 用于非颜色数据
)

将纹理与表面结合使用

surface = gs.surfaces.Rough(
    diffuse_texture=gs.textures.ImageTexture(image_path="albedo.png"),
    roughness_texture=gs.textures.ImageTexture(image_path="roughness.png", encoding="linear"),
    normal_texture=gs.textures.ImageTexture(image_path="normal.png", encoding="linear"),
)

可视化模式

# 粒子可视化（用于流体）
gs.surfaces.Rough(color=(0.6, 0.8, 1.0), vis_mode="particle")

# 表面重建
gs.surfaces.Glass(color=(0.7, 0.85, 1.0, 0.7), vis_mode="recon")

环境贴图（光线追踪器）

scene = gs.Scene(
    renderer=gs.renderers.RayTracer(
        env_surface=gs.surfaces.Emission(
            emissive_texture=gs.textures.ImageTexture(image_path="hdri.hdr")
        ),
        env_radius=15.0,
    )
)