/pvsneslib

PVSnesLib : A small, open and free development kit for the Nintendo SNES

Primary LanguageC

A library to code in C or ASM for the Nintendo SNES

PVSneslib V4.0.2 (February,02,2023)

PVSnesLib (Programmer Valuable Snes Library) is an open and free library to develop programs for the Nintendo SNES using the C programming language.

Created initially for the 20th birthday of the Nintendo SNES (2012) and based on Ulrich Hecht SDK, it has been evolved a lot and is now mainly coded in assembler for performances reasons. It is also directly usable in asm for those who do not want to use C language but without rewriting everything from scratch.

It contains a snes-sdk compiler / linker and a library (sources included) which offer facilities to use backgrounds / sprites / pads / music & sound on the Nintendo SNES system. It also contains examples which demonstrate how to use the functions in the library.

Installation

PVSNESLIB Windows32 Release PVSNESLIB Linux32 Release

To install the library, please download the latest release or with the link below and follow instructions on the Wiki pages.

You can also see the documentation generated from sources.

Visual Studio Code

You can find a Visual Studio Code template in the vscode-template folder to help PVSnesLib integration with it.

Build status

PVSNESLIB Build and Package

You can find with the link below the last stable builds of PVSnesLib. They are development builds, you can have bugs not yet resolved with them.

Dependencies

PVSnesLib works on Windows and Linux systems. Due to technical constraints, it is available for now on 32 bits system only.

To use it, you will need at least :

  • a unix-like environment like msys if you work on Windows
  • python 3 installed and available in your path environment variable (accessible with the python command)

If you want to compile the whole project, please see this wiki page to get all required dependencies.

Contribution

GitHub project

To discuss about the library, your project or to request help, join us on Discord.

PVSneslib and affiliated tools are distributed under the MIT license (see pvsneslib_license.txt file).

Support PVSneslib

PVSneslib is free but you can donate to support its development:
Paypal

Powered by PVSneslib

These projects are based on PVSnesLib (non-exhaustive list):

alt text

Yo-Yo Shuriken by Dr. Ludos

alt text

Eyra by Second Dimension

alt text

Sydney Hunter by CollectorVision

Special thanks

-RetroAntho (https://github.com/RetroAntho) for his great help to move wla-dx to last version and also for all compilation optimizations in Makefile, snes_rules and, at least, for keeping me motivated to update PVSnesLib ;)
-Ulrich Hecht for SNES C SDK: http://code.google.com/p/snes-sdk/
-Byuu for bass - assembler with SPC700 support: http://byuu.org/programming/
-Mic_ for 816-tcc, sixpack, optimore, constify: http://jiggawatt.org/badc0de/sixpack/ and http://jiggawatt.org/optimore-816r2.zip
-Neviksti for pcx2snes
-Shiru for snesbmp idea & sound tools: http://shiru.untergrund.net/
-Mukunda for smconv tool: http://snes.mukunda.com/
-RedBug for constify tcc bug fix and tips for Linux and Docker
-mills32 (https://github.com/mills32) for his mode7 3D example
-n_Arno for his help on Linux version (https://github.com/nArnoSNES/)
-kobenairb for python & docker optimizations

Thanks !