mirror of https://github.com/lscharen/iigs-game-engine.git synced 2024-12-27 11:30:10 +00:00

A tile-based game engine for the Apple IIgs written in 65816 asssembly language

Go to file

Lucas Scharenbroich 3063ab88f9 Fix sprite stamp rendering for 8x16 and 16x8 sprites		2022-07-21 22:51:25 -05:00
.github/images	Start adding some basic documentation on building from source	2022-02-24 21:54:11 -06:00
.vscode	Update skeleon to show a pictire on-screen	2020-08-19 00:35:30 -05:00
archive	Add an archive of the old GTE sources	2018-07-30 23:23:05 -05:00
demos	Demo 9	2022-07-21 20:29:55 -05:00
docs	Add initial documentation for all remaining stable toolbox calls	2022-07-04 20:52:28 -05:00
emu	Final reorg; all projects build into a unified disk image for testing	2021-08-26 17:15:44 -05:00
macros	Fix issues preventing BG1 per-line offsets from working	2022-07-16 16:42:41 -05:00
ref	Reorg files; focus on S16 artifact	2021-03-21 21:59:54 -05:00
src	Fix sprite stamp rendering for 8x16 and 16x8 sprites	2022-07-21 22:51:25 -05:00
tools	Demo 5 complete	2022-07-21 20:26:46 -05:00
_FileInformation.txt	Local cleanup	2022-06-09 07:36:40 -05:00
.gitignore	Local cleanup	2022-06-09 07:36:40 -05:00
build-image.bat	Refactor to support building a tool and new demo to try and use it [not working]	2022-04-23 00:47:13 -05:00
package.json	More jekyll work	2022-06-27 20:33:34 -05:00
README.md	Move documentation to the github pages location.	2022-07-04 20:56:37 -05:00

README.md

Generic Tile Engine for the Apple IIgs

A high-performance library for writing tile-based games for the Apple IIgs personal computer in 65816 assembly langugage. Unlock the full, 16-bit potential of the last machine of the Apple ][ line.

Introduction

The Generic Tile Engine (GTE) project is a tile engine built to exploit the unique hardware capabilities of the Apple IIgs personal computer. It supports the Apple IIgs super hires graphics mode (320x200, 16/256 colors) and provides two full-screen independent scrolling layers along with software sprites. The API and core functionality of the library is inspired by the graphics hardware of the NES/SMS/SNES/Genesis console era.

Parallax scrolling of two full-screen static layers

Building from Source

The library iscurrently implemented as a set of source files that must be compiled into a GS/OS application. A set of example project can be found under the demos folder. Each demo folder uses a package.json file to define the build targets and a build of each application can be created by executing a npm run build command.

Each demo application has a build script that also builds the toolset and copies it, along with the demo S16 application file, to the target disk image.

Dependencies

GTE uses the merlin32 assembler to compile its source into GS/OS OMF files and Cadius to copy those files onto a ProDOS disk image. The paths to these tool can be set in the package.json file.

An empty 2MG disk image is included in emu/Target.2mg and is used as the default location for copying demo applications. This image can be mounted in any IIgs emulator.

Build of demo app in the IIgs Finder

Documentation

Please refer to the GTE Toolbox documentation.