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)

"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 utilisateur
Normalement, FreeCAD démarre en mode graphique (GUI), mais vous pouvez aussi le forcer à démarrer en mode console en tapant : 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.

Exécuter FreeCAD comme un module Python
FreeCAD peut également être utilisé et exécuté en tant que module Python à l'intérieur d'autres applications, qui utilisent Python, ou, à partir d'un shell Python externe. Pour cela, l'application hôte Python doit savoir où résident vos libs FreeCAD. La meilleure façon de l'obtenir, c'est d'annexer temporairement le chemin des libs de FreeCAD à la variable sys.path. Le code suivant tapé à partir de n'importe quel shell Python va importer FreeCAD, et vous permettre de l'exécuter de la même manière que dans le mode console :

Une fois que FreeCAD est chargé, c'est à vous de le faire interagir avec votre application hôte de toutes les manières que vous pouvez imaginer !

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.