Modules

• AssetDB

Functions

• _checkIfMountValid(assetdb, fspath)

• check and remove unused meta file

• _deleteImportedAssets()

• _removeUnusedMeta(assetdb, metapath)

• check and remove unused meta file

• _backupUnusedMeta(assetdb, metapath, force) ⇒ string

• check and backup unused meta file

• _backupAsset(assetdb, filePath)

• check and backup asset file

• _removeUnusedImportFiles()

• _removeUnusedImportFiles

• _removeUnusedMtimeInfo()

• _removeUnusedMtimeInfo

• _scan(assetdb, fspath, opts, cb)

• task scan

• _checkIfReimport(assetdb, fspath, cb)

• check if reimport

• _initMetas(assetdb, fspath, cb)

• precache uuid from meta files, if meta file not exists, create it

• _importAsset(assetdb, fspath, cb)

• precache uuid from meta files, if meta file not exists, create it

• _postImportAsset(assetdb, assetInfo, cb)

• Post manipulations of meta files, it may used to create reference between imported assets.

• _fillInResults(assetdb, path, meta, results)

• Construct results for given meta and fill into the results array

• _refresh()

• task refresh

• _preProcessMoveInput()

• callback's parameters: srcPath, destPath, srcpaths, destPaths

• _copyFiles()

• _generateSubMetaDiff()

• For save / saveMeta tasks to generate sub meta diff informations

• _deleteAsset()

• Delete one asset by fspath

AssetDB

Process: core

• AssetDB
  • static
    • .init([cb])
    • .refresh(url, [cb])
    • .deepQuery([cb])
    • .queryAssets(pattern, assetTypes, [cb])
    • .queryMetas(pattern, type, [cb])
    • .move(srcUrl, destUrl, [cb])
    • .delete(urls, [cb])
    • .create(url, data, [cb])
    • .saveExists(url, data, [cb])
    • .import(rawfiles, url, [cb])
    • .saveMeta(uuid, jsonString, [cb])
    • .exchangeUuid(urlA, urlB, [cb])
    • .clearImports(url, [cb])
    • .register(extname, folder, metaCtor)
    • .unregister(metaCtor)
    • .getRelativePath(fspath) ⇒ string
    • .getAssetBackupPath(filePath)
    • .setEventCallback(cb)
  • inner
    • ~urlToUuid(url) ⇒ string
    • ~fspathToUuid(fspath) ⇒ string
    • ~uuidToFspath(uuid) ⇒ string
    • ~uuidToUrl(uuid) ⇒ string
    • ~fspathToUrl(fspath) ⇒ string
    • ~urlToFspath(url) ⇒ string
    • ~exists(url) ⇒ string
    • ~existsByUuid(uuid) ⇒ string
    • ~existsByPath(fspath) ⇒ string
    • ~isSubAsset(url) ⇒ boolean
    • ~isSubAssetByUuid(uuid) ⇒ boolean
    • ~isSubAssetByPath(fspath) ⇒ boolean
    • ~containsSubAssets(url) ⇒ boolean
    • ~containsSubAssetsByUuid(uuid) ⇒ boolean
    • ~containsSubAssetsByPath(path) ⇒ boolean
    • ~assetInfo(url) ⇒ object
    • ~assetInfoByUuid(uuid) ⇒ object
    • ~assetInfoByPath(fspath) ⇒ object
    • ~subAssetInfos(url) ⇒ array
    • ~subAssetInfosByUuid(uuid) ⇒ array
    • ~subAssetInfosByPath(fspath) ⇒ array
    • ~loadMeta(url) ⇒ object
    • ~loadMetaByUuid(uuid) ⇒ object
    • ~loadMetaByPath(fspath) ⇒ object
    • ~isMount(url) ⇒ boolean
    • ~isMountByPath(fspath) ⇒ boolean
    • ~isMountByUuid(uuid) ⇒ boolean
    • ~mountInfo(url) ⇒ object
    • ~mountInfoByUuid(uuid) ⇒ object
    • ~mountInfoByPath(fspath) ⇒ object
    • ~mount(path, mountPath, opts, [cb])
    • ~attachMountPath(mountPath, [cb])
    • ~unattachMountPath(mountPath, [cb])
    • ~unmount(mountPath, [cb])
      

