Project selection 154
See also : Editor interface overview.
This page is for version v1.5.4
For the latest version of PopcornFX, see: Project selection
When you first start the PK-Fx editor, the following window will pop-up:
This is the project selection window.
It is split in 3 main parts:
- 1 : Data folder
- 2 : Projects panel
- 3 : Recent files panel
This tells the Popcorn-Fx editor where to look for the projects settings.
It is by default set to a user-directory. You do not have to have your packs in this folder, this is for the user configuration stuff.
PK-Fx Editor allows you to setup multiple "projects" at once. However, you can only have a single project loaded at a single time.
This panel allows you to add new projects, and change their settings.
To open a project, you can either:
- double-click on the project you wish to open
- select the project, and click the 'OK' button in the window's bottom-right corner.
The little garbage-can icon on the left of each project deletes the project's entry (NOTE: it does NOT delete the project's files !)
Clicking on the 'Settings' button pops-up the project settings window:
The "Pack root" tells the editor where the pack is physically located.
It can be a path relative to the data-folder, or an absolute path.
The Coordinate-system setup panel will allow you to choose between the following coordinate systems:
|Right handed Y-Up axis
( aka. OpenGL )
|Right handed Z-Up axis
( aka. Max )
|Left handed Y-Up axis
( aka. DirectX )
|Left handed Z-Up axis|
NOTE: there was a bug in Popcorn-Fx editor v126.96.36.19942 that prevented coordinate systems other than Right handed Y-Up from functioning properly. This has been fixed in the latest version.
You can add custom resource paths to where your resources are located, to make them browsable from within popcorn.
(absolute paths are forbidden to reference resources in the editor).
Here you can setup your list of output platforms to tell the editor where it should output the baked targets for each platform.
See the AssetBaker page for more details
Recent files panel
This lists the recent files in each project, and allows you to select what file should be automatically opened when launching the project.
Sometimes, when a new version of the popcorn runtime & editor is released, some things might change that will cause assets to break.
Although the file formats popcorn uses support retro-compatibility, it is on-purpose that we do not make everything retro-compatible.
This gives us much more freedom to improve and refactor things that need to be, to bring you a better system.
However, we have a system that knows the history of breaking-changes in assets, from version to version, and can automatically upgrade yours if they are from an earlier version.
It can only upgrade assets from an earlier version to a newer version, NOT downgrade them from a new version to an old one.
This has various implications:
- Your editor packs must ALWAYS have the "LastRevision.txt" file at their root. This is where the editor stores the last version of the pack. (This might change in the future to add a per-asset version number, to make it easier to transfer assets from one machine to another, that might not have the same editor version)
- If you have popcorn packs in source-control, Make sure their "LastRevision.txt" file is in source-control too, so that the pack won't get upgraded twice by different people.
- You should avoid manually copy/pasting assets from packs that are not upgraded to the same popcorn version.
- Your popcorn editor version should match your runtime version
The editor makes it clear in the project list which projects are out-of date and need updating, by highlighting them in red and displaying a tooltip giving details about what changes have taken place between that pack's version and the current editor version:
Projects without the "LastRevision.txt" file at their root will be treated as legacy packs (before the revision system was introduced), and ALL patches will be applied:
To upgrade an out-of-date project, simply click on the 'update' icon appearing next to the 'delete' icon:
Projects more recent than the editor
A project MORE RECENT than the editor will appear in a slightly deeper red, and the tooltip will say so explicitely:
Trying to open the project will pop up the following warning window:
Troubleshooting project upgrade
Sometimes, a project upgrade can fail.
Most of the time, this is due to the access permissions on the files that the editor tries to upgrade.
It can happen if you are using a source-control software that locks the files and sets them to read-only mode.
The popcorn editor will not force them to read-write, therefore will fail upgrading them if they are read-only.
Make sure your files have write permissions when you upgrade your project.
You might also get this error:
Which indicates the editor failed writing to the "LastRevision.txt" file at the root of the PopcornFx pack.
The popcorn editor will automatically connect to the popcornfx website to check if there are editor updates/fixes available.
If updates are found, it will display the latest update changelog:
We recommend you keep this check active to get the latest bugfixes. However, if you are bound to an older version of the C++ SDK, you might not want to get the latest editor update, as it may have features not supported by your older SDK.
You cannot disable auto-updates from the UI yet, to do this manually, download and run the following .reg file:
(you might need administrator privileges)