Skip to content

mvac7/SDCC_PT3player_Lib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

37 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PT3 Player MSX SDCC Library (fR3eL Project)

Architecture: MSX
Format: C Object (SDCC .rel)
Programming language: C and Z80 assembler

Authors:

In examples/test_ROM software, PT3 songs:

  • "A funny day with my MSX" by Makinavaja for AAMSX 50th Users Meeting invitro
  • "Mathematical brain" by Makinavaja for XI MICROCOMPO AY

PT3 player (Fixed Table) for asMSX cross-assembler (by SapphiRe): z80st-Blog > Nueva version del replayer de PT3

Sorry!: This text is pending correction of the English translation. <<<<<<<<<

History of versions:

  • 1.2 (?) Release Version
  • 1.1.10 (05/10/2021) Add Note Table address in Player_InitSong and bug fixed in Player_Resume
  • 1.1.9 (07/07/2021) Delete PlayAY() and AYREGS. Now need the AY38910BF library that manages hardware access.
  • 1.1.8 (16/04/2021) add Player_IsEnd() function
  • 1.1.7 (24/03/2021)
  • 1.1.6 (15/02/2021) same function names in music libraries
  • 1.1.5 (22/01/2021) Adjusted to work without the 100 Byte header
  • 1.1.4 (08/01/2021) PT3_Init and Bug #11 in loop
  • 1.1.3 (05/01/2021) PT3state, PT3_Loop, PT3_Pause and PT3_Resume
  • 1.1.2 (04/01/2021) assignment of frequency table memory address to NoteTable
  • 1.1 (28/05/2019) Adaptation to SDCC of asMSX version by SapphiRe.
  • 1.0 (21/10/2016) Adaptation to SDCC of the ROM version by Kun.

Description

Adaptation of the latest version of Vortex Tracker II PT3 Player for MSX by SapphiRe for use in software development in C (SDCC).

There are modifications on the original code, to add some extra functionality in the player control. Also part of the nomenclature has been changed to unify and simplify the use of different sound libraries.

To function it requires the AY38910BF library. The function that dumps the registers buffer to the sound processor PlayAY, has been moved to this library because it is applicable to other music libraries (such as ayFXplayer). You also get the possibility of selecting to which sound processor the data processed by the players should be directed (internal or external AY).

Allows access to player variables.

Allows you to use any of the four note/frequency tables available in Vortex Tracker. They are available in header format to be included in your program.

This project is an Open Source library. You can add part or all of this code in your application development or include it in other libraries/engines.

You can access the documentation here with How to use the library.

In the source code examples/, you can find applications for testing and learning purposes.

TEST PT3player

TEST PT3player in WebMSX

This library is part of the MSX fR3eL Project.

Enjoy it!



License

Vortex Tracker II v1.0 PT3 player (c) 2004 S.V.Bulba Vortex Project



Requirements

For compile.

For create PT3 songs.

For generate C datas



AY Sound System

The AY38910BF, PT3player and ayFXplayer libraries are designed to work together, so you will have a system to provide music and effects in game development.

AY Sound System