Skip to content

mvac7/SDCC_ayFXplayer_Lib

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

PSG ayFX Player MSX SDCC Library (fR3eL Project)

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

Authors: 
        Original code: SapphiRe  <http://z80st.auic.es>
        This adaptation to SDCC: mvac7 
        
In examples/test_ROM software, PT3 songs:
- "Mathematical brain" by Makinavaja (for XI MICROCOMPO AY) 

Description

Library for launch sound effects for the PSG AY-3-8910 or compatible.

It is an adaptation of ayFX REPLAYER Fixed Volume v1.31 made by SapphiRe.

The names of the functions have been changed to adapt it to the nomenclature of the sound libraries of the fR3eL project.

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

Use them for developing MSX applications using Small Device C Compiler (SDCC).

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 AYfxplayer

This library is part of the MSX fR3eL Project.

Enjoy it!



Features

  • Designed for developing MSX applications using Small Device C Compiler (SDCC).
  • It does not use the BIOS so it can be used to program both ROMs or MSX-DOS executables.
  • Up to 256 effects per bank. Multiple banks can be defined and changed from the initialization function.
  • Priority parameter. The effects with the highest priority will be executed on the ones with the lowest.
  • 2 modes of operation:
    • Fixed. They will be heard on the indicated channel.
    • Cyclical. The ayFX sample will be mixed on a different PSG channel in each frame.


History of versions

  • v1.1 (12 July 2023) Bug fix (thanks to @ericb59 )
  • v1.0 (7 July 2021) First SDCC version.


Requirements

For compile:

For create a FXs bank



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



Acknowledgments

I want to give a special thanks to all those who freely share their knowledge with the MSX developer community.