Intégrez le visualiseur IFC dans votre propre produit

Monter dans un sélecteur CSS ou un élément. Voir les options ci-dessous.

Crée un visualiseur et se résout dès qu’il peut accepter des commandes.

Charger des octets IFC (ArrayBuffer/Uint8Array) depuis votre app. Le buffer est transféré pour un passage sans copie.

Charger une URL IFC publique compatible CORS.

Décharge un modèle par id.

Supprimer tous les modèles chargés.

Sélectionner et cadrer un élément — par son expressID IFC ou par son GlobalId (qui trouve aussi son modèle).

Voler vers une vue nommée de la scène — iso, front, back, left, right, top, bottom — avec toute la scène dans le cadre. Sans réponse (de 1.14 à 1.17 la visionneuse l’ignorait).

Cadrage de présentation : le modèle occupe `fill` du cadre (0,2–0,98, 0,85 par défaut), ajusté à ses coins plutôt qu’à sa sphère englobante. azimuth / elevation choisissent l’angle.

Cadrer un élément (expressID) : depuis l’angle actuel sauf si une vue est donnée. Rejette s’il n’est pas dans le modèle.

Cadrer le modèle actif depuis l’angle actuel, avec une marge / réinitialiser la caméra.

Place la caméra à une position regardant dans une direction.

Où est la caméra et ce qu’elle regarde — enregistrez-le, restaurez-le avec lookAt.

Amène la caméra à une position, regardant une cible (mètres de scène, Y vers le haut).

Mode visite à la première personne (WASD, glisser pour regarder, Échap pour sortir). Émet walk-changed.

Si le mode visite est actif, et à quelle vitesse.

Isoler une catégorie (p. ex. "IfcWall") ; omettre pour réinitialiser.

Restaurer toute la visibilité (annuler masquage + isolation).

Masque / affiche un ensemble d’éléments par expressID.

Affiche ou masque un modèle d'une scène fédérée sans le décharger.

Rend un modèle translucide (0,05–1) — p. ex. l’architecture autour des lots techniques.

N’affiche que ce modèle ; null les réaffiche tous.

Change le fond de la scène : un préréglage ('white', 'paper', 'blueprint', 'sky', 'studio'), '#rrggbb', '#haut,#bas' ou { top, bottom }. Non enregistré comme préférence du visiteur.

Le fond actuel de la scène.

Change la couleur d'accent de l'interface à l'exécution (#rrggbb).

Active ou désactive la vue client — celle des parties prenantes, comme ui: 'client'.

'quality' active le rendu plus lourd pour une image phare ; 'standard' au quotidien.

Ombres réelles à une date et une heure locales du site : { date: '06-21', time: '18:00' }. Le site vient du géoréférencement IFC ; passez location pour un modèle qui n’en a pas — jamais une ville par défaut en silence.

Date, heure et fuseau de l'étude, et où se trouve le site.

Place le modèle sur la carte avec le relief et les environs OpenStreetMap. L’appeler, c’est votre page qui déclare le consentement aux tuiles pour ses visiteurs ; affichez les attributions.

État du mode carte, le placement et les attributions à afficher.

Ouvrir une autre scène : l’URL d’un .scene.json, ou un document de scène (il voyage compressé dans l’adresse du cadre et doit tenir dans un lien). La visionneuse se recharge ; les appels en attente sont rejetés et ready se déclenche de nouveau.

La scène à l’écran comme document de scène — modèles par URL, couches, jumeau, carte, caméra — avec les sources à créditer et un lien qui la contient.

Compresser soi-même un document de scène pour un lien #scene= (null s’il est trop gros pour un lien).

Le catalogue des sources publiques en direct, nommées dans la langue de la visionneuse, avec ce qu’il faut à chacune dans un navigateur (une clé, un proxy) et si elle a des données près du site.

Ajouter une couche : une source du catalogue ({ preset }), du GeoJSON ou un flux en direct à une URL ({ url, live }), ou du GeoJSON que vous avez déjà ({ geojson }). Pour la session seulement : jamais enregistrée dans les couches du visiteur.

Toutes les couches de données : état, nombre d’entités, emprise, rafraîchissement et attribution.

Afficher ou masquer une couche.

Amener la caméra sur les entités d’une couche.

Retirer une couche.

