Scummvm Documentation
Total Page:16
File Type:pdf, Size:1020Kb
ScummVM Documentation Mar 05, 2021 GSOD Proposal 1 Objectives 1 2 The current situation 3 3 Fixing the problem 5 3.1 Suggested documentation structure...................................5 3.2 Plan of attack...............................................6 4 Proposed timeline 9 4.1 Community bonding...........................................9 4.2 Week 1..................................................9 4.3 Week 2..................................................9 4.4 Week 3..................................................9 4.5 Week 4.................................................. 10 4.6 Week 5.................................................. 10 4.7 Week 6.................................................. 10 4.8 Week 7.................................................. 10 4.9 Week 8.................................................. 11 4.10 Week 9.................................................. 11 4.11 Week 10................................................. 11 4.12 Week 11................................................. 11 5 Quick start guide 13 6 PSP 15 7 Raspberry Pi 17 7.1 System requirements........................................... 17 7.2 Downloading and installing ScummVM................................. 17 7.3 Loading games onto the Raspberry Pi.................................. 17 7.4 Adding games to ScummVM...................................... 18 7.5 Launching games............................................. 22 8 Game settings 23 8.1 Game tab................................................. 23 8.2 Graphics tab............................................... 23 8.3 Audio tab................................................. 24 i 8.4 Volume tab................................................ 25 8.5 MIDI tab................................................. 25 8.6 Paths tab................................................. 26 9 Global settings 27 9.1 Graphics tab............................................... 27 9.2 Audio tab................................................. 28 9.3 Volume tab................................................ 28 9.4 MIDI tab................................................. 28 9.5 Paths tab................................................. 29 9.6 Misc tab................................................. 30 10 Keyboard Shortcuts 31 11 The Launcher 35 11.1 The games list.............................................. 36 11.2 Quick search............................................... 36 11.3 The buttons................................................ 36 11.4 The Global Main Menu......................................... 41 12 Command line interface 43 12.1 Launching ScummVM.......................................... 43 12.2 Launching saved games......................................... 45 12.3 Examples................................................. 47 13 The configuration file 49 13.1 Location................................................. 49 13.2 Keywords................................................. 49 13.3 Example file............................................... 51 14 Graphic filters 53 15 Render modes 55 16 Welcome to ScummVM! 57 16.1 First steps................................................. 57 16.2 How do I. ?............................................... 57 16.3 Advanced features............................................ 58 16.4 Getting help............................................... 58 16.5 The ScummVM Project......................................... 58 ii CHAPTER 1 Objectives 1. To produce high-quality, versioned end user documentation by consolidating large amounts of information from disparate sources and re-writing information for clarity, consistency, and completeness. Documentation should be easy to understand for beginners, without being patronizing to tech-savvy users. 2. To create a documentation portal using a static-site generator. 3. To future-proof end user documentation by creating templates and detailed how-to instructions for future open source contributors. 1 ScummVM Documentation 2 Chapter 1. Objectives CHAPTER 2 The current situation • The available ScummVM documentation is spread across multiple sources. • Information is hard to find and often duplicated; it’s easy to get lost in obscure pages. • It’s hard to know what information is current, and what is out of date. • Some information is missing or incomplete. 3 ScummVM Documentation 4 Chapter 2. The current situation CHAPTER 3 Fixing the problem 3.1 Suggested documentation structure Landing Page |-- Getting Started | `-- Quick start guide |-- Installing ScummVM | |-- Nintendo 3DS | |-- AmigaOS | |-- Android | |-- (every) | |-- (common) | |-- (supported) | `-- (platform) |-- Using ScummVM | |-- The Launcher | |-- Global settings | |-- Game settings | `-- Keyboard shortcuts |-- Advanced options | |-- Cloud and LAN | |-- Control Mapping | |-- Configuration | |-- Command line options | |-- Graphics | `-- Music and sound |-- Help | |-- FAQ | |-- Contacts | |-- Known problems | `-- Reporting a bug `-- Release Notes Getting started 5 ScummVM Documentation New users often look for a quick start guide to get going as quickly as possible. While the install of ScummVM can be complex on some platforms, installing it onto a computer is not. The quickstart guide should cover the following: • How to install ScummVM onto Windows, Mac and Linux. • How to load, add and launch a game. Installing ScummVM In cases where the install is not intuitive, or where the user may not have a strong technical base, the user needs a comprehensive guide for installing ScummVM on any of the supported platforms. Each comprehensive installation page should cover the following: • Any system requirements/prerequisites. • How to download the appropriate version of ScummVM. • How to install ScummVM. • How to load games onto the chose platform, especially where it is not the platform the game was designed for. • How to launch ScummVM, add a game, and launch a game. Using ScummVM Users need reference documents that explain how to use ScummVM. The reference documents should cover the following: • The Launcher interface; what each window and tab looks like as well as how they function. • An explanation of the available settings, both global and game-specific. • Keyboard shortcuts/hotkeys. Advanced options Advanced users need additional, more technical information about the options available to them for tweaking how their games run. Release notes While our documentation will be versioned, having a Release Notes section may be helpful to provide a summary of changes in the latest release. This may include some areas which are currently outside the scope of this documentation, such as newly supported games or information about new engines. 3.2 Plan of attack I propose to start by creating a template for the Installing ScummVM pages, as that will be the easiest way for me to get the information I require from port maintainers/developers (especially where this information is scant or does not exist). I will pre-fill any information I already have from existing documentation, which can then be checked for completeness, accuracy, and currency, or added to as necessary. Next I will comb the existing documentation; README, wiki and website. As I go, I will re-write and add to each section as required and pull all the information into the new portal. I will also make note of what information is pulled from where, to ensure that once the portal is live there are no double-ups, contradictions, or other anomalies. Throughout, I will liaise with the mentor(s), developers, port maintainers, and any other subject matter experts to source any missing information, as well as ensuring each page is as up-to-date and comprehensive as possible. 6 Chapter 3. Fixing the problem ScummVM Documentation In the spirit of collaboration and subject to approval from the mentor(s), I would like to have the work-in-progress portal accessible to the ScummVM community throughout the writing process, to receive real-time feedback and ensure nothing is missed along the way. I suggest using a style guide, such as the Google developer documentation style guide, to ensure consistency for this body of work and for all documentation moving forward. Wherever possible, I will use screenshots, gifs, and other visual aids to enhance understanding. 3.2. Plan of attack 7 ScummVM Documentation 8 Chapter 3. Fixing the problem CHAPTER 4 Proposed timeline 4.1 Community bonding August 17 - September 13, 2020 • Continue to spend time talking to the mentor(s) and the wider ScummVM community to fine-tune the vision for the project and finalise details such as document structure and content. 4.2 Week 1 September 14 - September 20 • Create a template for the platform-specific installation pages. • Pre-fill the templates with any existing information and distribute to the appropriate port maintainers/developers for further information. 4.3 Week 2 September 21 - September 27 • Set up the new documentation portal. 4.4 Week 3 September 28 - October 4 • Using ScummVM: – The interface 9 ScummVM Documentation – Global settings • Installing ScummVM: – Platform-specific installation guides as completed templates are returned to me. 4.5 Week 4 October 5 - October 11 • Using ScummVM: – Game settings – Keyboard shortcuts • Installing ScummVM: – Platform-specific installation guides as completed templates are returned to me 4.6 Week 5 October 12 - October 18 • Advanced options: – Cloud and LAN – Control Mapping • Installing ScummVM: – Platform-specific installation guides as completed templates are returned to me 4.7