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=v3.0pre2
+|author=TaraHoleInIt
-| lastupdated = 2020/05/20
+|lastupdated=2020/05/12
-| licence = Mixed
+|type=Computer
-| author = TaraHoleInIt
+|version=3.0pre2
-| website = https://github.com/TaraHoleInIt/minivmac-3ds
+|license=Mixed
-| download = https://dlhb.gamebrew.org/3dshomebrew/Minivmacv0.3.7z
+|download=https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds.7z
-| source = https://github.com/TaraHoleInIt/minivmac-3ds
+|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.
+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.
-== Mini vMac 3DS Port ==
 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.
-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.
-There is no sound, and I haven't attempted to look into it yet.
+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 [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
-Macintosh II emulation on the o3ds is SLOW, especially in 256colors
+Circle Pad/C-Stick or Touchscreen - Mouse
-If you're getting a black screen with the Macintosh II builds be patient, it just takes a bit to load (ESPECIALLY o3ds)
+After shutting MacOS down properly, press L+R+Start to exit or use the control mode interface.
 ==Screenshots==
-https://dlhb.gamebrew.org/3dshomebrew/ZVf3SmO.jpg
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds3.png
-https://dlhb.gamebrew.org/3dshomebrew/X0FV2xN.jpg
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds4.png
-==Keys:==
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds5.png
-* DPAD Is mapped to arrow keys
+https://dlhb.gamebrew.org/3dshomebrews/minivmac3ds6.png
-* Select switches between scale modes on the upper screen
-* Start toggles the Mini vMac control mode interface
-* L and R Shoulder buttons are the mouse button
-* Y Toggles the on screen keyboard
-* Circle pad and Circle stick move the mouse
-* Touchscreen moves the mouse
-* After shutting MacOS down properly, press L + R + Start to exit or use the control mode interface
-== What's working: ==
+==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>
-It boots on hardware! Touchscreen mouse CPad mouse Basic on screen keyboard DPAD Mapped to arrow keys
+'''Mini vMac 3DS WIP Keyboard Demo''' ([https://www.youtube.com/watch?v=oI2YOn-zCFE TarableCode]) <br>
+<youtube>oI2YOn-zCFE</youtube>
-== TODO: ==
+==Compatibility==
-Code cleanup Remove unused (all) SDL Audio code Optimize/speedup for o3ds
+Macintosh II emulation on the o3ds is slow, especially in 256colors.
 ==Changelog==
-'''Added:'''
+'''v3.0pre2 2020/05/12'''
-* Support for Macintosh II @16 colours
+* Slightly sped up display conversion.
-* Support for Macintosh II @256 colours
+* Added "Insert Disk" UI.
-* Support for circle stick on n3ds
+* Added super slow and unreadable 1024x768x8 variant.
-* Mouse on the touchscreen is now an absolute pointer
+* Added 512x384x2 variant.
-* CPad and CStick mouse speed move in relation to how far you move the stick
+* Added 800x480 variant.
-* Pressing X will now dismiss Mini vMac messages
+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.
-'''Updates:'''
+'''v2 2017/05/19'''
-* 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:'''
+Added:
-*Probably a bunch of stuff.
+* 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.
-== TODO (At some point): ==
+Updates:
-Sound Support Macintosh II variants Support screen widths/heights greater than 512px
+* 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.
-== Using ==
+Fixed:
-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...
+* Probably a bunch of stuff.
-== Notes ==
+==External links==
-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
+* 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