Mini vMac 3DS: Difference between revisions

Mini vMac
Mini vMac
General
Author	TaraHoleInIt
Type	Computer
Version	3.0pre2
License	Mixed
Last Updated	2020/05/12
Links
	Download
	Website
	Source

Latest revision as of 06:00, 6 Mayıs 2024

This is a port of Paul C. Pratt's Mini vMac to the Nintendo 3DS and New Nintendo 3DS.

It is a miniature early Macintosh emulator, currently supports Macintosh Plus and Macintosh II with multiple resolution options.

Installation

Note: Requires the BIOS ROM (vMac.ROM for Macintosh Plus, MacII.ROM for Macintosh II) and disk images to run.

Disk images must be auto loaded at runtime so make sure they're named diskX.dsk where X is 1 to how many images you want to load.

Make sure to have your OS image already to go before copying your disks to your 3DS, as you cannot swap disks to complete the install on the 3DS.

Place everything (3DSX, ROM, OS image and disk images) in sdmc:/3ds/vmac/, then run with the Homebrew Launcher (for Citra, put the ROM on root).

User guide

If you are getting a flashing disk and nothing else, make sure your first disk image (disk1.dsk) is a valid bootable Mac System disk.

It's best to verify your disk images in the desktop version of Mini vMac before copying your disk images over to your 3DS.

If you're getting a black screen with the Macintosh II builds be patient, it just takes a bit to load (especially O3DS).

Supported options include:

1 Bit colour depth, 2 Bit colour depth, 4 Bit colour depth and 8 Bit colour depth.
Resolutions >= 512x384 Resolutions <= 1024x1024.
Sound Sound sample size.
And many more, feel free to experiment.

More information about Mini vMac in general can be found at the original Mini vMac's site.

Controls

D-Pad - Arrow keys

Select - Switch between scale modes on the upper screen

Start - Toggle Mini vMac control mode interface

L/R - Mouse click

Y - Toggle on-screen keyboard

Circle Pad/C-Stick or Touchscreen - Mouse

After shutting MacOS down properly, press L+R+Start to exit or use the control mode interface.

Screenshots

Media

Warcraft: Orcs and Humans on Mini vMac on Nintendo 3DS (TarableCode)

Mini vMac 3DS WIP Keyboard Demo (TarableCode)

Compatibility

Macintosh II emulation on the o3ds is slow, especially in 256colors.

Changelog

v3.0pre2 2020/05/12

Slightly sped up display conversion.
Added "Insert Disk" UI.
Added super slow and unreadable 1024x768x8 variant.
Added 512x384x2 variant.
Added 800x480 variant.

Changes:

In disk insert mode, B goes up one directory level and X cancels.

v3.0pre1 2020/05/09

Readying for test release.

v2.1 2017/05/19

Fixed background clear colour from green to black.

v2 2017/05/19

Added:

Support for Macintosh II @16 colours.
Support for Macintosh II @256 colours.
Support for circle stick on n3ds.
Mouse on the touchscreen is now an absolute pointer.
CPad and CStick mouse speed move in relation to how far you move the stick.
Pressing X will now dismiss Mini vMac messages.

Updates:

Mini vMac source base 3.5.1 beta.
1BPP Framebuffer conversion should be just under 3x faster on o3ds.
Updated partial framebuffer updates to accept left/right box.

Fixed:

Probably a bunch of stuff.

External links

Author's Tweet - https://twitter.com/TarableI/status/1257500220914651138
GitHub - https://github.com/TaraHoleInIt/minivmac-3ds
GBAtemp - https://gbatemp.net/threads/mini-vmac-for-3ds.439119

