Start up and Configuration/es

Esta página muestra las diferentes formas de iniciar FreeCAD y las características de configuración más importantes.

Iniciando FreeCAD desde la línea de comandos

FreeCAD puede iniciarse normalmente, haciendo doble clic en el icono del escritorio o seleccionándolo en el menú de inicio, pero también sr puede iniciar directamente desde la línea de comandos. Esto te permite cambiar algunos de las opciones por defecto de inicio.

Opciones de la línea de comandos

Las opciones de la línea de comandos están sujetas a frecuentes cambios, por tanto es una buena idea comprobar las opciones actuales escribiendo:

FreeCAD --help

En la respuesta puedes leer los posibles parámetros:

Usage:
FreeCAD [options] File1 File2 .....
Allowed options:  

Generic options:
 -v [ --version ]      print version string
 -h [ --help ]         print help message
 -c [ --console ]      start in console mode

Configuration:
 -l [ --write-log ] arg    write a log file
 -t [ --run-test ] arg     test level
 -M [ --module-path ] arg  additional module paths
 -P [ --python-path ] arg  additional python paths
 --response-file arg       can be specified with '@name', too

Respuesta y archivos de configuración

FreeCAD puede leer algunas de estas opciones de un archivo de configuración. Este archivo debe estar en el directorio bin y debe llamarse FreeCAD.cfg. Ten en cuenta que las opciones que especifiques en la línea de comando sobrescriben el archivo de configuración!

Algunos sistemas operativos tienen límites de longitud muy bajos para la línea de comandos. El modo más habitual de evitar esas limitaciones es utilizar un archivo de respuesta. Un archivo de respuesta es simplemente un archivo de configuración que utiliza la misma sintaxis que la línea de comandos. Si la línea de comandos especifica un nombre de archivo de respuesta a utilizar, es cargado y analizado sintáticamente en adición a la línea de comandos:

FreeCAD @ResponseFile.txt 

o:

FreeCAD --response-file=ResponseFile.txt

Opciones ocultas

Existen varias opciones no visibles por el usuario. Estas opciones son por ejemplo los parámetros de X-Window analizados por el sistema Windows:

• -display display, establece la visualización de X (por defecto es $DISPLAY).
• -geometry geometry, establece la geometría cliente de la primera ventana que es mostrada.
• -fn or -font font, Define la fuente de letra de la aplicación. La fuente de letra debería estar especificada utilizando una descripción de fuente lógica de X.
• -bg or -background color, establece el color de fondo por defectoy una paleta para la aplicación (se calculan las sombras iluminadas y oscuras).
• -fg or -foreground color, establece el color de primer planor.
• -btn or -button color, establece el color por defecto de los botones.
• -name name, establece el nombre de la aplicación.
• -title title, establece el título de la aplicación.
• -visual TrueColor, fuerza a la aplicación a utilizar la visualización TrueColor en una visualización de 8-bit.
• -ncols count, limita el número de colores asignados en el cubo de color de visualización de 8-bit, si la aplicación está utilizando la especificación del color QApplication::ManyColor. Si el computo es 216 entonces se utiliza un cubo de color de 6x6x6 (por ejemplo 6 niveles de rojo, 6 de verde y 6 de azul); para otros valores, se utiliza un cubo aproximadamente proporcional a un cubo de 2x3x1.
• -cmap, cause que la aplicación instale un mapa de color privado en una visualización de 8-bit.

Ejecución de FreeCAD sin interfaz de usuario

FreeCAD normalmente se inicia en el modo de interfaz de usuario gráfico GUI, pero puedes forzar que inicie en modo consola escribiendo:

FreeCAD -c

desde la línea de comandos. En el modo consola, no se mostrará el interfaz de usuario, y tendrás presente la consola del interprete de Python. Desde ella tienes la misma funcionalidad que desde el interprete de Python que se ejecuta dentro del interfaz de usuario gráfico GUI de FreeCAD, y acceso normal a todos los módulos y plugins de FreeCAD, exceptuando el módulo FreeCADGui. Ten en cuenta que los módulos que dependan del FreeCADGui podrían tampoco estar disponibles.

Ejecución de FreeCAD como un módulo de Python

FreeCAD también puede utilizarse para ejecutar como un módulo de Python dentro de otras aplicaciones que utilizan Python o desde un interprete de Python externo. Para ello, la aplicación anfitriona de Python debe saber donde están las librerías de FreeCAD. El mejor modo para obtener eso es añadir temporalmente las librerías de FreeCAD a la variable sys.path. El código siguiente escrito desde un interprete de Python importará FreeCAD y te permitirá ejecutarlo del mismo modo que en el modo consola:

import sys
sys.path.append("path/to/FreeCAD/lib") # change this by your own FreeCAD lib path
import FreeCAD

Una vez que FreeCAD está cargado, puedes interactuar con tu aplicación anfitriona de cualquier modo que puedas imaginar!

El conjunto de configuración

En cada inicio FreeCAD examina sus alrededores y los parámetros de la línea de comandos. Esto construye un conjunto de configuración que guarda la esencia de toda la información de la ejecución. Esta información es después utilizada para determinar la ubicación donde guardar los datos del usuario o archivos de registro. También es muy importante para los análisis postmortem. Por lo tanto es guardado en el archivo de registro.

