API Docs for:
Show:

LS.ResourcesManager Class

Defined in: ../src/resourcesManager.js:1
Module: LS

Static class that contains all the resources loaded, parsed and ready to use. It also contains the parsers and methods in charge of processing them

Constructor

LS.ResourcesManager

()

Defined in ../src/resourcesManager.js:1

Methods

cancelOnceLoaded

(
  • fullpath
  • index
)

Defined in ../src/resourcesManager.js:1070

Cancels the binding of a onceLoaded

Parameters:

  • fullpath String

    fullpath of the resource you want to cancel the binding

  • index Number

    the index of the callback to cancel (as it was returned by onceLoaded)

cleanFullpath

(
  • fullpath
)
String

Defined in ../src/resourcesManager.js:209

Cleans resource name (removing double slashes to avoid problems) It is slow, so use it only in changes, not in getters

Parameters:

  • fullpath String

Returns:

String:

fullpath cleaned

getBasename

(
  • fullpath
)
String

Defined in ../src/resourcesManager.js:190

Returns the filename without the folder or the extension

Parameters:

  • fullpath String

Returns:

String:

filename extension

getExtension

(
  • fullpath
  • complex_extension
)
String

Defined in ../src/resourcesManager.js:114

Returns the filename extension from an url

Parameters:

  • fullpath String

    url or filename

  • complex_extension Boolean

    [optional] returns the extension from the first dot, otherwise only the part from last dot

Returns:

String:

filename extension

getFilename

(
  • fullpath
)
String

Defined in ../src/resourcesManager.js:157

Returns the filename from a full path

Parameters:

  • fullpath String

Returns:

String:

filename extension

getFolder

(
  • fullpath
)
String

Defined in ../src/resourcesManager.js:175

Returns the folder from a fullpath

Parameters:

  • fullpath String

Returns:

String:

folder name

getFullURL

(
  • url
  • options
)
String

Defined in ../src/resourcesManager.js:295

transform a url to a full url taking into account proxy, virtual file systems and local_repository

Parameters:

  • url String
  • options Object

Returns:

String:

full url

getMesh

(
  • filename
)
Mesh

Defined in ../src/resourcesManager.js:968

returns a mesh resource if it is loaded

Parameters:

  • filename String

Returns:

Mesh:

getNoCache

(
  • force
)
String

Defined in ../src/resourcesManager.js:53

Returns a string to append to any url that should use the browser cache (when updating server info)

Parameters:

  • force Boolean

    force to return a nocache string ignoring the default configuration

Returns:

String:

a string to attach to a url so the file wont be cached

getResource

(
  • url
  • constructor
)

Defined in ../src/resourcesManager.js:365

Returns the resource if it has been loaded, if you want to force to load it, use load

Parameters:

  • url String

    where the resource is located (if its a relative url it depends on the path attribute)

  • constructor Function

    [optional] allows to specify the class expected for this resource, if the resource doesnt match, it returns null

Returns:

:

the resource

getResourcesData

(
  • resource_names
  • allow_files
)
Object

Defined in ../src/resourcesManager.js:405

Returns an object containig all the resources and its data (used to export resources)

Parameters:

  • resource_names Array

    an array containing the resources names

  • allow_files Bool

    [optional] used to allow to retrieve the data in File or Blob, otherwise only String and ArrayBuffer is supported

Returns:

Object:

object with name:data

getResourceType

(
  • resource
)
String

Defined in ../src/resourcesManager.js:387

Returns the resource type ("Mesh","Texture","Material","SceneNode",...) of a given resource

Parameters:

  • resource

Returns:

String:

the type in string format

getTexture

(
  • filename
)
Texture

Defined in ../src/resourcesManager.js:985

returns a texture resource if it is loaded

Parameters:

  • filename String

    could be a texture itself in which case returns the same texture

Returns:

Texture:

getURLasFile

(
  • filename
)
File

Defined in ../src/resourcesManager.js:875

Used to load files and get them as File (or Blob)

Parameters:

  • filename String

Returns:

File:

the file

isLoading

() Boolean

Defined in ../src/resourcesManager.js:951

forces to try to reload again resources not found

Returns:

Boolean:

isLoading

() Boolean

Defined in ../src/resourcesManager.js:936

Tells if it is loading resources (or an specific resource)

Returns:

Boolean:

load

(
  • url
  • [options={}]
  • [on_complete=null]
)

Defined in ../src/resourcesManager.js:519

Loads a generic resource, the type will be infered from the extension, if it is json or wbin it will be processed Do not use to load regular files (txts, csv, etc), instead use the LS.Network methods

Parameters:

  • url String

    where the resource is located (if its a relative url it depends on the path attribute)

  • [options={}] Object optional

    options to apply to the loaded resource when processing it

  • [on_complete=null] Function optional

    callback when the resource is loaded and cached, params: callback( resource, url ) //( url, resource, options )

loadResources

(
  • resources
  • [options={}]
)
Number

Defined in ../src/resourcesManager.js:235

Loads all the resources in the Object (it uses an object to store not only the filename but also the type)

Parameters:

  • resources Object

    contains all the resources, associated with its type

  • [options={}] Object optional

    options to apply to the loaded resources

