1
0
mirror of https://github.com/fadden/6502bench.git synced 2024-09-10 13:54:52 +00:00
6502bench/docs/sgmanual
Andy McFadden 4e5c34f457 Binary includes
This adds a new data format option, "binary include", that takes a
filename operand.  When assembly sources are generated, the section
of file is replaced with an appropriate pseudo-op, and binary files
are generated that hold the file contents.  This is a convenient way
to remove large binary blobs, such as music or sound samples, that
aren't useful to have in text form in the sources.

Partial pathnames are allowed, so you can output a sound blob to
"sounds/blather.bin".  For safety reasons, we don't allow the files
to be created above the project directory, and existing files will
only be overwritten if they have a matching length (so you don't
accidentally stomp on your project file).

The files are not currently shown in the GenAsm dialog, which lets
you see a preview of the generated sources.  The hex dump tool
can do this for the (presumably rare) situations where it's useful.

A new regression test, 20300-binary-include, has been added.  The
pseudo-op name can be overridden on-screen in the settings.

We don't currently do anything new for text/HTML exports.  It might
be useful to generate an optional appendix with a hex dump of the
excised sections.

(issue #144)
2024-05-31 14:22:39 -07:00
..
advanced.html Address region isolation, part 3 (of 3) 2024-05-21 14:14:32 -07:00
analysis.html Update reference manual formatting 2021-10-18 17:56:08 -07:00
codegen.html Make label files look more like cc65 output 2024-04-22 15:09:23 -07:00
editors.html Binary includes 2024-05-31 14:22:39 -07:00
end-notes.html Update reference manual formatting 2021-10-18 17:56:08 -07:00
index.html Make label files look more like cc65 output 2024-04-22 15:09:23 -07:00
intro-details.html Minor tweaks 2024-05-22 14:02:53 -07:00
intro.html Update reference manual formatting 2021-10-18 17:56:08 -07:00
main.css Update reference manual formatting 2021-10-18 17:56:08 -07:00
mainwin.html Tweak address region edit dialog 2021-10-20 09:06:53 -07:00
settings.html Document new label placement setting 2024-04-22 17:35:21 -07:00
tools.html Update reference manual formatting 2021-10-18 17:56:08 -07:00
tutorials.html Update reference manual formatting 2021-10-18 17:56:08 -07:00
visualization.html Expand C64 sprite visualizer 2022-05-01 11:09:41 -07:00