AssetDB.init([cb])

Init assetdb, it will scan the mounted directories, and import unimported assets.

Kind: static method of AssetDB

Example

Editor.assetdb.init(function (err, results) {
  // assets that imported during init
  results.forEach(function ( result ) {
    // result.uuid
    // result.parentUuid
    // result.url
    // result.path
    // result.type
  });
});

AssetDB.refresh(url, [cb])

Refresh the assets in url, and return the results

Kind: static method of AssetDB

Example

Editor.assetdb.refresh('db://assets/foo/bar/', function (err, results) {
  // assets that imported during init
  results.forEach(function ( result ) {
    if ( result.command === 'delete' ) {
      // result.uuid
      // result.url
      // result.path
      // result.type
    } else if ( result.command === 'change' || result.command === 'create' ) {
      // result.uuid
      // result.parentUuid
      // result.url
      // result.path
      // result.type
    } else if ( result.command === 'uuid-change' ) {
      // result.oldUuid
      // result.uuid
      // result.parentUuid
      // result.url
      // result.path
      // result.type
    }
  });
});

AssetDB.deepQuery([cb])

deepQuery

Kind: static method of AssetDB

Example

Editor.assetdb.deepQuery(function ( err, results ) {
  results.forEach(function ( result ) {
    // result.name
    // result.extname
    // result.uuid
    // result.type
    // result.isSubAsset
    // result.children - the array of children result
  });
});

AssetDB.queryAssets(pattern, assetTypes, [cb])

queryAssets

Kind: static method of AssetDB

Example

Editor.assetdb.queryAssets( 'db://assets/**\/*', 'texture', function ( err, results ) {
  results.forEach(function ( result ) {
    // result.url
    // result.path
    // result.uuid
    // result.type
    // result.isSubAsset
  });
});

AssetDB.queryMetas(pattern, type, [cb])

queryMetas

Kind: static method of AssetDB

Example

Editor.assetdb.queryAssets( 'db://assets/**\/*', 'texture', function ( err, results ) {
  results.forEach(function ( meta ) {
    // the meta instance
  });
});

AssetDB.move(srcUrl, destUrl, [cb])

move

Kind: static method of AssetDB

Example

Editor.assetdb.move( 'db://assets/foo/foobar.png', 'db://assets/bar/foobar.png', function ( err, results ) {
  results.forEach(function ( result ) {
    // result.srcPath
    // result.destPath
    // result.uuid
    // result.parentUuid
  });
});

AssetDB.delete(urls, [cb])

delete

Kind: static method of AssetDB

Example

Editor.assetdb.delete( [ 'db://assets/foo/bar.png', 'db://assets/foo/bar.plist' ], function ( err, results ) {
  results.forEach(function ( result ) {
    // result.srcPath
    // result.destPath
    // result.uuid
    // result.parentUuid
  });
});

AssetDB.create(url, data, [cb])

Create asset at url with data

Kind: static method of AssetDB

Example

Editor.assetdb.create( 'db://assets/foo/bar.js', data, function ( err, results ) {
  results.forEach(function ( result ) {
    // result.uuid
    // result.parentUuid
    // result.url
    // result.path
    // result.type
  });
});

AssetDB.saveExists(url, data, [cb])

Save data to the exists asset at url

Kind: static method of AssetDB

Example

Editor.assetdb.saveExists( 'db://assets/foo/bar.js', data, function ( err, meta ) {
  // do something
});

AssetDB.import(rawfiles, url, [cb])

Import raw files to url

Kind: static method of AssetDB

Example

Editor.assetdb.import( ['/User/user/foo.js', '/User/user/bar.js'], 'db://assets/foobar', function ( err, results ) {
  results.forEach(function ( result ) {
    // result.uuid
    // result.parentUuid
    // result.url
    // result.path
    // result.type
  });
});

AssetDB.saveMeta(uuid, jsonString, [cb])

Overwrite the meta by loading it through uuid

Kind: static method of AssetDB

Example

Editor.assetdb.saveMeta( uuid, jsonString, function ( err, meta ) {
  // do something
});

AssetDB.exchangeUuid(urlA, urlB, [cb])

Exchange uuid for two assets

Kind: static method of AssetDB

