BG_ASCII v1.32
------------------------------------------------------------------
Sviluppato da Boris A. Glazer
boris_a_g@hotmail.com
http://mazaika.tripod.com
------------------------------------------------------------------

1. INTRODUZIONE
   1.1 NOVIT
2. INSTALLAZIONE/DISINSTALLAZIONE
3. ESECUZIONE
4. UTILIZZO
   4.1 ASCII ART IN BIANCO E NERO
       4.1.1 CONVERTIRE UNA IMMAGINE
       4.1.2 CONVERTIRE UN TESTO
       4.1.3 CREARE COMMENTI
   4.2 ASCII/HTML ART A COLORI
       4.2.1 CONVERTIRE UNA IMMAGINE
       4.2.2 CONVERTIRE UN TESTO
   4.3 FUNZIONE TESTO
   4.4 SALVARE IL RISULTATO
   4.5 IMPOSTAZIONI/PREFERENZE
5. DISTRIBUZIONE
7. COME PUOI MANTENERE LO SVILUPPO DI BG_ASCII


------------------------------------------------------------------
1. INTRODUZIONE
------------------------------------------------------------------

BG_ASCII  un programma per creare grafica ascii interattivo.
Grafica ascii -  grafica fatta di comuni caratteri ascii come "A..Z 1..0 !.*#$
eccetera.
 un programma molto interattivo -  possibile cambiare _quasi_ ogni cosa e vedere 
il cambiamento in grafica ascii istantaneamente.
Puoi convertire immagini in immagini ascii usando il tool PIC.
Puoi convertire ogni font installato nel tuo computer in testo ascii artistico
usando il tool TXT.
Puoi salvare il tuo lavoro come testo semplice, file immagine (solo bmp), o file html.
Usando le hotkey puoi convertire un testo semplice dalla clipboard
in un testo ascii artistico e incollarlo in qualsiasi applicazione.
Questa caratteristica  molto utile per scirvere commenti a codici di programmi.

------------------------------------------------------------------
   1.1 NOVIT
------------------------------------------------------------------
NOVIT NELLA VERSIONE 1.32
Corretto un errore nella sezione HTML a colori.

------------------------------------------------------------------
NOVIT NELLA VERSIONE 1.31
Aggiunte minori:

Ora il programma pu ricordare non solo l'ultimo font face usato,
    ma anche i suoi attributi come grassetto e italic

Preferenze Generali "use </font>":
	Quando si salva come HTML  possibile usare o meno le chiusure delle tag
	font (</font>).
	Il file  pi leggero senza di esse, ma se si volesse aggiungere
	del testo dopo l'immagine si potrebbe volerle inserire. (nuovo)

Preferenze Generali "HTML to clipboard only":
	Quando si salva come HTML  possibile copiare il testo in clipboard
	(utile se si vuole vedere una preview e poi copiare il codice html
	risultante nel prorio editor html).
	Se si seleziona "only" non ci sar alcuna finestra di preview aperta
	e il codice html risultante verr solamente copiato in clipboard.

Preferenze Generali "Comment every line":
	Se si seleziona questa opzione - nel caso si usasse BG_ASCII per aggiungere
	commenti nei propri programmi - ogni linea di commento verr scritta tra
	tag di commento.
	Se l'opzione non  selezionata, le tag di commento verranno inserite solo
	prima della prima linea e dopo l'ultima del commento stesso.

------------------------------------------------------------------
NOVIT NELLA VERSIONE 1.3
Creazione di immagini a colori
Salvataggio in HTML
Desktop HotKey - Per convertire testi dalla clipboard in testo ascii semplicemente
	premenod un tasto predefinito.
	Questa  la funzione ideale per scrivere commenti.
Varie nuove funzioni per grafica ascii - rotazione in senso orario/antiorario.
Tutte le immagini nuove create possono essere inserite al posto del testo selezionato

------------------------------------------------------------------
NOVIT NELLA VERSIONE 1.2

Modalit Mulicolore - combina i modi mezzotono e bianco/nero:
	le aree a mezzotono vengono realizzate con caratteri mezzotono ma
	nero marcato e bordi bianchi vengono realizzati come in bianco e nero.

