Le «Carte di Credito»
Il programma CreditCard permette di creare un kit per l'assemblaggio di una foto fronte/retro in formato "carta di credito".
Il kit viene stampato su una cartolina 10x15cm, mentre il prodotto finale ha le dimensioni di una carta di credito (86x54 mm).
Il programma chiamato con il parametro -h o --help mostra la sintassi di utilizzo, come riportato di seguito:
Casasoft Contemporary Carte de Visite CreditCard Copyright (c) 2020-2023 Roberto Ceccarelli - Casasoft Usage: CreditCard [options]* inputfile Options: --fronttext=VALUE text in front (Cardholder name) --fronttextfont=VALUE front text font (default 'Arial') --fronttextcolor=VALUE front text color (default #000000) --fronttextborder=VALUE front text border color (default #000000) --fronttextbackground=VALUE front text background color (default #00000000) --fontbold use bold font weight --fontitalic use italic font style --mbcolor=VALUE magnetic band color (default #8B4513) --mbimage=VALUE magnetic band overlay image --backimage=VALUE image for back side --backtext=VALUE pango markup for text on back side. Text can be stored in a file instead of a string. The file must be referenced as '@filename' --fillcolor=VALUE set the color used to fill the images (default #FFFFFF) --bordercolor=VALUE set the color used to border the images (default #000000) --dpi=VALUE set output resolution (default 300) --json=VALUE parameters in json format, use --helpjson for sample template Text can be stored in a file instead of a string The file must be referenced as '@filename' --script=VALUE c# script for custom processing, use --helpscript for sample template Text can be stored in a file instead of a string The file must be referenced as '@filename' -o, --output=VALUE set output dir/filename --extension=VALUE file extension for output file (default 'jpg') --tag=VALUE extra info for user scripts Text can be stored in a file instead of a string The file must be referenced as '@filename' --nobanner suppress the banner -h, --help show this message and exit --helpjson show json parameters template --helpscript show script template --man show the man page source and exit --colors list available colors by name --license show program license (AGPL 3.0) Colors can be written in any of these formats: #rgb #rrggbb #rrggbbaa #rrrrggggbbbb #rrrrggggbbbbaaaa colorname (use CreditCard --colors to see all available colors) Environment variables The program can read values from these variables: CDV_OUTPATH Base path for output files CDV_DPI Resolution for output files CDV_FILL Color used to fill images CDV_BORDER Border color
Per chi la preferisse è anche disponibile la man page (Nuova pagina) Unix
La man page, in formato MarkDown, può essere ottenuta chiamando il programma con l'opzione --man
I parametri possono essere passati in un file in formato json le cui struttura può essere ottenuta con il comando cartella --helpjson il cui output è riportato di seguito:
Casasoft Contemporary Carte de Visite CreditCard Copyright (c) 2020-2023 Roberto Ceccarelli - Casasoft Json parameters template for: CreditCard { "FrontText": "", "FrontTextFont": "Arial", "FrontTextColor": "#FFFFFF", "FrontTextBorder": "#000000", "FrontTextBackground": "#00000000", "fontBold": false, "fontItalic": false, "MagneticBandColor": "#000000FF", "MagneticBandImage": "", "BackImage": "", "BackText": "", "FillColor": "#FFFFFF", "BorderColor": "#000000", "Dpi": 300, "OutputName": "", "Extension": "jpg", "Script": null, "Tag": null, "FilesList": [] }
Al programma deve essere passato il file contenente l'immagine sul fronte, l'eventuale immagine da riportare sul dorso va passata con il parametro --backimage=; se non viene passato viene utilizzata l'immagine frontale previa applicazione di un filtro blur e di un generale schiarimento in modo da dare un effetto traslucido.
Sul frontale può essere creata una label passandola con il parametro --fronttext=; una serie di parametri opzionali permette di specificare il font, gli attributi bold e italic, il colore di riempimento e del bordo del carattere; infine con --fronttextbackground= si può inserire uno sfondo colorato anche semitrasparente.
Sul dorso viene inserito un rettangolo colorato che simula la banda magnetica; il colore del rettangolo viene specificato con --mbcolor=, al rettangolo può essere sovrapposta una immagine con il parametro --mbimage=.
L'opzione --dpi= (non esiste forma breve) specifica la risoluzione, in dpi, del file di uscita.
Se non indicata viene impostata a 300dpi.
L'opzione -o, o la versione lunga --output=, permette di specificare il pathname (senza estensione) del file generato: se non specificata il file si chiamerà cc.jpg e si troverà nella stessa directory del programma.
Questa immagine mostra un esempio del risultato ottenibile.