User Player With Sound Effect for CPC

[ramon]

Te presento una rutina de usuario para reproducir música y efectos en Amstrad CPC.

Primera parte

1-Edita tu música en tu editor favorito ARKOS TRACKET 2, www.julien-nevo.com/arkostracker/
2-Construye una "Pieza Musical" o "Song". ARKOS TRACKET 2 permite agregar "subsongs" en una compilación. Aprovecharemos esta propiedad del Arkos Tracker 2 para usar el comando selector de música "USER n"
3-Crea otra "Song". Esta vez crea tus efectos de sonido como si fueran instrumentos. Sigue las instrucciones en www.julien-nevo.com/arkostracker/index.php/sound-effects/
También puedes intentar este tutorial en pacmanzxspectrum.blogspot.com/2021/01/sesion-arkos-traker.html
Ahora podrás invocar tus efectos de sonido con "USER 100+n"
4-Compila tu música siguiendo las estrategias descritas en los enlaces anteriores.
5-La intención de todo esto es conseguir dos archivos AKMusic.asm (paso 2) y AKFX.asm (paso 3) donde se guardará la información de las músicas y los efectos respectivamente.

Segunda Parte

Instalación de los programas dentro del directorio "SuiteCPC":
Puedes descargar el archivo UserAK_CPC.rar (299.5 KB) dentro de tu directorio "SuiteCPC". Este archivo hace las siguientes tareas por ti:

-Crea dos nuevos directorios llamados "resources" y "Rasm" ambos dentro de "SuiteCPC"
-Copia los Players "PlayerAkg.asm" y "PlayerAkg_SoundEffects.asm" que se incluyen en la instalación de "ARKOS TRACKET 2" a nuestro directorio "Rasm"
-Copia dos compilaciones ejemplo: AKMusic.asm y AKFX.asm al directorio "resources".
-Copia "Music_Empty.asm" que se incluye en la instalación de "ARKOS TRACKET 2" en el directorio "resources" también.
-Copia rasm.exe al directorio "Rasm"
-Hace una copia de seguridad de tu "Build.bat" dentro del directorio "SuiteCPC" de tu instalación de MPAGD.
-Crea un nuevo Build.bat para compilar la música. Compatible para otros propósitos.
-Copia UserPlayerAkgWithSoundEffect_CPC.asm al directorio "SuiteCPC"

Cosas que deberás hacer tu:
1-Deberás sustituir las dos compilaciones ejemplo: AKMusic.asm y AKFX.asm por las de tu juego con los mismos nombres.

Tercera Parte

1-Selecciona UserPlayerAkgWithSoundEffect_CPC.asm como tu rutina de usuario en tu editor MPAGD.
2-Incluye en tu evento favorito "USER n" para invocar la subsong n de tu compilación musical.
3-Incluye USER 18 para detener el player.
4-Incluye USER 100+n para invocar el efecto n en tu banco de efectos
5-No olvides incluir siempre USER 96 en el evento mail loop.

En inglés:

First part

1-Edit your music in your favorite editor: ARKOS TRACKET 2 , www.julien-nevo.com/arkostracker/
2-Build a "Musical Piece" or "Song". ARKOS TRACKET 2 allows you to add "subsongs" in a compilation. We will take advantage of this Arkos Tracker 2 property to use the music selector command "USER n"
3-Create another "Song". This time create your sound effects as if they were instruments. Follow the instructions at www.julien-nevo.com/arkostracker/index.php/sound-effects/
You can also try this tutorial at pacmanzxspectrum.blogspot.com/2021/01/sesion-arkos-traker.html
Now you can play your sound effects with "USER 100+n"
4-Compile your music following the strategies described in the previous links.
5-The intention of all this is to get two files AKMusic.asm (step 2) and AKFX.asm (step 3) where the information of the music and the effects will be saved respectively.

Second part

