Branding/ro: Difference between revisions

From FreeCAD Documentation
No edit summary
(Updating to match new version of source page)
 
(18 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav
|[[Continuous_Integration|Continuous Integration]]
|[[Localisation|Localisation]]
}}

{{TOCright}}

==Overview==

<div class="mw-translate-fuzzy">
Acest articol descrie '''Branding''' al FreeCAD. Branding înseamnă să începeți propria aplicație pe baza FreeCAD. Acesta poate fi doar propriul dvs. executabil sau [[Splash screen | splash screen]] până la un program complet reconfigurat. Pe baza arhitecturii flexibile a FreeCAD, este ușor de utilizat ca bază pentru propriul program special.
Acest articol descrie '''Branding''' al FreeCAD. Branding înseamnă să începeți propria aplicație pe baza FreeCAD. Acesta poate fi doar propriul dvs. executabil sau [[Splash screen | splash screen]] până la un program complet reconfigurat. Pe baza arhitecturii flexibile a FreeCAD, este ușor de utilizat ca bază pentru propriul program special.
</div>


== Warning ==

Although FreeCAD is offered to you free of charge, and the FreeCAD community is happy to see other applications emerging, that are based on FreeCAD, we have on the other hand seen a lot of unfair use of the information contained on this page by people who simply rebranded FreeCAD into a closed-source application to make profit from it.

Although the [[License|LGPL license]] allows to use the FreeCAD source code in closed-source applications, it also gives strict rules to do so, and does not allow simply taking FreeCAD, renaming it and stripping it of its license.

Would you be interested in using FreeCAD in a closed-source application, be sure to check thoroughly the implications of the LGPL license, and, even better, contact any FreeCAD developer, administrator or moderator before doing so.

== General ==

<div class="mw-translate-fuzzy">
=== General ===
=== General ===
Majoritatea branding-ului se face în ''' MainCmd.cpp''' sau ''' MainGui.cpp '''. Aceste proiecte generează fișierele executabile ale FreeCAD. Pentru a crea propriul dvs. brand doar copiați proiectele Main sau MainGui și dați executabilului un nume propriu, de ex. FooApp.exe.
Majoritatea branding-ului se face în ''' MainCmd.cpp''' sau ''' MainGui.cpp '''. Aceste proiecte generează fișierele executabile ale FreeCAD. Pentru a crea propriul dvs. brand doar copiați proiectele Main sau MainGui și dați executabilului un nume propriu, de ex. FooApp.exe.
Cele mai importante setări pentru un aspect nou pot fi făcute într-un singur loc în funcția principal (). Iată secțiunea de cod care controlează branding-ul:
Cele mai importante setări pentru un aspect nou pot fi făcute într-un singur loc în funcția principal (). Iată secțiunea de cod care controlează branding-ul:
</div>


<!-- WARNING Do not modify the <syntaxhighligh> tag because of "{}" or pipe characters "|" included in the source code of the macro -->
<syntaxhighlight>
<syntaxhighlight lang="C">
int main( int argc, char ** argv )
int main( int argc, char ** argv )
{
{
// Name and Version of the Application
// Name and Version of the Application
App::Application::Config()["ExeName"] = "FooApp";
App::Application::Config()["ExeVersion"] = "0.7";
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;
}
</syntaxhighlight>
The first Config entry defines the program name. This is not the executable name, which can be changed by renaming or by compiler settings, but the name that is displayed in the task bar on windows or in the program list on Unix systems.


// set the banner (for loging and console)
The next lines define the Config entries of your FooApp Application. A description of the Config and its entries you find in [[Start up and Configuration]].
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
=== Images ===
App::Application::Config()["RunMode"] = "Gui";
Image resources are compiled into FreeCAD using [http://qt-project.org/doc/qt-4.8/resources.html Qt's resource system]. 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
App::Application::init(argc,argv);
<syntaxhighlight>

Q_INIT_RESOURCE(FooApp);
Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);
</syntaxhighlight>

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:
Gui::Application::initApplication();
<syntaxhighlight>
Gui::Application::runApplication();
Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);
App::Application::destruct();