Le jumeau opérationnel maintenant : sources d’appareils (état, dernière lecture) et, par liaison, la règle vérifiée, sa couleur, la valeur de l’étiquette et si elle est en alerte.

Ajoute un plan de coupe. { level: 'RDC' } est un plan à cet étage ; { axis: 'x', offset: 4.5 } une coupe à 4,5 m.

Déplace, active/désactive ou inverse un plan.

Retire un plan, ou toutes les coupes sans id.

Une boîte de coupe autour du modèle ou de la sélection ; false la retire.

Tous les plans, la boîte et les niveaux disponibles pour les coupes par étage.

Lance une visite prédéfinie : 'social', 'client-walkthrough' ou 'technical-review' (parcourt les anomalies de validation). Jouée par la barre de visite du visualiseur.

Joue une visite que vous avez écrite : arrêts de caméra avec légende, surlignages et classes isolées. autoplay : true ou ms par arrêt.

Passer d’un arrêt à l’autre.

Active ou désactive l’avance automatique de la visite en cours.

Arrête la visite et rend la caméra.

La visite et ses arrêts, au format de playTour() — enregistrez-la, rejouez-la plus tard.

Les recettes intégrées du réalisateur (démo de réunion, reel, teaser LinkedIn, lancement, looks éditoriaux…).

Transforme le modèle en vidéo montée à partir d’une recette : plans tirés de l’IFC, légendes, musique. Ouvre Clip Studio avec le résultat. Suivez presentation-progress.

Encode la présentation dans le navigateur du visiteur et renvoie les octets du MP4 — à téléverser, joindre ou lire dans une <video>.

Ferme Clip Studio.

Les recettes, modèles, formats et palettes du studio de couvertures.

Créer une couverture : lancer une recette (elle capture les vues nécessaires), puis fixer modèle, format, palette et textes. Ouvre le studio, toujours modifiable.

La couverture en l’état, ou null si le studio est fermé.

L’exporter : png / jpeg (une page), pdf / pptx (tout le document), zip (toutes les pages). Renvoie les octets.

Ferme le studio de couvertures.

Démarrer maintenant une visionneuse différée (ce que fait le bouton de l’affiche). Les appels précédents attendaient.

Scrollytelling : quand chaque paragraphe passe au milieu de l’écran, cadrer, isoler, déplacer le soleil ou lancer votre code. Renvoie une fonction de détachement.

Une lente rotation au repos (degrés par seconde ; false l’arrête). S’arrête au premier contact, jamais en mouvement réduit.

Passer la figure en plein écran, ou revenir.

Suspendre ou reprendre le rendu. pauseOffscreen le fait pour vous.

Tous les groupes de la scène — déduits de l’IFC (projet, site, localisation) et créés par les utilisateurs.

Crée un groupe, éventuellement avec des modèles. Renvoie son id.

Renomme ou supprime un groupe utilisateur. Les groupes automatiques ne sont pas modifiables.

Place un modèle ou un nuage de points dans un groupe ; null le rend au regroupement automatique, 'loose' le laisse sans groupe.

Affiche ou masque un groupe entier, ou n’en affiche qu’un.

Cadre la caméra sur un groupe, membres masqués compris.

Arme un outil de mesure pour le visiteur (ouvre le panneau Mesurer), ou 'none'. Les résultats arrivent sur measurements-changed.

Toutes les mesures à l'écran. Valeurs en SI — mètres, m², degrés — quel que soit l'affichage.

Retire une mesure, ou toutes.

Liste les modèles chargés. Renvoie une promesse.

Trouver des éléments par classe IFC, GlobalId et/ou nom dans les modèles chargés. Chaque résultat contient ce qu’attendent getElement(), select() et frame().

Par expressID ou GlobalId. Les données IFC d’un élément : attributs avec le GlobalId, ses jeux de propriétés et quantités, et ceux de son type — typeName, typeProperties — avec unités. effectivePropertySets fusionne les deux, la valeur propre de l’élément l’emporte.

Valider un modèle maintenant (par défaut l’actif) et résoudre avec son Health Score et le nombre d’anomalies. Rejette avec la raison.

Le résultat de validation affiché, ou null avant qu’une exécution en ait produit un. Voir « Cycle de la validation ».

Où en est la validation : idle, running (avec progression), done ou error.

Nombre d’éléments par catégorie et par modèle — pour les graphiques. Renvoie une promesse.