Información relativa al usuario

Entradas de configuración de usuario

Nombre variable configuración	Sinopsis	Ejemplo M$	Ejemplo Posix (Linux)
UserAppData	Ruta donde FreeCAD almacena los datos de la aplicación relativos al usuario.	C:\Documents and Settings\username\Application Data\FreeCAD	/home/username/.FreeCAD
UserParameter	Archivo donde FreeCAD almacena los datos de la aplicación relativos al usuario.	C:\Documents and Settings\username\Application Data\FreeCAD\user.cfg	/home/username/.FreeCAD/user.cfg
SystemParameter	Archivo donde FreeCAD almacena datos relativos a la aplicación.	C:\Documents and Settings\username\Application Data\FreeCAD\system.cfg	/home/username/.FreeCAD/system.cfg
UserHomePath	Ruta de la carpeta de inicio del usuario actual	C:\Documents and Settings\username\My Documents	/home/username

Argumentos de la línea de comando

Entradas de configuración de usuario

Nombre variable configuración	Sinopsis	Ejemplo
LoggingFile	1 si el logging está activado	1
LoggingFileName	Nombre de archivo en el que está ubicado el registro	C:\Documents and Settings\username\Application Data\FreeCAD\FreeCAD.log
RunMode	Esto indica como funcionará el bucle principal. "Script" significa que el archivo de guión dado se llamará y luego se saldrá. "Cmd" ejecuta el interprete de la línea de comandos. "Internal" ejecuta un archivo de guión interno. "Gui" introduce el bucle de eventos de la interfaz de usuario gráfica GUI. "Module" carga un módulo de Python dado.	"Cmd"
FileName	Su significado depende del modo de ejecución
ScriptFileName	Su significado depende del modo de ejecución
Verbose	Nivel de verborrea de FreeCAD	"" o "strict"
OpenFileCount	Mantiene el número de archivos abiertos a través de argumentos de la línea de comandos	"12"
AdditionalModulePaths	Mantiene las rutas de módulos adicionales dados en la línea de comandos	"extraModules/"

Relativos al sistema

Entradas de configuración de usuario

Nombre variable configuración	Sinopsis	Ejemplo M$	Ejemplo Posix (Linux)
AppHomePath	c:/Progam Files/FreeCAD_0.7	/user/local/FreeCAD_0.7
PythonSearchPath	Mantiene una lista de las rutas en las cuales Python busca módulos. Esto es al inicio se puede cambiar durante la ejecución

Algunas bibliotecas necesitan llamar a variables de entorno del sistema. A veces cuando existe un problema con una instalación de FreeCAD, es porque algunas variables de entorno no están o se han definido mal. Por tanto, algunas variables importantes son duplicadas en la Configuración y guardadas en el archivo de registro.

Variables de entorno relativas a Python:

• PYTHONPATH
• PYTHONHOME
• TCL_LIBRARY
• TCLLIBPATH

OpenCascade related environment variables:

• CSF_MDTVFontDirectory
• CSF_MDTVTexturesDirectory
• CSF_UnitsDefinition
• CSF_UnitsLexicon
• CSF_StandardDefaults
• CSF_PluginDefaults
• CSF_LANGUAGE
• CSF_SHMessage
• CSF_XCAFDefaults
• CSF_GraphicShr
• CSF_IGESDefaults
• CSF_STEPDefaults

System related environment variables:

• PATH

Build related information

The table below shows the availible informations about the Build version. Most of it comes from the Subversion repository. This stuff is needed to exactly rebuild a version!

User config entries

Config var name	Synopsis	Example
BuildVersionMajor	Major Version number of the Build. Defined in src/Build/Version.h.in	0
BuildVersionMinor	Minor Version number of the Build. Defined in src/Build/Version.h.in	7
BuildRevision	SVN Repository Revision number of the src in the Build. Generated by SVN	356
BuildRevisionRange	Range of differnt changes	123-356
BuildRepositoryURL	Repository URL	https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
BuildRevisionDate	Date of the above Revision	2007/02/03 22:21:18
BuildScrClean	Indicates if the source was changed ager checkout	Src modified
BuildScrMixed		Src not mixed

Branding related

These Config entries are related to the branding mechanism of FreeCAD. See Branding for more details.

User config entries

Config var name	Synopsis	Example
ExeName	Name of the build Executable file. Can diver from FreeCAD if a different main.cpp is used.	FreeCAD.exe
ExeVersion	Over all Version shows up at start time	V0.7
AppIcon	Icon which is used for the Executable, shows in Application MainWindow.	"FCIcon"
ConsoleBanner	Banner which is prompted in console mode
SplashPicture	Name of the Icon used for the Splash Screen	"FreeCADSplasher"
SplashAlignment	Alignment of the Text in the Splash dialog	Left"
SplashTextColor	Color of the splasher Text	"#000000"
StartWorkbench	Name of the Workbech which get started automaticly after Startup	"Part design"
HiddenDockWindow	List of dockwindows (separated by a semicolon) which will be disabled	"Property editor"

Third Party Tools

FreeCAD Build Tool

Index