# Preload Image

Grammar — Preload file|Image File queue|Immediately/For Next Map
Flags — Native | Action

Preloads an image file. The file must be explicitly identified (it won’t work if you plug in a variable to that parameter). Preloading will force an asset or data entry to be loaded into memory before the map starts, rather than be loaded on demand as the map runs.

# Arguments

• string [ filepath ] — File
• bool [ preset::PreloadQueue ] — Queue

Returns — void

native void PreloadImage(string path, bool queue);

# Related

Category: Game / Preloading

• [F] — void — Preload Asset — ( PreloadAsset )
• [F] — void — Preload Image — ( PreloadImage )
• [F] — void — Preload Layout — ( PreloadLayout )
• [F] — void — Preload Model — ( PreloadModel )
• [F] — void — Preload Model Animation — ( libNtve_gf_PreloadModelAnimation )
• [F] — void — Preload Model Object — ( libNtve_gf_PreloadModelObject )
• [F] — void — Preload Movie — ( PreloadMovie )
• [F] — void — Preload Object — ( PreloadObject )
• [F] — void — Preload Scene — ( PreloadScene )
• [F] — void — Preload Script — ( PreloadScript )
• [F] — void — Preload Sound — ( PreloadSound )
• [F] — void — Preload Sound Object — ( libNtve_gf_PreloadSoundObject )
• [F] — void — Preload Soundtrack — ( libNtve_gf_PreloadSoundtrack )
• [F] — void — Preload Unit — ( libNtve_gf_PreloadUnit )

# Examples

# campaigns/liberty.sc2campaign

— MapScript.galaxy

// L4009
PreloadImage("Assets\\Textures\\loading-agria.dds", false)

// L4010
PreloadImage("Assets\\Textures\\loading-aiur.dds", false)

// L4011
PreloadImage("Assets\\Textures\\loading-tyrador.dds", false)

// L4012
PreloadImage("Assets\\Textures\\loading-avernus.dds", false)

// L4013
PreloadImage("Assets\\Textures\\loading-belshir.dds", false)

// L4014
PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false)

// L4015
PreloadImage("Assets\\Textures\\loading-char.dds", false)

// L4016
PreloadImage("Assets\\Textures\\loading-korhal.dds", false)

// L4017
PreloadImage("Assets\\Textures\\loading-marsara.dds", false)

// L4018
PreloadImage("Assets\\Textures\\loading-xil.dds", false)

// L1120
PreloadImage("Assets\\Textures\\btn-ability-terran-raynorplasmagun.dds", false)

// L4009
PreloadImage("Assets\\Textures\\loading-agria.dds", false)

// L4010
PreloadImage("Assets\\Textures\\loading-aiur.dds", false)

// L4011
PreloadImage("Assets\\Textures\\loading-tyrador.dds", false)

// L4012
PreloadImage("Assets\\Textures\\loading-avernus.dds", false)

// L4013
PreloadImage("Assets\\Textures\\loading-belshir.dds", false)

// L4014
PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false)

// L4015
PreloadImage("Assets\\Textures\\loading-char.dds", false)

// L4016
PreloadImage("Assets\\Textures\\loading-korhal.dds", false)

// L4017
PreloadImage("Assets\\Textures\\loading-marsara.dds", false)

// L4018
PreloadImage("Assets\\Textures\\loading-xil.dds", false)

// L1120
PreloadImage("Assets\\Textures\\btn-ability-terran-raynorplasmagun.dds", false)

// L995
PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false)

// L996
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false)

// L997
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false)

// L998
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false)

// L999
PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false)

// L1000
PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false)

// L1001
PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false)

// L1002
PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false)

// L1003
PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false)

// L1004
PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false)

// L995
PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false)

// L996
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false)

// L997
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false)

// L998
PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false)

// L999
PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false)

// L1000
PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false)

// L1001
PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false)

// L1002
PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false)

// L1003
PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false)

// L1004
PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false)