2 Copyright (C) 1999-2006 Id Software, Inc. and contributors.
3 For a list of contributors, see the accompanying CONTRIBUTORS file.
5 This file is part of GtkRadiant.
7 GtkRadiant is free software; you can redistribute it and/or modify
8 it under the terms of the GNU General Public License as published by
9 the Free Software Foundation; either version 2 of the License, or
10 (at your option) any later version.
12 GtkRadiant is distributed in the hope that it will be useful,
13 but WITHOUT ANY WARRANTY; without even the implied warranty of
14 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 GNU General Public License for more details.
17 You should have received a copy of the GNU General Public License
18 along with GtkRadiant; if not, write to the Free Software
19 Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
24 #include "debugging/debugging.h"
27 #include "itextures.h"
29 #include "preferencesystem.h"
32 #include "texturelib.h"
33 #include "container/hashfunc.h"
34 #include "container/cache.h"
35 #include "generic/callback.h"
40 #include "preferences.h"
46 eTextures_NEAREST = 0,
47 eTextures_NEAREST_MIPMAP_NEAREST = 1,
48 eTextures_NEAREST_MIPMAP_LINEAR = 2,
50 eTextures_LINEAR_MIPMAP_NEAREST = 4,
51 eTextures_LINEAR_MIPMAP_LINEAR = 5,
52 eTextures_MAX_ANISOTROPY = 6,
55 enum TextureCompressionFormat
57 TEXTURECOMPRESSION_NONE = 0,
58 TEXTURECOMPRESSION_RGBA = 1,
59 TEXTURECOMPRESSION_RGBA_S3TC_DXT1 = 2,
60 TEXTURECOMPRESSION_RGBA_S3TC_DXT3 = 3,
61 TEXTURECOMPRESSION_RGBA_S3TC_DXT5 = 4,
64 struct texture_globals_t
67 // texture compression format
68 TextureCompressionFormat m_nTextureCompressionFormat;
72 bool bTextureCompressionSupported; // is texture compression supported by hardware?
73 GLint texture_components;
75 // temporary values that should be initialised only once at run-time
76 bool m_bOpenGLCompressionSupported;
77 bool m_bS3CompressionSupported;
79 texture_globals_t( GLint components ) :
80 m_nTextureCompressionFormat( TEXTURECOMPRESSION_NONE ),
82 bTextureCompressionSupported( false ),
83 texture_components( components ),
84 m_bOpenGLCompressionSupported( false ),
85 m_bS3CompressionSupported( false ){
89 texture_globals_t g_texture_globals( GL_RGBA );
91 void SetTexParameters( ETexturesMode mode ){
92 float maxAniso = QGL_maxTextureAnisotropy();
94 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAX_ANISOTROPY_EXT, 1.0f );
97 if ( mode == eTextures_MAX_ANISOTROPY ) {
98 mode = eTextures_LINEAR_MIPMAP_LINEAR;
103 case eTextures_NEAREST:
104 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST );
105 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
107 case eTextures_NEAREST_MIPMAP_NEAREST:
108 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST_MIPMAP_NEAREST );
109 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
111 case eTextures_NEAREST_MIPMAP_LINEAR:
112 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_NEAREST_MIPMAP_LINEAR );
113 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_NEAREST );
115 case eTextures_LINEAR:
116 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR );
117 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR );
119 case eTextures_LINEAR_MIPMAP_NEAREST:
120 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_NEAREST );
121 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR );
123 case eTextures_LINEAR_MIPMAP_LINEAR:
124 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MIN_FILTER, GL_LINEAR_MIPMAP_LINEAR );
125 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAG_FILTER, GL_LINEAR );
127 case eTextures_MAX_ANISOTROPY:
128 glTexParameteri( GL_TEXTURE_2D, GL_TEXTURE_MAX_ANISOTROPY_EXT, maxAniso );
131 globalOutputStream() << "invalid texture mode\n";
135 ETexturesMode g_texture_mode = eTextures_LINEAR_MIPMAP_LINEAR;
140 byte g_gammatable[256];
141 void ResampleGamma( float fGamma ){
143 if ( fGamma == 1.0 ) {
144 for ( i = 0; i < 256; i++ )
149 for ( i = 0; i < 256; i++ )
151 inf = (int)( 255 * pow( static_cast<double>( ( i + 0.5 ) / 255.5 ), static_cast<double>( fGamma ) ) + 0.5 );
158 g_gammatable[i] = inf;
163 inline const int& min_int( const int& left, const int& right ){
164 return std::min( left, right );
167 int max_tex_size = 0;
168 const int max_texture_quality = 3;
169 LatchedInt g_Textures_textureQuality( 3, "Texture Quality" );
171 /// \brief This function does the actual processing of raw RGBA data into a GL texture.
172 /// It will also resample to power-of-two dimensions, generate the mipmaps and adjust gamma.
173 void LoadTextureRGBA( qtexture_t* q, unsigned char* pPixels, int nWidth, int nHeight ){
174 static float fGamma = -1;
177 int nCount = nWidth * nHeight;
179 if ( fGamma != g_texture_globals.fGamma ) {
180 fGamma = g_texture_globals.fGamma;
181 ResampleGamma( fGamma );
187 total[0] = total[1] = total[2] = 0.0f;
189 // resample texture gamma according to user settings
190 for ( int i = 0; i < ( nCount * 4 ); i += 4 )
192 for ( int j = 0; j < 3; j++ )
194 total[j] += ( pPixels + i )[j];
195 byte b = ( pPixels + i )[j];
196 ( pPixels + i )[j] = g_gammatable[b];
200 q->color[0] = total[0] / ( nCount * 255 );
201 q->color[1] = total[1] / ( nCount * 255 );
202 q->color[2] = total[2] / ( nCount * 255 );
204 glGenTextures( 1, &q->texture_number );
206 glBindTexture( GL_TEXTURE_2D, q->texture_number );
208 SetTexParameters( g_texture_mode );
211 while ( gl_width < nWidth )
215 while ( gl_height < nHeight )
218 bool resampled = false;
219 if ( !( gl_width == nWidth && gl_height == nHeight ) ) {
221 outpixels = (byte *)malloc( gl_width * gl_height * 4 );
222 R_ResampleTexture( pPixels, nWidth, nHeight, outpixels, gl_width, gl_height, 4 );
229 int quality_reduction = max_texture_quality - g_Textures_textureQuality.m_value;
230 int target_width = min_int( gl_width >> quality_reduction, max_tex_size );
231 int target_height = min_int( gl_height >> quality_reduction, max_tex_size );
233 while ( gl_width > target_width || gl_height > target_height )
235 GL_MipReduce( outpixels, outpixels, gl_width, gl_height, target_width, target_height );
237 if ( gl_width > target_width ) {
240 if ( gl_height > target_height ) {
246 glTexImage2D( GL_TEXTURE_2D, mip++, g_texture_globals.texture_components, gl_width, gl_height, 0, GL_RGBA, GL_UNSIGNED_BYTE, outpixels );
247 while ( gl_width > 1 || gl_height > 1 )
249 GL_MipReduce( outpixels, outpixels, gl_width, gl_height, 1, 1 );
251 if ( gl_width > 1 ) {
254 if ( gl_height > 1 ) {
258 glTexImage2D( GL_TEXTURE_2D, mip++, g_texture_globals.texture_components, gl_width, gl_height, 0, GL_RGBA, GL_UNSIGNED_BYTE, outpixels );
261 glBindTexture( GL_TEXTURE_2D, 0 );
267 typedef std::pair<LoadImageCallback, CopiedString> TextureKey;
269 void qtexture_realise( qtexture_t& texture, const TextureKey& key ){
270 texture.texture_number = 0;
271 if ( !string_empty( key.second.c_str() ) ) {
272 Image* image = key.first.loadImage( key.second.c_str() );
274 LoadTextureRGBA( &texture, image->getRGBAPixels(), image->getWidth(), image->getHeight() );
275 texture.surfaceFlags = image->getSurfaceFlags();
276 texture.contentFlags = image->getContentFlags();
277 texture.value = image->getValue();
279 globalOutputStream() << "Loaded Texture: \"" << key.second.c_str() << "\"\n";
280 GlobalOpenGL_debugAssertNoErrors();
284 globalErrorStream() << "Texture load failed: \"" << key.second.c_str() << "\"\n";
289 void qtexture_unrealise( qtexture_t& texture ){
290 if ( GlobalOpenGL().contextValid && texture.texture_number != 0 ) {
291 glDeleteTextures( 1, &texture.texture_number );
292 GlobalOpenGL_debugAssertNoErrors();
296 class TextureKeyEqualNoCase
299 bool operator()( const TextureKey& key, const TextureKey& other ) const {
300 return key.first == other.first && string_equal_nocase( key.second.c_str(), other.second.c_str() );
304 class TextureKeyHashNoCase
307 typedef hash_t hash_type;
308 hash_t operator()( const TextureKey& key ) const {
309 return hash_combine( string_hash_nocase( key.second.c_str() ), pod_hash( key.first ) );
313 class TexturesMap : public TexturesCache
315 class TextureConstructor
317 TexturesMap* m_cache;
319 explicit TextureConstructor( TexturesMap* cache )
322 qtexture_t* construct( const TextureKey& key ){
323 qtexture_t* texture = new qtexture_t( key.first, key.second.c_str() );
324 if ( m_cache->realised() ) {
325 qtexture_realise( *texture, key );
329 void destroy( qtexture_t* texture ){
330 if ( m_cache->realised() ) {
331 qtexture_unrealise( *texture );
337 typedef HashedCache<TextureKey, qtexture_t, TextureKeyHashNoCase, TextureKeyEqualNoCase, TextureConstructor> qtextures_t;
338 qtextures_t m_qtextures;
339 TexturesCacheObserver* m_observer;
340 std::size_t m_unrealised;
343 TexturesMap() : m_qtextures( TextureConstructor( this ) ), m_observer( 0 ), m_unrealised( 1 ){
345 typedef qtextures_t::iterator iterator;
348 return m_qtextures.begin();
351 return m_qtextures.end();
354 LoadImageCallback defaultLoader() const {
355 return LoadImageCallback( 0, QERApp_LoadImage );
357 Image* loadImage( const char* name ){
358 return defaultLoader().loadImage( name );
360 qtexture_t* capture( const char* name ){
361 return capture( defaultLoader(), name );
363 qtexture_t* capture( const LoadImageCallback& loader, const char* name ){
364 return m_qtextures.capture( TextureKey( loader, name ) ).get();
366 void release( qtexture_t* texture ){
367 m_qtextures.release( TextureKey( texture->load, texture->name ) );
369 void attach( TexturesCacheObserver& observer ){
370 ASSERT_MESSAGE( m_observer == 0, "TexturesMap::attach: cannot attach observer" );
371 m_observer = &observer;
373 void detach( TexturesCacheObserver& observer ){
374 ASSERT_MESSAGE( m_observer == &observer, "TexturesMap::detach: cannot detach observer" );
378 if ( --m_unrealised == 0 ) {
379 g_texture_globals.bTextureCompressionSupported = false;
381 if ( GlobalOpenGL().ARB_texture_compression() ) {
382 g_texture_globals.bTextureCompressionSupported = true;
383 g_texture_globals.m_bOpenGLCompressionSupported = true;
386 if ( GlobalOpenGL().EXT_texture_compression_s3tc() ) {
387 g_texture_globals.bTextureCompressionSupported = true;
388 g_texture_globals.m_bS3CompressionSupported = true;
391 switch ( g_texture_globals.texture_components )
395 case GL_COMPRESSED_RGBA_ARB:
396 if ( !g_texture_globals.m_bOpenGLCompressionSupported ) {
397 globalOutputStream() << "OpenGL extension GL_ARB_texture_compression not supported by current graphics drivers\n";
398 g_texture_globals.m_nTextureCompressionFormat = TEXTURECOMPRESSION_NONE;
399 g_texture_globals.texture_components = GL_RGBA;
402 case GL_COMPRESSED_RGBA_S3TC_DXT1_EXT:
403 case GL_COMPRESSED_RGBA_S3TC_DXT3_EXT:
404 case GL_COMPRESSED_RGBA_S3TC_DXT5_EXT:
405 if ( !g_texture_globals.m_bS3CompressionSupported ) {
406 globalOutputStream() << "OpenGL extension GL_EXT_texture_compression_s3tc not supported by current graphics drivers\n";
407 if ( g_texture_globals.m_bOpenGLCompressionSupported ) {
408 g_texture_globals.m_nTextureCompressionFormat = TEXTURECOMPRESSION_RGBA;
409 g_texture_globals.texture_components = GL_COMPRESSED_RGBA_ARB;
413 g_texture_globals.m_nTextureCompressionFormat = TEXTURECOMPRESSION_NONE;
414 g_texture_globals.texture_components = GL_RGBA;
419 globalOutputStream() << "Unknown texture compression selected, reverting\n";
420 g_texture_globals.m_nTextureCompressionFormat = TEXTURECOMPRESSION_NONE;
421 g_texture_globals.texture_components = GL_RGBA;
426 glGetIntegerv( GL_MAX_TEXTURE_SIZE, &max_tex_size );
427 if ( max_tex_size == 0 ) {
431 for ( qtextures_t::iterator i = m_qtextures.begin(); i != m_qtextures.end(); ++i )
433 if ( !( *i ).value.empty() ) {
434 qtexture_realise( *( *i ).value, ( *i ).key );
437 if ( m_observer != 0 ) {
438 m_observer->realise();
443 if ( ++m_unrealised == 1 ) {
444 if ( m_observer != 0 ) {
445 m_observer->unrealise();
447 for ( qtextures_t::iterator i = m_qtextures.begin(); i != m_qtextures.end(); ++i )
449 if ( !( *i ).value.empty() ) {
450 qtexture_unrealise( *( *i ).value );
456 return m_unrealised == 0;
460 TexturesMap* g_texturesmap;
462 TexturesCache& GetTexturesCache(){
463 return *g_texturesmap;
467 void Textures_Realise(){
468 g_texturesmap->realise();
471 void Textures_Unrealise(){
472 g_texturesmap->unrealise();
476 Callback g_texturesModeChangedNotify;
478 void Textures_setModeChangedNotify( const Callback& notify ){
479 g_texturesModeChangedNotify = notify;
482 void Textures_ModeChanged(){
483 if ( g_texturesmap->realised() ) {
484 SetTexParameters( g_texture_mode );
486 for ( TexturesMap::iterator i = g_texturesmap->begin(); i != g_texturesmap->end(); ++i )
488 glBindTexture( GL_TEXTURE_2D, ( *i ).value->texture_number );
489 SetTexParameters( g_texture_mode );
492 glBindTexture( GL_TEXTURE_2D, 0 );
494 g_texturesModeChangedNotify();
497 void Textures_SetMode( ETexturesMode mode ){
498 if ( g_texture_mode != mode ) {
499 g_texture_mode = mode;
501 Textures_ModeChanged();
505 void Textures_setTextureComponents( GLint texture_components ){
506 if ( g_texture_globals.texture_components != texture_components ) {
507 Textures_Unrealise();
508 g_texture_globals.texture_components = texture_components;
513 void Textures_UpdateTextureCompressionFormat(){
514 GLint texture_components = GL_RGBA;
516 switch ( g_texture_globals.m_nTextureCompressionFormat )
518 case ( TEXTURECOMPRESSION_NONE ):
520 texture_components = GL_RGBA;
523 case ( TEXTURECOMPRESSION_RGBA ):
525 texture_components = GL_COMPRESSED_RGBA_ARB;
528 case ( TEXTURECOMPRESSION_RGBA_S3TC_DXT1 ):
530 texture_components = GL_COMPRESSED_RGBA_S3TC_DXT1_EXT;
533 case ( TEXTURECOMPRESSION_RGBA_S3TC_DXT3 ):
535 texture_components = GL_COMPRESSED_RGBA_S3TC_DXT3_EXT;
538 case ( TEXTURECOMPRESSION_RGBA_S3TC_DXT5 ):
540 texture_components = GL_COMPRESSED_RGBA_S3TC_DXT5_EXT;
545 Textures_setTextureComponents( texture_components );
548 void TextureCompressionImport( TextureCompressionFormat& self, int value ){
549 if ( !g_texture_globals.m_bOpenGLCompressionSupported
550 && g_texture_globals.m_bS3CompressionSupported
557 self = TEXTURECOMPRESSION_NONE;
560 self = TEXTURECOMPRESSION_RGBA;
563 self = TEXTURECOMPRESSION_RGBA_S3TC_DXT1;
566 self = TEXTURECOMPRESSION_RGBA_S3TC_DXT3;
569 self = TEXTURECOMPRESSION_RGBA_S3TC_DXT5;
572 Textures_UpdateTextureCompressionFormat();
574 typedef ReferenceCaller1<TextureCompressionFormat, int, TextureCompressionImport> TextureCompressionImportCaller;
576 void TextureGammaImport( float& self, float value ){
577 if ( self != value ) {
578 Textures_Unrealise();
583 typedef ReferenceCaller1<float, float, TextureGammaImport> TextureGammaImportCaller;
585 void TextureModeImport( ETexturesMode& self, int value ){
589 Textures_SetMode( eTextures_NEAREST );
592 Textures_SetMode( eTextures_NEAREST_MIPMAP_NEAREST );
595 Textures_SetMode( eTextures_LINEAR );
598 Textures_SetMode( eTextures_NEAREST_MIPMAP_LINEAR );
601 Textures_SetMode( eTextures_LINEAR_MIPMAP_NEAREST );
604 Textures_SetMode( eTextures_LINEAR_MIPMAP_LINEAR );
607 Textures_SetMode( eTextures_MAX_ANISOTROPY );
610 typedef ReferenceCaller1<ETexturesMode, int, TextureModeImport> TextureModeImportCaller;
612 void TextureModeExport( ETexturesMode& self, const IntImportCallback& importer ){
615 case eTextures_NEAREST:
618 case eTextures_NEAREST_MIPMAP_NEAREST:
621 case eTextures_LINEAR:
624 case eTextures_NEAREST_MIPMAP_LINEAR:
627 case eTextures_LINEAR_MIPMAP_NEAREST:
630 case eTextures_LINEAR_MIPMAP_LINEAR:
633 case eTextures_MAX_ANISOTROPY:
640 typedef ReferenceCaller1<ETexturesMode, const IntImportCallback&, TextureModeExport> TextureModeExportCaller;
642 void Textures_constructPreferences( PreferencesPage& page ){
644 const char* percentages[] = { "12.5%", "25%", "50%", "100%", };
647 STRING_ARRAY_RANGE( percentages ),
648 LatchedIntImportCaller( g_Textures_textureQuality ),
649 IntExportCaller( g_Textures_textureQuality.m_latched )
657 FloatImportCallback( TextureGammaImportCaller( g_texture_globals.fGamma ) ),
658 FloatExportCallback( FloatExportCaller( g_texture_globals.fGamma ) )
661 const char* texture_mode[] = { "Nearest", "Nearest Mipmap", "Linear", "Bilinear", "Bilinear Mipmap", "Trilinear", "Anisotropy" };
663 "Texture Render Mode",
664 STRING_ARRAY_RANGE( texture_mode ),
665 IntImportCallback( TextureModeImportCaller( g_texture_mode ) ),
666 IntExportCallback( TextureModeExportCaller( g_texture_mode ) )
670 const char* compression_none[] = { "None" };
671 const char* compression_opengl[] = { "None", "OpenGL ARB" };
672 const char* compression_s3tc[] = { "None", "S3TC DXT1", "S3TC DXT3", "S3TC DXT5" };
673 const char* compression_opengl_s3tc[] = { "None", "OpenGL ARB", "S3TC DXT1", "S3TC DXT3", "S3TC DXT5" };
674 StringArrayRange compression(
675 ( g_texture_globals.m_bOpenGLCompressionSupported )
676 ? ( g_texture_globals.m_bS3CompressionSupported )
677 ? STRING_ARRAY_RANGE( compression_opengl_s3tc )
678 : STRING_ARRAY_RANGE( compression_opengl )
679 : ( g_texture_globals.m_bS3CompressionSupported )
680 ? STRING_ARRAY_RANGE( compression_s3tc )
681 : STRING_ARRAY_RANGE( compression_none )
684 "Hardware Texture Compression",
686 TextureCompressionImportCaller( g_texture_globals.m_nTextureCompressionFormat ),
687 IntExportCaller( reinterpret_cast<int&>( g_texture_globals.m_nTextureCompressionFormat ) )
691 void Textures_constructPage( PreferenceGroup& group ){
692 PreferencesPage page( group.createPage( "Textures", "Texture Settings" ) );
693 Textures_constructPreferences( page );
695 void Textures_registerPreferencesPage(){
696 PreferencesDialog_addDisplayPage( FreeCaller1<PreferenceGroup&, Textures_constructPage>() );
699 void TextureCompression_importString( const char* string ){
700 g_texture_globals.m_nTextureCompressionFormat = static_cast<TextureCompressionFormat>( atoi( string ) );
701 Textures_UpdateTextureCompressionFormat();
703 typedef FreeCaller1<const char*, TextureCompression_importString> TextureCompressionImportStringCaller;
706 void Textures_Construct(){
707 g_texturesmap = new TexturesMap;
709 GlobalPreferenceSystem().registerPreference( "TextureCompressionFormat", TextureCompressionImportStringCaller(), IntExportStringCaller( reinterpret_cast<int&>( g_texture_globals.m_nTextureCompressionFormat ) ) );
710 GlobalPreferenceSystem().registerPreference( "TextureFiltering", IntImportStringCaller( reinterpret_cast<int&>( g_texture_mode ) ), IntExportStringCaller( reinterpret_cast<int&>( g_texture_mode ) ) );
711 GlobalPreferenceSystem().registerPreference( "TextureQuality", IntImportStringCaller( g_Textures_textureQuality.m_latched ), IntExportStringCaller( g_Textures_textureQuality.m_latched ) );
712 GlobalPreferenceSystem().registerPreference( "SI_Gamma", FloatImportStringCaller( g_texture_globals.fGamma ), FloatExportStringCaller( g_texture_globals.fGamma ) );
714 g_Textures_textureQuality.useLatched();
716 Textures_registerPreferencesPage();
718 Textures_ModeChanged();
720 void Textures_Destroy(){
721 delete g_texturesmap;
725 #include "modulesystem/modulesmap.h"
726 #include "modulesystem/singletonmodule.h"
727 #include "modulesystem/moduleregistry.h"
729 class TexturesDependencies :
730 public GlobalRadiantModuleRef,
731 public GlobalOpenGLModuleRef,
732 public GlobalPreferenceSystemModuleRef
734 ImageModulesRef m_image_modules;
736 TexturesDependencies() :
737 m_image_modules( GlobalRadiant().getRequiredGameDescriptionKeyValue( "texturetypes" ) ){
739 ImageModules& getImageModules(){
740 return m_image_modules.get();
746 TexturesCache* m_textures;
748 typedef TexturesCache Type;
749 STRING_CONSTANT( Name, "*" );
752 Textures_Construct();
754 m_textures = &GetTexturesCache();
759 TexturesCache* getTable(){
764 typedef SingletonModule<TexturesAPI, TexturesDependencies> TexturesModule;
765 typedef Static<TexturesModule> StaticTexturesModule;
766 StaticRegisterModule staticRegisterTextures( StaticTexturesModule::instance() );
768 ImageModules& Textures_getImageModules(){
769 return StaticTexturesModule::instance().getDependencies().getImageModules();