Document structure/cs

A FreeCAD document contains all the objects of your scene. It can contain groups, and objects made with any workbench. You can therefore switch between workbenches, and still work on the same document. The document is what gets saved to disk when you save your work. You can also open several documents at the same time in FreeCAD, and open several views of the same document.

Inside the document, the objects can be moved into groups, and have a unique name. Managing groups, objects and object names is done mainly from the Tree view. It can also be done, of course, like everything in FreeCAD, from the python interpreter. In the Tree view, you can create groups, move objects to groups, delete objects or groups, by right-clicking in the tree view or on an object, rename objects by double-clicking on their names, or possibly other operations, depending on the current workbench.

The objects inside a FreeCAD document can be of different types. Each workbench can create its own types of objects, for example the Mesh Workbench creates mesh objects, the Part Workbench create Part objects, the Draft Workbench also creates Part objects, etc.

If there is at least one document open in FreeCAD, there is always one and only one active document. That's the document that appears in the current 3D view, the document you are currently working on.

Application and User Interface
Like almost everything else in FreeCAD, the user interface part (Gui) is separated from the base application part (App). This is also valid for documents. The documents are also made of two parts: the Application document, which contains our objects, and the View document, which contains the representation on screen of our objects.

Představte si to jako dva prostory, které definují dané objekty. Jejich konstrukční parametry (je to kostka?, kužel?, jaké má rozměry?) jsou uloženy v Aplikačním dokumentu, zatímco jejich grafická reprezentace (je kreslený černou čarou?, modrou plochou?) je uložena v Pohledovém dokumentu. Proč se tomu tak? Protože FreeCAD může být a také je BEZ grafického rozhraní, např. uvnitř jiných programů a musí být schopen pracovat s našimi objekty i když se na obrazovce nic nekreslí.

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