SuperAPI AI 工具集

advanced-rendering

通用与其它

查看项目

更新于 10-15 20:34

技能介绍

用途:为 Decentraland 场景提供高级渲染能力,包括实体朝向相机、三维世界文字、自定义 PBR 材质、模型节点级覆盖与纹理动画。

主要能力:Billboard 支持 BM_Y、BM_ALL、BM_X、BM_Z、BM_NONE 等模式,常用 BM_Y 保持竖直且渲染更省;TextShape 在三维空间渲染文字,支持 fontSize、textColor、outlineColor、outlineWidth 及九种对齐方式;Material.setPbrMaterial 可设置 metallic、roughness、albedoColor、transparencyMode(MTM_ALPHA_BLEND 平滑透明、MTM_ALPHA_TEST 阈值裁切)、emissiveColor(Color3)与 emissiveIntensity,并支持 diffuse、bump、emissive 贴图;GltfContainer 通过 visibleMeshesCollisionMask 与 invisibleMeshesCollisionMask 控制网格层可见性与碰撞;VisibilityComponent 可隐藏或切换实体而不删除,适合 LOD;GltfNodeModifiers 按 GLTF 层级路径覆盖材质或阴影,path 传空字符串可作用于整模型;Tween 支持纹理偏移/平铺的连续或有限动画,运行时可用 Tween.setTextureMove 与 Tween.setTextureMoveContinuous;另支持 Avatar 纹理与 TFM_POINT、TFM_BILINEAR、TFM_TRILINEAR 过滤模式及 TWM_REPEAT、TWM_CLAMP、TWM_MIRROR 环绕模式。

使用方式:视觉实体应在 main-entities.ts 中声明,运行时修改(如切换可见性)放在 src/index.ts。示例中 engine.addEntity() 加 Transform.create 的写法属于旧模式,需迁移到 main-entities.ts。

适用场景:NPC 浮动名牌、招牌、发光道具、水面或传送带滚动纹理、按距离切换显示的 LOD 系统。

限制:屏幕 UI 文字应改用 build-ui 的 React-ECS Label;emissiveColor 使用 Color3 而非 Color4;MTM_ALPHA_TEST 比 MTM_ALPHA_BLEND 更省性能。具体收费、价格与平台信息暂未提供。