AssetDB.clearImports(url, [cb])

Clear imports

Kind: static method of AssetDB

Example

Editor.assetdb.clearImports( 'db://assets/foo/bar.js', function ( err, results ) {
  results.forEach(function ( result ) {
    // result.uuid
    // result.url
    // result.path
    // result.type
  });
});

AssetDB.register(extname, folder, metaCtor)

Register meta type

Kind: static method of AssetDB

Example

Editor.assetdb.register( '.png', false, PngMeta );

AssetDB.unregister(metaCtor)

Unregister meta type

Kind: static method of AssetDB

Example

Editor.assetdb.unregister( PngMeta );

AssetDB.getRelativePath(fspath) ⇒ string

Get the relative path from mount path to the asset by fspath

Kind: static method of AssetDBReturns: string - the relative path from mount path to the asset

AssetDB.getAssetBackupPath(filePath)

get the backup file path of asset file

Kind: static method of AssetDB

AssetDB.setEventCallback(cb)

set the event callback for assets events

Kind: static method of AssetDB

Example

Editor.assetdb.setEventCallback((event, params) => {
   // do something for the event
})

AssetDB~urlToUuid(url) ⇒ string

Return uuid by url. if uuid not found, it will return null.

Kind: inner method of AssetDB

AssetDB~fspathToUuid(fspath) ⇒ string

Return uuid by file path. if uuid not found, it will return null.

Kind: inner method of AssetDB

AssetDB~uuidToFspath(uuid) ⇒ string

Return file path by uuid. if file path not found, it will return null.

Kind: inner method of AssetDB

AssetDB~uuidToUrl(uuid) ⇒ string

Return url by uuid. if url not found, it will return null.

Kind: inner method of AssetDB

AssetDB~fspathToUrl(fspath) ⇒ string

Return url by file path. if file path not found, it will return null.

Kind: inner method of AssetDB

AssetDB~urlToFspath(url) ⇒ string

Return file path by url. if url not found, it will return null.

Kind: inner method of AssetDB

AssetDB~exists(url) ⇒ string

Check existance by url.

Kind: inner method of AssetDB

AssetDB~existsByUuid(uuid) ⇒ string

Check existance by uuid.

Kind: inner method of AssetDB

AssetDB~existsByPath(fspath) ⇒ string

Check existance by path.

Kind: inner method of AssetDB

AssetDB~isSubAsset(url) ⇒ boolean

Check whether asset for a given url is a sub asset.

Kind: inner method of AssetDB

AssetDB~isSubAssetByUuid(uuid) ⇒ boolean

Check whether asset for a given uuid is a sub asset.

Kind: inner method of AssetDB

AssetDB~isSubAssetByPath(fspath) ⇒ boolean

Check whether asset for a given path is a sub asset.

Kind: inner method of AssetDB

AssetDB~containsSubAssets(url) ⇒ boolean

Check whether asset contains sub assets for a given url.

Kind: inner method of AssetDB

AssetDB~containsSubAssetsByUuid(uuid) ⇒ boolean

Check whether asset contains sub assets for a given uuid.

Kind: inner method of AssetDB

AssetDB~containsSubAssetsByPath(path) ⇒ boolean

Check whether asset contains sub assets for a given path.

Kind: inner method of AssetDB

AssetDB~assetInfo(url) ⇒ object

Return asset info by a given url.

Kind: inner method of AssetDBReturns: object - - { uuid, path, url, type, isSubAsset }

AssetDB~assetInfoByUuid(uuid) ⇒ object

Return asset info by a given uuid.

Kind: inner method of AssetDBReturns: object - - { uuid, path, url, type, isSubAsset }

AssetDB~assetInfoByPath(fspath) ⇒ object

Return asset info by a given file path.

Kind: inner method of AssetDBReturns: object - - { uuid, path, url, type, isSubAsset }

AssetDB~subAssetInfos(url) ⇒ array

Return all sub assets info by url if the url contains sub assets.

Kind: inner method of AssetDBReturns: array - - [{ uuid, path, url, type, isSubAsset }]

AssetDB~subAssetInfosByUuid(uuid) ⇒ array

Return all sub assets info by uuid if the uuid contains sub assets.

Kind: inner method of AssetDBReturns: array - - [{ uuid, path, url, type, isSubAsset }]

