6502 code generator for sprites, fonts, images and more
Go to file
2018-07-23 13:15:27 -07:00
transposed_font_comparison Added build products for font comparison test 2018-07-23 12:52:43 -07:00
.gitignore Added support for the color white 2016-12-21 14:03:28 -08:00
apple-sprite9x11.png WIP for multiple sprites 2017-06-25 08:29:10 -07:00
apple-sprite15x15.png Initial code fork to new repository from Quinn's HiSprite 2017-07-17 10:59:00 -07:00
asmgen.py Changed shbang line to use /usr/bin/env to find the python interpreter 2018-07-23 12:18:14 -07:00
bwtest.s WIP for multiple sprites 2017-06-25 08:29:10 -07:00
colortest.s Added simple movement for sprite 2017-06-22 11:17:31 -07:00
cpbg.s Removed debug background stuff (unnecessary now that lots more is working) 2017-07-09 21:19:06 -07:00
drawfont.s Font demo program comparing my transposed font character generator to standard type character generators 2017-09-20 09:55:27 -07:00
fatfont128.dat fatfont: fixed 0 and 1 for consistency 2017-07-06 22:22:33 -07:00
fatfont.s Added fast font demo 2017-07-04 13:36:36 -07:00
fonttest.s Font demo program comparing my transposed font character generator to standard type character generators 2017-09-20 09:55:27 -07:00
LICENSE Initial code fork to new repository from Quinn's HiSprite 2017-07-17 10:59:00 -07:00
LICENSE.generated_code Initial code fork to new repository from Quinn's HiSprite 2017-07-17 10:59:00 -07:00
Makefile Font demo program comparing my transposed font character generator to standard type character generators 2017-09-20 09:55:27 -07:00
moldy_burger.png Made color selection in PNGs a little more forgiving 2017-06-30 14:13:42 -07:00
multitest.s Fixed push/pull framework. Works on page1 2017-07-03 07:54:40 -07:00
README.rst Updated to version 2.0, dropping support for python 2 2018-07-01 21:26:04 -07:00
setup.py Updated to version 2.0, dropping support for python 2 2018-07-01 21:26:04 -07:00
slowfont.s Font demo program comparing my transposed font character generator to standard type character generators 2017-09-20 09:55:27 -07:00
transposed_font_description.pdf Added generated PDF product 2018-07-23 13:15:27 -07:00
transposed_font_description.svg Added URL for asmgen 2018-07-23 13:15:10 -07:00

===========
AsmGen
===========



Abstract
========

AsmGen - code generator for sprites, fonts, and images for Apple ][ hi-res and
Atari 8-bit computers

This program creates 6502 (or 65c02) code for several tasks, including a sprite
complier (based on `HiSprite <https://github.com/blondie7575/HiSprite>`_) that
hardcodes sprite data in unrolled loops for each shifted shape. By removing
image lookups and loops, sprites can be drawn much faster than otherwise
possible.

Other utilities include generating code for reporting screen damage, a fast
bitmap font renderer, and generation for all the row/column lookup tables for
each supported bitmap mode.


Installing From Source
======================

The autogenerator code is written in Python and should run on any platform
that can use python

Prerequisites
-------------

* python 3.6 (and above)
* numpy
* pypng

Starting with version 2.0, python 2 support has been dropped.

Fork me!
========

The source is free and open, and lives on `github
<https://github.com/robmcmullen/asmgen>`_, so clone and enhance at will!


History
=======

This program started life as a friendly fork of Quinn Dunki's `HiSprite
<https://github.com/blondie7575/HiSprite>`_ that she presented at KansasFest
2017.

Her conclusion was that it was not that practical for the Apple II because of
the limited memory and the number of sprite shifts needed. I wanted to port
this to the Atari because it would require fewer shifted shapes in most of the
graphics modes (e.g. only 4 shifted shapes for the commonly used ANTIC modes 13
and 14) She told me that she was unlikely to continue work on sprite compiling
but encouraged me to continue development.


Additional Credits
==================

The sample font is modified from Michael Pohoreski's `excellent tutorial on
Apple II fonts <https://github.com/Michaelangel007/apple2_hgr_font_tutorial>`_.


Disclaimer
==========

AsmGen, the 6502 code generator sponsored by the Player/Missile Podcast
Copyright (c) 2017-2018 Rob McMullen

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License along
with this program; if not, write to the Free Software Foundation, Inc.,
51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.


Generated Code License
----------------------

While the code for AsmGen itself is licensed under the GPLv3, the code it
produces is licensed under the the Creative Commons Attribution 4.0
International (CC BY 4.0), so you are free to use the generated code for
commercial or non-commercial purposes.