2009-08-21 22:21:05 +02:00
|
|
|
/*
|
|
|
|
* This file is part of OpenTTD.
|
|
|
|
* 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.
|
|
|
|
* 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.
|
|
|
|
* 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/>.
|
|
|
|
*/
|
|
|
|
|
2008-05-06 17:11:33 +02:00
|
|
|
/** @file newgrf_cargo.cpp Implementation of NewGRF cargoes. */
|
|
|
|
|
2007-03-23 21:55:45 +01:00
|
|
|
#include "stdafx.h"
|
2007-03-26 10:43:14 +02:00
|
|
|
#include "debug.h"
|
2007-03-23 21:55:45 +01:00
|
|
|
#include "newgrf_spritegroup.h"
|
|
|
|
|
2014-04-23 22:13:33 +02:00
|
|
|
#include "safeguards.h"
|
|
|
|
|
2012-11-10 21:46:39 +01:00
|
|
|
/** Resolver of cargo. */
|
2012-11-10 21:39:39 +01:00
|
|
|
struct CargoResolverObject : public ResolverObject {
|
2020-01-26 13:45:51 +01:00
|
|
|
const CargoSpec *cargospec;
|
|
|
|
|
2012-11-10 21:39:39 +01:00
|
|
|
CargoResolverObject(const CargoSpec *cs, CallbackID callback = CBID_NO_CALLBACK, uint32 callback_param1 = 0, uint32 callback_param2 = 0);
|
2007-03-23 21:55:45 +01:00
|
|
|
|
2020-01-26 13:45:51 +01:00
|
|
|
GrfSpecFeature GetFeature() const override;
|
|
|
|
uint32 GetDebugID() const override;
|
2012-11-10 21:39:39 +01:00
|
|
|
};
|
2007-03-23 21:55:45 +01:00
|
|
|
|
2020-01-26 13:45:51 +01:00
|
|
|
GrfSpecFeature CargoResolverObject::GetFeature() const
|
|
|
|
{
|
|
|
|
return GSF_CARGOES;
|
|
|
|
}
|
|
|
|
|
|
|
|
uint32 CargoResolverObject::GetDebugID() const
|
|
|
|
{
|
|
|
|
return this->cargospec->label;
|
|
|
|
}
|
|
|
|
|
2012-11-10 21:46:39 +01:00
|
|
|
/**
|
|
|
|
* Constructor of the cargo resolver.
|
|
|
|
* @param cs Cargo being resolved.
|
|
|
|
* @param callback Callback ID.
|
|
|
|
* @param callback_param1 First parameter (var 10) of the callback.
|
|
|
|
* @param callback_param2 Second parameter (var 18) of the callback.
|
|
|
|
*/
|
2012-11-10 21:39:39 +01:00
|
|
|
CargoResolverObject::CargoResolverObject(const CargoSpec *cs, CallbackID callback, uint32 callback_param1, uint32 callback_param2)
|
2020-01-26 13:45:51 +01:00
|
|
|
: ResolverObject(cs->grffile, callback, callback_param1, callback_param2), cargospec(cs)
|
2007-03-23 21:55:45 +01:00
|
|
|
{
|
2014-03-03 21:02:31 +01:00
|
|
|
this->root_spritegroup = cs->group;
|
2007-03-23 21:55:45 +01:00
|
|
|
}
|
|
|
|
|
2012-11-10 21:46:39 +01:00
|
|
|
/**
|
|
|
|
* Get the custom sprite for the given cargo type.
|
|
|
|
* @param cs Cargo being queried.
|
|
|
|
* @return Custom sprite to draw, or \c 0 if not available.
|
|
|
|
*/
|
2007-03-23 21:55:45 +01:00
|
|
|
SpriteID GetCustomCargoSprite(const CargoSpec *cs)
|
|
|
|
{
|
2012-11-10 21:39:39 +01:00
|
|
|
CargoResolverObject object(cs);
|
2014-03-03 21:02:31 +01:00
|
|
|
const SpriteGroup *group = object.Resolve();
|
2019-04-10 23:07:06 +02:00
|
|
|
if (group == nullptr) return 0;
|
2007-03-23 21:55:45 +01:00
|
|
|
|
2009-05-23 14:13:42 +02:00
|
|
|
return group->GetResult();
|
2007-03-23 21:55:45 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
|
2007-07-25 21:06:29 +02:00
|
|
|
uint16 GetCargoCallback(CallbackID callback, uint32 param1, uint32 param2, const CargoSpec *cs)
|
2007-03-23 21:55:45 +01:00
|
|
|
{
|
2012-11-10 21:39:39 +01:00
|
|
|
CargoResolverObject object(cs, callback, param1, param2);
|
2014-03-03 21:02:31 +01:00
|
|
|
return object.ResolveCallback();
|
2007-03-23 21:55:45 +01:00
|
|
|
}
|
2007-04-13 21:32:18 +02:00
|
|
|
|
2012-02-07 23:46:26 +01:00
|
|
|
/**
|
|
|
|
* Translate a GRF-local cargo slot/bitnum into a CargoID.
|
|
|
|
* @param cargo GRF-local cargo slot/bitnum.
|
|
|
|
* @param grffile Originating GRF file.
|
|
|
|
* @param usebit Defines the meaning of \a cargo for GRF version < 7.
|
|
|
|
* If true, then \a cargo is a bitnum. If false, then \a cargo is a cargoslot.
|
|
|
|
* For GRF version >= 7 \a cargo is always a translated cargo bit.
|
|
|
|
* @return CargoID or CT_INVALID if the cargo is not available.
|
|
|
|
*/
|
2007-10-13 04:23:11 +02:00
|
|
|
CargoID GetCargoTranslation(uint8 cargo, const GRFFile *grffile, bool usebit)
|
2007-04-13 21:32:18 +02:00
|
|
|
{
|
2012-02-08 19:11:49 +01:00
|
|
|
/* Pre-version 7 uses the 'climate dependent' ID in callbacks and properties, i.e. cargo is the cargo ID */
|
2021-01-10 15:10:03 +01:00
|
|
|
if (grffile->grf_version < 7 && !usebit) {
|
|
|
|
if (cargo >= CargoSpec::GetArraySize() || !CargoSpec::Get(cargo)->IsValid()) return CT_INVALID;
|
|
|
|
return cargo;
|
|
|
|
}
|
2012-02-08 19:11:49 +01:00
|
|
|
|
|
|
|
/* Other cases use (possibly translated) cargobits */
|
|
|
|
|
2018-09-23 13:23:54 +02:00
|
|
|
if (grffile->cargo_list.size() > 0) {
|
2012-02-08 19:11:49 +01:00
|
|
|
/* ...and the cargo is in bounds, then get the cargo ID for
|
|
|
|
* the label */
|
2018-09-23 13:23:54 +02:00
|
|
|
if (cargo < grffile->cargo_list.size()) return GetCargoIDByLabel(grffile->cargo_list[cargo]);
|
2012-02-08 19:11:49 +01:00
|
|
|
} else {
|
2007-10-13 04:23:11 +02:00
|
|
|
/* Else the cargo value is a 'climate independent' 'bitnum' */
|
2012-02-07 23:46:26 +01:00
|
|
|
return GetCargoIDByBitnum(cargo);
|
2007-10-13 04:23:11 +02:00
|
|
|
}
|
|
|
|
return CT_INVALID;
|
2007-04-13 21:32:18 +02:00
|
|
|
}
|