annotate README.txt @ 2298:b5abfff07ca9

Add new DMGrowBuf helper functions dmGrowBufCopyOffsSize() and dmGrowBufConstCopyOffsSize().
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 04 Jul 2019 10:54:16 +0300
parents 05532d716f50
children c801995cbb13
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
1 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
2
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
3 T N S P
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
4 - --==============-- -
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
5
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
6 ###### ### ## ### ### ######
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
7 # ### ## #### ### ### ### ### ## #
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
8 # # ### ## ######## ### ### ###### # #
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
9 # ### ## ### # ## ### ### ### ## #
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
10 ###### ### ## ###### ### ######
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
11
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
12 Demo engine / development and utility framework
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
13
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
14 -----------------------------------------------------------------------------
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
15
470
64f3281c7265 Update copyright notice.
Matti Hamalainen <ccr@tnsp.org>
parents: 458
diff changeset
16 Programmed and designed by Matti Hämäläinen (ccr/TNSP)
2087
05532d716f50 Bump copyright years.
Matti Hamalainen <ccr@tnsp.org>
parents: 2030
diff changeset
17 (C) Copyright 2002-2019 Tecnic Software productions (TNSP)
890
6a2a286f3d70 Remove license duplicate from README.
Matti Hamalainen <ccr@tnsp.org>
parents: 882
diff changeset
18 Please see the file "COPYING" for license.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
19
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
20 Contact
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
21 =======
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
22 IRC : ccr @ IRCNet, sometimes also Freenode
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
23 e-mail : ccr@tnsp.org
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
24
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
25
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
26 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
27
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
28
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
29 So, what is this?
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
30 =================
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
31 Basically .. a bunch of more and/or less random stuff. dmlib in
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
32 itself is a library with various things useful in demo programming.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
33 There is a resource management subsystem, functions for loading
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
34 PNG and JPEG images. Software blitted and scaled sprites, etc.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
35 Bitmap font routines. A XM module replayer.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
36
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
37 And a work-in-progress timeline-supporting demo framework, with
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
38 a Qt based GUI editor.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
39
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
40 And graphics converter and displayer for various restricted formats,
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
41 such as C64/VIC-20 characters, bitmaps, sprites, etc.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
42
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
43 .. So, yeah. There are many things in here. It's a junkyard of various
882
6c024a8f252e Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 869
diff changeset
44 demo- or such development related pieces of code and utilities. Many
6c024a8f252e Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 869
diff changeset
45 parts can be disabled during compile-time from config.mak
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
46
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
47 Most modules can be enabled or disabled, per project basis via
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
48 compile-time configuration in config.mak.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
49
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
50
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
51 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
52
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
53
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
54 Requirements
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
55 ============
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
56 The compilation and usage of these utilities requires following
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
57 software packages or functional equivalents installed:
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
58
1354
a333081090ea Documentation adjustments.
Matti Hamalainen <ccr@tnsp.org>
parents: 1277
diff changeset
59 - GCC 4.6 or later
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
60 - GNU binutils
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
61 - GNU Make
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
62 - pkg-config
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
63
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
64 You will also want these libraries:
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
65
1557
5e5f75b45f8d Initial port to SDL2. Many things will not work now.
Matti Hamalainen <ccr@tnsp.org>
parents: 1356
diff changeset
66 - libSDL 2.0
882
6c024a8f252e Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 869
diff changeset
67 - zlib
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
68 - libPNG 1.2 and development headers (more optional,
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
69 only required for PNG write and read support by some
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
70 utilities.)
1558
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
71 - SDL2_ttf for libSDL2 (optional, required for some things)
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
72 - Tremor (integer-based Ogg Vorbis decoder) + libogg
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
73
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
74 And the demo editor framework requires (but it is not yet
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
75 usable anyway, so you may as well skip these):
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
76
1558
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
77 - Qt 5.x framework libraries
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
78
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
79
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
80 For Linux -> Win32/64 cross-compilation I have used the standard
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
81 MinGW packages from Debian Testing (wheezy):
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
82
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
83 gcc-mingw-w64 mingw-w64-i686-dev mingw-w64-x86-64-dev
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
84
1558
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
85 with the additions of cross-compiled libSDL, zlib, Tremor, libogg
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
86 and libPNG. The SDL-related stuff for MinGW can be found from
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
87 libSDL's website, though some things you may need to cross-compile
48dcde220a2e Few fixes in the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1557
diff changeset
88 yourself. YMMV.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
89
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
90 Please don't ask me for help to get cross-compilation working.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
91
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
92
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
93 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
94
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
95
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
96 How to build
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
97 ============
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
98 1) $ cp config.mak.in config.mak
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
99
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
100 2) Edit config.mak to enable/disable desired options.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
101 Make sure you have the required depencies.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
102
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
103 3) $ gmake
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
104 or, if cross-compiling to Win32 via MinGW
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
105 $ gmake -f Makefile.w32
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
106
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
107 4) If it works -> Happy fun times \:D\
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
108
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
109
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
110 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
111
882
6c024a8f252e Cosmetics.
Matti Hamalainen <ccr@tnsp.org>
parents: 869
diff changeset
112
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
113 Included utilities
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
114 ==================
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
115
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
116 xm2jss
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
117 ------
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
118 Convert XM modules to internal JMOD format. You can optionally optimize the
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
119 module and even strip out various parts, such as complete instruments
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
120 (leaving only pattern data), sample data, sample instruments, etc.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
121
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
122
945
47f111643745 Viewmode utility was renamed to dumpmod, so reflect that change in the
Matti Hamalainen <ccr@tnsp.org>
parents: 890
diff changeset
123 dumpmod
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
124 -------
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
125 Simple XM/JMOD viewer. Dumps selected parts into stdout as text format data.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
126
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
127
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
128 ppl
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
129 ---
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
130 A simple XM/JMOD player with SDL-based UI.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
131
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
132
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
133 testpl
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
134 ------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
135 Even simpler player, with no UI at all. Uses SDL for audio.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
136
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
137
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
138 mod2wav
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
139 -------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
140 Render XM/JMOD modules into WAV files.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
141
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
142
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
143 packed
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
144 ------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
145 Manipulate DMPACK files. Basically a bit like ZIP archive,
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
146 for glueing resource files into a zlib-compressed blob.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
147 The dmlib resource subsystem can utilize these files.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
148
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
149 fontconv
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
150 --------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
151 Convert bitmap fonts.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
152
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
153
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
154 objlink
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
155 -------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
156 Simple, but versatile commandline utility for combining binary
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
157 files into one file. Understands 2-byte loading address PRG
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
158 style files, and raw data. "Loading addresses" can be specified
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
159 and overridden. The utility also checks for overlaps, etc.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
160
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
161
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
162 data2inc
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
163 --------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
164 Simple data file to C/ASM source converter.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
165
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
166
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
167 gfxconv
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
168 -------
450
acea24b77bdc Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 425
diff changeset
169 Utility for "dumping" and converting various graphics in plain
acea24b77bdc Update documentation a bit.
Matti Hamalainen <ccr@tnsp.org>
parents: 425
diff changeset
170 ASCII, or ANSI colored output, or into various image formats
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
171 (including PNG, PCX, PPM, IFF ILBM and RAW/ARAW files).
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
172
1794
9dced5352f70 Slight fix to the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1599
diff changeset
173 Input can also be interpreted as bitmap, sprite or character data,
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
174 in multicolor or single color. Colors can be mapped as desired.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
175 Image file output can be either single image (with chars/sprites
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
176 placed vertically if input is char/sprite data), or in separate
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
177 files.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
178
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
179 (Note: PNG support is a compile-time option)
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
180
1794
9dced5352f70 Slight fix to the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1599
diff changeset
181 64vw
9dced5352f70 Slight fix to the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1599
diff changeset
182 ----
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
183 Compiled only if libSDL support is enabled. Can be used to
1794
9dced5352f70 Slight fix to the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1599
diff changeset
184 display various C64 image file formats.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
185
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
186
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
187 -----------------------------------------------------------------------------
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
188
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
189
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
190 Examples
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
191 ========
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
192
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
193 data2inc
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
194 --------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
195 To convert a data file to a C structure using 'uint8_t' as type:
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
196
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
197 $ data2inc -C -n variable_name -t uint8_t input.bin output.h
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
198
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
199
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
200 objlink
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
201 -------
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
202 $ objlink -o intro.tmp -pppp intro.o gfx/dkdlogo2.drp:0x3800 \
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
203 muzak.prg gfx/chars_4.fnt:0x6800
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
204
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
205 - "-o intro.tmp" sets output file
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
206 - As you can see, short options can be combined, like "-pppp".
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
207 However, the next parameters must be the corresponding option
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
208 arguments, in correct order, if any.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
209 - It is possible to specify a overriding loading address via
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
210 ":<addr>" syntax. See the help for more information.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
211
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
212
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
213 gfxconv
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
214 -------
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
215
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
216 Convert IFF ILBM format image to RGBA/32bit PNG:
1356
e55426a0a010 Add another gfxconv example.
Matti Hamalainen <ccr@tnsp.org>
parents: 1354
diff changeset
217
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
218 $ gfxconv -o output.png input.lbm
1356
e55426a0a010 Add another gfxconv example.
Matti Hamalainen <ccr@tnsp.org>
parents: 1354
diff changeset
219
e55426a0a010 Add another gfxconv example.
Matti Hamalainen <ccr@tnsp.org>
parents: 1354
diff changeset
220
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
221 Convert IFF ILBM format image to indexed/paletted PNG:
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
222
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
223 $ gfxconv -o output.png input.lbm -P
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
224
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
225
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
226 Convert DrazPaint format C64 bitmap image to indexed/paletted PNG:
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
227
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
228 $ gfxconv -o output.png input.drp -P
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
229
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
230
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
231 Convert DrazPaint format C64 bitmap image to unpacked Koala Painter format:
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
232
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
233 $ gfxconv -o output.kla input.drp
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
234
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
235 NOTE: Desired output format is detected from the filename extension,
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
236 but if you wish to use "non-standard" filename(s), you can specify the
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
237 output format via option "-f", e.g. "-f kla", "-f png" etc.
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
238
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
239
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
240 Image input to C64 char font conversion:
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
241
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
242 $ gfxconv font16x16.pcx -o font16x16.chr
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
243
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
244 - Input file "font16x16.pcx" is a 2-color indexed/paletted PCX image,
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
245 containing a 16x16 pixel font.
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
246
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
247 "Chr" (.chr or "-f chr") specifies conversion to c64 char memory format,
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
248 gfxconv splits the input image to 8x8 blocks, outputting them in sequence
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
249 to the output file.
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
250
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
251
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
252 Convert input image to IFFMaster ARAW + assembler include file,
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
253 while remapping some palette entries:
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
254
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
255 $ gfxconv -R "#000000:0" -f araw -B 3 input.png -o output.raw
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
256
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
257 - "-R #000000:0" remaps all input image palette colors matching RGB
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
258 hex triplet #000000 to palette index 0.
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
259 - "-f araw" specifies output format to be IFFMaster ARAW.
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
260 - "-B 3" _clamps_ output to be 3 bitplanes. Any bits above those are
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
261 simply discarded.
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
262 - The assembler include file will be "output.inc" in this case.
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
263
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
264
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
265 Single color C64 char font to PNG image conversion:
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
266
2030
2b961e6b35e5 Update documentation etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 1936
diff changeset
267 $ gfxconv chars1.fnt -i chr:sc -s 2 -S 4 -m 255,1 -n 256 -o chars1.png
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
268
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
269 - Input file is "chars1.fnt"
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
270 - "-i chr:sc" specifies that input is interpreted as single color chars.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
271 - "-s 2" skips first two bytes of the input file (loading address)
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
272 - "-S 4" scales output image to be 5 times larger
2030
2b961e6b35e5 Update documentation etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 1936
diff changeset
273 - "-m 255,1" defines background color (bit value 0) to be transparent
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
274 (255, only works for PNG) and foreground to be C64 color 1 (white)
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
275 - "-n 256" specifies that up to 256 items (characters) worth of data
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
276 from input will be processed.
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
277
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
278 By default the output image will be "vertical", e.g. each character will
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
279 be subsequently below previous. If you specify a width via "-w <n>" option,
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
280 the output will be <n> items (characters) wide, extending down as many rows
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
281 as it will take to fill "-n 256" items.
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
282
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
283
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
284 Extract sprites from a C64 memory dump, convert to PNG:
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
285
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
286 $ gfxconv bub_dump.raw -i spr:mc -s 0x5800 -n 20 -f png -o bub \
2030
2b961e6b35e5 Update documentation etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 1936
diff changeset
287 -q -S 3 -m 255:2:5:1
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
288
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
289 - Input file "bub_dump.raw" is a raw memory dump of Bubble Bobble
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
290 extracted via VICE in game running mode.
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
291 - "-i spr:mc" sets input to be interpreted as multicolor sprite data
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
292 - "-s 0x5800" skips 0x5800 bytes, basically the memory address as the
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
293 input is a straight memory dump file.
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
294 - "-n 20" sets max item count to 20, so 20 sprites will be dumped.
1913
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
295 - "-f png" sets output format to PNG, required because next option
cdf95a4d5282 Update gfxconv documentation, and fix the various mistakes and obsolete
Matti Hamalainen <ccr@tnsp.org>
parents: 1868
diff changeset
296 does not specify a filename extension.
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
297 - "-o bub" sets filename prefix to "bub"
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
298 - "-q" selects sequential output (separate files)
2030
2b961e6b35e5 Update documentation etc.
Matti Hamalainen <ccr@tnsp.org>
parents: 1936
diff changeset
299 - "-m 255:2:5:1" sets the multicolor color mappings
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
300 (255 is the transparency color again)
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
301
491
d9c460300f23 Update documentation.
Matti Hamalainen <ccr@tnsp.org>
parents: 470
diff changeset
302
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
303 Dump ANSI colour ASCII output of the same dump file as above:
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
304
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
305 $ gfxconv bub_dump.raw -i spr:mc -s 0x5800 -n 5 -f ansi
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
306
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
307 - "-f ansi" sets output format to ANSI
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
308
1868
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
309
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
310 Dump as character data into stdout, skipping 2 bytes at start, and
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
311 limit output to 3 items (characters).
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
312
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
313 $ gfxconv chars3.fnt -i chr:sc -s 2 -n 3
4bb3d10328a9 Update gfxconv usage examples.
Matti Hamalainen <ccr@tnsp.org>
parents: 1794
diff changeset
314
425
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
315
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
316 ---- : -------------- #0
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
317 0002 : ........
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
318 0003 : ..####..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
319 0004 : .#....#.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
320 0005 : #..##..#
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
321 0006 : #.#....#
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
322 0007 : #..##..#
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
323 0008 : .#....#.
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
324 0009 : ..####..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
325 ---- : -------------- #1
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
326 000a : ........
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
327 000b : ...##...
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
328 000c : ..#..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
329 000d : ..####..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
330 000e : .##..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
331 000f : .##..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
332 0010 : .##..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
333 0011 : ........
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
334 ---- : -------------- #2
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
335 0012 : ........
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
336 0013 : ..###...
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
337 0014 : ..#..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
338 0015 : ..###...
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
339 0016 : .##..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
340 0017 : .##..#..
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
341 0018 : .####...
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
342 0019 : ........
aa5f28c2cde1 Add README.
Matti Hamalainen <ccr@tnsp.org>
parents:
diff changeset
343
862
01f2af5f87b1 Some updates in README.txt
Matti Hamalainen <ccr@tnsp.org>
parents: 805
diff changeset
344
1936
73c513f536d0 Cleanup the README.
Matti Hamalainen <ccr@tnsp.org>
parents: 1913
diff changeset
345 -----------------------------------------------------------------------------