src/script/common/c_content.h

   1 /*
   2 Minetest
   3 Copyright (C) 2013 celeron55, Perttu Ahola <celeron55@gmail.com>
   4
   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.
   9
  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.
  14
  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.
  18 */
  19
  20
  21 /******************************************************************************/
  22 /******************************************************************************/
  23 /* WARNING!!!! do NOT add this header in any include file or any code file    */
  24 /*             not being a script/modapi file!!!!!!!!                         */
  25 /******************************************************************************/
  26 /******************************************************************************/
  27
  28 #pragma once
  29
  30 extern "C" {
  31 #include <lua.h>
  32 }
  33
  34 #include <iostream>
  35 #include <vector>
  36
  37 #include "irrlichttypes_bloated.h"
  38 #include "util/string.h"
  39 #include "itemgroup.h"
  40 #include "itemdef.h"
  41 #include "c_types.h"
  42 // We do a explicit path include because by default c_content.h include src/client/hud.h
  43 // prior to the src/hud.h, which is not good on server only build
  44 #include "../../hud.h"
  45
  46 namespace Json { class Value; }
  47
  48 struct MapNode;
  49 class NodeDefManager;
  50 struct PointedThing;
  51 struct ItemStack;
  52 struct ItemDefinition;
  53 struct ToolCapabilities;
  54 struct ObjectProperties;
  55 struct SimpleSoundSpec;
  56 struct ServerSoundParams;
  57 class Inventory;
  58 class InventoryList;
  59 struct NodeBox;
  60 struct ContentFeatures;
  61 struct TileDef;
  62 class IGameDef;
  63 struct DigParams;
  64 struct HitParams;
  65 struct EnumString;
  66 struct NoiseParams;
  67 class Schematic;
  68 class ServerActiveObject;
  69 struct collisionMoveResult;
  70
  71 extern struct EnumString es_TileAnimationType[];
  72
  73 void               read_content_features     (lua_State *L, ContentFeatures &f,
  74                                               int index);
  75 void               push_content_features     (lua_State *L,
  76                                               const ContentFeatures &c);
  77
  78 void               push_nodebox              (lua_State *L,
  79                                               const NodeBox &box);
  80 void               push_box                  (lua_State *L,
  81                                               const std::vector<aabb3f> &box);
  82
  83 void               push_palette              (lua_State *L,
  84                                               const std::vector<video::SColor> *palette);
  85
  86 TileDef            read_tiledef              (lua_State *L, int index,
  87                                               u8 drawtype);
  88
  89 void               read_soundspec            (lua_State *L, int index,
  90                                               SimpleSoundSpec &spec);
  91 NodeBox            read_nodebox              (lua_State *L, int index);
  92
  93 void               read_server_sound_params  (lua_State *L, int index,
  94                                               ServerSoundParams &params);
  95
  96 void               push_dig_params           (lua_State *L,
  97                                               const DigParams &params);
  98 void               push_hit_params           (lua_State *L,
  99                                               const HitParams &params);
 100
 101 ItemStack          read_item                 (lua_State *L, int index, IItemDefManager *idef);
 102
 103 struct TileAnimationParams read_animation_definition(lua_State *L, int index);
 104 void push_animation_definition(lua_State *L, struct TileAnimationParams anim);
 105
 106 ToolCapabilities   read_tool_capabilities    (lua_State *L, int table);
 107 void               push_tool_capabilities    (lua_State *L,
 108                                               const ToolCapabilities &prop);
 109
 110 void read_item_definition (lua_State *L, int index, const ItemDefinition &default_def,
 111                 ItemDefinition &def);
 112 void               push_item_definition      (lua_State *L,
 113                                               const ItemDefinition &i);
 114 void               push_item_definition_full (lua_State *L,
 115                                               const ItemDefinition &i);
 116
 117 void               read_object_properties    (lua_State *L, int index,
 118                                               ServerActiveObject *sao,
 119                                               ObjectProperties *prop,
 120                                               IItemDefManager *idef);
 121 void               push_object_properties    (lua_State *L,
 122                                               ObjectProperties *prop);
 123
 124 void               push_inventory                (lua_State *L,
 125                                               Inventory *inventory);
 126
 127 void               push_inventory_list       (lua_State *L,
 128                                               const InventoryList &invlist);
 129 void               push_inventory_lists      (lua_State *L,
 130                                               const Inventory &inv);
 131 void               read_inventory_list       (lua_State *L, int tableindex,
 132                                               Inventory *inv, const char *name,
 133                                               IGameDef *gdef, int forcesize=-1);
 134
 135 MapNode            readnode                  (lua_State *L, int index,
 136                                               const NodeDefManager *ndef);
 137 void               pushnode                  (lua_State *L, const MapNode &n,
 138                                               const NodeDefManager *ndef);
 139
 140
 141 void               read_groups               (lua_State *L, int index,
 142                                               ItemGroupList &result);
 143
 144 void               push_groups               (lua_State *L,
 145                                               const ItemGroupList &groups);
 146
 147 //TODO rename to "read_enum_field"
 148 int                getenumfield              (lua_State *L, int table,
 149                                               const char *fieldname,
 150                                               const EnumString *spec,
 151                                               int default_);
 152
 153 bool               getflagsfield             (lua_State *L, int table,
 154                                               const char *fieldname,
 155                                               FlagDesc *flagdesc,
 156                                               u32 *flags, u32 *flagmask);
 157
 158 bool               read_flags                (lua_State *L, int index,
 159                                               FlagDesc *flagdesc,
 160                                               u32 *flags, u32 *flagmask);
 161
 162 void               push_flags_string         (lua_State *L, FlagDesc *flagdesc,
 163                                               u32 flags, u32 flagmask);
 164
 165 u32                read_flags_table          (lua_State *L, int table,
 166                                               FlagDesc *flagdesc, u32 *flagmask);
 167
 168 void               push_items                (lua_State *L,
 169                                               const std::vector<ItemStack> &items);
 170
 171 std::vector<ItemStack> read_items            (lua_State *L,
 172                                               int index,
 173                                               IGameDef* gdef);
 174
 175 void               push_soundspec            (lua_State *L,
 176                                               const SimpleSoundSpec &spec);
 177
 178 bool               string_to_enum            (const EnumString *spec,
 179                                               int &result,
 180                                               const std::string &str);
 181
 182 bool               read_noiseparams          (lua_State *L, int index,
 183                                               NoiseParams *np);
 184 void               push_noiseparams          (lua_State *L, NoiseParams *np);
 185
 186 void               luaentity_get             (lua_State *L,u16 id);
 187
 188 bool               push_json_value           (lua_State *L,
 189                                               const Json::Value &value,
 190                                               int nullindex);
 191 void               read_json_value           (lua_State *L, Json::Value &root,
 192                                               int index, u8 recursion = 0);
 193
 194 /*!
 195  * Pushes a Lua `pointed_thing` to the given Lua stack.
 196  * \param csm If true, a client side pointed thing is pushed
 197  * \param hitpoint If true, the exact pointing location is also pushed
 198  */
 199 void push_pointed_thing(lua_State *L, const PointedThing &pointed, bool csm =
 200         false, bool hitpoint = false);
 201
 202 void push_objectRef            (lua_State *L, const u16 id);
 203
 204 void read_hud_element          (lua_State *L, HudElement *elem);
 205
 206 void push_hud_element          (lua_State *L, HudElement *elem);
 207
 208 bool read_hud_change           (lua_State *L, HudElementStat &stat, HudElement *elem, void **value);
 209
 210 void push_collision_move_result(lua_State *L, const collisionMoveResult &res);
 211
 212 void push_physics_override         (lua_State *L, float speed, float jump, float gravity, bool sneak, bool sneak_glitch, bool new_move);