This repository has been archived by the owner on Jan 13, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 4
/
README.txt
120 lines (85 loc) · 4.56 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
HOW TO USE THIS REPOSITORY
==========================
Clone this repository into your local filesystem first:
$ cd <somewhere>
$ git clone https://github.com/Nebuleon/mupen64plus-build.git
The other Mupen64Plus repositories should be cloned next to this one in your
filesystem. You can pick the fork of each repository that you want to build.
For example, to use this repository with the official Mupen64Plus repositories
you can issue these commands:
$ git clone https://github.com/mupen64plus/mupen64plus-core.git
$ git clone https://github.com/mupen64plus/mupen64plus-ui-console.git
$ git clone https://github.com/mupen64plus/mupen64plus-input-sdl.git
$ git clone https://github.com/mupen64plus/mupen64plus-audio-sdl.git
$ git clone https://github.com/mupen64plus/mupen64plus-video-rice.git
$ git clone https://github.com/mupen64plus/mupen64plus-rsp-hle.git
To use this repository with Nebuleon's version of the Mupen64Plus repositories
that work on MIPS, you can issue these commands:
$ git clone https://github.com/Nebuleon/mupen64plus-core.git
$ git clone https://github.com/Nebuleon/mupen64plus-ui-console.git
$ git clone https://github.com/Nebuleon/mupen64plus-input-sdl.git
$ git clone https://github.com/Nebuleon/mupen64plus-audio-sdl.git
$ git clone https://github.com/mupen64plus/mupen64plus-video-rice.git
$ git clone https://github.com/Nebuleon/mupen64plus-video-gles2n64.git
$ git clone https://github.com/Nebuleon/mupen64plus-rsp-hle.git
BUILDING FOR PC
===============
Building for PC uses the Make file called Makefile. You will need to install
gcc, GNU make, SDL 1.2 or 2.0 development libraries, OpenGL 2.0 development
libraries, as well as possibly other things.
You should leave GCW Zero branches before building for PC, in the following
repositories:
* mupen64plus-core
* mupen64plus-input-sdl
To build:
$ cd mupen64plus-build
$ make
Binaries will go to 'out/'. Rice will be built as the video plugin, as well as
the other required plugins and the console UI.
BUILDING FOR GCW ZERO
=====================
Building for the GCW Zero uses the Make file called Makefile.gcw0. You will
need to install the GCW Zero toolchain from http://www.gcw-zero.com/develop .
You should enter GCW Zero branches before building for the GCW Zero, in the
following repositories:
* mupen64plus-core
* mupen64plus-input-sdl
To build:
$ cd mupen64plus-build
$ make -f Makefile.gcw0
Binaries will go to 'out/', and an OPK file will be dropped in the build
directory itself. GLES2n64 will be built as the video plugin, as well as the
other required plugins and the console UI, for MIPS32 processors.
GUIDE TO NEBULEON'S REPOSITORIES
================================
Changes to the official Mupen64Plus code are required for things to compile
and run properly on the GCW Zero. Where the changes are not GCW Zero-specific,
they are in the 'master' branch; otherwise, they are in a 'gcw0' branch.
- mupen64plus-core:
'master' contains changes to the Makefile to unofficially support compiling
for MIPS as well as to allow overriding the path of SDL_CONFIG via the
environment, as required by GCW Zero cross-compilation.
'gcw0' contains changes to stop using (full) OpenGL straight in the core,
allowing OpenGL ES to be initialised by gles2n64. It also contains a fix for
a crash that occurs when setting the floating-point rounding mode.
'neb-dynarec' is a deprecated branch as of 2014-09-04, which has become too
complicated for its own good.
When building for the GCW Zero, please use a local branch based on 'gcw0'
with any JIT work you wish to use merged on top of it.
- mupen64plus-ui-console, mupen64plus-audio-sdl, mupen64plus-rsp-hle:
'master' contains changes to the Makefile to unofficially support compiling
for MIPS as well as to allow overriding the path of SDL_CONFIG via the
environment, as required by GCW Zero cross-compilation.
There are no other changes. The code is cross-platform.
- mupen64plus-input-sdl:
'master' contains the input mapping for PC, including the keyboard mapping.
'gcw0' contains the input mapping for the GCW Zero, mapping its buttons to
the closest thing that exists on the N64 controller.
(Start is Start on the GCW Zero; A and B, the analog nub and the d-pad are
the same, but other buttons are different. See the commits for more
information, as this may change.)
- mupen64plus-video-gles2n64:
'master' is the only branch. It contains similar fixes to build for MIPS, as
well as some other fixes that were cherry-picked.
Rice Video is not in Nebuleon's repositories, because it is not intended to be
built for the GCW Zero. It is only built for PC.