Method _ensure_fractional

scenedetect/common.py:453–464

Validate and convert an `fps` argument into a positive `Fraction`. NTSC-like frame rates are handled via :func:`framerate_to_fraction`.

(fps: "FrameRate | FrameTimecode")

    @staticmethod
    def _ensure_fractional(fps: "FrameRate | FrameTimecode") -> Fraction:
        """Validate and convert an `fps` argument into a positive `Fraction`. NTSC-like frame rates
        are handled via :func:`framerate_to_fraction`."""
        if isinstance(fps, FrameTimecode):
            if fps._rate is None:
                raise TypeError("FrameTimecode passed as fps must have a known rate.")
            return fps._rate
        if isinstance(fps, (float, Fraction)):
            return framerate_to_fraction(fps)
        raise TypeError(
            f"Wrong type for fps: {type(fps)} - expected float, Fraction, or FrameTimecode"
        )

    def _seconds_to_frames(self, seconds: float) -> int:
        """Convert `seconds` to the nearest number of frames using the current framerate.