ScreenshotWUPS/README.md

2.9 KiB

Screenshot Plugin

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

Installation

([ENVIRONMENT] is a placeholder for the actual environment name.)

  1. Copy the file screenshot.wps into sd:/wiiu/environments/[ENVIRONMENT]/plugins.
  2. Requires the WiiUPluginLoaderBackend in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  3. Requires the MemoryMappingModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.
  4. Requires the NotificationModule in sd:/wiiu/environments/[ENVIRONMENT]/modules.

Usage

Press a button combo on the GamePad, Pro Controller or Classic Controller to take a screenshot.

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:

  • Settings:
    • Enabled: (Default is true)
      • Enables or disables the screenshot plugin.
    • Button combo: (Default is TV-Button)
      • Changes the button combo for taking screenshots.
    • Screen: (Default is TV and GamePad)
      • Determines from which screen a screenshot should be taken. Possible options: TV & GamePad, TV only, GamePad only.
    • Output format: (Default is JPEG)
      • Determines which file is used. Currently saving screens as .jpg, .png and .bmp is supported.
    • JPEG quality: (Default is 90)
      • Determines the quality when saving as JPEG. Lowest possible quality is 10, highest 100.
    • Check ReservedBit for taking screenshots: (Default is true)
      • Enables taking screenshots when the "ReservedBit" on the Pro Controller is set, regardless of the configured button combo. For example this allows to take screenshots with the screenshot button of Switch Pro Controller (when using a compatible Bloopair version):

Building

For building you need:

Building using the Dockerfile

It's possible to use a docker image for building. This way you don't need anything installed on your host system.

# Build docker image (only needed once)
docker build . -t screenshot-plugin-builder

# make 
docker run -it --rm -v ${PWD}:/project screenshot-plugin-builder make

# make clean
docker run -it --rm -v ${PWD}:/project screenshot-plugin-builder make clean

Format the code via docker

docker run --rm -v ${PWD}:/src ghcr.io/wiiu-env/clang-format:13.0.0-2 -r ./src -i