Que fait Intégration de l'Éditeur Pascal ?
Aperçu
L'Éditeur Pascal (pascalorg/editor) est un éditeur de bâtiments 3D open source construit avec React Three Fiber et WebGPU. Il fournit un graphe de scène basé sur des nœuds, la gestion d'état Zustand et une architecture de systèmes idéale pour la génération architecturale pilotée par IA. Cette compétence couvre l'API de base pour créer, manipuler et exporter la géométrie des bâtiments.
Instructions
Démarrage rapide
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
Hiérarchie des nœuds
Pascal utilise un arbre de nœuds typés :
Site -> Bâtiment -> Niveau -> Mur -> Ouverture (porte/fenêtre)
-> Dalle (sol/plafond)
-> Zone (limite de pièce)
-> Élément (meuble, accessoire)
Chaque nœud possède : id (UUID), type, parentId, children (IDs enfants), props (spécifiques au type) et dirty (marque pour reconstruction).
Stores Zustand
import { useScene, useViewer, useEditor } from '@pascal-app/core'
// useScene -- graphe de scène (nœuds, relations)
const { nodes, createNode, updateNode, deleteNode } = useScene()
// useViewer -- état de la vue (caméra, sélection)
const { selectedIds, camera, setSelection } = useViewer()
// useEditor -- mode outil et état de l'interface utilisateur
const { activeTool, setTool, history } = useEditor()
Création de murs avec ouvertures
const scene = useScene.getState()
// Mur extérieur : 4,5 m de long, 200 mm d'épaisseur, 2,7 m de hauteur sous plafond
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)
// Ajouter une fenêtre : 1,2 m de large, appui à 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)
// Ajouter une porte : 900 mm de large
await scene.createNode({
type: 'item',
props: {
itemType: 'door', wallId: wall.id,
offsetFromStart: 3.0, width: 0.9, height: 2.1, sillHeight: 0,
}
}, wall.id)
Création de niveaux et de pièces
const level = await scene.createNode({
type: 'level',
props: { name: 'Rez-de-chaussée', elevation: 0, height: 2.7, index: 0 }
}, buildingId)
// Dalle de sol
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)
// Zone de pièce pour étiquetage et calcul de surface
await scene.createNode({
type: 'zone',
props: {
name: 'Salon', 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)
Exportation de la scène au format 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),
}))
}
}
}
Rendu avec 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>
)
}
Accrochage à la grille
Par défaut, Pascal utilise une grille de 100 mm (0.1 m) :
const snapToGrid = (value: number, gridSize = 0.1) =>
Math.round(value / gridSize) * gridSize
Exemples
Exemple 1 : Construire un rez-de-chaussée de 10 m x 8 m
Créez un rez-de-chaussée complet avec murs extérieurs, une cloison intérieure séparant le salon des chambres, et des ouvertures appropriées :
- Créez un nœud de niveau avec elevation 0, height 2.7 m
- Créez une dalle de sol : polygone 10 m x 8 m, épaisseur 0,25 m
- Créez 4 murs extérieurs (0,20 m d'épaisseur, maçonnerie) : nord (10 m), est (8 m), sud (10 m), ouest (8 m)
- Ajoutez une cloison intérieure à x=5.5 (0,10 m d'épaisseur, bois) sur toute la profondeur
- Ajoutez une porte d'entrée sur le mur nord : 1,0 m x 2,1 m à un décalage de 3,5 m
- Ajoutez des fenêtres sur le mur est : deux fenêtres de 1,2 m x 1,2 m avec appui à 0,9 m, décalages de 1,2 m et 4,5 m
- Créez des zones : Salon (5,3 m x 7,8 m = 41,3 m2), Zone chambres (4,3 m x 7,8 m = 33,5 m2)
- Exportez au format JSON pour validation selon les règles
architectural-dimensions
Exemple 2 : Enregistrer un système de validation personnalisé
Créez un système qui vérifie l'épaisseur des murs à chaque modification d'un nœud de mur :
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(`Mur ${node.id}: extérieur ${thickness}m < 0.14m minimum`)
if (height < 2.1)
console.warn(`Mur ${node.id}: hauteur ${height}m < 2.1m minimum`)
}
}
})
Ce système s'exécute automatiquement lorsque les nœuds de mur sont marqués comme sales, avant que les systèmes de géométrie ne reconstruisent les maillages.
Directives
- Toutes les dimensions sont en mètres -- Pascal utilise le système métrique en interne
- Utilisez
useScenepour toutes les opérations CRUD sur les nœuds,useViewerpour la sélection/caméra,useEditorpour les outils - Accrochez les coordonnées à la grille de 0,1 m pour une géométrie propre
- Épaisseur des murs : 0,20 m pour les murs extérieurs, 0,10 m pour les cloisons intérieures
- La hauteur du seuil de porte est toujours 0 (au niveau du sol) ; la hauteur d'appui de fenêtre par défaut est de 0,9 m
- Enregistrez les systèmes personnalisés avec une priorité > 50 pour qu'ils s'exécutent avant la reconstruction de la géométrie (0-50)
- Combinez avec la compétence
architectural-dimensionspour la validation des mesures réelles - Packages clés :
@pascal-app/core,@pascal-app/ui,@react-three/fiber,three,zustand - GitHub : github.com/pascalorg/editor