Class TransformEngine

constructor

• new TransformEngine(): TransformEngine

  Crée le moteur de transformation. Initialise les tableaux de fragments et transformations.

  Returns TransformEngine

fragments

transformations

animatePreviewSeparation

• animatePreviewSeparation(progress: number, maxSeparation?: number): void

  Anime la séparation des fragments pour preview (écartement radial).

  Parameters

  • progress: number

    Progression 0-1

  • OptionalmaxSeparation: number = 2.0

    Distance maximale de séparation

  Returns void

calculateAutoExtrudeDepth

• calculateAutoExtrudeDepth(boundingBox: Box3): number

  Calcule la profondeur d'extrusion automatique (5% de la taille moyenne de bbox).

  Parameters

  • boundingBox: Box3

    Boîte englobante du mesh

  Returns number

  Profondeur recommandée

calculateVertexNormals

• calculateVertexNormals(triangles: any[], vertices: Vector3[]): Vector3[]

  Calcule les normales par sommet en moyennant les normales des triangles adjacents.

  Parameters

  • triangles: any[]

    Triangles source

  • vertices: Vector3[]

    Sommets uniques

  Returns Vector3[]

  Normales par sommet

createFragmentMeshes

• createFragmentMeshes(material?: Material): Mesh[]

  Crée les meshes Three.js pour tous les fragments avec matériau. CORRECTION: Position initiale = centre original (géométrie déjà recentrée).

  Parameters

  • Optionalmaterial: Material = null

    Matériau à appliquer (défaut: MeshPhongMaterial orange)

  Returns Mesh[]

  Meshes créés

createVolumeConvexHull

• createVolumeConvexHull(region: any, inwardOffset?: number): any

  Crée un volume 3D par enveloppe convexe autour d'une région de surface. Génère des points internes par offset selon les normales pour épaisseur.

  Parameters

  • region: any

    Région avec vertexIndices, position, normal, seed

  • OptionalinwardOffset: number = 0.15

    Distance d'offset interne pour épaisseur

  Returns any

  Géométrie convexe ou null si < 4 points

createVolumeExtrusion

• createVolumeExtrusion(surfaceTriangles: any[], extrudeDepth: number): any

  Crée un volume 3D par extrusion des triangles de surface vers l'intérieur. Génère faces extérieures, intérieures et latérales de connexion.

  Parameters

  • surfaceTriangles: any[]

    Triangles de surface (v0, v1, v2)

  • extrudeDepth: number

    Profondeur d'extrusion

  Returns any

  Géométrie extrudée ou null si < 3 sommets

cutRegionsWithPlanes

• cutRegionsWithPlanes(
      regions: any[],
      planes: Plane[],
      depth?: number,
      maxDepth?: number,
  ): any[]

  Coupe récursivement des régions avec une liste de plans (BSP).

  Parameters

  • regions: any[]

    Régions à découper

  • planes: Plane[]

    Plans de coupe

  • Optionaldepth: number = 0

    Profondeur récursive actuelle

  • OptionalmaxDepth: number = 8

    Profondeur maximale

  Returns any[]

  Régions découpées

dispose

• dispose(): void

  Libère toutes les ressources (géométries et matériaux).

  Returns void

extractBoundaryEdges

• extractBoundaryEdges(triangles: any[], vertices: Vector3[]): number[][]

  Extrait les arêtes de bordure (arêtes présentes dans un seul triangle).

  Parameters

  • triangles: any[]

    Triangles de la région

  • vertices: Vector3[]

    Sommets uniques

  Returns number[][]

  Paires d'indices de sommets formant bordure

extractUniqueVertices

• extractUniqueVertices(triangles: any[]): Vector3[]

  Extrait les sommets uniques d'un ensemble de triangles (dédoublonnage spatial).

  Parameters

  • triangles: any[]

    Triangles avec v0, v1, v2

  Returns Vector3[]

  Sommets uniques

findClosestSeed

• findClosestSeed(point: Vector3, seeds: Vector3[]): number

  Trouve l'indice de la graine la plus proche d'un point.

  Parameters

  • point: Vector3

    Point à tester

  • seeds: Vector3[]

    Graines Voronoï

  Returns number

  Indice de la graine la plus proche

findVertexIndex

• findVertexIndex(vertex: Vector3, vertices: Vector3[]): number

  Trouve l'indice d'un sommet dans un tableau (comparaison avec epsilon).

  Parameters

  • vertex: Vector3

    Sommet à chercher

  • vertices: Vector3[]

    Tableau de sommets

  Returns number

  Indice ou -1 si non trouvé

fragmentMesh

