Esta página muestra las diferentes formas de iniciar FreeCAD y las características de configuración más importantes.
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.
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 --response-file arg can be specified with '@name', too
Configuration: -l [ --write-log ] arg write a log file to default location(Run FreeCAD --h to see default location) --log-file arg Unlike to --write-log this allows to log 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 level -M [ --module-path ] arg additional module paths -P [ --python-path ] arg additional python paths
EX: (Windows)
"C:\Program Files\FreeCAD 0.14\bin\FreeCAD.exe" -M "N:\FreeCAD\Mod\Draft" -M "N:\FreeCAD\Mod\Part" -M "N:\FreeCAD\Mod\Drawing" -u "N:\FreeCAD\Config\user.cfg" -s "N:\FreeCAD\Config\system.cfg"
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
Existen varias opciones no visibles por el usuario. Estas opciones son por ejemplo los parámetros de X-Window analizados por el sistema Windows:
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.
Python scripts/FreeCAD macro files can be specified as command line arguments to either of the executables mentioned above.
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.
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 |
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/" |
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:
Variables de entorno relativas a OpenCascade:
Variables de entorno relativas al sistema:
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!
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 |
Estas entradas de configuración son relativas al mecanismo de marcado de FreeCAD. Mira Marcado para más detalles.
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" |