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/>.
10 /** @file gfxinit.cpp Initializing of the (GRF) graphics. */
15 #include "3rdparty/md5/md5.h"
16 #include "fontcache.h"
18 #include "transparency.h"
19 #include "blitter/factory.hpp"
20 #include "video/video_driver.hpp"
21 #include "window_func.h"
23 /* The type of set we're replacing */
24 #define SET_TYPE "graphics"
25 #include "base_media_func.h"
27 #include "table/sprites.h"
29 #include "safeguards.h"
31 /** Whether the given NewGRFs must get a palette remap from windows to DOS or not. */
32 bool _palette_remap_grf
[MAX_FILE_SLOTS
];
34 #include "table/landscape_sprite.h"
36 /** Offsets for loading the different "replacement" sprites in the files. */
37 static const SpriteID
* const _landscape_spriteindexes
[] = {
38 _landscape_spriteindexes_arctic
,
39 _landscape_spriteindexes_tropic
,
40 _landscape_spriteindexes_toyland
,
44 * Load an old fashioned GRF file.
45 * @param filename The name of the file to open.
46 * @param load_index The offset of the first sprite.
47 * @param file_index The Fio offset to load the file in.
48 * @return The number of loaded sprites.
50 static uint
LoadGrfFile(const char *filename
, uint load_index
, int file_index
)
52 uint load_index_org
= load_index
;
55 FioOpenFile(file_index
, filename
, BASESET_DIR
);
57 DEBUG(sprite
, 2, "Reading grf-file '%s'", filename
);
59 byte container_ver
= GetGRFContainerVersion();
60 if (container_ver
== 0) usererror("Base grf '%s' is corrupt", filename
);
61 ReadGRFSpriteOffsets(container_ver
);
62 if (container_ver
>= 2) {
63 /* Read compression. */
64 byte compression
= FioReadByte();
65 if (compression
!= 0) usererror("Unsupported compression format");
68 while (LoadNextSprite(load_index
, file_index
, sprite_id
, container_ver
)) {
71 if (load_index
>= MAX_SPRITES
) {
72 usererror("Too many sprites. Recompile with higher MAX_SPRITES value or remove some custom GRF files.");
75 DEBUG(sprite
, 2, "Currently %i sprites are loaded", load_index
);
77 return load_index
- load_index_org
;
81 * Load an old fashioned GRF file to replace already loaded sprites.
82 * @param filename The name of the file to open.
83 * @param index_tbl The offsets of each of the sprites.
84 * @param file_index The Fio offset to load the file in.
85 * @return The number of loaded sprites.
87 static void LoadGrfFileIndexed(const char *filename
, const SpriteID
*index_tbl
, int file_index
)
92 FioOpenFile(file_index
, filename
, BASESET_DIR
);
94 DEBUG(sprite
, 2, "Reading indexed grf-file '%s'", filename
);
96 byte container_ver
= GetGRFContainerVersion();
97 if (container_ver
== 0) usererror("Base grf '%s' is corrupt", filename
);
98 ReadGRFSpriteOffsets(container_ver
);
99 if (container_ver
>= 2) {
100 /* Read compression. */
101 byte compression
= FioReadByte();
102 if (compression
!= 0) usererror("Unsupported compression format");
105 while ((start
= *index_tbl
++) != END
) {
106 uint end
= *index_tbl
++;
109 bool b
= LoadNextSprite(start
, file_index
, sprite_id
, container_ver
);
112 } while (++start
<= end
);
117 * Checks whether the MD5 checksums of the files are correct.
119 * @note Also checks sample.cat and other required non-NewGRF GRFs for corruption.
121 void CheckExternalFiles()
123 if (BaseGraphics::GetUsedSet() == NULL
|| BaseSounds::GetUsedSet() == NULL
) return;
125 const GraphicsSet
*used_set
= BaseGraphics::GetUsedSet();
127 DEBUG(grf
, 1, "Using the %s base graphics set", used_set
->name
);
129 static const size_t ERROR_MESSAGE_LENGTH
= 256;
130 static const size_t MISSING_FILE_MESSAGE_LENGTH
= 128;
132 /* Allocate for a message for each missing file and for one error
135 char error_msg
[MISSING_FILE_MESSAGE_LENGTH
* (GraphicsSet::NUM_FILES
+ SoundsSet::NUM_FILES
) + 2 * ERROR_MESSAGE_LENGTH
];
137 char *add_pos
= error_msg
;
138 const char *last
= lastof(error_msg
);
140 if (used_set
->GetNumInvalid() != 0) {
141 /* Not all files were loaded successfully, see which ones */
142 add_pos
+= seprintf(add_pos
, last
, "Trying to load graphics set '%s', but it is incomplete. The game will probably not run correctly until you properly install this set or select another one. See section 4.1 of README.md.\n\nThe following files are corrupted or missing:\n", used_set
->name
);
143 for (uint i
= 0; i
< GraphicsSet::NUM_FILES
; i
++) {
144 MD5File::ChecksumResult res
= GraphicsSet::CheckMD5(&used_set
->files
[i
], BASESET_DIR
);
145 if (res
!= MD5File::CR_MATCH
) add_pos
+= seprintf(add_pos
, last
, "\t%s is %s (%s)\n", used_set
->files
[i
].filename
, res
== MD5File::CR_MISMATCH
? "corrupt" : "missing", used_set
->files
[i
].missing_warning
);
147 add_pos
+= seprintf(add_pos
, last
, "\n");
150 const SoundsSet
*sounds_set
= BaseSounds::GetUsedSet();
151 if (sounds_set
->GetNumInvalid() != 0) {
152 add_pos
+= seprintf(add_pos
, last
, "Trying to load sound set '%s', but it is incomplete. The game will probably not run correctly until you properly install this set or select another one. See section 4.1 of README.md.\n\nThe following files are corrupted or missing:\n", sounds_set
->name
);
154 assert_compile(SoundsSet::NUM_FILES
== 1);
155 /* No need to loop each file, as long as there is only a single
157 add_pos
+= seprintf(add_pos
, last
, "\t%s is %s (%s)\n", sounds_set
->files
->filename
, SoundsSet::CheckMD5(sounds_set
->files
, BASESET_DIR
) == MD5File::CR_MISMATCH
? "corrupt" : "missing", sounds_set
->files
->missing_warning
);
160 if (add_pos
!= error_msg
) ShowInfoF("%s", error_msg
);
163 /** Actually load the sprite tables. */
164 static void LoadSpriteTables()
166 memset(_palette_remap_grf
, 0, sizeof(_palette_remap_grf
));
167 uint i
= FIRST_GRF_SLOT
;
168 const GraphicsSet
*used_set
= BaseGraphics::GetUsedSet();
170 _palette_remap_grf
[i
] = (PAL_DOS
!= used_set
->palette
);
171 LoadGrfFile(used_set
->files
[GFT_BASE
].filename
, 0, i
++);
174 * The second basic file always starts at the given location and does
175 * contain a different amount of sprites depending on the "type"; DOS
176 * has a few sprites less. However, we do not care about those missing
177 * sprites as they are not shown anyway (logos in intro game).
179 _palette_remap_grf
[i
] = (PAL_DOS
!= used_set
->palette
);
180 LoadGrfFile(used_set
->files
[GFT_LOGOS
].filename
, 4793, i
++);
183 * Load additional sprites for climates other than temperate.
184 * This overwrites some of the temperate sprites, such as foundations
185 * and the ground sprites.
187 if (_settings_game
.game_creation
.landscape
!= LT_TEMPERATE
) {
188 _palette_remap_grf
[i
] = (PAL_DOS
!= used_set
->palette
);
190 used_set
->files
[GFT_ARCTIC
+ _settings_game
.game_creation
.landscape
- 1].filename
,
191 _landscape_spriteindexes
[_settings_game
.game_creation
.landscape
- 1],
196 /* Initialize the unicode to sprite mapping table */
197 InitializeUnicodeGlyphMap();
200 * Load the base and extra NewGRF with OTTD required graphics as first NewGRF.
201 * However, we do not want it to show up in the list of used NewGRFs,
202 * so we have to manually add it, and then remove it later.
204 GRFConfig
*top
= _grfconfig
;
206 /* Default extra graphics */
207 GRFConfig
*master
= new GRFConfig("OPENTTD.GRF");
208 master
->palette
|= GRFP_GRF_DOS
;
209 FillGRFDetails(master
, false, BASESET_DIR
);
210 ClrBit(master
->flags
, GCF_INIT_ONLY
);
212 /* Baseset extra graphics */
213 GRFConfig
*extra
= new GRFConfig(used_set
->files
[GFT_EXTRA
].filename
);
215 /* We know the palette of the base set, so if the base NewGRF is not
216 * setting one, use the palette of the base set and not the global
217 * one which might be the wrong palette for this base NewGRF.
218 * The value set here might be overridden via action14 later. */
219 switch (used_set
->palette
) {
220 case PAL_DOS
: extra
->palette
|= GRFP_GRF_DOS
; break;
221 case PAL_WINDOWS
: extra
->palette
|= GRFP_GRF_WINDOWS
; break;
224 FillGRFDetails(extra
, false, BASESET_DIR
);
225 ClrBit(extra
->flags
, GCF_INIT_ONLY
);
228 master
->next
= extra
;
231 LoadNewGRF(SPR_NEWGRFS_BASE
, i
, 2);
233 uint total_extra_graphics
= SPR_NEWGRFS_BASE
- SPR_OPENTTD_BASE
;
234 _missing_extra_graphics
= GetSpriteCountForSlot(i
, SPR_OPENTTD_BASE
, SPR_NEWGRFS_BASE
);
235 DEBUG(sprite
, 1, "%u extra sprites, %u from baseset, %u from fallback", total_extra_graphics
, total_extra_graphics
- _missing_extra_graphics
, _missing_extra_graphics
);
237 /* The original baseset extra graphics intentionally make use of the fallback graphics.
238 * Let's say everything which provides less than 500 sprites misses the rest intentionally. */
239 if (500 + _missing_extra_graphics
> total_extra_graphics
) _missing_extra_graphics
= 0;
241 /* Free and remove the top element. */
249 * Check blitter needed by NewGRF config and switch if needed.
250 * @return False when nothing changed, true otherwise.
252 static bool SwitchNewGRFBlitter()
254 /* Never switch if the blitter was specified by the user. */
255 if (!_blitter_autodetected
) return false;
257 /* Null driver => dedicated server => do nothing. */
258 if (BlitterFactory::GetCurrentBlitter()->GetScreenDepth() == 0) return false;
260 /* Get preferred depth.
261 * - depth_wanted_by_base: Depth required by the baseset, i.e. the majority of the sprites.
262 * - depth_wanted_by_grf: Depth required by some NewGRF.
263 * Both can force using a 32bpp blitter. depth_wanted_by_base is used to select
264 * between multiple 32bpp blitters, which perform differently with 8bpp sprites.
266 uint depth_wanted_by_base
= BaseGraphics::GetUsedSet()->blitter
== BLT_32BPP
? 32 : 8;
267 uint depth_wanted_by_grf
= _support8bpp
== S8BPP_NONE
? 32 : 8;
268 for (GRFConfig
*c
= _grfconfig
; c
!= NULL
; c
= c
->next
) {
269 if (c
->status
== GCS_DISABLED
|| c
->status
== GCS_NOT_FOUND
|| HasBit(c
->flags
, GCF_INIT_ONLY
)) continue;
270 if (c
->palette
& GRFP_BLT_32BPP
) depth_wanted_by_grf
= 32;
273 /* Search the best blitter. */
274 static const struct {
276 uint animation
; ///< 0: no support, 1: do support, 2: both
277 uint min_base_depth
, max_base_depth
, min_grf_depth
, max_grf_depth
;
278 } replacement_blitters
[] = {
280 { "32bpp-sse4", 0, 32, 32, 8, 32 },
281 { "32bpp-ssse3", 0, 32, 32, 8, 32 },
282 { "32bpp-sse2", 0, 32, 32, 8, 32 },
283 { "32bpp-sse4-anim", 1, 32, 32, 8, 32 },
285 { "8bpp-optimized", 2, 8, 8, 8, 8 },
286 { "32bpp-optimized", 0, 8, 32, 8, 32 },
288 { "32bpp-sse2-anim", 1, 8, 32, 8, 32 },
290 { "32bpp-anim", 1, 8, 32, 8, 32 },
293 const bool animation_wanted
= HasBit(_display_opt
, DO_FULL_ANIMATION
);
294 const char *cur_blitter
= BlitterFactory::GetCurrentBlitter()->GetName();
296 VideoDriver::GetInstance()->AcquireBlitterLock();
298 for (uint i
= 0; i
< lengthof(replacement_blitters
); i
++) {
299 if (animation_wanted
&& (replacement_blitters
[i
].animation
== 0)) continue;
300 if (!animation_wanted
&& (replacement_blitters
[i
].animation
== 1)) continue;
302 if (!IsInsideMM(depth_wanted_by_base
, replacement_blitters
[i
].min_base_depth
, replacement_blitters
[i
].max_base_depth
+ 1)) continue;
303 if (!IsInsideMM(depth_wanted_by_grf
, replacement_blitters
[i
].min_grf_depth
, replacement_blitters
[i
].max_grf_depth
+ 1)) continue;
304 const char *repl_blitter
= replacement_blitters
[i
].name
;
306 if (strcmp(repl_blitter
, cur_blitter
) == 0) {
307 VideoDriver::GetInstance()->ReleaseBlitterLock();
310 if (BlitterFactory::GetBlitterFactory(repl_blitter
) == NULL
) continue;
312 DEBUG(misc
, 1, "Switching blitter from '%s' to '%s'... ", cur_blitter
, repl_blitter
);
313 Blitter
*new_blitter
= BlitterFactory::SelectBlitter(repl_blitter
);
314 if (new_blitter
== NULL
) NOT_REACHED();
315 DEBUG(misc
, 1, "Successfully switched to %s.", repl_blitter
);
319 if (!VideoDriver::GetInstance()->AfterBlitterChange()) {
320 /* Failed to switch blitter, let's hope we can return to the old one. */
321 if (BlitterFactory::SelectBlitter(cur_blitter
) == NULL
|| !VideoDriver::GetInstance()->AfterBlitterChange()) usererror("Failed to reinitialize video driver. Specify a fixed blitter in the config");
324 VideoDriver::GetInstance()->ReleaseBlitterLock();
329 /** Check whether we still use the right blitter, or use another (better) one. */
332 if (!SwitchNewGRFBlitter()) return;
335 GfxClearSpriteCache();
339 /** Initialise and load all the sprites. */
340 void GfxLoadSprites()
342 DEBUG(sprite
, 2, "Loading sprite set %d", _settings_game
.game_creation
.landscape
);
344 SwitchNewGRFBlitter();
353 bool GraphicsSet::FillSetDetails(IniFile
*ini
, const char *path
, const char *full_filename
)
355 bool ret
= this->BaseSet
<GraphicsSet
, MAX_GFT
, true>::FillSetDetails(ini
, path
, full_filename
, false);
357 IniGroup
*metadata
= ini
->GetGroup("metadata");
360 fetch_metadata("palette");
361 this->palette
= (*item
->value
== 'D' || *item
->value
== 'd') ? PAL_DOS
: PAL_WINDOWS
;
363 /* Get optional blitter information. */
364 item
= metadata
->GetItem("blitter", false);
365 this->blitter
= (item
!= NULL
&& *item
->value
== '3') ? BLT_32BPP
: BLT_8BPP
;
371 * Calculate and check the MD5 hash of the supplied GRF.
372 * @param file The file get the hash of.
373 * @param subdir The sub directory to get the files from.
375 * - #CR_MATCH if the MD5 hash matches
376 * - #CR_MISMATCH if the MD5 does not match
377 * - #CR_NO_FILE if the file misses
379 /* static */ MD5File::ChecksumResult
GraphicsSet::CheckMD5(const MD5File
*file
, Subdirectory subdir
)
382 FILE *f
= FioFOpenFile(file
->filename
, "rb", subdir
, &size
);
383 if (f
== NULL
) return MD5File::CR_NO_FILE
;
385 size_t max
= GRFGetSizeOfDataSection(f
);
389 return file
->CheckMD5(subdir
, max
);
394 * Calculate and check the MD5 hash of the supplied filename.
395 * @param subdir The sub directory to get the files from
396 * @param max_size Only calculate the hash for this many bytes from the file start.
398 * - #CR_MATCH if the MD5 hash matches
399 * - #CR_MISMATCH if the MD5 does not match
400 * - #CR_NO_FILE if the file misses
402 MD5File::ChecksumResult
MD5File::CheckMD5(Subdirectory subdir
, size_t max_size
) const
405 FILE *f
= FioFOpenFile(this->filename
, "rb", subdir
, &size
);
407 if (f
== NULL
) return CR_NO_FILE
;
409 size
= min(size
, max_size
);
416 while ((len
= fread(buffer
, 1, (size
> sizeof(buffer
)) ? sizeof(buffer
) : size
, f
)) != 0 && size
!= 0) {
418 checksum
.Append(buffer
, len
);
423 checksum
.Finish(digest
);
424 return memcmp(this->hash
, digest
, sizeof(this->hash
)) == 0 ? CR_MATCH
: CR_MISMATCH
;
427 /** Names corresponding to the GraphicsFileType */
428 static const char * const _graphics_file_names
[] = { "base", "logos", "arctic", "tropical", "toyland", "extra" };
430 /** Implementation */
431 template <class T
, size_t Tnum_files
, bool Tsearch_in_tars
>
432 /* static */ const char * const *BaseSet
<T
, Tnum_files
, Tsearch_in_tars
>::file_names
= _graphics_file_names
;
434 template <class Tbase_set
>
435 /* static */ bool BaseMedia
<Tbase_set
>::DetermineBestSet()
437 if (BaseMedia
<Tbase_set
>::used_set
!= NULL
) return true;
439 const Tbase_set
*best
= NULL
;
440 for (const Tbase_set
*c
= BaseMedia
<Tbase_set
>::available_sets
; c
!= NULL
; c
= c
->next
) {
441 /* Skip unusable sets */
442 if (c
->GetNumMissing() != 0) continue;
445 (best
->fallback
&& !c
->fallback
) ||
446 best
->valid_files
< c
->valid_files
||
447 (best
->valid_files
== c
->valid_files
&& (
448 (best
->shortname
== c
->shortname
&& best
->version
< c
->version
) ||
449 (best
->palette
!= PAL_DOS
&& c
->palette
== PAL_DOS
)))) {
454 BaseMedia
<Tbase_set
>::used_set
= best
;
455 return BaseMedia
<Tbase_set
>::used_set
!= NULL
;
458 template <class Tbase_set
>
459 /* static */ const char *BaseMedia
<Tbase_set
>::GetExtension()
461 return ".obg"; // OpenTTD Base Graphics
464 INSTANTIATE_BASE_MEDIA_METHODS(BaseMedia
<GraphicsSet
>, GraphicsSet
)