Class Assets

The Assets Editor API

Hierarchy

Events
- Assets

Internal

add

add(asset: Asset): void
Adds asset to the list
Parameters
- asset: Asset
  The asset
Returns void
- Defined in submodules/editor-api/src/assets.js:220

clear

clear(): void
Removes all assets from the list

Returns void
- Defined in submodules/editor-api/src/assets.js:293

loadAll

loadAll(options?: { view: string }): Promise<void>
Loads all assets in the current project / branch. Does not subscribe to realtime changes.
Parameters
- options: { view: string } = {}
  Options
  - view: string
    The desired view for the REST API e.g 'designer', 'shader-editor'. This might limit the assets returned to a smaller subset depending on the view.
Returns Promise<void>
- Defined in submodules/editor-api/src/assets.js:339

loadAllAndSubscribe

loadAllAndSubscribe(options?: { view: string }): Promise<void>
Loads all assets in the current project / branch and subscribes to changes.
Parameters
- options: { view: string } = {}
  Options
  - view: string
    The desired view for the REST API e.g 'designer', 'shader-editor'. This might limit the assets returned to a smaller subset depending on the view.
Returns Promise<void>
- Defined in submodules/editor-api/src/assets.js:392

remove

remove(asset: Asset): void
Removes asset from the list
Parameters
- asset: Asset
  The asset
Returns void
- Defined in submodules/editor-api/src/assets.js:272

Other

constructor

new Assets(options?: { autoSubscribe: boolean }): Assets
Constructor
Parameters
- options: { autoSubscribe: boolean } = {}
  Options
  - autoSubscribe: boolean
    Whether to auto subscribe to asset changes when assets are loaded.
Returns Assets
Overrides Events.constructor
- Defined in submodules/editor-api/src/assets.js:62

defaultUploadCompletedCallback

get defaultUploadCompletedCallback(): Function
Gets the default callback called when on asset upload succeeds.

Returns Function
- Defined in submodules/editor-api/src/assets.js:960
set defaultUploadCompletedCallback(value: Function): void
Sets the default callback called when on asset upload succeeds. The function takes 2 arguments: the upload id, and the new asset.
Parameters
- value: Function
Returns void
- Defined in submodules/editor-api/src/assets.js:951

defaultUploadErrorCallback

get defaultUploadErrorCallback(): Function
Gets the default callback called when on asset upload fails.

Returns Function
- Defined in submodules/editor-api/src/assets.js:998
set defaultUploadErrorCallback(value: Function): void
Sets the default callback called when on asset upload progress. The function takes 2 arguments: the upload id, and the error.
Parameters
- value: Function
Returns void
- Defined in submodules/editor-api/src/assets.js:989

defaultUploadProgressCallback

get defaultUploadProgressCallback(): Function
Gets the default callback called when on asset upload progress.

Returns Function
- Defined in submodules/editor-api/src/assets.js:979
set defaultUploadProgressCallback(value: Function): void
Sets the default callback called when on asset upload progress. The function takes 2 arguments: the upload id and the progress.
Parameters
- value: Function
Returns void
- Defined in submodules/editor-api/src/assets.js:970

parseScriptCallback

get parseScriptCallback(): Function
Gets the callback which parses script assets.

Returns Function
- Defined in submodules/editor-api/src/assets.js:1019
set parseScriptCallback(value: Function): void
Sets the callback which parses script assets. When this callback is set, new script assets will be parsed after they are created. The function takes the asset as a parameter and returns a promise with a list of script names when it is done parsing.
Parameters
- value: Function
Returns void
- Defined in submodules/editor-api/src/assets.js:1010

createAnimStateGraph

createAnimStateGraph(
    options?: {
        data: object;
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
    },
): Promise<Asset>
Creates new anim state graph asset.
Parameters
- options: {
      data: object;
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
  } = {}
  Options
  - data: object
    The asset data. See Asset for Animstategraph data.
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:514

createBundle

createBundle(
    options?: {
        assets: Asset[];
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
    },
): Promise<Asset>
Creates new bundle asset
Parameters
- options: {
      assets: Asset[];
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
  } = {}
  Options
  - assets: Asset[]
    The assets that the bundle will contain
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:535

createCss

createCss(
    options?: {
        folder: string;
        name: string;
        onProgress: Function;
        preload: boolean;
        text: string;
    },
): Promise<Asset>
Creates new CSS asset
Parameters
- options: {
      folder: string;
      name: string;
      onProgress: Function;
      preload: boolean;
      text: string;
  } = {}
  Options
  - folder: string
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - text: string
    The CSS
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:558

createCubemap

