Macintosh-Tools/uvmac
1
0
Fork 0
mirror of https://github.com/InvisibleUp/uvmac.git synced 2024-06-10 13:29:44 +00:00
Code Issues Projects Releases Wiki Activity

Merge branch 'master' of github.com:InvisibleUp/minivmac

Browse Source
This commit is contained in:
InvisibleUp 2023-04-01 15:42:13 -07:00
commit 35961b3152
1 changed files with 22 additions and 12 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

34
README.md
View File

@ -1,11 +1,32 @@
# µvMac 0.37.0
***THIS CODEBASE IS INCOMPLETE AND DOES NOT CURRENTLY COMPILE TO A USABLE PRODUCT. ALSO, IT IS NOT UNDER ACTIVE DEVELOPMENT.***
Forked from Mini vMac v36.4 by Paul C. Pratt (http://www.gryphel.com/c/minivmac), which was forked from vMac by Philip "PC" Cummins (http://www.vmac.org/main.html)
µvMac (micro vMac) is a small, simple emulator for early Motorola 68000 based emulators. Currently we support systems from the original Macintosh 128K all the way up to the Macintosh II.
This fork was created to clean up and modernize the code base, make the project easier to compile and hack on, and allow for much easier user configuration. The intent of Mini vMac was to create a "emulator collection" of many very optimized "variations" of the same codebase. I consider this much more trouble than it's worth, and intend to focus more on maintainability and accuracy.
## How to Compile
µvMac uses the Meson build system. See https://mesonbuild.com/ for instructions on how to download and use it.
1. Install the SDL2 libraries (On Ubuntu/Debian, this is `sudo apt install libsdl2-dev`. On Windows, see below.)
2. `git clone --recursive` this repository
3. Run `meson setup build`
4. Navigate to the `build/` directory and run `meson compile`
5. Add `vMac.ROM` (and possibly libsdl2.dll) to the build directory and run the program!
On Windows systems, you may need to run the following commands for SDL to work:
```
mkdir subprojects/
meson wrap install sdl2
```
Also, for now, for the M68K core to work, you need to compile Musashi yourself. Follow the instructions in that project's README for details.
## Supported Platforms
µvMac *absolutely requires* SDL2. There are no plans to support platforms that SDL2 does not target. For 99% of users, this should not be a concern. Dropping support for esoteric platforms and exclusively using SDL2 vastly simplifies the complexity of the code.
@ -33,18 +54,7 @@ The configuration manager will require resources from a ROM. Here's the screen y
![Flashing ? on a ROM chip, and a message asking you to find a ROM](docs/norom-mockup.gif)
## Compiling
µvMac uses the Meson build system. See https://mesonbuild.com/ for instructions on how to download and use it.
On Windows systems, you may need to run the following commands for SDL to work:
```
mkdir subprojects/
meson wrap install sdl2
```
Also, for now, for the M68K core to work, you need to compile Musashi yourself. Follow the instructions in that project's README for details.
## Legal info
## Legal Info
You can redistribute µvMac and/or modify it under the terms
of version 2 of the GNU General Public License as published by