BG_ASCII V1.32
----------------------------------------------------------------------------
Programmeret af Boris A. Glazer
boris_a_g@hotmail.com
http://mazaika.tripod.com
----------------------------------------------------------------------------

1. Introduktion
   1.1 Nyheder
2. Installering og de-installering
3. Kre programmet
4. Brug
   4.1 Sort/hvid ASCII kunst
       4.1.1 Konverter billede
       4.1.2 Konverter tekst
       4.1.3 Indst kommentar
   4.2 Farve ASCII kunst
       4.2.1. Konverter billede
       4.2.2 Konverter text
   4.3 Tekst funtion
   4.4 Gem arbejde
   4.5 Indstillinger
5. Distribution
7. Hvordan kan du hjlpe med udviklingen af BG_ASCII

----------------------------------------------------------------------------
1. Introduktion
----------------------------------------------------------------------------

BG_ASCII er et interaktivt ASCII grafik vrktj.
ASCII grafik er grafik lavet med almindelige ASCII tegn, f.eks. 
"A, B, C, D... 1, 2, 3,... ! . * ' " og s videre.
Det er et meget interaktivt program. Du kan ndre *nsten* alting og straks 
se hvordan ASCII grafikken ndres.
Du kan konvertere billede filer til ASCII billeder ved hjlp af vort PIC 
vrktj.
Du kan konvertere enhver font installeret p din computer til kunstfrdig 
ASCII text ved hjlp af vort TXT vrktj.
Du kan gemme dit arbejde som almindelig tekst, billed fil (kun bmp) 
eller en html fil.
Ved at bruge en "hotkey" kan du konvertere almindelig tekst gemt i Window's 
clipboard til kunstfrdig ascii tekst og klistre det ind i enhver applikation. 
Denne feature er storartet til at srkive kommentarer i program kode.

----------------------------------------------------------------------------
1.1 Nyheder
----------------------------------------------------------------------------

Nyheder i version 1.32
Fejl korrigering i farve HTML sektionen

----------------------------------------------------------------------------
Nyheder i version 1.31
Mindre tilfjelser:

Nu kan programmet huske ikke kun den sidst brugte font, men ogs attributter 
ssom fed eller kursiv

Generelle instillinger "use </font>":
Nr du gemmer en fil som HTML kan du vlge at have eller ikke have HTML 
slut-tags </font>. Filen bliver mindre uden dem, men hvis du vill tilfje 
tekst efter billedet vil du mske have dem alligevel (nyt)

Generelle instillinger "HTML to clipboard only":
Nr du gemmer som HTML can du kopiere tekst til clipboardet (smart hvis 
du gerne vil have et preview og s klistre den frdige html kode til din 
html editor). Hvis du klikker "only" s vil der ikke blive bnet et 
browser vindue, og den resulterende html kode vil kun blive indsat p clipboardet.

Generelle instillinger "comment every line":
Hvis du klikker p denne option - nr du bruger BG_ASCII til at lave kommentarer 
til dine programmer - s bliver hver kommentar insat mellem kommentar-tags. 
Hvis du ikke klikker p denne option, s bliver kommentar tags kun indsat 
fr frste linie og efter sidste linie.

----------------------------------------------------------------------------
Nyheder i version 1.3
Farve billede dannelse
Gem til html
Hotkey fra desktoppen - til at konvertere clipboard tekst til ascii tekst 
skal du blot trykke p en hotkey. Rigtigt smart til at lave kommentarer.
Flere ny ascii grafik funktioner - du kan rotere med eller mod uret
Alle nyligt dannede billeder eller tekst kan blive klistret ind i stedet 
for valgt tekst

----------------------------------------------------------------------------
Nyheder i version 1.2

Flerefarve mode - kombinerer halftone og sort/hvid mode: Halftone omrder 
renderes med halftone tegn men skarpe sort og hvide kanter vises i sort/hvid.

Grfarve niveau - nu kan du indstille ikke kun sort og hvis men ogs grtoner. 
Det virker som en gamma korrigering i billede redigerings programmer.

Gemme funtion - nu kan du gemme dit arbejde enten som en ren tekst fil eller 
som et bmp billede.

Ny ascii grafik funktion - flip, omvend, trim

Popup menu - tekst funtion (select alt/klip/kopi/klistre) kan nu vlges p en 
popup menu som andre nye grafiske funtkoner.

Korrekt skalering af ico billeder - i tidligere versioner kunne du ikke 
scalere icon billder.

----------------------------------------------------------------------------
2. Installering / de-installering
----------------------------------------------------------------------------
For at installere: unzip filerne til din hard disk. Og det er det hele! 
Du vil f 6 filer nr du unzipper:

bg_ascii.exe - hovedprogrammet
ReadMe.txt - den fil du lser nu
bg_ascii.diz - kort beskrivelse af programmet
sample.jpg - eksempel p et grtone billede
abe3.gif - eksempel sort/hvid billede
pens01.ico - eksempel farve billede