createCubemap(
    options?: {
        anisotropy: number;
        folder: Asset;
        magFilter: number;
        minFilter: number;
        name: string;
        onProgress: Function;
        preload: boolean;
        textures: Asset[];
    },
): Promise<Asset>
Creates new cubemap asset
Parameters
- options: {
      anisotropy: number;
      folder: Asset;
      magFilter: number;
      minFilter: number;
      name: string;
      onProgress: Function;
      preload: boolean;
      textures: Asset[];
  } = {}
  Options
  - anisotropy: number
    Cubemap anisotropy value. Defaults to 1.
  - folder: Asset
    The parent folder asset
  - magFilter: number
    Cubemap magFilter value. Defaults to pc.FILTER_LINEAR.
  - minFilter: number
    Cubemap minFilter value. Defaults to pc.FILTER_LINEAR_MIPMAP_LINEAR.
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - textures: Asset[]
    The textures for each cubemap face in this order: right, left, up, down, front, back
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:584

createFolder

createFolder(
options?: { folder: Asset; name: string; onProgress: Function },
): Promise<Asset>
Creates a new folder asset
Parameters
- options: { folder: Asset; name: string; onProgress: Function } = {}
  Options
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:614

createHtml

createHtml(
    options?: {
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
        text: string;
    },
): Promise<Asset>
Creates new HTML asset
Parameters
- options: {
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
      text: string;
  } = {}
  Options
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - text: string
    The HTML
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:633

createI18n

createI18n(
    options?: {
        folder: Asset;
        localizationData: object;
        name: string;
        onProgress: Function;
        preload: boolean;
    },
): Promise<Asset>
Creates new localization JSON asset
Parameters
- options: {
      folder: Asset;
      localizationData: object;
      name: string;
      onProgress: Function;
      preload: boolean;
  } = {}
  The options
  - folder: Asset
    The parent folder asset
  - localizationData: object
    The localization data. If null then default data will be used.
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:682

createJson

createJson(
    options?: {
        folder: Asset;
        json: object;
        name: string;
        onProgress: Function;
        preload: boolean;
        spaces: number;
    },
): Promise<Asset>
Creates new JSON asset
Parameters
- options: {
      folder: Asset;
      json: object;
      name: string;
      onProgress: Function;
      preload: boolean;
      spaces: number;
  } = {}
  Options
  - folder: Asset
    The parent folder asset
  - json: object
    The JSON
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - spaces: number
    The number of spaces used for indentation. Defaults to 0 (tightly packed output).
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:657

createMaterial

createMaterial(
    options?: {
        data: object;
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
    },
): Promise<Asset>
Creates new material asset
Parameters
- options: {
      data: object;
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
  } = {}
  Options
  - data: object
    The material data. Default values will be used for missing fields. See Asset for material data.
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:716

createScript

createScript(
    options?: {
        data: object;
        filename: string;
        folder: Asset;
        onProgress: Function;
        preload: boolean;
        text: string;
    },
): Promise<Asset>
Creates new script asset
Parameters
- options: {
      data: object;
      filename: string;
      folder: Asset;
      onProgress: Function;
      preload: boolean;
      text: string;
  } = {}
  Options
  - data: object
    The script data. See Asset for Script data.
  - filename: string
    The filename of the script. This will also be the name of the script asset. If not defined it will be generated from the name of the script.
  - folder: Asset
    The parent folder asset
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - text: string
    The contents of the script. If none then boilerplate code will be used.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:748

createShader

createShader(
    options?: {
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
        text: string;
    },
): Promise<Asset>
Creates new shader asset
Parameters
- options: {
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
      text: string;
  } = {}
  Options
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - text: string
    The GLSL
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:808

createSprite

createSprite(
    options?: {
        folder: Asset;
        frameKeys: number[];
        name: string;
        onProgress: Function;
        pixelsPerUnit: number;
        preload: boolean;
        renderMode: number;
        textureAtlas: Asset;
    },
): Promise<Asset>
Creates new sprite asset
Parameters
- options: {
      folder: Asset;
      frameKeys: number[];
      name: string;
      onProgress: Function;
      pixelsPerUnit: number;
      preload: boolean;
      renderMode: number;
      textureAtlas: Asset;
  } = {}
  Options
  - folder: Asset
    The parent folder asset
  - frameKeys: number[]
    The sprite's frame keys
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - pixelsPerUnit: number
    The sprite's pixels per unit value. Defaults to 100.
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - renderMode: number
    The sprite's render mode. Defaults to pc.SPRITE_RENDERMODE_SIMPLE.
  - textureAtlas: Asset
    The sprite's texture atlas asset
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:833

createTemplate

createTemplate(
    options?: {
        entity: Entity;
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
    },
): Promise<Asset>
Creates new template asset
Parameters
- options: {
      entity: Entity;
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
  } = {}
  Options
  - entity: Entity
    The entity to create the template from
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:883

