CommonCtrl.OneTimeAsset

for managing (texture) asset that is mostly used only once during the application, such as game front page, on_load movie, etc.

Description

Sample Code

NPL.load("(gl)script/ide/OneTimeAsset.lua");
CommonCtrl.OneTimeAsset.Add("Logo", "page1.bmp")
...
CommonCtrl.OneTimeAsset.Add("Logo", "page2.bmp")
...
CommonCtrl.OneTimeAsset.Add("Logo", nil)
or one can use CommonCtrl.OneTimeAsset.Unload("page2.bmp;0 0 100 100")

Member Functions

OneTimeAsset.Add

 define a new control in the common control libary
local OneTimeAsset = {
   registry = {}, 
   error = "",
   print_error = commonlib.error,  
}

Only one item is loaded at a time. So if we add multiple asset files to the same item name, the previous ones will be unloaded if they are not identical.

• param ItemName :
• param assetFileName :

syntax

function OneTimeAsset.Add(ItemName, assetFileName)

parameters

OneTimeAsset.GetFileName

this will remove the paramters after the semicolon e.g. GetFileName("aaa.bmp;0 0 11 11") == "aaa.bmp"

syntax

function OneTimeAsset.GetFileName(assetFileName)

parameters

OneTimeAsset.Unload

call this function to unload the given asset

syntax

function OneTimeAsset.Unload(assetFileName)

parameters