Start up and Configuration/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "=== Options cachées ===")
No edit summary
 
(245 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
Cette page montre, les différentes façons de lancer FreeCAD, et, ses configurations les plus importantes.

{{Docnav/fr
|[[Import_Export_Preferences/fr|Préférences d'Import Export]]
|[[Scripting_and_macros/fr|Scripts et macros]]
}}

{{VeryImportantMessage|Dans la version 0.20 de FreeCAD, l'emplacement par défaut des fichiers de configuration, de données et de cache du programme a été modifié pour Linux.<br>
Voir les [[Release_notes_0.20/fr#Noyau|Notes de version 0.20]] pour plus d'informations. Cette page n'a pas encore été mise à jour en conséquence.}}

{{TOCright}}

<span id="Overview"></span>
== Présentation ==

Cette page montre les différentes façons de lancer FreeCAD et ses éléments de configuration les plus importants.


<span id="Starting_FreeCAD_from_the_Command_line"></span>
== Démarrer FreeCAD en ligne de commande ==
== Démarrer FreeCAD en ligne de commande ==


FreeCAD peut être lancé normalement, en double-cliquant sur son icône qui est sur le bureau, ou, en le sélectionnant dans le menu de démarrage, mais, il peut également être lancé directement à partir de la ligne de commande. Cela vous permet de changer les options de démarrage par défaut '''SOEM'''.
FreeCAD peut être lancé normalement en double-cliquant sur son icône qui est sur le bureau, ou en le sélectionnant dans le menu de démarrage, mais il peut également être lancé directement à partir de la ligne de commande. Cela vous permet de changer les options de démarrage par défaut.


<span id="Using_command_line_options_without_a_command_line_shell"></span>
=== Les options disponibles en ligne de commande ===
=== Utilisation des options en ligne de commande sans utiliser le shell ===

* Sur Ubuntu, vous pouvez créer une icône de bureau et modifier leurs propriétés. Ajoutez les options de ligne de commande séparées par des espaces derrière le nom du programme dans le champ "Commande".
* Sous Windows, créez un raccourci et modifiez ses propriétés. Ajoutez les options de ligne de commande séparées par des espaces dans le champ "Cible".

<span id="Command_line_options"></span>
=== Options disponibles en ligne de commande ===

Les options en ligne de commande sont l'objet de fréquents changements. Il est donc sage de vérifier les options de votre version courante en tapant :


Les options en ligne de commande sont l'objet de fréquents changements, il est donc sage de vérifier les options de votre version courante en tapant :
FreeCAD --help
FreeCAD --help

Les réponses disponibles, sont dans les paramètres :
La réponse vous permet de connaître les paramètres disponibles :
Usage:

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

Dans le tableau suivant, les options sélectionnées sont décrites plus en détail :

{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|-
! Option longue !! [[#Configuration|Nom de la variable de configuration]] correspondante !! Synopsis
|-
| {{incode|--user-cfg <filename>}} || UserParameter || Nom de fichier ou chemin relatif qui se termine par un nom de fichier. La valeur par défaut est {{incode|user.cfg}}.
|-
| {{incode|--module-path <dir>}} || Préfèrée à AdditionalModulePaths || Répertoire qui contient des modules. Cette option peut être donnée à plusieurs reprises pour spécifier plusieurs répertoires.
|-
| {{incode|--get-config <config-var-name>}} || La plus part || Affiche la valeur demandée dans une boîte de dialogue contextuelle. Quitte après confirmation avec {{KEY|OK}}. Ne peut pas être utilisé à plusieurs reprises. Si un nom de variable inconnu / illégal est utilisé, la réponse est vide. L'indicateur {{incode|--console}} n'est pas respecté.
|}
Les options peuvent être rédigées sous deux formes : {{incode|--long-option arg}} et {{incode|--long-option<nowiki>=</nowiki>arg}}.

<span id="Response_and_config_files"></span>
=== Fichiers de configuration et réponse ===


Vous pouvez lire certaines options de FreeCAD à partir d'un fichier de configuration.
Vous pouvez lire certaines options de FreeCAD à partir d'un fichier de configuration.
Ce fichier doit être dans le répertoire '''/bin''' et doit être nommé '''FreeCAD.cfg'''.
Ce fichier doit être dans le répertoire {{FileName|/bin}} et doit être nommé {{FileName|FreeCAD.cfg}}. Notez que les options spécifiées en ligne de commande remplacent le fichier de configuration !

'''Notez, que les options spécifiées en ligne de commande, remplacent le fichier de configuration !'''
Certains systèmes d'exploitation ne permettent qu'un nombre de caractères assez limité en ligne de commande. La façon courante de contourner cette limitation, est l'utilisation des fichiers ''response''. Un fichier ''response'' n'est qu'un fichier de configuration, qui utilise la même syntaxe qu'en ligne de commande. Si la ligne de commande spécifie un nom de fichier ''response'' à utiliser, il est chargé, analysé et ajouté à la ligne de commande :

<pre>
FreeCAD @ResponseFile.txt
</pre>

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

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


<span id="Hidden_options"></span>
Certains systèmes d'exploitation ont une limite assez courte de la longueur de la chaîne, en ligne de commande. La façon courante de contourner ces limitations, est l'utilisation des fichiers de '''Response'''. Un fichier de '''Response''' n'est qu'un fichier de configuration, qui utilise la même syntaxe qu'a la ligne de commande. Si la ligne de commande spécifie un nom de fichier de '''Response''' à utiliser, il est chargé analysé, et s'ajoute à la ligne de commande :
FreeCAD @ResponseFile.txt
ou :
FreeCAD --response-file=ResponseFile.txt
=== Options cachées ===
=== Options cachées ===


There are a couple of options not visible to the user. These options are e.g. the X-Window parameters parsed by the Windows system:
Il y a des options qui sont invisibles à l'utilisateur. Ces options sont, par exemple, les paramètres X-Window analysés par le système Windows :
* -display display, sets the X display (default is $DISPLAY).
* '''-display display''', définit l'affichage X (valeur par défaut est $DISPLAY).
* -geometry geometry, sets the client geometry of the first window that is shown.
* '''-geometry geometry''', la géométrie fixe de la première fenêtre client qui est affichée.
* -fn or -font font, defines the application font. The font should be specified using an X logical font description.
* '''-fn or -font font''', définit la police de l'application. La police doit être spécifié en utilisant la description de police logique X.
* -bg or -background color, sets the default background color and an application palette (light and dark shades are calculated).
* '''-bg or -background color''', définit la couleur de fond par défaut et une palette d'application (tons clairs et foncés sont calculés).
* -fg or -foreground color, sets the default foreground color.
* '''-fg or -foreground color''', définit la couleur de premier plan par défaut.
* -btn or -button color, sets the default button color.
* '''-btn or -button color''', définit la couleur des boutons par défaut.
* -name name, sets the application name.
* '''-name name''', définit le nom de l'application.
* -title title, sets the application title.
* '''-title title''', définit le titre de l'application.
* -visual TrueColor, forces the application to use a TrueColor visual on an 8-bit display.
* '''-visual TrueColor''', force l'application à utiliser un visuel TrueColor sur un affichage 8-bits.
* -ncols count, limits the number of colors allocated in the color cube on an 8-bit display, if the application is using the QApplication::ManyColor color specification. If count is 216 then a 6x6x6 color cube is used (i.e. 6 levels of red, 6 of green, and 6 of blue); for other values, a cube approximately proportional to a 2x3x1 cube is used.
* '''-ncols count''', limite le nombre de couleurs allouées dans le cube de couleur sur un écran 8-bits, si l'application utilise la spécification de couleur QApplication::ManyColor. Si le nombre est 216, un cube 6x6x6 couleurs est utilisé (soit 6 niveaux de rouge, 6 de vert, et 6 de bleu); pour d'autres valeurs un cube à peu près proportionnel à un cube 2x3x1 couleurs est utilisé.
* '''-cmap''', provoque l'installation d'une carte de couleurs réservée à l'application, sur un affichage 8-bits.
* -cmap, causes the application to install a private color map on an 8-bit display.


<span id="Running_FreeCAD_without_GUI_(headless)"></span>
=== Executer FreeCAD sans interface graphique utilisateur ===


FreeCAD est généralement compilé avec deux exécutables : un exécutable compatible avec l'interface graphique, appelé {{FileName|FreeCAD}} ou {{FileName|freecad}}, et un exécutable sans tête, appelé {{FileName|FreeCADCmd}} ou {{FileName|freecadcmd}}.
== Running FreeCAD without User Interface ==
FreeCAD peut être utilisé en mode console en utilisant le commutateur {{incode|--console}} (qui est le comportement par défaut de {{FileName|FreeCADCmd}}) :


FreeCAD --console
FreeCAD normally starts in GUI mode, but you can also force it to start in console mode by typing:
FreeCAD -c
from the command line. In console mode, no user interface will be displayed, and you will be presented with a python interpreter prompt. From that python prompt, you have the same functionality as the python interpreter that runs inside the FreeCAD GUI, and normal access to all modules and plugins of FreeCAD, excepted the FreeCADGui module. Be aware that modules that depend on FreeCADGui might also be unavailable.


En mode console, aucune interface utilisateur graphique ne sera affichée et vous serez invité à utiliser l'interpréteur Python : {{incode|>>>>}}. À partir de cette invite, vous disposez des mêmes fonctionnalités que l'interpréteur Python qui fonctionne dans l'interface graphique de FreeCAD, et vous avez accès à tous les modules et plugins de FreeCAD, à l'exception du module FreeCADGui. Sachez que les modules qui dépendent de FreeCADGui peuvent également être indisponibles.


Pour en savoir plus sur le mode console ou le mode sans tête, consultez [[Headless_FreeCAD/fr|FreeCAD sans GUI]].
== Running FreeCAD as a python module ==


<span id="Running_modules,_macros_and_scripts"></span>
FreeCAD can also be used to run as a python module inside other applications that use python or from an external python shell. For that, the host python application must know where your FreeCAD libs reside. The best way to obtain that is to temporarily append FreeCAD's lib path to the sys.path variable. The following code typed from any python shell will import FreeCAD and let you run it the same way as in console mode:
=== Exécution de modules, macros et scripts ===


{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
<syntaxhighlight>
! Type de fichier !! Système !! Exemple en lignes de commande
import sys
|-
sys.path.append("path/to/FreeCAD/lib") # change this by your own FreeCAD lib path
| Module ||Windows || {{incode|"C:\Program Files\FreeCAD\bin\FreeCAD.exe" -M "C:\FreeCAD\Mod\Draft"}}
import FreeCAD
|-
</syntaxhighlight>
| ||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}}
|}

Voir [[Macro_at_Startup/fr|Macro at Startup]] pour savoir comment configurer une macro pour qu'elle s'exécute automatiquement au démarrage de FreeCAD.

<span id="Environment_variables"></span>
== Variables d'environnement ==

FreeCAD prend en charge les variables d'environnement suivantes, qui peuvent être utilisées pour configurer les répertoires: {{Version/fr|0.19}}
{| border="2" cellpadding="4" cellspacing="0" style="margin-top:1em; margin-bottom:1em; background:#f9f9f9; border:1px #aaa solid; border-collapse:collapse;"
|-
! Variable d'environnement !! [[#Ensemble_de_configuration|Nom de la variable de configuration]] correspondante !! Synopsis
|-
| {{incode|FREECAD_USER_HOME}} || UserHomePath || Répertoire "de base" de FreeCAD pour conserver les données des utilisateurs locaux.
|-
| {{incode|FREECAD_USER_DATA}} || UserAppData || S'il n'est pas défini, la valeur par défaut est {{incode|FREECAD_USER_HOME/.FreeCAD}} mais uniquement si {{incode|FREECAD_USER_HOME}} est défini.
|-
| {{incode|FREECAD_USER_TEMP}} || AppTempPath || S'il n'est pas défini, la valeur par défaut est {{incode|FREECAD_USER_HOME/temp}} mais uniquement si {{incode|FREECAD_USER_HOME}} est défini.
|}
Si le chemin spécifié n'existe pas, le paramètre est ignoré!

Les variables d'environnement ci-dessus sont destinées à être utilisées pour réaliser un environnement FreeCAD ''portable''. Pour un exemple d'utilisation des variables d'environnement à partir de la ligne de commande sous Linux, reportez-vous aux [[Download/fr#Note_aux_utilisateurs_de_GNU.2FLinux|notes pour les utilisateurs Linux sur la page de téléchargement]].

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

FreeCAD utilise [[Third_Party_Libraries/fr#Qt|Qt]], qui respecte la variable d'environnement {{incode|HOME}}. Ainsi, le paramètre {{incode|HOME}} peut être utilisé pour spécifier le répertoire de base des fichiers de configuration liés à Qt ({{incode|.config/FreeCAD/FreeCAD.conf}}).

FreeCad lui-même ne respecte pas la variable d'environnement {{incode|HOME}} (car cela détermine le répertoire personnel de l'utilisateur à partir d'une API système de niveau inférieur). Utilisez {{incode|FREECAD_USER_HOME}} pour cela.

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

Le répertoire temporaire par défaut est {{FileName|/tmp/}}. La variable d'environnement {{incode|TMPDIR}} peut être utilisée pour remplacer la valeur par défaut. (''Editeur:priorité?'').

<span id="Libraries"></span>
=== Bibliothèques ===

Certaines bibliothèques doivent appeler des variables d'environnement système. Parfois, lorsqu'il y a un problème avec une installation de FreeCAD, c'est parce qu'une variable d'environnement est absente ou incorrecte. Par conséquent, certaines variables importantes sont dupliquées dans la configuration et enregistrées dans le fichier de log.

'''Python'''

* PYTHONPATH
* PYTHONHOME
* TCL_LIBRARY
* TCLLIBPATH

'''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


<span id="Configuration_set"></span>
Once FreeCAD is loaded, it is up to you to make it interact with your host application in any way you can imagine!
== Configuration ==


A chaque démarrage, FreeCAD examine son environnement, ainsi que les paramètres en ligne de commande. Il construit un '''ensemble de configuration''' qui détient le cœur des informations d'exécution. Ces informations sont ensuite utilisées pour déterminer l’emplacement où enregistrer les données des utilisateurs ou des fichiers journaux. Il est également très important pour les analyses post-mortem. Par conséquent, il est enregistré dans le fichier des logs.
== The Config set ==


<span id="User_related_information"></span>
On every Startup FreeCAD examines its surrounding and the command line parameters. It builds up a '''configuration set''' which holds the essence of the runtime information. This information is later used to determine the place where to save user data or log files. It is also very important for post postmortem analyzes. Therefore it is saved in the log file.
=== Informations relatives à l'utilisateur===


L'appel se fait de la manière suivante :
=== User related information===
path = FreeCAD.ConfigGet("UserAppData")


{| 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;"
|+ User config entries
|-
|-
! Config var name !! Synopsis !! Example M$ !! Example Posix (Linux)
! Nom de la variable de configuration !! Synopsis !! Exemple Windows !! Exemple Linux
|-
|-
| UserAppData || Path where FreeCAD stores User Related application data. || C:\Documents and Settings\username\Application Data\FreeCAD ||/home/username/.FreeCAD
| UserAppData || Chemin FreeCAD met les données utilisateur de l'application. ||{{FileName|C:\Documents and Settings\username\AppData\FreeCAD}}<hr />''Chemin court : ''{{FileName|%APPDATA%\FreeCAD}} || {{FileName|/home/username/.FreeCAD}}<hr />''Chemin court : ''{{FileName|~/.FreeCAD}}
|-
|-
| UserParameter || File where FreeCAD stores User Related application data. || C:\Documents and Settings\username\Application Data\FreeCAD\user.cfg ||/home/username/.FreeCAD/user.cfg
| UserParameter || Chemin FreeCAD met les fichier utilisateur de l'application. || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\user.cfg}}<hr />''Chemin court : ''{{FileName|%APPDATA%\FreeCAD\user.cfg}} || {{FileName|/home/username/.config/FreeCAD/user.cfg}}<hr />''Chemin court : ''{{FileName|~/.config/FreeCAD/user.cfg}} or {{FileName|$HOME/.config/FreeCAD/user.cfg}}
|-
|-
| SystemParameter || File where FreeCAD stores Application Related data. || C:\Documents and Settings\username\Application Data\FreeCAD\system.cfg ||/home/username/.FreeCAD/system.cfg
| SystemParameter || Fichier sont les données de l'application. || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\system.cfg}}<hr />''Chemin court : ''{{FileName|%APPDATA%\FreeCAD\system.cfg}} || {{FileName|/home/username/.config/FreeCAD/system.cfg}}<hr />''Chemin court : ''{{FileName|~/.FreeCAD/system.cfg}} or {{FileName|$HOME/.FreeCAD/system.cfg}}
|-
|-
| UserHomePath || Home path of the current user || C:\Documents and Settings\username\My Documents ||/home/username
| UserHomePath || Chemin racine de l'utilisateur courant. || {{FileName|C:\Documents and Settings\username}}<hr />''Chemin court : ''{{FileName|%USERPROFILE%}} || {{FileName|/home/username}}<hr />''Chemin court : ''{{FileName|~}}
|}
|}


Remarque: pour les distributions Linux, un fichier de configuration supplémentaire lié à [[Third_Party_Libraries/fr#Qt|Qt]] peut exister au chemin {{FileName|/home/username/.config/FreeCAD/FreeCAD.conf}}.
=== Command line arguments ===

<span id="Command_line_arguments"></span>
=== Paramètres en ligne de commande ===


{| 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;"
|+ User config entries
|-
|-
! Config var name !! Synopsis !! Example
! Nom de la variable de configuration !! Synopsis !! Exemple
|-
|-
| LoggingFile || 1 if the logging is switched on || 1
| LoggingFile || 1 si l'enregistrement est activé || 1
|-
|-
| LoggingFileName || File name where the log is placed || C:\Documents and Settings\username\Application Data\FreeCAD\FreeCAD.log
| LoggingFileName || Nom du fichier ou le joural est placé || {{FileName|C:\Documents and Settings\username\AppData\FreeCAD\FreeCAD.log}}
|-
|-
| RunMode || This indicates how the main loop will work. '''"Script"''' means that the given script is called and then exit. '''"Cmd"''' runs the command line interpreter. '''"Internal"''' runs an internal script. '''"Gui"''' enters the Gui event loop. '''"Module"''' loads a given python module. || "Cmd"
| RunMode || Cela indique comment la boucle principale travaillera. '''"Script"''' signifie que le script donné est appelé puis quitté. '''"Cmd"''' est destiné à l’interpréteur en ligne de commande. '''"Internal"''' exécute un script interne. '''"Gui"''' entre dans la boucle d'évènement Gui. '''"Module"''' charge un module Python donné. || "Cmd"
|-
|-
| FileName || Meaning depends on the RunMode ||
| FileName || Dépend du RunMode ||
|-
|-
| ScriptFileName || Meaning depends on the RunMode ||
| ScriptFileName || Dépend du RunMode ||
|-
|-
| Verbose || Verbosity level of FreeCAD || "" or "strict"
| Verbose || Niveau de verbosité de FreeCAD || "" or "strict"
|-
|-
| OpenFileCount ||Holds the number of files opened through command line arguments || "12"
| OpenFileCount || Donne le nombre de dossiers ouverts par les arguments en ligne de commande || "12"
|-
|-
| AdditionalModulePaths||Holds the additional Module paths given in the cmd line || "extraModules/"
| AdditionalModulePaths|| Contient les chemins des modules supplémentaires donnés dans la ligne de commande || "extraModules/"
|}
|}


<span id="System_related"></span>
=== System related ===
=== Relatif au système ===


{| 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;"
|+ User config entries
|-
|-
! Config var name !! Synopsis !! Example M$ !! Example Posix (Linux)
! Nom de la variable de configuration !! Synopsis !! Exemple Windows !! Exemple Linux
|-
|-
| AppHomePath || Path where FreeCAD is installed || c:/Progam Files/FreeCAD_0.7|| /user/local/FreeCAD_0.7
| AppHomePath || Chemin est installé FreeCAD || {{FileName|c:/Progam Files/FreeCAD_0.19}}|| /user/local/FreeCAD_0.19
|-
|-
| PythonSearchPath || Holds a list of paths which python search modules. This is at startup can change during execution || ||
| PythonSearchPath || Donne une liste de chemins que les modules Python recherchent. S'effectue au démarrage, et peut changer en cours d'exécution || ||
|-
| AppTempPath || Chemin du répertoire temporaire.<br >Peut être donné avec la variable d'environnement {{incode|TMPDIR}} ou avec l'[[Image:Std_DlgParameter.svg|16px]] [[Std_DlgParameter/fr|éditeur des paramètres]]: {{MenuCommand|Outils → Editer paramètres ... → BaseApp → Préférences → Général → TempPath}} || || {{FileName|/tmp/}} (par défaut)
|}
|}


<span id="Build_related_information"></span>
Some libraries need to call system environment variables. Sometimes when there is a problem with a FreeCAD installation, it is because some environment variable is absent or set wrongly. Therefore, some important variables get duplicated in the Config and saved in the log file.
=== Informations relatives à la version ===


Le tableau ci-dessous montre les informations générées par la version disponible. La plupart proviennent du dépôt de sous-version. Cette astuce est nécessaire pour reconstruire exactement une version !
'''Python related environment variables:'''
* 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!


{| 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;"
|+ User config entries
|-
|-
! Config var name !! Synopsis !! Example
! Nom de la variable de configuration !! Synopsis !! Exemple
|-
|-
| BuildVersionMajor || Major Version number of the Build. Defined in src/Build/Version.h.in || 0
| BuildVersionMajor || Numéro de version majeure de la construction. Définie dans {{FileName|src/Build/Version.h.in}} || 0
|-
|-
| BuildVersionMinor || Minor Version number of the Build. Defined in src/Build/Version.h.in || 7
| BuildVersionMinor || Numéro de version mineure de la construction. Définie dans {{FileName|src/Build/Version.h.in}} || 7
|-
|-
| BuildRevision || SVN Repository Revision number of the src in the Build. Generated by SVN || 356
| BuildRevision || Numéro de révision du référentiel SVN du src de construction. Généré par SVN || 356
|-
|-
| BuildRevisionRange || Range of differnt changes || 123-356
| BuildRevisionRange || Gamme de différents changements || 123-356
|-
|-
| BuildRepositoryURL || Repository URL || https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
| BuildRepositoryURL || URL de référence || https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
|-
|-
| BuildRevisionDate || Date of the above Revision || 2007/02/03 22:21:18
| BuildRevisionDate || Date de la révision ci-dessus || 2007/02/03 22:21:18
|-
|-
| BuildScrClean || Indicates if the source was changed ager checkout ||Src modified
| BuildScrClean || Indique si la source a été modifiée après la dernière construction || Source modifiée
|-
|-
| BuildScrMixed || || Src not mixed
| BuildScrMixed || || Source non mixée
|}
|}


<span id="Branding_related"></span>
=== Branding related ===
=== Identité liée à la marque ===


These Config entries are related to the branding mechanism of FreeCAD. See [[Branding]] for more details.
Ces entrées de configuration sont liées au dispositif d'identification à la marque FreeCAD. Voir [[Branding/fr|Branding]] pour plus de renseignements.


{| 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;"
|+ User config entries
|-
|-
! Config var name !! Synopsis !! Example
! Nom de la variable de configuration !! Synopsis !! Exemple
|-
|-
| ExeName || Name of the build Executable file. Can diver from FreeCAD if a different main.cpp is used. || FreeCAD.exe
| ExeName || Nom du fichier exécutable de compilation. Ce nom peut être différent de FreeCAD si un {{FileName|main.cpp}} différent est utilisé. || {{FileName|FreeCAD.exe}}
|-
|-
| ExeVersion || Over all Version shows up at start time || V0.7
| ExeVersion || La version présente au moment de la compilation || V0.19
|-
|-
| AppIcon || Icon which is used for the Executable, shows in Application MainWindow. || "FCIcon"
| AppIcon || L'icône qui est utilisé pour l'exécutable, affichée dans la fenêtre principale d'application || "FCIcon"
|-
|-
| ConsoleBanner || Banner which is prompted in console mode ||
| ConsoleBanner || Bannière du prompt en mode console ||
|-
|-
| SplashPicture || Name of the Icon used for the Splash Screen || "FreeCADSplasher"
| SplashPicture || Nom de l'icône utilisée pour l'écran de démarrage || "FreeCADSplasher"
|-
|-
| SplashAlignment || Alignment of the Text in the Splash dialog || "Bottom|Left"
| SplashAlignment || Alignement du texte dans la boîte de dialogue Splash || "Bottom" ou "Left"
|-
|-
| SplashTextColor || Color of the splasher Text || "#000000"
| SplashTextColor || Couleur du texte splashé || "#000000"
|-
|-
| StartWorkbench || Name of the Workbech which get started automaticly after Startup || "Part design"
| StartWorkbench || Nom de l'atelier lancé automatiquement après le démarrage || "PartDesign"
|-
|-
| HiddenDockWindow || List of dockwindows (separated by a semicolon) which will be disabled || "Property editor"
| HiddenDockWindow || Liste des dockwindows (séparés par un point-virgule) qui seront désactivés || "Property editor"
|}
|}


<span id="Querying_the_configuration"></span>
{{docnav|Third Party Tools|FreeCAD Build Tool}}
=== Interrogation de la configuration ===


'''Depuis la console Python de FreeCAD'''
[[Category:Developer Documentation]]


Les entrées de la configuration peuvent être interrogées avec le '''nom de la variable de configuration''' (voir les tableaux ci-dessus) depuis la [[Python_console/fr|console Python]]. Par exemple :
{{clear}}
>>> FreeCAD.ConfigGet("ExeVersion")
<languages/>
'0.19'
Si le nom n'est pas trouvé, une chaîne vide est renvoyée.

'''En ligne de commande'''

Utilisez l'option {{incode|--get-config <config-var-name>}} pour interroger un seul nom. Tous les noms ne sont pas pris en charge. Par exemple :
FreeCAD --get-config ExeVersion

Utilisez l'option {{incode|--dump-config}} pour obtenir une liste de noms et leurs valeurs. Tous les noms ne sont pas pris en charge.

'''Depuis la console FreeCAD'''

Démarrez FreeCAD en mode console avec {{incode|--console}} et interrogez avec du code Python. Par exemple :
$ FreeCAD --console
[FreeCAD Console mode <Use Ctrl-D (i.e. EOF) to exit.>]
>>> FreeCAD.ConfigGet("ExeVersion")
'0.19'
>>> exit()

Pour Linux (shell bash), vous pouvez modifier la ligne de commande suivante en fonction de vos besoins :
$ 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

<span id="Starting_FreeCAD_from_the_desktop"></span>
== Démarrage de FreeCAD à partir du bureau ==

<span id="Linux:_Creating_an_additional_start_option"></span>
=== Linux : création d'une option de démarrage supplémentaire ===

Ce qui suit suppose que votre bureau est configuré de telle sorte que vous puissiez lancer FreeCAD à partir de celui-ci. En fonction de votre distribution Linux et de votre environnement de bureau, vous devrez peut-être adapter les étapes suivantes :
# Copiez le fichier d'entrée freedesktop pour FreeCAD de {{FileName|/usr/share/applications/freecad.desktop}} vers {{FileName|~/.local/share/applications}}.
# Changez le nom de {{FileName|freecad.desktop}} en autre chose (par exemple {{FileName|MyFreeCADConfig.desktop}}).
# Ouvrez le fichier avec un éditeur de texte et changez la façon dont FreeCAD est appelé en modifiant la ligne commençant par {{incode|Exec}}.
# Pour résultat, une entrée supplémentaire dans votre menu Démarrer/lanceur d'application est disponible. De cette façon, vous pouvez avoir plusieurs entrées FreeCAD avec différentes options de lancement.

<span id="Starting_FreeCAD_from_a_portable_USB_medium"></span>
== Démarrage de FreeCAD à partir d'un medium USB ==

'''Windows'''

Placez l'exécutable FreeCAD, {{FileName|FreeCAD.exe}}, sur le support USB. Créez un fichier batch, {{FileName|FreeCAD.bat}} et placez-le dans le même répertoire que {{FileName|FreeCAD.exe}}. Dans le fichier batch, écrivez :

{{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}}

Avec le batch dans la racine du support USB :

{{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
}}

Maintenant, double-cliquez sur le fichier de commandes pour démarrer FreeCAD. ([https://forum.freecadweb.org/viewtopic.php?f=4&t=49028 voir ce fil])


{{Docnav/fr
|[[Import_Export_Preferences/fr|Préférences d'Import Export]]
|[[Scripting_and_macros/fr|Scripts et macros]]
}}

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

Latest revision as of 11:08, 28 January 2024

Dans la version 0.20 de FreeCAD, l'emplacement par défaut des fichiers de configuration, de données et de cache du programme a été modifié pour Linux.
Voir les Notes de version 0.20 pour plus d'informations. Cette page n'a pas encore été mise à jour en conséquence.

Présentation

Cette page montre les différentes façons de lancer FreeCAD et ses éléments de configuration les plus importants.

Démarrer FreeCAD en ligne de commande

FreeCAD peut être lancé normalement en double-cliquant sur son icône qui est sur le bureau, ou en le sélectionnant dans le menu de démarrage, mais il peut également être lancé directement à partir de la ligne de commande. Cela vous permet de changer les options de démarrage par défaut.

Utilisation des options en ligne de commande sans utiliser le shell

  • Sur Ubuntu, vous pouvez créer une icône de bureau et modifier leurs propriétés. Ajoutez les options de ligne de commande séparées par des espaces derrière le nom du programme dans le champ "Commande".
  • Sous Windows, créez un raccourci et modifiez ses propriétés. Ajoutez les options de ligne de commande séparées par des espaces dans le champ "Cible".

Options disponibles en ligne de commande

Les options en ligne de commande sont l'objet de fréquents changements. Il est donc sage de vérifier les options de votre version courante en tapant :

FreeCAD --help

La réponse vous permet de connaître les paramètres disponibles :

 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

Dans le tableau suivant, les options sélectionnées sont décrites plus en détail :

Option longue Nom de la variable de configuration correspondante Synopsis
--user-cfg <filename> UserParameter Nom de fichier ou chemin relatif qui se termine par un nom de fichier. La valeur par défaut est user.cfg.
--module-path <dir> Préfèrée à AdditionalModulePaths Répertoire qui contient des modules. Cette option peut être donnée à plusieurs reprises pour spécifier plusieurs répertoires.
--get-config <config-var-name> La plus part Affiche la valeur demandée dans une boîte de dialogue contextuelle. Quitte après confirmation avec OK. Ne peut pas être utilisé à plusieurs reprises. Si un nom de variable inconnu / illégal est utilisé, la réponse est vide. L'indicateur --console n'est pas respecté.

Les options peuvent être rédigées sous deux formes : --long-option arg et --long-option=arg.

Fichiers de configuration et réponse

Vous pouvez lire certaines options de FreeCAD à partir d'un fichier de configuration. Ce fichier doit être dans le répertoire /bin et doit être nommé FreeCAD.cfg. Notez que les options spécifiées en ligne de commande remplacent le fichier de configuration !

Certains systèmes d'exploitation ne permettent qu'un nombre de caractères assez limité en ligne de commande. La façon courante de contourner cette limitation, est l'utilisation des fichiers response. Un fichier response n'est qu'un fichier de configuration, qui utilise la même syntaxe qu'en ligne de commande. Si la ligne de commande spécifie un nom de fichier response à utiliser, il est chargé, analysé et ajouté à la ligne de commande :

FreeCAD @ResponseFile.txt 

ou :

FreeCAD --response-file=ResponseFile.txt

ou :

FreeCAD --response-file ResponseFile.txt

Options cachées

Il y a des options qui sont invisibles à l'utilisateur. Ces options sont, par exemple, les paramètres X-Window analysés par le système Windows :

  • -display display, définit l'affichage X (valeur par défaut est $DISPLAY).
  • -geometry geometry, la géométrie fixe de la première fenêtre client qui est affichée.
  • -fn or -font font, définit la police de l'application. La police doit être spécifié en utilisant la description de police logique X.
  • -bg or -background color, définit la couleur de fond par défaut et une palette d'application (tons clairs et foncés sont calculés).
  • -fg or -foreground color, définit la couleur de premier plan par défaut.
  • -btn or -button color, définit la couleur des boutons par défaut.
  • -name name, définit le nom de l'application.
  • -title title, définit le titre de l'application.
  • -visual TrueColor, force l'application à utiliser un visuel TrueColor sur un affichage 8-bits.
  • -ncols count, limite le nombre de couleurs allouées dans le cube de couleur sur un écran 8-bits, si l'application utilise la spécification de couleur QApplication::ManyColor. Si le nombre est 216, un cube 6x6x6 couleurs est utilisé (soit 6 niveaux de rouge, 6 de vert, et 6 de bleu); pour d'autres valeurs un cube à peu près proportionnel à un cube 2x3x1 couleurs est utilisé.
  • -cmap, provoque l'installation d'une carte de couleurs réservée à l'application, sur un affichage 8-bits.

Executer FreeCAD sans interface graphique utilisateur

FreeCAD est généralement compilé avec deux exécutables : un exécutable compatible avec l'interface graphique, appelé FreeCAD ou freecad, et un exécutable sans tête, appelé FreeCADCmd ou freecadcmd. FreeCAD peut être utilisé en mode console en utilisant le commutateur --console (qui est le comportement par défaut de FreeCADCmd) :

FreeCAD --console

En mode console, aucune interface utilisateur graphique ne sera affichée et vous serez invité à utiliser l'interpréteur Python : >>>>. À partir de cette invite, vous disposez des mêmes fonctionnalités que l'interpréteur Python qui fonctionne dans l'interface graphique de FreeCAD, et vous avez accès à tous les modules et plugins de FreeCAD, à l'exception du module FreeCADGui. Sachez que les modules qui dépendent de FreeCADGui peuvent également être indisponibles.

Pour en savoir plus sur le mode console ou le mode sans tête, consultez FreeCAD sans GUI.

Exécution de modules, macros et scripts

Type de fichier Système Exemple en lignes de commande
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

Voir Macro at Startup pour savoir comment configurer une macro pour qu'elle s'exécute automatiquement au démarrage de FreeCAD.

Variables d'environnement

FreeCAD prend en charge les variables d'environnement suivantes, qui peuvent être utilisées pour configurer les répertoires: introduit dans la version 0.19

Variable d'environnement Nom de la variable de configuration correspondante Synopsis
FREECAD_USER_HOME UserHomePath Répertoire "de base" de FreeCAD pour conserver les données des utilisateurs locaux.
FREECAD_USER_DATA UserAppData S'il n'est pas défini, la valeur par défaut est FREECAD_USER_HOME/.FreeCAD mais uniquement si FREECAD_USER_HOME est défini.
FREECAD_USER_TEMP AppTempPath S'il n'est pas défini, la valeur par défaut est FREECAD_USER_HOME/temp mais uniquement si FREECAD_USER_HOME est défini.

Si le chemin spécifié n'existe pas, le paramètre est ignoré!

Les variables d'environnement ci-dessus sont destinées à être utilisées pour réaliser un environnement FreeCAD portable. Pour un exemple d'utilisation des variables d'environnement à partir de la ligne de commande sous Linux, reportez-vous aux notes pour les utilisateurs Linux sur la page de téléchargement.

HOME

FreeCAD utilise Qt, qui respecte la variable d'environnement HOME. Ainsi, le paramètre HOME peut être utilisé pour spécifier le répertoire de base des fichiers de configuration liés à Qt (.config/FreeCAD/FreeCAD.conf).

FreeCad lui-même ne respecte pas la variable d'environnement HOME (car cela détermine le répertoire personnel de l'utilisateur à partir d'une API système de niveau inférieur). Utilisez FREECAD_USER_HOME pour cela.

TMPDIR

Le répertoire temporaire par défaut est /tmp/. La variable d'environnement TMPDIR peut être utilisée pour remplacer la valeur par défaut. (Editeur:priorité?).

Bibliothèques

Certaines bibliothèques doivent appeler des variables d'environnement système. Parfois, lorsqu'il y a un problème avec une installation de FreeCAD, c'est parce qu'une variable d'environnement est absente ou incorrecte. Par conséquent, certaines variables importantes sont dupliquées dans la configuration et enregistrées dans le fichier de log.

Python

  • PYTHONPATH
  • PYTHONHOME
  • TCL_LIBRARY
  • TCLLIBPATH

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

Configuration

A chaque démarrage, FreeCAD examine son environnement, ainsi que les paramètres en ligne de commande. Il construit un ensemble de configuration qui détient le cœur des informations d'exécution. Ces informations sont ensuite utilisées pour déterminer l’emplacement où enregistrer les données des utilisateurs ou des fichiers journaux. Il est également très important pour les analyses post-mortem. Par conséquent, il est enregistré dans le fichier des logs.

Informations relatives à l'utilisateur

L'appel se fait de la manière suivante :

path = FreeCAD.ConfigGet("UserAppData")
Nom de la variable de configuration Synopsis Exemple Windows Exemple Linux
UserAppData Chemin où FreeCAD met les données utilisateur de l'application. C:\Documents and Settings\username\AppData\FreeCAD
Chemin court : %APPDATA%\FreeCAD
/home/username/.FreeCAD
Chemin court : ~/.FreeCAD
UserParameter Chemin où FreeCAD met les fichier utilisateur de l'application. C:\Documents and Settings\username\AppData\FreeCAD\user.cfg
Chemin court : %APPDATA%\FreeCAD\user.cfg
/home/username/.config/FreeCAD/user.cfg
Chemin court : ~/.config/FreeCAD/user.cfg or $HOME/.config/FreeCAD/user.cfg
SystemParameter Fichier où sont les données de l'application. C:\Documents and Settings\username\AppData\FreeCAD\system.cfg
Chemin court : %APPDATA%\FreeCAD\system.cfg
/home/username/.config/FreeCAD/system.cfg
Chemin court : ~/.FreeCAD/system.cfg or $HOME/.FreeCAD/system.cfg
UserHomePath Chemin racine de l'utilisateur courant. C:\Documents and Settings\username
Chemin court : %USERPROFILE%
/home/username
Chemin court : ~

Remarque: pour les distributions Linux, un fichier de configuration supplémentaire lié à Qt peut exister au chemin /home/username/.config/FreeCAD/FreeCAD.conf.

Paramètres en ligne de commande

Nom de la variable de configuration Synopsis Exemple
LoggingFile 1 si l'enregistrement est activé 1
LoggingFileName Nom du fichier ou le joural est placé C:\Documents and Settings\username\AppData\FreeCAD\FreeCAD.log
RunMode Cela indique comment la boucle principale travaillera. "Script" signifie que le script donné est appelé puis quitté. "Cmd" est destiné à l’interpréteur en ligne de commande. "Internal" exécute un script interne. "Gui" entre dans la boucle d'évènement Gui. "Module" charge un module Python donné. "Cmd"
FileName Dépend du RunMode
ScriptFileName Dépend du RunMode
Verbose Niveau de verbosité de FreeCAD "" or "strict"
OpenFileCount Donne le nombre de dossiers ouverts par les arguments en ligne de commande "12"
AdditionalModulePaths Contient les chemins des modules supplémentaires donnés dans la ligne de commande "extraModules/"

Relatif au système

Nom de la variable de configuration Synopsis Exemple Windows Exemple Linux
AppHomePath Chemin où est installé FreeCAD c:/Progam Files/FreeCAD_0.19 /user/local/FreeCAD_0.19
PythonSearchPath Donne une liste de chemins que les modules Python recherchent. S'effectue au démarrage, et peut changer en cours d'exécution
AppTempPath Chemin du répertoire temporaire.
Peut être donné avec la variable d'environnement TMPDIR ou avec l' éditeur des paramètres: Outils → Editer paramètres ... → BaseApp → Préférences → Général → TempPath
/tmp/ (par défaut)

Informations relatives à la version

Le tableau ci-dessous montre les informations générées par la version disponible. La plupart proviennent du dépôt de sous-version. Cette astuce est nécessaire pour reconstruire exactement une version !

Nom de la variable de configuration Synopsis Exemple
BuildVersionMajor Numéro de version majeure de la construction. Définie dans src/Build/Version.h.in 0
BuildVersionMinor Numéro de version mineure de la construction. Définie dans src/Build/Version.h.in 7
BuildRevision Numéro de révision du référentiel SVN du src de construction. Généré par SVN 356
BuildRevisionRange Gamme de différents changements 123-356
BuildRepositoryURL URL de référence https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
BuildRevisionDate Date de la révision ci-dessus 2007/02/03 22:21:18
BuildScrClean Indique si la source a été modifiée après la dernière construction Source modifiée
BuildScrMixed Source non mixée

Identité liée à la marque

Ces entrées de configuration sont liées au dispositif d'identification à la marque FreeCAD. Voir Branding pour plus de renseignements.

Nom de la variable de configuration Synopsis Exemple
ExeName Nom du fichier exécutable de compilation. Ce nom peut être différent de FreeCAD si un main.cpp différent est utilisé. FreeCAD.exe
ExeVersion La version présente au moment de la compilation V0.19
AppIcon L'icône qui est utilisé pour l'exécutable, affichée dans la fenêtre principale d'application "FCIcon"
ConsoleBanner Bannière du prompt en mode console
SplashPicture Nom de l'icône utilisée pour l'écran de démarrage "FreeCADSplasher"
SplashAlignment Alignement du texte dans la boîte de dialogue Splash "Bottom" ou "Left"
SplashTextColor Couleur du texte splashé "#000000"
StartWorkbench Nom de l'atelier lancé automatiquement après le démarrage "PartDesign"
HiddenDockWindow Liste des dockwindows (séparés par un point-virgule) qui seront désactivés "Property editor"

Interrogation de la configuration

Depuis la console Python de FreeCAD

Les entrées de la configuration peuvent être interrogées avec le nom de la variable de configuration (voir les tableaux ci-dessus) depuis la console Python. Par exemple :

 >>> FreeCAD.ConfigGet("ExeVersion")
 '0.19'

Si le nom n'est pas trouvé, une chaîne vide est renvoyée.

En ligne de commande

Utilisez l'option --get-config <config-var-name> pour interroger un seul nom. Tous les noms ne sont pas pris en charge. Par exemple :

 FreeCAD --get-config ExeVersion

Utilisez l'option --dump-config pour obtenir une liste de noms et leurs valeurs. Tous les noms ne sont pas pris en charge.

Depuis la console FreeCAD

Démarrez FreeCAD en mode console avec --console et interrogez avec du code Python. Par exemple :

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

Pour Linux (shell bash), vous pouvez modifier la ligne de commande suivante en fonction de vos besoins :

 $ 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

Démarrage de FreeCAD à partir du bureau

Linux : création d'une option de démarrage supplémentaire

Ce qui suit suppose que votre bureau est configuré de telle sorte que vous puissiez lancer FreeCAD à partir de celui-ci. En fonction de votre distribution Linux et de votre environnement de bureau, vous devrez peut-être adapter les étapes suivantes :

  1. Copiez le fichier d'entrée freedesktop pour FreeCAD de /usr/share/applications/freecad.desktop vers ~/.local/share/applications.
  2. Changez le nom de freecad.desktop en autre chose (par exemple MyFreeCADConfig.desktop).
  3. Ouvrez le fichier avec un éditeur de texte et changez la façon dont FreeCAD est appelé en modifiant la ligne commençant par Exec.
  4. Pour résultat, une entrée supplémentaire dans votre menu Démarrer/lanceur d'application est disponible. De cette façon, vous pouvez avoir plusieurs entrées FreeCAD avec différentes options de lancement.

Démarrage de FreeCAD à partir d'un medium USB

Windows

Placez l'exécutable FreeCAD, FreeCAD.exe, sur le support USB. Créez un fichier batch, FreeCAD.bat et placez-le dans le même répertoire que FreeCAD.exe. Dans le fichier batch, écrivez :

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

Avec le batch dans la racine du support USB :

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

Maintenant, double-cliquez sur le fichier de commandes pour démarrer FreeCAD. (voir ce fil)