//          ------------------------------------------------------
//          Istruzioni di configurazione per lo script dFramer.jsx
//          ------------------------------------------------------
//
// ****************************************************************************
//   Questo documento fornisce istruzioni sulla compilazione del file di 
//  configurazione dello script. Tale file deve essere denominato 'dFramer.cfg' 
//    e va collocato nella cartella di installazione di Adobe PhotoShop CS2.
//  Questo documento  esso stesso strutturato come file di configurazione, 
//                    sufficiente rinominarlo come descritto.
// ****************************************************************************
//
// Il file di configurazione pu contenere due tipi di sezioni:
//
// 1. [OPTIONS] -> parametri per dimensioni, bordi, cornici ed altro.
//                 E' possibile avere UNA SOLA sezione di questo tipo.
//
// 2. [TEXT]    -> parametri per la definizione del testo.
//                 E' possibile avere un NUMERO virtualmente ILLIMITATO di
//                 queste sezioni, una per ogni singolo testo.
//
// Di seguito vengono descritti tutti i parametri di ciascuna sezione.
// Modificare i relativi valori in base alle proprie esigenze.
//
// *****************************************************************************
// IMPORTANTE: limitarsi a modificare i valori dei parametri presenti a destra
// del segno "=". Non apportare altre modifiche a questo file.
// *****************************************************************************

[OPTIONS]
// *** Dimensioni finali della tela e valore DPI ***
// -------------------------------------------------
// L'ideale  che sia le dimensioni sia il valore DPI siano identici alla
// dimensione della carta ed alla risoluzione dello stampatore. In questo modo
// saremo sicuri che lo stampatore non apporter modifiche durante il processo
// di stampa.
//
// N.B.: per disabilitare il ridimensionamento dell'immagine, porre a 0 almeno
// uno dei tre valori seguenti.

// Larghezza finale della tela (cm)
CanWidthX =  19

// Altezza finale della tela (cm)
CanWidthY =  13

// Risoluzione finale (preferibilmente la stessa di quella di stampa)
DPI       = 300


// *** Passepartout ***
// --------------------

// Le dimensioni (minime) del passepartout (px)
MatteDim = 100

// Dimensioni aggiuntiva di un eventuale bordo inferiore maggiorato (px)
BottomMatteExtraDim = 0

// Colore del passepartout
// (tripletta RGB esadecimale. Esempio: "FFFFFF" = bianco; "000000" = nero)
MatteCol = FFFFFF


// *** Bordino immagine ***
// ------------------------

// Le dimensioni del bordino (px)
StrokeDim = 2

// Colore del bordino
// (tripletta RGB esadecimale. Esempio: "FFFFFF" = bianco; "000000" = nero)
StrokeCol = 000000


// *** Fattore di crop ***
// -----------------------
// Parametro utilizzato nel calcolo della focale equivalente, se richiesta nel
// testo.
// Esempi: 0 = Focale equivalente non disponibile; 1 = Full frame
// 1.5 = formato Nikon DX; 1.6 = formato Canon APS-C
CropFactor = 0
[/OPTIONS]



[TEXT]
// *** Contenuto del testo ***
// ---------------------------

// Pu contenere speciali valori (tag) che saranno sostituiti con i
// corrispettivi dati Exif riconosciuti da Photoshop. Consultare la tabella
// "Exif TAGs utilizzabili per comporre il testo" alla fine di questo file per
// sapere quali tag sono disponibili.
Msg = Testo in alto a sinistra

// Nome del font (nome interno di Photoshop. Per conoscere l'elenco dei nomi
// interni dei font installati sul computer, eseguire lo sript 'ListFont.jsx'.
// Verr generato un file contenente l'elenco dei font installati sul computer:
// per ciascun font in elenco viene indicato il nome interno usato da PhotoShop.
// Il file generato dallo script si chiama "FontList.csv" e viene salvato nella
// cartella di installazione di PhotoShop CS2. Il formato CSV (Comma Separated
// Values)  un formato tabulare che pu essere importato in applicativi di
// database o fogli elettronici (ad esempio MS Access ed Excel). Un file CSV pu
// anche essere aperto con un normal editor di testi (ad es. Notepad), anche se
// la consultazione non ne risulta delle pi agevoli ;-)
FontName = ArialMT

// Dimensione del font
FontSize = 24

// Colore del font
// (tripletta RGB esadecimale. Esempio: "FFFFFF" = bianco; "000000" = nero)
HexColor = 000000