Livello di grigio - ora  possibile impostare non solo i livelli di bianco e nero,
	ma anche quelli di grigio.
	Funziona come il gamma correction dei programmi per immagini.

Funzione Salva - ora  possibile salvare il proprio lavoro come testo semplice o
	immagine bmp.

Nuove funzioni per la grafica ascii - rovesciamento, inversione, ritaglio.

Popup menu - la funzione testo (seleziona all/cut/copy/paste) pu essere raggiunta
	via popup menu come le altre funzioni per la grafica ascii.

Corretto il ridimensionamento delle immagini ico - nelle verioni precedenti
	non era possibile ridimensionare le icone.

------------------------------------------------------------------
2. INSTALLAZIONE/DISINSTALLAZIONE
-----------------------------------------------------------------
Per installare: scompattare i file nel proprio disco. Tutti qui!
Verranno scompattati sei file:

bg_asci.exe - il programma principale
ReadMe.txt  - il file che stai leggendo ora
bg_ascii.diz - una breve descrizione di questo programma
sample.jpg - una immagine di esempio in toni di grigio
abe3.gif   - una immagine di esempio in bianco e nero
pens01.ico - una immagine di esempio a colori

Per disintallare: cancellare questi file.

L'unica cosa che questo programma crea  un file ini (bgasci.ini)
nella directory di windows (ad esempio C:/windows/bgasci.ini)
Cancellare anche questo file.

E questo  tutto!

------------------------------------------------------------------
3. ESECUZIONE
------------------------------------------------------------------
Per eseguire, fare doppio click su bg_asci.exe.
Per usare le hotkey, sar prima necessario definire una combinazione di hotkey
nella pagina delle preferenze.

------------------------------------------------------------------
4.UTILIZZO
------------------------------------------------------------------
   4.1.1 CONVERTIRE UNA IMMAGINE
------------------------------------------------------------------
Per creare una foto ascii premere il pulsante <PIC>:
Quindi premere <Open> e scegliere l'immagine (questa versione riconosce fino a
27 formati, tra i quali jpg, gif, bmp, ico, tif, pcx, pcd e alcuni altri).
Quando l'immagine  caricata, premere il pulsante <Go>
L'immagine sar mostrata in background.

 possibile ridimensionare l'immagine ridimensionando la finestra dell'immagine stessa

 possibile scegliere un'area da convertire cliccando col sinistro sulla parte
desiderata dell'immagine.
Quindi trascinare la maschera di selezione sull'immagine.

Problema noto - se si seleziona un'area e poi si ridimensiona l'immagine, i bordi
visibili della selezione spariranno.
Sar necessario selezionare l'area di nuovo :(

 possibile impostare il livello di nero con shift+click col sinistro sulla parte
desiderata dell'immagine.
 possibile impostare il livello di bianco con shift+click col destro sulla parte
