Get Info: #basiliskii

About the interoperability of System 7 and iOS

by Matt Sephton — Mon, 03 May 2021 00:00:00 +0000

It never fails to amaze me how at home System 7 feels on an iPad. In fact, I’d go so far as to say I’ve never felt more capable than when I’m using it this way. What a time to be alive!

Still, there are times when it makes sense to lean on the features of the host device to get your job done more easily. In this post I detail common tasks that involve “crossing the streams”.

File Conversions

When transferring files to/from System 7 you’re going to need to convert them to/from suitable formats to make your life easier. Below I’ve listed my approach to the most common file types. Of course, your task may differ but I hope this gives you some useful hints.

Bitmap files

I use Pixaki which is a fantastic native iPad app for creating pixel art. It will load either layered Photoshop or flat PNG files, both of which are easy to generate in System 7:

PSD: Photoshop 3.0
PNG: GraphicConverter 4.1

Vector files

Dealing with vector artwork produced in the Deneba apps that I use is a little trickier. We have to jump use a stepping stone or two. First we export a file that keeps the vector data—I tend to choose Illustrator 88—and then we load that into the majestic FreeHand and export an EPS from there.

I88: Illustrator 88 (aka version 1.7)
EPS: FreeHand 3/4/5

Textual data

I generally type in Markdown so plain-text TXT files work just fine and require no conversion. Programming source code files such as C, Pascal, or otherwise also transfer without incident.

You may have some luck with Rich Text RTF files, and also with some versions of the Microsoft Word DOC file format, to transfer formatted text both ways without having to convert it to other file formats.

More exotic document formats will be trickier, but LibreOffice can open number of older formats as read-only files. Examples are: AppleWorks, ClarisWorks, Nisus Writer, WordPerfect, and more.

Tabular data

Excel 4.0 has you covered for CSV, XLS and more.

File I/O

To get files out of System 7 simply drop them onto the File Sharing drive, open Files, and long press on the file to get a list of the available actions. The exact options that iOS will give you will depend on the apps you have installed. Don’t be a stranger over at the App Store!

Printing

To print any type of document from System 7, I make use of software that allows printing to a PDF. It’s worth noting that the result is a bitmap PDF, not vector, but it’s good enough to get hold of a quick hardcopy.

PDF: Acrobat PDFWriter 3.0

Of course, if you are working with vector files you’ll have a proper scalable vector PDF file that you can print in exactly the same way.

Once the PDF is in File Sharing, use iOS to print it wirelessly to an AirPrint compatible printer.

Multitasking

iOS is only a swipe away, so remember that you can access iOS apps and services and swipe System 7 away at any time.

Split View (if you enabled it when building BasiliskII) for side-by-side browsing in Safari
Slide Over for quick access to Files, Photos, Safari, etc.
Background to listen to Music or Podcasts
Picture-in-Picture for YouTube or other video playback

Downloading files

Safari will let you download classic Macintosh file formats. Even though it doesn’t know how to handle them, they will automatically be saved on your iPad in Downloads.

From there you can use Files to copy the file into BasiliskII’s File Sharing folder, or use the iOS Share Sheet to copy the file into BasiliskII and simultaneously open the emulator! Very handy. I use one or the other depending on my goal.

Some file formats you are likely to come across:

.hqx—BinHex file
.bin—MacBinary file
.sit—StuffIt archive
.cpt—CompactPro archive
.sea—self-extracting archive

The above files can be converted or extracted using StuffIt, MindExpander, or CompactPro. You might also see files with more than one extension, in which case don’t worry the file has been treated twice for good measure, you may have to open it twice in System 7 to get it into its final/original form.

.dsk—disk image
.img—disk image
.smi—self-mounting disk image

The above disk images can be mounted using StuffIt, ShrinkWrap, DiskCopy 6. You could also mount them in the BasiliskII interface, but I tend not to do so for disk images that I won’t have mounted for very long.

.iso—standard CD-ROM disk image
.toast—proprietary CD-ROM disk image

The above optical disk images should be mounted using the BasiliskII settings interface (shown at first launch, or whenever you shake your device). Disks mounted in this way will be available at every boot, and can only be removed by shutting down the system and restarting the emulator.

Turning an iPad Pro into the Ultimate Classic Macintosh
How to install BasiliskII on your iPad
Exploring Custom Keyboards and Automation
Optimising Macintosh app toolbars for touch
Macintosh drawing software compared
Mixing External Tools across Deneba software
My System 7 software choices
About the interoperability of System 7 and iOS

Building BasiliskII for iOS

by Matt Sephton — Wed, 21 Apr 2021 00:00:00 +0000

I’ve had numerous requests for a guide to building BasiliskII on iOS. Let me know of anything is unclear or would benefit from more details!

