Function GetRawSprite

src/spritecache.cpp:855–895

* Reads a sprite (from disk or sprite cache). * If the sprite is not available or of wrong type, a fallback sprite is returned. * @param sprite Sprite to read. * @param type Expected sprite type. * @param allocator Allocator function to use. Set to nullptr to use the usual sprite cache. * @param encoder Sprite encoder to use. Set to nullptr to use the currently active blitter. * @return Spri

 * @return Sprite raw data
 */
void *GetRawSprite(SpriteID sprite, SpriteType type, SpriteAllocator *allocator, SpriteEncoder *encoder)
{
	assert(type != SpriteType::MapGen || IsMapgenSpriteID(sprite));
	assert(type < SpriteType::Invalid);

	if (!SpriteExists(sprite)) {
		Debug(sprite, 1, "Tried to load non-existing sprite #{}. Probable cause: Wrong/missing NewGRFs", sprite);

		/* SPR_IMG_QUERY is a BIG FAT RED ? */
		sprite = SPR_IMG_QUERY;
	}

	SpriteCache *sc = GetSpriteCache(sprite);

	if (sc->type != type) return HandleInvalidSpriteRequest(sprite, type, sc, allocator, encoder);

	if (allocator == nullptr && encoder == nullptr) {
		/* Load sprite into/from spritecache */

		/* Update LRU */
		sc->lru = ++_sprite_lru_counter;

		/* Load the sprite, if it is not loaded, yet */
		if (sc->ptr == nullptr) {
			UniquePtrSpriteAllocator cache_allocator;
			if (sc->type == SpriteType::Recolour) {
				ReadRecolourSprite(*sc->file, sc->file_pos, sc->length, cache_allocator);
			} else {
				ReadSprite(sc, sprite, type, cache_allocator, nullptr);
			}
			sc->ptr = std::move(cache_allocator.data);
			sc->length = static_cast<uint32_t>(cache_allocator.size);
			_spritecache_bytes_used += sc->length;
		}

		return static_cast<void *>(sc->ptr.get());
	} else {
		/* Do not use the spritecache, but a different allocator. */
		return ReadSprite(sc, sprite, type, *allocator, encoder);
	}
}

void GfxInitSpriteMem()
{