pixelperfectengine 0.10.0-beta.4

A 2D game engine for retro styled games


To use this package, run the following command in your project's root directory:

Manual usage
Put the following dependency into your project's dependences section:

PixelPerfectEngine ver 0.10-beta

A retro engine for 2D and pseudo-3D games written in D by László Szerémi.

Started out as a project for college, and continued as a hobby to learn game and software development. Has its own GUI subsystem, which is influenced by the looks of old graphical operating systems' (Amiga Workbench, old MacOS, etc.).

Why use PixelPerfectEngine over the competition?

Authentic pixel graphics

I was looking for a project idea to present something for Object-Oriented Programming exams, that whould be doable by a single person, yet fun enough to keep me occupied to work on it. While I underestimated the complexity and the work that should go into an engine (especially as a rookie), I noticed a few odd things about 2D retro games. As modern engines often use 3D polygons for sprites, there are often many errors:

  • Rounding errors from floating-point coordinates.
  • Unauthentic scaling and rotation effects due to direct rendering on high-resolution framebuffers.
  • Ability of use of sprites and textures with baked-in big pixels, which lead to misaligned pixels.

In order to mitigate these issues, the engine uses CPU or GPU (coming in the future) blitter, like some old systems did back in the days, such as the Amiga. However the engine also can do some of the tricks of later 2D machines like per-index transparency, and you can create various effects like light, fog, and reflections, by using custom layers or even the EffectLayer (coming in the future). You also don't need any trickery for palette-swap effects.

Small footprint and lightweight

Some other, popular engines used for 2D retro games are 3D engines that are made to display 2D graphics instead. This often adds additional bulk onto an otherwise small game.

This lightweight nature of the engine will soon enable to be compiled for low-powered ARMv8 devices, which will allow to be run on many smartphones and even single-board computers.

Open-source without the hassle

This engine is licensed under the Boost Software License 1.0, which means it can be used without attribution and even in commercial applications. Be aware that many components are on different licenses, such as SDL2 and ZLib.

How to build

PixelPerfectEngine actually requires ldc2 to build since that has better vector support than DMD, and vectors are used to speed up the rendering.

To compile windowmakerforconcrete, launch a simple :

dub build :windowmakerforconcrete --compiler=ldc2

Test cases, demos, and tools

PixelPerfectEngine comes with multiple test cases, both to test various functionalities during development, and to showcase the capabilities of the engine.

test0

Displays an automatically generated tilemap pattern on two layers (one is transformable) and multiple sprites (art by arkark3). There's also a semi transparent text-layer displaying the framerate and collision information. This all can be controlled from the keyboard.

test1

Audio testcase. Tests audio initialization and plugins. Can play music by including an plugin-configuration file and MIDI files. Due to lack of MIDI 2.0 compatible file formats, it only plays MIDI 1.0 files.

test2

Map format testcase. Tests most functionality of the Extendible Map Format (XMF). Can load any XMP files.

test3

GUI elements testcase. Tests if GUI elements work correctly.

wallbreaker

Arkanoid-clone game. Currently under development.

Windowmaker for Concrete/PPE

Window layout editor with code generation features.

Features

  • Pixel-accurate retro graphics.
  • Either hard-transparency using blitter, or soft-transparency using alpha-blending.
  • Various effects with other composing functions.
  • A tile layer that is capable of displaying uniform tiles from a map, and has per-line scrolling via a delegate.
  • A transformable tile layer capable of Mode7 type effects at the cost of power-of-two only tile and map sizes.
  • A sprite layer with sprite scaling, simple slicing, and individual composing functions for each sprite.
  • GUI
  • Configuration file handling
  • Collision detection
  • Handling of multiple inputs
  • An audio subsystem capable of era-correct synthesis
  • ...and many more

Known issues:

  • The engine doesn't clear the framebuffer to spare some CPU time. This can result in rapid flickering if the bottom layer is scrolled out. To avoid it at all cost, you can use a warp mode on that layer.
  • There's also some speed issues as SDL2 writes the framebuffer back to the main memory. This will probably end up in the slow replacement of SDL2's graphical side with something faster.
  • WindowMakerForConcrete and PixelPerfectEditor are currently unfinished. The former will be soon working fully with extra features (such as undo/redo, snapping to grid and components), then the latter can be developed without an issue.
  • Error handling isn't fully realized, so a lot of errors might happen. You can help me by reporting errors, testing on various systems.

Future plans:

  • Hardware acceleration, possibly through OpenCL since GLSL lacks the ability of reading textures as integers in older versions.
  • Adding support for scripting languages (QScript, Lua, Python, BASIC, etc).
  • Compressed data file handling.
Authors:
  • Laszlo Szeremi
Sub packages:
pixelperfectengine:test0, pixelperfectengine:test1, pixelperfectengine:test3, pixelperfectengine:windowmakerforconcrete, pixelperfectengine:wallbreaker
Dependencies:
collections-d, sdlang-d, midi-di, dimage, midi2, cpublit, bitleveld, undead, bmfont, bindbc-sdl, intel-intrinsics
Versions:
0.11.0-beta 2024-Aug-17
0.11.0-alpha.5 2024-May-25
0.11.0-alpha.4 2024-Apr-05
0.11.0-alpha.3 2024-Mar-31
0.11.0-alpha.2 2024-Feb-12
Show all 47 versions
Download Stats:
  • 0 downloads today

  • 0 downloads this week

  • 0 downloads this month

  • 240 downloads total

Score:
2.2
Short URL:
pixelperfectengine.dub.pm