Returns:

Number:

the actual amount of resources being loaded (this differs fromt he resources passed because some could be already in memory)

onceLoaded

(
  • fullpath
  • callback
)

Defined in ../src/resourcesManager.js:1045

Binds a callback for when a resource is loaded (in case you need to do something special)

Parameters:

  • fullpath String

    of the resource you want to get the notification once is loaded

  • callback Function

    the function to call, it will be called as callback( fullpath, resource )

Returns:

(number) index of the position in the array, use this index to cancel the event

processFinalResource

(
  • url
  • the
  • [options={}]
  • on_complete
)

Defined in ../src/resourcesManager.js:748

Takes a resource instance, and adds some extra properties and register it

Parameters:

  • url String

    where the resource is located (if its a relative url it depends on the path attribute)

  • the

    resource class

  • [options={}] Object optional

    options to apply to the loaded resource

  • on_complete Function

    once the resource is ready

processResource

(
  • url
  • data
  • [options={}]
  • on_complete
)

Defined in ../src/resourcesManager.js:629

Takes some resource data and transforms it to a resource (and Object ready to be used by the engine) and REGISTERs it in the ResourcesManager. In most cases the process involves parsing and uploading to the GPU It is called for every single resource that comes from an external source (URL) right after being loaded

Parameters:

  • url String

    where the resource is located (if its a relative url it depends on the path attribute)

  • data

    the data of the resource (could be string, arraybuffer, image... )

  • [options={}] Object optional

    options to apply to the loaded resource

  • on_complete Function

    once the resource is ready

registerFileSystem

(
  • name
  • url
)

Defined in ../src/resourcesManager.js:351

Allows to associate a resource path like "vfs:myfile.png" to an url according to the value before the ":". This way we can have alias for different folders where the assets are stored. P.e: "e","http://domain.com" -> will transform "e:myfile.png" in "http://domain.com/myfile.png"

Parameters:

  • name String

    the filesystem name (the string before the colons in the path)

  • url String

    the url to attach before

registerResource

(
  • filename
  • resource
)

Defined in ../src/resourcesManager.js:798

Stores the resource inside the manager containers. This way it will be retrieveble by anybody who needs it.

Parameters:

  • filename String

    fullpath

  • resource Object

registerResourcePostProcessor

(
  • resource_type
  • callback
)

Defined in ../src/resourcesManager.js:101

Some resources require to be post-processed right after being parsed to validate, extend, register (meshes need to have the AABB computed...) This job could be done inside the parser but it is better to do it separatedly so it can be reused among different parsers.

Parameters:

  • resource_type String

    the name of the class of the resource

  • callback Function

    the function to call once the data has been processed

registerResourcePreProcessor

(
  • fileformats
  • callback
  • data_type
  • resource_type
)

Defined in ../src/resourcesManager.js:77

Resources need to be parsed once the data has been received, some formats could be parsed using native functions (like images) others require to pass the data through a series of functions (extract raw content, parse it, upload it to the GPU... Registering a resource preprocessor the data will be converted once it is in memory

Parameters:

  • fileformats String

    the extension of the formats that this function will parse

  • callback Function

    the function to call once the data must be processed, if the process is async it must return true

  • data_type String
  • resource_type String

removeExtension

(
  • fullpath
  • complex_extension
)
String

Defined in ../src/resourcesManager.js:136

Returns the url without the extension

Parameters:

  • fullpath String

    url or filename

  • complex_extension Boolean

    [optional] removes the extension from the first dot, otherwise only the part from last dot

Returns:

String:

url without extension

renameResource

(
  • old
  • newname
  • [skip_event=false]
)
Boolean

Defined in ../src/resourcesManager.js:894

Changes the name of a resource and sends an event to all components to change it accordingly

Parameters:

  • old String
  • newname String
  • [skip_event=false] Boolean optional

    ignore sending an event to all components to rename the resource

Returns:

Boolean:

if the file was found

reset

()

Defined in ../src/resourcesManager.js:63

Resets all the resources cached, so it frees the memory

resourceModified

(
  • resource
)

Defined in ../src/resourcesManager.js:455

Marks the resource as modified, used in editor to know when a resource data should be updated

Parameters:

  • resource Object

resourceSaved

(
  • resource
)

Defined in ../src/resourcesManager.js:504

Unmarks the resource as modified

Parameters:

  • resource Object

setPath

(
  • url
)

Defined in ../src/resourcesManager.js:262

Set the base path where all the resources will be fetched (unless they have absolute URL) By default it will use the website home address

Parameters:

  • url String

setProxy

(
  • proxy_url
)

Defined in ../src/resourcesManager.js:274

Set a proxy url where all non-local resources will be requested, allows to fetch assets to other servers. request will be in this form: proxy_url + "/" + url_with_protocol: -> http://myproxy.com/google.com/images/...

Parameters:

  • proxy_url String

unregisterResource

(
  • filename
)
Boolean

Defined in ../src/resourcesManager.js:843

removes the resources from all the containers

Parameters:

  • filename String

Returns:

Boolean:

true is removed, false if not found