vitasdk code samples

Prerequisites

In order to build a vita sample, you need to add the toolchain bin/ directory to your $PATH.

Building

Every samples directory should include a CMake list. To build a sample, place yourself into this directory and use the cmake . && make command to build it.

Running

To run a sample:

Send the generated .vpk to your vita:
- Start an FTP server on your vita (for example, with VitaShell - by pressing the select button).
- Upload the .vpk to the Vita using your FTP client (for example, with Curl - with curl -T *.vpk ftp://YOUR_VITA_IP:1337/ux0:/)
- If Curl returns fatal: No names found, cannot describe anything it mean that you are trying to overwrite a folder with a file. Add a / to the end of your url to explain that you want to upload IN this folder.
Install the .vpk on your vita using a vpk installer (for example, with VitaShell - by pressing the X button on the .vpk)
This will create a new folder in the ux0:/app/ for the sample.

Building everything

Use the following command to build every samples:

mkdir build && cd build
cmake ..
make

List of samples

audio: Simple audio wave generator.
camera: Demonstration of camera features.
common: Common functions for samples.
ctrl: A minimal controller (button) sample.
debug_print: A minimal debug print sample.
debugscreen: Debug text printing sample.
hello_cpp_world: A minimal hello world sample in C++.
hello_world: A minimal hello world sample.
ime: Graphical dialog sample.
microphone: Demonstration of microphone features.
motion: Prints accelerometer data.
net_http: A minimal HTTP download sample.
net_http_bsd: A minimal HTTP download sample using BSD sockets.
net_libcurl: A libcurl download sample.
power: A minimal power sample.
pretty_livearea: A minimal hello world sample with example livearea styling and features.
prx_loader: Load/list prx modules.
prx_simple: Minimal sample prx module.
redrectangle: Example SDL rendering.
rtc: A minimal RTC sample.
socket_ping: ICMP ping using raw sockets.
soloud: Plays an audio file and Text To Speech.
touch: A minimal touch sample.

Notes on images

Images shall use indexed palettes (PNG-8 128 Dithered).
The size of an image shall not exceed 420KB.
For some reasons, some PNG files created by GIMP makes the .vpk installation crash.
You can further minimize overhead by running your images through pngquant.

Notes on supporting files and folders

File names shall not exceed 32B.
Directory names shall not exceed 16B.
Folder creation shall not exceed one level.

Notes on XML

UTF-8 character encoding, CRLF line termination.
File size shall not exceed 32KB.
Different visual styles are available, check the sample pretty_livearea for an example.

License

All code and build scripts in this repo is licensed under the terms of CC0 1.0 Universal.

frangarcj / samples