AV Item

AVItem ¶

AVItem(
    comment: str,
    id: int,
    label: Label,
    name: str,
    parent_folder: FolderItem | None,
    type_name: str,
    duration: float,
    frame_duration: int,
    frame_rate: float,
    height: int,
    pixel_aspect: float,
    width: int,
)

Bases: Item

The AVItem object provides access to attributes and methods of audio/visual files imported into After Effects.

Info

AVItem is a subclass of Item. All methods and attributes of Item are available when working with AVItem.

Info

AVItem is the base class for both CompItem and FootageItem, so AVItem attributes and methods are also available when working with CompItem and FootageItem objects. See CompItem object and FootageItem object.

See: https://ae-scripting.docsforadobe.dev/item/avitem/

Attributes¶

comment ¶

comment: str

The item comment.

duration ¶

duration: float

The duration of the item in seconds. Still footages have a duration of 0.

footage_missing ¶

footage_missing: bool

When True, the AVItem is a placeholder, or represents footage with a source file that cannot be found. In this case, the path of the missing source file is in the missing_footage_path attribute of the footage item's source-file object. See FootageItem.main_source and FileSource.missing_footage_path.

frame_duration ¶

frame_duration: int

The duration of the item in frames. Still footages have a duration of 0.

frame_rate ¶

frame_rate: float

The frame rate of the item in frames-per-second.

height ¶

height: int

The height of the item in pixels.

id ¶

id: int

The item unique identifier.

is_composition ¶

is_composition: bool

True if the item is a composition.

is_folder ¶

is_folder: bool

True if the item is a folder.

is_footage ¶

is_footage: bool

True if the item is a footage.

label ¶

label: Label

The label color. Colors are represented by their number (0 for None, or 1 to 16 for one of the preset colors in the Labels preferences).

name ¶

name: str

The name of the item, as shown in the Project panel.

parent_folder ¶

parent_folder: FolderItem | None = field(repr=False)

The parent folder of this item. None for the root folder.

pixel_aspect ¶

pixel_aspect: float

The pixel aspect ratio of the item (1.0 is square).

type_name ¶

type_name: str

A user-readable name for the item type ("Folder", "Footage" or "Composition"). These names are application locale-dependent, meaning that they are different depending on the application's UI language.

used_in ¶

used_in: list[CompItem]

All the compositions that use this AVItem.

width ¶

width: int

The width of the item in pixels.