# 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

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

# Examples

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4009

    PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false);
    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4010

    PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false);
    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4011

    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4012

    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4013

    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4014

    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4015

    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4016

    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4017

    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);
    gf_Level1Preload();

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/tarcade.sc2map/MapScript.galaxy:4018

    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);
    gf_Level1Preload();
    gf_Level2Preload();

campaigns/liberty.sc2campaign — base.sc2maps/maps/campaign/thorner05s.sc2map/MapScript.galaxy:1120

    }

    PreloadImage("Assets\\Textures\\btn-ability-terran-raynorplasmagun.dds", false);
    libCamp_gf_AddUnitTypeToUnitHelpPanel("Marine", false, gv_p01_USER);
    libCamp_gf_AddUnitTypeToUnitHelpPanel("Firebat", false, gv_p01_USER);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4009

    PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false);
    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4010

    PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false);
    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4011

    PreloadImage("Assets\\Textures\\loading-agria.dds", false);
    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4012

    PreloadImage("Assets\\Textures\\loading-aiur.dds", false);
    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4013

    PreloadImage("Assets\\Textures\\loading-tyrador.dds", false);
    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4014

    PreloadImage("Assets\\Textures\\loading-avernus.dds", false);
    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4015

    PreloadImage("Assets\\Textures\\loading-belshir.dds", false);
    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4016

    PreloadImage("Assets\\Textures\\loading-braxisalpha.dds", false);
    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4017

    PreloadImage("Assets\\Textures\\loading-char.dds", false);
    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);
    gf_Level1Preload();

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/tarcade.sc2map — MapScript.galaxy:4018

    PreloadImage("Assets\\Textures\\loading-korhal.dds", false);
    PreloadImage("Assets\\Textures\\loading-marsara.dds", false);
    PreloadImage("Assets\\Textures\\loading-xil.dds", false);
    gf_Level1Preload();
    gf_Level2Preload();

campaigns/liberty.sc2campaign/base.sc2maps/maps/campaign/thorner05s.sc2map — MapScript.galaxy:1120

    }

    PreloadImage("Assets\\Textures\\btn-ability-terran-raynorplasmagun.dds", false);
    libCamp_gf_AddUnitTypeToUnitHelpPanel("Marine", false, gv_p01_USER);
    libCamp_gf_AddUnitTypeToUnitHelpPanel("Firebat", false, gv_p01_USER);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:995

    PreloadModel("Assets\\Doodads\\THorner05SElectricalArcs\\THorner05SElectricalArcs.m3", false);
    PreloadModel("Assets\\Doodads\\TempleStoneInlay\\TempleStoneInlay.m3", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:996

    PreloadModel("Assets\\Doodads\\TempleStoneInlay\\TempleStoneInlay.m3", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:997

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:998

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:999

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:1000

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:1001

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:1002

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:1003

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5normal.dds", false);

campaigns/void.sc2campaign — base.sc2maps/maps/campaign/void/pshakuras02.sc2map/MapScript.galaxy:1004

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:995

    PreloadModel("Assets\\Doodads\\THorner05SElectricalArcs\\THorner05SElectricalArcs.m3", false);
    PreloadModel("Assets\\Doodads\\TempleStoneInlay\\TempleStoneInlay.m3", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:996

    PreloadModel("Assets\\Doodads\\TempleStoneInlay\\TempleStoneInlay.m3", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:997

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:998

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_specular.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:999

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:1000

    PreloadImage("Assets\\Textures\\shakurasex1_cliff1_diffuse.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:1001

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:1002

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_diffuse_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:1003

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5normal.dds", false);

campaigns/void.sc2campaign/base.sc2maps/maps/campaign/void/pshakuras02.sc2map — MapScript.galaxy:1004

    PreloadImage("Assets\\Textures\\shakurasex1cliff0_normal_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_00.dds", false);
    PreloadImage("Assets\\Textures\\shakurasex1cliff0_specular_01.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5normal.dds", false);
    PreloadImage("Assets\\Textures\\shakurastemple_5.dds", false);