# Preload Object

Grammar — Preload id|Object in catalog|Catalog queue|Immediately/For Next Map
Flags — Native | Action

Preloads a data entry and its associated assets. The object 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

• int [ preset::CatalogType ] — Catalog
• string — Identifier
• bool [ preset::PreloadQueue ] — Queue

Returns — void

native void PreloadObject(
	int catalog,
	string id,
	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

// L4008
PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false)

// L7334
PreloadObject(c_gameCatalogUnit, (UnitGetType(lp_unit)), false)

// L10092
PreloadObject(c_gameCatalogModel, (libCamp_gf_MercPortraitModel(lv_indexMerc)), false)

// L10331
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_gf_MissionContact(lv_missionID))), false)

// L10332
PreloadObject(c_gameCatalogModel, (libCamp_gf_PlanetIconModel(lv_indexPlanet)), false)

// L10333
PreloadObject(c_gameCatalogModel, (libCamp_gf_PlanetModel(lv_indexPlanet)), false)

// L28709
PreloadObject(c_gameCatalogModel, ("AdjutantPortrait"), false)

// L29025
PreloadObject(c_gameCatalogModel, ("AdjutantPortrait"), false)

// L29158
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactHanson)), false)

// L29569
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactSwann)), false)

// L29730
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactSwann)), false)

// L4008
PreloadObject(c_gameCatalogUnit, ("SS_Fighter"), false)

// L7334
PreloadObject(c_gameCatalogUnit, (UnitGetType(lp_unit)), false)

// L10092
PreloadObject(c_gameCatalogModel, (libCamp_gf_MercPortraitModel(lv_indexMerc)), false)

// L10331
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_gf_MissionContact(lv_missionID))), false)

// L10332
PreloadObject(c_gameCatalogModel, (libCamp_gf_PlanetIconModel(lv_indexPlanet)), false)

// L10333
PreloadObject(c_gameCatalogModel, (libCamp_gf_PlanetModel(lv_indexPlanet)), false)

// L28709
PreloadObject(c_gameCatalogModel, ("AdjutantPortrait"), false)

// L29025
PreloadObject(c_gameCatalogModel, ("AdjutantPortrait"), false)

// L29158
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactHanson)), false)

// L29569
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactSwann)), false)

// L29730
PreloadObject(c_gameCatalogModel, (libCamp_gf_ContactPortraitModel(libCamp_ge_ContactID_ContactSwann)), false)

# mods/core.sc2mod

— NativeLib.galaxy

// L3439
PreloadObject(c_gameCatalogModel, (lp_id), lp_queue)

// L3445
PreloadObject(c_gameCatalogSound, (lp_id), lp_queue)

// L3451
PreloadObject(c_gameCatalogSoundtrack, (lp_soundtrack), lp_queue)

// L3457
PreloadObject(c_gameCatalogUnit, (lp_unit), lp_queue)

// L2935
PreloadObject(c_gameCatalogModel, (lp_id), lp_queue)

// L2941
PreloadObject(c_gameCatalogSound, (lp_id), lp_queue)

// L2947
PreloadObject(c_gameCatalogSoundtrack, (lp_soundtrack), lp_queue)

// L2953
PreloadObject(c_gameCatalogUnit, (lp_unit), lp_queue)

# mods/heroes.stormmod

— MapScript.galaxy

// L416
PreloadObject(c_gameCatalogHero, (gv_pLAYER_AI_AllyHero), false)

// L417
PreloadObject(c_gameCatalogSkin, CatalogFieldValueGet(c_gameCatalogHero, gv_pLAYER_AI_AllyHero, "SkinArray[" + IntToString(0) + "]", c_playerAny), false)

// L459
PreloadObject(c_gameCatalogHero, (gv_pLAYER_AI_EnemyHero), false)

// L460
PreloadObject(c_gameCatalogSkin, CatalogFieldValueGet(c_gameCatalogHero, gv_pLAYER_AI_EnemyHero, "SkinArray[" + IntToString(0) + "]", c_playerAny), false)

// L416
PreloadObject(c_gameCatalogHero, (gv_pLAYER_AI_AllyHero), false)

// L417
PreloadObject(c_gameCatalogSkin, CatalogFieldValueGet(c_gameCatalogHero, gv_pLAYER_AI_AllyHero, "SkinArray[" + IntToString(0) + "]", c_playerAny), false)

// L459
PreloadObject(c_gameCatalogHero, (gv_pLAYER_AI_EnemyHero), false)

// L460
PreloadObject(c_gameCatalogSkin, CatalogFieldValueGet(c_gameCatalogHero, gv_pLAYER_AI_EnemyHero, "SkinArray[" + IntToString(0) + "]", c_playerAny), false)

# mods/heroesbrawlmods/brawlmapmods/coop/pvebrawlmod.stormmod

— LibPVEB.galaxy

// L603
PreloadObject(c_gameCatalogHero, (libPVEB_gv_pBNPCHeroes[lv_index].lv_hero), false)

// L613
PreloadObject(c_gameCatalogSkin, (libPVEB_gv_pBNPCHeroes[lv_index].lv_skin), false)

# mods/heroesbrawlmods/brawlmapmods/coop/pvemod.stormmod

— LibPVEM.galaxy

// L810
PreloadObject(c_gameCatalogHero, (libPVEM_gv_pvENPCHeroes[lv_index].lv_hero), false)

// L820
PreloadObject(c_gameCatalogSkin, (libPVEM_gv_pvENPCHeroes[lv_index].lv_skin), false)