return 0;
}
</syntaxhighlight>
</syntaxhighlight>

Prima intrare Config defineste numele programului. Acesta nu este numele executabilului, care poate fi modificat prin redenumire sau prin setările compilatorului, dar numele care este afișat în bara de activități din ferestrele sau în lista de programe din sistemele Unix.

Următoarele linii definesc intrările Config ale aplicației dvs. FooApp. O descriere a Config și a intrărilor pe care le găsiți în [[Start up and Configuration]].

== Images ==

<div class="mw-translate-fuzzy">
=== Imagini ===
Resursele de imagine sunt compilate în FreeCAD folosind [http://qt-project.org/doc/qt-4.8/resources.html Qt's resource system]. Prin urmare, trebuie să scrieți un fișier .qrc, un format de fișier bazat pe XML care afișează fișierele imagine pe disc, dar și orice alt tip de fișiere de resurse. Pentru a încărca resursele compilate din cadrul aplicației, trebuie să adăugați o linie
</div>

{{Code|code=
Q_INIT_RESOURCE(FooApp);
}}

<div class="mw-translate-fuzzy">
în funcția principal (). Alternativ, dacă aveți o imagine în format XPM, puteți să o includeți direct în main.cpp și să adăugați următoarea linie pentru a o înregistra:
</div>

{{Code|code=
Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);
}}

== Branding XML ==

<div class="mw-translate-fuzzy">
=== Branding XML ===
=== Branding XML ===
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:
În FreeCAD există și o metodă acceptată fără scrierea unei funcții principale personalizate (). Pentru această metodă trebuie scrieți un nume de fișier numit branding.xml și să-l puneți în directorul de instalare al FreeCAD. Iată un exemplu cu toate etichetele acceptate:
</div>
<syntaxhighlight>

<?xml version="1.0" encoding="utf-8"?>
<!-- WARNING Do not modify the <syntaxhighligh> tag because of "{}" or pipe characters "|" included in the source code of the macro -->
<Branding>
<syntaxhighlight lang="XML">
<Application>FooApp</Application>
<?xml version="1.0" encoding="utf-8"?>
<WindowTitle>Foo App in title bar</WindowTitle>
<Branding>
<BuildVersionMajor>1</BuildVersionMajor>
<Application>FooApp</Application>
<BuildVersionMinor>0</BuildVersionMinor>
<WindowTitle>Foo App in title bar</WindowTitle>
<BuildRevision>1234</BuildRevision>
<BuildVersionMajor>1</BuildVersionMajor>
<BuildRevisionDate>2014/1/1</BuildRevisionDate>
<BuildVersionMinor>0</BuildVersionMinor>
<CopyrightInfo>(c) My copyright</CopyrightInfo>
<BuildRevision>1234</BuildRevision>
<MaintainerUrl>Foo App URL</MaintainerUrl>
<BuildRevisionDate>2014/1/1</BuildRevisionDate>
<ProgramLogo>Path to logo (appears in bottom right corner)</ProgramLogo>
<CopyrightInfo>(c) My copyright</CopyrightInfo>
<WindowIcon>Path to icon file</WindowIcon>
<MaintainerUrl>Foo App URL</MaintainerUrl>
<ProgramIcons>Path to program icons</ProgramIcons>
<ProgramLogo>Path to logo (appears in bottom right corner)</ProgramLogo>
<SplashScreen>splashscreen.png</SplashScreen>
<WindowIcon>Path to icon file</WindowIcon>
<SplashAlignment>Bottom|Left</SplashAlignment>
<ProgramIcons>Path to program icons</ProgramIcons>
<SplashTextColor>#ffffff</SplashTextColor>
<SplashScreen>splashscreen.png</SplashScreen>
<SplashInfoColor>#c8c8c8</SplashInfoColor>
<SplashAlignment>Bottom|Left</SplashAlignment>
<StartWorkbench>PartDesignWorkbench</StartWorkbench>
<SplashTextColor>#ffffff</SplashTextColor>
</Branding>
<SplashInfoColor>#c8c8c8</SplashInfoColor>
<StartWorkbench>PartDesignWorkbench</StartWorkbench>
</Branding>
</syntaxhighlight>
</syntaxhighlight>
All of the listed tags are optional.


