From 7217042b2ba9797f7c69c961a8f023a8d9d0b856 Mon Sep 17 00:00:00 2001 From: kub Date: Sun, 30 Mar 2025 23:30:42 +0200 Subject: [PATCH] update readme files --- README.md | 14 ++++++++--- platform/base_readme.txt | 50 +++++++++++++++++++++++++++++----------- 2 files changed, 48 insertions(+), 16 deletions(-) diff --git a/README.md b/README.md index 7d15497c..3b2f40ab 100644 --- a/README.md +++ b/README.md @@ -29,8 +29,16 @@ Further instructions can be found in `platform/base_readme.txt`. PicoDrive can use Storyware pages and pad overlays in png format in the same directory as the cartridge image. The selected page is displayed automatically if the pen is used on the storyware or pad. Details about how to correctly name -the pages can be found in the *How to run Sega Pico games* section in -`platform/base_readme.txt`. +the pages can be found in `platform/base_readme.txt`. + +### Sega Pico Pen and Sega Mouse + +On all platforms with physical mouse support, PicoDrive can use real mouse +input to emulate a Sega Mouse or the Pico Pen. A physical mouse can be operated +in either a captured or uncaptured state, selectable via the `Capture mouse` hotkey. +Mouse mode can be activated by setting `mouse` as the input device for one +of the pads. It depends on the game as to which pad should be used for mouse +input. More information is located in `platform/base_readme.txt`. ### Sega Pico and SC-3000 Keyboards @@ -42,7 +50,7 @@ Both physical keyboard support and a virtual keyboard overlay are available. Physical keyboards are assigned a default key mapping corresponding to an American PC layout, but the mapping can be redefined in the `Controls` configuration menu. Note that only 'unmodified' physical key presses (e.g. -`A`, `1` etc) can be mapped to emulated keyboard input; special characters +`a`, `1` etc) can be mapped to emulated keyboard input; special characters entered via modifier/meta keys (e.g. `Ctrl`, `Shift` etc) will not work. Additional information may be found in `platform/base_readme.txt`. diff --git a/platform/base_readme.txt b/platform/base_readme.txt index cd5030e7..69424c42 100644 --- a/platform/base_readme.txt +++ b/platform/base_readme.txt @@ -95,23 +95,34 @@ scaled to fit the screen. There are 2 menu actions for switching to pages or pad which will automatically display the images if they are available. To allow for proper pen positioning -there is also an action for having the pen on the page/touchpad or not. Pen -positioning is done through the D-pad if the screen has been switched to either -pages or pad. +there is also a function for having the pen on the page/touchpad or not, the +toggle for which is mapped to the START pad button. Pen positioning is done +through the D-pad if the screen has been switched to either pages or pad, or by +mouse if physical mouse support is activated. -How to load SC-3000 tapes -------------------------- +How to use the mouse +-------------------- + +If the host system has physical mouse support, PicoDrive can use real mouse +input to emulate a Sega Mouse on a MegaDrive base, or to control the Pico Pen. +To activate this functionality, select `mouse` as the input device for one of +the pads. It depends on the game as to which pad should be used for mouse +input. +For Pico games, one input device should be set to `pad`, the other to `mouse`. -The SC-3000 microcomputer has a connector for connecting a cassette tape drive -to it. PicoDrive supports using tape recordings in WAV or bitstream format. -Run one of the BASIC cartridges, then load the tape with the "Load tape" menu. -Entering the LOAD command using the keyboard emulation automatically starts -the emulated tape drive. You will get a confirmation after the tape has been -loaded. +A physical mouse can be operated in either a captured or uncaptured state, +selectable via the `Capture mouse` hotkey. In captured mode, mouse movements +for the whole screen are sent to PicoDrive; in uncaptured mode, only mouse +movements inside the PicoDrive window are tracked. -The emulated tape drive has an automatic start/stop feature. Tapes requiring -several load operations don't need any additional handling. +The physical mouse buttons are mapped as follows: + +| Physical Mouse | Sega Mouse | Pico Pen | +|:--------------:|:----------:|:-----------:| +| Left Button | B | Pen Button | +| Middle Button | START | Red Button | +| Right Button | C | Pen Up/Down | How to use keyboard input @@ -139,6 +150,19 @@ on the state the color of the key changes slightly. Only one meta key can be active at the same time. +How to load SC-3000 tapes +------------------------- + +The SC-3000 microcomputer has a connector for attaching a cassette tape drive. +PicoDrive supports tape recordings in WAV or bitstream format. Run one of the +BASIC cartridges then load the tape image via the `Load tape` menu. Entering +the `LOAD` command using the emulated keyboard automatically starts the virtual +tape drive. Confirmation will usually be provided after the tape has been read. + +The virtual tape drive has an automatic start/stop feature. Tapes requiring +several load operations are handled without the need for user intervention. + + Other important stuff --------------------- -- 2.39.5