Keyper

Output Options

Output Options

Output Options
Keyper can return the people or subject, a luminance matte, a colored representation of the matte over the background, or a colored matte with alpha channel. The matte can be inverted to return the background instead.
Matte Options

Matte Options
The matte Keyper can produce is either Full, Outline, Inline, or Core. These can be used Colored matte for graphic elements, as well as with Composite on layers with blend modes such as Lighten and Darken to produce a more realisitic composite.

Usage

Adobe Premiere and Apple Motion use

Adobe Premiere and Apple Motion use
The easiest way to use Keyper is to place a copy or clone of the desired clip on the layer above and apply Keyper to it. Then filters can be applied to the background (on the lower layer) or the people (on the upper layer).

Be certain to apply any filters that affect the look after applying Keyper as they may interfere with the ability to isolate the people or subject within the frame.

Compatibility

Keyper is compatible with Final Cut Pro, Motion, Premiere Pro and After Effects.

Parameters

Presets

Presets contain a snapshot of your effect configuration. While no built-in presets are available through this parameter, you can still save and load your own preset files.

When you save parameter configuration to a file on disk, this file can later be loaded to recreate the same effect configuration. Presets generated in one video application can be used by the same plug-in running in a different video application.

How do I use the presets popup menu?

Detect

Person / Subject / Error

Person / Subject / Error
Select which detector to use. Sometimes Person is the better choice, however Subject will detect non-human subjects. Note: Subject is only available after MacOS Sonoma. Selecting Subject on any OS prior to Sonoma will produce the above warning.

The following options are available:

  • Person — initial selection
    Use the Person detector.
  • Subject
    Use the Subject detector.

Matte

The following options are available:

  • Full — initial selection
    Full matte. (same as Keyper 1.0)
  • Outline
    Traces a line around the outside of the matte, controlled by Width and Edge.
  • Inline
    Traces a line around the inside of matte, controlled by Width and Edge.
  • Core
    Subtracts Inline from the matte to retain the Core, controlled by Width and Edge.
  • Combo
    Combines Core and Inline, controlled by Width (Edge is less useful here). Useful for filling holes in the matte.

Output

Output frame.

The following options are available:

  • Composite — initial selection
    Output detected people with alpha.
  • Matte
    Output alpha as a luminance matte.
  • Matte over background
    Matte as a color overlay. Useful for visualizing matte.
  • Colored matte
    Colored matte with alpha.

Quality

Controls resources expended to locate people in frame. This can have a considerable affect on render times. Medium is a good compromise.

The following options are available:

  • low
    Minimal resources used.
  • medium — initial selection
    Good for testing.
  • high
    Good for final render. May significantly increase render times.

PreProcess

Adjust the Sharpness, Contrast, Brightness, and Saturation of the image as well as add a LUT prior to processing. These controlls can improve person recognition. Or make it worse. Adjust carefully and set output to Matte to check your results. They have no effect on the image being composited.

Peek

Off by default.

Shows the result of PreProcess. Do not leave this checked as it will be rendered as the effect.

Use LUT

Off by default.

Load a user supplied Look Up Table to pre-process the image. This is useful for LOG footage that can have dificulty in recognition due to low contrast.

LUT

Reads a file in one of these types: from the given location.

LUT - Look Up Table used for preprocessing.

Sharpness

Set to 0% by default.

Performs a sharpening algorithm.

Contrast

Set to 0 by default. Only values between -1 and 1 are allowed.

Alters contrast.

Brightness

Set to 0 by default. Only values between -1 and 1 are allowed.

Alters brightness.

Saturation

Set to 0 by default. Only values between -1 and 1 are allowed.

Alters saturation.

Invert

Off by default.

Invert matte to return the background instead of the people found.

Thin

Set to 0 by default. Only values between 0 and 25 are allowed.

Reduce gray areas of matte.

Reduce gray areas of matte.
Helpful in combination with Thicken.

Thicken

Set to 0 by default. Only values between 0 and 25 are allowed.

Strengthen gray areas of matte.

Strengthen gray areas of matte.
Helpful in combination with Thin.

Dilate

Set to 0 by default. Only values between 0 and 10 are allowed.

Expand matte.

Expand matte.
Helpful in combination with Erode.

Erode

Set to 0 by default. Only values between 0 and 10 are allowed.

Contract Matte.

Contract Matte.
Helpful in combination with Dilate.

Width

Set to 0% by default.

Outline / Inline / Core

Outline / Inline / Core
Used with Inline, Outline, and Core to modify the matte.

Edge

Set to 0% by default.

Feather Edge.

Feather Edge.
Used with Outline, Inline, and Core to feather the matte.

Soften

Set to 0 by default. Only values between 0 and 10 are allowed.

Blur Matte.

Blur Matte.

Color

Set to
by default.
Color of Colored matte.

Strength

Set to 50% by default.

Opacity of Colored matte.

Patch

Off by default.

Enables a patch shape that can be used to augment the person detection. Use this when some portion of the person’s body like a badge or a microphone fails to be included in the mask, or when there is spurious unwanted recognition occuring (such as a background photo).

Patch Settings

Show

On by default.

Make the patch visible by highlighting it in yellow. Be sure to turn Show off before rendering as the yellow visualization will be included in the final output.

Mode

How to apply the patch.

The following options are available:

  • Add — initial selection
    Add patch to matte.
  • Remove
    Remove patch from matte.
  • Include
    Only include matte within the patch

Size

Set to 25% by default.

Size of the patch.

Roundness

Set to 100% by default.

Moves from rectangle to elipse.

Softness

Set to 0% by default.

Softness of the edge of the patch.

Aspect

Set to 1 by default. Only values between 0.1 and 3 are allowed.

Aspect ratio of the patch.

Angle

Set to 0° by default.

Value must be between -180° and 180°.

Angle of the patch.

Position

A point parameter centered in the frame by default.

Initial location in the frame
How do I adjust the location on-screen?
Manual positioning of the patch.

Track

Off by default.

Enable position tracking of the patch.

Patch Tracker

Lets you track an object in your video. To learn more about object tracking:

Tracking Objects in Video

Offset

A point parameter centered in the frame by default.

Initial location in the frame
How do I adjust the location on-screen?
Used for adjusting the position of the patch relative to the tracking area.