1============================================================================
2 JZINTV  -- Joe Zbiciak's Portable Intellivision Emulator
3============================================================================
4
5(Note:  This file applies to the pre-MacOS X port.)
6
7Welcome to jzIntv.
8
9First be sure to read the main README for this project.
10
11WARNING:  This documentation was whipped together in a hurry.  Email
12me (tlindner@ix.netcom.com) if I leave something out.
13
14Important Info
15--------------
16
17 jzintv homepage:   http://spatula-city.org/~im14u2c/intv
18 Author:            Joe Zbiciak (intvnut@yahoo.com)
19 Credits:           Lots and lots.  See the home page!
20 Macintosh Port:    tim lindner (tlindner@ix.netcom.com)
21
22Quick Start
23-----------
24
25I set up this port using Metrowerks CodeWarrior Pro 4. It shouldn't
26be difficult to change to Pro 5 if you want to.
27
28This is a multi-step build process so bear with me.
29
301) Get the AsgardESS source from Aaron Giles:
31
32         http://www.sirius.com/~agiles/
33
34   Unstuff and move the two files:
35
36         AsgardESS.c
37         AsgardESS.h
38
39   Into the :src:plat:Asgard: folder.
40
41   AsgardESS is the sound library I use to push the samples from the emulator
42   into the Macintosh Sound Manager. This library is not under the GPL so I
43   can not distribute it in source form.
44
452) Compile the MakeTable program. The project file is located in the src folder.
46After you build the application it is moved in to :src:cp1600:
47Now run the application "MakeTable" 10 times with 10 different argument lines:
48
49   fn_cond_br.tbl :tbl:fn_cond_br.c
50   fn_dir_2op.tbl :tbl:fn_dir_2op.c
51   fn_imm_2op.tbl :tbl:fn_imm_2op.c
52   fn_impl_1op_a.tbl :tbl:fn_impl_1op_a.c
53   fn_impl_1op_b.tbl :tbl:fn_impl_1op_b.c
54   fn_ind_2op.tbl :tbl:fn_ind_2op.c
55   fn_reg_1op.tbl :tbl:fn_reg_1op.c
56   fn_reg_2op.tbl :tbl:fn_reg_2op.c
57   fn_rot_1op.tbl :tbl:fn_rot_1op.c
58   formats.tbl :tbl:formats.tbl.c
59
603) Build "Makefile.CodeWarrior.mcp" (located in the src folder). Open
61   the file in CodeWarrior and choose "Make" from the project menu. It
62   will then build an application in the ":src:bin:" folder.
63
64Documentation
65-------------
66
67The 'jzintv/doc' directory contains all the documentation the jzIntv
68project has to share at the moment.
69
70Warning:  jzintv/doc/jzintv/source.txt is very, very, very, very out of date.
71
72
73ROM Binaries
74------------
75
76You don't have any?  Go buy an Intellivision Lives! CD, you cheapskate!
77Go get it at http://www.intellivisionlives.com/ , ok?  Or better yet,
78build a ROM dumper.  In any case, we're not going to encourage ROM piracy.
79
80
81A note about Joe
82----------------
83
84There is no way this port could not have been done if it were not for Joe
85Zbiciak.  His expertise and his code is what made this possible.  His is
86truly an excellent emulator which my port does not (yet) do justice to.
87