三维示例库
三维示例库
仓库提供两套三维示例，均为一对文件：*.vp.tsx（VP-TSX 源码，可改后重编）+ *.vpproj.json（编译产物，编辑器首页「导入项目文件」直接用）。除标注外全部零外部素材、离线可跑。
| 目录 | 数量 | 定位 |
|---|---|---|
data/三维/场景/ | 45 | 逐功能 + 综合大屏：从基础场景到组态/行业实战，按主题演示能力组合 |
data/三维/元素/ | 40 | 逐组件：三维元素每种一个工程（车流的完整演示见 map3d/45 收费站），选项尽量一次配全，带按钮控制台与交互三件套 |
不想下载也能先看
data/三维/元素/ 这 40 个工程的场景已内嵌进三维元素手册的五个分类页——每种元素一份在线预览，点开即跑（vjmap 官方公开服务，联网可用）。想要按钮控制台与完整交互，再导入这里的工程文件。
# 改源码重编（仓库根执行）
pnpm exec tsx .cursor/skills/generate-vp-project/scripts/vptsx/compile.mts "data/三维/场景/01-基础场景与材质.vp.tsx" -o "data/三维/场景/01-基础场景与材质.vpproj.json"
# 或全部重编（`data/三维/元素` 目录同理有自己的 compile-all.ps1）
powershell -NoProfile -ExecutionPolicy Bypass -File data/三维/场景/compile-all.ps1逐功能与综合大屏（data/三维/场景/，45 个）
基础与场景（01–05）
| # | 示例 | 看点 |
|---|---|---|
| 01 | 基础场景与材质 | 七种几何体 × PBR 材质、阴影、环境反射 |
| 02 | 灯光与阴影 | 五种灯光、聚光锥角、2048 阴影 |
| 03 | 相机操控与自动环绕 | orbit 巡航、操控限制、雾效 |
| 04 | 视角书签与巡航 | 书签巡航 + scene3dFlyTo |
| 05 | 值标签与测点驱动 | 状态色、告警闪烁、写测点 |
组态与特效（06–18）
| # | 示例 | 看点 |
|---|---|---|
| 06 | 管道与飞线 | 流动规则、脉冲飞线、辉光 |
| 07 | 粒子特效 | 火焰/烟雾/雨/雪同屏 |
| 08 | 模型加载与爆炸 | glb 骨骼动画、爆炸分解（需外网模型） |
| 09 | 交互-点击与联动 | 点击特写、triggerTarget 精确分发 |
| 10 | CAD 转 3D | CAD 图纸按规则转墙体/体块/线稿（需 vjmap 服务） |
| 11 | 同页多实例 | 双场景互不串扰 |
| 12 | 特效材质秀 | 全息/玻璃/流光/Shadertoy/镜面五件套 |
| 13 | 辉光与描边 | bloom + 悬停/点击描边 |
| 14 | 光墙围栏与雷达 | 电子围栏流光、雷达扇区、告警变色 |
| 15 | 热力图 | 2D/3D 双模式、JSON 整批刷新 |
| 16 | 路径动画与巡检漫游 | 路径循环/往返、相机路径漫游 |
| 17 | 三维文字与标记 | 广告牌/固定字、三种标记 |
| 18 | 交互增强 | 悬停触发器、高亮/显隐/模型动画动作 |
综合大屏（19–30）
| # | 示例 | 看点 |
|---|---|---|
| 19 | 综合演示·智慧园区 | 入场飞入 + 悬停气泡 + 双击聚焦 + LED + 全能力门面 |
| 20 | 星空风机牧场 | 程序化星空、自转风机、镜面湖 |
| 21 | 应急疏散演练 | 导引线告警联动、弹窗、截图 |
| 22 | 拉伸体园区与测量 | 流光楼群、三向尺寸线 |
| 23 | 数据机房总控 | 机柜列阵 + 温度热力地板 + 小地图 + 巡检 AGV |
| 24 | 视频融合安防中心 | 三块监控屏 VideoTexture（需外网样例视频） |
| 25 | 设备剖切检修 | 剖切面步进/换轴/复位 |
| 26 | 智慧仓储日夜总控 | 点云货位 + scene3dSetOption 日夜一键切换 |
| 27 | 智慧车站信息屏 | 三块 LED 字幕屏 + 告警联动 |
| 28 | 地下综合管廊 | 三色分支管网拓扑 + 剖切 + 泄漏告警 |
| 29 | 第一人称机房巡检 | WASD 行走 + 小地图 |
| 30 | 综合总控·智慧工厂全景 | R1~R5 全家桶 + 剖切/步行/辉光/快照按钮 |
GIS 与新能力（31–39）
| # | 示例 | 看点 |
|---|---|---|
| 31 | 智慧水厂工艺总控 | 四座液位罐实时升降 + 数据看板牌 + 告警光柱 |
| 32 | 智慧城市地标夜景 | 五色 POI 光柱 + 顶牌看板 + 飞线汇聚 |
| 33 | 瓦片地图智慧城域 | OSM 真实地图铺底 + 运行时换底图三风格（需联网） |
| 34 | CAD图纸瓦片与行政区裁剪 | CAD 瓦片当底图 + 京域轮廓裁剪正反选 |
| 35 | 城市体块与图标点位 | 批量楼块 + 精灵点位 JSON 重排 + 区域面告警 + 右键详情 |
| 36 | 倾斜摄影实景 | Cesium 3D Tiles 按视距加载（需外网） |
| 37 | 智慧展厅迎宾大屏 | 粒子文字聚字 + 霓虹线条三动画 + CSS3D 立牌 |
| 38 | 庆典夜景与光晕特效 | 镜头光晕 + 烟花 + 指数雾 + 呼吸脉动 |
| 39 | 三维地图特效全景秀 | 瓦片地图上叠 14 层特效的旗舰演示（需联网） |
组态实战三连（40–42）
对标图扑 / 山海鲸风格的真实生产场景，共享同一套「设备属性面板」交互范式，可直接当业务模板：
| # | 示例 | 看点 |
|---|---|---|
| 40 | 组态实战·中央空调冷站群控 | 2 冷机 + 4 泵 + 2 塔全程序化拼装、四色工艺管路流动逐列跟泵启停、每台设备专属属性面板（台账 + 启停 + 故障复位）、一键顺控开机 / 停机、主机故障演练联锁 |
| 41 | 组态实战·化工储运罐区 | 三座立式储罐（mm 量程液位 + 高低位闪烁）、泵棚三泵 + 电动调节阀、装车鹤位与槽罐车循环、可燃气体探测点云、泄漏着火演练（火焰烟雾 + 联锁切断 + 消防车出动）与一键复位 |
| 42 | 组态实战·110kV 变电站 | 4 台 SF6 断路器 + 2 台主变程序化拼装、6 段潮流箭头逐段跟断路器分合闸、一键顺控送电 / 全站停电、主变过载演练（红闪 + 风冷自动投运）、遥控列表红合绿分 |
范式要点：①每台可控设备一个 group-popup 属性面板；②场景 scene3d-piece-click 用多目标条目（actions[] 每项带 triggerTarget，设备的每个部件 uid 都注册）实现「点谁开谁的面板」；③面板按钮组合动作 = scene3dWritePoint 写状态测点（驱动变色 / 闪烁 / 管路流动）+ scene3dSetOption 开关旋转件 + changeOption 同步 2D 状态文本。易错点：交互 targetPath 对任意嵌套深度的组件都是扁平两段 [screenUid, widgetUid]；多动作按钮里每个动作都要 start:'meanwhile'（此时 delay 才是相对点击时刻的绝对偏移，顺控时序不失真）。
行业实战（43–45）
| # | 示例 | 看点 |
|---|---|---|
| 43 | 人员定位系统·CAD 巷道与人员定位 | CAD 多段线转拱形巷道网络（net-source=cad）+ 人员点位 follow-net 图纸坐标换算 + 演示行走生成器；点击人员出详情与光波、scene3dPersonTrail 轨迹回放（相机跟随）、scene3dNetRoute 最近出口路线高亮（需 vjmap 服务） |
| 44 | 智慧家居全屋智控 | 三居室真实户型程序化建模（墙体开洞 + 全屋家具 40+ 件）+ 9 类可控设备各带属性面板；「回家/离家/观影/睡眠」情景一键时序联动、燃气演练联锁、WASD 第一人称参观（零素材离线） |
| 45 | 收费站管理云平台 | toll.glb 模型子对象驱动：车流 scene3d-carflow 自动配对车道与抬杆循环过车；点谁的收费窗口弹谁的值班详情（triggerTarget 复合键 w_toll#SF00x）、点抬杆 scene3dTween 手动抬/降（需外网模型） |
逐组件示例（data/三维/元素/，40 个）
三维元素手册里的三维元素每种对应一个示例工程（01-scene-场景设置 … 40-persons-人员点位，文件名即元素序号 + type + 中文名；车流 scene3d-carflow 的完整演示见 data/三维/场景/45-收费站管理云平台）。每个工程聚焦一个元素，把它的选项尽量一次配全，并统一带：
- 多实例对比：同屏摆多份不同参数的实例，直观看出每个选项的效果差异。
- 测点绑定：场景绑测点长表，元素配
data-key+state-rules/flow-rules/blink-values。 - 按钮控制台（左栏）：
scene3dWritePoint/scene3dSetOption/scene3dSetVisible等动作实时改属性、模拟工况。 - 交互三件套：单击信息条回显（
{:name}/{:pieceType}）、双击聚焦（scene3dFocus）、悬停气泡 + 描边（后期效果），点空白复位。
其中 07 形状为双页面工程（几何材质页 / 动画数据页，顶部按钮 switchScreen 互切），11 号另演示 {:hitX} 命中坐标回显；36 序列帧的精灵图为编译期生成的 SVG data-URI 条带（零素材技巧，生产上换美术 png 条带或 TexturePacker 图集同一套配置）。需外网 / 服务的：10（公网 glb）、11（3D Tiles）、13（在线瓦片）、25（公网 mp4）、12（vjmap 服务）、39（Lottie JSON + 引擎插件服务）、40（人物模型档为公网士兵 glb，切「图标精灵」档即离线）及 06 的「在线预设库」类型，其余 32 个零素材离线可跑。
每个示例的完整覆盖点与测试要点见仓库 data/三维/场景/README.md 与 data/三维/元素/README.md。