Reference : Text-art Applet



1.) Parameter (HTML)

Name: Value: Range: Default: Info.:
"loop" Integer 0-max - 0 = loop endless
"color" (String) : RGB 000-999 - more info's
"font size" Integer 1-max 12  
"font name" (String) (depends from os) Courier  
"copyright" - "Meph. is a alien" -  
"data" String - -  


Example:
<applet code="textart.class" width=350 height=380>
<param name=loop value="0">
<param name=color value="000">
<param name=fontsize value=8>
<param name=fontname value="Courier">
<param name=copyright value="Meph. is a alien">
<param name=data value="...

All values except from font size & font name must be set.




2.) Data format ("data-parameter")

NOTE: This version didn't support the reading from a extern file. Therefore the it is not allowed to use strings or characters (")  in the "data-parameter" which are interpreted as HTML.

2.1 ANSI related tags:

x,y := Integer
§   := Start control Sequence
;   := Separator
§x;yH (or §x;yf) Set cursor position to X(column),Y(row)
§yA Move cursor y rows up
§yB Move cursor y rows down
§xC Move cursor x columns right
§xD Move cursor y columns left
§s Save actual cursor position
§u Load cursorposition
§2J Clear Screen, go to position (0,0)
§K Delete row beginning form the actual position
§k Delete col. beginning form the actual position
[ §xm or §x;ym] THIS TAG IS NO LONGER NEEDED. IT IS ONLY A "TRIBUT" TO THE ANSI.SYS.
Set color to x (font or background)
-> max. 2 values allowed
-> text attributes not supported
-> font colors 30-37
-> background colors 40-47

 

2.2 New tags:

x,y := Integer
§   := Start control sequence
;   := Separator
§xxxf Set font color: RGB value
1.) X := red   percentage (0-9)
2.) X := green percentage (0-9)
3.) X := blue  percentage (0-9)


Example :
§000f -> White §900f -> red
§999f -> Black §090f -> green
§444f -> Grey §009f -> blue
§xxxF Set background color: RGB value (see above)
§q Random font color
§Q Random background color
§xr Go to random column (x = range)
§xR Go to random row (x = range)
§xi (or §i) Font style
1.) X := 1 -> italic
2.) X := 2 -> bold
3.) other  -> plain text
§xz Speed (delay after every input (!) character)
x := range (0-max)

Example: 2000 millisec. Pause
§2000z§0z
§xx Repeat character: (RLE)
Draws the first character after the tag x times in the actual row.

Example:
tag   : §5x-
output: -----
§xX Repeat character: (RLE)
Draws the first character after the tag x times in the actual column.

Example:
tag   : §2x|
output: |

        |
§x;yL Jump back in data string: (Repeat)
Jumps x characters back in the data string for y times.

Example:
tag:...§K§k§1B§1C§17;48L
pos:   12345678901234567

       |_______________|
  (repeat this block 48 times)
Note:
-> Make sure that you don't jump in
   another tag.
-> mostly only relative cursor
   settings in the repetition block
   are meaningful.


3.) General Information:

3.1 The canvas:

(x,y) := (column X, row y)

There is no high or width restriction of the canvas. If a character is in the visible area depends from the 'width' and 'high' value in the HTML applet tag.


      (0,0)
       +----------------------------->
       | (1,1)       Border
       |  +-------------------------->
       |  |
       |B |
       |o |         CANVAS
       |r |
       |d |
       |e |
       |r |
       |  |
       |  |
       V  V

 

3.1 The font:

You can set the font with the 'fontname' parameter in the HTML file. If the font is accepted depends from your os and JAVA. If the applet couldn't use/find the font 'Courier' is used. The applet works with a fixed font width and you can theoretically use any font for text-art. Nevertheless it is recommended to use only fixed width fonts because of the ratio aspect.

 

3.2 The colors:

The color tag with 'F' and 'f' may irritate a bit. Here is a little table with the other standard formats:

  Red Green Blue
Applet x x x
Word RGB value r := 1byte (0-255)
x := r/28.3
g := 1byte (0-255)
x := g/28.3
b := 1byte (0-255)
x := b/28.3
Hex. RGB value r := 2 digits hex. (00-FF)
x := r/1C
g := 2 digits hex. (00-FF)
x := g/1C
b := 2 digits hex. (00-FF)
x := b/1C
Percentage value r :=  [0,1]
x := r*1.1
g :=  [0,1]
x := g*1.1
b :=  [0,1]
x := b*1.1

 

3.3 Other:

File size:
The size is relative small if the '§xx', '§xX' tag is used to make a simple RLE compression.

Programs:
ASCIIEditor 4.1 will save files (compressed and uncompressed) in the applet format with the next update (1.3) . Converting ANSI files in the applet format is possible, but makes a lot of work. ANSI programs which write a not optimized code make the conversion more easy

Greetings:
Hi Joe : The extended IBM character set isn't supported - sorry (possibly in an other version)
              `-> ... in work.
Hi cjr : Seems that it is to slow for ASCII animations . . .

 

3.4 Copyright:

Free for non commercial use, no warranty or other guarantee of fitness for this software.
(c) 1999 Marc Schmitz (Meph.)

               O=============================================O
  ,,,,,,,,     I  __  __   ___   ___   _  _           _,,,_  I
.,,,  __  \_   I |M \/ M| |E__| |P_ \ | || | ASCII   / o o \ I
(    ( o)   \_ I | |\/| | | _|  |  _/ | HH | & more  >  P  < I
`\           o)I |_|  |_| |E__| |_P   |_||_| ~~~~~~  \_\_/_/ I 
  \     \____/ I                                             I
   \   ____/   I  ASCII-, ANSI-, HTML-art, programs, ...     I
    )  )       O=============================================O
\__/    \  Index page:
     \\_ ) http://studenten.freepage.de/meph/ascii/ascii.htm
\___ __ /  English "fast-link" page:
  _//  \\_ http://studenten.freepage.de/meph/ascii/eng/eng.htm

(B A C K)