comparison README.txt @ 2030:2b961e6b35e5

Update documentation etc.
author Matti Hamalainen <ccr@tnsp.org>
date Thu, 08 Nov 2018 11:45:13 +0200
parents 73c513f536d0
children 05532d716f50
comparison
equal deleted inserted replaced
2029:5ecd51009072 2030:2b961e6b35e5
262 - The assembler include file will be "output.inc" in this case. 262 - The assembler include file will be "output.inc" in this case.
263 263
264 264
265 Single color C64 char font to PNG image conversion: 265 Single color C64 char font to PNG image conversion:
266 266
267 $ gfxconv chars1.fnt -i chr:sc -s 2 -S 4 -c 255,1 -n 256 -o chars1.png 267 $ gfxconv chars1.fnt -i chr:sc -s 2 -S 4 -m 255,1 -n 256 -o chars1.png
268 268
269 - Input file is "chars1.fnt" 269 - Input file is "chars1.fnt"
270 - "-i chr:sc" specifies that input is interpreted as single color chars. 270 - "-i chr:sc" specifies that input is interpreted as single color chars.
271 - "-s 2" skips first two bytes of the input file (loading address) 271 - "-s 2" skips first two bytes of the input file (loading address)
272 - "-S 4" scales output image to be 5 times larger 272 - "-S 4" scales output image to be 5 times larger
273 - "-c 255,1" defines background color (bit value 0) to be transparent 273 - "-m 255,1" defines background color (bit value 0) to be transparent
274 (255, only works for PNG) and foreground to be C64 color 1 (white) 274 (255, only works for PNG) and foreground to be C64 color 1 (white)
275 - "-n 256" specifies that up to 256 items (characters) worth of data 275 - "-n 256" specifies that up to 256 items (characters) worth of data
276 from input will be processed. 276 from input will be processed.
277 277
278 By default the output image will be "vertical", e.g. each character will 278 By default the output image will be "vertical", e.g. each character will
282 282
283 283
284 Extract sprites from a C64 memory dump, convert to PNG: 284 Extract sprites from a C64 memory dump, convert to PNG:
285 285
286 $ gfxconv bub_dump.raw -i spr:mc -s 0x5800 -n 20 -f png -o bub \ 286 $ gfxconv bub_dump.raw -i spr:mc -s 0x5800 -n 20 -f png -o bub \
287 -q -S 3 -c 255:2:5:1 287 -q -S 3 -m 255:2:5:1
288 288
289 - Input file "bub_dump.raw" is a raw memory dump of Bubble Bobble 289 - Input file "bub_dump.raw" is a raw memory dump of Bubble Bobble
290 extracted via VICE in game running mode. 290 extracted via VICE in game running mode.
291 - "-i spr:mc" sets input to be interpreted as multicolor sprite data 291 - "-i spr:mc" sets input to be interpreted as multicolor sprite data
292 - "-s 0x5800" skips 0x5800 bytes, basically the memory address as the 292 - "-s 0x5800" skips 0x5800 bytes, basically the memory address as the
294 - "-n 20" sets max item count to 20, so 20 sprites will be dumped. 294 - "-n 20" sets max item count to 20, so 20 sprites will be dumped.
295 - "-f png" sets output format to PNG, required because next option 295 - "-f png" sets output format to PNG, required because next option
296 does not specify a filename extension. 296 does not specify a filename extension.
297 - "-o bub" sets filename prefix to "bub" 297 - "-o bub" sets filename prefix to "bub"
298 - "-q" selects sequential output (separate files) 298 - "-q" selects sequential output (separate files)
299 - "-c 255:2:5:1" sets the multicolor color mappings 299 - "-m 255:2:5:1" sets the multicolor color mappings
300 (255 is the transparency color again) 300 (255 is the transparency color again)
301 301
302 302
303 Dump ANSI colour ASCII output of the same dump file as above: 303 Dump ANSI colour ASCII output of the same dump file as above:
304 304