2 Copyright (C)2003-2013 Ryan Thoryk
3 http://www.skyscrapersim.com
4 http://sourceforge.net/projects/skyscraper
10 4. Building and Installing
15 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
19 This program is free software; you can redistribute it and/or
20 modify it under the terms of the GNU General Public License
21 as published by the Free Software Foundation; either version 2
22 of the License, or (at your option) any later version.
24 This program is distributed in the hope that it will be useful,
25 but WITHOUT ANY WARRANTY; without even the implied warranty of
26 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
27 GNU General Public License for more details.
29 You should have received a copy of the GNU General Public License
30 along with this program; if not, write to the Free Software
31 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
33 For more information, see the LICENSE file.
35 This software utilizes the FMOD sound system
36 FMOD Sound System, copyright (C) Firelight Technologies Pty, Ltd., 1994-2010.
38 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
42 Skyscraper is a 3D virtual building simulator written in C++ using the OGRE graphics engine
43 (previously Crystal Space) graphics engine. The goal of the Skyscraper project is to create a
44 fully-featured, modular, multiplatform 3D realtime building simulation engine, including
45 gaming support (single and network multiplayer). Everything possible is planned to be simulated,
46 including elevators, stairs, interfloor areas, ductwork, and more, all in first-person 3D.
47 The simulator core is called the Scalable Building Simulator, or SBS. Buildings are stored
48 in scripted text files that are loaded and generated in realtime by the simulator. A
49 graphical building designer application is planned to assist in creating building data
52 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
56 This release is the eighth development relase of the 2.0 series (which is a complete rewrite of
57 the original 1.0 version), and is part of an ongoing effort towards a 2.0 stable release.
59 This software requires both the OGRE graphics engine library (version 1.7) which
60 can be found at http://www.ogre3d.org, the Bullet physics engine with some custom patches,
61 available at http://www.skyscrapersim.com/downloads/dev/other_apps/ and the wxWidgets
62 library (version 2.6.3 or later) which can be found at http://www.wxwidgets.org.
64 See the changelog for new features, fixes, and other changes in this release.
66 For third-party texture credits, see the file "license-info.txt" in the "data" folder.
68 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
70 4. Building and installing
72 Skyscraper can be built on Unix, Msys/Mingw, and Cygwin using the Jam build
73 tool. Microsoft Visual C++ users can build the project using the project files
74 in the skyscraper/msvc directory.
78 The build system is based upon Jam rather than 'make'. If you do not yet have
79 Jam installed, then check your distribution for a Jam package or download the
80 source and compile/install Jam yourself. You can find the source here:
82 ftp://ftp.perforce.com/pub/jam/
84 You will need at least version 2.4.
88 1. Go to the top-level directory in the project tree.
89 2. Run "./configure", possibly with some options, if you wish. You can see a
90 list of available options by invoking configure with the "--help" option.
96 2. Ensure that you have write permissions to the install directories. On Unix
97 (GNU/Linux, MacOS/X, Darwin, BSD) this usually means that you need to be
101 4.2 Microsoft Visual C++
103 1. Set these system environment variables (usually from System Properties in Windows):
106 WXWIN=(path to wxWidgets)
107 wx: WXWIN=C:\wxWidgets-2.8.9
108 2. Open the solution file skyscraper/msvc/skyscraper.sln.
109 3. Choose "Release" or "Debug" build mode.
110 4. Build the project.
112 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
116 To use Skyscraper, run the program, and a main menu screen will appear with a button for each
117 available building (and one button for loading user buildings).
118 Choose the building to load, and in a few moments you will be walking around in that building.
119 The only buildings that are completely simulated in this release are "Simple" and "Triton Center".
120 While in one of these buildings, you can click on objects such as elevator call buttons, etc
121 to perform actions. The recommended building to try out is the Triton Center, since it is the most
122 complete official building. The "Simple" building is a minimalistic demo to basically show how to make
123 your own buildings in the application's scripting language. Other user-created buildings are included,
124 and can be loaded by choosing the "Other Building" button on the main screen.
126 ------------------------------------
127 Keys currently used in the simulator:
129 W or Up Arrow - move forwards
130 S or Down Arrow - move backwards
131 A or Left Arrow - move left
132 D or Right Arrow - move right
133 PgUp or P - Look upwards
134 PgDown or L - Look downwards
136 Home or O - Float upwards (or jump if collision detection is on)
137 End or K - Float downwards (or crouch if collision detection is on)
138 F2 - print FPS on console
139 F3 - Reset camera rotation and zoom to default
140 F4 - Enable/disable wireframe mode
141 F5 - Freelook (mouse look) mode
142 F6 - Full camera reset (respawn)
144 F10 - Fullscreen mode
145 F11 - Take screenshot
146 F12 - Open control panel
147 Shift - Run (hold down with other keys)
148 Control - Walk slowly (hold down with other keys)
149 Alt + arrow keys - Strafe
150 Alt + PgUp/P - Spin right
151 Alt + PgDown/L - Spin left
152 Plus or ] - Zoom in (decrease FOV angle)
153 Minus or [ - Zoom out (increase FOV angle)
154 Esc - exit to main menu
155 V - Toggle noclip mode (gravity and collisions off)
156 Ctrl-Alt-C - Crash program (throw exception) - used for testing handlers
158 --- Mouse actions ---
159 -elevator shaft doors can be manually opened and closed by holding down the Shift key and clicking on them
160 -hallway call buttons can be lit and unlit also by holding down Shift and clicking on them (this does not call an elevator, but just changes the light status)
161 -polygons (wall/floor sides) can be deleted by holding down Ctrl and clicking on the object
162 -doors can be locked by holding down the Shift key and clicking on the side to lock
164 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
168 Bug-Reports, suggestions, and requests should be posted to
169 the Skyscraper forum at http://forum.skyscrapersim.com
170 I can be contacted directly at ryan at tliquest dot net