Branding/it: Difference between revisions

From FreeCAD Documentation
mNo edit summary
mNo edit summary
Line 3: Line 3:
Questo articolo descrive la personalizzazione o '''Marchiatura''' di FreeCAD.
Questo articolo descrive la personalizzazione o '''Marchiatura''' di FreeCAD.


Marchiare (Branding) significa avviare la realizzazione di una propria applicazione basata su FreeCAD. La personalizzazione può riguardare solo il proprio eseguibile o la [[Splash screen/it|schermata iniziale]] fino alla rielaborazione completa del programma.
Marchiare (Branding) significa avviare la realizzazione di una propria applicazione basata su FreeCAD. La personalizzazione può riguardare solo il proprio eseguibile oppure andare dalla [[Splash screen/it|schermata iniziale]] fino alla rielaborazione completa del programma.


L'architettura flessibile di FreeCAD è facile da usare come base per realizzare propri programmi per impieghi particolari.
L'architettura flessibile di FreeCAD è facile da usare come base per realizzare dei programmi personali per impieghi particolari.


___TOC___
___TOC___
Line 11: Line 11:
==== Generale ====
==== Generale ====


La maggior parte della marchiatura avviene in '''MainCmd.cpp''' oppure in '''MainGui.cpp'''. Questi Progetti generano i file eseguibili di FreeCAD. Per costruire il proprio marchio è sufficiente copiare i progetti Main o MainGui e dare all'eseguibile un proprio (diverso) nome, ad esempio, FooApp.exe.
La maggior parte della marchiatura avviene in '''MainCmd.cpp''' oppure in '''MainGui.cpp'''. Questi Progetti generano i file eseguibili di FreeCAD. Per costruire il proprio marchio è sufficiente copiare i progetti Main o MainGui e dare all'eseguibile un nome diverso, ad esempio, FooApp.exe.


Le impostazioni più importanti per dare un nuovo aspetto possono essere fatte all'interno della funzione main().
Le impostazioni più importanti per dare all'applicazione un nuovo aspetto possono essere fatte all'interno della funzione main().


Ecco la sezione di codice che controlla la marchiatura:
Ecco la sezione di codice che controlla la marchiatura:
Line 47: Line 47:
</code>
</code>


La prima voce Config definisce il nome del programma. Questo nome non è il nome del file eseguibile, il quale può essere modificato rinominandolo o tramite le impostazioni del compilatore, ma il nome che viene visualizzato nella barra delle applicazioni su Windows o nell'elenco dei programmi sui sistemi Unix.
La prima voce Config definisce il nome del programma. Questo nome non è il nome del file eseguibile, il quale può essere modificato rinominandolo o tramite le impostazioni del compilatore, ma è il nome che viene visualizzato nella barra delle applicazioni su Windows o nell'elenco dei programmi sui sistemi Unix.


Le righe successive definiscono le voci di configurazione della vostra applicazione FooApp. Una descrizione del Config e delle sue voci si trova in [[Start up and Configuration/it|Avvio e Configurazione]].
Le righe successive definiscono le voci di configurazione della vostra applicazione FooApp. Una descrizione di Config e delle sue voci si trova in [[Start up and Configuration/it|Avvio e Configurazione]].


==== Immagini ====
==== Immagini ====


In FreeCAD tutte le risorse di immagine vengono compilate. Questo riduce il tempo di caricamento e mantiene l'installazione compatta.
In FreeCAD tutte le risorse immagine vengono compilate. Questo riduce il tempo di caricamento e mantiene l'installazione compatta.


Le immagini sono incluse nel formato XPM il quale è fondamentalmente un formato di testo che utilizza la sintassi C.
Le immagini sono incluse nel formato XPM il quale è fondamentalmente un formato di testo che utilizza la sintassi C.


Praticamente si può disegnare queste immagini con un editor di testo, ma è più comodo creare le immagini con il proprio programma di grafica preferito e convertirle successivamente in formato XPM.
Praticamente è possibile disegnare queste immagini con un editor di testo, ma è più comodo creare le immagini con il proprio programma di grafica preferito e convertirle successivamente in formato XPM.


