Pascal编辑器集成 是做什么的?
概述
Pascal编辑器(pascalorg/editor)是一款基于React Three Fiber和WebGPU构建的开源3D建筑编辑器。它提供了基于节点的场景图、Zustand状态管理以及适用于AI驱动建筑生成的系统架构。本技能涵盖了创建、操作和导出建筑几何体的核心API。
说明
快速启动
npx create-next-app@latest my-building-app
cd my-building-app
npm install @pascal-app/core @pascal-app/ui @react-three/fiber @react-three/drei three zustand
节点层次
Pascal使用一颗类型化节点的树:
Site -> Building -> Level -> Wall -> Opening (door/window)
-> Slab (floor/ceiling)
-> Zone (room boundary)
-> Item (furniture, fixture)
每个节点包含:id(UUID)、type、parentId、children(子节点ID)、props(特定类型属性)和dirty(标记重建)。
Zustand状态Store
import { useScene, useViewer, useEditor } from '@pascal-app/core'
// useScene -- 场景图(节点、关系)
const { nodes, createNode, updateNode, deleteNode } = useScene()
// useViewer -- 视口状态(相机、选择)
const { selectedIds, camera, setSelection } = useViewer()
// useEditor -- 工具模式和UI状态
const { activeTool, setTool, history } = useEditor()
创建带开口的墙体
const scene = useScene.getState()
// 外墙:长4.5m,厚200mm,层高2.7m
const wall = await scene.createNode({
type: 'wall',
props: {
start: { x: 0, y: 0 }, end: { x: 4.5, y: 0 },
thickness: 0.20, height: 2.7,
isExterior: true, material: 'masonry',
}
}, levelId)
// 添加窗户:宽1.2m,窗台高900mm
await scene.createNode({
type: 'item',
props: {
itemType: 'window', wallId: wall.id,
offsetFromStart: 1.5, width: 1.2, height: 1.2, sillHeight: 0.9,
}
}, wall.id)
// 添加门:宽900mm
await scene.createNode({
type: 'item',
props: {
itemType: 'door', wallId: wall.id,
offsetFromStart: 3.0, width: 0.9, height: 2.1, sillHeight: 0,
}
}, wall.id)
创建楼层和房间
const level = await scene.createNode({
type: 'level',
props: { name: 'Ground Floor', elevation: 0, height: 2.7, index: 0 }
}, buildingId)
// 楼板
await scene.createNode({
type: 'slab',
props: {
polygon: [{ x: 0, y: 0 }, { x: 10, y: 0 }, { x: 10, y: 8 }, { x: 0, y: 8 }],
thickness: 0.25, isRoof: false,
}
}, level.id)
// 房间区域,用于标注和面积计算
await scene.createNode({
type: 'zone',
props: {
name: 'Living Room', roomType: 'living',
polygon: [{ x: 0.1, y: 0.1 }, { x: 5.4, y: 0.1 }, { x: 5.4, y: 7.9 }, { x: 0.1, y: 7.9 }],
}
}, level.id)
将场景导出为JSON
function exportScene(): BuildingExport {
const { nodes } = useScene.getState()
const allNodes = Object.values(nodes)
const site = allNodes.find(n => n.type === 'site')
const building = allNodes.find(n => n.type === 'building')
const levels = allNodes
.filter(n => n.type === 'level' && n.parentId === building.id)
.sort((a, b) => a.props.elevation - b.props.elevation)
return {
units: 'meters',
site: { width: site.props.width, depth: site.props.depth },
building: {
levels: levels.map(level => ({
name: level.props.name,
elevation: level.props.elevation,
height: level.props.height,
walls: getChildrenByType(level.id, 'wall', allNodes),
rooms: getChildrenByType(level.id, 'zone', allNodes),
}))
}
}
}
使用React Three Fiber渲染
import { Canvas } from '@react-three/fiber'
import { PascalScene, PascalCamera, PascalControls } from '@pascal-app/ui'
export function BuildingViewer() {
return (
<Canvas camera={{ position: [0, 20, 20], fov: 45 }}>
<PascalScene />
<PascalCamera />
<PascalControls />
<ambientLight intensity={0.5} />
<directionalLight position={[10, 20, 10]} castShadow />
</Canvas>
)
}
网格吸附
Pascal默认使用100 mm(0.1 m)网格:
const snapToGrid = (value: number, gridSize = 0.1) =>
Math.round(value / gridSize) * gridSize
示例
示例1:构建10m x 8m的底层
创建包含外墙、分隔起居室与卧室的内隔墙以及合适开口的完整底层:
- 创建楼层节点,标高0,高度2.7 m
- 创建楼板:10 m x 8 m多边形,厚度0.25 m
- 创建4面外墙(厚0.20 m,砌体):北墙(10 m)、东墙(8 m)、南墙(10 m)、西墙(8 m)
- 在x=5.5处添加内隔墙(厚0.10 m,木结构),贯穿整个进深
- 在北墙上添加入户门:1.0 m x 2.1 m,偏移3.5 m
- 在东墙上添加窗户:两扇1.2 m x 1.2 m,窗台高0.9 m,偏移分别为1.2 m和4.5 m
- 创建区域:起居室(5.3 m x 7.8 m = 41.3 m2),卧室区(4.3 m x 7.8 m = 33.5 m2)
- 导出为JSON,根据
architectural-dimensions规则进行验证
示例2:注册自定义验证系统
创建一个每当墙体节点变化时检查墙厚的系统:
import { registerSystem, useScene } from '@pascal-app/core'
registerSystem({
name: 'wall-validator',
nodeTypes: ['wall'],
priority: 100,
process(dirtyNodes) {
for (const node of dirtyNodes) {
const { thickness, isExterior, height } = node.props
if (isExterior && thickness < 0.14)
console.warn(`墙体 ${node.id}:外墙厚度 ${thickness}m 小于最小值 0.14m`)
if (height < 2.1)
console.warn(`墙体 ${node.id}:高度 ${height}m 小于最小值 2.1m`)
}
}
})
该验证会在墙体节点被标记为脏数据后自动运行,先于几何系统重建网格。
指南
- 所有尺寸单位均为米——Pascal内部使用公制
- 使用
useScene进行所有节点CRUD操作,useViewer用于选择/相机,useEditor用于工具 - 将坐标吸附到0.1 m网格以确保几何体整洁
- 墙厚:外墙0.20 m,内隔墙0.10 m
- 门底高度始终为0(楼板高度);窗台高度默认0.9 m
- 注册自定义系统时,优先级>50可保证在几何重建(0-50)之前运行
- 与
architectural-dimensions技能配合使用,以实现真实世界测量验证 - 关键包:
@pascal-app/core、@pascal-app/ui、@react-three/fiber、three、zustand - GitHub:github.com/pascalorg/editor