// Posizione relativa del testo: consultare la tabella "Valori ammessi per il
// parametro 'Position'" presente in fondo a questo file.
Position = UL

// Scostamento orizzontale del testo (px)
OffsetX = 0

// Scostamento verticale del testo (px)
OffsetY = 20
[/TEXT]

// ****************************************************************************
//
// Exif TAGs utilizzabili per comporre il testo
// --------------------------------------------
// Come contenuto dei testi (ossia nel parametro 'Msg')  possibile inserire dei
// tag Exif in modo tale da riportare automaticamente i dati di scatto
// nell'immagine. Ad esempio: 'Msg = Foto scattata con [Model]'. Il risultato
// potrebbe essere: 'Foto scattata con Canon PowerShot A620'.
//
// Photoshop importa solo un sottoinsieme dei dati Exif presenti nelle immagini.
// Inoltre, l'insieme dei dati Exif generati dalle fotocamere varia da modello a
// modello. Per questi motivi, non  possibile fornire direttamente un elenco
// esaustivo di tag exif supportati dallo script.
//
// L'approccio adottato nella realizzazione di questo script  stato quindi il
// seguente:
//
// 1) Viene fornito uno script di utilit denominato "AvailableExifData.jsx"
//    il quale genera un file nella cartella di installazione di PhotoShop CS2
//    chiamato 'AvailableExifData.txt'. Il file generato conterr l'elenco dei
//    Tag Exif supportati per il file attivo. E' sufficiente copiare ed
//    incollare nel parametro 'Msg' i tag racchiusi tra parentesi quadre.
//
//    Ad ogni modo,  qui possibile riportare un elenco di tag Exif di maggior
//    interesse quasi sempre disponibili:
//
//
//    TAG comuni             DESCRIZIONE
//    --------------------   -----------
//
//    [Make]                 Produttore
//    [Model]                Nome fotocamera
//    [Date Time]            Data/Ora di  modifica (aaaa:MM:gg hh:mm:ss)
//    [Exposure Time]        Tempo di esposizione
//    [F-Stop]               Apertura diaframma
//    [Date Time Original]   Data di scatto
//    [Focal Length]         Lunghezza focale
//
//
// 2) Vengono forniti una serie di tag "speciali", utili per ottenere valori
//    pre-formattati.
//
//    TAG speciali           DESCRIZIONE
//    --------------------   -----------
//    [FocalEq]              Focale equivalente. E' necessario prima impostare
//                           il parametro CropFactor presente nella sezione
//                           [OPTIONS]
//    [DateShort]            Data di scatto in formato gg.MM.aaaa
//    [DateLong]             Data di scatto in formato gg mese_per_esteso aaaa
//    [Time]                 Orario di scatto in formato hh:mm
//    [Day]                  Giorno di scatto in formato gg
//    [Month]                Mese di scatto in formato MM
//    [MonthLong]            Mese di scatto in formato mese_per_esteso
//    [MonthShort]           Mese di scatto in formato prime_tre_lettere_mese
//    [Day]                  Anno di scatto in formato aa
//
//
//
// ****************************************************************************
//
//  Valori ammessi per il parametro "Position" della sezione [TEXT]
//  ---------------------------------------------------------------
//
//  Valore       Descrizione
//  ------       ----------------------------------
//  UL      ->   Upper Left    - In alto a sinistra
//  UC      ->   Upper Center  - In alto al centro
//  UR      ->   Upper Right   - In alto a destra
//  BL      ->   Bottom Left   - In basso a sinistra
//  BC      ->   Bottom Center - In basso al centro
//  BR      ->   Bottom Right  - In basso a destra
//



[TEXT]
Msg=Testo in alto al centro
FontName=ArialMT
FontSize=24
HexColor=000000
Position=UC
OffsetX=0
OffsetY=20
[/TEXT]


[TEXT]
Msg=Testo in alto a destra
FontName=ArialMT
FontSize=24
HexColor=000000
Position=UR
OffsetX=0
OffsetY=20
[/TEXT]

[TEXT]
Msg=Testo in basso a sinistra
FontName=ArialMT
FontSize=24
HexColor=000000
Position=BL
OffsetX=0
OffsetY=60
[/TEXT]

[TEXT]
Msg=Testo in basso al centro
FontName=ArialMT
FontSize=24
HexColor=000000
Position=BC
OffsetX=0
OffsetY=60
[/TEXT]

[TEXT]
Msg=Testo in basso a destra
FontName=ArialMT
FontSize=24
HexColor=000000
Position=BR
OffsetX=0
OffsetY=60
[/TEXT]