Estrutura do documento
O documento FreeCAD contém todos os objectos da sua cena. Ele pode conter grupos e objectos feitos com qualquer bancada. Portanto, você pode alternar entre bancadas de trabalho, e ainda trabalhar no mesmo documento. O documento é o que fica guardado no disco quando você salvar seu trabalho. Você também pode abrir vários documentos ao mesmo tempo em FreeCAD e abra várias vistas do mesmo documento.
Dentro do documento, os objectos podem ser movidos em grupos, e de ter um nome único. Gerir grupos, objectos e nomes de objecto é feito principalmente a partir da tela Árvore. Ele também pode ser feito, é claro, como tudo na FreeCAD, a partir do interpretador Python. Na vista de árvore, você pode criar grupos, mover objectos para grupos, apagar objectos ou grupos, clicando com o botão direito na vista de árvore ou em um objecto, renomear objectos clicando duas vezes em seus nomes, ou possivelmente outras operações, dependendo a bancada actual.
Os objectos dentro de um documento FreeCAD pode ser de diferentes tipos. Cada bancada pode criar seus próprios tipos de objectos, por exemplo, o Mesh Workbench cria objectos de malha, os Part Workbench cria objectos parciais , o Draft Workbench também cria objectos parciais, etc.
Se houver pelo menos um documento aberto em FreeCAD, há sempre um e só um documento activo. Esse é o documento que aparece na visualização em 3D actual, o documento que você está trabalhando actualmente.
Aplicação e interface de usuário
Como quase tudo em FreeCAD, a área da Interface Gráfica do Usuário (GUI) esta separada da área da aplicação base (App). Isto também é válido para documentos. Os documentos também são feitos de duas partes: o documento da Aplicação, que contém os nossos objectos, e o documento Vista, que contém a representação na tela de nossos objectos.
Pense nisso como dois espaços, onde os objectos são definidos. Seus parâmetros construtivos (É um cubo? É um cone? Qual o tamanho?) São armazenados no documento do aplicativo, enquanto a sua representação gráfica (é desenhado com linhas pretas? Com as caras azuis?) São armazenados no documento Vista. Por que é assim? Porque FreeCAD também pode ser usado sem interface gráfica, por exemplo dentro de outros programas, e ainda deve ser capaz de manipular os nossos objectos, mesmo que nada é desenhado na tela.
Another thing that is contained inside the View document are 3D views. One document can have several views opened, so you can inspect your document from several points of view at the same time. Maybe you would want to see a top view and a front view of your work at the same time? Then, you will have two views of the same document, both stored in the View document. Creating new views or closing views can be done from the View menu or by right-clicking on a view tab.
Scripting
Documents can be easily created, accessed and modified from the python interpreter. For example:
FreeCAD.ActiveDocument
Will return the current (active) document
FreeCAD.ActiveDocument.Blob
Would access an object called "Blob" inside your document
FreeCADGui.ActiveDocument
Will return the view document associated to the current document
FreeCADGui.ActiveDocument.Blob
Would access the graphical representation (view) part of our Blob object
FreeCADGui.ActiveDocument.ActiveView
Will return the current view
