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