Il programma di immagini di GNU [http://gimp.org/ Gimp] può salvare in file XPM.
Il programma di immagini di GNU [http://gimp.org/ Gimp] può salvare in file XPM.


Per la conversione si può utilizzare lo strumento ''[[ImageConv/it|ImageConv]]'' che è incluso in FreeCAD. Potete trovarlo in:
Per la conversione si può utilizzare lo strumento ''[[ImageConv/it|ImageConv/it]]'' che è incluso in FreeCAD. Lo trovate in:


/trunk/src/Tools/ImageTools/ImageConv
/trunk/src/Tools/ImageTools/ImageConv


Non solo può convertire le immagini, ma può anche aggiornare automaticamente il file ''BmpFactoryIcons.cpp'', dove sono registrate le immagini. Così come si vede nel seguente esempio il suo utilizzo tipico è molto semplice:
Oltre a convertire le immagini, ImageConv può anche aggiornare automaticamente il file ''BmpFactoryIcons.cpp'', dove sono registrate le immagini. Così come si vede nel seguente esempio il suo utilizzo tipico è molto semplice:


ImageConv -i InputImage.png -o OutputImage.xpm
ImageConv -i InputImage.png -o OutputImage.xpm
Line 87: Line 87:
<nowiki>static const char *FCIcon[]={</nowiki>
<nowiki>static const char *FCIcon[]={</nowiki>


Sostituirla con la propria icona preferita, ricompilare FreeCAD e il successivo passo per creare la propria applicazione marchiata è fatto.
Sostituitela con la propria icona preferita, ricompilate FreeCAD e il successivo passo per creare la propria applicazione marchiata è fatto.


Ci sono molte altre icone in questo file che si possono cambiare a proprio gusto.
In questo file ci sono molte altre icone che si possono cambiare a proprio gusto.


Se è necessario aggiungere nuove icone, bisogna registrarle in:
Se è necessario aggiungere nuove icone, bisogna registrarle in:
Line 99: Line 99:
===== Immagine di sfondo =====
===== Immagine di sfondo =====


L'immagine di sfondo appare, quando non è aperta nessuna finestra di documento. Come la [[Splash screen/it|schermata iniziale]], essa è definita in ''developers.h'' nella sezione che inizia con:
L'immagine di sfondo appare quando non è aperta nessuna finestra di documento. Come la [[Splash screen/it|schermata iniziale]], essa è definita in ''developers.h'' nella sezione che inizia con:


static const char* const background[]={
static const char* const background[]={

Revision as of 19:47, 14 October 2014

Marchiatura - Personalizzazione

Questo articolo descrive la personalizzazione o Marchiatura di FreeCAD.

Marchiare (Branding) significa avviare la realizzazione di una propria applicazione basata su FreeCAD. La personalizzazione può riguardare solo il proprio eseguibile oppure andare dalla schermata iniziale fino alla rielaborazione completa del programma.

L'architettura flessibile di FreeCAD è facile da usare come base per realizzare dei programmi personali per impieghi particolari.

_

_

Generale

La maggior parte della marchiatura avviene in MainCmd.cpp oppure in MainGui.cpp. Questi Progetti generano i file eseguibili di FreeCAD. Per costruire il proprio marchio è sufficiente copiare i progetti Main o MainGui e dare all'eseguibile un nome diverso, ad esempio, FooApp.exe.

Le impostazioni più importanti per dare all'applicazione un nuovo aspetto possono essere fatte all'interno della funzione main().

Ecco la sezione di codice che controlla la marchiatura:

int main( int argc, char ** argv )
{
  // Name and Version of the Application
  App::Application::Config()["ExeName"] = "FooApp.exe";
  App::Application::Config()["ExeVersion"] = "0.7";

  // set the banner (for loging and console)
  App::Application::Config()["ConsoleBanner"] = sBanner;
  App::Application::Config()["AppIcon"] = "FCIcon";
  App::Application::Config()["SplashPicture"] = "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;
}

La prima voce Config definisce il nome del programma. Questo nome non è il nome del file eseguibile, il quale può essere modificato rinominandolo o tramite le impostazioni del compilatore, ma è il nome che viene visualizzato nella barra delle applicazioni su Windows o nell'elenco dei programmi sui sistemi Unix.

Le righe successive definiscono le voci di configurazione della vostra applicazione FooApp. Una descrizione di Config e delle sue voci si trova in Avvio e Configurazione.

Immagini

In FreeCAD tutte le risorse immagine vengono compilate. Questo riduce il tempo di caricamento e mantiene l'installazione compatta.

Le immagini sono incluse nel formato XPM il quale è fondamentalmente un formato di testo che utilizza la sintassi C.

Praticamente è possibile disegnare queste immagini con un editor di testo, ma è più comodo creare le immagini con il proprio programma di grafica preferito e convertirle successivamente in formato XPM.

Il programma di immagini di GNU Gimp può salvare in file XPM.

Per la conversione si può utilizzare lo strumento ImageConv/it che è incluso in FreeCAD. Lo trovate in:

/trunk/src/Tools/ImageTools/ImageConv

Oltre a convertire le immagini, ImageConv può anche aggiornare automaticamente il file BmpFactoryIcons.cpp, dove sono registrate le immagini. Così come si vede nel seguente esempio il suo utilizzo tipico è molto semplice:

ImageConv -i InputImage.png -o OutputImage.xpm

Questo comando converte il file InputImage.png in formato XPM e scrive il risultato in un file OutputImage.xpm.

La riga:

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

include quindi nella funzione main() l'immagine nel BitmapFactory di FreeCAD.

Icone

L'icona principale dell'applicazione FCIcon che appare nei titoli delle finestre e in altri luoghi è definita in:

/trunk/src/Gui/Icons/images.cpp

e inizia con la riga

static const char *FCIcon[]={

Sostituitela con la propria icona preferita, ricompilate FreeCAD e il successivo passo per creare la propria applicazione marchiata è fatto.

In questo file ci sono molte altre icone che si possono cambiare a proprio gusto.

Se è necessario aggiungere nuove icone, bisogna registrarle in:

/trunk/src/Gui/Icons/BmpFactoryIcons.cpp

in modo da poter accedere ad esse da FreeCAD.

Immagine di sfondo

L'immagine di sfondo appare quando non è aperta nessuna finestra di documento. Come la schermata iniziale, essa è definita in developers.h nella sezione che inizia con:

static const char* const background[]={

Per lo sfondo si consiglia di scegliere un'immagine a basso contrasto. In caso contrario l'immagine potrebbe infastidire l'utente.

Altre lingue: Template:Se