Start up and Configuration/es

Vista general
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.

Usar las opciones de la línea de comandos sin un shell de línea de comandos

 * En Ubuntu puedes crear un icono de escritorio y editar sus propiedades. Añade las opciones de la línea de comandos separadas por espacios detrás del nombre del programa en el campo "Comando".
 * En Windows crea un acceso directo y edita las propiedades. Añade las opciones de la línea de comandos separadas por espacios en el campo "Objetivo".

Opciones de la línea de comandos
Las opciones de la línea de comandos están sujetas a cambios frecuentes, por lo que es conveniente 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 ]         Prints version string -h [ --help ]            Prints help message -c [ --console ]         Starts in console mode --response-file arg      Can be specified with '@name', too --dump-config            Dumps configuration --get-config arg         Prints the value of the requested configuration key Configuration: -l [ --write-log ]       Writes a log file to: /home/username/.FreeCAD/FreeCAD.log --log-file arg           Unlike --write-log this allows logging to an                               arbitrary file -u [ --user-cfg ] arg    User config file to load/save user settings -s [ --system-cfg ] arg  System config file to load/save system settings -t [ --run-test ] arg    Test case - or 0 for all -M [ --module-path ] arg Additional module paths -P [ --python-path ] arg Additional python paths --single-instance        Allow to run a single instance of the application

In the following table, selected options are described in more detail:

Options can written in two forms: and.

Respuesta y archivos de configuración
FreeCAD puede leer algunas de estas opciones desde un archivo de configuración. Este archivo debe estar en la ruta de la papelera y debe llamarse. Tenga en cuenta que las opciones especificadas en la línea de comandos anulan 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

or: 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 --console

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.

To read more about console or headless mode, refer to Headless FreeCAD.

Running modules, macros and scripts
See Macro at Startup on how to set up a macro to automatically run at FreeCAD startup.

Environment variables
FreeCAD supports the following environment variables, which can be used to configure directories: If the specified path does not exist, the setting is ignored!

The above environment variables are meant to be used to realize a portable FreeCAD environment. For an example how environment variables can be used from the command line on Linux refer to the notes for Linux users on the downloads page.

FreeCAD uses Qt, which does honor the environmental variable. Thus, setting can be used to specify the base directory of Qt-related configuration files.

FreeCad itself does not honor the environmental variable (because it determines the user's home directory from a lower-level system API). Use for this pupose.

The default temporary directory is. The environmental variable can be used to override the default. (Editor: precedence?).

Libraries
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

Variables de entorno relativas a OpenCascade:


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

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
Note: For Linux distributions, an additional configuration file that relates to Qt may exist at path.

Información relativa a la construcción
La tabla de abajo muestra la información disponible sobre la versión de construcción. La mayoría proviene del repositorio de Subversion. Esto es necesario para reconstruir exactamente una versión!

Relativos al marcado
Estas entradas de configuración son relativas al mecanismo de marcado de FreeCAD. Mira Marcado para más detalles.

Querying the configuration
From FreeCAD's Python console

Entries of the configuration set can be queried with the config var name (see tables above) from the Python console. For example: >>> FreeCAD.ConfigGet("ExeVersion") '0.19' If the name is not found, an empty string is returned.

From command line

Use the option to query a single name. Not all names are supported. For example: FreeCAD_0.19 --get-config ExeVersion

Use the option to get a list of names and their values. Not all names are supported.

From FreeCAD console

Start FreeCAD in console mode with and query with Python code. For example: $ FreeCAD_0.19 --console [FreeCAD Console mode ] >>> FreeCAD.ConfigGet("ExeVersion") '0.19' >>> exit

For Linux (bash shell) you can modify the following command line to suit your needs: $ FreeCAD_0.19 --console <<EOF print( "FREECAD_USER_HOME: " + ( "not set" if ( os.environ.get('FREECAD_USER_HOME') is None ) else os.environ.get('FREECAD_USER_HOME') ) ) print( "UserHomePath: " + FreeCAD.ConfigGet("UserHomePath") ) exit EOF

Linux: Creating an additional start option
The following assumes that your desktop is configured such that you can launch FreeCAD from it. Depending on your Linux distribution and desktop environment, you may have to adapt the following steps:
 * 1) Copy the freedesktop entry file for FreeCAD from  to.
 * 2) Change the name from  to something else (e.g. ).
 * 3) Open the file with a text editor and change how FreeCAD is invoked by modifying the line starting with.
 * 4) As a result, an additional entry in your start menu/application launcher is available. This way, you can have multiple FreeCAD entries with various launch options.

Starting FreeCAD from a portable USB medium
Windows

Put the FreeCAD executable,, on the USB medium. Create a batch file,, and put it into the same directory as. Inside the batch file write:

or with

With the batch in the root of the USB medium:

Now double-click the batch file to start FreeCAD. (see)