src/newgrf_industrytiles.cpp

   1 /* $Id$ */
   2
   3 /*
   4  * This file is part of OpenTTD.
   5  * OpenTTD is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, version 2.
   6  * OpenTTD is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
   7  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
   8  */
   9
  10 /** @file newgrf_industrytiles.cpp NewGRF handling of industry tiles. */
  11
  12 #include "stdafx.h"
  13 #include "debug.h"
  14 #include "landscape.h"
  15 #include "newgrf_industrytiles.h"
  16 #include "newgrf_sound.h"
  17 #include "industry.h"
  18 #include "town.h"
  19 #include "command_func.h"
  20 #include "water.h"
  21 #include "newgrf_animation_base.h"
  22
  23 #include "table/strings.h"
  24
  25 #include "safeguards.h"
  26
  27 /**
  28  * Based on newhouses equivalent, but adapted for newindustries
  29  * @param parameter from callback.  It's in fact a pair of coordinates
  30  * @param tile TileIndex from which the callback was initiated
  31  * @param index of the industry been queried for
  32  * @param signed_offsets Are the x and y offset encoded in parameter signed?
  33  * @param grf_version8 True, if we are dealing with a new NewGRF which uses GRF version >= 8.
  34  * @return a construction of bits obeying the newgrf format
  35  */
  36 uint32 GetNearbyIndustryTileInformation(byte parameter, TileIndex tile, IndustryID index, bool signed_offsets, bool grf_version8)
  37 {
  38         if (parameter != 0) tile = GetNearbyTile(parameter, tile, signed_offsets); // only perform if it is required
  39         bool is_same_industry = (IsTileType(tile, MP_INDUSTRY) && GetIndustryIndex(tile) == index);
  40
  41         return GetNearbyTileInformation(tile, grf_version8) | (is_same_industry ? 1 : 0) << 8;
  42 }
  43
  44 /**
  45  * This is the position of the tile relative to the northernmost tile of the industry.
  46  * Format: 00yxYYXX
  47  * Variable  Content
  48  * x         the x offset from the northernmost tile
  49  * XX        same, but stored in a byte instead of a nibble
  50  * y         the y offset from the northernmost tile
  51  * YY        same, but stored in a byte instead of a nibble
  52  * @param tile TileIndex of the tile to evaluate
  53  * @param ind_tile northernmost tile of the industry
  54  */
  55 uint32 GetRelativePosition(TileIndex tile, TileIndex ind_tile)
  56 {
  57         byte x = TileX(tile) - TileX(ind_tile);
  58         byte y = TileY(tile) - TileY(ind_tile);
  59
  60         return ((y & 0xF) << 20) | ((x & 0xF) << 16) | (y << 8) | x;
  61 }
  62
  63 /* virtual */ uint32 IndustryTileScopeResolver::GetVariable(byte variable, uint32 parameter, bool *available) const
  64 {
  65         switch (variable) {
  66                 /* Construction state of the tile: a value between 0 and 3 */
  67                 case 0x40: return (IsTileType(this->tile, MP_INDUSTRY)) ? GetIndustryConstructionStage(this->tile) : 0;
  68
  69                 /* Terrain type */
  70                 case 0x41: return GetTerrainType(this->tile);
  71
  72                 /* Current town zone of the tile in the nearest town */
  73                 case 0x42: return GetTownRadiusGroup(ClosestTownFromTile(this->tile, UINT_MAX), this->tile);
  74
  75                 /* Relative position */
  76                 case 0x43: return GetRelativePosition(this->tile, this->industry->location.tile);
  77
  78                 /* Animation frame. Like house variable 46 but can contain anything 0..FF. */
  79                 case 0x44: return IsTileType(this->tile, MP_INDUSTRY) ? GetAnimationFrame(this->tile) : 0;
  80
  81                 /* Land info of nearby tiles */
  82                 case 0x60: return GetNearbyIndustryTileInformation(parameter, this->tile,
  83                                 this->industry == NULL ? (IndustryID)INVALID_INDUSTRY : this->industry->index, true, this->ro.grffile->grf_version >= 8);
  84
  85                 /* Animation stage of nearby tiles */
  86                 case 0x61: {
  87                         TileIndex tile = GetNearbyTile(parameter, this->tile);
  88                         if (IsTileType(tile, MP_INDUSTRY) && Industry::GetByTile(tile) == this->industry) {
  89                                 return GetAnimationFrame(tile);
  90                         }
  91                         return UINT_MAX;
  92                 }
  93
  94                 /* Get industry tile ID at offset */
  95                 case 0x62: return GetIndustryIDAtOffset(GetNearbyTile(parameter, this->tile), this->industry, this->ro.grffile->grfid);
  96         }
  97
  98         DEBUG(grf, 1, "Unhandled industry tile variable 0x%X", variable);
  99
 100         *available = false;
 101         return UINT_MAX;
 102 }
 103
 104 /* virtual */ uint32 IndustryTileScopeResolver::GetRandomBits() const
 105 {
 106         assert(this->industry != NULL && IsValidTile(this->tile));
 107         assert(this->industry->index == INVALID_INDUSTRY || IsTileType(this->tile, MP_INDUSTRY));
 108
 109         return (this->industry->index != INVALID_INDUSTRY) ? GetIndustryRandomBits(this->tile) : 0;
 110 }
 111
 112 /* virtual */ uint32 IndustryTileScopeResolver::GetTriggers() const
 113 {
 114         assert(this->industry != NULL && IsValidTile(this->tile));
 115         assert(this->industry->index == INVALID_INDUSTRY || IsTileType(this->tile, MP_INDUSTRY));
 116         if (this->industry->index == INVALID_INDUSTRY) return 0;
 117         return GetIndustryTriggers(this->tile);
 118 }
 119
 120 /**
 121  * Get the associated NewGRF file from the industry graphics.
 122  * @param gfx Graphics to query.
 123  * @return Grf file associated with the graphics, if any.
 124  */
 125 static const GRFFile *GetIndTileGrffile(IndustryGfx gfx)
 126 {
 127         const IndustryTileSpec *its = GetIndustryTileSpec(gfx);
 128         return (its != NULL) ? its->grf_prop.grffile : NULL;
 129 }
 130
 131 /**
 132  * Constructor of the industry tiles scope resolver.
 133  * @param gfx Graphics of the industry.
 134  * @param tile %Tile of the industry.
 135  * @param indus %Industry owning the tile.
 136  * @param callback Callback ID.
 137  * @param callback_param1 First parameter (var 10) of the callback.
 138  * @param callback_param2 Second parameter (var 18) of the callback.
 139  */
 140 IndustryTileResolverObject::IndustryTileResolverObject(IndustryGfx gfx, TileIndex tile, Industry *indus,
 141                         CallbackID callback, uint32 callback_param1, uint32 callback_param2)
 142         : ResolverObject(GetIndTileGrffile(gfx), callback, callback_param1, callback_param2),
 143         indtile_scope(*this, indus, tile),
 144         ind_scope(*this, tile, indus, indus->type)
 145 {
 146         this->root_spritegroup = GetIndustryTileSpec(gfx)->grf_prop.spritegroup[0];
 147 }
 148
 149 static void IndustryDrawTileLayout(const TileInfo *ti, const TileLayoutSpriteGroup *group, byte rnd_colour, byte stage, IndustryGfx gfx)
 150 {
 151         const DrawTileSprites *dts = group->ProcessRegisters(&stage);
 152
 153         SpriteID image = dts->ground.sprite;
 154         PaletteID pal  = dts->ground.pal;
 155
 156         if (HasBit(image, SPRITE_MODIFIER_CUSTOM_SPRITE)) image += stage;
 157         if (HasBit(pal, SPRITE_MODIFIER_CUSTOM_SPRITE)) pal += stage;
 158
 159         if (GB(image, 0, SPRITE_WIDTH) != 0) {
 160                 /* If the ground sprite is the default flat water sprite, draw also canal/river borders
 161                  * Do not do this if the tile's WaterClass is 'land'. */
 162                 if (image == SPR_FLAT_WATER_TILE && IsTileOnWater(ti->tile)) {
 163                         DrawWaterClassGround(ti);
 164                 } else {
 165                         DrawGroundSprite(image, GroundSpritePaletteTransform(image, pal, GENERAL_SPRITE_COLOUR(rnd_colour)));
 166                 }
 167         }
 168
 169         DrawNewGRFTileSeq(ti, dts, TO_INDUSTRIES, stage, GENERAL_SPRITE_COLOUR(rnd_colour));
 170 }
 171
 172 uint16 GetIndustryTileCallback(CallbackID callback, uint32 param1, uint32 param2, IndustryGfx gfx_id, Industry *industry, TileIndex tile)
 173 {
 174         assert(industry != NULL && IsValidTile(tile));
 175         assert(industry->index == INVALID_INDUSTRY || IsTileType(tile, MP_INDUSTRY));
 176
 177         IndustryTileResolverObject object(gfx_id, tile, industry, callback, param1, param2);
 178         return object.ResolveCallback();
 179 }
 180
 181 bool DrawNewIndustryTile(TileInfo *ti, Industry *i, IndustryGfx gfx, const IndustryTileSpec *inds)
 182 {
 183         if (ti->tileh != SLOPE_FLAT) {
 184                 bool draw_old_one = true;
 185                 if (HasBit(inds->callback_mask, CBM_INDT_DRAW_FOUNDATIONS)) {
 186                         /* Called to determine the type (if any) of foundation to draw for industry tile */
 187                         uint32 callback_res = GetIndustryTileCallback(CBID_INDTILE_DRAW_FOUNDATIONS, 0, 0, gfx, i, ti->tile);
 188                         if (callback_res != CALLBACK_FAILED) draw_old_one = ConvertBooleanCallback(inds->grf_prop.grffile, CBID_INDTILE_DRAW_FOUNDATIONS, callback_res);
 189                 }
 190
 191                 if (draw_old_one) DrawFoundation(ti, FOUNDATION_LEVELED);
 192         }
 193
 194         IndustryTileResolverObject object(gfx, ti->tile, i);
 195
 196         const SpriteGroup *group = object.Resolve();
 197         if (group == NULL || group->type != SGT_TILELAYOUT) return false;
 198
 199         /* Limit the building stage to the number of stages supplied. */
 200         const TileLayoutSpriteGroup *tlgroup = (const TileLayoutSpriteGroup *)group;
 201         byte stage = GetIndustryConstructionStage(ti->tile);
 202         IndustryDrawTileLayout(ti, tlgroup, i->random_colour, stage, gfx);
 203         return true;
 204 }
 205
 206 extern bool IsSlopeRefused(Slope current, Slope refused);
 207
 208 /**
 209  * Check the slope of a tile of a new industry.
 210  * @param ind_base_tile Base tile of the industry.
 211  * @param ind_tile      Tile to check.
 212  * @param its           Tile specification.
 213  * @param type          Industry type.
 214  * @param gfx           Gfx of the tile.
 215  * @param itspec_index  Layout.
 216  * @param initial_random_bits Random bits of industry after construction
 217  * @param founder       Industry founder
 218  * @param creation_type The circumstances the industry is created under.
 219  * @return Succeeded or failed command.
 220  */
 221 CommandCost PerformIndustryTileSlopeCheck(TileIndex ind_base_tile, TileIndex ind_tile, const IndustryTileSpec *its, IndustryType type, IndustryGfx gfx, uint itspec_index, uint16 initial_random_bits, Owner founder, IndustryAvailabilityCallType creation_type)
 222 {
 223         Industry ind;
 224         ind.index = INVALID_INDUSTRY;
 225         ind.location.tile = ind_base_tile;
 226         ind.location.w = 0;
 227         ind.type = type;
 228         ind.random = initial_random_bits;
 229         ind.founder = founder;
 230
 231         uint16 callback_res = GetIndustryTileCallback(CBID_INDTILE_SHAPE_CHECK, 0, creation_type << 8 | itspec_index, gfx, &ind, ind_tile);
 232         if (callback_res == CALLBACK_FAILED) {
 233                 if (!IsSlopeRefused(GetTileSlope(ind_tile), its->slopes_refused)) return CommandCost();
 234                 return_cmd_error(STR_ERROR_SITE_UNSUITABLE);
 235         }
 236         if (its->grf_prop.grffile->grf_version < 7) {
 237                 if (callback_res != 0) return CommandCost();
 238                 return_cmd_error(STR_ERROR_SITE_UNSUITABLE);
 239         }
 240
 241         return GetErrorMessageFromLocationCallbackResult(callback_res, its->grf_prop.grffile, STR_ERROR_SITE_UNSUITABLE);
 242 }
 243
 244 /* Simple wrapper for GetHouseCallback to keep the animation unified. */
 245 uint16 GetSimpleIndustryCallback(CallbackID callback, uint32 param1, uint32 param2, const IndustryTileSpec *spec, Industry *ind, TileIndex tile, int extra_data)
 246 {
 247         return GetIndustryTileCallback(callback, param1, param2, spec - GetIndustryTileSpec(0), ind, tile);
 248 }
 249
 250 /** Helper class for animation control. */
 251 struct IndustryAnimationBase : public AnimationBase<IndustryAnimationBase, IndustryTileSpec, Industry, int, GetSimpleIndustryCallback> {
 252         static const CallbackID cb_animation_speed      = CBID_INDTILE_ANIMATION_SPEED;
 253         static const CallbackID cb_animation_next_frame = CBID_INDTILE_ANIM_NEXT_FRAME;
 254
 255         static const IndustryTileCallbackMask cbm_animation_speed      = CBM_INDT_ANIM_SPEED;
 256         static const IndustryTileCallbackMask cbm_animation_next_frame = CBM_INDT_ANIM_NEXT_FRAME;
 257 };
 258
 259 void AnimateNewIndustryTile(TileIndex tile)
 260 {
 261         const IndustryTileSpec *itspec = GetIndustryTileSpec(GetIndustryGfx(tile));
 262         if (itspec == NULL) return;
 263
 264         IndustryAnimationBase::AnimateTile(itspec, Industry::GetByTile(tile), tile, (itspec->special_flags & INDTILE_SPECIAL_NEXTFRAME_RANDOMBITS) != 0);
 265 }
 266
 267 bool StartStopIndustryTileAnimation(TileIndex tile, IndustryAnimationTrigger iat, uint32 random)
 268 {
 269         const IndustryTileSpec *itspec = GetIndustryTileSpec(GetIndustryGfx(tile));
 270
 271         if (!HasBit(itspec->animation.triggers, iat)) return false;
 272
 273         IndustryAnimationBase::ChangeAnimationFrame(CBID_INDTILE_ANIM_START_STOP, itspec, Industry::GetByTile(tile), tile, random, iat);
 274         return true;
 275 }
 276
 277 bool StartStopIndustryTileAnimation(const Industry *ind, IndustryAnimationTrigger iat)
 278 {
 279         bool ret = true;
 280         uint32 random = Random();
 281         TILE_AREA_LOOP(tile, ind->location) {
 282                 if (ind->TileBelongsToIndustry(tile)) {
 283                         if (StartStopIndustryTileAnimation(tile, iat, random)) {
 284                                 SB(random, 0, 16, Random());
 285                         } else {
 286                                 ret = false;
 287                         }
 288                 }
 289         }
 290
 291         return ret;
 292 }
 293
 294 /**
 295  * Trigger random triggers for an industry tile and reseed its random bits.
 296  * @param tile Industry tile to trigger.
 297  * @param trigger Trigger to trigger.
 298  * @param ind Industry of the tile.
 299  * @param [in,out] reseed_industry Collects bits to reseed for the industry.
 300  */
 301 static void DoTriggerIndustryTile(TileIndex tile, IndustryTileTrigger trigger, Industry *ind, uint32 &reseed_industry)
 302 {
 303         assert(IsValidTile(tile) && IsTileType(tile, MP_INDUSTRY));
 304
 305         IndustryGfx gfx = GetIndustryGfx(tile);
 306         const IndustryTileSpec *itspec = GetIndustryTileSpec(gfx);
 307
 308         if (itspec->grf_prop.spritegroup[0] == NULL) return;
 309
 310         IndustryTileResolverObject object(gfx, tile, ind, CBID_RANDOM_TRIGGER);
 311         object.waiting_triggers = GetIndustryTriggers(tile) | trigger;
 312         SetIndustryTriggers(tile, object.waiting_triggers); // store now for var 5F
 313
 314         const SpriteGroup *group = object.Resolve();
 315         if (group == NULL) return;
 316
 317         /* Store remaining triggers. */
 318         SetIndustryTriggers(tile, object.GetRemainingTriggers());
 319
 320         /* Rerandomise tile bits */
 321         byte new_random_bits = Random();
 322         byte random_bits = GetIndustryRandomBits(tile);
 323         random_bits &= ~object.reseed[VSG_SCOPE_SELF];
 324         random_bits |= new_random_bits & object.reseed[VSG_SCOPE_SELF];
 325         SetIndustryRandomBits(tile, random_bits);
 326         MarkTileDirtyByTile(tile);
 327
 328         reseed_industry |= object.reseed[VSG_SCOPE_PARENT];
 329 }
 330
 331 /**
 332  * Reseeds the random bits of an industry.
 333  * @param ind Industry.
 334  * @param reseed Bits to reseed.
 335  */
 336 static void DoReseedIndustry(Industry *ind, uint32 reseed)
 337 {
 338         if (reseed == 0 || ind == NULL) return;
 339
 340         uint16 random_bits = Random();
 341         ind->random &= reseed;
 342         ind->random |= random_bits & reseed;
 343 }
 344
 345 /**
 346  * Trigger a random trigger for a single industry tile.
 347  * @param tile Industry tile to trigger.
 348  * @param trigger Trigger to trigger.
 349  */
 350 void TriggerIndustryTile(TileIndex tile, IndustryTileTrigger trigger)
 351 {
 352         uint32 reseed_industry = 0;
 353         Industry *ind = Industry::GetByTile(tile);
 354         DoTriggerIndustryTile(tile, trigger, ind, reseed_industry);
 355         DoReseedIndustry(ind, reseed_industry);
 356 }
 357
 358 /**
 359  * Trigger a random trigger for all industry tiles.
 360  * @param ind Industry to trigger.
 361  * @param trigger Trigger to trigger.
 362  */
 363 void TriggerIndustry(Industry *ind, IndustryTileTrigger trigger)
 364 {
 365         uint32 reseed_industry = 0;
 366         TILE_AREA_LOOP(tile, ind->location) {
 367                 if (ind->TileBelongsToIndustry(tile)) {
 368                         DoTriggerIndustryTile(tile, trigger, ind, reseed_industry);
 369                 }
 370         }
 371         DoReseedIndustry(ind, reseed_industry);
 372 }
 373