You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is the source code for LisaEm 1.2.7. LisaEm is a emulator that runs on a wide variety of modern and somewhat old systems by means of the wxWidgets framework, implementing an emulation of the (in)famous Apple Lisa Computer. The Apple Lisa computer is the predecesor of the Mac and the "inspiration" of many GUI environments from Windows 1.x to GEOS. Many of the original ideas of the modern GUI were first envisioned in the Apple Lisa, so it's a historically very important machine.
13
+
14
+
This document contains a few brief updates that are also found in the ChangeLog file, as well as some information on how to compile wxWidgets and LisaEm.
15
+
(The updates will go away once the bugs are removed as ChangeLog is better suited for them.)
16
+
17
+
## 2020.02.22
18
+
19
+
I've made many fixes, but there are still about a dozen bugs left. Most
20
+
notably when the scale is changed the window size is wrong. On macos x
21
+
it sometimes disappears entirely because it goes to size zero. A temporary
22
+
work around is to install the Spectacle App from https://www.spectacleapp.com/
23
+
and use the Command+Option+F to maximize the window. Normal macos x without
24
+
this leaves you only with the Window >> Maximize menu.
25
+
26
+
There's still some refresh issues with macos X as well.
27
+
28
+
Zoom larger than 2.0 on macos x causes LisaEm to lock up, so I've disabled it
29
+
for this platform only.
30
+
31
+
2Y and 2X,3Y modes still have mouse location issues
32
+
33
+
34
+
## 2019.12.25
35
+
36
+
Cleaned up a bunch of stuff and fixed builds on both Windows and macos X.
37
+
Both now install properly. There are still some bugs. Windows crashes on the
38
+
hq3x renderer, and quits (I think on sound), but can now find its resources.
39
+
Also cleaned up the old upper case function names in bashbuild that were a
40
+
holdover from the 1.3.0 days.
41
+
Added initial FreeBSD.sys support.
42
+
10
43
## 2019.12.12
11
44
I rewrote a lot of the 1.3.0 build scripts and separated the fn's out to their
12
45
own include files, standardized the build scripts to the new "buildbash"
@@ -25,7 +58,7 @@ Widgets, I'd welcome any insights you may have.
25
58
26
59
There's a lot of stuff to clean up and debug, especially these README files.
27
60
28
-
##2019.10.13 Finally got it working on macos X 10.11+ but had to recompile
61
+
##2019.10.13 Finally got it working on macos X 10.11+ but had to recompile
29
62
both wxWidgets and LisaEm with -stdlib=libc++, and LisaEm with -lstdc++.6,
30
63
there are still lots of bugs, there are stubs for HQX but this feature is
31
64
incomplete so not yet included in the code. I've added a scripts directory
@@ -34,7 +67,7 @@ is needed on macos X, and certainly I need to rewrite all the Windows building
34
67
code.
35
68
36
69
37
-
##2019.09.29 This is a developer grade preview, you can expect tons of bugs and
70
+
##2019.09.29 This is a developer grade preview, you can expect tons of bugs and
38
71
incomplete features, likely it will turn into a release in a month or two
39
72
depending on free time, etc.
40
73
@@ -82,126 +115,47 @@ through a few beta and release-candidate versions on win10 and macosx, the
82
115
final 1.2.7 will be released in binary form as well.
If you wish to build for Windows, Cygwin, along with regular gcc and mingw is required.
165
121
166
-
*NOTE* these are outdated instructions ::TODO:: fix these.
122
+
Please examine the two cygwin installation batch files which will setup the appropriate packages. As you'll need to right click on the appropriate one (32 bit vs 64 bit) and run as Administrator, it's highly recommended that you carefully examine what they do.
167
123
168
-
You will need to download the source code for wxWidgets 2.8.x
169
-
from www.wxwidgets.org. After extracting it, you'll need
170
-
to modify it as follows:
124
+
(The Cygwin installer requires that it be run as Administrator when scripted, otherwise it goes interactive and does not properly select the packages passed to it on the command line.)
171
125
126
+
These scripts expect to be run from the E:\ drive, and that you've downloaded the Setup.exe for Cygwin and have named it properly as the script expects. Once cygwin is properly installed, copy the LisaEm source tarball (or do a git clone) to your home directory inside of Cygwin.
172
127
173
-
IMPORTANT!
128
+
Next, use the scripts in the scripts directory that build wxWidgets.
174
129
175
-
In your wxMac-2.8.0 dir, edit the file
130
+
## Compiling wxWidgets for your system
176
131
177
-
include/wx/mac/carbon/chkconf.h
132
+
The scripts directory contains several scripts that you could use to build wxWidgets for your system. We will generally link LisaEm statically, especially for macos x and
178
133
179
134
```
180
-
change the line with '#define wxMAC_USE_CORE_GRAPHICS 1'
181
-
to '#define wxMAC_USE_CORE_GRAPHICS 0'
135
+
build-wx3.1.2-modern-macosx.sh
136
+
build-wxwidgets-cygwin-windows.sh
137
+
build-wxwidgets-gtk.sh
182
138
```
139
+
After wxWidgets is installed to `/usr/local/wxsomething`, add `/usr/local/wxsomething/bin` to your path before running the LisaEm build script.
183
140
184
-
(Many thanks to Brian Foley for finding this!)
141
+
## Compiling LisaEm for all platforms:
185
142
186
-
If you do not do this, the display will look very ugly.
143
+
You will need netpbm as well as wxWdigets 3.0.4-3.1.2 installed. Do not use system provided wxWidgets, but rather build your own using the scripts in the scripts directory as mentioned above.
187
144
145
+
You will want to install/compile wxWidgets **without** the shared library option, except perhaps on GTK systems, but if you do this, it will not be portable except to systems of the same kind and version.
188
146
189
-
You will want to install/compile wxWidgets without the
190
-
shared library option.
191
-
147
+
After installing/compiling wxWidgets, ensure that wx-config is in your path, cd to the source code directly and run
192
148
193
149
./build.sh clean build
150
+
sudo ./build.sh install
194
151
195
-
The application will be inside of the source code
196
-
directory under ./lisa as LisaEm.app
197
-
152
+
(Don't use sudo on Cygwin, instead you'll be prompted whether you wish to launch the command in an Administration MinTTY session.)
198
153
154
+
This will install the lisaem and lisafsh-tool binaries to /usr/local/bin, and will install skins and sound files to /usr/local/share/LisaEm/; on Windows it will be installed to C:\Program Files\Sunder.Net\LisaEm and /Applications for macos.
If your system has the upx command available, it will also compress the resulting binary with upx in order to save space, it's a good idea to install this command. (The upx step is disabled for debug-enabled builds as it interferes with gdb.)
201
157
202
-
## Compiling for win32:
158
+
On Windows and macos x we'll also want a static build so we don't have to ship
159
+
a copy of wxWidgets along with the app. Of course building for your own system doesn't require that, however the included scripts are setupt to produce static libraries, except for Linux/GTK.
203
160
204
-
Use the cygwin installer batch files and then extract or clone lisaem in
205
-
cygwin and use the download script in the scripts directory before building.
OS provided copies of wxWidgets are likely not going to work with LisaEm. Please use the appropriate script in the scripts directory for your system to compile wxWidgets (although as I write this, the wxWidgets 3.0 provided with Ubuntu 18.04 seems to function correctly.)
0 commit comments