For at de-installere: Slet disse filer

De eneste der bliver gemt p din maskine:
ini fil bgasci.ini i dit windows directory (f.eks. c:/windows/bgasci.ini)
Slet den ogs.
Og det er det hele!

----------------------------------------------------------------------------
3. Kre programmet
----------------------------------------------------------------------------

For at kre programmet: Dobbelt-klik p bg_asci.exe
For a bruge hotkey funktionen - du skal frst vlge en hotkey p 
indstillingerne's frste side

----------------------------------------------------------------------------
4. Brug af programmet
----------------------------------------------------------------------------
   4.1.1 Konverter billede
----------------------------------------------------------------------------
For at lave et ascii photo tryk p <PIC> knappen:
S tryk <Open> og vlg billed filen
(denne version kan forst 27 forskellige fil formater,
incl jpg, gif, bmp, ico, tif, pcx, pcd og andre)
Nr billedet er lst ind tryk p <Go> knappen.
Billedet vil s blive vist p baggrunden.

Du kan ndre strrelse p billedet ved at ndre vinduets strrelse.

Du kan vlge et konverterings orde ved at venstre-klikke og trkke musen 
over den del af billedet du vil have. Derefter kan du trkke den valgte 
maske over billedet.

Kendt FEJL - nr du vlger et omrde og s ndre strrelse - 
Det valgte omrdes grnser forsvinder. Du er ndt til at vlge omrdet igen :(

Du kan justere hvor meget sort der er ved at shift venstre klikke 
et omrde af billedet.
Du kan justere hvor meget hvidt er er ved at shift hjre klikke et omrde 
af billedet.
Eller du kan taste disse vrdier ind manuelt.
Du kan justere grtoner ved shift mellem klik (eller hvis din mus ikke 
har en midter knap - ctrl venstre klik) p et omrde af billdet.

For at danne halftone billder - klick "H" radio knappen.

For at danne sort/hvide billder - klick "B/W" knappen.
I "B/W" mode bliver alle omrder lysere end _GRAY_ hvide, og alle 
mrkere bliver sorte.

Hvis dit billede har skarpe linier, prv at bruge "multicolor" mode. 
Det kombinerer grtoner og sort/hvid.

Efter justeringerne, tryk p <Go> knappen igen.

----------------------------------------------------------------------------
   4.1.2 Konverter tekst
----------------------------------------------------------------------------
For at lave ascii tekst, tryk p <TXT> knappen:
Tast noget tekst ind i tekstboksen. 
Tryk p den lange knap med font navn for at vlge font og attributter.

Du kan justere font strrelse, forgrundsfarve og baggrundsfarve.

For at forbedre din tekst, klick p "Enhanced"

----------------------------------------------------------------------------
   4.1.3 Lav kommentar
----------------------------------------------------------------------------

Med BG_ASCII kan du lave kommentar tekst i ethvert windows udviklingsvrktj 
(jeg bruger det med MS VisualFoxPro og Delphi).
Frst - du skal definere din hotkey til en tast der ikke bruges af dit 
udviklingsvrktj (jeg bruger ctrl-F4)
Derefter - indtast din kommentar under "preferences/general/comment". I 
FoxPro kan du bruger *!* til at starte kommentaren og en blank linie til at 
slutte den. Hvis du vil lave html kommentarer, brug <!-- som start 
og --> som afslutning.

Nu skal du vlge og klippe noget tekst fra dit udviklingsvrktj til windows 
clipboard (NB, det kan kun vre EN linie - hvis der er mere end en linie s 
bliver intet konverteret) - tryk igen p din valgte hotkey og tilsidst 
klistre teksten ind igen.

----------------------------------------------------------------------------
   4.2 Farve ascii/html kunst
----------------------------------------------------------------------------
       4.2.1 Konverter billeder
----------------------------------------------------------------------------
Ligesom i sort/hvis mode vlger du at lave et ascii photo med <PIC> knappen:
s tryk <Open> og vlg billed filen.
Klik "C" radio knappen og klik p <Go> knappen.
I "save as" kan du taste et filnavn og trykke p <ok>.
S vil din default browser starte og vise dit billede som farve html tekst. 
Du kan justere sort, gr og hvid niveau som du har lyst til, men det kan 
vre smart at tildele 255 til alle vrdier.
Hvis du gr det, s bilver dit billede et enkelt tegn i forskellige farver.
Font strrelse kan du justere under Preferences -> HTML Save page.

----------------------------------------------------------------------------
           4.2.2 Konverter tekst
----------------------------------------------------------------------------
Start som i sort/hvis mode
S klik Preferences -> HTML Save page og klik p <Save'n'view> knappen.
P denne side kan du justere font strrelse, baggrund og forgrundsfarve og 
titlen p din html side.
(Din tekst vil blive indsat mellem <XMP> </XMP> tags)
Du kan bne Preferences -> Color HTML Page
Her kan du lave farve gradient tekst eller grafik.
Det bruger font strrelse og tittel fra Preferences -> HTML Save page

NB:
1. Nr du laver et billede med en horisontal gradient kan det resulter i 
   MEGET store filer, for hver karakter i teksten bliver erstattet 
    af <font color=xxxx>.

2. Med dette vrktj kan du lave gradient farve linier ud af tekst.

----------------------------------------------------------------------------
   4.3 Tekst funtion
----------------------------------------------------------------------------

Tekst funktion:
Hjre klik p hovedvinduet for at aktivere popup menuen.
Flip - vender teksten om - du kan bruge denne funktion med almindelig tekst:

etted esl nak ud sivh rg nenoitknuf plif davh rtsrof uD

Invert - inverterer farve (grtoner) af et ascii billede. 
         Halvt billede inveretet

         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   - skr tegnet mest til venstre af i hver linie
Shift right - indst et blanktegn til venstre p hver linie
Trim right  - skr tegnet mest til hjre af hver linie
Shift right - Inst et blanktegn til hjre p hver linie
No trails   - Skr alle blanktegn af enden af linierne
Make trails - Gr alle linier lige lange ved at indstte blanktegn til 
              hjre p linien

Rotate CW/CCW - roter tekst med uret (CW) eller imod uret (CCW) som dette:

K H d B l J h t s   H d f v e
a v e G a e v i j   v e o e t
n a n ! v g a l o   i t r n 
  d n A e   d , v   s   n l e
d   e S   v     t     t u i k
u s   C d e d m u   d i f g s
  y t I e d e e u   u l t   e
l n e I t   t n d       i o m
 e k   t i     .   k n g g p
s s s 1 e k k d     a o t   e
e   t .   k a e     n g , s l
  d ? 3   e n t       e   e .
d u                 b t v n
e     k     b s     r    d
t o   a     r e     u   r  
t m   n     u r     g     m
e           g       e     i
?           e             g
            s 

Denne funktion kan bruges enten p udvalgt tekst eller p hele teksten.

----------------------------------------------------------------------------
   4.4 Gem arbejdet
----------------------------------------------------------------------------
1. Gem til en anden applikation
   Du kan klippe eller kopiere ascii grafik via clipboardet ved at trykke
   ctrl-c eller ctrl-x
   Defefter kan du klistere det ind hvor du har lyst med ctrl-v

2. Clik p "Save" knappen
   Vlg filformat (text/bmp/html) og vlg et filnavn

----------------------------------------------------------------------------
   4.5 Instillinger / Preferences
----------------------------------------------------------------------------
Avancerede instillinger - I avanceret mode (og i trace mode i billede vinduet
bliver hver 2x2 matrice reprsenteret af et enkelt ascii tegn.

Du kan justere 16 forskellige tegn i "txt" vinduet.
Denne indstilling pvirker bde tekst og billede vinduet.

Den lille knap med navnet "R" vil genindstille til default tegn.

Billede vist i halftone mode. <H> radio knappen var valgt:


         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  

Samme i flerfarve mode. <M> radio knappen var valgt:

         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     

Samme i sort/hvid mode. <B> radio knappen var valgt:

         __________.                                    
       __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     

Instillinger i baggrundsbilledet:

Du kan ndre font og font strrelse i baggrundsbilledet lige som font i
"lav ascii tekst" asnittet i denne readme fil.
(jeg tror du skal vlge en fast font som f.eks. courier)

For at justere halvtone tegn strengen:

Manuelt - tegn 16 tegn ind i tekstboksen
Automatisk - Tryk <Pref> knappen.
             Vlg font navn og atrributter, hvorefter en halvtone streng
             vil komme i tekstboksen. Efterlad 16 tegn og tryk <Go>.

----------------------------------------------------------------------------
5. Distribution
----------------------------------------------------------------------------
Du er velkommen til at bruge denne applikation, bde kommercielt og privat.

Denne software leveres "som den er" uden nogen form for garanti - hverken
udtrykkelig eller underforstet. Programmren vil ikke under nogen 
omstndigheder vre ansvarlig for nogen skade der opstr efter brug af
dette program.

----------------------------------------------------------------------------
7. Hvordan kan du hjlpe
----------------------------------------------------------------------------

Hvis du kan lide programmet og du vil hjlpe med med mit arbejde kan du
(men du behver ikke) sttte mig p fire forskellige mder:

1. Send mig et email hvor du fortller hvad der er godt - og forkert - og
   hvad du kunne tnke dig at se i BG_ASCII

2. G til http://mazaika.tripod.com og klik p mine sponsores reklamer.

3. Send mig et billede postkort som hilsen

4. Send mig et postkort med et par dollar - 1, 2, 5... ;)

Min postadresse er:

My post address:

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
