My Nes GTK

1. System Requirements
2. Features
3. Important Notes
4. Installation
5. To stay up to date
6. What's new ?
7. GUI
    7.1 Menu: File
    7.2 Menu: Emulation
    7.3 Menu: State
    7.4 Menu: Game genie
    7.5 Menu: Recorder
    7.6 Menu: Settings
8. Settings
    8.1 Video
    8.2 Sound
    8.3 Paths
    8.4 Input
    8.5 Palette
9. Credits
10. Links

1. System Requirements

Since My Nes emulation core is designed to perform accurate emulation, it requires a decent hardware.

OS: Microsoft Windows® XP / Vista/ 7 and 8, Linux.

Processor: 2 GHz or faster (Intel or AMD)

Memory: 256 Mb RAM or larger

GTK#, visit: http://www.mono-project.com/GtkSharp
NOTE: My Nes GTK is compatible with gtk-sharp-2.12.10.win32 version. It should work on newer versions too. In 64-bit pcs MyNesGTK may fail to launch, if this happen:
Go to folder : "C:\Program Files (x86)\GtkSharp\2.12\bin", copy all files then paste them in MyNesGTK folder.
Mono runtime (Linux users only). For 64-bit pc you may need to install McMyAdmin .
SDL.NET, visit: http://cs-sdl.sourceforge.net/

[TOP]

2. Features

My Nes GTK Edition:

Save/Load state.
Multi-Renderer.
User can create profiles for controls mapping.
Supports BotGod xml database which used for detecting additional rom information like MMC3 board revision.

Emulation Features:

CPU: all instruction including the undocumented. Emulates the interrupts check at the last cycle operation plus the interrupt vector changing behavior.
PPU: exact ppu cycle timing, exact vbl and nmi behavior, accurate sprites evaluation emulation.
APU: accurate frame counter, accurate dmc irqs and channels clocks on real cpu frequency.
Sound Channels: All internal channel, MMC5, Namcot106, SunsofB5 and VRC6.
Supports 4 players.
Supports Zapper.
Supports Vs-UniSystem.
Supports Game Genie.
TV Systems: NTSC, PALB and Dendy.
Supported mappers and boards: almost full set, some boards not supported because of developers couldn't find a proper documents and roms for test.

[TOP]

3. Important Notes

My Nes GTK is compatible with gtk-sharp-2.12.10.win32 version. It should work on newer versions too. In 64-bit pcs MyNesGTK may fail to launch, if this happen:
Go to folder : "C:\Program Files (x86)\GtkSharp\2.12\bin", copy all files then paste them in MyNesGTK folder.

Linux users should use Mono runtime to run MyNesGTK.exe

In Linux platform: If the emulator window show up with black screen and the emulator hang, this is a sound issue, visit http://cs-sdl.sourceforge.net/ for more information or simply disable the sound. The terminal should show the error message.

[TOP]

4. Installation

Windows users:

Extract MyNesGTK package somewhere in your disk.

Install Microsoft .net framework 4.

Install GTK# "http://www.mono-project.com/GtkSharp"
Install SDL.NET "http://cs-sdl.sourceforge.net/"
Run MyNesGTK.exe.

Linux users:

Extract MyNesGTK package somewhere in your disk.
Install mono including GTK# with all dependencies: http://www.mono-project.com/
Install C# SDL: http://cs-sdl.sourceforge.net/
Run MyNesGTK.exe using mono runtime. Mono runtime (terminal) is recommended.

[TOP]

5. To stay up to date

My Nes GTK Edition depends on My Nes core. For every release of My Nes:

Download the latest release version then put these dlls in MyNesGTK folder, replace the old ones :
NesCore.dll
Renderers.dll
CPRenderers.dll (in Renderers folder).

My Nes GTK is fully compatible with My Nes 5.x core, any release version 5.x should work.

[TOP]

6. What's new ?

version 2.0:

