Démarrage et configuration

From FreeCAD Documentation
Revision as of 17:50, 12 August 2012 by Mario52 (talk | contribs) (création et traduction de la page)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

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 ]      Version du programme
 -h [ --help ]         Affiche la fenêtre avec les options disponibles
 -c [ --console ]      Démarre en mode console

Configuration:
 -l [ --write-log ] arg    Ecrit un log file
 -t [ --run-test ] arg     test niveau
 -M [ --module-path ] arg  modules paths (chemins) additionnels
 -P [ --python-path ] arg  modules python paths (chemins) additionnels
 --response-file arg       peut être spécifié avec '@ name', ......

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

import sys sys.path.append("path/to/FreeCAD/lib") # change this by your own FreeCAD lib path import FreeCAD

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 correspondants à l'utilisateur

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 de la 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ème lié

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 changements différentes 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 Indicates if the source was changed ager checkout Src modified
BuildScrMixed Src not mixed

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 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"
Third Party Tools/fr
FreeCAD Build Tool/fr
Traductions disponibles de cette page : Template:Se