desiderata dell'immagine.
 anche possibile inserire questi dati manualmente.
 possibile impostare il livello di grigio con shift+click col tasto centrale (o, se
il mouse non ce l'ha, con shift+click col sinistro) sulla parte desiderata dell'immagine.

Per tracciare una immagine a mezzitoni selezionare la casella "H"
Per tracciare una immagine in bianco e nero selezionare la casella "B/W"
In modalit "B/W" tutti i colori pi chiari del livello di grigio diveneranno bianco,
tutti quelli pi scuri nero

Se l'immagine ha bordi chiari/scuri marcati - provare ad usare "multicolor".
Questa modalit combina quella a mezzitoni e quella in bianco e nero.

Dopo gli opportuni aggiustamenti, premere nuovamente il pulsante <Go>.

------------------------------------------------------------------
   4.1.2 CONVERTIRE UN TESTO
------------------------------------------------------------------
Per creare un testo ascii, premere il pulsante <TXT>;
Scrivere un qualche testo nella textbox;
Premere il lungo pulsante contenente il nome del font per scegliere font e attributi.

 possibile impostare la dimensione del font e i caratterti di sfondo.

Per creare un testo pi marcato, selezionare la casella "Enhanced"

------------------------------------------------------------------
   4.1.3 CREARE COMMENTI
------------------------------------------------------------------
Con BG_ASCII  possibile creare testi di commento per qualsiasi ambiente di programmazione
(io lo uso con MS VisualFoxPro e Delphi).
Primo - bisogna definire una hotkey non usata dall'IDE che ci interessa (io uso Ctrl-F4).
Secondo - inserire i caratteri di commento in preferenze/general/comment.
In FoxPro si pu usare *!* come apertura di commento e una stringa vuota come chiusura.
Se si vuole un commento html, usare <!-- come apertura e --> come chiusura.
Ora selezionare e tagliare dall'IDE del testo che andr in clipboard
(NOTA - DEVE ESSERE SOLO _UNA_ LINEA - se sono di pi non ci sar alcuna conversione),
quindi premere la hotkey definita in BG_ASCII e alla fine incollare il testo nuovamente.

------------------------------------------------------------------
   4.2 ASCII/HTML ART A COLORI
------------------------------------------------------------------
       4.2.1 CONVERTIRE UNA IMMAGINE
------------------------------------------------------------------
Come in modalit bianco e nero, per creare una foto ascii premere <PIC>:
quindi premere <Open> e scegliere l'immagine.
Selezionare la casella "C" e poi cliccare sul pulsante <GO>.
In "Save as" inserire una nome per il file.
A questo punto il browser partir e mostrer l'immagine come testo html colorato.
 possibile impostare i livelli di nero, bianco e grigio come desiderato - ma potrebbe
essere saggio assegnare 255 a tutti e tre.
In questo caso tutta l'immagine sar composta da un singolo carattere in differenti colori.
La dimensione del font pu essere impostata da Preferenze -> HTML Save page

------------------------------------------------------------------
       4.2.2 CONVERTIRE UN TESTO
------------------------------------------------------------------
Creare un testo come per la modalit bianco e nero.
Quindi aprire Preferenze -> HTML Save page e cliccare sul pulsante "Save'n'View".
Da questa pagina  possibile impostare la dimensione del font, sfondo, colore del font e
titolo della pagina html (Il testo verr posizionato all'interno di tag <XMP></XMP>).
 anche possibile aprire Preferenze -> Color HTML.
Qui si possono creare gradienti di colore diversi per il testo o la grafica.
Utilizza la dimensione del font e il titolo impostati in Preferenze -> HTML Save page

NOTE:
1.
Quando si crea una immagine con gradiente orizzontale - si rischia di creare
un file MOLTO grosso perch prima di ogni carattere del testo verr messa una tag
<font color="XXXXXX">.

2.
Con questo tool  possibile creare linee di testo con gradienti di colore.

------------------------------------------------------------------
   4.3 FUNZIONE TESTO
------------------------------------------------------------------
FUNZIONE TESTO:
Click con destro sulla finestra principale per attivare il popup menu.
Flip - rovescia il testo -  possibile applicare questa funzione al testo semplice:

inarts etnemarev itset eraerc ioup
arbadacarba otseuq ereggel ioup es aM
pilf li evres asoc a otipac iah

Invert      - inverte i colori (scala di grigi) di una immagine ascii
	      Met del'immagine invertita:

         NF"4NNNNNN)
     ._MMNL_. ""NNNMM__            __MN###MM
   ._/"   (M)   MF"""""_.        ._MM#QUUUMM
   (M)    (M)   M)     M)        (MUUUUUUUMM
   (M)    (M)   M)     M)        (MUUUUUUUMM
   (M)    (M)   M)     M)     ___JMNNNNNNNMM___.
   (M)    (M)   M)     M)     MN#)   ########NM)
   (M)    (M)   M)     M)     MHU)    (UL_UUUHM)
   (M)    (M)   M)     M)     MHU)   "4UUUUUUHM)
   (M)    (M)   M)     M)     MMN) ___JNNNNNNMM)
   (M)    (M)   M)     M)   __#)      (#F"#####L_
   (M)    (M)   M)     M)   MMU)     "4UF"__UUUHM
   (M)    (M)   M)     M)   MMU)      (U) UUUUUHM
   (MNH___JM)   MNHL_HHM)   MMU)      (U) UUUUUHM
NNNNN) ___. (NNN   +%  NNN4"  2`"4N"""` ++       ""NNNNN
NNNNN) 22N)2+   +++%2  NNN) 222(NNNNNN)2(N22N)222  NNNNN
NNNNN) NNNNNJ_%%%$222  NNN) %%2(NNNNN2(N)%""%%%%%  NNNNN
NNNNN) NNNNN4"NN22222  NNNNN  2(NNNNN2._.%__%%%  NNNNNNN
NNNNN) +++++  ++       NNNNN  2(NNNNNN)2(N22222+ NNNNNNN
NNN) (NNNNNNNNNNNNNNNNN (NNN  2(NNNNN22222NN222+ NNNNNNN
NNN) (NNNNNNNNNNNNNNNNN (NNN  2(NNNNNN)2(N22222+ NNNNNNN
NNN) (NNNNNNNNNNNNNNNNN (NNN  2(NNNNNN)2(N22222+ NNNNNNN
NNN) (NNNNNNNNNNNNNNNNN (NNN  2(NNNNN"`2`"__222+ NNNNNNN
NNN)                    (NNN                     NNNNNNN
NNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNNN

Trim left   - ritaglia il primo carattere a sinistra della linea
Shift right - aggiunge uno spazio come primo carattere a sinistra della linea
Trim right  - ritaglia il primo carattere a destra della linea
Shift left  - aggiunge uno spazio come primo carattere a destra della linea
No trails   - ritaglia tutti gli spazi ai bordi della linea
Make trails - crea spazio ai bordi delle linee per fare in modo che tutte le linee
              abbiano la stessa lunghezza della linea pi lunga del testo

Rotate CW/CCW - ruota il testo in senso orario o antiorario in questo modo:

 C  H  t  B  c  I  w  r  b  i    I  i  n  d  s  
 a  o  h  G  r     a  e  u  t    f  t  e  o  e  
 n  w  i  |  e  d  y  a  t             e  n  n  
       s  A  a  o     l     i    y  i  d  '  d  
 y  d     S  t  n  i  l  I  s    o  n  f  t     
 o  o  t  C  e  '  t  y          u     u     m  
 u     e  I     t        f  a       s  l  f  e  
    y  x  I  t     c  u  e       c  o     o     
 r  o  t     h  k  a  s  e  f    a  m  w  r  m  
 e  u  ?  1  i  n  n  e  l  u    n  e  a  g  e  
 a        .  s  o     d  :  n          y  e  s  
 d  l     3  .  w  b        !    u        t  s  
    i              e  -          s           a  
 t  k     c     t                e           g  
 h  e     a     h                            e  
 i        n     e                            .  
 s                                              
 ?                                              


Tutte queste funzioni possono essere usate sull'intero testo o
su una parte selezionata di esso.

------------------------------------------------------------------
   4.4 SALVARE IL RISULTATO
------------------------------------------------------------------
1. Salvare per un'altro programma
   Si pu copiare o tagliare la grafica ascii in clipboard usando
   Ctrl-C o Ctrl-X
   Dopo di che si potr incollarla ovnunque si desideri. 

2. Cliccare sul pulsante "Save"
   Scegliere il formato (text/bmp/html) nel quale si desidera salvare e inserire
   un nome per il file.

------------------------------------------------------------------
   4.5 IMPOSTAZIONI/PREFERENZE
------------------------------------------------------------------
Enhanced settings - in modalit Enhanced (e in modalit tracciamento nella finestra immagine)
ogni matrice 2x2  rappresentata da un singolo carattere ascii

 possibile impostare 16 caratteri differenti nella finestra "txt"
Questa impostazione ha effetto sia nella finestra di testo che in quella dell'immagine

Il piccolo pulsante con la "R" reimposta questi caratteri ai valori predefiniti

------------------------------------------------------------------
Immagine in modalit mezzitoni. Casella <H> selezionata:

         2222222222+                                    
       22N#U#NNNNNNA2                2222222            
     2UMMN#U0%DDNNNMMUU            UUMN###MM            
   2UA0222UM0 00MQ00000U2        2UMM#QUUUMM            
   0MA%   0M0 00MA%+.%%M0        0MUUUUUUUMM            
   0MA%   0M0 00MA%%+%%M0        0MUUUUUUUMM            
   0MA%   0M0 00MA%%+%%M0     UUUHMNNNNNNNMMUUU2        
   0MA%   0M0 00MA%+.%%M0     MN#D222########NM0        
   0MA%   0M0 00MA%%+%%M0     MHU2   %0UADUUUHM0        
   0MA%   0M0 00MA%+.%%M0     MHU2   0DUUAUUUHM0        
   0MA%   0M0 00MA%+.%%M0     MMN0 UU0UNHHNNNMM0        
   0MA%   0M0 00MA%%+%%M0   UU#D2+ 22%0#U0#####QU       
   0MA%   0M0 00MA%+.%%M0   MMU2     0DUADDDUUUHM       
   0MA%   0M0 00MA%%+%%M0   MMU2     %0UDYAAUUUHM       
   0MNQUUUHM0 00MNQQUQQM0   MMU2     %0UDYAAUUUHM       
   +2UMDD0QM0 00MMNH#MM2+ 2UMMUUU2 UU0UNHQNNNNNMMUU     
     0MUU%0UHMMMHHHQUMM   0MUUU2      2U0%UU0AUUUMM     
     0M00%200D###QUUUMM   0M##U02+ 22U02D#UU#####MM     
     0M00%200D00UUUUUMM   +2MMU02+ 22UUUQ#UU###NM22     
     0M##Q##HN##NNNNNMM     MMU2     %YA0YAAUUUHM       
   0MA%     .%  %202%%%M0   MMU2     UUUUU00UUUHM       
   0MA%   .+..++Y22%.%%M0   MMU2     %0UDYAAUUUHM       
   0MA%   .+..++Y22%.%%M0   MMU2     %0UDYAAUUUHM       
   0MA%    ..+..22Y$+%%M0   MMU2     0DUADDDUUUHM       
   0MMMMMMMMMMMMMMMMMMMM0   MMMMMMMMMMMMMMMMMMMMM       
                                                        
Lo stesso in modalit Multicolor. Casella <M> selezionata:
                                                        
         NF"4NNNNNN)                                    
     ._MMNL_. ""NNNMM__            __MN###MM            
   ._/"   (M)   MF"""""_.        ._MM#QUUUMM            
   (M)    (M)   M)     M)        (MUUUUUUUMM            
   (M)    (M)   M)     M)        (MUUUUUUUMM            
   (M)    (M)   M)     M)     ___JMNNNNNNNMM___.        
   (M)    (M)   M)     M)     MN#)   ########NM)        
   (M)    (M)   M)     M)     MHU)    (UL_UUUHM)        
   (M)    (M)   M)     M)     MHU)   "4UUUUUUHM)        
   (M)    (M)   M)     M)     MMN) ___JNNNNNNMM)        
   (M)    (M)   M)     M)   __#)      (#F"#####L_       
   (M)    (M)   M)     M)   MMU)     "4UF"__UUUHM       
   (M)    (M)   M)     M)   MMU)      (U) UUUUUHM       
   (MNH___JM)   MNHL_HHM)   MMU)      (U) UUUUUHM       
     (M"""4M)   MMNH#MM   ._MMUL_. ___JNHHNNNNNMM__     
     (MUU (UHMMMHHH#UMM   (MUUU)      (U) UU (UUUMM     
     (M     `"###QUUUMM   (M##U)     U) (#__#####MM     
     (M     ._  UUUUUMM     MMU)     UF"4#""###NM       
     (MHHHHHNNHHNNNNNMM     MMU)      (U) UUUUUHM       
   (M)                 M)   MMU)     UUUUU  UUUHM       
   (M)                 M)   MMU)      (U) UUUUUHM       
   (M)                 M)   MMU)      (U) UUUUUHM       
   (M)                 M)   MMU)     _JUL_""UUUHM       
   (MMMMMMMMMMMMMMMMMMMM)   MMMMMMMMMMMMMMMMMMMMM       
                                                        
