Incorpore o visualizador IFC no seu próprio produto

Montar num seletor CSS ou elemento. Veja as opções abaixo.

Cria um visualizador e resolve assim que estiver pronto para aceitar comandos.

Carregar bytes IFC (ArrayBuffer/Uint8Array) da sua app. O buffer é transferido para uma passagem sem cópia.

Carregar um URL IFC público com CORS.

Descarrega um modelo por id.

Remover todos os modelos carregados.

Selecionar e enquadrar um elemento — pelo seu expressID IFC ou pelo GlobalId (que também encontra o modelo).

Voar para uma vista com nome da cena — iso, front, back, left, right, top, bottom — com toda ela no enquadramento. Sem resposta (entre 1.14 e 1.17 o visualizador ignorava-a).

Enquadramento para apresentar: o modelo ocupa `fill` do quadro (0,2–0,98, por omissão 0,85), ajustado aos seus cantos e não à esfera envolvente. azimuth / elevation olham de qualquer ângulo.

Enquadrar um elemento (expressID): a partir do ângulo atual, salvo se for indicada uma vista. Rejeita se não estiver no modelo.

Enquadrar o modelo ativo a partir do ângulo atual, com margem / repor a câmara.

Coloca a câmara numa posição a olhar numa direção.

Onde está a câmara e para onde olha — guarde e restaure com lookAt.

Leva a câmara a uma posição a olhar para um alvo (metros de cena, Y para cima).

Modo passeio na primeira pessoa (WASD, arrastar para olhar, Esc para sair). Emite walk-changed.

Se o modo passeio está ativo e a que velocidade.

Isolar uma categoria (ex.: "IfcWall"); omitir para limpar.

Restaurar toda a visibilidade (limpar ocultos + isolamento).

Oculta / mostra um conjunto de elementos por expressID.

Mostra ou oculta um modelo de uma cena federada sem o descarregar.

Torna um modelo translúcido (0,05–1) — p. ex. a arquitetura à volta das instalações.

Mostra só este modelo; null volta a mostrá-los todos.

Muda o fundo da cena: um preset ('white', 'paper', 'blueprint', 'sky', 'studio'), '#rrggbb', '#cima,#baixo' ou { top, bottom }. Não é guardado como preferência do visitante.

O fundo atual da cena.

