Document structure/es



Un documento FreeCAD contiene todos los objetos de la escena. Puede contener grupos y objetos hechos con cualquier workbench (mesa, puesto o banco de trabajo). Por lo tanto, puede cambiar entre los bancos de trabajo, y sigue trabajando en el mismo documento. El documento es lo que se guarda en el disco al guardar su trabajo. También puede abrir varios documentos al mismo tiempo en FreeCAD, y abrir varias vistas del mismo documento.

En el documento, los objetos se pueden mover e incorporar a grupos, y cada objeto tiene un nombre único, exclusivo. La gestión de grupos, objetos y nombres de objeto se hace principalmente en la vista de árbol. También se puede hacer, por supuesto, como todo en FreeCAD, desde el intérprete de Python. En la vista de árbol, se pueden crear grupos, mover objetos a grupos, eliminar objetos o grupos,... haciendo clic derecho en la vista en árbol o en un objeto. , cambiar el nombre de los objetos haciendo doble clic sobre sus nombres,... o posiblemente otras operaciones, en función del banco o mesa de trabajo actual.

Los objetos dentro de un documento FreeCAD pueden ser de diferentes tipos. Cada mesa de trabajo (Workbench) puede crear sus propios tipos de objetos, por ejemplo, la Workbench malla crea objetos de malla, la Workbench Parte crear objetos Parte, el Workbench trazado también crea objetos pieza, etc

Si hay uno o más documentos abiertos en FreeCAD, siempre alguno de ellos, y sólo uno, será el documento activo. Ese es el documento que aparece en la vista 3D actual, el documento que está trabajando actualmente.

Aplicación e interfaz de usuario
Como casi todo lo demás en FreeCAD, la parte interfaz de usuario (GUI) está separada de la parte aplicación de base (la aplicación). Esto también es válido para los documentos. Los documentos también están hechos de dos partes: el documento de la aplicación, que contiene nuestros objetos, y el documento Vista, que contiene la representación en pantalla de nuestros objetos.

Piense en ello como dos espacios, donde los objetos están definidos. Sus parámetros constructivos (¿es un cubo? ¿Un cono? ¿Qué tamaño? ...) se almacenan en el documento de aplicación, mientras que su representación gráfica (¿es dibujado con línea negra? ¿Con la cara azul? ...) se almacena en el documento Vista. ¿Por qué? Porque FreeCAD también puede ser utilizado sin interfaz gráfica, por ejemplo dentro de otros programas y, aún así, tenemos que ser capaces de manipular nuestros objetos, incluso si no se dibujan en la pantalla.

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. Create new views or close 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