Installing the programs inside the "SuiteCPC" directory:
You can download the UserAK_CPC.rar (299.5 KB) file inside your "SuiteCPC" directory. This file does the following tasks for you:

-Create two new directories called "resources" and "Rasm" both inside "SuiteCPC"
-Copy the Players "PlayerAkg.asm" and "PlayerAkg_SoundEffects.asm" that are included in the "ARKOS TRACKET 2" installation to our "Rasm" directory
-Copy two sample builds: AKMusic.asm and AKFX.asm to the "resources" directory.
-Copy "Music_Empty.asm" that is included in the "ARKOS TRACKET 2" installation in the "resources" directory as well.
-Copy rasm.exe to the "Rasm" directory
-Make a backup of your "Build.bat" inside the "SuiteCPC" directory of your MPAGD installation.
-Create a new Build.bat to compile the music. Compatible for other purposes.
-Copy UserPlayerAkgWithSoundEffect_CPC.asm to the "SuiteCPC" directory

Things you should do:
1-You must replace the two example compilations: AKMusic.asm and AKFX.asm for those of your game with the same names.

Third part

1-Select UserPlayerAkgWithSoundEffect_CPC.asm as your user routine in your MPAGD editor.
2-Include "USER n" in your favorite event to invoke subsong n of your music compilation.
3-Include USER 18 to stop the player.
4-Include USER 100+n to summon effect n in your effects bank
5-Don't forget to always include USER 96 in the mail loop event.

Example: "DIAMOND GEEZER EVENT INTROMENU"

EVENT INTROMENU

INK 15
PAPER 0
CLS
AT 4 9

LET CONTROL = 99
WHILE CONTROL >= 99
    CLS
    AT 5 9
    PRINTMODE 1
    PRINT "DIAMOND GEEZER"
    PRINTMODE 0
    AT 9 10
    PRINT "1. KEYBOARD"
    AT 11 10
    PRINT "2. KEMPSTON"
    AT 13 10
    PRINT "3. SINCLAIR"
    LET CONTROL = 99
    USER 0 ; play music subsong 0
    WHILE CONTROL = 99
        USER 96 ; play
        DELAY 6 ; sync necesary in intro menu event.
        IF KEY OPTION1
            LET CONTROL = 0
        ENDIF
        IF KEY OPTION2
            LET CONTROL = 1
        ENDIF
        IF KEY OPTION3
            LET CONTROL = 2
        ENDIF
    ENDWHILE
    USER 18 ; stop the player
ENDWHILE
CLS

Example: "DIAMOND GEEZER EVENT SPRITETYPE2"

EVENT SPRITETYPE2

IF SETTINGA = 0
    IF SETTINGB = 66
        LET SETTINGA = 1
    ELSE
        SUBTRACT 1 FROM SETTINGB
    ENDIF
ELSE
    IF SETTINGB = 70
        LET SETTINGA = 0
    ELSE
        ADD 1 TO SETTINGB
    ENDIF
ENDIF

SPRITEINK SETTINGB

IF COLLISION 0
    REMOVE
    EXPLODE 25
    SPRITEINK 7
    SCORE 100
    USER 104 ; sound effect 4
    SUBTRACT 1 FROM A
    IF A = 0
        DELAY 50
        WHILE T > 0
            SUBTRACT 1 FROM T
            SCORE 1
            AT 12 26
            DISPLAY SECONDS T
            AT 3 25
            SHOWSCORE
            BEEP 50
            DELAY 2
        ENDWHILE
        NEXTLEVEL
    ENDIF
    AT 3 25
    SHOWSCORE
ENDIF

Example: "DIAMOND GEEZER EVENT LOSTGAME"

EVENT LOSTGAME

USER 18

DELAY 50

(No olvides:)
Example: "DIAMOND GEEZER EVENT MAINLOOP1"

EVENT MAINLOOP1

USER 96 ; master play

