Modules
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])
- ~urlToUuid(url) ⇒
- static
AssetDB.init([cb])
Init assetdb, it will scan the mounted directories, and import unimported assets.
Kind: static method of AssetDB
Param | Type |
---|---|
[cb] | function |
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
Param | Type |
---|---|
url | string |
[cb] | function |
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
Param | Type |
---|---|
[cb] | function |
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
Param | Type | Description | |
---|---|---|---|
pattern | string |
The url pattern | |
assetTypes | string \ |
array |
The asset type(s) |
[cb] | function |
The callback function |
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
Param | Type | Description |
---|---|---|
pattern | string |
The url pattern |
type | string |
The asset type |
[cb] | function |
The callback function |
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
Param | Type |
---|---|
srcUrl | string |
destUrl | string |
[cb] | function |
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
Param | Type |
---|---|
urls | array |
[cb] | function |
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
Param | Type |
---|---|
url | string |
data | string |
[cb] | function |
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
Param | Type |
---|---|
url | string |
data | string |
[cb] | function |
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
Param | Type |
---|---|
rawfiles | array |
url | string |
[cb] | function |
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
Param | Type |
---|---|
uuid | string |
jsonString | string |
[cb] | function |
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
Param | Type |
---|---|
urlA | string |
urlB | string |
[cb] | function |
AssetDB.clearImports(url, [cb])
Clear imports
Kind: static method of AssetDB
Param | Type |
---|---|
url | string |
[cb] | function |
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
Param | Type | Description |
---|---|---|
extname | string |
|
folder | boolean |
Whether it's a folder type |
metaCtor | object |
Example
Editor.assetdb.register( '.png', false, PngMeta );
AssetDB.unregister(metaCtor)
Unregister meta type
Kind: static method of AssetDB
Param | Type |
---|---|
metaCtor | object |
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 AssetDB
Returns: string
- the relative path from mount path to the asset
Param | Type |
---|---|
fspath | string |
AssetDB.getAssetBackupPath(filePath)
get the backup file path of asset file
Kind: static method of AssetDB
Param | Type | Description |
---|---|---|
filePath | string |
asset file path |
AssetDB.setEventCallback(cb)
set the event callback for assets events
Kind: static method of AssetDB
Param | Type | Description |
---|---|---|
cb | object |
The callback for assets events. |
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
Param | Type |
---|---|
url | string |
AssetDB~fspathToUuid(fspath) ⇒ string
Return uuid by file path. if uuid not found, it will return null.
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~uuidToFspath(uuid) ⇒ string
Return file path by uuid. if file path not found, it will return null.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~uuidToUrl(uuid) ⇒ string
Return url by uuid. if url not found, it will return null.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~fspathToUrl(fspath) ⇒ string
Return url by file path. if file path not found, it will return null.
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~urlToFspath(url) ⇒ string
Return file path by url. if url not found, it will return null.
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~exists(url) ⇒ string
Check existance by url.
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~existsByUuid(uuid) ⇒ string
Check existance by uuid.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~existsByPath(fspath) ⇒ string
Check existance by path.
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~isSubAsset(url) ⇒ boolean
Check whether asset for a given url is a sub asset.
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~isSubAssetByUuid(uuid) ⇒ boolean
Check whether asset for a given uuid is a sub asset.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~isSubAssetByPath(fspath) ⇒ boolean
Check whether asset for a given path is a sub asset.
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~containsSubAssets(url) ⇒ boolean
Check whether asset contains sub assets for a given url.
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~containsSubAssetsByUuid(uuid) ⇒ boolean
Check whether asset contains sub assets for a given uuid.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~containsSubAssetsByPath(path) ⇒ boolean
Check whether asset contains sub assets for a given path.
Kind: inner method of AssetDB
Param | Type |
---|---|
path | string |
AssetDB~assetInfo(url) ⇒ object
Return asset info by a given url.
Kind: inner method of AssetDB
Returns: object
- - { uuid, path, url, type, isSubAsset }
Param | Type |
---|---|
url | string |
AssetDB~assetInfoByUuid(uuid) ⇒ object
Return asset info by a given uuid.
Kind: inner method of AssetDB
Returns: object
- - { uuid, path, url, type, isSubAsset }
Param | Type |
---|---|
uuid | string |
AssetDB~assetInfoByPath(fspath) ⇒ object
Return asset info by a given file path.
Kind: inner method of AssetDB
Returns: object
- - { uuid, path, url, type, isSubAsset }
Param | Type |
---|---|
fspath | string |
AssetDB~subAssetInfos(url) ⇒ array
Return all sub assets info by url if the url contains sub assets.
Kind: inner method of AssetDB
Returns: array
- - [{ uuid, path, url, type, isSubAsset }]
Param | Type |
---|---|
url | string |
AssetDB~subAssetInfosByUuid(uuid) ⇒ array
Return all sub assets info by uuid if the uuid contains sub assets.
Kind: inner method of AssetDB
Returns: array
- - [{ uuid, path, url, type, isSubAsset }]
Param | Type |
---|---|
uuid | string |
AssetDB~subAssetInfosByPath(fspath) ⇒ array
Return all sub assets info by path if the path contains sub assets.
Kind: inner method of AssetDB
Returns: array
- - [{ uuid, path, url, type, isSubAsset }]
Param | Type |
---|---|
fspath | string |
AssetDB~loadMeta(url) ⇒ object
Return meta instance by a given url.
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~loadMetaByUuid(uuid) ⇒ object
Return meta instance by a given uuid.
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~loadMetaByPath(fspath) ⇒ object
Return meta instance by a given path.
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~isMount(url) ⇒ boolean
Return whether a given url is reference to a mount
Kind: inner method of AssetDB
Param | Type |
---|---|
url | string |
AssetDB~isMountByPath(fspath) ⇒ boolean
Return whether a given path is reference to a mount
Kind: inner method of AssetDB
Param | Type |
---|---|
fspath | string |
AssetDB~isMountByUuid(uuid) ⇒ boolean
Return whether a given uuid is reference to a mount
Kind: inner method of AssetDB
Param | Type |
---|---|
uuid | string |
AssetDB~mountInfo(url) ⇒ object
Return mount info by url
Kind: inner method of AssetDB
Returns: object
- - { path, name, type }
Param | Type |
---|---|
url | string |
AssetDB~mountInfoByUuid(uuid) ⇒ object
Return mount info by uuid
Kind: inner method of AssetDB
Returns: object
- - { path, name, type }
Param | Type |
---|---|
uuid | string |
AssetDB~mountInfoByPath(fspath) ⇒ object
Return mount info by path
Kind: inner method of AssetDB
Returns: object
- - { path, name, type }
Param | Type |
---|---|
fspath | string |
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
Param | Type | Description |
---|---|---|
path | string |
file system path |
mountPath | string |
the mount path (relative path) |
opts | object |
options |
opts.hide | object |
if the mount hide in assets browser |
opts.virtual | object |
if this is a virtual mount point |
opts.icon | object |
icon for the mount |
[cb] | function |
a callback function |
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
Param | Type | Description |
---|---|---|
mountPath | string |
the mount path (relative path) |
[cb] | function |
a callback function |
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
Param | Type | Description |
---|---|---|
mountPath | string |
the mount path (relative path) |
[cb] | function |
a callback function |
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
Param | Type | Description |
---|---|---|
mountPath | string |
the mount path |
[cb] | function |
Example
Editor.assetdb.unmount('assets', function (err) {
// unmounted, do something ...
});
_checkIfMountValid(assetdb, fspath)
check and remove unused meta file
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
fspath | string |
meta file path |
_deleteImportedAssets()
_removeUnusedMeta(assetdb, metapath)
check and remove unused meta file
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
metapath | string |
meta file path |
_backupUnusedMeta(assetdb, metapath, force) ⇒ string
check and backup unused meta file
Kind: global function
Returns: string
- The relative path of the meta file. If not backed up, return null
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
metapath | string |
meta file path |
force | boolean |
skip the check process and force do backup, default is false |
_backupAsset(assetdb, filePath)
check and backup asset file
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
filePath | string |
asset file path |
_removeUnusedImportFiles()
_removeUnusedImportFiles
_removeUnusedMtimeInfo()
_removeUnusedMtimeInfo
_scan(assetdb, fspath, opts, cb)
task scan
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
fspath | string |
file system path |
opts | object |
options |
opts.remove-unused-meta | object |
indicate if remove unused meta file |
opts.filter-meta | object |
if results need filter .meta file |
cb | function |
_checkIfReimport(assetdb, fspath, cb)
check if reimport
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
fspath | string |
file system path |
cb | function |
_initMetas(assetdb, fspath, cb)
precache uuid from meta files, if meta file not exists, create it
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
fspath | string |
file system path |
cb | function |
_importAsset(assetdb, fspath, cb)
precache uuid from meta files, if meta file not exists, create it
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
fspath | string |
file system path |
cb | function |
_postImportAsset(assetdb, assetInfo, cb)
Post manipulations of meta files, it may used to create reference between imported assets.
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
assetInfo | object |
Asset info object including file system path and other informations. |
cb | function |
_fillInResults(assetdb, path, meta, results)
Construct results for given meta and fill into the results array
Kind: global function
Param | Type | Description |
---|---|---|
assetdb | object |
asset database |
path | string |
file system path for asset |
meta | AssetMeta |
Meta object |
results | Array |
The results array to fill |
_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
Kind: global function