Skip to main content

Actors

 

 

pfm_actor_editor.pngActors in PFM are entities (i.e. game objects) that are part of your animation, not including map entities or other entities that exist independently of your project. An actor can be anything from a camera to a light source, prop or particle system. An articulated actor is an actor with a skeletal rig or morph targets (i.e. flexes/flex controllers).

In the PFM interface you can find a list of all actors in the currently selected film clip in the actor editor window.

 

 

Components

Contrary to SFM, there are no concrete actor types in PFM. Instead, every actor has a list of components associated with it which describe/define the behavior/function of that actor. For instance, if you create a camera in SFM, that actor is a camera entity. If you create a camera in PFM, that actor is an entity with a camera component. The key difference is that components in PFM can be freely added or removed to/from an actor. Example:

You create an actor X and add a camera component to it, which turns that actor into a camera. If you add another component to actor X, for instance a light source component, then actor X is both a camera and a light source at the same time. If you then remove the camera component from the actor, it ceases to be a camera, but remains to be a light source.

This allows you to flexibly change the behavior of an actor. Another example: Let's say you

You can also create custom components with Lua, and then add those components to your actors! Custom components can also add new animatable properties.

Components allow you to change the function and behavior of an actor.

You can find a list of components an actor has in the "Actor Editor":

actor_components.png

To avoid cluttering the interface, not all of the actor's components are listed by default, and some may be hidden. Right-click on "Components" and choose "Add Component" to see which ones are hidden. By clicking one of the components it will be added to the interface (along with its properties, if it has any). You should only do this if you intend to modify the properties of one of the components.

actor_add_component.png

The option "Create new Component" allows you to add an entirely new component to the actor:

actor_create_new_component.png

This list includes all components known by the engine, many of which may not be suited for use in PFM!

You can also create entirely new components with Lua, which will also appear in this list.

If you select one or more components from the actor component list, you will get a set of properties on the right-hand side of the editor:

pragma_2021-09-23_16-19-05.png

Most of these properties can be animated (with the exception of strings and a few other types).

Creating an actor

 

Creating custom components

 

Creating editable properties

 

 

 

Components allow you to change the function and behavior of an actor dynamically. Anther example: You can create an articulated actor and add a retarget component to it, allowing you to retarget the actor to a different model, while keeping the animation intact.