; Update the bonus timer.
ADD 1 TO S
IF S > 25
    SUBTRACT 25 FROM S
    IF T > 0
        SUBTRACT 1 FROM T
    ENDIF
    AT 12 26
    DISPLAY SECONDS T
ENDIF

[ramon]

I'm sorry. Download the backup copy of the original version of the Build.bat file inside the SuiteCPC directory in your MPAGD installation for future recovery here: build - original.bat (690 B)

[ramon]

Versión sincronizada.

Con unos pequeños cambios no será necesario que incluyas USER 96 en el MAINLOOP de tus juegos para escuchar tus músicas y efectos.
En esta versión se ejecuta el sonido sincronizado con el EngineCPC.

A continuación se muestran los pasos a seguir con la nueva versión:

Primera parte

Instalación de los programas dentro del directorio "SuiteCPC":
Puedes descargar el archivo UserAK_CPC_SYNC.rar (341.5 KB) dentro de tu directorio "SuiteCPC". Este archivo hace las siguientes tareas por ti:

-Crea dos nuevos directorios llamados "resources" y "Rasm" ambos dentro de "SuiteCPC"
-Copia los Players "PlayerAkg.asm" y "PlayerAkg_SoundEffects.asm" que se incluyen en la instalación de "ARKOS TRACKET 2" a nuestro directorio "Rasm"
-Copia plsnd.asm al directorio "Rasm"
-Copia dos compilaciones ejemplo: AKMusic.asm y AKFX.asm al directorio "resources".
-Copia "Music_Empty.asm" que se incluye en la instalación de "ARKOS TRACKET 2" en el directorio "resources" también.
-Copia rasm.exe y fart.exe al directorio "Rasm"
-Hace una copia de seguridad de tu "Build.bat" dentro del directorio "SuiteCPC" de tu instalación de MPAGD.
-Crea un nuevo Build.bat para compilar la música. Compatible para otros propósitos.
-Copia UserPlayerAkgWithSoundEffect_CPC.asm al directorio "SuiteCPC"

Segunda Parte

Deberás sustituir las dos compilaciones ejemplo: AKMusic.asm y AKFX.asm por las de tu juego con los mismos nombres:

1-Edita tu música en tu editor favorito ARKOS TRACKET 2, www.julien-nevo.com/arkostracker/
2-Construye una "Pieza Musical" o "Song". ARKOS TRACKET 2 permite agregar pequeñas "subsongs" en una compilación. Aprovecharemos esta propiedad del Arkos Tracker 2 para usar el comando selector de música "USER n"
3-Crea otra "Song" a parte. Esta vez crea tus efectos de sonido como si fuerean istrumentos. Sigue las instrucciones en www.julien-nevo.com/arkostracker/index.php/sound-effects/
Tambien puedes intentar este tutorial en pacmanzxspectrum.blogspot.com/2021/01/sesion-arkos-traker.html
Ahora podrás invocar tus efectos de sonido con USER "100+n"
4-Compila tu musica siguiendo las estrategias descritas en los enlaces anteriores.
5-La intención de todo esto es conseguir dos archivos AKMusic.asm (paso 2) y AKFX.asm (paso 3) donde se guardará la información de las músicas y los efectos respectivamente.

Tercera Parte

1-Selecciona UserPlayerAkgWithSoundEffect_CPC.asm como tu rutina de usuario en tu editor MPAGD.
2-Incluye en tu evento favorito "USER n" para invocar la subsong n de tu compilación musical.
3-Incluye USER 18 para detener el player.
4-Incluye USER 100+n para invocar el efecto n en tu banco de efectos
5-El master player está ahora sincronizado con el motor del juego por lo que no hace falta nada más.
6-Debes incluir "DELAY 2" en tu evento INTROMENU si quieres que suene tu música; ya que aquí no hay sincronización automática. Abajo hay un ejemplo.

En inglés:

Synchronized version.