• fragmentMesh(
      mesh: Mesh,
      fragmentCount?: number,
      partitionMethod?: string,
      volumeMethod?: string,
      options?: any,
  ): any[]

  Fragmente un mesh en morceaux volumétriques avec recentrage des géométries. CORRECTION: Les géométries sont translatées pour avoir leur centre en (0,0,0) local, garantissant des rotations et physiques correctes.

  Parameters

  • mesh: Mesh

    Mesh à fragmenter

  • OptionalfragmentCount: number = 30

    Nombre de fragments cibles

  • OptionalpartitionMethod: string = "bsp"

    Méthode de partition ("voronoi" | "bsp")

  • OptionalvolumeMethod: string = "extrusion"

    Méthode de volumétrisation ("convexhull" | "extrusion")

  • Optionaloptions: any = {}

    Options (inwardOffset, extrudeDepth)

  Returns any[]

  Tableau de fragments avec géométrie, position, vélocités

fragmentMeshSimple

• fragmentMeshSimple(
      mesh: Mesh,
      fragmentCount?: number,
      mode?: string,
      options?: any,
  ): any[]

  API simplifiée de fragmentation avec modes prédéfinis.

  Parameters

  • mesh: Mesh

    Mesh à fragmenter

  • OptionalfragmentCount: number = 30

    Nombre de fragments

  • Optionalmode: string = "bsp-extrusion"

    Mode ("voronoi-convex" | "voronoi-extrusion" | "bsp-convex" | "bsp-extrusion" | "hybrid" | "extrusion")

  • Optionaloptions: any = {}

    Options additionnelles

  Returns any[]

  Tableau de fragments

generateBSPPlanes

• generateBSPPlanes(geometry: BufferGeometry, count: number): Plane[]

  Génère des plans de coupe aléatoires pour partition BSP. 30% de plans alignés sur axes, 70% orientés aléatoirement.

  Parameters

  • geometry: BufferGeometry

    Géométrie source

  • count: number

    Nombre de plans

  Returns Plane[]

  Plans de coupe

generateVoronoiSeeds

• generateVoronoiSeeds(geometry: BufferGeometry, count: number): Vector3[]

  Génère des graines Voronoï distribuées sur la surface par échantillonnage d'aire. Les triangles plus grands ont plus de probabilité d'héberger une graine.

  Parameters

  • geometry: BufferGeometry

    Géométrie source

  • count: number

    Nombre de graines

  Returns Vector3[]

  Positions des graines

getAllTriangles

• getAllTriangles(geometry: BufferGeometry): any[]

  Extrait tous les triangles d'une géométrie indexée.

  Parameters

  • geometry: BufferGeometry

    Géométrie source

  Returns any[]

  Triangles avec v0, v1, v2

getEdgeKey

• getEdgeKey(i0: number, i1: number): string

  Génère des clés uniques pour identifier les arêtes (ordre canonique).

  Parameters

  • i0: number

    Indice sommet 1

  • i1: number

    Indice sommet 2

  Returns string

  Clé "i0,i1" avec i0 < i1

getFragmentMeshes

• getFragmentMeshes(): Mesh[]

  Retourne tous les meshes de fragments créés.

  Returns Mesh[]

  Meshes (null exclus)

parseEdgeKey

• parseEdgeKey(key: string): number[]

  Parse une clé d'arête en indices de sommets.

  Parameters

  • key: string

    Clé format "i0,i1"

  Returns number[]

  [i0, i1]

partitionBSP

• partitionBSP(geometry: BufferGeometry, count: number): any[]

  Partition par Binary Space Partitioning récursif. Coupe l'espace avec plans aléatoires orientés et positionnés près du centre.

  Parameters

  • geometry: BufferGeometry

    Géométrie source

  • count: number

    Nombre de plans de coupe

  Returns any[]

  Régions découpées avec triangles et bounds

partitionVoronoi

• partitionVoronoi(geometry: BufferGeometry, count: number): any[]

  Partition par diagramme de Voronoï avec échantillonnage pondéré par aire. Génère des graines sur la surface selon la densité de triangles.

  Parameters

  • geometry: BufferGeometry

    Géométrie source

  • count: number

    Nombre de régions Voronoï

  Returns any[]

  Régions avec triangles, indices de sommets et graine

reset

• reset(): void

  Réinitialise les fragments avec nouvelles vélocités d'explosion aléatoires.

  Returns void

resetToCompact

• resetToCompact(): void

  Réinitialise tous les fragments à leur position compacte d'origine (vélocités nulles).

  Returns void

splitRegionByPlane

• splitRegionByPlane(region: any, plane: Plane): any

  Divise une région en deux selon un plan (devant/derrière).

  Parameters

  • region: any

    Région avec triangles

  • plane: Plane

    Plan de coupe

  Returns any

  { front, back } avec triangles séparés

updateFragments

• updateFragments(deltaTime: number, gravity?: number, friction?: number): void

  Met à jour la physique des fragments (gravité, friction, position, rotation).

  Parameters

  • deltaTime: number

    Temps écoulé (secondes)

  • Optionalgravity: number = -9.8

    Accélération gravitationnelle

  • Optionalfriction: number = 0.98

    Coefficient de friction (0-1)

  Returns void