Start up and Configuration/es: Difference between revisions

From FreeCAD Documentation
(Created page with "{{docnav/es|Third Party Tools/es|FreeCAD Build Tool/es}}")
(Updating to match new version of source page)
 
(40 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
Esta página muestra las diferentes formas de iniciar FreeCAD y las características de configuración más importantes.

{{Docnav/es
|[[Import_Export_Preferences/es|Preferencias Importación y Exportación]]
|[[Scripting_and_macros/es|Guiones y Macros]]
}}

{{VeryImportantMessage|In FreeCAD version 0.20 the default location of the program's configuration, data and cache files was changed for Linux.<br>
See [[Release_notes_0.20#Core|Release notes 0.20]] for more information. This page has not yet been updated accordingly.}}

{{TOCright}}

==Overview==

<div class="mw-translate-fuzzy">
==Vista general==
Esta página muestra las diferentes formas de iniciar FreeCAD y las características de configuración más importantes.
</div>


<span id="Starting_FreeCAD_from_the_Command_line"></span>
== Iniciando FreeCAD desde la línea de comandos ==
== 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.
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.


=== Using command line options without a command line shell ===

<div class="mw-translate-fuzzy">
=== 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".
</div>

<span id="Command_line_options"></span>
=== Opciones de la línea de comandos ===
=== 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:
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
FreeCAD --help

En la respuesta puedes leer los posibles parámetros:
En la respuesta puedes leer los posibles parámetros:

Usage:
FreeCAD [options] File1 File2 .....
Usage: FreeCAD [options] File1 File2 ...
Allowed options:
Allowed options:
Generic options:
Generic options:
-v [ --version ] print version string
-h [ --help ] print help message
-v [ --version ] Prints version string
-c [ --console ] start in console mode
-h [ --help ] Prints help message
-c [ --console ] Starts in console mode
--response-file arg Can be specified with '@name', too
Configuration:
-l [ --write-log ] arg write a log file
--dump-config Dumps configuration
--get-config arg Prints the value of the requested configuration key
-t [ --run-test ] arg test level
-M [ --module-path ] arg additional module paths
Configuration:
-P [ --python-path ] arg additional python paths
--response-file arg can be specified with '@name', too
-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:

{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|-
! Long option !! Corresponding [[#Configuration_set|config var name]] !! Synopsis
|-
| {{incode|--user-cfg <filename>}} || UserParameter || Filename or relative path that ends with a filename. Defaults to {{incode|user.cfg}}.
|-
| {{incode|--module-path <dir>}} || Prepends to AdditionalModulePaths || Directory that contains modules. This option can be given repeatedly to specify multiple directories.
|-
| {{incode|--get-config <config-var-name>}} || most || Outputs the requested value in a popup dialog. Exits upon confirmation with {{KEY|OK}}. Cannot be used repeatedly. If an unknown/illegal variable name is used, the response is empty. The {{incode|--console}} flag is not honored.
|}
Options can written in two forms: {{incode|--long-option arg}} and {{incode|--long-option<nowiki>=</nowiki>arg}}.

<span id="Response_and_config_files"></span>
=== Respuesta y archivos de configuración ===
=== 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!
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 {{FileName|FreeCAD.cfg}}. 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:
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
<pre>
o:
FreeCAD --response-file=ResponseFile.txt
FreeCAD @ResponseFile.txt
</pre>

o:
<pre>
FreeCAD --response-file=ResponseFile.txt
</pre>

or:
<pre>
FreeCAD --response-file ResponseFile.txt
</pre>

<span id="Hidden_options"></span>
=== Opciones ocultas ===
=== Opciones ocultas ===


Line 48: Line 117:
* -cmap, cause que la aplicación instale un mapa de color privado en una visualización de 8-bit.
* -cmap, cause que la aplicación instale un mapa de color privado en una visualización de 8-bit.


<span id="Running_FreeCAD_without_GUI_(headless)"></span>

<div class="mw-translate-fuzzy">
== Ejecución de FreeCAD sin interfaz de usuario ==
== Ejecución de FreeCAD sin interfaz de usuario ==
</div>


<div class="mw-translate-fuzzy">
FreeCAD normalmente se inicia en el modo de interfaz de usuario gráfico GUI, pero puedes forzar que inicie en modo consola escribiendo:
FreeCAD normalmente se inicia en el modo de interfaz de usuario gráfico GUI, pero puedes forzar que inicie en modo consola escribiendo:
</div>
FreeCAD -c

FreeCAD --console

<div class="mw-translate-fuzzy">
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.
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.
</div>


To read more about console or headless mode, refer to [[Headless_FreeCAD|Headless FreeCAD]].


=== Running modules, macros and scripts ===
== Ejecución de FreeCAD como un módulo de Python ==


{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
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:
! File type !! System !! Command line example
|-
| Module ||Windows || {{incode|"C:\Program Files\FreeCAD\bin\FreeCAD.exe" -M "C:\FreeCAD\Mod\Draft"}}
|-
| ||Linux || {{incode|FreeCAD_0.19 -M ~/.FreeCAD/Mod/Draft}}
|-
| ||Linux (AppImage) || {{incode|path/to/FreeCADXXX.AppImage -M ~/.FreeCAD/Mod/Draft}}
|-
|-
| .FCMacro or .py ||Windows || {{incode|"C:\Program Files\FreeCAD\bin\FreeCAD.exe" "C:\Users\userName\AppData\Roaming\FreeCAD\Mod\WorkFeature\start_WF.FCMacro"}}
|-
| ||Linux || {{incode|FreeCAD_0.19 ~/.FreeCAD/Mod/WorkFeature/start_WF.FCMacro}}
|-
| ||Linux (AppImage) || {{incode|path/to/FreeCADXXX.AppImage ~/.FreeCAD/Mod/WorkFeature/start_WF.FCMacro}}
|}


See [[Macro_at_Startup|Macro at Startup]] on how to set up a macro to automatically run at FreeCAD startup.
<syntaxhighlight>
import sys
sys.path.append("path/to/FreeCAD/lib") # change this by your own FreeCAD lib path
import FreeCAD
</syntaxhighlight>


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

FreeCAD supports the following environment variables, which can be used to configure directories: {{Version|0.19}}
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|-
! Environment variable !! Corresponding [[#Configuration_set|config var name]] !! Synopsis
|-
| {{incode|FREECAD_USER_HOME}} || UserHomePath || FreeCAD's "base" directory for keeping local user data.
|-
| {{incode|FREECAD_USER_DATA}} || UserAppData || If not set, defaults to {{incode|FREECAD_USER_HOME/.FreeCAD}}, but only if {{incode|FREECAD_USER_HOME}} is set.
|-
| {{incode|FREECAD_USER_TEMP}} || AppTempPath || If not set, defaults to {{incode|FREECAD_USER_HOME/temp}}, but only if {{incode|FREECAD_USER_HOME}} is set.
|}
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 [[Download#Notes_for_GNU.2FLinux_users|notes for Linux users on the downloads page]].

=== {{incode|HOME}} ===

FreeCAD uses [[Third_Party_Libraries#Qt|Qt]], which does honor the {{incode|HOME}} environmental variable. Thus, setting {{incode|HOME}} can be used to specify the base directory of Qt-related configuration files ({{incode|.config/FreeCAD/FreeCAD.conf}}).

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

=== {{incode|TMPDIR}} ===

The default temporary directory is {{FileName|/tmp/}}. The {{incode|TMPDIR}} environmental variable can be used to override the default. (''Editor: precedence?'').

=== Libraries ===

<div class="mw-translate-fuzzy">
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.
</div>

<div class="mw-translate-fuzzy">
'''Variables de entorno relativas a Python:'''
</div>

* PYTHONPATH
* PYTHONHOME
* TCL_LIBRARY
* TCLLIBPATH

<div class="mw-translate-fuzzy">
'''Variables de entorno relativas a OpenCascade:'''
</div>

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


<span id="Configuration_set"></span>
<div class="mw-translate-fuzzy">
== El conjunto de configuración ==
== El conjunto de configuración ==
</div>


<div class="mw-translate-fuzzy">
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.
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.
</div>


<span id="User_related_information"></span>
=== Información relativa al usuario===
=== Información relativa al usuario===


<div class="mw-translate-fuzzy">
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|+ Entradas de configuración de usuario
|+ Entradas de configuración de usuario
Line 87: Line 240:
| UserHomePath || Ruta de la carpeta de inicio del usuario actual || C:\Documents and Settings\username\My Documents ||/home/username
| UserHomePath || Ruta de la carpeta de inicio del usuario actual || C:\Documents and Settings\username\My Documents ||/home/username
|}
|}
</div>


Note: For Linux distributions, an additional configuration file that relates to [[Third_Party_Tools#Qt-Toolkit|Qt]] may exist at path {{FileName|/home/username/.config/FreeCAD/FreeCAD.conf}}.

<span id="Command_line_arguments"></span>
=== Argumentos de la línea de comando ===
=== Argumentos de la línea de comando ===


<div class="mw-translate-fuzzy">
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|+ Entradas de configuración de usuario
|+ Entradas de configuración de usuario
Line 111: Line 269:
| AdditionalModulePaths||Mantiene las rutas de módulos adicionales dados en la línea de comandos || "extraModules/"
| AdditionalModulePaths||Mantiene las rutas de módulos adicionales dados en la línea de comandos || "extraModules/"
|}
|}
</div>


<span id="System_related"></span>
=== Relativos al sistema ===
=== Relativos al sistema ===


<div class="mw-translate-fuzzy">
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|+ Entradas de configuración de usuario
|+ Entradas de configuración de usuario
Line 123: Line 284:
| 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 || ||
| 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 || ||
|}
|}
</div>


<span id="Build_related_information"></span>
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
'''Variables de entorno relativas al sistema:'''
* PATH
=== Información relativa a la construcción ===
=== Información relativa a la construcción ===


<div class="mw-translate-fuzzy">
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!
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!
</div>


<div class="mw-translate-fuzzy">
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|+ Entradas de configuración de usuario
|+ Entradas de configuración de usuario
Line 171: Line 315:
| BuildScrMixed || || Src not mixed
| BuildScrMixed || || Src not mixed
|}
|}
</div>


<span id="Branding_related"></span>
=== Relativos al marcado ===
=== Relativos al marcado ===


<div class="mw-translate-fuzzy">
Estas entradas de configuración son relativas al mecanismo de marcado de FreeCAD. Mira [[Branding/es|Marcado]] para más detalles.
Estas entradas de configuración son relativas al mecanismo de marcado de FreeCAD. Mira [[Branding/es|Marcado]] para más detalles.
</div>


<div class="mw-translate-fuzzy">
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|+ Entradas de configuración de usuario
|+ Entradas de configuración de usuario
Line 200: Line 348:
| HiddenDockWindow || Lista de dockwindows (separadas por un punto y coma) que serán mostradas || "Property editor"
| HiddenDockWindow || Lista de dockwindows (separadas por un punto y coma) que serán mostradas || "Property editor"
|}
|}
</div>


=== Querying the configuration ===
{{docnav/es|Third Party Tools/es|FreeCAD Build Tool/es}}


'''From FreeCAD's Python console'''
[[Category:Developer Documentation]]


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

'''From command line'''

Use the {{incode|--get-config <config-var-name>}} option to query a single name. Not all names are supported. For example:
FreeCAD --get-config ExeVersion

Use the {{incode|--dump-config}} option to get a list of names and their values. Not all names are supported.

'''From FreeCAD console'''

Start FreeCAD in console mode with {{incode|--console}} and query with Python code. For example:
$ FreeCAD --console
[FreeCAD Console mode <Use Ctrl-D (i.e. EOF) to exit.>]
>>> FreeCAD.ConfigGet("ExeVersion")
'0.19'
>>> exit()

For Linux (bash shell) you can modify the following command line to suit your needs:
$ FreeCAD --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

== Starting FreeCAD from the desktop ==

=== 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:
# Copy the freedesktop entry file for FreeCAD from {{FileName|/usr/share/applications/freecad.desktop}} to {{FileName|~/.local/share/applications}}.
# Change the name from {{FileName|freecad.desktop}} to something else (e.g. {{FileName|MyFreeCADConfig.desktop}}).
# Open the file with a text editor and change how FreeCAD is invoked by modifying the line starting with {{incode|Exec}}.
# 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, {{FileName|FreeCAD.exe}}, on the USB medium. Create a batch file, {{FileName|FreeCAD.bat}}, and put it into the same directory as {{FileName|FreeCAD.exe}}. Inside the batch file write:

{{Code|code=
set CURRENTDIR=%cd%
set FREECAD_USER_HOME=%CURRENTDIR%
start FreeCAD.exe -u FreeCAD/user.cfg -s FreeCAD/system.cfg --write-log
}}

Or with {{incode|FREECAD_USER_DATA}} ([https://forum.freecadweb.org/viewtopic.php?f=12&t=54784&start=60#p474759 see]):

{{Code|code=
set CURRENTDIR="%cd%"
set FREECAD_USER_DATA=%CURRENTDIR%/..
start FreeCAD.exe -u %FREECAD_USER_DATA%/user.cfg -s %FREECAD_USER_DATA%/system.cfg}}

With the batch in the root of the USB medium:

{{Code|code=
set CURRENTDIR=%cd%
set FREECAD_USER_DATA=%CURRENTDIR%FreeCAD\
start %cd%FreeCAD\bin\FreeCAD.exe -u %FREECAD_USER_DATA%user.cfg -s %FREECAD_USER_DATA%system.cfg
}}

Now double-click the batch file to start FreeCAD. ([https://forum.freecadweb.org/viewtopic.php?f=4&t=49028 see])


<div class="mw-translate-fuzzy">
{{docnav/es|Third Party Tools/es|FreeCAD Build Tool/es}}
</div>

{{Userdocnavi{{#translation:}}}}
[[Category:Developer Documentation{{#translation:}}]]

Latest revision as of 15:27, 20 May 2023

In FreeCAD version 0.20 the default location of the program's configuration, data and cache files was changed for Linux.
See Release notes 0.20 for more information. This page has not yet been updated accordingly.

Overview

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.

Using command line options without a command line shell

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:

Long option Corresponding config var name Synopsis
--user-cfg <filename> UserParameter Filename or relative path that ends with a filename. Defaults to user.cfg.
--module-path <dir> Prepends to AdditionalModulePaths Directory that contains modules. This option can be given repeatedly to specify multiple directories.
--get-config <config-var-name> most Outputs the requested value in a popup dialog. Exits upon confirmation with OK. Cannot be used repeatedly. If an unknown/illegal variable name is used, the response is empty. The --console flag is not honored.

Options can written in two forms: --long-option arg and --long-option=arg.

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 FreeCAD.cfg. 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

File type System Command line example
Module Windows "C:\Program Files\FreeCAD\bin\FreeCAD.exe" -M "C:\FreeCAD\Mod\Draft"
Linux FreeCAD_0.19 -M ~/.FreeCAD/Mod/Draft
Linux (AppImage) path/to/FreeCADXXX.AppImage -M ~/.FreeCAD/Mod/Draft
.FCMacro or .py Windows "C:\Program Files\FreeCAD\bin\FreeCAD.exe" "C:\Users\userName\AppData\Roaming\FreeCAD\Mod\WorkFeature\start_WF.FCMacro"
Linux FreeCAD_0.19 ~/.FreeCAD/Mod/WorkFeature/start_WF.FCMacro
Linux (AppImage) path/to/FreeCADXXX.AppImage ~/.FreeCAD/Mod/WorkFeature/start_WF.FCMacro

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: introduced in version 0.19

Environment variable Corresponding config var name Synopsis
FREECAD_USER_HOME UserHomePath FreeCAD's "base" directory for keeping local user data.
FREECAD_USER_DATA UserAppData If not set, defaults to FREECAD_USER_HOME/.FreeCAD, but only if FREECAD_USER_HOME is set.
FREECAD_USER_TEMP AppTempPath If not set, defaults to FREECAD_USER_HOME/temp, but only if FREECAD_USER_HOME is set.

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.

HOME

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

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

TMPDIR

The default temporary directory is /tmp/. The TMPDIR 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

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

Note: For Linux distributions, an additional configuration file that relates to Qt may exist at path /home/username/.config/FreeCAD/FreeCAD.conf.

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

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!

Entradas de configuración de usuario
Nombre variable configuración Sinopsis Ejemplo
BuildVersionMajor Número de versión principal de la construcción. Definida en src/Build/Version.h.in 0
BuildVersionMinor Número de versión secundario de la construcción. Definida en src/Build/Version.h.in 7
BuildRevision Número de revisión del repositorio SVN del src en la construcción. Generado por SVN 356
BuildRevisionRange Rango de diferentes cambios 123-356
BuildRepositoryURL URL del repositorio https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
BuildRevisionDate Fecha de la revisión de arriba 2007/02/03 22:21:18
BuildScrClean Indica si el código fuente fue modificado después de su descarga Src modified
BuildScrMixed Src not mixed

Relativos al marcado

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

Entradas de configuración de usuario
Nombre variable configuración Sinopsis Ejemplo
ExeName Nombre del archivo ejecutable de la construcción. Puede diferir de la de FreeCAD si es utilizado un main.cpp diferente. FreeCAD.exe
ExeVersion Versión global mostrada al inicio V0.7
AppIcon Icono que es utilizado por el ejecutable, mostrado en Application MainWindow. "FCIcon"
ConsoleBanner Banner que es mostrado en modo consola
SplashPicture Nombre del icono utilizado por la pantalla de bienvenida "FreeCADSplasher"
SplashAlignment Alineación del texto en el letrero de diálogo de bienvenida Left"
SplashTextColor Color del texto de bienvenida "#000000"
StartWorkbench Nombre del entorno que comenzará automáticamente después del inicio "Part design"
HiddenDockWindow Lista de dockwindows (separadas por un punto y coma) que serán mostradas "Property editor"

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 --get-config <config-var-name> option to query a single name. Not all names are supported. For example:

 FreeCAD --get-config ExeVersion

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

From FreeCAD console

Start FreeCAD in console mode with --console and query with Python code. For example:

 $ FreeCAD --console
 [FreeCAD Console mode <Use Ctrl-D (i.e. EOF) to exit.>]
 >>> FreeCAD.ConfigGet("ExeVersion")
 '0.19'
 >>> exit()

For Linux (bash shell) you can modify the following command line to suit your needs:

 $ FreeCAD --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

Starting FreeCAD from the desktop

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 /usr/share/applications/freecad.desktop to ~/.local/share/applications.
  2. Change the name from freecad.desktop to something else (e.g. MyFreeCADConfig.desktop).
  3. Open the file with a text editor and change how FreeCAD is invoked by modifying the line starting with Exec.
  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, FreeCAD.exe, on the USB medium. Create a batch file, FreeCAD.bat, and put it into the same directory as FreeCAD.exe. Inside the batch file write:

set CURRENTDIR=%cd%
set FREECAD_USER_HOME=%CURRENTDIR%
start FreeCAD.exe -u FreeCAD/user.cfg -s FreeCAD/system.cfg --write-log

Or with FREECAD_USER_DATA (see):

set CURRENTDIR="%cd%"
set FREECAD_USER_DATA=%CURRENTDIR%/..
start FreeCAD.exe -u %FREECAD_USER_DATA%/user.cfg -s %FREECAD_USER_DATA%/system.cfg

With the batch in the root of the USB medium:

set CURRENTDIR=%cd%
set FREECAD_USER_DATA=%CURRENTDIR%FreeCAD\
start %cd%FreeCAD\bin\FreeCAD.exe -u %FREECAD_USER_DATA%user.cfg -s %FREECAD_USER_DATA%system.cfg

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


Third Party Tools/es
FreeCAD Build Tool/es