User Interface

Here you can find a list of articles describing the individual windows in PFM and how to use them.

Overview

initial_view.png

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:

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:

Menu Bar

menu_bar2.png

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.

 

Keybinds

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.

Action Default Key
Toggle Play space
Previous Frame ,
Next Frame .
Previous Bookmark [
Next Bookmark ]
Create Bookmark m
Clip Editor F2
Motion Editor F3
Graph Editor F4
Quick-Move X Axis x
Quick-Move Y Axis y
Quick-Move Z Axis z
Undo Ctrl+Z
Redo Ctrl+Y
Select q
Translate t
Rotate r
Scale s
Save Project Ctrl +S

 

Viewport

The viewport window provides a real-time preview of your scene which you can interact with to select actors, move them around, etc.

Movement

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.

Viewport Modes

Select selection_tool.png

Keyboard shortcut: Q

While in 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:

actor_right_click_menu2.png

Move translation_tool.png