Adapt to wiki format

ABelliqueux 2021-08-04 11:39:31 +02:00
parent b1a7b0064b
commit 4ad605427d
8 changed files with 45 additions and 97 deletions

16
BS.md

@ -1,18 +1,8 @@
# Loading a BS still image
# BS file format
You need [mkpsxiso](https://github.com/Lameguy64/mkpsxiso) in your $PATH to generate a PSX disk image.
## Code example
## Compile
```bash
make all
```
## Clean directory
```bash
make cleansub
```
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_bs
## Converting a still image to BS

49
CD.md

@ -1,17 +1,8 @@
## Compiling
# CD file loading
You need [mkpsxiso](https://github.com/Lameguy64/mkpsxiso) in your $PATH to generate a PSX disk image.
Typing
```bash
make
```
in a terminal will compile and generate the bin/cue files.
## Code example
Typing
```bash
make cleansub
```
will clean the current directory
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_cd
## Creating the disk image
@ -19,38 +10,12 @@ will clean the current directory
mkpsxiso -y isoconfig.xml
```
## Using ffmpeg to generate a CDDA compliant Wav file
### Adding data to the CD
Needed Specification : `RIFF (little-endian) data, WAVE audio, Microsoft PCM, 16 bit, stereo 44100 Hz`
### Conversion
```bash
ffmpeg -i input.mp3 -acodec pcm_s16le -ac 2 -ar 44100 output.wav
```
### Merging two mono audio channels into one stereo channel
```bash
ffmpeg -i herb.wav.new -filter_complex "[0:a][0:a]amerge=inputs=2[a]" -map "[a]" herbi.wav
```
### Adding the audio track to the CD
Add a track section **after** your data track in `isoconfig.xml` :
In `isoconfig.xml`, in the data track's `directory_tree` section, use this syntax :
```xml
<track type="audio" source="file.wav"/>
<file name="HELO.DAT" type="data" source="theFile.dat"/>
```
## Music credits
Track 1 :
Beach Party by Kevin MacLeod
Link: https://incompetech.filmmusic.io/song/3429-beach-party
License: https://filmmusic.io/standard-license
Track 2:
Funk Game Loop by Kevin MacLeod
Link: https://incompetech.filmmusic.io/song/3787-funk-game-loop
License: https://filmmusic.io/standard-license
See https://github.com/Lameguy64/mkpsxiso/blob/master/examples/example.xml for more details.

15
CDDA.md

@ -1,17 +1,8 @@
## Compiling
# CDDA playback
You need [mkpsxiso](https://github.com/Lameguy64/mkpsxiso) in your $PATH to generate a PSX disk image.
Typing
```bash
make
```
in a terminal will compile and generate the bin/cue files.
## Code example
Typing
```bash
make cleansub
```
will clean the current directory
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_cdda
## Creating the disk image

7
STP.md

@ -1,3 +1,10 @@
# STR : Semi-Transparency
## Code example
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_poly_stp
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_cubetex_stp
![Hello_stp](https://wiki.arthus.net/assets/hello-stp.png)
# STP : Semi-Transparency usage

20
STR.md

@ -1,22 +1,14 @@
This example will play a fullscreen STR file and is as straightforward as possible. If you need more advanced control other the display size and position, see the [STR playback library](https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_str#str-playback-library) section.
# STR file format
## Compiling
## Code example
You need [mkpsxiso](https://github.com/Lameguy64/mkpsxiso) in your $PATH to generate a PSX disk image.
Typing
```bash
make
```
in a terminal will compile and generate the bin/cue files.
Typing
```bash
make cleansub
```
will clean the current directory.
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_str
## STR playback library
This example will play a fullscreen STR file and is as straightforward as possible.
If you need more advanced control other the display size and position, see the [STR playback library](https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_str#str-playback-library) section.
@Lameguy64 has spent some time making a STR playback library that's easily included in a project :
> One thing that I find somewhat missing here is a decent piece of code for playing STR video files easily. So, what I did was take the old and messy PsyQ STR player example, clean it up entirely, and finally make it into a cute little c library for easy implementation.

8
TIM.md

@ -1,4 +1,10 @@
# TIM files
# TIM file format
## Code example
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_sprt
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_poly_ft
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_poly_gt
Standard bitmap images that can be transferred directly to the PSX VRAM.

7
VAG.md

@ -1,4 +1,9 @@
# VAG files
# VAG file format
## Code examples
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_vag
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_multivag
> VAG is the PlayStation single waveform data format for ADPCM-encoded data of sampled sounds, such as
piano sounds, explosions, and music. The typical extension in DOS is “.VAG”.

20
XA.md

@ -1,3 +1,9 @@
# XA file format
## Code example
https://github.com/ABelliqueux/nolibgs_hello_worlds/tree/main/hello_xa
## XA playback
You need [mkpsxiso](https://github.com/Lameguy64/mkpsxiso) in your $PATH to generate a PSX disk image.
@ -14,20 +20,6 @@ xainterleave 1 xa/interleave8.txt xa/inter8.xa
Alternatively, you can use the windows tool [`MC32.EXE`](https://psx.arthus.net/tools/pimp-psx.zip) to interleave several PSX media files.
### Compile
This will compile and build an iso image :
```bash
make
```
### Clean directory
```bash
make cleansub
```
## Encoding to XA
You can use a modified version of [`psxavenc`](https://github.com/ABelliqueux/candyk-psx/tree/master/toolsrc/psxavenc) to convert your audio file to a 2336 bytes XA file :