Pascal Editor Integration
Überblick
Pascal Editor (pascalorg/editor) ist ein Open-Source-3D-Gebäudeditor, der mit React Three Fiber und WebGPU erstellt wurde. Er bietet einen knotenbasierten Szenegraph, Zustand-Statusverwaltung und eine Systemarchitektur, die ideal für KI-gesteuerte Architekturgenerierung ist. Diese Skill-Anleitung behandelt die Kern-API zum Erstellen, Manipulieren und Exportieren von Gebäudegeometrie.
Anleitung
Schnellstart
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
Knotenhierarchie
Pascal verwendet einen Baum typisierter Knoten:
Site -> Building -> Level -> Wall -> Opening (door/window)
-> Slab (floor/ceiling)
-> Zone (room boundary)
-> Item (furniture, fixture)
Jeder Knoten hat: id (UUID), type, parentId, children (Kind-IDs), props (typspezifisch) und dirty (Markierung für Neuerstellung).
Zustand Stores
import { useScene, useViewer, useEditor } from '@pascal-app/core'
// useScene -- Szenegraph (Knoten, Beziehungen)
const { nodes, createNode, updateNode, deleteNode } = useScene()
// useViewer -- Viewport-Zustand (Kamera, Auswahl)
const { selectedIds, camera, setSelection } = useViewer()
// useEditor -- Werkzeugmodus und UI-Zustand
const { activeTool, setTool, history } = useEditor()
Wände mit Öffnungen erstellen
const scene = useScene.getState()
// Außenwand: 4,5 m lang, 200 mm dick, 2,7 m Deckenhöhe
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)
// Fenster hinzufügen: 1,2 m breit, Brüstung bei 900 mm
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)
// Tür hinzufügen: 900 mm breit
await scene.createNode({
type: 'item',
props: {
itemType: 'door', wallId: wall.id,
offsetFromStart: 3.0, width: 0.9, height: 2.1, sillHeight: 0,
}
}, wall.id)
Ebenen und Räume erstellen
const level = await scene.createNode({
type: 'level',
props: { name: 'Erdgeschoss', elevation: 0, height: 2.7, index: 0 }
}, buildingId)
// Bodenplatte
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)
// Raumzone zur Beschriftung und Flächenberechnung
await scene.createNode({
type: 'zone',
props: {
name: 'Wohnzimmer', 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)
Szene nach JSON exportieren
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),
}))
}
}
}
Rendern mit 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>
)
}
Rasterfangen
Pascal verwendet standardmäßig ein 100-mm-Raster (0,1 m):
const snapToGrid = (value: number, gridSize = 0.1) =>
Math.round(value / gridSize) * gridSize
Beispiele
Beispiel 1: Ein 10 m x 8 m Erdgeschoss bauen
Erstellen Sie ein vollständiges Erdgeschoss mit Außenwänden, einer Innenwand, die Wohn- und Schlafbereiche trennt, und passenden Öffnungen:
- Ebenenknoten mit Elevation 0, Höhe 2,7 m erstellen
- Bodenplatte erstellen: 10 m x 8 m Polygon, 0,25 m dick
- 4 Außenwände (0,20 m dick, Mauerwerk) erstellen: Nord (10 m), Ost (8 m), Süd (10 m), West (8 m)
- Innenwand bei x=5,5 (0,10 m dick, Holz) über die gesamte Tiefe einfügen
- Eingangstür an der Nordwand: 1,0 m x 2,1 m bei Versatz 3,5 m
- Fenster an der Ostwand: zwei 1,2 m x 1,2 m mit Brüstung 0,9 m, Versätze 1,2 m und 4,5 m
- Zonen erstellen: Wohnzimmer (5,3 m x 7,8 m = 41,3 m2), Schlafzimmerbereich (4,3 m x 7,8 m = 33,5 m2)
- Nach JSON exportieren zur Validierung gegen
architectural-dimensionsRegeln
Beispiel 2: Ein benutzerdefiniertes Validierungssystem registrieren
Erstellen Sie ein System, das die Wandstärke prüft, sobald sich ein Wandknoten ändert:
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(`Wall ${node.id}: exterior ${thickness}m < 0.14m minimum`)
if (height < 2.1)
console.warn(`Wall ${node.id}: height ${height}m < 2.1m minimum`)
}
}
})
Dieses System wird automatisch ausgeführt, wenn Wandknoten als verändert markiert wurden, bevor die Geometriesysteme die Netze neu aufbauen.
Richtlinien
- Alle Abmessungen sind in Metern – Pascal verwendet intern metrische Einheiten
- Verwenden Sie
useScenefür alle Knoten-CRUD-Operationen,useViewerfür Auswahl/Kamera,useEditorfür Werkzeuge - Rastern Sie Koordinaten auf ein 0,1-m-Raster für saubere Geometrie
- Wandstärke: 0,20 m für Außenwände, 0,10 m für Innenwände
- Türbrüstungshöhe ist immer 0 (Fußbodenniveau); Fensterbrüstungshöhe beträgt standardmäßig 0,9 m
- Registrieren Sie benutzerdefinierte Systeme mit Priorität > 50, um vor dem Geometrie-Neuaufbau ausgeführt zu werden (0-50)
- Kombinieren Sie mit der
architectural-dimensionsSkill für Validierung realer Maße - Wichtige Pakete:
@pascal-app/core,@pascal-app/ui,@react-three/fiber,three,zustand - GitHub: github.com/pascalorg/editor