Структура на документите
Документът в FreeCAD се състои от всички обекти във вашата сцена. Може да съдържа групи от обекти (самата група може да се третира като обект). Един документ може да съдържа едновременно обекти от всеки работен плот. Може да сменяте между работните плотове колкото често желаете докато работите върху един документ. Целия документ (със всички създадени обекти) се запазва върху твърдия диск всеки път когато натиснете Save. Може да отворите няколко документа едновременно в FreeCAD, както и да отворите различни изгледи към същия документ.
В документът обектите може да се събират в групи, като всеки обект (и всяка група) имат уникално име. Тъй като всяка група сама по себе си също е обект, може да бъде сложена в друга група. Така групите и обектите образуват дърво. Управлението на групи, обекти и техните имена се извършва основно в прозореца Tree view (прозореца съдържащ дървото на обектите). Също може да се извършва и програматически от python.. В прозорецът Tree view може да създавате групи, да местите обекти между групи, да изтривате обекти или групи (натиснете десния бутон върху обекта/групата и изберете Delete от появилото се меню) и да променяте името на обект/група (натиснете 2 пъти левия бутон на мишката върху обекта). В зависимост от работния плот избран в момента, може да имате достъп и до други операции в прозореца.
Обектите в документа имат различни типове. Всеки работен плот може да създава обекти от своите собствени типове. Нашример Mesh Workbench създава mesh обекти (3D повърхности изградени от триъгълници) , Part Workbench създава Part обкети (елементи изградени от по-прости форми), Draft Workbench също съзадава Part обекти, и т.н.
Дори да има няколко едновременно отворени документи в FreeCAD, само един от тях може да бъде активен в определен момент. Активния документ е този чиито обекти се виждат в момента в прозореца 3D view.
Application and User Interface
В FreeCAD, потребителския интерфейс(Gui) е отделен модул от основната програма (App). Същото правило важи и за документите. Документа се състои от 2 части: Application частта,която съдържа нашите обекти (видима в Tree View) и View частта, която съдържа репрезентацията на екрана на вашите обекти (видима в 3D View прозореца).
Think of it as two spaces, where the objects are defined. Their constructive parameters (is it a cube? a cone? which size?) are stored in the Application document, while their graphical representation (is it drawn with black lines? with blue faces?) are stored in the View document. Why is that? Because FreeCAD can also be used WITHOUT graphical interface, for example inside other programs, and we must still be able to manipulate our objects, even if nothing is drawn on the screen.
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
