Material

IMPORTANT: Creating custom materials is considered experimental and requires to enable "Developer Mode". The new experimental material editor will be improved in the coming versions.

Overview

Each renderer has an associated material defining properties for this renderer:
Feature set overview
Billboard_Transparent material applied to a billboard renderer

The PopcornFX SDK does not take care of rendering particles, but does provide referencies to the associated material.
The rendering is managed by the plugins (UnrealEngine, Unity, …​) or by integrations.

Materials ?

Materials are regular assets contained in the PopcornFX project, with the ".pkma" extension:
Feature set
The following materials are available in all projects (amongst others):

  • Billboard_Transparent.pkma

  • Ribbon_Transparent.pkma

  • Default_Mesh.pkma

  • Mesh_Opaque.pkma

  • Sound_Default.pkma

Rendering features ?

Rendering features are a set of properties of a material that define high level options.
Here are a some example rendering features which could be available in a material:

  • “Lit” - Particles rendered by this renderer are lit by engine lights

  • “Soft particles” - Particles rendered by this renderer require depth distance fade

  • “Transparent” - Particles are either additive, alpha blended or premultiplied alpha

We designed rendering features to be modular and cross-engine.

Note: PopcornFX is designed to be compatible with all game engines, so we limit the list of default rendering features to a set supported on all engine integrations we develop. Nothing stops a production to design custom rendering features, but it will break rendering compatibility with other game engines (and could prevent selling engine-agnostic content on a marketplace).

See rendering interface for more detail.

Renderer, Material, Rendering features

By default, all renderers select their default material (ie. Billboard_Transparent.pkma for a billboard renderer):
Feature set

  1. Renderer specific properties

  2. Renderer features can be enabled/disabled

  3. Material file

  4. “Transparent” renderer feature is a “mandatory feature” in Billboard_Transparent.pkma, its properties are always displayed

  5. “Diffuse” renderer feature is a “mandatory feature” in Billboard_Transparent.pkma, its properties are always displayed

  6. “Atlas” renderer has been enabled in section #2, so its properties are displayed

  7. Renderer feature properties can add pins to renderers

Changing a renderer’s material changes the list of available rendering properties. Sections appear when rendering properties are enabled:
Feature set

  1. Alpha remap properties appears when the feature is enabled

  2. Atlas properties appears when the feature is enabled

  3. Soft particle properties appear when the feature is enabled

  4. Different material selected changes the list of properties available for the renderer

Various rendering examples are available in the tutorials effect pack.

Materials / shaders

As renderer features are high level parameters and not shaders/material graphs, you might wonder how those renderer features are plugged in the final material/shader. Each PopcornFX integration handles that by remapping renderer features and their properties to the game engine material system.
UE billboard material:
Feature set

  1. Diffuse texture, retrieved in the material via a Texture2D parameter named “DiffuseTexture”

  2. Particle color, retrieved using the “VertexColor” node

  3. Having an atlas provides the correct sub-UVs in the Texcoord node, ready for sampling.

  4. Linear atlas blending is enabled, another set of UVs is filled for the material

  5. Static switch set from c++ when linear atlas blending is enabled

  6. Lerp cursor is passed into DynamicParameter.x

Another example with a mesh material in UE:
Feature set

  1. Specular texture, retrieved in the material via a Texture2D parameter “SpecularTexture”

  2. Normal texture, retrieved in the material via a Texture2D parameter “NormalTexture”

  3. Static switch set from c++ when a valid specular map is available

  4. Static switch set from c++ when a valid normal map is available

Editor shaders

PopcornFX Editor does not have a material graph editor, but supports an HLSL-like editor:
Feature set
The vertex and fragment shaders of a material can be edited in that editor (see Material editor).

Note: That shader code is editor only, it is not exported to plugins or custom game engines.