Here you can find a list of articles describing the individual windows in PFM and how to use them.
- Actor Editor
- Graph Editor
- Model Catalog
- Material Editor
- Web Browser
- Particle Editor
- UDM Editor
Above is the initial view you should be seeing when launching PFM for the first time. The interface is very similar to that of SFM, so if you're familiar with SFM you should feel mostly at home. That being said, there are significant differences as well. Here is a short overview over the most important windows:
- Primary Viewport: The viewport is where you can view your scene, play back your animation, select and transform actors, etc.
- Render: This is where you can render your scene. You can render single images or animations, use one of several renderer engines, render VR images and more.
- Timeline: In this window you will find the
Clip Editor, for managing film clips and the
Graph Editorfor animating. The
Motion Editoris currently not implemented and is not available.
- Actor Editor: After selecting a film clip from the
Timelinewindow, this is where you will find a list of all of the actors in the scene and where you can edit actor properties or add new actors.
All windows can be detached from the main window using the icon at the top right, which can be particularly handy if you want to work with multiple monitors:
Here are some of the most important options in the menu bar:
File > New: Create a new empty or simple project.
An empty project will start out with no actors whatsoever, while a simple project contains a few commonly used base actors (such as a camera and a sky actor).
The directory for opening or saving a project is
Pragma/addons/filmmaker/projects/, you cannot choose any other destination. PFM also has an autosave which is triggered approximately every 10 minutes. Autosaved projects can be found in the same directory as the main project, but with the suffix
_autosaveX at the end of the file name.
File > Import: Import a SFM project or a map.
Importing a SFM project can take several minutes, since all of the assets used in the project will have to be converted to Pragma's formats. Importing a SFM project is also not a 1:1 process, it is likely that the scene will look significantly different in SFM and will require some adjustments.
You also have to make sure that all actor transforms are unlocked and all rigs are detached before importing the project into PFM. You can find more information on how to do that here.
You can also import a map. This is not a full import and will only import the map geometry and map props, which will be added to the scene as actors. Other entities will not be imported. It is only recommended to use this option for small maps.
File > Pack project...: This option allows you to pack up the entire project, including all of its used assets, into a zip-archive. This archive can be used to share the project with other people.
Preferences > Language: Allows you to change the interface language. Only English and German are fully translated, other languages will default to English for non-translated texts.
Windows: Not all available windows are open by default. Here you can find and open all available windows. Please read through the articles for the individual windows here to find out more information about them.
Below is a list of the available keybinds that are accessible everywhere. Some windows may provide additional keybinds, which you can find at the bottom of the wiki article for the respective window.
|Quick-Move X Axis||x|
|Quick-Move Y Axis||y|
|Quick-Move Z Axis||z|
|Save Project||Ctrl +S|
The viewport window provides a real-time preview of your scene which you can interact with to select actors, move them around, etc.
To move the work camera around in the viewport, click (and hold) the right mouse button and drag the cursor around. As long as you are holding down the mouse button, you can move around with WASD. To move slower or faster, you can hold the alt- or shift-key respectively. Additionally, you can use the scroll wheel to change the field of view of the camera while in this mode.
Keyboard shortcut: Q
Select mode, you can simply left-click an actor to select them, which is indicated by a blue outline around the object. The actor will also be selected in the actor editor. You can also click-and-drag the mouse cursor to create a rectangle selection and select multiple objects at once.
You can select multiple actors by holding the ctrl-key. To deselect an actor, hold the alt-key. If you right-click a selected actor, you get a number of actions you can perform:
- Edit Material: Opens the specified material in the material editor for quick changes.
- Copy/Paste selected Actors: Copies the actor(s) to the clipboard. You can paste the actor to create a copy, or send the clipboard contents to someone else as plain-text, which allows them to insert the actors into their own projects, including the animation.
- Pack Model: Packs the model of the actor with its materials and textures into a zip-archive.
- Move work camera to actor: Moves the work camera to the actor's position.
- Move actor to work camera: Moves the actor to the work camera's position.
- Show model in explorer: Opens the file explorer for your operating system pointing to where the model asset file of the actor is located.
- Toggle camera link: See Camera-Actor Placement
- Retarget: Use this to retarget an actor to a different model.