Added NesCore 5 (updated core from version 4 to 5) compatibility.
Added MyNes Renderers system compatiblity.
Added more options for renderers, video, sound, input, palette, paths and emulation system.
Added game genie code editor.
Added sound recorder.

[TOP]

7. GUI

7.1 Menu: File

Open: to open rom file.
Quit: exit My Nes GTK

[TOP]

7.2 Menu: Emulation

Toggle pause: when game is running, use this to pause/resume emulation.
Turn off: shutdown emulation.
Hard reset: reset the game with hard reset mode, this mean just like turn of nes then turn on.
Soft reset: this will reset nes emulation in soft mode.

[TOP]

7.3 Menu: State

Slot: choose where you want to save state. You can use 10 different slots for each game.
Save: save the game state at selected slot.
Save as: save the state as file.
Load: load the game state from selected slot.
Load as: load the game state from file.

[TOP]

7.4 Menu: Game genie

Active: to active game genie. emulation must be on (playing a game)
Configure: to access the Game Genie code editor.

[TOP]

7.5 Menu: Recorder

Record sound: when a game is running, click this to record sound. Click this again to stop recording.

[TOP]

7.6 Menu: Settings

Renderers: allows to choose renderer. Renderer is the library that render video and sound, handles input mappings for My Nes core.

Video: allows to configure video settings. See Video
Sound: allows to configure sound settings. See Sound
Pahs: allows to configure paths settings. See Paths
Input: allows to configure input settings. See Input
Palette: allows to change palette settings. See Palette
Emulation sustem: allow to change tv system (NTSC, PALB or DENDY). Auto means My Nes core will automatically switch tv system.

[TOP]

8. Settings

8.1 Video

Fullscreen resolution: select the screen resolution when switching to fullscreen.
Keep aspect ratio: If enabled, the renderer will keep aspect ratio of nes resolution (256 x 240) when renderering with larger/smaller resolution.
Launch game in fullscreen: if enabled the game will start in fullscreen mode.
Immediated mode: if enabled, the renderer will not wait for the full image to render. If disabled, the renderer will wait for the image to render completly. This is just like VSync, not work with PALB tv system propably.
Hide upper and lower lines: nes not show all 256 x 240 pixels in the screen, instead it hides upper and lower 8 lines in NTSC tv system or 1 lower and upper line in PALB system. With this option enabled, My Nes core will hide these lines otherwise will show all 256 x 240 pixels.
Show FPS: if enabled the renderer will show the fps (Frames per seconds) in the top left corner. The format (xx/xx) is FPS/Total FPS can make.
Show notifactions: if enabled, My Nes core will draw important events notifications such as state saved, state loaded ...etc
Stretch multiply: this number will determine renderer window size in format:
(256 * n x 240 * n) while n is entered number.
n=1 then window size is 256 x 240
n=2 then window size is 512 x 480
....
Screenshot format: the image format when taking snapshot.

[TOP]

8.2 Sound

Sound enabled: active this option to active sound playback. This option will not effect the sound emualtion in the core since it required.

Volume: adjust the volume level.

Frequency: select the sound render frequency.

[TOP]

8.3 Paths

State folder: the folder where state files saved when you save state for a game.

Snapshots folder: the folder where snapshots are saved when you take a snapshot.

[TOP]

8.4 Input

In the input settings window:

Profiles: My Nes work in this way, there are control profiles. Each profile can save different control mappings. In this window, selected profile will be the active one. You can delete, edit and add profiles. You can change profile any time, go to Settings>Input>Profile>your profile.
Player 1,2,3,4: allows to edit the control mappings for players.
Emulation: the emulation shortcuts like save state, load state, switch to fullscreen ...etc
Emulation shortcuts: general option like connect zapper and 4 players control. Usually, My Nes work for 2 controls, player 1 and 2. You need to active this connect 4 players option in order to use all 4 players. This option is disabled by default because of the 4 players emulation may affect emulation speed and it's not required to be active all the time. Same for zapper.
VSUnisystem DIP: the VS Unisystem controls. Work only for VS roms.