Document structure/cs

Dokument FreeCADu obsahuje všechny objekty Vaší úlohy. Může obsahovat skupiny a objekty vytvořené na jakékoliv pracovní ploše. Proto můžete přepínat mezi pracovními plochami a pořád pracujete na stejném dokumentu. Dokument je to se zapisuje na disk, když ukládáte svou práci. Ve FreeCADu můžete také zároveň otevřít několik dokumentů a také otevřít několik pohledů stejného dokumentu.

Uvnitř dokumentu mohou být objekty přesunovány do skupin a mít unikátní jméno. Řízení skupin, objektů a jmen objektů se dělá především z Pohledu stromu. Také může být samozřejmě prováděno, jako všechno ve FreeCADu, pomocí interpreteru Pythonu. V Pohledu stromu můžete vytvářet skupiny, přesunovat objekty do skupin, mazat objekty nebo skupiny, pomocí kliknutí pravého tlačítka myši v pohledu stromu nebo na objekt, přejmenovávat objekti dvojklikem na jejich jméno nebo jsou i další možnosti v závislosti na právě používané pracovní ploše.

Objekty uvnitř dokumentu FreeCADu mohou být různých typů. Každá pracovní plocha může vytvářet své vlastní typy objektů např. Pracovní plocha sít vytváří síťové objekty, Pracovní plocha Díl vytváří objekty Díl, Pracovní plocha kreslení také vytváří objekty Díl, atd.

Jestliže je ve FreeCADu otevřen alespoň jeden dokument, potom je vždy jeden a pouze jeden aktivní dokument. Je to dokument, který je aktuálně zobrazen ve 3D pohledu, dokument na kterém právě pracujete.

Aplikace a uživatelské prostředí
Jako téměř všechno ve FreeCADu je uživatelské prostředí (GUI) odděleno od základní aplikační části (App). Platí to i pro dokumenty. Dokumenty se také skládají ze dvou částí: Aplikační dokument, který obsahuje naše objekty a Pohledový dokument, který obsahuje reprezentaci našich objektů na obrazovce.

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