相机¶

def auto_zoom(
    self,
    mobjects: Iterable[Mobject],
    margin: float = 0,
    animate: bool = True,
) -> Animate[Mobject] | Mobject:
    """在二维中将视图适配到一组 mobject 周围：将帧居中于其上，
    并调整尺寸以容纳它们。

    帧保持其比例：其宽度适配 mobject，或其高度适配 mobject，
    取两者中填充较多的一个，并加上 `margin`。

    Args:
        mobjects: 要适配的 mobject，帧本身被排除在外；至少须有一个
            保留（否则抛出 ValueError）。
        margin: 视图比 mobject 多出的宽度（或高度），以场景单位表示。
        animate: 是否返回帧的动画以供播放，而非立即适配。

    Returns:
        该动画，以供播放；当 `animate` 为 False 时，返回适配后的帧。
    """
    mobs = [m for m in mobjects if m is not self.frame]
    if not mobs:
        raise ValueError(
            "Could not determine bounding box of the mobjects given to 'auto_zoom'."
        )
    left, right = (
        min(m.get_critical_point(LEFT)[0] for m in mobs),
        max(m.get_critical_point(RIGHT)[0] for m in mobs),
    )
    up, down = (
        max(m.get_critical_point(UP)[1] for m in mobs),
        min(m.get_critical_point(DOWN)[1] for m in mobs),
    )
    target = (
        (self.frame.animate if animate else self.frame)
        .set_x((left + right) / 2)
        .set_y((up + down) / 2)
    )
    if (right - left) / self.frame.width > (up - down) / self.frame.height:
        return target.set(width=right - left + margin)
    return target.set(height=up - down + margin)

def add_fixed_in_frame_mobjects(self, *mobjects: Mobject) -> None:
    """将 mobject 固定到屏幕上：每个按其点所在位置绘制，如同在以原点为中心的
    二维视图中，绘制在一切之上。

    无论相机的角度、缩放与中心如何，它们都保持在屏幕上的位置：用
    `to_corner` 放置的标题停留在其角落。其中的一切现在及以后都被固定：
    之后添加的成员（一个数字的新数位、更新器或 Transform 产生的部分）也
    被固定。

    Args:
        *mobjects: 要固定的 mobject，连同其家族。
    """
    self._fixed_in_frame.update(dict.fromkeys(mobjects))

def get_phi(self) -> float:
    """相机视线与 z 轴之间的夹角。

    Returns:
        该角度，以弧度表示。
    """
    return self.phi_tracker.get_value()

def get_theta(self) -> float:
    """相机绕 z 轴的角度，从 x 轴逆时针方向计量。

    Returns:
        该角度，以弧度表示。
    """
    return self.theta_tracker.get_value()

def get_gamma(self) -> float:
    """相机绕自身视线转动的角度。

    Returns:
        该角度，以弧度表示。
    """
    return self.gamma_tracker.get_value()

def get_zoom(self) -> float:
    """相机的放大倍数。

    Returns:
        zoom：1 表示无放大。
    """
    return self.zoom_tracker.get_value()

def get_focal_distance(self) -> float:
    """相机与其帧中心的距离。

    Returns:
        该距离，以场景单位表示。
    """
    return self.focal_distance_tracker.get_value()

def set_phi(self, value: float) -> None:
    """立即设置相机视线与 z 轴之间的夹角。

    Args:
        value: 该角度，以弧度表示：0 表示从正上方俯视 xy 平面。
    """
    self.phi_tracker.set_value(value)

def set_theta(self, value: float) -> None:
    """立即设置相机绕 z 轴的角度。

    Args:
        value: 该角度，以弧度表示，从 x 轴逆时针方向计量。
    """
    self.theta_tracker.set_value(value)

def set_gamma(self, value: float) -> None:
    """立即设置相机绕自身视线转动的角度。

    Args:
        value: 该角度，以弧度表示。
    """
    self.gamma_tracker.set_value(value)