Muda a cor de destaque da interface em tempo de execução (#rrggbb).

Liga ou desliga a vista cliente — a de apresentação a stakeholders, igual a ui: 'client'.

'quality' ativa a renderização mais pesada para uma imagem de destaque; 'standard' para o dia a dia.

Sombras reais numa data e hora locais do local: { date: '06-21', time: '18:00' }. O local vem da georreferência do IFC; passe location para um modelo sem ela — nunca uma cidade por omissão em silêncio.

Data, hora e fuso do estudo, e onde fica o local.

Coloca o modelo no mapa com terreno e envolvente OpenStreetMap. Chamá-lo é a sua página a declarar o consentimento de mosaicos pelos visitantes; mostre as atribuições.

Estado do modo mapa, a colocação e as atribuições a mostrar.

Abrir outra cena: o URL de um .scene.json ou um documento de cena (viaja comprimido no endereço da moldura, por isso tem de caber numa ligação). O visualizador recarrega com ela; as chamadas pendentes são rejeitadas e ready volta a disparar.

A cena no ecrã como documento de cena — modelos por URL, camadas, gémeo, mapa, câmara — com as fontes a creditar e uma ligação que a contém.

Comprimir você mesmo um documento de cena para uma ligação #scene= (null se for grande demais para uma ligação).

O catálogo de fontes públicas em direto, com nome no idioma do visualizador, o que cada uma precisa num navegador (uma chave, um proxy) e se tem dados perto do local.

Adicionar uma camada: uma fonte do catálogo ({ preset }), GeoJSON ou um feed em direto num URL ({ url, live }), ou GeoJSON que já tem ({ geojson }). Só para a sessão: nunca guardada nas camadas do visitante.

Todas as camadas de dados: estado, número de elementos, extensão, atualização e atribuição.

Mostrar ou ocultar uma camada.

Levar a câmara aos elementos de uma camada.

Remover uma camada.

O gémeo operacional agora: fontes de dispositivos (estado, última leitura) e, por ligação, a regra que se cumpre, a sua cor, o valor da etiqueta e se está em alerta.

Adiciona um plano de corte. { level: 'Piso 1' } é uma planta nesse piso; { axis: 'x', offset: 4.5 } um corte a 4,5 m.

Move, liga/desliga ou inverte um plano.

Remove um plano, ou todos os cortes sem id.

Uma caixa de corte à volta do modelo ou da seleção; false remove-a.

Todos os planos, a caixa e os pisos disponíveis para cortes por nível.

Inicia um tour predefinido: 'social', 'client-walkthrough' ou 'technical-review' (percorre as incidências de validação). Reproduzido pela barra de tour do visualizador.

Reproduz um tour criado por si: paragens de câmara com legendas, destaques e classes isoladas. autoplay: true ou ms por paragem.

Mudar de paragem.

Liga ou desliga o avanço automático do tour em curso.

Para o tour e devolve a câmara.

O tour e as suas paragens, no formato de playTour() — guarde-o e reproduza-o mais tarde.

As receitas do realizador (demo para reunião, reel, teaser do LinkedIn, lançamento, looks editoriais…).

Transforma o modelo num vídeo editado a partir de uma receita: planos gerados do IFC, legendas, música. Abre o Clip Studio com o resultado. Acompanhe presentation-progress.

Codifica a apresentação no navegador do visitante e devolve os bytes do MP4 — para enviar, anexar ou reproduzir num <video>.

Fecha o Clip Studio.

As receitas, modelos, formatos e paletas do estúdio de capas.

Cria uma capa: executa uma receita (captura as vistas de que precisa) e depois define modelo, formato, paleta e textos. Abre o estúdio, que continua editável.

A capa tal como está, ou null se o estúdio estiver fechado.

Exporta-a: png / jpeg (uma página), pdf / pptx (todo o documento), zip (todas as páginas). Devolve os bytes.

Fecha o estúdio de capas.

Arrancar já um visualizador diferido (o que faz o botão do póster). As chamadas anteriores ficaram em fila.

Scrollytelling: enquanto cada parágrafo cruza o meio do ecrã, enquadrar, isolar, mover o sol ou correr o seu código. Devolve uma função para desligar.

Uma rotação lenta em repouso (graus por segundo; false para-a). Para ao primeiro toque, nunca com movimento reduzido.

Ampliar a figura para ecrã inteiro, ou voltar.

Parar ou retomar a renderização. pauseOffscreen fá-lo por si.

Todos os grupos da cena — deduzidos do IFC (projeto, local, localização) e criados pelos utilizadores.

Cria um grupo, opcionalmente com modelos. Devolve o seu id.

Muda o nome ou apaga um grupo de utilizador. Os automáticos não se editam.

Move um modelo ou nuvem de pontos para um grupo; null devolve-o ao agrupamento automático, 'loose' deixa-o sem grupo.

Mostra ou oculta um grupo inteiro, ou mostra só um.

Enquadra a câmara num grupo, incluindo membros ocultos.

Arma uma ferramenta de medição para o visitante (abre o painel Medir), ou 'none'. Os resultados chegam em measurements-changed.

Todas as medições no ecrã. Valores em SI — metros, m², graus — seja qual for a apresentação.

Remove uma medição, ou todas.

Lista os modelos carregados. Devolve uma promessa.

Encontrar elementos por classe IFC, GlobalId e/ou nome nos modelos carregados. Cada resultado traz o que getElement(), select() e frame() pedem.

Por expressID ou GlobalId. Os dados IFC de um elemento: atributos com o GlobalId, os seus conjuntos de propriedades e quantidades, e os do seu tipo — typeName, typeProperties — com unidades. effectivePropertySets junta ambos e prevalece o valor do próprio elemento.

Validar um modelo agora (por omissão, o ativo) e resolver com o seu Health Score e as contagens de problemas. Rejeita com o motivo.

O resultado de validação no ecrã, ou null antes de uma execução ter produzido um. Ver «Ciclo da validação».

Em que ponto está a validação: idle, running (com progresso), done ou error.

Contagem de elementos por categoria e modelo — para gráficos. Devolve uma promessa.

Problemas de validação para uma tabela (filtra por severidade / limite). Devolve uma promessa.

Captura a vista 3D atual como data URL PNG. Devolve uma promessa.

Compara duas entregas por URL (por GlobalId) e abre a área de comparação com o resultado.

Abre um painel de ferramenta, ou passa null para fechar o que estiver aberto. Um painel indisponível — escondido pelo chrome, ou sem nada carregado sobre o que atuar — não faz nada, e não é um erro.

Que painel está aberto e quais são oferecidos neste momento. Uma ferramenta ausente de `available` não pode ser aberta; não está apenas desativada.

Limita a barra a estes painéis, em tempo de execução. Mesmo vocabulário do parâmetro de URL `panels=` e tem prioridade sobre ele. Restringe o que o visualizador oferece e nunca acrescenta; um array vazio significa sem barra.

Carrega um levantamento a partir de bytes — LAS, LAZ, COPC, PLY, PCD ou texto. O buffer é transferido, não copiado. Resolve com o id da nuvem.

Carrega um levantamento que o próprio visualizador obtém. O URL tem de permitir CORS.

Todos os levantamentos carregados. `pointCount` é o residente, `declaredCount` o que o ficheiro contém — diferem quando o orçamento truncou a leitura.

Descarrega um levantamento e liberta os seus buffers de GPU, ou descarrega todos.

Mostra ou oculta um levantamento sem o descarregar.

Enquadra a câmara num levantamento, ou no primeiro carregado.

Tamanho do ponto, opacidade, modo de cor, densidade, limiar de confiança — partilhados por todos. Cada um é um uniform do shader, logo instantâneo com 20 milhões de pontos.

Arma o clique para ler. Enquanto armado, clicar num ponto emite `pointcloud-picked` com as coordenadas DO FICHEIRO ao lado das da cena.

Ajusta um levantamento à mão: posição, guinada, nivelamento, escala. Parcial e limitado; aplica-se sobre o alinhamento deduzido em vez de o substituir.

Corrige que eixo o levantamento trata como vertical. PLY, PCD e texto não declaram orientação, o visualizador deduz — verifique `upAxisSource`.

Importa um modelo a partir de bytes. Recebe uma LISTA: um .gltf precisa do seu .bin e texturas, um .obj do seu .mtl — sozinho, o ficheiro de entrada dá geometria cinzenta.

Importa um modelo que o visualizador obtém. Passe todos os URL necessários; são obtidos em paralelo e todos têm de permitir CORS.

Todos os modelos importados, com contagens de triângulos e texturas. Leia `unitSource` e `upAxisSource` antes de confiar nos valores ao lado.

Remove uma importação e liberta a geometria, materiais e texturas, ou remove todas.

Mostra ou oculta uma importação sem a descarregar.

Enquadra a câmara numa importação, ou em todas.

Coloca uma importação à mão: posição, guinada, nivelamento, escala. Parcial e limitado. As importações começam centradas no IFC, assentes no seu piso.

Corrige o eixo vertical da origem. Só faz sentido em OBJ — a especificação glTF obriga a Y para cima, por isso reporta `upAxisSource: 'declared'`.

Corrige a unidade de origem: 1 metros, 0,01 centímetros, 0,001 milímetros, 0,3048 pés. Nenhum destes formatos a regista, o visualizador deduz do tamanho do modelo.

Verifica o modelo contra um IDS da buildingSMART (XML .ids). Corre num worker. Devolve aprovado/reprovado por especificação.

Verifica o modelo contra um perfil de validação EIR / BIM — um objeto, o seu JSON (incl. o formato compacto) ou o id de um perfil incorporado como 'builtin-en14351-1'. Compila para IDS e corre no mesmo motor: o mesmo IdsResult que checkIds.

Mudar o idioma da interface em tempo de execução.

Listar os códigos de idioma suportados (rótulos em IfcViewer.LANGUAGES).

Resolve quando o visualizador está pronto para aceitar comandos.

Getter — true assim que o visualizador sinaliza que está pronto.

Subscrever um evento; devolve uma função para cancelar.

Remove um listener de eventos adicionado anteriormente.

Desmontar o visualizador e remover o iframe.