Anomalies de validation pour un tableau (filtre par sévérité / limite). Renvoie une promesse.

Capture la vue 3D actuelle en data URL PNG. Renvoie une promesse.

Compare deux livraisons par URL (par GlobalId) et ouvre l’espace de comparaison sur le résultat.

Ouvre un panneau d'outil, ou null pour fermer celui qui est ouvert. Un panneau indisponible — masqué par le chrome, ou sans contenu sur lequel agir — ne fait rien et n'est pas une erreur.

Quel panneau est ouvert et lesquels sont proposés à cet instant. Un outil absent de `available` ne peut pas être ouvert ; il n'est pas simplement désactivé.

Limite la barre à ces panneaux, à l'exécution. Même vocabulaire que le paramètre d'URL `panels=`, et il prime sur lui. Restreint ce que le visualiseur propose et n'ajoute jamais ; un tableau vide signifie aucune barre.

Charge un relevé depuis des octets — LAS, LAZ, COPC, PLY, PCD ou texte. Le tampon est transféré, pas copié. Résout avec l'identifiant du nuage.

Charge un relevé que le visualiseur récupère lui-même. L'URL doit autoriser CORS.

Tous les relevés chargés. `pointCount` est ce qui réside en mémoire, `declaredCount` ce que contient le fichier — ils diffèrent quand le budget a tronqué l'analyse.

Décharge un relevé et libère ses tampons GPU, ou décharge-les tous.

Affiche ou masque un relevé sans le décharger.

Cadre la caméra sur un relevé, ou sur le premier chargé.

Taille des points, opacité, mode de couleur, densité, seuil de confiance — partagés par tous les relevés. Chacun est un uniform de shader, donc instantané sur 20 millions de points.

Arme le clic-pour-lire. Une fois armé, cliquer un point émet `pointcloud-picked` avec les coordonnées DU FICHIER à côté de celles de la scène.

Ajuste un relevé à la main : position, lacet, mise à niveau, échelle. Partiel et borné ; s'applique par-dessus l'alignement déduit sans le remplacer.

Corrige l'axe que le relevé considère comme vertical. PLY, PCD et texte ne déclarent aucune orientation, le visualiseur la déduit — vérifiez `upAxisSource`.

Importe un modèle depuis des octets. Prend une LISTE : un .gltf a besoin de son .bin et de ses textures, un .obj de son .mtl — seul, le fichier d'entrée donne de la géométrie grise.

Importe un modèle que le visualiseur récupère. Passez toutes les URL nécessaires ; elles sont récupérées en parallèle et doivent toutes autoriser CORS.

Tous les modèles importés, avec leurs nombres de triangles et de textures. Lisez `unitSource` et `upAxisSource` avant de faire confiance aux valeurs voisines.

Retire un import et libère sa géométrie, ses matériaux et ses textures, ou retire-les tous.

Affiche ou masque un import sans le décharger.

Cadre la caméra sur un import, ou sur tous.

Place un import à la main : position, lacet, mise à niveau, échelle. Partiel et borné. Un import démarre centré sur l'IFC, posé sur son sol.

Corrige l'axe vertical de la source. Utile seulement pour OBJ — la spécification glTF impose Y vers le haut, elle rapporte donc `upAxisSource: 'declared'`.

Corrige l'unité source : 1 mètres, 0,01 centimètres, 0,001 millimètres, 0,3048 pieds. Aucun de ces formats ne l'enregistre, le visualiseur la déduit de la taille du modèle.

Vérifie le modèle par rapport à un IDS buildingSMART (XML .ids). S’exécute dans un worker. Renvoie réussite/échec par spécification.

Vérifie la maquette avec un profil de validation EIR / BIM — un objet, son JSON (y compris la forme compacte) ou l'id d'un profil intégré comme 'builtin-en14351-1'. Compilé en IDS et exécuté par le même moteur : même IdsResult que checkIds.

Changer la langue de l'interface à l'exécution.

Lister les codes de langue pris en charge (libellés via IfcViewer.LANGUAGES).

Se résout quand le visualiseur peut accepter des commandes.

Getter — true dès que le visualiseur a signalé qu’il est prêt.

S’abonner à un événement ; renvoie une fonction de désabonnement.

Supprime un écouteur d’événement ajouté précédemment.

Démonter le visualiseur et retirer l’iframe.