> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md).

# Importar um Plano DXF

Importe um desenho arquitetónico DXF para um Gémeo Digital do Edifício — converta o desenho CAD de linhas em paredes à escala.

A maioria das instalações comerciais já tem um desenho arquitetónico. Em vez de redesenhar um armazém ou o piso de um escritório parede a parede, pode importar esse desenho diretamente. O editor lê **DXF** ficheiros — o formato de intercâmbio que todas as principais aplicações CAD podem exportar — e converte os traços em paredes no piso atual.

Esta é a forma mais rápida de obter um modelo preciso: a geometria vem diretamente da planta do arquiteto, já à escala, e você dedica o seu tempo a mobilar e ligar sensores em vez de traçar.

## O que precisa

* Um `.dxf` ficheiro do piso que pretende modelar. Qualquer pacote CAD — AutoCAD, BricsCAD, LibreCAD e outros — pode exportar DXF.
* O ficheiro é lido inteiramente no seu navegador. Nada é enviado até guardar o widget.

## Importar um ficheiro

1. Na barra de ferramentas inferior, clique em **Construir**, depois clique em **Traçar a partir do mapa** — a caixa de diálogo de importação é acedida a partir da mesma área. (A importação DXF e o traçado de mapas partilham a linha de ferramentas de estrutura.)
2. Na caixa de diálogo de importação, clique **Escolher ficheiro** e selecione o seu `.dxf` ficheiro.
3. A caixa de diálogo analisa o ficheiro e mostra uma **pré-visualização** das paredes que encontrou, para que possa verificar o resultado antes de comprometer qualquer coisa no modelo.
4. Revise as **Opções** e **Estatísticas** na barra lateral (abaixo).
5. Clique em **Importar**. É criada uma parede para cada segmento de linha no desenho, no piso que está atualmente ativo.

Se o ficheiro não puder ser lido, a caixa de diálogo indica-o. Se for analisado mas não contiver geometria utilizável, a caixa de diálogo também o diz — os ficheiros DXF às vezes contêm apenas anotações ou dimensões, sem paredes reais.

## Opções

Duas definições controlam a forma como o desenho é interpretado:

* **Unidade de origem** — a unidade em que o ficheiro CAD foi desenhado: **Milímetros**, **Centímetros**, **Metros**, **Polegadas**, **Pés**, ou **Sem unidade**. O importador lê a unidade declarada pelo próprio ficheiro quando existe uma e pré-seleciona-a; altere-a se a declaração do ficheiro estiver errada ou em falta. Acertar nisto é o que faz com que o edifício importado tenha o tamanho real correto — se um modelo for importado demasiado grande ou demasiado pequeno, a unidade de origem é quase sempre a causa.
* **Segmentos de arco** — quão finamente a geometria curva é aproximada, dado que o modelo é construído a partir de segmentos de parede retos: **Baixo**, **Médio**, ou **Alta**. Médio é uma boa predefinição; Alto dá curvas mais suaves, à custa de mais segmentos de parede.

A pré-visualização é novamente renderizada sempre que altera uma opção, para que possa ajustar visualmente a escala antes de importar.

## Estatísticas e avisos

A barra lateral indica o que o importador fez:

* **Paredes** — segmentos retos convertidos em paredes.
* **Arcos** e **Círculos** — entidades curvas aproximadas por segmentos de parede.
* **Entidades ignoradas** — elementos do desenho que não são paredes (texto, dimensões, hachuras) e foram excluídos.

Qualquer **Avisos** explicam o que foi descartado e porquê. Um número elevado de elementos ignorados é normal — um desenho CAD contém muito mais do que paredes, e apenas a geometria das paredes pertence ao gémeo digital do edifício.

## Depois de importar

As paredes importadas comportam-se exatamente como paredes desenhadas à mão. Selecione qualquer uma para definir altura, espessura e material, adicione portas e janelas, e continue a construir. Se a importação não estiver totalmente correta, **Desfazer** (Ctrl+Z) reverte-a e pode ajustar a unidade de origem e tentar novamente.

Um fluxo de trabalho típico: importe a estrutura a partir de DXF, mude para o **Vista 2D** para confirmar o layout, depois desenhe quaisquer divisórias interiores que o ficheiro CAD não incluiu e passe à mobília.

## Sugestões

* Se o edifício for importado com o tamanho errado, a **Unidade de origem** está errada — altere-a e volte a importar.
* Importe o desenho de cada piso para o seu próprio nível: adicione primeiro o piso (ver [Pisos e níveis](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md)), torne-o ativo e depois importe.
* Ficheiros DXF limpos importam-se limpidamente. Se um desenho estiver poluído com camadas que não são paredes, exportar apenas a camada das paredes a partir da ferramenta CAD dá o melhor resultado.

## Ver também

* [Desenhar o seu edifício](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drawing-your-building.md) — Desenhe ou ajuste a estrutura manualmente
* [Traçar a partir do mapa](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/tracing-from-the-map.md) — Em vez disso, construa a partir de um mapa aéreo
* [Pisos e níveis](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Importe cada piso para o seu próprio nível


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/importing-a-dxf-plan.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
