Apple-2gs-SW/iigs-game-engine
1
0
Fork 0
mirror of https://github.com/lscharen/iigs-game-engine.git synced 2024-12-27 11:30:10 +00:00
Code Issues Projects Releases Wiki Activity
A tile-based game engine for the Apple IIgs written in 65816 asssembly language
463 Commits 5 Branches 1 Tag 36 MiB
Assembly 90.9%
JavaScript 7.6%
C 1.1%
Python 0.3%
536959619f
Go to file
Lucas Scharenbroich 536959619f Refine the horizontal dispatch 
Find small optimizations to improve the average performance of the
blitter, especially in the odd-aligned case.

 - Odd-aligned PEA exit is 2 cycles faster per line
 - Odd-aligned JMP exit is 2 cycles faster per line
 - Odd-aligned LDA exit is 6 cycles faster (eliminated long store)
 - Merged setting the entry opcode and offset to convert 2 8-bit
   store into a single 16-bit store (save 6 cycles per line)
 - Load and save the full word for the high bytes. Cost 2 cycles
   but enabled the 6 cycles saved for the LDA case.
2023-03-07 17:32:46 -06: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 Update some demos to match new behaviors 2023-03-06 14:39:38 -06:00
docs Doc updates 2023-03-06 15:14:22 -06:00
emu Final reorg; all projects build into a unified disk image for testing 2021-08-26 17:15:44 -05:00
macros Transition to fixed snippets 2023-03-02 23:24:03 -06:00
ORCACDefs Functional compiled sprites in demo-5 2023-03-01 13:18:37 -06:00
ref Reorg files; focus on S16 artifact 2021-03-21 21:59:54 -05:00
src Refine the horizontal dispatch 2023-03-07 17:32:46 -06:00
tools Checkpoint 2023-03-06 14:57:52 -06:00
_FileInformation.txt checkpoint 2023-01-02 11:04:26 -06:00
.gitignore Checkpoint with TF4 demo framework 2022-08-11 14:14:25 -05:00
build-image.bat Fix path to tool when building at the top-level 2022-07-24 21:20:33 -05:00
package-lock.json Save package lock 2022-07-23 16:32:17 -05:00
package.json Add additional npm script targets 2022-07-24 21:20:54 -05:00
README.md Add link to merlin32 1.1.10 2022-07-30 11:07:03 -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

  • node
  • merlin32 (1.1.10+)
  • cadius

GTE uses the merlin32 1.1.10 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.

References