Add Screenshot Guidelines

docs/.vitepress/config/en.ts

@@ -222,6 +222,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
           text: "Game Info and Hub Guidelines",
           link: "/guidelines/content/game-info-and-hub-guidelines",
         },
+        {
+          text: "Screenshot Guidelines",
+          link: "/guidelines/content/screenshot-guidelines",
+        },
         {
           text: "Genre Definitions",
           link: "/guidelines/content/genre-definitions",

docs/.vitepress/config/es.ts

@@ -223,6 +223,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
         //   link: "/guidelines/content/game-info-and-hub-guidelines",
         // },
         // {
+        //   text: "Screenshot Guidelines",
+        //   link: "/guidelines/content/screenshot-guidelines",
+        // },
+        // {
         //   text: "Genre Definitions",
         //   link: "/guidelines/content/genre-definitions",
         // },

docs/.vitepress/config/pt.ts

@@ -222,6 +222,10 @@ function sidebarGuidelines(): DefaultTheme.SidebarItem[] {
     //       link: "/guidelines/content/game-info-and-hub-guidelines",
     //     },
     //     {
+    //       text: "Screenshot Guidelines",
+    //       link: "/guidelines/content/screenshot-guidelines",
+    //     },
+    //     {
     //       text: "Genre Definitions",
     //       link: "/guidelines/content/genre-definitions",
     //     },

docs/guidelines/content/game-info-and-hub-guidelines.md

@@ -103,98 +103,7 @@ Game images are the displayed images on the game page, including the icon (aka m
 
 ### Screenshots
 
-- File size must be under 4 MB to upload.
-- English screenshots are encouraged unless they’re from translation patches in which case the original language is preferred.
-- No watermarks are to be present on any images.
-- Some games lack a typical title screen. In these cases, a screenshot of the title during an opening movie or loading screen may be used. If that doesn't exist, an initial menu screen or gameplay screen may be used.
-- Game Boy screenshots should be in black-and-white.
-- Emulator filters and shaders should be disabled for screenshots. For example, Game Boy Color and Game Boy Advance should not use color correction, and Apple II should not use a scanline filter.
-
-#### Screenshot Dimensions
-
-- Screenshots must have the same standard dimensions whenever possible.
-- Listed below are the standard image dimensions for each system. Some systems may differ depending on the game.
-	- 3DO Interactive Multiplayer - 320x240
-	- Amstrad CPC - 192x272, 384x272
-	- Apple II - 280x192, 560x384
-	- Arcade - Game-dependent
-	- Arcadia 2001 - 164x269 (Taken in narrow)
-	- Arduboy - 128x64
-	- Atari 2600 - 160x228 (NTSC), 160x274 (PAL)
-	- Atari 5200 - 320x228, 336x240
-	- Atari 7800 - 320x223, 320x272, 320x240, 160x240
-	- Atari Jaguar - Game-dependent
-	- Atari Jaguar CD - Game-dependent
-	- Atari Lynx - 160x102
-	- Atari ST - 320x200
-	- Bandai WonderSwan - 224x144, 144x224
-	- ColecoVision - 256x192
-	- Commodore 64 - Game-dependent
-	- Commodore Amiga - Game-dependent
-	- Commodore VIC-20 - 200x234
-	- DOS - Game-dependent
-	- Elektor TV Games Computer - 164x269 (Taken in narrow)
-	- Epoch Co. Cassette Vision - 128x192
-	- Epoch Co. Super Cassette Vision - 198x225
-	- Fairchild Channel F - 306x192
-	- Famicom Disk System - 256x224, 256x240
-	- Fujitsu FM Towns - Game-dependent
-	- GCE Vectrex - 193x240, 360x480
-	- Interton VC 4000 - 164x269 (Taken in narrow)
-	- Magnavox Odyssey 2 - 320x235
-	- Mattel Intellivision - 320x200
-	- Mega Duck - 160x144
-	- Microsoft MSX - 272x240
-	- Microsoft Xbox - 320x240
-	- NEC PC Engine CD/TurboGrafx-CD - 256x232, 256x239, 336x239, 512x243
-	- NEC PC Engine/TurboGrafx-16 - 256x232, 256x239, 336x239, 512x243
-	- NEC PC-6000 - Game-dependent
-	- NEC PC-8000/8800 - 320x200
-	- NEC PC-9800 - 640x400
-	- NEC PC-FX - 256x232, 256x240, 341x240
-	- Nintendo 3DS - 400x240, 320x240, 720x480
-	- Nintendo 64 - 320x240
-	- Nintendo DS - 256x384, 256x192
-	- Nintendo DSi - 256x384, 256x192
-	- Nintendo Entertainment System/Famicom - 256x224, 256x240
-	- Nintendo Game & Watch - Game-dependent
-	- Nintendo Game Boy - 160x144
-	- Nintendo Game Boy Advance - 240x160
-	- Nintendo Game Boy Color - 160x144
-	- Nintendo GameCube - 320x240
-	- Nintendo Pokemon Mini - 96x64
-	- Nintendo Virtual Boy - 320x186, 384x224
-	- Nintendo Wii - Game-dependent. Enable widescreen when the game supports it
-	- Nintendo Wii U - 1280x720
-	- Nokia N-Gage - Game-dependent
-	- Philips CD-i - 384x240, 384x280
-	- Sega 32X - 320x224, 256x224, 320x240
-	- Sega CD - 320x224, 256x224, 320x240
-	- Sega Dreamcast - 320x240
-	- Sega Game Gear - 160x144
-	- Sega Genesis/Mega Drive - 320x224, 256x224, 320x240
-	- Sega Master System - 256x192, 256x224, 256x240
-	- Sega Pico - 320x224, 256x224, 320x240
-	- Sega Saturn - 320x224, 352x224, 320x240, 352x240, 320x256, 352x256, 640x224, 704x224, 640x240, 704x240, 640x448, 704x448, 640x480, 704x480
-	- Sega SG-1000 - 256x192
-	- Sharp X1 - 320x200
-	- Sharp X68000 - Game-dependent
-	- Sinclair ZX Spectrum - 320x240
-	- Sinclair ZX81 - 256x192
-	- SNK Neo Geo CD - 320x224
-	- SNK Neo Geo Pocket - 160x152
-	- Sony PlayStation - 320x240, 256x240, 368x240, 512x240, 640x240, 320x480, 256x480, 368x480, 512x480, 640x480, 320x224, 512x268, 320x268
-	- Sony PlayStation 2 - 320x240, 640x448, 640x512, 596x447, 682x512
-	- Sony PlayStation Portable - 320x180, 480x272
-	- Super Nintendo Entertainment System/Famicom - 256x224, 256x240, 512x224
-	- TCS Oric - 240x224
-	- Texas Instruments TI-83 - 96x64
-	- Thomson TO8 - 672x432
-	- TIC-80 - 240x136
-	- Uzebox - Game-dependent
-	- WASM-4 - 160x160
-	- Watara Supervision - 160x160
-	- Zeebo - 800x480
+- Refer to the [Screenshot Guidelines](/guidelines/content/screenshot-guidelines) page.
 
 ## Hubs and Similar Games
 

docs/guidelines/content/screenshot-guidelines.md

@@ -0,0 +1,168 @@
+---
+title: Screenshot Guidelines
+description: Guidelines for contributing game screenshots to RetroAchievements. Learn about the best practices for taking screenshots of games, including how to configure emulators.
+---
+
+# Screenshot Guidelines
+
+- Screenshots should be taken directly from an emulator's screenshot capture function, using the game's natural resolution. Do not use external screenshot tools and do not take screenshots of an upscaled window or full screen display. 2D games should be pixel perfect and 3D games should be their raw internal resolution.
+- If possible, 3D games can have their internal resolution upscaled by 2x or 3x. Note that this is a special emulator setting, not just resizing the window while it's at 1x internal resolution.
+- For most systems, screenshots should be taken in RALibretro, since it automatically takes screenshots at the appropriate resolution. RetroArch should be avoided since it does not do this by default.
+- Emulators such as PCSX2 and Dolphin require configuration to have the appropriate screenshot settings. Please read the information in their sections below.
+- Never manually resize or crop a screenshot just to force a match with the required dimensions. If you're sure you have the appropriate emulator settings and the screenshots are correct for the game, but the site doesn't allow it, it may be an oversight. This can especially happen with some 3D systems like PS1 and PS2. Please report these cases in the #cleanup-requests forum in our [Discord server](https://discord.gg/dq2E4hE) if you're sure it's a mistake.
+- You may receive unusually wide screenshots with systems like Amstrad CPC and some PS1 games. Even if it looks strange, this can be the normal internal resolution for the game - the site should automatically handle these and resize them to the aspect ratio you expect. You don't have to manually resize them yourself.
+
+## Basic Guidelines
+
+- File size must be under 6 MB to upload.
+- Each game allows a maximum of 10 screenshots, including those marked as the title screen and completion screen.
+- English screenshots are encouraged unless they’re from translation patches in which case the original language is preferred.
+- No watermarks are to be present on any images.
+- Some games lack a typical title screen. In these cases, a screenshot of the title during an opening movie or loading screen may be used. If that doesn't exist, an initial menu screen or gameplay screen may be used.
+- Completion screenshots are intended to be "The End" screens that appear after beating the game, whenever possible. If such a screen doesn't exist, creativity may be needed in taking a good screenshot during the credits, or when finishing the final level, defeating the final boss, winning the final round before looping (for arcade games), etc.
+- Game Boy screenshots should be in black-and-white.
+- Emulator filters and shaders should be disabled for screenshots. For example, Game Boy Color and Game Boy Advance should not use color correction, and Apple II should not use a scanline filter.
+- Be sure to carefully look at the existing screenshots for a game before submitting more. Multiple screenshots of the same level or scene aren't that interesting - diversity is preferred (as much as the game allows). Menu screenshots should be kept to a minimum as well. Do not rush and submit several screenshots of initial menus or the first level just for the sake of submitting things.
+- Try to make screenshots interesting in general - not just characters standing in idle poses at the beginning of each level, but shots with more action and energy as well.
+- Avoid submitting screenshots of spoilers - scenes that involve plot twists, unexpected characters or unexpected boss fights later in the game, etc. Use your best judgment. (completion screenshots are an exception, of course - the site will automatically obscure them as a spoiler)
+
+### Screenshot Dimensions
+
+- Listed below are the standard image dimensions for each system. Some systems may differ depending on the game.
+- A reminder: please do not manually resize or crop your screenshots to match with these dimensions. They should be produced automatically by the emulator with appropriate settings. If you believe an error has been made, please report it in the #cleanup-requests forum as explained above.
+- This list may not always be up to date with the site's configuration if a change is made there without editing this page yet.
+	- 3DO Interactive Multiplayer - 320x240
+	- Amstrad CPC - 192x272, 384x272
+	- Apple II - 280x192, 560x384
+	- Arcade - Game-dependent
+	- Arcadia 2001 - 164x269 (Taken in narrow)
+	- Arduboy - 128x64
+	- Atari 2600 - 160x228 (NTSC), 160x274 (PAL)
+	- Atari 5200 - 320x228, 336x240
+	- Atari 7800 - 320x223, 320x272, 320x240, 160x240
+	- Atari Jaguar - Game-dependent
+	- Atari Jaguar CD - Game-dependent
+	- Atari Lynx - 160x102
+	- Atari ST - 320x200
+	- Bandai WonderSwan - 224x144, 144x224
+	- ColecoVision - 256x192
+	- Commodore 64 - Game-dependent
+	- Commodore Amiga - Game-dependent
+	- Commodore VIC-20 - 200x234
+	- DOS - Game-dependent
+	- Elektor TV Games Computer - 164x269 (Taken in narrow)
+	- Epoch Co. Cassette Vision - 128x192
+	- Epoch Co. Super Cassette Vision - 198x225
+	- Fairchild Channel F - 306x192
+	- Famicom Disk System - 256x224, 256x240
+	- Fujitsu FM Towns - Game-dependent
+	- GCE Vectrex - 193x240, 360x480
+	- Interton VC 4000 - 164x269 (Taken in narrow)
+	- Magnavox Odyssey 2 - 320x235
+	- Mattel Intellivision - 320x200
+	- Mega Duck - 160x144
+	- Microsoft MSX - 272x240
+	- Microsoft Xbox - 640x480
+	- NEC PC Engine CD/TurboGrafx-CD - 256x232, 256x239, 336x239, 512x243
+	- NEC PC Engine/TurboGrafx-16 - 256x232, 256x239, 336x239, 512x243
+	- NEC PC-6000 - Game-dependent
+	- NEC PC-8000/8800 - 320x200
+	- NEC PC-9800 - 640x400
+	- NEC PC-FX - 256x232, 256x240, 341x240
+	- Nintendo 3DS - 400x240, 320x240, 720x480
+	- Nintendo 64 - 320x240
+	- Nintendo DS - 256x384, 256x192
+	- Nintendo DSi - 256x384, 256x192
+	- Nintendo Entertainment System/Famicom - 256x224, 256x240
+	- Nintendo Game & Watch - Game-dependent
+	- Nintendo Game Boy - 160x144
+	- Nintendo Game Boy Advance - 240x160
+	- Nintendo Game Boy Color - 160x144
+	- Nintendo GameCube - 640x480, 640x448
+	- Nintendo Pokemon Mini - 96x64
+	- Nintendo Virtual Boy - 320x186, 384x224
+	- Nintendo Wii - Game-dependent. Enable widescreen when the game supports it
+	- Nintendo Wii U - 1280x720
+	- Nokia N-Gage - Game-dependent
+	- Philips CD-i - 384x240, 384x280
+	- Sega 32X - 320x224, 256x224, 320x240
+	- Sega CD - 320x224, 256x224, 320x240
+	- Sega Dreamcast - 320x240
+	- Sega Game Gear - 160x144
+	- Sega Genesis/Mega Drive - 320x224, 256x224, 320x240
+	- Sega Master System - 256x192, 256x224, 256x240
+	- Sega Pico - 320x224, 256x224, 320x240
+	- Sega Saturn - 320x224, 352x224, 320x240, 352x240, 320x256, 352x256, 640x224, 704x224, 640x240, 704x240, 640x448, 704x448, 640x480, 704x480, 330x224, 660x224
+	- Sega SG-1000 - 256x192
+	- Sharp X1 - 320x200
+	- Sharp X68000 - Game-dependent
+	- Sinclair ZX Spectrum - 320x240
+	- Sinclair ZX81 - 256x192
+	- SNK Neo Geo CD - 320x224
+	- SNK Neo Geo Pocket - 160x152
+	- Sony PlayStation - 320x240, 256x240, 368x240, 512x240, 640x240, 320x480, 256x480, 368x480, 512x480, 640x480, 320x224, 512x268, 320x268, 640x224, 512x384
+	- Sony PlayStation 2 - 640x480, 640x448, 640x512, 596x447, 682x512
+	- Sony PlayStation Portable - 480x272
+	- Super Nintendo Entertainment System/Famicom - 256x224, 256x240, 512x224
+	- TCS Oric - 240x224
+	- Texas Instruments TI-83 - 96x64
+	- Thomson TO8 - 672x432
+	- TIC-80 - 240x136
+	- Uzebox - Game-dependent
+	- WASM-4 - 160x160
+	- Watara Supervision - 160x160
+	- Zeebo - 800x480
+
+## Emulator Setup
+
+### DuckStation
+
+- Go to Settings -> Capture and under Screenshots, set Screenshot Size to Internal Resolution (Aspect Uncorrected).
+
+![DuckStation Screenshot Size setting](/duckstation-screenshot-size.png)
+
+- To increase the internal resolution by 2x or 3x, go to Settings -> Graphics -> Rendering tab -> Internal Resolution. If you choose to do this, 3x Native is preferred for screenshots.
+
+![DuckStation Internal Resolution setting](/duckstation-internal-resolution.png)
+
+- All other settings can be default.
+
+### PCSX2
+
+- Go to Settings -> Graphics -> Media Capture tab and under Screenshot Capture Setup, set Resolution to Internal Resolution (No Aspect Correction).
+
+![PCSX2 Screenshot Resolution setting](/pcsx2-screenshot-resolution.png)
+
+- To increase the internal resolution by 2x or 3x, go to Settings -> Graphics -> Rendering tab -> Internal Resolution. If you choose to do this, 3x Native is preferred for screenshots.
+
+![PCSX2 Internal Resolution setting](/pcsx2-internal-resolution.png)
+
+- All other settings can be default, especially Aspect Ratio under the Display tab. Widescreen should not be used for PS2 screenshots (just to keep things simple and standard for the system).
+
+### Dolphin
+
+- Go to Settings -> Graphics -> Advanced tab and under Frame Dumping, set Resolution Type to Raw Internal Resolution.
+
+![Dolphin Screenshot Resolution Type setting](/dolphin-screenshot-resolution-type.png)
+
+- Widescreen is preferred for Wii screenshots, so go to Settings -> Wii and under Misc Settings, make sure Aspect Ratio is set to 16:9 (this should be the default).
+
+![Dolphin Wii Aspect Ratio setting](/dolphin-wii-aspect-ratio.png)
+
+- To increase the internal resolution by 2x or 3x, go to Settings -> Graphics -> Enhancements tab -> Internal Resolution. If you choose to do this, 3x Native is preferred for screenshots.
+
+![Dolphin Internal Resolution setting](/dolphin-internal-resolution.png)
+
+- All other settings can be default. Do not use widescreen for GameCube games.
+
+### PPSSPP
+
+- Go to Settings -> System -> General and set Screenshot Mode to Raw Game Image. Enabling "Save screenshots in PNG format" is also recommended.
+
+![PPSSPP Screenshot Mode setting](/ppsspp-screenshot-mode.png)
+
+- To increase the internal resolution by 2x or 3x, go to Settings -> Graphics -> Rendering Mode -> Rendering Resolution. If you choose to do this, 3x PSP is preferred for screenshots. Please note if this setting is set to Auto, the internal resolution will correspond with your Window Size setting.
+
+![PPSSPP Rendering Resolution setting](/ppsspp-rendering-resolution.png)
+
+- All other settings can be default.