createText

createText(
    options?: {
        folder: Asset;
        name: string;
        onProgress: Function;
        preload: boolean;
        text: string;
    },
): Promise<Asset>
Creates new text asset
Parameters
- options: {
      folder: Asset;
      name: string;
      onProgress: Function;
      preload: boolean;
      text: string;
  } = {}
  Options
  - folder: Asset
    The parent folder asset
  - name: string
    The asset name
  - onProgress: Function
    Function to report progress
  - preload: boolean
    Whether to preload the asset. Defaults to true.
  - text: string
    The text
Returns Promise<Asset>
The new asset
- Defined in submodules/editor-api/src/assets.js:860

delete

delete(assets: Asset[]): Promise<void>
Deletes specified assets
Parameters
- assets: Asset[]
  The assets
Returns Promise<void>
- Defined in submodules/editor-api/src/assets.js:909

filter

filter(fn: Function): Asset[]
Gets assets that satisfy function
Parameters
- fn: Function
  The function (takes an asset as an argument and returns boolean).
Returns Asset[]
The assets
- Defined in submodules/editor-api/src/assets.js:313

findOne

findOne(fn: Function): Asset
Finds first asset that satisfies function
Parameters
- fn: Function
  A function that takes an asset as an argument and returns boolean.
Returns Asset
The asset
- Defined in submodules/editor-api/src/assets.js:325

get

get(id: number): Asset
Gets asset by id
Parameters
- id: number
  The asset id
Returns Asset
The asset
- Defined in submodules/editor-api/src/assets.js:154

getAssetForScript

getAssetForScript(script: string): Asset
Gets the first script asset that contains the specified script
Parameters
- script: string
  The script name
Returns Asset
The script asset
- Defined in submodules/editor-api/src/assets.js:450

getUnique

getUnique(uniqueId: number): Asset
Gets asset by its unique id
Parameters
- uniqueId: number
  The unique id
Returns Asset
The asset
- Defined in submodules/editor-api/src/assets.js:165

instantiateTemplates

instantiateTemplates(
    assets: Asset[],
    parent: Entity,
    options?: {
        extraData: object;
        history: boolean;
        index: number;
        select: boolean;
    },
): Promise<Entity[]>
Instantiates the specified template assets under the specified parent entity.
Parameters
- assets: Asset[]
  The template assets.
- parent: Entity
  The parent entity
- options: { extraData: object; history: boolean; index: number; select: boolean } = {}
  Options
  - extraData: object
    Extra data passed to the backend. Used by the Editor on specific cases.
  - history: boolean
    Whether to record a history action.
  - index: number
    The desired index under the parent to instantiate the templates.
  - select: boolean
    Whether to select the new entities.
Returns Promise<Entity[]>
The new entities
- Defined in submodules/editor-api/src/assets.js:941

list

list(): Asset[]
Returns array of all assets

Returns Asset[]
The assets
- Defined in submodules/editor-api/src/assets.js:175

listByTag

listByTag(...tags: any[]): Asset[]
Finds all assets with specified tags
Parameters
- ...tags: any[]
  The tags. If multiple tags are specified then assets that contain ANY of the specified tags will be included. If an argument is an array of tags then assets that contain ALL of the tags in the array will be included.
Returns Asset[]
The assets
- Defined in submodules/editor-api/src/assets.js:186

Class Assets

Hierarchy

Index

Internal

Other

Internal

add

Parameters

Returns void

clear

Returns void

loadAll

Parameters

view: string

Returns Promise<void>

loadAllAndSubscribe

Parameters

view: string

Returns Promise<void>

remove

Parameters

Returns void

Other

constructor

Parameters

autoSubscribe: boolean

Returns Assets

defaultUploadCompletedCallback

Returns Function

Parameters

Returns void

defaultUploadErrorCallback

Returns Function

Parameters

Returns void

defaultUploadProgressCallback

Returns Function

Parameters

Returns void

parseScriptCallback

Returns Function

Parameters

Returns void

createAnimStateGraph

Parameters

data: object

folder: Asset

name: string

onProgress: Function

preload: boolean

Returns Promise<Asset>

createBundle

Parameters

assets: Asset[]

folder: Asset

name: string

onProgress: Function

preload: boolean

Returns Promise<Asset>

createCss

Parameters

folder: string

name: string

onProgress: Function

preload: boolean

text: string

Returns Promise<Asset>

createCubemap

Parameters

anisotropy: number

folder: Asset

magFilter: number

minFilter: number

name: string

onProgress: Function

preload: boolean

textures: Asset[]

Returns Promise<Asset>

createFolder

Parameters