90 lines
5.9 KiB
HTML
90 lines
5.9 KiB
HTML
<html><head><title>Branding/fr</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Branding/fr</h1></div>
|
|
|
|
<div id="mw-content-text" lang="fr" dir="ltr" class="mw-content-ltr"><hr/><div class="mw-parser-output"><p>Cet article décrit l'<b>image de marque de FreeCAD</b>. <b>Branding</b>, est le moyen de lancer votre propre application, sur les bases de <b>FreeCAD</b>.
|
|
</p><p>Cela ne concerne que votre propre exécutable, ou, votre écran de démarrage (splash screen) ou jusqu'à ce que le programme complet soit retravaillé (refonte totale).
|
|
</p><p>Grâce aux bases très souples de l'architecture de FreeCAD, il est très facile de l'utiliser, comme fondation pour votre programme personnalisé, ou pour une utilisation spécifique.
|
|
</p>
|
|
<h3><span class="mw-headline" id="Generalit.C3.A9s">Generalités</span></h3>
|
|
<p>La plupart des marques (branding) se font dans <b>MainCmd.cpp</b>, ou, <b>MainGui.cpp</b>. Ces projets génèrent les fichiers exécutables de <b>FreeCAD</b>.
|
|
</p><p>Pour faire votre propre marque (branding), il suffit de copier <b>Main</b> (les projets principaux) ou <b>MainGui</b> (les projets graphiques GUI), et donner à l'exécutable un nom qui vous est propre, pour notre exemple, <b>FooApp.exe</b>.
|
|
Les paramètres les plus importants pour un nouveau look, ne peuvent être fait qu'en un seul endroit, dans la <b>fonction main()</b>.
|
|
</p><p>Voici la section de code qui contrôle la marque (branding) :
|
|
</p>
|
|
<div class="mw-highlight mw-content-ltr" dir="ltr"><pre> int main( int argc, char ** argv )
|
|
{
|
|
// Name and Version of the Application
|
|
App::Application::Config()["ExeName"] = "FooApp";
|
|
App::Application::Config()["ExeVersion"] = "0.7";
|
|
|
|
// set the banner (for loging and console)
|
|
App::Application::Config()["CopyrightInfo"] = sBanner;
|
|
App::Application::Config()["AppIcon"] = "FooAppIcon";
|
|
App::Application::Config()["SplashScreen"] = "FooAppSplasher";
|
|
App::Application::Config()["StartWorkbench"] = "Part design";
|
|
App::Application::Config()["HiddenDockWindow"] = "Property editor";
|
|
App::Application::Config()["SplashAlignment" ] = "Bottom|Left";
|
|
App::Application::Config()["SplashTextColor" ] = "#000000"; // black
|
|
|
|
// Inits the Application
|
|
App::Application::Config()["RunMode"] = "Gui";
|
|
App::Application::init(argc,argv);
|
|
|
|
Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);
|
|
|
|
Gui::Application::initApplication();
|
|
Gui::Application::runApplication();
|
|
App::Application::destruct();
|
|
|
|
return 0;
|
|
}</pre></div>
|
|
<p>La première entrée, <b>::Config</b> définit le nom du programme ici, <b>"FooApp.exe"</b>. Ce n'est pas le nom de l'exécutable qui peut être modifié en le renommant, ou par les paramètres du compilateur, mais le nom qui est affiché dans la barre des tâches sur les fenêtres, ou dans la liste des programmes sur les systèmes Unix.
|
|
</p><p>Les lignes suivantes définissent les entrées de configuration de votre application <b>"FooApp"</b>, une description de la configuration, et de ses entrées, que vous trouverez dans <b><a href="https://www.freecadweb.org/wiki/index.php?title=Start_up_and_Configuration/fr" title="Start up and Configuration/fr">Start up and Configuration</a></b>.
|
|
</p>
|
|
<h3><span class="mw-headline" id="Images">Images</span></h3>
|
|
<p>Image resources are compiled into FreeCAD using <a rel="nofollow" class="external text" href="http://qt-project.org/doc/qt-4.8/resources.html">Qt's resource system</a>. Therefore you have to write a .qrc file, an XML-based file format that lists image files on the disk but also any other kind of resource files. To load the compiled resources inside the application you have to add a line
|
|
</p>
|
|
<div class="mw-highlight mw-content-ltr" dir="ltr"><pre> Q_INIT_RESOURCE(FooApp);</pre></div>
|
|
<p>into the main() function. Alternatively, if you have an image in XPM format you can directly include it into your main.cpp and add the following line to register it:
|
|
</p>
|
|
<div class="mw-highlight mw-content-ltr" dir="ltr"><pre> Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);</pre></div>
|
|
<h3><span class="mw-headline" id="Branding_XML">Branding XML</span></h3>
|
|
<p>In FreeCAD there is also a method supported without writing a customized main() function. For this method you must write a file name called branding.xml and put it into the installation directory of FreeCAD. Here is an example with all supported tags:
|
|
</p>
|
|
<div class="mw-highlight mw-content-ltr" dir="ltr"><pre> <?xml version="1.0" encoding="utf-8"?>
|
|
<Branding>
|
|
<Application>FooApp</Application>
|
|
<WindowTitle>Foo App in title bar</WindowTitle>
|
|
<BuildVersionMajor>1</BuildVersionMajor>
|
|
<BuildVersionMinor>0</BuildVersionMinor>
|
|
<BuildRevision>1234</BuildRevision>
|
|
<BuildRevisionDate>2014/1/1</BuildRevisionDate>
|
|
<CopyrightInfo>(c) My copyright</CopyrightInfo>
|
|
<MaintainerUrl>Foo App URL</MaintainerUrl>
|
|
<ProgramLogo>Path to logo (appears in bottom right corner)</ProgramLogo>
|
|
<WindowIcon>Path to icon file</WindowIcon>
|
|
<ProgramIcons>Path to program icons</ProgramIcons>
|
|
<SplashScreen>splashscreen.png</SplashScreen>
|
|
<SplashAlignment>Bottom|Left</SplashAlignment>
|
|
<SplashTextColor>#ffffff</SplashTextColor>
|
|
<SplashInfoColor>#c8c8c8</SplashInfoColor>
|
|
<StartWorkbench>PartDesignWorkbench</StartWorkbench>
|
|
</Branding></pre></div>
|
|
<p>All of the listed tags are optional.
|
|
</p>
|
|
|
|
<div style="clear:both"></div>
|
|
</div>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div><div class="printfooter">
|
|
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Branding/fr&oldid=114351">http://www.freecadweb.org/wiki/index.php?title=Branding/fr&oldid=114351</a>"</div>
|
|
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
<div id="mw-navigation">
|
|
<h2>Navigation menu</h2>
|
|
|
|
</body></html> |