Lo stesso in modalit bianco e nero. Casella <B> selezionata:

         __________.                                    
       __NNNNNNNNNNL_                _______            
     (NNNNNNF"NNNNNNNNN            NNNNNNNNN            
   (NNN"""4N) NNNNNNNNNN)        (NNNNNNNNNN            
   (NNN   (N) NNNNNL_NNN)        (NNNNNNNNNN            
   (NNN   (N) NNNNNNNNNN)        (NNNNNNNNNN            
   (NNN   (N) NNNNNNNNNN)     NNNNNNNNNNNNNNNNN)        
   (NNN   (N) NNNNNF"NNN)     NNNF"""NNNNNNNNNN)        
   (NNN   (N) NNNNNNNNNN)     NNN)   _JNNNNNNNN)        
   (NNN   (N) NNNNNL_NNN)     NNN)   NNNNNNNNNN)        
   (NNN   (N) NNNNNF"NNN)     NNN) NNNNNNNNNNNN)        
   (NNN   (N) NNNNNNNNNN)   NNNF"` """4NNNNNNNNNN       
   (NNN   (N) NNNNNL_NNN)   NNN)     NNNNNNNNNNNN       
   (NNN   (N) NNNNNNNNNN)   NNN)     _JNNNNNNNNNN       
   (NNNNNNNN) NNNNNNNNNN)   NNN)     "4NNNNNNNNNN       
   `"4NNNNNN) NNNNNNNNN"` (NNNNNN) NNNNNNNNNNNNNNNN     
     (NNNNNNNNNNNNNNNNN   (NNNN)      (NNNNNNNNNNNN     
     (NNNNNNNNNNNNNNNNN   (NNNNL_. __NL_JNNNNNNNNNN     
     (NNNNNNNNNNNNNNNNN   `"NNNF"` ""NNNNNNNNNNNN""     
     (NNNNNNNNNNNNNNNNN     NNN)     "4NNNNNNNNNN       
   (NNN     (N  NNNNNNNN)   NNN)     NNNNNNNNNNNN       
   (NNN   (NL_NNNNNL_NNN)   NNN)     _JNNNNNNNNNN       
   (NNN   (NF"NNNNNF"NNN)   NNN)     "4NNNNNNNNNN       
   (NNN   `"4N""NNNNNNNN)   NNN)     NNNNNNNNNNNN       
   (NNNNNNNNNNNNNNNNNNNN)   NNNNNNNNNNNNNNNNNNNNN       
                                                        

IMPOSTAZIONI della finestra di sfondo

Cambiare tipo e dimensione di font della finestra di sfondo come descritto
nella sezione "CONVERTIRE UN TESTO".
(Penso si dovrebbe scegliere un font a dimensione fissa tipo courier.)

Per modificare la stringa di caratteri da usare come scala dei mezzitoni:

Manuale - inserire una stringa di 16 caratteri nella textbox apposita

Auto - premere il pulsante <Pref>.
Scegliere font e attributi, dopo un p una stringa di mezzitoni apparir
nella textbox. Lasciare 16 caratteri e premere <Go>

------------------------------------------------------------------
5. DISTRIBUZIONE
------------------------------------------------------------------
Sentitevi liberi di usare questo programma, sia per usi commerciali e non.

Questo software  distribuito 'as-is', senza garanzie implicite o esplicite.
In nessun caso l'autore potr essere ritenuto responsabile per eventuali danni
provocati dall'utilizzo di questo software.

------------------------------------------------------------------
7. COME PUOI MANTENERE LO SVILUPPO DI BG_ASCII
------------------------------------------------------------------

Se questo piccolo freeware ti  paciuto e vuoi aiutarmi nel continuare
a lavorarci su puoi (ma non devi) supportarmi in quattro modi:

1. Mandami una e-mail per dirmi cosa v bene, cosa v male e cosa dovrebbe
   essere fatto per migliorare BG_ASCII

2. Vai su http://mazaika.tripod.com e clicca sui banner dei miei sponsor

3. Mandami una cartolina di saluto

4. Mandami una cartolina di saluto includendo 1..2..5 dollari ;-)


Il mio indirizzo:

Russia
620002
Ekaterinburg K-2
ul. Mira, 19, a/b 23
Boris A. Glazer

------------------------------------------------------------------

Boris A. Glazer
boris_a_g@hotmail.com
http://mazaika.tripod.com
