ScreenshotWUPS/README.md

55 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2020-12-11 16:41:37 +01:00
# Screenshot Plugin
2018-07-01 19:12:35 +02:00
2022-09-23 17:00:10 +02:00
This is just a simple plugin that takes screenshots of the TV and GamePad screens.
The screenshots will be saved on the SD card in the folder `sd:/wiiu/screenshots`
2018-07-01 19:12:35 +02:00
2020-12-11 16:41:37 +01:00
## Installation
(`[ENVIRONMENT]` is a placeholder for the actual environment name.)
2018-07-01 19:12:35 +02:00
2020-12-11 16:41:37 +01:00
1. Copy the file `screenshot.wps` into `sd:/wiiu/environments/[ENVIRONMENT]/plugins`.
2. Requires the [WiiUPluginLoaderBackend](https://github.com/wiiu-env/WiiUPluginLoaderBackend) in `sd:/wiiu/environments/[ENVIRONMENT]/modules`.
3. Requires the [MemoryMappingModule](https://github.com/wiiu-env/MemoryMappingModule) in `sd:/wiiu/environments/[ENVIRONMENT]/modules`.
## Usage
Press a button combo (default is L + R + ZL + ZR) on the GamePad, Pro Controller or Classic Controller to take a screenshot.
2020-12-11 16:41:37 +01:00
2022-09-23 17:00:10 +02:00
Via the plugin config menu (press L, DPAD Down and Minus on the GamePad, Pro Controller or Classic Controller) you can configure the plugin. The available options are the following:
2020-12-11 16:41:37 +01:00
- **Settings**:
- Enabled: (Default is true)
- Enables or disables the screenshot plugin.
2022-09-24 17:57:29 +02:00
- Button combo: (Default is L + R + ZL + ZR)
- Changes the button combo for taking screenshots.
2022-09-23 17:00:10 +02:00
- Screen: (Default is TV and GamePad)
- Determines from which screen a screenshot should be taken. Possible options: TV & GamePad, TV only, GamePad only.
2022-09-23 17:00:53 +02:00
- Output format: (Default is JPEG)
- Determines which file is used. Currently saving screens as .jpg, .png and .bmp is supported.
2020-12-11 16:41:37 +01:00
- JPEG quality: (Default is 90)
- Determines the quality when saving as JPEG. Lowest possible quality is 10, highest 100.
2018-07-01 19:12:35 +02:00
## Building
For building you need:
2020-12-11 16:41:37 +01:00
- [wups](https://github.com/wiiu-env/WiiUPluginSystem)
2018-07-13 19:23:42 +02:00
- [wut](https://github.com/decaf-emu/wut)
2020-12-11 16:41:37 +01:00
- [libmappedmemory](https://github.com/wiiu-env/libmappedmemory)
- PPC versions of zlib, libgd, libpng, libjpeg (install via `pacman -Syu ppc-zlib ppc-libgd ppc-libpng ppc-libjpeg-turbo`)
2018-07-01 19:12:35 +02:00
2020-12-11 16:41:37 +01:00
## Building using the Dockerfile
2018-07-01 19:12:35 +02:00
It's possible to use a docker image for building. This way you don't need anything installed on your host system.
```
2020-12-11 16:41:37 +01:00
# Build docker image (only needed once)
docker build . -t screenshot-plugin-builder
# make
2020-12-11 16:41:37 +01:00
docker run -it --rm -v ${PWD}:/project screenshot-plugin-builder make
# make clean
2020-12-11 16:41:37 +01:00
docker run -it --rm -v ${PWD}:/project screenshot-plugin-builder make clean
```
2020-12-11 16:41:37 +01:00
## Format the code via docker
`docker run --rm -v ${PWD}:/src wiiuenv/clang-format:13.0.0-2 -r ./src -i`