February 2024: Updated for building with Xcode 15.2 on macOS 14.3 to iOS 17.3. YMMV.

Building

Install Xcode from Mac App Store
Clone project source from GitHub
Switch to the ios branch
Open .xcodeproj file
Set Product > Destination to point to your device
Run

Optional Changes

These are changes I made that give a better experience on my specific iPad.

Adding chunky screen resolutions

I added chunky “half resolution” screen modes to increase the size of user interface elements so that buttons, menu items and so on are all around the 44pt recommended in the Apple iOS HIG.

For iPad Pro 12.9” these changes were:

[self addVideoMode:CGSizeMake(512, 496) to:videoModes]; // portrait minus keyboard
[self addVideoMode:CGSizeMake(512, 672) to:videoModes]; // portrait "full" screen
[self addVideoMode:CGSizeMake(683, 502) to:videoModes]; // landscape "full" screen

Enter those after line 61 in file B2ScreenView.mm

Disabling graphics smoothing

My personal preference is to disable filtering/smoothing on all graphics scaling, but only because I’ve dialled in resolutions that fit exactly so there will be no scaling happening anyway:

NSString *filter = kCAFilterNearest;
videoLayer.magnificationFilter = filter;
videoLayer.minificationFilter = filter;

Make this change at line 108 in file B2ScreenView.mm

Custom Keyboard Layouts

These are defined in JSON and compiled to a custom format:

source file location on GitHub
several regional layouts are already provided
you don’t have to make your own!

Here’s one that I made, based on the British layout, for use with Deneba artWORKS/UltraPaint. To install it you should copy the file artWORKS.nfkeyboardlayout to BasiliskII’s Keyboard Layout folder using the Files app on your iPad.

Enable Split View Support

This can be enabled by changing BasiliskII-Info.plist: UIRequiresFullScreen should be false in BasiliskII-Info.plist but be wary of the following problem:

the very top of the screen (where you’d expect the iOS status bar to be, and where part of the System 7 menu bar is) will become unresponsive to touch due to the Slide Over indicator

This would need to be managed/avoided by the screen layout of BasiliskII, but when I attempted this it raised more issues.

However, you can still use Slide Over to position Safari, Files, etc. along the edge of your screen.

Notes

There are additional capabilities that come with the emulator integration. I go further into these, and more besides, in a additional posts listed at the bottom of the page.

Keyboard

Swipe up/down with two fingers to show/hide the on-screen keyboard

Settings

Spread 4 or 5 fingers to show the BasiliskII Settings pop-up
Tap outside of the BasiliskII Settings pop-up to hide it
Settings can also be invoked through the app menu, long press the app icon

Custom screen size

Pinch with 2 fingers to dynamically resize screen
Separate tracking for horizontal and vertical resizing
Double-tap for full size screen

A drive appears on the desktop that is mapped to the iOS file sharing folder of the app.

You can use Files to transfer files into or out of the emulated machine
Share Sheet also works for getting files into the emulated machine
You can organise the files into folders using the Files app

Apple Pencil

This is supported the same way as regular touch so it acts as a mouse. Drawing works well and is very responsive, even at lower Hz.

Palm rejection is missing
Pressure sensitivity is missing
Multi touch seems to be missing

Turning an iPad Pro into the Ultimate Classic Macintosh
How to install BasiliskII on your iPad
Exploring Custom Keyboards and Automation
Optimising Macintosh app toolbars for touch
Macintosh drawing software compared
Mixing External Tools across Deneba software
My System 7 software choices
About the interoperability of System 7 and iOS

Turning an iPad Pro into the Ultimate Classic Macintosh

by Matt Sephton — Sat, 17 Apr 2021 00:00:00 +0000

I’ve started work on the next in my 1-bit Woodblocks series: “Tekagami” (Ito Shinsui’s “Hand Mirror”). So it’s a good time to talk about how I turned an iPad Pro into the ultimate Classic Macintosh.

Emulators

Both Macintosh emulators available on iOS we’re ported by @maczydeco who has done an amazing job making them feel truly at home on iOS. Many thanks! They need to be built from source using Xcode but it’s a pretty straight forward process.

Mini vMac

Supports System 1.1 to 7.5.5
Limited RAM and CPU emulation
File Sharing via bespoke method
No dynamic screen resolution changing
Odd interface using Control key shortcuts
Source code

BasiliskII

Supports System 7.0 to 8.1
Advanced RAM and CPU emulation
File Sharing via mapped folder
Dynamic screen resolutions through Monitors control panel, or automation
Native iOS interface for settings panel, negating all the issues with the desktop GUI
We have a winner!
Source code (use the ios branch)

This works a treat in both emulators, but the experience is better in BasiliskII.

