The content browser is displayed when opening a PopcornFX project and displays all assets contained in the project:
You can navigate your project the same way you would do using your preferred file explorer as the content browser mirrors the on-disk folder structure.
PopcornFX projects contain various asset types:
|PopcornFX effects (.pkfx)|
|Static or animated meshes (.fbx)|
|2D textures (dds, png, jpg, jpeg, tga, tif, tiff, pkm, pvr, exr, hdr)|
|2D textures atlases (.pkat)|
|Vector fields (.fga)|
|Font metrics (.ttf, .otf)|
|Sounds (.wav, .ogg, .mp3)|
The PopcornFX editor processes those source asset file formats into internal file formats (.pkmm, .pkvf, .pkfm, ..) and stores them in the project’s Cache folder. By default, it is located in Editor/Cache/.
All resources are imported automatically when placed in the project via your system’s file explorer:
- On-disk folder location, mirrored in the content browser
- Source asset
- Virtual asset that can now be used in the PopcornFX project
Nothing more is required to import the asset.
The content browser supports common file-explorer like actions, but also more advanced actions. Right click an asset to display them:
The treeview is a classic file explorer like tree view of the project’s directory structure and content:
- Folders, mirrors the on-disk folder structure from your project
Assets can be moved around easily, and selected assets are synchronized with the Thumbnails view.
Content browser’s main view, it displays your PopcornFX project’s content:
- Previous/next folder location, parent folder
- Navigation breadcrumb, current location is highlighted
- Filters dropdown, allows to filter specific asset types
- Search bar
- Asset name
- Asset type icon
It is possible to change thumbnails size in your editor settings.
The details view provides a flat view of the project’s assets, with detailed columns:
- Right click a column displays those options, to add/remove columns
- Status column, useful to sort items by status, to quickly identify problematic assets
This view is very useful later in production, or for content reviews.
Hovering assets displays a status tooltil detailing the various infos/warnings/errors generated by the asset graphs:
It is also possible to add custom columns in the editor settings.
Right now, the content browser can only create two types of assets (folders and effects). Simply right click either in the treeview or thumbnails view:
- New Effect, selecting this displays the new effect type panel
- New folder, will be created on-disk too
- Template effects, will create an effect from the selected template. You can create your own template effects (right now, template effects are contained by default under Editor/Templates/). We’ll improve that creation dialog in future PopcornFX versions
- Empty effect, to create effects from scratch
Once the effect/folder is created, it’ll appear both in treeview and thumbnails view.
A simple copy/paste of the .pkfx file isn’t enough to share a PopcornFX effect as effects have many dependencies (templates, textures, meshes, ..). The correct option is to create a PopcornFX package (.pkkg) as they can contain various assets and their dependencies.
To create a package, simply select all assets you would like to share, right click -> Export to Package:
- Output package location
- Browse export location using system’s explorer
Once the package location is correct, click OK. This will display the package export dialog:
This window displays all dependencies for that asset, and let you remove dependencies if necessary. Click Export to finalize the package creation.
PopcornFX packages (.pkkg) are often used to share assets between projects or users, to import one, right click in the treeview or thumbnails view:
Then, select the source .pkkg file, this will display the package import dialog:
- Folder structure, folders will be created if they don’t exist on-disk
- Imported assets
- Assets conflicts, importing this asset will override this asset that already exists in your project