¿Qué hace Integración con Pascal Editor?
Resumen
Pascal Editor (pascalorg/editor) es un editor de edificios 3D de código abierto construido con React Three Fiber y WebGPU. Proporciona un grafo de escena basado en nodos, gestión de estado con Zustand y una arquitectura de sistemas ideal para la generación arquitectónica impulsada por IA. Esta habilidad cubre la API principal para crear, manipular y exportar geometría de edificios.
Instrucciones
Inicio rápido
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
Jerarquía de nodos
Pascal utiliza un árbol de nodos tipados:
Sitio -> Edificio -> Nivel -> Muro -> Abertura (puerta/ventana)
-> Losa (suelo/techo)
-> Zona (límite de habitación)
-> Elemento (mueble, accesorio)
Cada nodo tiene: id (UUID), type, parentId, children (IDs de hijos), props (específicos del tipo) y dirty (marca para reconstrucción).
Stores de Zustand
import { useScene, useViewer, useEditor } from '@pascal-app/core'
// useScene -- grafo de escena (nodos, relaciones)
const { nodes, createNode, updateNode, deleteNode } = useScene()
// useViewer -- estado del viewport (cámara, selección)
const { selectedIds, camera, setSelection } = useViewer()
// useEditor -- modo de herramienta y estado de la interfaz
const { activeTool, setTool, history } = useEditor()
Creación de muros con aberturas
const scene = useScene.getState()
// Muro exterior: 4.5 m de largo, 200 mm de espesor, 2.7 m de altura
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)
// Añadir una ventana: 1.2 m de ancho, antepecho a 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)
// Añadir una puerta: 900 mm de ancho
await scene.createNode({
type: 'item',
props: {
itemType: 'door', wallId: wall.id,
offsetFromStart: 3.0, width: 0.9, height: 2.1, sillHeight: 0,
}
}, wall.id)
Creación de niveles y habitaciones
const level = await scene.createNode({
type: 'level',
props: { name: 'Planta baja', elevation: 0, height: 2.7, index: 0 }
}, buildingId)
// Losa de suelo
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)
// Zona de habitación para etiquetado y cálculo de área
await scene.createNode({
type: 'zone',
props: {
name: 'Salón', 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)
Exportación de la escena a 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),
}))
}
}
}
Renderizado con 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>
)
}
Ajuste a la cuadrícula
Pascal utiliza una cuadrícula de 100 mm (0.1 m) por defecto:
const snapToGrid = (value: number, gridSize = 0.1) =>
Math.round(value / gridSize) * gridSize
Ejemplos
Ejemplo 1: Construir una planta baja de 10m x 8m
Crea una planta baja completa con muros exteriores, una partición interior que separa el salón de los dormitorios y aberturas apropiadas:
- Crear nodo de nivel con elevación 0, altura 2.7 m
- Crear losa de suelo: polígono de 10 m x 8 m, espesor 0.25 m
- Crear 4 muros exteriores (0.20 m de espesor, mampostería): norte (10 m), este (8 m), sur (10 m), oeste (8 m)
- Añadir partición interior en x=5.5 (0.10 m de espesor, madera) que recorra toda la profundidad
- Añadir puerta de entrada en el muro norte: 1.0 m x 2.1 m a 3.5 m del inicio
- Añadir ventanas en el muro este: dos de 1.2 m x 1.2 m con antepecho a 0.9 m, a 1.2 m y 4.5 m del inicio
- Crear zonas: Salón (5.3 m x 7.8 m = 41.3 m2), área de dormitorios (4.3 m x 7.8 m = 33.5 m2)
- Exportar a JSON para validación con las reglas de
architectural-dimensions
Ejemplo 2: Registrar un sistema de validación personalizado
Crea un sistema que verifique el espesor de los muros cada vez que un nodo de muro cambia:
import { registerSystem, useScene } from '@pascal-app/core'
registerSystem({
name: 'validador-de-muros',
nodeTypes: ['wall'],
priority: 100,
process(dirtyNodes) {
for (const node of dirtyNodes) {
const { thickness, isExterior, height } = node.props
if (isExterior && thickness < 0.14)
console.warn(`Muro ${node.id}: exterior ${thickness}m < mínimo 0.14m`)
if (height < 2.1)
console.warn(`Muro ${node.id}: altura ${height}m < mínimo 2.1m`)
}
}
})
Esto se ejecuta automáticamente cada vez que los nodos de muro se marcan como sucios, antes de que los sistemas de geometría reconstruyan las mallas.
Directrices
- Todas las dimensiones están en metros: Pascal utiliza el sistema métrico internamente
- Usa
useScenepara todas las operaciones CRUD de nodos,useViewerpara selección/cámara,useEditorpara herramientas - Ajusta las coordenadas a la cuadrícula de 0.1 m para una geometría limpia
- Espesor de muros: 0.20 m para exteriores, 0.10 m para particiones interiores
- La altura del antepecho de las puertas es siempre 0 (a nivel del suelo); la altura del antepecho de las ventanas por defecto es 0.9 m
- Registra sistemas personalizados con prioridad > 50 para que se ejecuten antes de la reconstrucción de la geometría (0-50)
- Combínalo con la habilidad
architectural-dimensionspara la validación de medidas del mundo real - Paquetes clave:
@pascal-app/core,@pascal-app/ui,@react-three/fiber,three,zustand - GitHub: github.com/pascalorg/editor