Content browser 154

From PopcornFX
Jump to navigation Jump to search

See also : Editor interface overview.

This page is for version v1.5.4
For the latest version of PopcornFX, see: Content browser


Overview

The content browser is shown when a project is opened. It allows you to see a preview of the resources inside the current pack, edit them, and create new resources.

PopcornFx Content-browser overview


Content thumbnails

The main content browser view is the thumbnails view, where a preview of the resource is displayed, along with the resource name. Just double-click on any thumbnail to launch the specific editor associated with the resource type.

When the editor is running, if you delete or create new files in the current pack directories, the content browser will auto-update the resource list and hot-reload everything that needs to.


Keyboard Shortcuts

F2 Rename selected asset (will rename all associated meta-files, same as right-click > Rename)
Ctrl+F2 Clone selected asset (will rename all associated meta-files, same as right-click > Rename)
Ctrl+T Assign tags to selected assets
Ctrl+B Bake selected assets (only if output platforms are defined in the project settings)
Del Deletes selected asset (asks for confirmation, will also delete all associated meta-files)
Enter Open editor for selected asset (same as double-click)
Ctrl+A Select all filtered assets


Note on "meta-files" : These are the .pkcf asset-config files, the editor thumbnails, and baked temporary assets in the 'Cache' folder


Filter Settings

The filter settings panel allows you to filter the content list, by resource type, and/or resource name.
By default, it is located on the top-right hand-side of the content browser.

If you start typing in the 'Search' field, the content list will update dynamically and show you all the resources whose name contain the text you just typed:


PopcornFx Content-browser filter settings


PopcornFx Content-browser filter settings


New asset

To create a new asset, right click on an empty area of the 'Content Thumbnails' panel, and select 'Create Asset', and the type of asset you wish to create:

PopcornFx Content-browser : new asset


A window will pop, asking you the name you wish to give to the new asset:

PopcornFx Content-browser : new asset


Once validated, A new thumbnail will appear on the content browser's list:

PopcornFx Content-browser : new asset


Tags

The tags panel allows you to create a set of tags, assign them to your effects, and quickly filter the effects that match a specific tag.

To create a new tag, locate the Tags panel, below the Filter panel, type a new tag name in the inputbox, and click the 'Add' button next to it (or hit the 'Enter' key). The new tag will appear in the tags list.

PopcornFx Content-browser : tag list


To assign one or multiple tags to an effect, select the effect, right-click and select the 'Add Tags' menu, or hit Ctrl+T.

PopcornFx Content-browser : assign tags


The add tags window will pop. You can select an arbitrary number of tags to bind them to the effect.

PopcornFx Content-browser : assing tags


NOTE : you can select multiple effects just like you would select multiple files in the windows explorer (using Shift+mouseclick and Ctrl+mouseclick), and hit Ctrl+T (or go through the menu). It will add/remove tags for all the selected effects.


Baking

You can bake the selected asset(s) by hitting Ctrl+B in the content browser (also available inside the particle-editor to bake the current effect)

If no bake platforms are setup, it will show this window:

PopcornFx Content-browser : cannot bake


To change/add bake platforms, see project settings : bake targets


Otherwise, you'll get the following message:

PopcornFx Content-browser : baking window


  • Bake all platforms : shortcut for selecting all platforms. Preserves specific platform selection if you only bake on one platform most of the time during development
  • Bake dependencies : will also bake all the asset's dependencies (meshes, textures, other effects that are triggered from this effect, etc...)


More infos on baking on the AssetBaker page.