3 Copyright (C) 2010-2017 celeron55, Perttu Ahola <celeron55@gmail.com>
5 This program is free software; you can redistribute it and/or modify
6 it under the terms of the GNU Lesser General Public License as published by
7 the Free Software Foundation; either version 2.1 of the License, or
8 (at your option) any later version.
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU Lesser General Public License for more details.
15 You should have received a copy of the GNU Lesser General Public License along
16 with this program; if not, write to the Free Software Foundation, Inc.,
17 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
20 #ifndef CLIENT_ENVIRONMENT_HEADER
21 #define CLIENT_ENVIRONMENT_HEADER
23 #include <ISceneManager.h>
24 #include "environment.h"
25 #include "clientobject.h"
27 class ClientSimpleObject;
29 class ClientScripting;
30 class ClientActiveObject;
36 The client-side environment.
38 This is not thread-safe.
39 Must be called from main (irrlicht) thread (uses the SceneManager)
40 Client uses an environment mutex.
43 enum ClientEnvEventType
52 ClientEnvEventType type;
66 typedef std::unordered_map<u16, ClientActiveObject*> ClientActiveObjectMap;
67 class ClientEnvironment : public Environment
70 ClientEnvironment(ClientMap *map, ITextureSource *texturesource, Client *client);
74 ClientMap & getClientMap();
76 Client *getGameDef() { return m_client; }
77 void setScript(ClientScripting *script) { m_script = script; }
81 virtual void setLocalPlayer(LocalPlayer *player);
82 LocalPlayer *getLocalPlayer() { return m_local_player; }
88 void addSimpleObject(ClientSimpleObject *simple);
94 GenericCAO* getGenericCAO(u16 id);
95 ClientActiveObject* getActiveObject(u16 id);
98 Adds an active object to the environment.
99 Environment handles deletion of object.
100 Object may be deleted by environment immediately.
101 If id of object is 0, assigns a free id to it.
102 Returns the id of the object.
103 Returns 0 if not added and thus deleted.
105 u16 addActiveObject(ClientActiveObject *object);
107 void addActiveObject(u16 id, u8 type, const std::string &init_data);
108 void removeActiveObject(u16 id);
110 void processActiveObjectMessage(u16 id, const std::string &data);
113 Callbacks for activeobjects
116 void damageLocalPlayer(u8 damage, bool handle_hp=true);
117 void updateLocalPlayerBreath(u16 breath);
120 Client likes to call these
123 // Get all nearby objects
124 void getActiveObjects(v3f origin, f32 max_d,
125 std::vector<DistanceSortedActiveObject> &dest);
127 bool hasClientEnvEvents() const { return !m_client_event_queue.empty(); }
128 // Get event from queue. If queue is empty, it triggers an assertion failure.
129 ClientEnvEvent getClientEnvEvent();
132 * Gets closest object pointed by the shootline.
133 * Returns NULL if not found.
135 * \param[in] shootline_on_map the shootline for
136 * the test in world coordinates
137 * \param[out] intersection_point the first point where
138 * the shootline meets the object. Valid only if
139 * not NULL is returned.
140 * \param[out] intersection_normal the normal vector of
141 * the intersection, pointing outwards. Zero vector if
142 * the shootline starts in an active object.
143 * Valid only if not NULL is returned.
145 ClientActiveObject * getSelectedActiveObject(
146 const core::line3d<f32> &shootline_on_map,
147 v3f *intersection_point,
148 v3s16 *intersection_normal
152 * Performs a raycast on the world.
153 * Returns the first thing the shootline meets.
155 * @param[in] shootline the shootline, starting from
156 * the camera position. This also gives the maximal distance
158 * @param[in] liquids_pointable if false, liquids are ignored
159 * @param[in] look_for_object if false, objects are ignored
161 PointedThing getPointedThing(
162 core::line3d<f32> shootline,
163 bool liquids_pointable,
164 bool look_for_object);
166 u16 attachement_parent_ids[USHRT_MAX + 1];
168 const std::list<std::string> &getPlayerNames() { return m_player_names; }
169 void addPlayerName(const std::string &name) { m_player_names.push_back(name); }
170 void removePlayerName(const std::string &name) { m_player_names.remove(name); }
171 void updateCameraOffset(v3s16 camera_offset)
172 { m_camera_offset = camera_offset; }
173 v3s16 getCameraOffset() const { return m_camera_offset; }
176 LocalPlayer *m_local_player = nullptr;
177 ITextureSource *m_texturesource;
179 ClientScripting *m_script = nullptr;
180 ClientActiveObjectMap m_active_objects;
181 std::vector<ClientSimpleObject*> m_simple_objects;
182 std::queue<ClientEnvEvent> m_client_event_queue;
183 IntervalLimiter m_active_object_light_update_interval;
184 IntervalLimiter m_lava_hurt_interval;
185 IntervalLimiter m_drowning_interval;
186 IntervalLimiter m_breathing_interval;
187 std::list<std::string> m_player_names;
188 v3s16 m_camera_offset;