Start up and Configuration/fr

Cette page montre, les différentes façons de lancer FreeCAD, et, ses configurations les plus importantes.

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.

Les 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

Les réponses disponibles, sont dans les paramètres :

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" 

"Response" fichiers de configurations

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

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 X logical font description.
• -bg or -background color, définit la couleur de fond par défaut et une palette d'applications (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, puis 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 privées à l'application, sur un affichage 8-bits.

Démarrer FreeCAD sans interface graphique utilisateur

FreeCAD est généralement construit avec deux exécutables: un compatible avec une interface graphique appelée FreeCAD, et une en ligne de commande uniquement FreeCADCmd. FreeCAD peut être utilisé en mode console en utilisant le commutateur "-c", c'est le comportement par défaut de FreeCADCmd:

FreeCAD -c

En ligne de commande. En mode console, aucune interface utilisateur, ne sera affichée, et l'invite vous sera présenté avec un interpréteur Python.

A partir de ce prompt Python, vous avez les mêmes fonctionnalités que l'interpréteur Python qui fonctionne au sein de l'interface graphique de FreeCAD, et, un accès normal à tous les modules et plugins de FreeCAD, à l'exception du module FreeCADGui. Notez que les modules qui dépendent de FreeCADGui peuvent également être inaccessibles.

Les macros Python de FreeCAD peuvent être spécifiés comme arguments de ligne de commande pour l'un des exécutables mentionnés ci-dessus.

Ensemble de configuration

A chaque démarrage, FreeCAD examine ses environs, ainsi que les paramètres en ligne de commande. Il construit un ensemble de configurations qui détiennent 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 après analyse post-mortem. Par conséquent, il est enregistré dans le fichier journal (log file).

Informations correspondantes à l'utilisateur

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

path = FreeCAD.ConfigGet("UserAppData")

User config entries

Config nom var	Synopsis	Exemple M$	Exemple Posix (Linux)
UserAppData	Chemin où FreeCAD met les données utilisateur de l'application.	C:\Documents and Settings\username\Application Data\FreeCAD	/home/username/.FreeCAD
UserParameter	Chemin où FreeCAD met les fichier utilisateur de l'application.	C:\Documents and Settings\username\Application Data\FreeCAD\user.cfg	/home/username/.FreeCAD/user.cfg
SystemParameter	Fichier où sont les données de l'application.	C:\Documents and Settings\username\Application Data\FreeCAD\system.cfg	/home/username/.FreeCAD/system.cfg
UserHomePath	Chemin racine de l'utilisateur courant.	C:\Documents and Settings\username\My Documents	/home/username

Arguments en ligne de commande

User config entries

Config nom var	Synopsis	Exemple
LoggingFile	1 si l'enregistrement est activé	1
LoggingFileName	Nom où est placé le fichier journal	C:\Documents and Settings\username\Application Data\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 commentaire 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/"

Systèmes liés

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

path = FreeCAD.ConfigGet("AppHomePath")

User config entries

Config var name	Synopsis	Exemple M$	Exemple Posix (Linux)
AppHomePath	Chemin où est installé FreeCAD	c:/Progam Files/FreeCAD_0.7	/user/local/FreeCAD_0.7
PythonSearchPath	Donne une liste de chemins que les modules Python recherchent. S'effectue au démarrage, et peut changer en cours d'exécution

Certaines bibliothèques, ont besoin d'appeler les variables d'environnement système. Parfois, il y a des problèmes avec une installation de FreeCAD, c'est parce que certaines variables d'environnements sont absentes ou mal réglées. Par conséquent, certaines variables importantes se reproduisent dans la configuration et enregistrées dans le fichier journal (log file).

Variables d’environnement relatifs à Python :

• PYTHONPATH
• PYTHONHOME
• TCL_LIBRARY
• TCLLIBPATH

Variables d’environnement relatifs à 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 d’environnement relatifs au Système :

• PATH

Construire des informations connexes

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

User config entries

Config var name	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	Nombre SVN révision du référentiel du src dans la construction. Généré par SVN	356
BuildRevisionRange	Gamme de différents changements	123-356
BuildRepositoryURL	Repository URL	https://free-cad.svn.sourceforge.net/svnroot/free-cad/trunk/src
BuildRevisionDate	Date de la révision susmentionnée ci-dessus	2007/02/03 22:21:18
BuildScrClean	Indique si la source a été modifiée après la dernière construction	Src modifié
BuildScrMixed		Src non mixé

Image de marque liée

Ces entrées de configuration sont liées au mécanisme de l'image de marque de FreeCAD. Voir Branding pour plus de renseignements.

User config entries

Config nom var	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.7
AppIcon	L'icône qui est utilisé pour l'exécutable, affichée dans application MainWindow	"FCIcon"
ConsoleBanner	Bannière qui est invité 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 splasher	"#000000"
StartWorkbench	Nom du Workbech qui commence automatiquement après le démarrage	"Part design"
HiddenDockWindow	Liste des dockwindows (séparés par un point-virgule) qui seront désactivés	"Property editor"