1Updated. Mon Sep 20 13:44:23 MEST 2004
2(Vincent S. Cojot <coyote@step.polymtl.ca>)
3
4Quick start:
5-----------------------------------------------------
6- /usr/local/bin/q2_x11.sh (Will start Quake2 for Solaris with X11 rendering).
7- /usr/local/bin/q2_xil.sh (Will start Quake2 for Solaris with XIL rendering).
8- /usr/local/bin/q2_glx.sh (Will start Quake2 for Solaris with GLX rendering).
9
10Tested with:
11-----------------------------------------------------
12Machine 1:
13- Solaris 8 10/00 for Sparc on an Ultra2 (1300) with a Creator3D card.
14- SDL-1.2.3 (http://www.libsdl.org)
15- X11R6.4 (comes with Solaris 8).
16- XIL-1.4 (comes with Solaris 8).
17- OpenGL-1.2.2 (see http://www.sun.com/software/solaris/opengl if using Solaris 8
18  older than 10/01).
19
20Machine 2:
21- Solaris 8 02/02 for Sparc on a SunBlade 2000 (900Mhz CU) and XVR-1000 card.
22- SDL-1.2.4 (http://www.libsdl.org)
23- X11R6.4 (comes with Solaris 8).
24- XIL-1.4 (comes with Solaris 8).
25- OpenGL-1.3 (see http://www.sun.com/software/solaris/opengl)
26(BIG PROBLEM with Multi-Texturing: SEE BELOW)
27
28Installation instructions:
29-----------------------------------------------------
30Use the README file at the top level for installation instructions..
31See the Solaris-Specific make options at the top of
32the Solaris Makefile (Makefile.Solaris). Most interesting options
33are:
34BUILD_X11=YES		(for X11 rendering)
35BUILD_GLX=YES		(for GLX rendering)
36BUILD_SDL=YES		(for SDL rendering)
37BUILD_SDLGL=YES		(for GLX rendering with SDL)
38BUILD_XIL=YES		(for XIL rendering)
39BUILD_CORONA=YES	(for the SunRay Terminal, -unverified- by me since I don't have the SDK)
40BUILD_DEDICATED=YES	(Will build a dedicated quake2 server binary).
41BUILD_SOLARIS_PKG=YES   # Build a Solaris package of all of the binaries for use  with pkgadd.
42BUILD_DATA_PKG=YES      # Build a Solaris package of the game (shareware or final) \
43			# data files for use with pkgadd.
44
45Notes on packages:
46-----------------------------------------------------
47The "release" and "debug" packages of the binaries get built by default.
48This should result in something like this:
49# ls -la releasesparc/pkg/*pkg debugsparc/pkg/*pkg
50-rw-r--r--   1 root     other    16548352 Aug  2 11:33 debugsparc/pkg/iDquake2-debug-r0.13.1-sparc.pkg
51-rw-r--r--   1 root     other    5249536 Aug  2 11:27 releasesparc/pkg/iDquake2-release-r0.13.1-sparc.pkg
52
53To build the the data "iDquake2d" package, edit the line in the Makefile
54that says "PKG_DATA_BUILD_DIR=/usr/local/src/quake2-data/quake2" and point
55it to the correct location for your data files.
56Set BUILD_DATA_PKG=YES in Makefile.Solaris.
57(WARNING: -everything- under ../baseq2 gets taken.
58
59Next, run "gmake -f Makefile.Solaris".
60This should result in something like this:
61-rw-r--r--   1 root     other    52185600 Aug  2 11:27 releasesparc/pkg/iDquake2d-release-r0.13.1-sparc.pkg
62
63After installation, you get:
64# pkginfo |grep -i quake2
65application iDquake2       ID Software Quake2 3.21 for Solaris 8 (X11,XIL,GLX,SDL)
66application iDquake2d      ID Software Quake2 shareware data files for Solaris 8 (X11,XIL,GLX,SDL)
67
68What's working:
69-----------------------------------------------------
70- The Quake2 binary
71- The SDL Quake2 binary (uses SDL for sound and CD).
72- X11 rendering (ref_softx.so)
73- XIL rendering (ref_xil.so) (Faster for some routines)
74- SDL rendering (ref_softsdl.so) (Nice full screen effect on Solaris displays)
75- GLX rendering (ref_glx.so) (Works semi-OK on my Ultra2/Creator3d but
76  it's s-l-o-w).
77
78What's still broken:
79-----------------------------------------------------
80- SDLGL renderer (loads, colors are all wrong. Colormap
81  problem? Update: it may be an endianness problem in
82  SDL since it displays fine to a remote x86 Linux machine
83  with NVidia drivers. Being worked on, priority #2).
84- quake2 and sdlquake2 Seg fault when quitting the game
85  (not a show stoppper but being worked on, priority #1).
86  Update: FIXED (replace exit(0) with commented out
87  _exit(0) in Sys_Quit() in src/solaris/sys_solaris.c.
88- WARNING: On my new XVR-1000 card and with OpenGL-1.2.3
89  the textures are messed up and jumping in GLX mode!
90  All of the quake2-r versions hexibit this problem.
91  I'm investigating the issue....
92  Note: the Utah-GLX project has a quake2 solaris source
93  port that does -not- exhibit this problem (seems to be in
94  ref_gl).
95  Update: Sept 4th 2002: Sun has acknowledged the problem.
96  Patches 112565-05 (5.9) and 112564-05 (5.8) don't help.
97  It looks like a problem with multi-texturing but there
98  is a WORKAROUND: add the following to your quake2 cmd
99  line (without quotes): "+set gl_ext_multitexture 0"
100- If you're using OpenGL (GLX) on an hardware accelerated
101  SUN video card, you -MUST- use OpenGL-1.2.3 and patches
102  112628-11 and 112629-11 or later. Otherwise you'll get
103  a flipping ceiling and the background will appear in front
104  of some walls in the "space" level. For OpenGL-1.3, you must
105  use recent OpenGL-1.3 patches (113886-20, 113887-20 or later).
106
107Thank you!
108-----------------------------------------------------
109Thanks for this Solaris release go to:
110
111- Martin englund and Elias M�rtensson from SUN (sweden).
112They ported Quake2 to Solaris with XIL and OpenGL
113and Martin made this release possible by contributing the source code
114once Quake2 was open-source'd by Id Software in dec' 2001.
115
116- Id software.
117(for such a great multi-platform game, Zoid for porting it to Linux).
118
119- The guys at icculus for hosting this quake2 project
120 (Steven Fuller, Brendan Burns and others..).
121
122This file written by Vincent S. Cojot <coyote@step.polymtl.ca>
123(Maintainer wannabe).
124