@@ Line 1: / Line 1: @@
-{{Infobox-3DS-Homebrews
+{{Infobox 3DS Homebrews
-| title = Mini vMac
+|title=Mini vMac
-| image = https://dlhb.gamebrew.org/3dshomebrew/Mini-vMac.jpeg|250px
+|image=Minivmac3ds2.png
-| type = Computer
+|description=Macintosh Plus and Macintosh II emulator.
-| version=1.0.2-Initial
+|author=TaraHoleInIt
-| lastupdated = 2017/06/07
+|lastupdated=2020/05/12
-| licence = Mixed
+|type=Computer
-| author = TaraHoleInIt
+|version=3.0pre2
-| website = https://github.com/TaraHoleInIt/mini-vmac-3ds-plus4M
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/Mini-vMac-3DS.rar
+|download=https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds.7z
-| source =  https://github.com/TaraHoleInIt/mini-vmac-3ds-plus4M
+|website=https://gbatemp.net/threads/mini-vmac-for-3ds.439119
+|source=https://github.com/TaraHoleInIt/minivmac-3ds
 }}
-<youtube>H3PkjTK8ebY</youtube>
+This is a port of Paul C. Pratt's [https://www.gryphel.com/c/minivmac/index.html Mini vMac] to the Nintendo 3DS and New Nintendo 3DS.
-===== Updated version: [https://github.com/TaraHoleInIt/minivmac-3ds https://github.com/TaraHoleInIt/minivmac-3ds] =====
+It is a miniature early Macintosh emulator, currently supports Macintosh Plus and Macintosh II with multiple resolution options.
-= Mini vMac 3DS Port =
+==Installation==
-Macintosh Plus with 4MB variant Most changes/3ds GLUE in src/MYOSGLUE.c
+'''Note:''' Requires the BIOS ROM (vMac.ROM for Macintosh Plus, MacII.ROM for Macintosh II) and disk images to run.
-== What's working: ==
+Disk images must be auto loaded at runtime so make sure they're named diskX.dsk where X is 1 to how many images you want to load.
-It boots on hardware! Touchscreen mouse CPad mouse Basic on screen keyboard DPAD Mapped to arrow keys
+Make sure to have your OS image already to go before copying your disks to your 3DS, as you cannot swap disks to complete the install on the 3DS.
-== TODO: ==
+Place everything (3DSX, ROM, OS image and disk images) in sdmc:/3ds/vmac/, then run with the Homebrew Launcher (for Citra, put the ROM on root).
-Code cleanup Remove unused (all) SDL Audio code Optimize/speedup for o3ds
-== TODO (At some point): ==
+==User guide==
-Sound Support Macintosh II variants Support screen widths/heights greater than 512px
+If you are getting a flashing disk and nothing else, make sure your first disk image (disk1.dsk) is a valid bootable Mac System disk.
-= Using =
+It's best to verify your disk images in the desktop version of Mini vMac before copying your disk images over to your 3DS.
-Place vMac.ROM in /3ds/vmac/ along with your disk images Place ui_kb_lc.png, ui_kb_uc.png, and ui_kb_shift.png in /3ds/vmac/gfx Disks must be autoloaded at the moment so name them disk1.dsk, disk2.dsk, ect...
-* L and R Shoulder buttons are a mouse click L + R + START Exits (Be sure to do Special-&gt;Shutdown first)
+If you're getting a black screen with the Macintosh II builds be patient, it just takes a bit to load (especially O3DS).
-* SELECT Toggles screen scaling mode
-* START Toggles the Mini vMac control mode interface
-* Y Toggles the on screen keyboard
-== Notes ==
+Supported options include:
-This is a very early WIP port so if it crashes/hangs/murders you... I dunno... Some frames may be dropped/skipped when running on an o3ds
+* 1 Bit colour depth, 2 Bit colour depth, 4 Bit colour depth and 8 Bit colour depth.
+* Resolutions >= 512x384 Resolutions <= 1024x1024.
+* Sound Sound sample size.
+* And many more, feel free to experiment.
+More information about Mini vMac in general can be found at the original [http://www.gryphel.com/c/minivmac/ Mini vMac's site].
+==Controls==
+D-Pad - Arrow keys
+Select - Switch between scale modes on the upper screen
+Start - Toggle Mini vMac control mode interface
+L/R - Mouse click
+Y - Toggle on-screen keyboard
+Circle Pad/C-Stick or Touchscreen - Mouse
+After shutting MacOS down properly, press L+R+Start to exit or use the control mode interface.
+==Screenshots==
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds3.png
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds4.png
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds5.png
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds6.png
+==Media==
+'''Warcraft: Orcs and Humans on Mini vMac on Nintendo 3DS''' ([https://www.youtube.com/watch?v=mu41aNuXF_Q TarableCode]) <br>
+<youtube>mu41aNuXF_Q</youtube>
+'''Mini vMac 3DS WIP Keyboard Demo''' ([https://www.youtube.com/watch?v=oI2YOn-zCFE TarableCode]) <br>
+<youtube>oI2YOn-zCFE</youtube>
+==Compatibility==
+Macintosh II emulation on the o3ds is slow, especially in 256colors.
+==Changelog==
+'''v3.0pre2 2020/05/12'''
+* Slightly sped up display conversion.
+* Added "Insert Disk" UI.
+* Added super slow and unreadable 1024x768x8 variant.
+* Added 512x384x2 variant.
+* Added 800x480 variant.
+Changes:
+* In disk insert mode, B goes up one directory level and X cancels.
+'''v3.0pre1 2020/05/09'''
+* Readying for test release.
+'''v2.1 2017/05/19'''
+* Fixed background clear colour from green to black.
+'''v2 2017/05/19'''
+Added:
+* Support for Macintosh II @16 colours.
+* Support for Macintosh II @256 colours.
+* Support for circle stick on n3ds.
+* Mouse on the touchscreen is now an absolute pointer.
+* CPad and CStick mouse speed move in relation to how far you move the stick.
+* Pressing X will now dismiss Mini vMac messages.
+Updates:
+* Mini vMac source base 3.5.1 beta.
+* 1BPP Framebuffer conversion should be just under 3x faster on o3ds.
+* Updated partial framebuffer updates to accept left/right box.
+Fixed:
+* Probably a bunch of stuff.
+==External links==
+* Author's Tweet - https://twitter.com/TarableI/status/1257500220914651138
+* GitHub - https://github.com/TaraHoleInIt/minivmac-3ds
+* GBAtemp - https://gbatemp.net/threads/mini-vmac-for-3ds.439119