isle-portable/README.md
Christian Semmler f51b1867ee
Some checks are pending
Build / Current msys2 mingw32 (push) Waiting to run
Build / Current msys2 mingw64 (push) Waiting to run
Build / Current MSVC (32-bit) (push) Waiting to run
Build / Current MSVC (64-bit) (push) Waiting to run
Format / C++ (push) Waiting to run
Naming / C++ (push) Waiting to run
Use SDL3 for filesystem access (#36)
* Use SDL IOStream in for MXIOINFO

* Use SDL IOStream for WDB file

* Use SDL IOStream for LegoStorage

* Update README.md

* Fixes

* Add names to skip.yml

* Add #include <stdio.h> where necessary
2024-12-16 22:25:52 +01:00

4.4 KiB

LEGO Island, portable

Development Vlog | Contributing | Matrix | Forums | Patreon

This initiative is a work-in-progress portable version of LEGO Island (Version 1.1, English) based on the decompilation project. Our primary goal is to transform the codebase to achieve platform independence, thereby enhancing compatibility across various systems while preserving the original game's experience as faithfully as possible.

Please note: this project is dedicated to achieving platform independence without altering the core gameplay, adding new features, enhancing visual quality, or rewriting code for improvement's sake. While those are worthwhile objectives, they are not within the scope of this project.

Status

Supported platforms

Platform Implementation status
Windows
Linux
macOS

Library substitutions

To achieve our goal of platform independence, we need to replace any Windows-only libraries with platform-independent alternatives. This ensures that our codebase remains versatile and compatible across various systems. The following table serves as an overview of major libraries / subsystems and their chosen replacements. For any significant changes or additions, it's recommended to discuss them with the team on the Matrix chat first to ensure consistency and alignment with our project's objectives.

Library/subsystem Substitution Status
Window, Events SDL3 WIP Remarks
Windows Registry (Configuration) libiniparser Remarks
Filesystem SDL3 Remarks
Threads, Mutexes (Synchronization) SDL3 Remarks
Keyboard/Mouse, DirectInput (Input) SDL3 Remarks
Joystick/Gamepad, DirectInput (Input) SDL3 Remarks
WinMM, DirectSound (Audio) SDL3, miniaudio Remarks
DirectDraw (2D video) SDL3 Remarks
Smacker libsmacker Remarks
Direct3D (3D video) SDL3, OpenGL ES (TBD) Remarks
Direct3D Retained Mode Custom re-implementation (TBD) Remarks
SmartHeap Default memory allocator - -

Building

This project uses the CMake build system, which allows for a high degree of versatility regarding compilers and development environments. Please refer to the GitHub action for guidance.

Contributing

If you're interested in helping or contributing to this project, check out the CONTRIBUTING page.