Mask Property Group¶

MaskPropertyGroup ¶

Bases: PropertyGroup

An individual mask applied to a layer.

The MaskPropertyGroup object encapsulates mask attributes in a layer.

Info

MaskPropertyGroup is a subclass of PropertyGroup object. All methods and attributes of PropertyBase object and PropertyGroup, in addition to those listed below, are available when working with MaskPropertyGroup.

Example

from py_aep import parse

app = parse("project.aep")
comp = app.project.compositions[0]
layer = comp.layers[0]
mask = layer.masks[0]
print(mask.inverted)

See: https://ae-scripting.docsforadobe.dev/property/maskpropertygroup/

Attributes¶

active ¶

active: bool

Same as enabled.

auto_name ¶

auto_name: str

The automatic (display) name derived from match_name.

can_set_enabled ¶

can_set_enabled: bool

True if the enabled attribute value can be set.

This is True for all layers, effect property groups, shape vector groups, and text path options. Read-only.

color ¶

color = ChunkField[List[float]](
    "_mkif",
    "color",
    transform=normalize_values,
    reverse_seq_field=denormalize_values,
    validate=validate_sequence(length=3, min=0.0, max=1.0),
)

The color used to draw the mask outline as it appears in the user interface (Composition panel, Layer panel, and Timeline panel). The three array values specify the red, green, and blue components of the color. Read / Write.

elided ¶

elided: bool

When True, the property is not shown in the UI. An elided property is still present in the timeline but hidden from view. Read-only.

enabled ¶

enabled = bool('_tdsb', 'enabled', default=True)

Corresponds to the setting of the eyeball icon. Read / Write.

inverted ¶

inverted = bool('_mkif', 'inverted')

When True, the mask is inverted. Read / Write.

is_effect ¶

is_effect: bool

When True, this property is an effect PropertyGroup. Read-only.

is_mask ¶

is_mask: bool

When True, this property is a mask PropertyGroup. Read-only.

is_modified ¶

is_modified: bool

True if any child property is modified.

For indexed groups (such as Effects or Masks parades), the group is considered modified when it has any children - adding items to an indexed group is itself a modification. Shape vector groups (Contents) follow the same rule.

is_name_set ¶

is_name_set: bool

True if the name has been explicitly set by the user. Read-only.

locked ¶

locked = bool('_mkif', 'locked')

When True, the mask is locked and cannot be edited in the user interface. Read / Write.

mask_feather_falloff ¶

mask_feather_falloff = enum(
    MaskFeatherFalloff, "_mkif", "mask_feather_falloff"
)

The feather falloff mode for the mask. Applies to all feather values for the mask. Read / Write.

mask_mode ¶

mask_mode = enum(MaskMode, '_mkif', 'mode')

The blending mode for the mask. Controls how the mask interacts with other masks and with the layer below. Read / Write.

mask_motion_blur ¶

mask_motion_blur = enum(
    MaskMotionBlur, "_mkif", "mask_motion_blur"
)

How motion blur is applied to this mask. Read / Write.

match_name ¶

match_name: str

A special name for the property used to build unique naming paths. The match name is not displayed, but you can refer to it in scripts. Every property has a unique match-name identifier. Read-only.

name ¶

name: str

Display name of the property. Read / Write.

num_properties ¶

num_properties: int

The number of child properties in this group.

Equivalent to ExtendScript PropertyGroup.numProperties.

parent_property ¶

parent_property: PropertyGroup | None

The parent PropertyGroup of this property, or None for top-level layer property groups. Read-only.

properties ¶

properties: list[Property | PropertyGroup] = properties

List of properties in this group. Read-only.

property_depth ¶

property_depth: int

The number of levels of parent groups between this property and the containing layer. The value is 0 for a layer. Read-only.

property_index ¶

property_index: int | None

The 0-based position of this property within its parent group.

Returns None for layers (property depth 0).

Warning

Unlike ExtendScript (1-based), this uses Python's 0-based convention so that group.properties[prop.property_index] works directly.

Read-only.

property_type ¶

property_type: PropertyType

The type of this property. One of PropertyType.PROPERTY, PropertyType.NAMED_GROUP, or PropertyType.INDEXED_GROUP. Read-only.

roto_bezier ¶

roto_bezier = bool(
    "_mask_shape_tdsb", "roto_bezier", default=False
)

When True, the mask uses RotoBezier, enabling curved mask segments without direction handles. Read / Write.

selected ¶

selected: bool

When True, the property is selected. Read / Write.

Functions¶

property ¶

property(key: int | str) -> Property | PropertyGroup

Look up a child property by index or name.

Mirrors ExtendScript PropertyGroup.property(indexOrName). Delegates to __getitem__.

Parameters:

key (int | str) –

An int index or a str display name / match name.