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.

Using command line options without a command line shell

 * On Ubuntu you can create a desktop icon and edit its properties. Add the command line options separated by spaces behind the program name in the "Command" field.
 * On Windows create a shortcut and edit the properties. Add the command line options separated by spaces to "Target" field.

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)

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

ou :

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

Systèmes liés
L'appel se fait de la manière suivants : path = FreeCAD.ConfigGet("AppHomePath")

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 : Variables d’environnement relatifs à OpenCascade : Variables d’environnement relatifs au Système :
 * PYTHONPATH
 * PYTHONHOME
 * TCL_LIBRARY
 * TCLLIBPATH
 * CSF_MDTVFontDirectory
 * CSF_MDTVTexturesDirectory
 * CSF_UnitsDefinition
 * CSF_UnitsLexicon
 * CSF_StandardDefaults
 * CSF_PluginDefaults
 * CSF_LANGUAGE
 * CSF_SHMessage
 * CSF_XCAFDefaults
 * CSF_GraphicShr
 * CSF_IGESDefaults
 * CSF_STEPDefaults
 * 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 !

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.