AssetDB~subAssetInfosByPath(fspath) ⇒ array

Return all sub assets info by path if the path contains sub assets.

Kind: inner method of AssetDBReturns: array - - [{ uuid, path, url, type, isSubAsset }]

AssetDB~loadMeta(url) ⇒ object

Return meta instance by a given url.

Kind: inner method of AssetDB

AssetDB~loadMetaByUuid(uuid) ⇒ object

Return meta instance by a given uuid.

Kind: inner method of AssetDB

AssetDB~loadMetaByPath(fspath) ⇒ object

Return meta instance by a given path.

Kind: inner method of AssetDB

AssetDB~isMount(url) ⇒ boolean

Return whether a given url is reference to a mount

Kind: inner method of AssetDB

AssetDB~isMountByPath(fspath) ⇒ boolean

Return whether a given path is reference to a mount

Kind: inner method of AssetDB

AssetDB~isMountByUuid(uuid) ⇒ boolean

Return whether a given uuid is reference to a mount

Kind: inner method of AssetDB

AssetDB~mountInfo(url) ⇒ object

Return mount info by url

Kind: inner method of AssetDBReturns: object - - { path, name, type }

AssetDB~mountInfoByUuid(uuid) ⇒ object

Return mount info by uuid

Kind: inner method of AssetDBReturns: object - - { path, name, type }

AssetDB~mountInfoByPath(fspath) ⇒ object

Return mount info by path

Kind: inner method of AssetDBReturns: object - - { path, name, type }

AssetDB~mount(path, mountPath, opts, [cb])

mount a directory to assetdb, and give it a name. if you don't provide a name, it will mount to root.

Kind: inner method of AssetDB

Example

Editor.assetdb.mount('path/to/mount', 'assets', function (err) {
  // mounted, do something ...
});

AssetDB~attachMountPath(mountPath, [cb])

attach the specified mount path

Kind: inner method of AssetDB

Example

Editor.assetdb.attachMountPath('assets', function (err, results) {
  // mount path attached, do something ...
  // results are the assets created
});

AssetDB~unattachMountPath(mountPath, [cb])

unattach the specified mount path

Kind: inner method of AssetDB

Example

Editor.assetdb.unattachMountPath('assets', function (err, results) {
  // mount path unattached, do something ...
  // results are the assets deleted
});

AssetDB~unmount(mountPath, [cb])

Unmount by name

Kind: inner method of AssetDB

Example

Editor.assetdb.unmount('assets', function (err) {
  // unmounted, do something ...
});

_checkIfMountValid(assetdb, fspath)

check and remove unused meta file

Kind: global function

_deleteImportedAssets()

Kind: global function

_removeUnusedMeta(assetdb, metapath)

check and remove unused meta file

Kind: global function

_backupUnusedMeta(assetdb, metapath, force) ⇒ string

check and backup unused meta file

Kind: global functionReturns: string - The relative path of the meta file. If not backed up, return null

_backupAsset(assetdb, filePath)

check and backup asset file

Kind: global function

_removeUnusedImportFiles()

_removeUnusedImportFiles

Kind: global function

_removeUnusedMtimeInfo()

_removeUnusedMtimeInfo

Kind: global function

_scan(assetdb, fspath, opts, cb)

task scan

Kind: global function

_checkIfReimport(assetdb, fspath, cb)

check if reimport

Kind: global function

_initMetas(assetdb, fspath, cb)

precache uuid from meta files, if meta file not exists, create it

Kind: global function

_importAsset(assetdb, fspath, cb)

precache uuid from meta files, if meta file not exists, create it

Kind: global function

_postImportAsset(assetdb, assetInfo, cb)

Post manipulations of meta files, it may used to create reference between imported assets.

Kind: global function

_fillInResults(assetdb, path, meta, results)

Construct results for given meta and fill into the results array

Kind: global function

_refresh()

task refresh

Kind: global function

_preProcessMoveInput()

callback's parameters: srcPath, destPath, srcpaths, destPaths

Kind: global function

_copyFiles()

Kind: global function

_generateSubMetaDiff()

For save / saveMeta tasks to generate sub meta diff informations

Kind: global function

_deleteAsset()

Delete one asset by fspath

Kind: global function