With Mini vMac you need to run a special file import app, and then whilst it’s open use iOS Share Sheet to send a file to Mini vMac. These extra steps are just enough friction to make the emulator annoying to use.

With BasiliskII things are easier as it has a drive mapped to the app’s file sharing folder. You can use the Share Sheet in the same way as Mini vMac, but you can also simply copy/move a file to the BasiliskII folder and it will be accessible inside the emulator. The only gotcha with this approach is that you’re best moving the file to the emulated system’s main disk drive otherwise you’ll encounter various oddities with certain apps that don’t know how to cope with files located on this type of drive.

Screen Resolutions

The original Macintosh had a native screen resolution of 512×342.

Conceptually, the iPad has a logical screen resolution of 1024×768, which when running in pixel doubled mode equates to 512×384. A pretty good match. Specifically, the native resolution varies according to the model of iPad or iPhone you are using.

I use an iPad Pro 12.9” which has a native resolution of 2732×2048, pixel doubled that means 1366×1024, and pixel quadrupled 683×512. Targeting this ballpark of resolution means user interface elements will be around the magic 44pt tappable area, so that fingertip interactions are accurate, predictable and enjoyable.

Of course the iPad can flip between landscape and portrait orientations on demand, which means BasiliskII supporting the Monitors control panel is a big win.

So I added a bunch of custom resolutions to the BasiliskII soure code to add support for both pixel-doubled and pixel-quadrupled resolutions, in both portrait and landscape, with and without room for the software keyboard. I can switch between these resolutions with keyboard shortcuts. Which leads nicely on to…

Custom Keyboards

Both emulators share the same software keyboard mechanism. The keyboard layouts are user-editable as JSON and compiled into a custom format.

So I put together a custom keyboard layout that can be used in either emulator that gives me quick thumb access to tools and shortcuts in my most used apps: artWORKS and UltraPaint. It works for both apps as they are closely related, sharing a lot of code and resources.

With this keyboard layout I’m not only relabelling the function keys, but also replacing some key codes to reposition keys for my own purposes. The apps don’t respond to function keys so I use macros and Apple Events to get things to work as detailed in another post.

How does the experience compare to a real Macintosh?

The most important aspect of this setup is that it runs System 7 and the various apps I use. That is the core of my classic Macintosh experience and the goal I had in mind. The hardware running System 7 is merely a conduit.

That said, the iPad Pro is more portable, reliable and capable than my real Macintosh. That’s 30 years of hardware progress for you.

The iPad’s display in particular is a huge differentiator—it can assume so many different resolutions it should be thought of as a collection of displays rather than just a single one.

Apple Pencil is very similar in feel to my Wacom ArtPad II, but with the single huge improvement that you’re drawing directly on the screen. Drawing with an Apple Pencil on System 7 is every bit as good as drawing in a native iPad app.

iOS is only a swipe away: download classic software using a modern web browser like Safari, expand archives more quickly with Files or Documents, watch videos picture-in-picture, search your Inside Macintosh PDFs in Books, listen to streaming music, and so many other things that aren’t doable (or at least are extremely difficult to do) on a real classic Macintosh.

Bluetooth keyboards just work. The new/recent mouse pointer support in iOS also works. You could even plug the iPad into an external display to go full circle back to a desktop computer.

This setup gives me the best of both old and new worlds, and that’s why I refer to it as the Ultimate Classic Macintosh.

Turning an iPad Pro into the Ultimate Classic Macintosh
How to install BasiliskII on your iPad
Exploring Custom Keyboards and Automation
Optimising Macintosh app toolbars for touch
Macintosh drawing software compared
Mixing External Tools across Deneba software
My System 7 software choices
About the interoperability of System 7 and iOS

Elsewhere

2021-03-29—The Mac Observer
2021-04-18—Hacker News
2021-04-19—Boing Boing
2021-04-19—iDownloadBlog
2021-04-19—The Loop
2021-04-22—FredZone (in French)
2021-04-23—Gizmodo
2021-04-23—Pixel Envy
2021-04-26—iGeneration (in French)

Get Info: #basiliskii

About the interoperability of System 7 and iOS

File Conversions

File I/O

Printing

Multitasking

Downloading files

Related posts

Building BasiliskII for iOS

Building

Optional Changes

Adding chunky screen resolutions

Disabling graphics smoothing

Custom Keyboard Layouts

Enable Split View Support

Notes

Keyboard

Settings

Custom screen size

File Sharing

Apple Pencil

Related posts

Turning an iPad Pro into the Ultimate Classic Macintosh

Emulators

File Sharing

Screen Resolutions

Custom Keyboards

How does the experience compare to a real Macintosh?

Related posts

Elsewhere