From mboxrd@z Thu Jan  1 00:00:00 1970
Received: from wopr.sciops.net ([216.126.196.60]) by ewsd; Mon Jan 27 17:35:04 EST 2020
Received: (qmail 27449 invoked by uid 1012); 27 Jan 2020 14:34:55 -0800
Date: Mon, 27 Jan 2020 14:34:55 -0800
From: qwx <qwx@sciops.net>
To: 9front@9front.org
Subject: Re: [9front] nintendo(1) improvements
Message-ID: <20200127223455.GA27265@wopr>
References: <7C9235B79BBCE8EC8B44C76CB45FC330@antares-labs.eu>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <7C9235B79BBCE8EC8B44C76CB45FC330@antares-labs.eu>
List-ID: <9front.9front.org>
List-Help: <http://lists.9front.org>
X-Glyph: ➈
X-Bullshit: table persistence HTTP app configuration dependency solution 

On Mon, Jan 27, 2020 at 10:34:37PM +0100, rgl@antares-labs.eu wrote:
> is it OK to commit this?
> 
> -rodri

Hello,

Thanks for spotting that typo and making these additions.

I'm not sure it's worth documenting the extra keys, but if we do, 
we have to do it for more than just the nintendo(1) emulators, 
since there's now a body of common code for these.

These function keys should also work for 2600(1), sega(1) and games/c64.

If I may make some suggestions, should we decide to go through with this:

- F1 just pauses the game, you can either resume normal operation with the
space key, or press F1 again to step 1 frame, other key presses are ignored.
There's no real "framestep mode".

- to be more precise, F12 prints the emulation speed (ratio between the
expected and observed time it took to draw 60 frames), outside the
drawing area.

- there's also 't', which toggles tracing of the entire emulation
for debugging.

- ` is an unauthorized toggle, deemed dangerous and unsportsmanlike
by starfleet engineers.  However, if you really must document it,
please state exactly what it does, all jokes aside: it uncaps the frame
rate and lets emulation go as fast as possible.  And maybe mention in
BUGS that it is unadvisable and unsportsmanlike?  Dunno.

Just my 2 cents.

Thanks!

qwx

> diff -r 287d82efe5f2 sys/man/1/nintendo
> --- a/sys/man/1/nintendo	Mon Jan 13 23:22:35 2020 +0000
> +++ b/sys/man/1/nintendo	Mon Jan 27 22:30:13 2020 +0100
> @@ -55,15 +55,25 @@
>  .I snes
>  are emulators for the Nintendo Game Boy and Game Boy Color (GB and GBC), Nintendo Game Boy Advance (GBA), Nintendo Entertainment System (NES), and Super Nintendo Entertainment System (SNES).
>  They execute the romfile given as an argument.
> -The \fBz\fR, \fBx\fR, \fBa\fR, \fBs\fR, \fBq\fR, \fBw\fRreturn and shift keys correspond to B, A, Y, X, L1, L2, Start and Select, respectively.
> +The \fBz\fR, \fBx\fR, \fBa\fR, \fBs\fR, \fBq\fR, \fBw, \fRreturn and shift keys correspond to B, A, Y, X, L1, L2, Start and Select, respectively.
>  Other keys:
>  .TP
> +F1
> +Enter framestep mode.  Every key press will advance one video frame at
> +a time until Esc is pressed.
> +.TP
>  F5
>  Save the current state in \fBgb.save\fR / \fBgba.save\fR / \fBnes.save\fR / \fBsnes.save\fR.
>  .TP
>  F6
>  Load the current state from \fBgb.save\fR / \fBgba.save\fR / \fBnes.save\fR / \fBsnes.save\fR.
>  .TP
> +F12
> +Toggle the profiler.
> +.TP
> +`
> +Reach speeds no man has reached before.
> +.TP
>  Esc
>  Pause the emulator.
>  .TP