<div class="mw-translate-fuzzy">
Toate etichetele enumerate sunt opționale.
</div>


<div class="mw-translate-fuzzy">
{{docnav|Continuous Integration|Localisation}}
{{docnav|Continuous Integration|Localisation}}
</div>


{{Userdocnavi{{#translation:}}}}
[[Category:Developer Documentation/ro]]
[[Category:Developer Documentation{{#translation:}}]]
{{clear}}

Latest revision as of 09:46, 12 January 2022

Overview

Acest articol descrie Branding al FreeCAD. Branding înseamnă să începeți propria aplicație pe baza FreeCAD. Acesta poate fi doar propriul dvs. executabil sau splash screen până la un program complet reconfigurat. Pe baza arhitecturii flexibile a FreeCAD, este ușor de utilizat ca bază pentru propriul program special.

Warning

Although FreeCAD is offered to you free of charge, and the FreeCAD community is happy to see other applications emerging, that are based on FreeCAD, we have on the other hand seen a lot of unfair use of the information contained on this page by people who simply rebranded FreeCAD into a closed-source application to make profit from it.

Although the LGPL license allows to use the FreeCAD source code in closed-source applications, it also gives strict rules to do so, and does not allow simply taking FreeCAD, renaming it and stripping it of its license.

Would you be interested in using FreeCAD in a closed-source application, be sure to check thoroughly the implications of the LGPL license, and, even better, contact any FreeCAD developer, administrator or moderator before doing so.

General

General

Majoritatea branding-ului se face în MainCmd.cpp sau MainGui.cpp . Aceste proiecte generează fișierele executabile ale FreeCAD. Pentru a crea propriul dvs. brand doar copiați proiectele Main sau MainGui și dați executabilului un nume propriu, de ex. FooApp.exe. Cele mai importante setări pentru un aspect nou pot fi făcute într-un singur loc în funcția principal (). Iată secțiunea de cod care controlează branding-ul:

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

Prima intrare Config defineste numele programului. Acesta nu este numele executabilului, care poate fi modificat prin redenumire sau prin setările compilatorului, dar numele care este afișat în bara de activități din ferestrele sau în lista de programe din sistemele Unix.

Următoarele linii definesc intrările Config ale aplicației dvs. FooApp. O descriere a Config și a intrărilor pe care le găsiți în Start up and Configuration.

Images

Imagini

Resursele de imagine sunt compilate în FreeCAD folosind Qt's resource system. Prin urmare, trebuie să scrieți un fișier .qrc, un format de fișier bazat pe XML care afișează fișierele imagine pe disc, dar și orice alt tip de fișiere de resurse. Pentru a încărca resursele compilate din cadrul aplicației, trebuie să adăugați o linie

Q_INIT_RESOURCE(FooApp);

în funcția principal (). Alternativ, dacă aveți o imagine în format XPM, puteți să o includeți direct în main.cpp și să adăugați următoarea linie pentru a o înregistra:

Gui::BitmapFactory().addXPM("FooAppSplasher", ( const char** ) splash_screen);

Branding XML

Branding XML

În FreeCAD există și o metodă acceptată fără scrierea unei funcții principale personalizate (). Pentru această metodă trebuie să scrieți un nume de fișier numit branding.xml și să-l puneți în directorul de instalare al FreeCAD. Iată un exemplu cu toate etichetele acceptate:

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

Toate etichetele enumerate sunt opționale.


Continuous Integration
Localisation