stubs ¶

def apply(self: SelfPropEnum, clip: vs.VideoNode) -> vs.VideoNode:
    """Applies the property to the VideoNode."""

    return clip.std.SetFrameProp(self.prop_key, self.value)

@classmethod
def ensure_presence(
    cls: type[SelfPropEnum], clip: vs.VideoNode, value: int | SelfPropEnum | None, func: FuncExceptT | None = None
) -> vs.VideoNode:
    """Ensure the presence of the property in the VideoNode."""

    enum_value = cls.from_param_or_video(value, clip, True, func)

    return clip.std.SetFrameProp(enum_value.prop_key, enum_value.value)

@staticmethod
def ensure_presences(
    clip: vs.VideoNode, prop_enums: Iterable[type[SelfPropEnum] | SelfPropEnum], func: FuncExceptT | None = None
) -> vs.VideoNode:
    """Ensure the presence of multiple PropEnums at once."""

    return clip.std.SetFrameProps(**{
        value.prop_key: value.value  # type: ignore
        for value in [
            cls if isinstance(cls, PropEnum) else cls.from_video(clip, True)
            for cls in prop_enums
        ]
    })

@classmethod
def from_param(cls: Any, value: Any, func_except: Any = None) -> SelfPropEnum | None:
    """Get the enum member from its int representation."""

@classmethod
def from_param_or_video(
    cls: type[SelfPropEnum], value: Any,
    src: vs.VideoNode | vs.VideoFrame | vs.FrameProps,
    strict: bool = False, func_except: FuncExceptT | None = None
) -> SelfPropEnum:
    """
    Get the enum member from a value that can be casted to this prop value
    or grab it from frame properties.

    If `strict=False`, gather the heuristics using the clip's size or format.

    :param value:           Value to cast.
    :param src:             Clip to get prop from.
    :param strict:          Be strict about the frame properties. Default: False.
    :param func_except:     Function returned for custom error handling.
    """
    value = cls.from_param(value, func_except)

    if value is not None:
        return value  # type: ignore

    return cls.from_video(src, strict, func_except)

@classmethod
def from_res(cls: type[SelfPropEnum], frame: vs.VideoNode | vs.VideoFrame) -> SelfPropEnum:
    """Get an enum member from the video resolution with heuristics."""

    raise NotImplementedError

@classmethod
def from_video(
    cls: type[SelfPropEnum], src: vs.VideoNode | vs.VideoFrame | vs.FrameProps, strict: bool = False,
    func: FuncExceptT | None = None
) -> SelfPropEnum:
    """Get an enum member from the frame properties or optionally fall back to resolution when strict=False."""

    raise NotImplementedError

@classmethod
def is_unknown(cls: type[SelfPropEnum], value: int | SelfPropEnum) -> bool:
    """Whether the value represents an unknown value."""

    return False

@classmethod
def is_valid(cls, value: int) -> bool:
    """Check if the given value is a valid int value of this enum."""
    return int(value) in map(int, cls.__members__.values())

@classproperty
def prop_key(cls: type[SelfPropEnum]) -> str:  # type: ignore
    """The key used in props to store the enum."""

    return f'_{cls.__name__}'