Sevgi Engine
************
Sevgi Engine is a new open source video game engine for classic Amiga computers
which provides the required tools and generates the boilerplate code to create
high performing Amiga games using only the C programming language. It is built
around the great ScrollingTricks by Georg Steger.

Features
********
* Performance
  All display algorithms aim to perform at a locked 50fps on a single buffered
  native Amiga chipset display. It implements an optimized version of the
  algorithm Scroller_XYUnlimited2_64 from ScrollingTricks. Benefits highly from
  Fast Ram where available.
* System friendly
  Aims to work on all ROM versions (2.0+) providing a clean quit back to OS
  without needing WHDLoad.
* AGA Support
  Supports all features provided by the AGA chipset.
* No limitations
  Designed to support all the well known visual tricks known by the popula
  Amiga video game titles while not limiting more experimental effects to be
  implemented.
* Easy development
  A native editor program is provided to generate code, manage game assets, edit
  color palettes etc. called Sevgi Editor. Other elements like game logic,
  animation and events require programming knowledge in C. The programming and
  compiling can be made natively (on the Amiga OS - using native compilers) or
  cross platfrom (on Windows or Linux PCs - using cross development tools).
  Sevgi Editor can import game maps made in Tiled (https://www.mapeditor.org/).
* Templates
  Generates ready to compile and run game code from template genres which aims
  to ease bootstrapping. The templates include test assets.
* ptplayer
  Implements the great ptplayer by Frank Wille for music and audio effects.
* No third party dependencies
  The game executable will not require any libraries(1)
* Documentation
  The engine code is very well commented and documented in detail in Amigaguide
  format.

(1): Except diskfont.library. And even that is avoidable if you do not use any
     Amiga font asset.

Sevgi Editor
************
Sevgi Engine code and template assets are generated using the provided editor
called Sevgi Editor.

Requirements
************
* ECS or AGA Amiga
* Kickstart 2.0+
* MUI 3.8 (for Sevgi Editor)

Build
*****
Sevgi Engine code is suitable to be compiled with any Amiga compiler. Makefiles
for SAS/C and gcc are provided and these compilers are tested to work. It
includes and uses SDI_headers, so (hopefully) it is compiler agnostic.

Templates
*********
Sevgi Editor comes with some ready to compile and run game templates from
different genres which demonstrates its features using some free assets.

Licences
********
Sevgi Engine and Sevgi Editor is under MIT Licence. Meaning you can use it in
whatever project you want as long as you include the original copyright and
license notice.
ptplayer is public domain under The Unlicence licence.

Future Plans
************
Sevgi Engine is still a work in progress. Some new features planned are:
* Support for different level display implementations (i.e double buffering,
  split screen etc.)
* More graphical effects
* A native tilemap and gameobject editor
* Functions for UI elements
* More templates for different game genres

Contributions
*************
The source codes for Sevgi Engine and Sevgi Editor can be found at:
https://github.com/alpyre/Sevgi_Engine

If you make use of Sevgi Engine and find shortcomings, contributions like
feature requests, bug reports or even pull requests will be highly appreciated.

--------------------------------------------------------------------------------
  HISTORY:

  v0.177 (2025-05-30)
  - Re-implement all file copy routines used in new project creation
  - Add a toolbar button to compile projects directly from Sevgi Editor
  - Add a toolbar button to run projects directly from Sevgi Editor
  - Popup the Editor Settings window at first run
  - Fix labels in Sevgi Editor according to Amiga User Interface Style Guide

  v0.176 (2025-05-26)
  - Fix file system errors on new project creation
  - Fix broken links in the documentation

  v0.175 (2025-05-21)
  - Initial release

 PERMSSN    UID  GID    PACKED    SIZE  RATIO METHOD CRC     STAMP          NAME
---------- ----------- ------- ------- ------ ---------- ------------ -------------
[Amiga]                   1811    2254  80.3% -lh5- d282 May 21 15:08 Sevgi_Engine.info
[Amiga]                    723    2567  28.2% -lh5- e6ce May 15 10:10 Sevgi_Engine/Code/anims.c
[Amiga]                    264     505  52.3% -lh5- 15c4 May 15 09:52 Sevgi_Engine/Code/anims.h
---------- ----------- ------- ------- ------ ---------- ------------ -------------
 Total         3 files    2798    5326  52.5%            May 30 00:04