从 Python¶

def __init__(
    self,
    video: str | os.PathLike[str] | None = None,
    *,
    frames: FrameSink | None = None,
    plays: PlayHook | None = None,
    take: Take | None = None,
    preset: X264Preset = DEFAULT_ENCODER_PRESET,
    crf: float = DEFAULT_ENCODER_CRF,
) -> None:
    if preset not in get_args(X264Preset):
        raise ValueError(f"unknown x264 preset {preset!r}")
    if not 0 <= crf <= 51:
        raise ValueError(
            f"x264 CRF must be a finite number from 0 to 51, not {crf}"
        )
    fps = config.frame_rate
    if video is not None and fps != int(fps):
        raise ValueError(
            f"a video needs a whole number of frames per second, not {fps}"
        )
    width, height = config.pixel_width, config.pixel_height
    if video is not None and (width % 2 or height % 2):  # H.264's 4:2:0 halves both
        raise ValueError(
            f"a video needs an even width and height, not {width}x{height}"
        )
    self.fps = clock.rational(fps)
    """影片每秒的帧数：影片开始时配置所定的值。"""
    # the GPU draws the film; or its take is recorded, to be drawn by ManimGX's player: by
    # choice, or where the engine has no GPU (in Pyodide)
    self._player: _engine.Player | None = None
    self._recorder: _engine.Recorder | None = None
    drawn: _engine.Player | _engine.Recorder
    if take is None and (gpu := feed.Player) is not None:
        if video is not None or frames is not None:
            _engine.start_gpu()  # the film draws: the GPU comes up as it begins
        self._player = drawn = gpu(width, height)
        if video is not None:
            drawn.begin_export(
                os.fspath(video), fps=int(fps), preset=preset, crf=crf
            )
    elif video is None and frames is None:
        self._recorder = drawn = _engine.Recorder(width, height, fps)
    else:
        raise ValueError(
            "a film recorded as a take is drawn by ManimGX's player, not here: it"
            " has no video or pixels"
            + ("" if feed.Player else " (this Python has no GPU)")
        )
    self._take = take
    self.feeder = Feeder(width, height, drawn)
    self.video = None if video is None else os.fspath(video)
    """正在写入的视频路径；写入完成后为 None，若无视频
    则始终为 None。"""
    self.frames = frames
    """每个已绘制的帧被交予的函数，若有。"""
    self.frame_count = 0
    """影片迄今为止的帧数，保持帧按其持续的帧数计入。"""
    self.plays: list[Play] = []
    """场景已运行的播放与等待，按顺序排列：每个为一个
    [`Play`][manimgx.rendering.film.Play]。"""
    self.sections: list[Section] = [
        Section("unnamed", Fraction(0), 0, "default.normal", "")
    ]
    """影片的分段，按顺序排列：每个为一个 [`Section`][manimgx.rendering.film.Section]，
    持续到下一分段开始。第一个分段随影片开始。"""
    self.subcaptions: list[Caption] = []
    """场景添加的字幕（见
    [`add_subcaption`][manimgx.Scene.add_subcaption]）；[`captions`]
    [manimgx.Film.captions] 会并入其语音产生的字幕。"""
    self.clips: list[Clip] = []
    """场景放置的声音，按放置顺序排列：每个为一个
    [`Clip`][manimgx.audio.sound.Clip]，自其在场景时间中的起点计。"""
    self.export: Export | None = None
    """视频的制作情况，视频写入完成后为一个
    [`Export`][manimgx.rendering.film.Export]；在此之前以及无视频时为 None。"""
    self._hook = plays
    self._pending: tuple[bytes, bytes, list[CameraView], int] | None = (
        None  # sent once it ends
    )
    self._first = 0  # the index of the pending frame
    self._key = False  # the next frame begins a section: a keyframe of its own
    self._pending_key = False  # the pending frame is one

def __init__(self, title: str = "ManimGX", *, time: float = 0.0) -> None:
    self._process = subprocess.Popen(
        [
            sys.executable,
            "-c",
            "from manimgx.rendering.window import _main; _main()",
        ]
        + [title, repr(float(time))],
        stdin=subprocess.PIPE,
        stdout=subprocess.PIPE,
    )
    self._asked: queue.Queue[str] = queue.Queue()
    self.failure: str | None = None
    """窗口失败的原因（若失败）：无可打开的屏幕、无 GPU 等：此时窗口已关闭。"""
    self._listening = threading.Thread(target=self._listen, daemon=True)
    self._listening.start()

def __init__(
    self, index: int, repeat: int, draw: Callable[[], bytes], key: bool = False
) -> None:
    self.index = index
    """它在影片中的位置：它作为首帧显示时的帧号，从
    0 起计。"""
    self.repeat = repeat
    """它显示的帧数：大于 1 表示一次保持。"""
    self.key = key
    """它是否开启影片的一个 [分段][manimgx.rendering.film.Section]：其前一分段
    结束时所停留的画面。"""
    self._draw = draw