With a few small changes it will not be necessary to include USER 96 in the MAINLOOP of your games to listen to your music and effects.
In this version the sound is executed in sync with the EngineCPC.

Below are the steps to follow with the new version:

First part

Installing the programs inside the "SuiteCPC" directory:
You can download the UserAK_CPC_SYNC.rar file inside your "SuiteCPC" directory. This file does the following tasks for you:

-Create two new directories called "resources" and "Rasm" both inside "SuiteCPC"
-Copy the Players "PlayerAkg.asm" and "PlayerAkg_SoundEffects.asm" that are included in the "ARKOS TRACKET 2" installation to our "Rasm" directory
-Copy two sample builds: AKMusic.asm and AKFX.asm to the "resources" directory.
-Copy "Music_Empty.asm" that is included in the "ARKOS TRACKET 2" installation in the "resources" directory as well.
-Copy plsnd.asm to the "Rasm" directory
-Copy rasm.exe and fart.exe to the "Rasm" directory
-Make a backup of your "Build.bat" inside the "SuiteCPC" directory of your MPAGD installation.
-Create a new Build.bat to compile the music. Compatible for other purposes.
-Copy UserPlayerAkgWithSoundEffect_CPC.asm to the "SuiteCPC" directory

Second part

You must replace the two example compilations: AKMusic.asm and AKFX.asm for those of your game with the same names:

1-Edit your music in your favorite editor: ARKOS TRACKET 2 , www.julien-nevo.com/arkostracker/
2-Build a "Musical Piece" or "Song". ARKOS TRACKET 2 allows you to add "subsongs" in a compilation. We will take advantage of this Arkos Tracker 2 property to use the music selector command "USER n"
3-Create another separated "Song". This time create your sound effects as if they were instruments. Follow the instructions at www.julien-nevo.com/arkostracker/index.php/sound-effects/
You can also try this tutorial at pacmanzxspectrum.blogspot.com/2021/01/sesion-arkos-traker.html
Now you can play your sound effects with USER "100+n"
4-Compile your music following the strategies described in the previous links.
5-The intention of all this is to get two files AKMusic.asm (step 2) and AKFX.asm (step 3) where the information of the music and the effects will be saved respectively.

Third part

1-Select UserPlayerAkgWithSoundEffect_CPC.asm as your user routine in your MPAGD editor.
2-Include "USER n" in your favorite event to invoke subsong n of your music compilation.
3-Include USER 18 to stop the player.
4-Include USER 100+n to summon effect n in your effects bank
5-The master player is now synchronized with the game engine so nothing else is needed.
6-You must include "DELAY 2" in your INTROMENU event if you want your music to play; since there is no automatic synchronization here. Below is an example.

Example: "DIAMOND GEEZER EVENT INTROMENU"

EVENT INTROMENU

INK 15
PAPER 0
CLS
AT 4 9

LET CONTROL = 99
WHILE CONTROL >= 99
    CLS
    AT 5 9
    PRINTMODE 1
    PRINT "DIAMOND GEEZER"
    PRINTMODE 0
    AT 9 10
    PRINT "1. KEYBOARD"
    AT 11 10
    PRINT "2. KEMPSTON"
    AT 13 10
    PRINT "3. SINCLAIR"
    LET CONTROL = 99
    USER 0 ; play music subsong 0
    WHILE CONTROL = 99
        DELAY 2 ; sync necesary in intro menu event.
        IF KEY OPTION1
            LET CONTROL = 0
        ENDIF
        IF KEY OPTION2
            LET CONTROL = 1
        ENDIF
        IF KEY OPTION3
            LET CONTROL = 2
        ENDIF
    ENDWHILE
    USER 18 ; stop the player
ENDWHILE
CLS

Example: "DIAMOND GEEZER EVENT SPRITETYPE2"

EVENT SPRITETYPE2

IF SETTINGA = 0
    IF SETTINGB = 66
        LET SETTINGA = 1
    ELSE
        SUBTRACT 1 FROM SETTINGB
    ENDIF
