[name]

Class for loading a [page:CubeTexture CubeTexture]. This uses the [page:ImageLoader] internally for loading files.

Example

[example:webgl_materials_cubemap materials / cubemap]
[example:webgl_materials_cubemap_balls_reflection materials / cubemap / balls / reflection]
[example:webgl_materials_cubemap_balls_refraction materials / cubemap / balls / refraction]
[example:webgl_materials_cubemap_dynamic materials / cubemap / dynamic]
[example:webgl_materials_cubemap_refraction materials / cubemap / refraction]

var scene = new v3d.Scene(); scene.background = new v3d.CubeTextureLoader() .setPath('textures/cubeMaps/') .load([ 'px.png', 'nx.png', 'py.png', 'ny.png', 'pz.png', 'nz.png' ]);

Constructor

[name]([param:LoadingManager manager])

[page:LoadingManager manager] — The [page:LoadingManager loadingManager] for the loader to use. Default is [page:LoadingManager v3d.DefaultLoadingManager].

Creates a new [name].

Properties

[property:String crossOrigin]

If set, assigns the [link:https://developer.mozilla.org/en-US/docs/Web/HTML/CORS_settings_attributes crossOrigin] attribute of the image to the value of *crossOrigin*, prior to starting the load. Default is *"anonymous"*.

[property:LoadingManager manager]

The [page:LoadingManager loadingManager] the loader is using. Default is [page:DefaultLoadingManager].

[property:String path]

The base path from which files will be loaded. See [page:.setPath]. Default is *undefined*.

Methods

[method:CubeTexture load]([param:String urls], [param:Function onLoad], [param:Function onProgress], [param:Function onError])

[page:String urls] — array of 6 urls to images, one for each side of the CubeTexture. The urls should be specified in the following order: pos-x, neg-x, pos-y, neg-y, pos-z, neg-z. They can also be [link:https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/Data_URIs Data URIs].
Note that, by convention, cube maps are specified in a coordinate system in which positive-x is to the right when looking up the positive-z axis -- in other words, using a left-handed coordinate system. Since Verge3D uses a right-handed coordinate system, environment maps used in Verge3D will have pos-x and neg-x swapped.
[page:Function onLoad] — Will be called when load completes. The argument will be the loaded [page:Texture texture].
[page:Function onProgress] — Will be called while load progresses. The argument will be the XMLHttpRequest instance, which contains .[page:Integer total] and .[page:Integer loaded] bytes.
[page:Function onError] — Will be called when load errors.

Begin loading from url and pass the loaded [page:CubeTexture texture] to onLoad.

[method:null setCrossOrigin]([param:String value])

Set the [page:.crossOrigin] attribute.

[method:FileLoader setPath]([param:String path])

Set the base path or URL from which to load files. This can be useful if you are loading many textures from the same directory.

[sourceHint]