1
0
mirror of https://github.com/pumpitupdev/pumptools.git synced 2024-11-27 16:10:55 +01:00

doc/hook: Update with sound related content

Information extracted from:
https://dev.s-ul.net/hackitup/pumptools/-/issues/28#note_5817
This commit is contained in:
icex2 2021-03-31 21:29:41 +02:00
parent 0eecce3c91
commit 51cf070fdc

View File

@ -61,6 +61,10 @@ disk to run the games on dedicated hardware for cabinets.
## Quick start: how to run (official release)
The following steps apply to any game of the "officially" supported release data.
!!!
AVOID USING `lib-ld.zip` PERIOD. THIS IS A FALLBACK OPTION IF `lib-local.zip` DOES NOT WORK!!!
!!!
1. Install the required dependencies which can vary per game. Check the section "required dependencies" in the dedicated
readme files of each hook.
1. Unpack `game.zip` and `lib-local.zip` to a folder of your choice.
@ -217,6 +221,43 @@ To route the audio to the device of your choice, e.g. device `0`, add the number
patch.sound.device=hw:0
```
Alternative:
```shell script
aplay -l
```
Example output:
```text
**** List of PLAYBACK Hardware Devices ****
card 0: Generic [HD-Audio Generic], device 3: HDMI 0 [HDMI 0]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: Generic [HD-Audio Generic], device 7: HDMI 1 [HDMI 1]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: Generic [HD-Audio Generic], device 8: HDMI 2 [HDMI 2]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 0: Generic [HD-Audio Generic], device 9: HDMI 3 [HDMI 3]
Subdevices: 1/1
Subdevice #0: subdevice #0
card 2: Generic_1 [HD-Audio Generic], device 0: ALC887-VD Analog [ALC887-VD Analog]
Subdevices: 0/1
Subdevice #0: subdevice #0
card 2: Generic_1 [HD-Audio Generic], device 1: ALC887-VD Digital [ALC887-VD Digital]
Subdevices: 1/1
Subdevice #0: subdevice #0
```
If you want to route the audio output to `card 0: Generic [HD-Audio Generic], device 3: HDMI`, set the following in
the `hook.conf` file:
```text
patch.sound.device=hw:CARD=Generic,DEV=3
```
### The game plays/renders too fast
The game relies on vsync to lock to the target framerate of 60 FPS. Ensure vsync is turned on in your GPU settings.
@ -268,4 +309,16 @@ scaling modes. Especially for the SD 640x480 4:3 games, this allows you to upsca
display resolution while keeping the aspect ratio (pillarbox).
Note: This does not change the enhance the image quality. It just uses the GPU to interpolate the lower resolution
output and stretches it to the target surface area.
output and stretches it to the target surface area.
### The game crashes with a snd_pcm_open error
If the game crashes with the following error:
```text
[E][2021/3/28-19:38:49:778][patch-sound][sound.c:55] snd_pcm_open failed: No such file or directory
piu: pcm_params.c:2354: snd_pcm_hw_refine: Assertion `pcm && params' failed.
Aborted (core dumped)
```
Verify that you have set the `patch.sound.device=` property in the `hook.conf`. Also refer to
[this section](#how-do-i-figure-out-which-sound-device-to-select) how to configure your audio device.