File: README

package info (click to toggle)
aa3d 1.0-4
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 76 kB
  • ctags: 5
  • sloc: ansic: 93; makefile: 19
file content (162 lines) | stat: -rw-r--r-- 7,025 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
GJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJ
]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SP
ER_J]KUMS\QPER_J]KUMS\QPER_]KUMS\QPER_]KUUMS\QPER_]KUMS\QPER_]KUMSS\QPER_]KUMSS\
CQE_PSVJ^COJCQE_PSVJ^COJCQ_PSVJ^COJCQ_PSVJJ^COJCQ_PVJJ^COJCQ_PVJJ^CCOJCQ_PVJJ^CC
HTXZQDDUTZUXHTXZQDDUTZUXHXZQDDDUTZUXHXQDDDUUTZUXHXDDDUUUTZUXHXDDUUUTTZUXHXDDUUUT
EYZIHVFQ[K`CEYZIHVFQ[K`CEZIHVFFQ[K`CEZHVFFQQ[K`CEZVFFQQQ[K`CEZVFQQQ[[K`CEZVFQQQ[
EEDHYNWSMFZCEEDHYNWSMFZCEDHYNWWSMFZCEDYNWWSSMFZCEDNWWSSSMFZCEDNWSSSMMFZCEDNWSSSM
ZNFDRGB`JKZVZNFDRGB`JKZVZFDRGB`JKZVZFDRGB`JJKZVZFDGB`JJKZVZFDGB`JJKZZVZFDGB`JJKZ
NQAQLHPZQ\X`NQAQLHPZQ\X`NAQLHPZQ\X`NAQLHPZQQ\X`NAQHPZQQ\X`NAQHPZQQ\XX`NAQHPZQQ\X
VRMT^C]XN_TPVRMT^C]XN_TPVMT^C]]XN_TPVM^C]]XXN_TPVMC]]XXXN_TPVMC]XXXNN_TPVMC]XXXN
CNH^N\HYWVQMCNH^N\HYWVQMCH^N\HHYWVQMCHN\HHYYWVQMCH\HHYYYWVQMCH\HYYYWWVQMCH\HYYYW
KJ\A[RN\]WNKKJ\A[RN\]WNKK\A[RNN\]WNKK\[RNN\\]WNKK\RNN\\\]WNKK\RN\\\]]WNKK\RN\\\]
`YCILI^CE[QU`YCILI^CE[QU`YCILI^CE[QU`YCILI^CE[QU`YCILI^CE[QU`YCILI^CE[QU`YCILI^C
UBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^
E^\CLHAQBGEDE^\CLHAQBGEDE^\CHAQBGEDE^\CHHAQBGEDE^\HHAQBGEDE^\HHAQQBGEDE^\HHAQQBG
JYB_V_B`LP_RJYB_V_B`LP_RJYBV_B`LP_RJYBV_BB`LP_RJYB_BB`LP_RJYB_BB`LLP_RJYB_BB`LLP
NCLD`^KRCE[]NCLD`^KRCE[]NCLD`^KRCE[]NCD`^KRRCE[]NCD^KRRCCE[]NCDKRRCCCE[]NCDKRRCC
]L[\[Z`EFM[[]L[\[Z`EFM[[]L[\[Z`EFM[[]L\[Z`EEFM[[]L\Z`EEFFM[[]L\ZEEFFFM[[]L\ZEEFF
HTHE\JXLNQLGHTHE\JXLNQLGHTHE\XLNQLGHTHE\XLLNQLGHTHEXLLNQQLGHTHEXLNQQQLGHTHEXLNQQ
IZFRH[M[JHNKIZFRH[M[JHNKIZFRHM[JHNKIZFRHM[[JHNKIZFRM[[JHHNKIZFRM[JHHHNKIZFRM[JHH
]F^MEP][OOMT]F^MEP][OOMT]F^MEP][OOMT]FMEP][[OOMT]FMP][[OOOMT]FMP[[OOOOMT]FMP[[OO
NRT[MDN^PW]QNRT[MDN^PW]QNRT[MDN^PW]QNR[MDN^^PW]QNR[DN^^PPW]QNR[N^^PPPW]QNR[N^^PP
PB_VZWTFO\WMPB_VZWTFO\WMPB_ZWTFO\WMPB_ZWTTFO\WMPB_WTTFO\WMPB_WTTFOO\WMPB_WTTFOO\
BPZRZ[IDK_ZIBPZRZ[IDK_ZIBPZR[IDK_ZIBPZR[[IDK_ZIBPZ[[IDK_ZIBPZ[[IDDK_ZIBPZ[[IDDK_
ET_^__[\VEXJET_^__[\VEXJET_^__[\VEXJET_^__[\VEXJET_^__[\VEXJET_^__[\VEXJET_^__[\

                   aa3d - An ASCII art stereogram generator

                       "New dimension for ASCII art"

The AA-project releases a so called technology demo for its new 3D stereogram
technology (ASCII-3D-2000). It uses the well known and popular random dot
stereograms in ASCII art (try to see above example). This technology will
be soon included into mainstream AA-lib release (planned for new AA-lib 99). 
Code is completely year 2000 compliant now and unicode support is coming soon!
Separate teams are working on hardware acceleration chips to be released before
year 2000.


Features
========

 o High quality ASCII art stereogram rendering
 o Highly configurable
 o User friendly command line interface (including full online help)
 o Year 2000 compliant


Download
========

aa3d is available from:

http://prdownloads.sourceforge.net/aa-project/aa3d-1.0.tar.gz


Homepage
========

http://aa-project.sourceforge.net/aa3d/


Usage
=====

aa3d is a standalone program to convert simple text file 3D maps to a
stereogram.

The input file should look a bit like this:

                   11111111111111111111111111111111111
                   11111111111111111111111111111111111
                   11112222222222222222222222222211111
                   11112222222222222222222222222211111
                   11112222222222222222222222222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222233333333333333322222211111
                   11112222222222222222222222222211111
                   11112222222222222222222222222211111
                   11112222222222222222222222222211111
                   11111111111111111111111111111111111
                   11111111111111111111111111111111111

The result of 'aa3d < /usr/share/aa3d/pyramid' is:

GJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJN[LSGJTR`KMJ
]KMQ\\SP]UMY]KMQ\\SP]UMY]KMQ\\SPUMY]KMQ\\SPUMY]KMQ\\SPUMY]KMQ\\SPUMMY]KMQ\\SPUMM
ER_J]KUMS\QPER_J]KUMS\QPER_J]KUM\QPER_J]KUM\QPER_J]KUM\QPER_J]KUM\QQPER_J]KUM\QQ
CQE_PSVJ^COJCQE_PSVJ^COJCQE_PSVJCOJCE_PSVJCOJCE_PSVJCOJCE_PSVJJCOJCCE_PSVJJCOJCC
HTXZQDDUTZUXHTXZQDDUTZUXHTXZQDDUZUXHXZQDDUZUXHXZQDDUZUXHXZQDDUUZUXHHXZQDDUUZUXHH
EYZIHVFQ[K`CEYZIHVFQ[K`CEYZIHVFQK`CEZIHVFQK`CEZIHVFQK`CEZIHVFQQK`CEEZIHVFQQK`CEE
EEDHYNWSMFZCEEDHYNWSMFZCEEDHYNWSFZCEDHYNWFZCEDHYNWFZCEDHHYNWFZZCEDHHHYNWFZZCEDHH
ZNFDRGB`JKZVZNFDRGB`JKZVZNFDRGB`KZVZFDRGBKZVZFDRGBKZVZFDDRGBKZZVZFDDDRGBKZZVZFDD
NQAQLHPZQ\X`NQAQLHPZQ\X`NQAQLHPZ\X`NAQLHP\X`NAQLHP\X`NAQQLHP\XX`NAQQQLHP\XX`NAQQ
VRMT^C]XN_TPVRMT^C]XN_TPVRMT^C]X_TPVMT^C]_TPVMT^C]_TPVMTT^C]_TTPVMTTT^C]_TTPVMTT
CNH^N\HYWVQMCNH^N\HYWVQMCNH^N\HYVQMCH^N\HVQMCH^N\HVQMCH^^N\HVQQMCH^^^N\HVQQMCH^^
KJ\A[RN\]WNKKJ\A[RN\]WNKKJ\A[RN\WNKK\A[RNWNKK\A[RNWNKK\AA[RNWNNKK\AAA[RNWNNKK\AA
`YCILI^CE[QU`YCILI^CE[QU`YCILI^C[QU`CILI^[QU`CILI^[QU`CIILI^[QQU`CIIILI^[QQU`CII
UBIKIDP^E[ZMUBIKIDP^E[ZMUBIKIDP^[ZMUIKIDP^[ZMUIKIDP^[ZMUIKIDP^^[ZMUUIKIDP^^[ZMUU
E^\CLHAQBGEDE^\CLHAQBGEDE^\CLHAQGEDE\CLHAQGEDE\CLHAQGEDE\CLHAQQGEDEE\CLHAQQGEDEE
JYB_V_B`LP_RJYB_V_B`LP_RJYB_V_B`P_RJB_V_B`P_RJB_V_B`P_RJB_V_B``P_RJJB_V_B``P_RJJ
NCLD`^KRCE[]NCLD`^KRCE[]NCLD`^KRE[]NCLD`^KRE[]NCLD`^KRE[]NCLD`^KRE[[]NCLD`^KRE[[
]L[\[Z`EFM[[]L[\[Z`EFM[[]L[\[Z`EM[[]L[\[Z`EM[[]L[\[Z`EM[[]L[\[Z`EM[[[]L[\[Z`EM[[
HTHE\JXLNQLGHTHE\JXLNQLGHTHE\JXLNQLGHTHE\JXLNQLGHTHE\JXLNQLGHTHE\JXLNQLGHTHE\JXL

The following options are available:

-w width   The image width (80)
-s step    The size of the repeating sequence (12)
-t text    The text used to generate the background
-r         Disable random text placement
-f file    Use file as input for raster
-d         Use digits instead of letters


AA-Project
==========

                               dT8  8Tb
                              dT 8  8 Tb
                             dT  8  8  Tb
                          <PROJECT><PROJECT>
                           dT    8  8    Tb
                          dT     8  8     Tb
   
The three goals of the AA-Project:

  1. Port all important software (like Doom, Second Reality, X window
     etc.) to AA-lib.

  2. Port AA-lib to all available platforms (mainly ZX-Spectrum and
     Sharp).

  3. Force IBM to start manufacturing MDA cards again.

AA-project was started by Jan Hubicka. Back then just a few
people knew about it. Then a new demo named BB has been released to show
the power of the AA-lib technology. Now the project is freely available and
anyone can help.


Mailinglists
============

You can join any of the AA-project mailinglists here:

http://sourceforge.net/mail/?group_id=20003


AA-Project Homepage
===================

http://aa-project.sourceforge.net/

There are lots of examples of ASCII art generated by AA-lib, pointers to
other AA-project resources etc.