ELSE
    IF SETTINGB = 70
        LET SETTINGA = 0
    ELSE
        ADD 1 TO SETTINGB
    ENDIF
ENDIF

SPRITEINK SETTINGB

IF COLLISION 0
    REMOVE
    EXPLODE 25
    SPRITEINK 7
    SCORE 100
    USER 104 ; sound effect 4
    SUBTRACT 1 FROM A
    IF A = 0
        DELAY 50
        WHILE T > 0
            SUBTRACT 1 FROM T
            SCORE 1
            AT 12 26
            DISPLAY SECONDS T
            AT 3 25
            SHOWSCORE
            BEEP 50
            DELAY 2
        ENDWHILE
        NEXTLEVEL
    ENDIF
    AT 3 25
    SHOWSCORE
ENDIF

Example: "DIAMOND GEEZER EVENT LOSTGAME"

EVENT LOSTGAME

USER 18        ; Stop music.

DELAY 50

Example: "DIAMOND GEEZER EVENT MAINLOOP1"

EVENT MAINLOOP1

; The master player is now synchronized with the game engine so nothing else is needed.

; Update the bonus timer.
ADD 1 TO S
IF S > 25
    SUBTRACT 25 FROM S
IF T > 0
    SUBTRACT 1 FROM T
    ENDIF
    AT 12 26
    DISPLAY SECONDS T
ENDIF

[ramon]

Mensaje de error corregido: Última versión revisada aquí: UserAK_CPC_SYNC.rar (645.05 KB)

[ramon]

Solved bug. New version:


UserAK_CPC_SYNC 1.rar (645.05 KB)

[ghecko71]

Gracias Makina !

[Kelebrindae]

Thanks a lot, Ramon! This is incredibly useful!

[mananuk]

Thank you very much Ramon, it works perfectly.
Would it be possible to keep the loading screen frame to use as a frame in mpagd for cpc and avoid deleting it by not doing any cls?

[ramon]

It is resolved for zx Spectrum in the article I indicate below, for you I have to do a study of the cpc. It will take a month and a half. but the foundation is the same.

arcadegamedesigner.proboards.com/thread/1152/external-screen

[mananuk]

Dec 18, 2023 12:17:33 GMT ramon said:

It is resolved for zx Spectrum in the article I indicate below, for you I have to do a study of the cpc. It will take a month and a half. but the foundation is the same.

arcadegamedesigner.proboards.com/thread/1152/external-screen

But I was not referring to storing the screen and then displaying it as we do in zxspectrum, but once the screen is loaded, delete only the part of the game with a clw and take advantage of the rest without spending more memory.

[ramon]

Try to resize screen window in the editor MPAGD. do not use never cls. Use a ampty room in this case.

[cyrille]

Hello , ramon
2 question : What is the ultimate stable USER AKCPC validated ?
Is the AKMusic.asm in the pack is an empty music ? or is it with an example song ? ( for know if it's work or not at first attempt)

thanks a lot for your great work

[ramon]

[ramon]

I'm sorry. I'm afraid I forgot to say that you have the sound sources in the resources folder within Suite CPC. You must replace the one I offer you as a sample with others created by you. Use exactly the same name for the files.

I hope it works to your liking. Do not overload the music in play with sound, it is just a tip.

[cyrille]

Jan 31, 2024 20:24:58 GMT ramon said:

I'm sorry. I'm afraid I forgot to say that you have the sound sources in the resources folder within Suite CPC. You must replace the one I offer you as a sample with others created by you. Use exactly the same name for the files.

I hope it works to your liking. Do not overload the music in play with sound, it is just a tip.

ramon , okay . But the last question is the one music you offered to us , is an empty song ? or it is a song ?

Because I tried , as intro menu loop as example as yours but i listen nothing like an empty song ,. Is your example song is a blank song ?

thanks again