OpenTTD Source 20250529-master-g10c159a79f
object_cmd.cpp
Go to the documentation of this file.
1/*
2 * This file is part of OpenTTD.
3 * 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.
4 * 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.
5 * 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/>.
6 */
7
10#include "stdafx.h"
11#include "landscape.h"
12#include "command_func.h"
13#include "company_func.h"
14#include "viewport_func.h"
15#include "company_base.h"
16#include "town.h"
17#include "bridge_map.h"
18#include "genworld.h"
19#include "autoslope.h"
20#include "clear_func.h"
21#include "water.h"
22#include "window_func.h"
23#include "company_gui.h"
24#include "cheat_type.h"
25#include "object.h"
26#include "cargopacket.h"
27#include "core/random_func.hpp"
28#include "core/pool_func.hpp"
29#include "object_map.h"
30#include "object_base.h"
31#include "newgrf_config.h"
32#include "newgrf_object.h"
34#include "newgrf_debug.h"
35#include "vehicle_func.h"
36#include "station_func.h"
37#include "object_cmd.h"
38#include "landscape_cmd.h"
40
41#include "table/strings.h"
42#include "table/object_land.h"
43
44#include "safeguards.h"
45
46ObjectPool _object_pool("Object");
48/* static */ std::array<uint16_t, NUM_OBJECTS> Object::counts;
49
56{
57 return Object::Get(GetObjectIndex(tile));
58}
59
67{
68 assert(IsTileType(t, MP_OBJECT));
69 return Object::GetByTile(t)->type;
70}
71
77
88void BuildObject(ObjectType type, TileIndex tile, CompanyID owner, Town *town, uint8_t view)
89{
90 const ObjectSpec *spec = ObjectSpec::Get(type);
91
92 TileArea ta(tile, GB(spec->size, HasBit(view, 0) ? 4 : 0, 4), GB(spec->size, HasBit(view, 0) ? 0 : 4, 4));
93 Object *o = new Object(type, town == nullptr ? CalcClosestTownFromTile(tile) : town, ta, TimerGameCalendar::date, view);
94
95 /* If nothing owns the object, the colour will be random. Otherwise
96 * get the colour from the company's livery settings. */
97 if (owner == OWNER_NONE) {
98 o->colour = Random();
99 } else {
100 const Livery &l = Company::Get(owner)->livery[0];
101 o->colour = l.colour1 + l.colour2 * 16;
102 }
103
104 /* If the object wants only one colour, then give it that colour. */
105 if (!spec->flags.Test(ObjectFlag::Uses2CC)) o->colour &= 0xF;
106
108 uint16_t res = GetObjectCallback(CBID_OBJECT_COLOUR, o->colour, 0, spec, o, tile);
109 if (res != CALLBACK_FAILED) {
110 if (res >= 0x100) ErrorUnknownCallbackResult(spec->grf_prop.grfid, CBID_OBJECT_COLOUR, res);
111 o->colour = GB(res, 0, 8);
112 }
113 }
114
115 assert(o->town != nullptr);
116
117 for (TileIndex t : ta) {
121 /* Update company infrastructure counts for objects build on canals owned by nobody. */
122 if (wc == WATER_CLASS_CANAL && owner != OWNER_NONE && (IsTileOwner(t, OWNER_NONE) || IsTileOwner(t, OWNER_WATER))) {
123 Company::Get(owner)->infrastructure.water++;
125 }
126 bool remove = IsDockingTile(t);
127 MakeObject(t, owner, o->index, wc, Random());
128 if (remove) RemoveDockingTile(t);
130 }
131
134}
135
141{
143 for (TileIndex t : ta) {
144 /* We encode the company HQ size in the animation state. */
147 }
148}
149
155static uint8_t GetCompanyHQSize(TileIndex tile)
156{
157 /* We encode the company HQ size in the animation state. */
158 return GetAnimationFrame(tile);
159}
160
166void UpdateCompanyHQ(TileIndex tile, uint score)
167{
168 if (tile == INVALID_TILE) return;
169
170 uint8_t val = 0;
171 if (score >= 170) val++;
172 if (score >= 350) val++;
173 if (score >= 520) val++;
174 if (score >= 720) val++;
175
176 while (GetCompanyHQSize(tile) < val) {
178 }
179}
180
186{
187 for (Object *obj : Object::Iterate()) {
188 Owner owner = GetTileOwner(obj->location.tile);
189 /* Not the current owner, so colour doesn't change. */
190 if (owner != c->index) continue;
191
192 const ObjectSpec *spec = ObjectSpec::GetByTile(obj->location.tile);
193 /* Using the object colour callback, so not using company colour. */
194 if (spec->callback_mask.Test(ObjectCallbackMask::Colour)) continue;
195
196 const Livery &l = c->livery[0];
197 obj->colour = (spec->flags.Test(ObjectFlag::Uses2CC) ? (l.colour2 * 16) : 0) + l.colour1;
198 }
199}
200
201extern CommandCost CheckBuildableTile(TileIndex tile, DiagDirections invalid_dirs, int &allowed_z, bool allow_steep, bool check_bridge);
202static CommandCost ClearTile_Object(TileIndex tile, DoCommandFlags flags);
203
213{
215
216 if (type >= ObjectSpec::Count()) return CMD_ERROR;
217 const ObjectSpec *spec = ObjectSpec::Get(type);
218 if (_game_mode == GM_NORMAL && !spec->IsAvailable() && !_generating_world) return CMD_ERROR;
219 if ((_game_mode == GM_EDITOR || _generating_world) && !spec->WasEverAvailable()) return CMD_ERROR;
220
221 if (spec->flags.Test(ObjectFlag::OnlyInScenedit) && ((!_generating_world && _game_mode != GM_EDITOR) || _current_company != OWNER_NONE)) return CMD_ERROR;
222 if (spec->flags.Test(ObjectFlag::OnlyInGame) && (_generating_world || _game_mode != GM_NORMAL || _current_company > MAX_COMPANIES)) return CMD_ERROR;
223 if (view >= spec->views) return CMD_ERROR;
224
225 if (!Object::CanAllocateItem()) return CommandCost(STR_ERROR_TOO_MANY_OBJECTS);
226 if (Town::GetNumItems() == 0) return CommandCost(STR_ERROR_MUST_FOUND_TOWN_FIRST);
227
228 int size_x = GB(spec->size, HasBit(view, 0) ? 4 : 0, 4);
229 int size_y = GB(spec->size, HasBit(view, 0) ? 0 : 4, 4);
230 TileArea ta(tile, size_x, size_y);
231 for (TileIndex t : ta) {
232 if (!IsValidTile(t)) return CommandCost(STR_ERROR_TOO_CLOSE_TO_EDGE_OF_MAP_SUB); // Might be off the map
233 }
234
235 if (type == OBJECT_OWNED_LAND) {
236 /* Owned land is special as it can be placed on any slope. */
237 cost.AddCost(Command<CMD_LANDSCAPE_CLEAR>::Do(flags, tile));
238 } else {
239 /* Check the surface to build on. At this time we can't actually execute the
240 * the CLEAR_TILE commands since the newgrf callback later on can check
241 * some information about the tiles. */
242 bool allow_water = spec->flags.Any({ObjectFlag::BuiltOnWater, ObjectFlag::NotOnLand});
243 bool allow_ground = !spec->flags.Test(ObjectFlag::NotOnLand);
244 for (TileIndex t : ta) {
245 if (HasTileWaterGround(t)) {
246 if (!allow_water) return CommandCost(STR_ERROR_CAN_T_BUILD_ON_WATER);
247 if (!IsWaterTile(t)) {
248 /* Normal water tiles don't have to be cleared. For all other tile types clear
249 * the tile but leave the water. */
251 } else {
252 /* Can't build on water owned by another company. */
253 Owner o = GetTileOwner(t);
254 if (o != OWNER_NONE && o != OWNER_WATER) cost.AddCost(CheckOwnership(o, t));
255
256 /* However, the tile has to be clear of vehicles. */
258 }
259 } else {
260 if (!allow_ground) return CommandCost(STR_ERROR_MUST_BE_BUILT_ON_WATER);
261 /* For non-water tiles, we'll have to clear it before building. */
262
263 /* When relocating HQ, allow it to be relocated (partial) on itself. */
264 if (!(type == OBJECT_HQ &&
265 IsTileType(t, MP_OBJECT) &&
267 IsObjectType(t, OBJECT_HQ))) {
269 }
270 }
271 }
272
273 /* So, now the surface is checked... check the slope of said surface. */
274 auto [slope, allowed_z] = GetTileSlopeZ(tile);
275 if (slope != SLOPE_FLAT) allowed_z++;
276
277 for (TileIndex t : ta) {
278 uint16_t callback = CALLBACK_FAILED;
279 std::array<int32_t, 16> regs100;
281 TileIndex diff = t - tile;
282 callback = GetObjectCallback(CBID_OBJECT_LAND_SLOPE_CHECK, GetTileSlope(t), TileY(diff) << 4 | TileX(diff), spec, nullptr, t, regs100, view);
283 }
284
285 if (callback == CALLBACK_FAILED) {
286 cost.AddCost(CheckBuildableTile(t, {}, allowed_z, false, false));
287 } else {
288 /* The meaning of bit 10 is inverted for a grf version < 8. */
289 if (spec->grf_prop.grffile->grf_version < 8) ToggleBit(callback, 10);
290 CommandCost ret = GetErrorMessageFromLocationCallbackResult(callback, regs100, spec->grf_prop.grffile, STR_ERROR_LAND_SLOPED_IN_WRONG_DIRECTION);
291 if (ret.Failed()) return ret;
292 }
293 }
294
295 if (flags.Test(DoCommandFlag::Execute)) {
296 /* This is basically a copy of the loop above with the exception that we now
297 * execute the commands and don't check for errors, since that's already done. */
298 for (TileIndex t : ta) {
299 if (HasTileWaterGround(t)) {
300 if (!IsWaterTile(t)) {
302 }
303 } else {
305 }
306 }
307 }
308 }
309 if (cost.Failed()) return cost;
310
311 /* Finally do a check for bridges. */
312 for (TileIndex t : ta) {
313 if (IsBridgeAbove(t) && (
316 return CommandCost(STR_ERROR_MUST_DEMOLISH_BRIDGE_FIRST);
317 }
318 }
319
320 int hq_score = 0;
321 uint build_object_size = 1;
322 switch (type) {
325 if (!IsTileFlat(tile)) return CommandCost(STR_ERROR_FLAT_LAND_REQUIRED);
326 break;
327
329 if (IsTileType(tile, MP_OBJECT) &&
332 return CommandCost(STR_ERROR_YOU_ALREADY_OWN_IT);
333 }
334 break;
335
336 case OBJECT_HQ: {
338 if (c->location_of_HQ != INVALID_TILE) {
339 /* Don't relocate HQ on the same location. */
340 if (c->location_of_HQ == tile) return CommandCost(STR_ERROR_ALREADY_BUILT);
341 /* We need to persuade a bit harder to remove the old HQ. */
343 cost.AddCost(ClearTile_Object(c->location_of_HQ, flags));
345 }
346
347 if (flags.Test(DoCommandFlag::Execute)) {
348 hq_score = UpdateCompanyRatingAndValue(c, false);
349 c->location_of_HQ = tile;
351 }
352 break;
353 }
354
355 case OBJECT_STATUE:
356 /* This may never be constructed using this method. */
357 return CMD_ERROR;
358
359 default: // i.e. NewGRF provided.
360 build_object_size = size_x * size_y;
361 break;
362 }
363
364 /* Don't allow building more objects if the company has reached its limit. */
366 if (c != nullptr && GB(c->build_object_limit, 16, 16) < build_object_size) {
367 return CommandCost(STR_ERROR_BUILD_OBJECT_LIMIT_REACHED);
368 }
369
370 if (flags.Test(DoCommandFlag::Execute)) {
371 BuildObject(type, tile, _current_company == OWNER_DEITY ? OWNER_NONE : _current_company, nullptr, view);
372
373 /* Make sure the HQ starts at the right size. */
374 if (type == OBJECT_HQ) UpdateCompanyHQ(tile, hq_score);
375
376 /* Subtract the tile from the build limit. */
377 if (c != nullptr) c->build_object_limit -= build_object_size << 16;
378 }
379
380 cost.AddCost(spec->GetBuildCost() * build_object_size);
381 return cost;
382}
383
394CommandCost CmdBuildObjectArea(DoCommandFlags flags, TileIndex tile, TileIndex start_tile, ObjectType type, uint8_t view, bool diagonal)
395{
396 if (start_tile >= Map::Size()) return CMD_ERROR;
397
398 if (type >= ObjectSpec::Count()) return CMD_ERROR;
399 const ObjectSpec *spec = ObjectSpec::Get(type);
400 if (view >= spec->views) return CMD_ERROR;
401
402 if (spec->size != OBJECT_SIZE_1X1) return CMD_ERROR;
403
406 CommandCost last_error = CMD_ERROR;
407 bool had_success = false;
408
410 int limit = (c == nullptr ? INT32_MAX : GB(c->build_object_limit, 16, 16));
411
412 std::unique_ptr<TileIterator> iter = TileIterator::Create(tile, start_tile, diagonal);
413 for (; *iter != INVALID_TILE; ++(*iter)) {
414 TileIndex t = *iter;
416
417 /* If we've reached the limit, stop building (or testing). */
418 if (c != nullptr && limit-- <= 0) break;
419
420 if (ret.Failed()) {
421 last_error = std::move(ret);
422 continue;
423 }
424
425 had_success = true;
426 if (flags.Test(DoCommandFlag::Execute)) {
427 money -= ret.GetCost();
428
429 /* If we run out of money, stop building. */
430 if (ret.GetCost() > 0 && money < 0) break;
431 Command<CMD_BUILD_OBJECT>::Do(flags, t, type, view);
432 }
433 cost.AddCost(ret.GetCost());
434 }
435
436 return had_success ? cost : last_error;
437}
438
439static Foundation GetFoundation_Object(TileIndex tile, Slope tileh);
440
441static void DrawTile_Object(TileInfo *ti)
442{
443 ObjectType type = GetObjectType(ti->tile);
444 const ObjectSpec *spec = ObjectSpec::Get(type);
445
446 /* Fall back for when the object doesn't exist anymore. */
447 if (!spec->IsEnabled()) type = OBJECT_TRANSMITTER;
448
449 if (!spec->flags.Test(ObjectFlag::HasNoFoundation)) DrawFoundation(ti, GetFoundation_Object(ti->tile, ti->tileh));
450
451 if (type < NEW_OBJECT_OFFSET) {
452 const DrawTileSprites *dts = nullptr;
453 Owner to = GetTileOwner(ti->tile);
454 PaletteID palette = to == OWNER_NONE ? PAL_NONE : GetCompanyPalette(to);
455
456 if (type == OBJECT_HQ) {
458 dts = &_object_hq[GetCompanyHQSize(ti->tile) << 2 | TileY(diff) << 1 | TileX(diff)];
459 } else {
460 dts = &_objects[type];
461 }
462
464 /* If an object has no foundation, but tries to draw a (flat) ground
465 * type... we have to be nice and convert that for them. */
466 switch (dts->ground.sprite) {
467 case SPR_FLAT_BARE_LAND: DrawClearLandTile(ti, 0); break;
468 case SPR_FLAT_1_THIRD_GRASS_TILE: DrawClearLandTile(ti, 1); break;
469 case SPR_FLAT_2_THIRD_GRASS_TILE: DrawClearLandTile(ti, 2); break;
470 case SPR_FLAT_GRASS_TILE: DrawClearLandTile(ti, 3); break;
471 default: DrawGroundSprite(dts->ground.sprite, palette); break;
472 }
473 } else {
474 DrawGroundSprite(dts->ground.sprite, palette);
475 }
476
478 for (const DrawTileSeqStruct &dtss : dts->GetSequence()) {
480 dtss.image.sprite, palette,
481 ti->x + dtss.delta_x, ti->y + dtss.delta_y,
482 dtss.size_x, dtss.size_y,
483 dtss.size_z, ti->z + dtss.delta_z,
485 );
486 }
487 }
488 } else {
489 DrawNewObjectTile(ti, spec);
490 }
491
493}
494
495static int GetSlopePixelZ_Object(TileIndex tile, uint x, uint y, bool)
496{
497 if (IsObjectType(tile, OBJECT_OWNED_LAND)) {
498 auto [tileh, z] = GetTilePixelSlope(tile);
499
500 return z + GetPartialPixelZ(x & 0xF, y & 0xF, tileh);
501 } else {
502 return GetTileMaxPixelZ(tile);
503 }
504}
505
506static Foundation GetFoundation_Object(TileIndex tile, Slope tileh)
507{
509}
510
516{
518 for (TileIndex tile_cur : o->location) {
519 DeleteNewGRFInspectWindow(GSF_OBJECTS, tile_cur.base());
520
521 MakeWaterKeepingClass(tile_cur, GetTileOwner(tile_cur));
522 }
523 delete o;
524}
525
526std::vector<ClearedObjectArea> _cleared_object_areas;
527
534{
535 TileArea ta = TileArea(tile, 1, 1);
536
537 for (ClearedObjectArea &coa : _cleared_object_areas) {
538 if (coa.area.Intersects(ta)) return &coa;
539 }
540
541 return nullptr;
542}
543
544static CommandCost ClearTile_Object(TileIndex tile, DoCommandFlags flags)
545{
546 /* Get to the northern most tile. */
547 Object *o = Object::GetByTile(tile);
548 TileArea ta = o->location;
549
550 ObjectType type = o->type;
551 const ObjectSpec *spec = ObjectSpec::Get(type);
552
553 CommandCost cost(EXPENSES_CONSTRUCTION, spec->GetClearCost() * ta.w * ta.h / 5);
554 if (spec->flags.Test(ObjectFlag::ClearIncome)) cost.MultiplyCost(-1); // They get an income!
555
556 /* Towns can't remove any objects. */
558
559 /* Water can remove everything! */
561 if (flags.Test(DoCommandFlag::NoWater) && IsTileOnWater(tile)) {
562 /* There is water under the object, treat it as water tile. */
563 return CommandCost(STR_ERROR_CAN_T_BUILD_ON_WATER);
564 } else if (!spec->flags.Test(ObjectFlag::Autoremove) && flags.Test(DoCommandFlag::Auto)) {
565 /* No automatic removal by overbuilding stuff. */
566 return CommandCost(type == OBJECT_HQ ? STR_ERROR_COMPANY_HEADQUARTERS_IN : STR_ERROR_OBJECT_IN_THE_WAY);
567 } else if (_game_mode == GM_EDITOR) {
568 /* No further limitations for the editor. */
569 } else if (GetTileOwner(tile) == OWNER_NONE) {
570 /* Owned by nobody and unremovable, so we can only remove it with brute force! */
572 } else if (CheckTileOwnership(tile).Failed()) {
573 /* We don't own it!. */
574 return CommandCost(STR_ERROR_OWNED_BY);
576 /* In the game editor or with cheats we can remove, otherwise we can't. */
578 if (type == OBJECT_HQ) return CommandCost(STR_ERROR_COMPANY_HEADQUARTERS_IN);
579 return CMD_ERROR;
580 }
581
582 /* Removing with the cheat costs more in TTDPatch / the specs. */
583 cost.MultiplyCost(25);
584 }
585 } else if (spec->flags.Any({ObjectFlag::BuiltOnWater, ObjectFlag::NotOnLand})) {
586 /* Water can't remove objects that are buildable on water. */
587 return CMD_ERROR;
588 }
589
590 switch (type) {
591 case OBJECT_HQ: {
593 if (flags.Test(DoCommandFlag::Execute)) {
594 c->location_of_HQ = INVALID_TILE; // reset HQ position
597 }
598
599 /* cost of relocating company is 1% of company value */
601 break;
602 }
603
604 case OBJECT_STATUE:
605 if (flags.Test(DoCommandFlag::Execute)) {
606 Town *town = o->town;
607 town->statues.Reset(GetTileOwner(tile));
609 }
610 break;
611
612 default:
613 break;
614 }
615
616 _cleared_object_areas.emplace_back(tile, ta);
617
619
620 return cost;
621}
622
623static void AddAcceptedCargo_Object(TileIndex tile, CargoArray &acceptance, CargoTypes &always_accepted)
624{
625 if (!IsObjectType(tile, OBJECT_HQ)) return;
626
627 /* HQ accepts passenger and mail; but we have to divide the values
628 * between 4 tiles it occupies! */
629
630 /* HQ level (depends on company performance) in the range 1..5. */
631 uint level = GetCompanyHQSize(tile) + 1;
632
633 /* Top town building generates 10, so to make HQ interesting, the top
634 * type makes 20. */
635 CargoType pass = GetCargoTypeByLabel(CT_PASSENGERS);
636 if (IsValidCargoType(pass)) {
637 acceptance[pass] += std::max(1U, level);
638 SetBit(always_accepted, pass);
639 }
640
641 /* Top town building generates 4, HQ can make up to 8. The
642 * proportion passengers:mail is different because such a huge
643 * commercial building generates unusually high amount of mail
644 * correspondence per physical visitor. */
645 CargoType mail = GetCargoTypeByLabel(CT_MAIL);
646 if (IsValidCargoType(mail)) {
647 acceptance[mail] += std::max(1U, level / 2);
648 SetBit(always_accepted, mail);
649 }
650}
651
652static void AddProducedCargo_Object(TileIndex tile, CargoArray &produced)
653{
654 if (!IsObjectType(tile, OBJECT_HQ)) return;
655
656 CargoType pass = GetCargoTypeByLabel(CT_PASSENGERS);
657 if (IsValidCargoType(pass)) produced[pass]++;
658 CargoType mail = GetCargoTypeByLabel(CT_MAIL);
659 if (IsValidCargoType(mail)) produced[mail]++;
660}
661
662
663static void GetTileDesc_Object(TileIndex tile, TileDesc &td)
664{
665 const ObjectSpec *spec = ObjectSpec::GetByTile(tile);
666 td.str = spec->name;
667 td.owner[0] = GetTileOwner(tile);
669
670 if (spec->grf_prop.HasGrfFile()) {
671 td.grf = GetGRFConfig(spec->grf_prop.grfid)->GetName();
672 }
673}
674
675static void TileLoop_Object(TileIndex tile)
676{
677 const ObjectSpec *spec = ObjectSpec::GetByTile(tile);
678 if (spec->flags.Test(ObjectFlag::Animation)) {
679 Object *o = Object::GetByTile(tile);
682 }
683
684 if (IsTileOnWater(tile)) TileLoop_Water(tile);
685
686 if (!IsObjectType(tile, OBJECT_HQ)) return;
687
688 /* HQ accepts passenger and mail; but we have to divide the values
689 * between 4 tiles it occupies! */
690
691 /* HQ level (depends on company performance) in the range 1..5. */
692 uint level = GetCompanyHQSize(tile) + 1;
693 assert(level < 6);
694
695 StationFinder stations(TileArea(tile, 2, 2));
696
697 uint r = Random();
698 /* Top town buildings generate 250, so the top HQ type makes 256. */
699 CargoType pass = GetCargoTypeByLabel(CT_PASSENGERS);
700 if (IsValidCargoType(pass) && GB(r, 0, 8) < (256 / 4 / (6 - level))) {
701 uint amt = GB(r, 0, 8) / 8 / 4 + 1;
702
703 /* Production is halved during recessions. */
704 if (EconomyIsInRecession()) amt = (amt + 1) >> 1;
705
706 /* Scale by cargo scale setting. */
707 amt = ScaleByCargoScale(amt, true);
708
709 MoveGoodsToStation(pass, amt, {GetTileOwner(tile), SourceType::Headquarters}, stations.GetStations());
710 }
711
712 /* Top town building generates 90, HQ can make up to 196. The
713 * proportion passengers:mail is about the same as in the acceptance
714 * equations. */
715 CargoType mail = GetCargoTypeByLabel(CT_MAIL);
716 if (IsValidCargoType(mail) && GB(r, 8, 8) < (196 / 4 / (6 - level))) {
717 uint amt = GB(r, 8, 8) / 8 / 4 + 1;
718
719 /* Production is halved during recessions. */
720 if (EconomyIsInRecession()) amt = (amt + 1) >> 1;
721
722 /* Scale by cargo scale setting. */
723 amt = ScaleByCargoScale(amt, true);
724
725 MoveGoodsToStation(mail, amt, {GetTileOwner(tile), SourceType::Headquarters}, stations.GetStations());
726 }
727}
728
729
730static TrackStatus GetTileTrackStatus_Object(TileIndex, TransportType, uint, DiagDirection)
731{
732 return 0;
733}
734
735static bool ClickTile_Object(TileIndex tile)
736{
737 if (!IsObjectType(tile, OBJECT_HQ)) return false;
738
740 return true;
741}
742
743static void AnimateTile_Object(TileIndex tile)
744{
746}
747
753{
754 uint maxx = Map::MaxX();
755 uint maxy = Map::MaxY();
756 uint r = Random();
757
758 /* Scatter the lighthouses more evenly around the perimeter */
759 int perimeter = (GB(r, 16, 16) % (2 * (maxx + maxy))) - maxy;
760 DiagDirection dir;
761 for (dir = DIAGDIR_NE; perimeter > 0; dir++) {
762 perimeter -= (DiagDirToAxis(dir) == AXIS_X) ? maxx : maxy;
763 }
764
765 TileIndex tile;
766 switch (dir) {
767 default:
768 case DIAGDIR_NE: tile = TileXY(maxx - 1, r % maxy); break;
769 case DIAGDIR_SE: tile = TileXY(r % maxx, 1); break;
770 case DIAGDIR_SW: tile = TileXY(1, r % maxy); break;
771 case DIAGDIR_NW: tile = TileXY(r % maxx, maxy - 1); break;
772 }
773
774 /* Only build lighthouses at tiles where the border is sea. */
775 if (!IsTileType(tile, MP_WATER)) return false;
776
777 for (int j = 0; j < 19; j++) {
778 int h;
779 if (IsTileType(tile, MP_CLEAR) && IsTileFlat(tile, &h) && h <= 2 && !IsBridgeAbove(tile)) {
781 assert(tile < Map::Size());
782 return true;
783 }
784 tile += TileOffsByDiagDir(dir);
785 if (!IsValidTile(tile)) return false;
786 }
787 return false;
788}
789
795{
796 TileIndex tile = RandomTile();
797 int h;
798 if (IsTileType(tile, MP_CLEAR) && IsTileFlat(tile, &h) && h >= 4 && !IsBridgeAbove(tile)) {
799 for (auto t : SpiralTileSequence(tile, 9)) {
800 if (IsObjectTypeTile(t, OBJECT_TRANSMITTER)) return false;
801 }
803 return true;
804 }
805 return false;
806}
807
808void GenerateObjects()
809{
810 /* Set a guestimate on how much we progress */
811 SetGeneratingWorldProgress(GWP_OBJECT, (uint)ObjectSpec::Count());
812
813 /* Determine number of water tiles at map border needed for freeform_edges */
814 uint num_water_tiles = 0;
816 for (uint x = 0; x < Map::MaxX(); x++) {
817 if (IsTileType(TileXY(x, 1), MP_WATER)) num_water_tiles++;
818 if (IsTileType(TileXY(x, Map::MaxY() - 1), MP_WATER)) num_water_tiles++;
819 }
820 for (uint y = 1; y < Map::MaxY() - 1; y++) {
821 if (IsTileType(TileXY(1, y), MP_WATER)) num_water_tiles++;
822 if (IsTileType(TileXY(Map::MaxX() - 1, y), MP_WATER)) num_water_tiles++;
823 }
824 }
825
826 /* Iterate over all possible object types */
827 for (const auto &spec : ObjectSpec::Specs()) {
828
829 /* Continue, if the object was never available till now or shall not be placed */
830 if (!spec.WasEverAvailable() || spec.generate_amount == 0) continue;
831
832 uint16_t amount = spec.generate_amount;
833
834 /* Scale by map size */
836 /* Scale the amount of lighthouses with the amount of land at the borders.
837 * The -6 is because the top borders are MP_VOID (-2) and all corners
838 * are counted twice (-4). */
839 amount = Map::ScaleBySize1D(amount * num_water_tiles) / (2 * Map::MaxY() + 2 * Map::MaxX() - 6);
840 } else if (spec.flags.Test(ObjectFlag::ScaleByWater)) {
841 amount = Map::ScaleBySize1D(amount);
842 } else {
843 amount = Map::ScaleBySize(amount);
844 }
845
846 /* Now try to place the requested amount of this object */
847 for (uint j = Map::ScaleBySize(1000); j != 0 && amount != 0 && Object::CanAllocateItem(); j--) {
848 switch (spec.Index()) {
850 if (TryBuildTransmitter()) amount--;
851 break;
852
854 if (TryBuildLightHouse()) amount--;
855 break;
856
857 default:
858 uint8_t view = RandomRange(spec.views);
860 break;
861 }
862 }
864 }
865}
866
867static void ChangeTileOwner_Object(TileIndex tile, Owner old_owner, Owner new_owner)
868{
869 if (!IsTileOwner(tile, old_owner)) return;
870
871 bool do_clear = false;
872
873 ObjectType type = GetObjectType(tile);
874 if ((type == OBJECT_OWNED_LAND || type >= NEW_OBJECT_OFFSET) && new_owner != INVALID_OWNER) {
875 SetTileOwner(tile, new_owner);
876 if (GetWaterClass(tile) == WATER_CLASS_CANAL) {
877 Company::Get(old_owner)->infrastructure.water--;
878 Company::Get(new_owner)->infrastructure.water++;
879 }
880 } else if (type == OBJECT_STATUE) {
881 Town *t = Object::GetByTile(tile)->town;
882 t->statues.Reset(old_owner);
883 if (new_owner != INVALID_OWNER && !t->statues.Test(new_owner)) {
884 /* Transfer ownership to the new company */
885 t->statues.Set(new_owner);
886 SetTileOwner(tile, new_owner);
887 } else {
888 do_clear = true;
889 }
890
892 } else {
893 do_clear = true;
894 }
895
896 if (do_clear) {
898 /* When clearing objects, they may turn into canal, which may require transferring ownership. */
899 ChangeTileOwner(tile, old_owner, new_owner);
900 }
901}
902
903static CommandCost TerraformTile_Object(TileIndex tile, DoCommandFlags flags, int z_new, Slope tileh_new)
904{
905 ObjectType type = GetObjectType(tile);
906
907 if (type == OBJECT_OWNED_LAND) {
908 /* Owned land remains unsold */
910 if (ret.Succeeded()) return CommandCost();
911 } else if (AutoslopeEnabled() && type != OBJECT_TRANSMITTER && type != OBJECT_LIGHTHOUSE) {
912 /* Behaviour:
913 * - Both new and old slope must not be steep.
914 * - TileMaxZ must not be changed.
915 * - Allow autoslope by default.
916 * - Disallow autoslope if callback succeeds and returns non-zero.
917 */
918 Slope tileh_old = GetTileSlope(tile);
919 /* TileMaxZ must not be changed. Slopes must not be steep. */
920 if (!IsSteepSlope(tileh_old) && !IsSteepSlope(tileh_new) && (GetTileMaxZ(tile) == z_new + GetSlopeMaxZ(tileh_new))) {
921 const ObjectSpec *spec = ObjectSpec::Get(type);
922
923 /* Call callback 'disable autosloping for objects'. */
925 /* If the callback fails, allow autoslope. */
926 uint16_t res = GetObjectCallback(CBID_OBJECT_AUTOSLOPE, 0, 0, spec, Object::GetByTile(tile), tile);
927 if (res == CALLBACK_FAILED || !ConvertBooleanCallback(spec->grf_prop.grffile, CBID_OBJECT_AUTOSLOPE, res)) return CommandCost(EXPENSES_CONSTRUCTION, _price[PR_BUILD_FOUNDATION]);
928 } else if (spec->IsEnabled()) {
929 /* allow autoslope */
930 return CommandCost(EXPENSES_CONSTRUCTION, _price[PR_BUILD_FOUNDATION]);
931 }
932 }
933 }
934
935 return Command<CMD_LANDSCAPE_CLEAR>::Do(flags, tile);
936}
937
938extern const TileTypeProcs _tile_type_object_procs = {
939 DrawTile_Object, // draw_tile_proc
940 GetSlopePixelZ_Object, // get_slope_z_proc
941 ClearTile_Object, // clear_tile_proc
942 AddAcceptedCargo_Object, // add_accepted_cargo_proc
943 GetTileDesc_Object, // get_tile_desc_proc
944 GetTileTrackStatus_Object, // get_tile_track_status_proc
945 ClickTile_Object, // click_tile_proc
946 AnimateTile_Object, // animate_tile_proc
947 TileLoop_Object, // tile_loop_proc
948 ChangeTileOwner_Object, // change_tile_owner_proc
949 AddProducedCargo_Object, // add_produced_cargo_proc
950 nullptr, // vehicle_enter_tile_proc
951 GetFoundation_Object, // get_foundation_proc
952 TerraformTile_Object, // terraform_tile_proc
953};
Functions related to autoslope.
bool AutoslopeEnabled()
Tests if autoslope is enabled for _current_company.
Definition autoslope.h:65
debug_inline constexpr bool HasBit(const T x, const uint8_t y)
Checks if a bit in a value is set.
constexpr T SetBit(T &x, const uint8_t y)
Set a bit in a variable.
debug_inline static constexpr uint GB(const T x, const uint8_t s, const uint8_t n)
Fetch n bits from x, started at bit s.
constexpr T ToggleBit(T &x, const uint8_t y)
Toggles a bit in a variable.
void DrawBridgeMiddle(const TileInfo *ti)
Draw the middle bits of a bridge.
TileIndex GetSouthernBridgeEnd(TileIndex t)
Finds the southern end of a bridge starting at a middle tile.
int GetBridgeHeight(TileIndex t)
Get the height ('z') of a bridge.
Map accessor functions for bridges.
bool IsBridgeAbove(Tile t)
checks if a bridge is set above the ground of this tile
Definition bridge_map.h:45
uint8_t CargoType
Cargo slots to indicate a cargo type within a game.
Definition cargo_type.h:23
bool IsValidCargoType(CargoType cargo)
Test whether cargo type is not INVALID_CARGO.
Definition cargo_type.h:106
static constexpr CargoLabel CT_PASSENGERS
Available types of cargo Labels may be re-used between different climates.
Definition cargo_type.h:31
Base class for cargo packets.
Cheats _cheats
All the cheats.
Definition cheat.cpp:16
Types related to cheating.
constexpr bool Test(Tvalue_type value) const
Test if the value-th bit is set.
constexpr Timpl & Reset()
Reset all bits.
constexpr Timpl & Set()
Set all bits.
constexpr bool Any(const Timpl &other) const
Test if any of the given values are set.
Common return value for all commands.
bool Succeeded() const
Did this command succeed?
void AddCost(const Money &cost)
Adds the given cost to the cost of the command.
Money GetCost() const
The costs as made up to this moment.
bool Failed() const
Did this command fail?
void MultiplyCost(int factor)
Multiplies the cost of the command by the given factor.
Enum-as-bit-set wrapper.
Generate TileIndices around a center tile or tile area, with increasing distance.
Structure contains cached list of stations nearby.
static std::unique_ptr< TileIterator > Create(TileIndex corner1, TileIndex corner2, bool diagonal)
Create either an OrthogonalTileIterator or DiagonalTileIterator given the diagonal parameter.
Definition tilearea.cpp:291
Wrapper class to abstract away the way the tiles are stored.
Definition map_func.h:25
static Date date
Current date in days (day counter).
Functions related to clear (MP_CLEAR) land.
Functions related to commands.
static const CommandCost CMD_ERROR
Define a default return value for a failed command.
@ Execute
execute the given command
@ NoModifyTownRating
do not change town rating
@ NoTestTownRating
town rating does not disallow you from building
@ NoWater
don't allow building on water
@ Auto
don't allow building on structures
Definition of stuff that is very close to a company, like the company struct itself.
Money CalculateCompanyValue(const Company *c, bool including_loan=true)
Calculate the value of the company.
Definition economy.cpp:150
CommandCost CheckTileOwnership(TileIndex tile)
Check whether the current owner owns the stuff on the given tile.
PaletteID GetCompanyPalette(CompanyID company)
Get the palette for recolouring with a company colour.
Money GetAvailableMoneyForCommand()
This functions returns the money which can be used to execute a command.
CommandCost CheckOwnership(Owner owner, TileIndex tile)
Check whether the current owner owns something.
CompanyID _current_company
Company currently doing an action.
Functions related to companies.
void ShowCompany(CompanyID company)
Show the window with the overview of the company.
void DirtyCompanyInfrastructureWindows(CompanyID company)
Redraw all windows with company infrastructure counts.
GUI Functions related to companies.
static constexpr Owner OWNER_DEITY
The object is owned by a superuser / goal script.
static constexpr Owner OWNER_TOWN
A town owns the tile, or a town is expanding.
static constexpr Owner OWNER_NONE
The tile has no ownership.
static constexpr Owner INVALID_OWNER
An invalid owner.
static constexpr Owner OWNER_WATER
The tile/execution is done by "water".
Axis DiagDirToAxis(DiagDirection d)
Convert a DiagDirection to the axis.
@ AXIS_X
The X axis.
DiagDirection
Enumeration for diagonal directions.
@ DIAGDIR_NE
Northeast, upper right on your monitor.
@ DIAGDIR_NW
Northwest.
@ DIAGDIR_SE
Southeast.
@ DIAGDIR_SW
Southwest.
int UpdateCompanyRatingAndValue(Company *c, bool update)
if update is set to true, the economy is updated with this score (also the house is updated,...
Definition economy.cpp:202
bool EconomyIsInRecession()
Is the economy in recession?
uint ScaleByCargoScale(uint num, bool town)
Scale a number by the cargo scale setting.
@ EXPENSES_CONSTRUCTION
Construction costs.
bool _generating_world
Whether we are generating the map or not.
Definition genworld.cpp:74
Functions related to world/map generation.
void IncreaseGeneratingWorldProgress(GenWorldProgress cls)
Increases the current stage of the world generation with one.
@ GWP_OBJECT
Generate objects (radio tower, light houses)
Definition genworld.h:68
void SetGeneratingWorldProgress(GenWorldProgress cls, uint total)
Set the total of a stage of the world generation.
uint32_t PaletteID
The number of the palette.
Definition gfx_type.h:18
void MarkTileDirtyByTile(TileIndex tile, int bridge_level_offset, int tile_height_override)
Mark a tile given by its index dirty for repaint.
uint GetPartialPixelZ(int x, int y, Slope corners)
Determines height at given coordinate of a slope.
void ChangeTileOwner(TileIndex tile, Owner old_owner, Owner new_owner)
Change the owner of a tile.
void DrawFoundation(TileInfo *ti, Foundation f)
Draw foundation f at tile ti.
Functions related to OTTD's landscape.
Command definitions related to landscape (slopes etc.).
@ Random
Randomise borders.
static debug_inline TileIndex TileXY(uint x, uint y)
Returns the TileIndex of a coordinate.
Definition map_func.h:372
#define RandomTile()
Get a valid random tile.
Definition map_func.h:651
static debug_inline uint TileY(TileIndex tile)
Get the Y component of a tile.
Definition map_func.h:424
static debug_inline uint TileX(TileIndex tile)
Get the X component of a tile.
Definition map_func.h:414
TileIndexDiff TileOffsByDiagDir(DiagDirection dir)
Convert a DiagDirection to a TileIndexDiff.
Definition map_func.h:569
@ CBID_OBJECT_LAND_SLOPE_CHECK
Callback done for each tile of an object to check the slope.
@ CBID_OBJECT_AUTOSLOPE
Called to determine if one can alter the ground below an object tile.
@ CBID_OBJECT_COLOUR
Called to determine the colour of a town building.
@ Autoslope
decides allowance of autosloping
@ Colour
decide the colour of the building
@ SlopeCheck
decides slope suitability
static const uint CALLBACK_FAILED
Different values for Callback result evaluations.
void ErrorUnknownCallbackResult(uint32_t grfid, uint16_t cbid, uint16_t cb_res)
Record that a NewGRF returned an unknown/invalid callback result.
CommandCost GetErrorMessageFromLocationCallbackResult(uint16_t cb_res, std::span< const int32_t > textstack, const GRFFile *grffile, StringID default_error)
Get the error message from a shape/location/slope check callback result.
bool ConvertBooleanCallback(const GRFFile *grffile, uint16_t cbid, uint16_t cb_res)
Converts a callback result into a boolean.
GRFConfig * GetGRFConfig(uint32_t grfid, uint32_t mask)
Retrieve a NewGRF from the current config by its grfid.
Functions to find and configure NewGRFs.
Functions/types related to NewGRF debugging.
void DeleteNewGRFInspectWindow(GrfSpecFeature feature, uint index)
Delete inspect window for a given feature and index.
void DrawNewObjectTile(TileInfo *ti, const ObjectSpec *spec)
Draw an object on the map.
bool TriggerObjectAnimation(Object *o, ObjectAnimationTrigger trigger, const ObjectSpec *spec)
Trigger the update of animation on a whole object.
bool TriggerObjectTileAnimation(Object *o, TileIndex tile, ObjectAnimationTrigger trigger, const ObjectSpec *spec)
Trigger the update of animation on a single tile.
void AnimateNewObjectTile(TileIndex tile)
Handle the animation of the object tile.
uint16_t GetObjectCallback(CallbackID callback, uint32_t param1, uint32_t param2, const ObjectSpec *spec, Object *o, TileIndex tile, std::span< int32_t > regs100, uint8_t view)
Perform a callback for an object.
Functions related to NewGRF objects.
static const uint8_t OBJECT_SIZE_1X1
The value of a NewGRF's size property when the object is 1x1 tiles: low nibble for X,...
@ Autoremove
Object get automatically removed (like "owned land").
@ CannotRemove
Object can not be removed.
@ AllowUnderBridge
Object can built under a bridge.
@ OnlyInScenedit
Object can only be constructed in the scenario editor.
@ BuiltOnWater
Object can be built on water (not required).
@ OnlyInGame
Object can only be built in game.
@ HasNoFoundation
Do not display foundations when on a slope.
@ Uses2CC
Object wants 2CC colour mapping.
@ NotOnLand
Object can not be on land, implicitly sets ObjectFlag::BuiltOnWater.
@ ScaleByWater
Object count is roughly scaled by water amount at edges.
@ Animation
Object has animated tiles.
@ ClearIncome
When object is cleared a positive income is generated instead of a cost.
Functions related to objects.
Base for all objects.
void UpdateObjectColours(const Company *c)
Updates the colour of the object whenever a company changes.
void BuildObject(ObjectType type, TileIndex tile, CompanyID owner, Town *town, uint8_t view)
Actually build the object.
static void ReallyClearObjectTile(Object *o)
Perform the actual removal of the object from the map.
CommandCost CheckBuildableTile(TileIndex tile, DiagDirections invalid_dirs, int &allowed_z, bool allow_steep, bool check_bridge)
Checks if the given tile is buildable, flat and has a certain height.
void InitializeObjects()
Initialize/reset the objects.
static uint8_t GetCompanyHQSize(TileIndex tile)
Get the size of the HQ.
static bool TryBuildTransmitter()
Try to build a transmitter.
CommandCost CmdBuildObjectArea(DoCommandFlags flags, TileIndex tile, TileIndex start_tile, ObjectType type, uint8_t view, bool diagonal)
Construct multiple objects in an area.
static bool TryBuildLightHouse()
Try to build a lighthouse.
ObjectType GetObjectType(Tile t)
Gets the ObjectType of the given object tile.
void UpdateCompanyHQ(TileIndex tile, uint score)
Update the CompanyHQ to the state associated with the given score.
ClearedObjectArea * FindClearedObject(TileIndex tile)
Find the entry in _cleared_object_areas which occupies a certain tile.
static void IncreaseCompanyHQSize(TileIndex tile)
Increase the HQ size.
CommandCost CmdBuildObject(DoCommandFlags flags, TileIndex tile, ObjectType type, uint8_t view)
Build an object object.
Command definitions related to objects.
Sprites to use and how to display them for object tiles.
Map accessors for object tiles.
void MakeObject(Tile t, Owner o, ObjectID index, WaterClass wc, uint8_t random)
Make an Object tile.
Definition object_map.h:74
bool IsObjectTypeTile(Tile t, ObjectType type)
Check whether a tile is a object tile of a specific type.
Definition object_map.h:36
bool IsObjectType(Tile t, ObjectType type)
Check whether the object on a tile is of a specific type.
Definition object_map.h:25
ObjectID GetObjectIndex(Tile t)
Get the index of which object this tile is attached to.
Definition object_map.h:47
static const ObjectType OBJECT_LIGHTHOUSE
The nice lighthouse.
Definition object_type.h:19
uint16_t ObjectType
Types of objects.
Definition object_type.h:16
static const ObjectType OBJECT_STATUE
Statue in towns.
Definition object_type.h:20
static const ObjectType OBJECT_HQ
HeadQuarter of a player.
Definition object_type.h:22
static const ObjectType OBJECT_TRANSMITTER
The large antenna.
Definition object_type.h:18
@ Built
Triggered when the object is built (for all tiles at the same time).
@ TileLoop
Triggered in the periodic tile loop.
@ TileLoopNorth
Triggered every 256 ticks (for all tiles at the same time).
static const ObjectType NEW_OBJECT_OFFSET
Offset for new objects.
Definition object_type.h:24
static const ObjectType OBJECT_OWNED_LAND
Owned land 'flag'.
Definition object_type.h:21
Some methods of Pool are placed here in order to reduce compilation time and binary size.
#define INSTANTIATE_POOL_METHODS(name)
Force instantiation of pool methods so we don't get linker errors.
Pseudo random number generator.
uint32_t RandomRange(uint32_t limit, const std::source_location location=std::source_location::current())
Pick a random number between 0 and limit - 1, inclusive.
A number of safeguards to prevent using unsafe methods.
GameSettings _settings_game
Game settings of a running game or the scenario editor.
Definition settings.cpp:61
static constexpr int GetSlopeMaxZ(Slope s)
Returns the height of the highest corner of a slope relative to TileZ (= minimal height)
Definition slope_func.h:160
static constexpr bool IsSteepSlope(Slope s)
Checks if a slope is steep.
Definition slope_func.h:36
Foundation FlatteningFoundation(Slope s)
Returns the foundation needed to flatten a slope.
Definition slope_func.h:369
Slope
Enumeration for the slope-type.
Definition slope_type.h:48
@ SLOPE_FLAT
a flat tile
Definition slope_type.h:49
Foundation
Enumeration for Foundations.
Definition slope_type.h:93
@ FOUNDATION_NONE
The tile has no foundation, the slope remains unchanged.
Definition slope_type.h:94
@ Headquarters
Source/destination are company headquarters.
Functions related to stations.
Definition of base types and functions in a cross-platform compatible way.
Class for storing amounts of cargo.
Definition cargo_type.h:113
static void InvalidateAllFrom(Source src)
Invalidates (sets source_id to INVALID_SOURCE) all cargo packets from given source.
bool value
tells if the bool cheat is active or not
Definition cheat_type.h:18
Cheat magic_bulldozer
dynamite industries, objects
Definition cheat_type.h:27
Keeps track of removed objects during execution/testruns of commands.
Definition object_base.h:86
TileIndex location_of_HQ
Northern tile of HQ; INVALID_TILE when there is none.
uint32_t build_object_limit
Amount of tiles we can (still) build objects on (times 65536). Also applies to buying land.
bool freeform_edges
allow terraforming the tiles at the map edges
A tile child sprite and palette to draw for stations etc, with 3D bounding box.
Definition sprite.h:22
Ground palette sprite of a tile, together with its sprite layout.
Definition sprite.h:43
PalSpriteID ground
Palette and sprite for the ground.
Definition sprite.h:44
std::string GetName() const
Get the name of this grf.
const struct GRFFile * grffile
grf file that introduced this entity
uint32_t grfid
grfid that introduced this entity.
bool HasGrfFile() const
Test if this entity was introduced by NewGRF.
ConstructionSettings construction
construction of things in-game
Information about a particular livery.
Definition livery.h:78
Colours colour2
Second colour, for vehicles with 2CC support.
Definition livery.h:81
Colours colour1
First colour, for all vehicles.
Definition livery.h:80
static uint ScaleBySize(uint n)
Scales the given value by the map size, where the given value is for a 256 by 256 map.
Definition map_func.h:327
static uint ScaleBySize1D(uint n)
Scales the given value by the maps circumference, where the given value is for a 256 by 256 map.
Definition map_func.h:340
static uint MaxY()
Gets the maximum Y coordinate within the map, including MP_VOID.
Definition map_func.h:305
static debug_inline uint Size()
Get the size of the map.
Definition map_func.h:287
static debug_inline uint MaxX()
Gets the maximum X coordinate within the map, including MP_VOID.
Definition map_func.h:296
Allow incrementing of ObjectClassID variables.
bool IsEnabled() const
Test if this object is enabled.
StandardGRFFileProps grf_prop
Properties related the the grf file.
StringID name
The name for this object.
static const ObjectSpec * GetByTile(TileIndex tile)
Get the specification associated with a tile.
static const ObjectSpec * Get(ObjectType index)
Get the specification associated with a specific ObjectType.
bool IsAvailable() const
Check whether the object is available at this time.
Money GetClearCost() const
Get the cost for clearing a structure of this type.
uint8_t size
The size of this objects; low nibble for X, high nibble for Y.
uint8_t generate_amount
Number of objects which are attempted to be generated per 256^2 map during world generation.
uint Index() const
Gets the index of this spec.
ObjectCallbackMasks callback_mask
Bitmask of requested/allowed callbacks.
ObjectFlags flags
Flags/settings related to the object.
uint8_t height
The height of this structure, in heightlevels; max MAX_TILE_HEIGHT.
bool WasEverAvailable() const
Check whether the object was available at some point in the past or present in this game with the cur...
Money GetBuildCost() const
Get the cost for building a structure of this type.
uint8_t views
The number of views.
An object, such as transmitter, on the map.
Definition object_base.h:23
ObjectType type
Type of the object.
Definition object_base.h:24
Town * town
Town the object is built in.
Definition object_base.h:25
static std::array< uint16_t, NUM_OBJECTS > counts
Number of objects per type ingame.
Definition object_base.h:80
static Object * GetByTile(TileIndex tile)
Get the object associated with a tile.
static void IncTypeCount(ObjectType type)
Increment the count of objects for this type.
Definition object_base.h:45
TimerGameCalendar::Date build_date
Date of construction.
Definition object_base.h:27
TileArea location
Location of the object.
Definition object_base.h:26
uint8_t colour
Colour of the object, for display purpose.
Definition object_base.h:28
static void DecTypeCount(ObjectType type)
Decrement the count of objects for this type.
Definition object_base.h:56
static void ResetTypeCounts()
Resets object counts.
Definition object_base.h:74
Represents the covered area of e.g.
uint16_t w
The width of the area.
TileIndex tile
The base tile of the area.
uint16_t h
The height of the area.
SpriteID sprite
The 'real' sprite.
Definition gfx_type.h:23
static Pool::IterateWrapper< Titem > Iterate(size_t from=0)
Returns an iterable ensemble of all valid Titem.
static Titem * Get(auto index)
Returns Titem with given index.
static size_t GetNumItems()
Returns number of valid items in the pool.
Tindex index
Index of this pool item.
static bool CanAllocateItem(size_t n=1)
Helper functions so we can use PoolItem::Function() instead of _poolitem_pool.Function()
static Titem * GetIfValid(auto index)
Returns Titem with given index.
Base class for all pools.
Tile description for the 'land area information' tool.
Definition tile_cmd.h:38
std::optional< std::string > grf
newGRF used for the tile contents
Definition tile_cmd.h:49
StringID str
Description of the tile.
Definition tile_cmd.h:39
TimerGameCalendar::Date build_date
Date of construction of tile contents.
Definition tile_cmd.h:43
std::array< Owner, 4 > owner
Name of the owner(s)
Definition tile_cmd.h:41
Tile information, used while rendering the tile.
Definition tile_cmd.h:29
int z
Height.
Definition tile_cmd.h:34
int x
X position of the tile in unit coordinates.
Definition tile_cmd.h:30
Slope tileh
Slope of the tile.
Definition tile_cmd.h:32
TileIndex tile
Tile index.
Definition tile_cmd.h:33
int y
Y position of the tile in unit coordinates.
Definition tile_cmd.h:31
Set of callback functions for performing tile operations of a given tile type.
Definition tile_cmd.h:144
Town data structure.
Definition town.h:52
CompanyMask statues
which companies have a statue?
Definition town.h:68
bool IsTileFlat(TileIndex tile, int *h)
Check if a given tile is flat.
Definition tile_map.cpp:95
std::tuple< Slope, int > GetTileSlopeZ(TileIndex tile)
Return the slope of a given tile inside the map.
Definition tile_map.cpp:55
int GetTileMaxZ(TileIndex t)
Get top height of the tile inside the map.
Definition tile_map.cpp:136
bool IsTileOwner(Tile tile, Owner owner)
Checks if a tile belongs to the given owner.
Definition tile_map.h:214
Owner GetTileOwner(Tile tile)
Returns the owner of a tile.
Definition tile_map.h:178
void SetTileOwner(Tile tile, Owner owner)
Sets the owner of a tile.
Definition tile_map.h:198
int GetTileMaxPixelZ(TileIndex tile)
Get top height of the tile.
Definition tile_map.h:312
uint8_t GetAnimationFrame(Tile t)
Get the current animation frame.
Definition tile_map.h:250
std::tuple< Slope, int > GetTilePixelSlope(TileIndex tile)
Return the slope of a given tile.
Definition tile_map.h:289
bool IsValidTile(Tile tile)
Checks if a tile is valid.
Definition tile_map.h:161
void SetAnimationFrame(Tile t, uint8_t frame)
Set a new animation frame.
Definition tile_map.h:262
static debug_inline bool IsTileType(Tile tile, TileType type)
Checks if a tile is a given tiletype.
Definition tile_map.h:150
Slope GetTileSlope(TileIndex tile)
Return the slope of a given tile inside the map.
Definition tile_map.h:279
constexpr TileIndex INVALID_TILE
The very nice invalid tile marker.
Definition tile_type.h:95
@ MP_CLEAR
A tile without any structures, i.e. grass, rocks, farm fields etc.
Definition tile_type.h:48
@ MP_WATER
Water tile.
Definition tile_type.h:54
@ MP_OBJECT
Contains objects such as transmitters and owned land.
Definition tile_type.h:58
OrthogonalTileArea TileArea
Shorthand for the much more common orthogonal tile area.
Definition of the game-calendar-timer.
Base of the town class.
Town * CalcClosestTownFromTile(TileIndex tile, uint threshold=UINT_MAX)
Return the town closest to the given tile within threshold.
bool IsTransparencySet(TransparencyOption to)
Check if the transparency option bit is set and if we aren't in the game menu (there's never transpar...
bool IsInvisibilitySet(TransparencyOption to)
Check if the invisibility option bit is set and if we aren't in the game menu (there's never transpar...
@ TO_STRUCTURES
other objects such as transmitters and lighthouses
TransportType
Available types of transport.
CommandCost EnsureNoVehicleOnGround(TileIndex tile)
Ensure there is no vehicle at the ground at the given position.
Definition vehicle.cpp:527
Functions related to vehicles.
void AddSortableSpriteToDraw(SpriteID image, PaletteID pal, int x, int y, int w, int h, int dz, int z, bool transparent, int bb_offset_x, int bb_offset_y, int bb_offset_z, const SubSprite *sub)
Draw a (transparent) sprite at given coordinates with a given bounding box.
Definition viewport.cpp:663
void DrawGroundSprite(SpriteID image, PaletteID pal, const SubSprite *sub, int extra_offs_x, int extra_offs_y)
Draws a ground sprite for the current tile.
Definition viewport.cpp:579
Functions related to (drawing on) viewports.
Functions related to water (management)
void TileLoop_Water(TileIndex tile)
Let a water tile floods its diagonal adjoining tiles called from tunnelbridge_cmd,...
void ClearNeighbourNonFloodingStates(TileIndex tile)
Clear non-flooding state of the tiles around a tile.
Definition water_cmd.cpp:97
bool HasTileWaterGround(Tile t)
Checks whether the tile has water at the ground.
Definition water_map.h:350
bool IsTileOnWater(Tile t)
Tests if the tile was built on water.
Definition water_map.h:136
WaterClass
classes of water (for WATER_TILE_CLEAR water tile type).
Definition water_map.h:39
@ WATER_CLASS_CANAL
Canal.
Definition water_map.h:41
@ WATER_CLASS_INVALID
Used for industry tiles on land (also for oilrig if newgrf says so).
Definition water_map.h:43
WaterClass GetWaterClass(Tile t)
Get the water class at a tile.
Definition water_map.h:112
bool IsDockingTile(Tile t)
Checks whether the tile is marked as a dockling tile.
Definition water_map.h:371
bool IsWaterTile(Tile t)
Is it a water tile with plain water?
Definition water_map.h:190
void InvalidateWaterRegion(TileIndex tile)
Marks the water region that tile is part of as invalid.
Handles dividing the water in the map into regions to assist pathfinding.
void SetWindowDirty(WindowClass cls, WindowNumber number)
Mark window as dirty (in need of repainting)
Definition window.cpp:3147
Window functions not directly related to making/drawing windows.
@ WC_TOWN_AUTHORITY
Town authority; Window numbers:
@ WC_COMPANY
Company view; Window numbers: