Viewporter

全局接口，用于暴露 surface 裁剪和缩放功能，可为 wl_surface 对象实例化一个接口扩展。该扩展接口允许裁剪和缩放 surface 内容，从而断开缓冲区与 surface 尺寸之间的直接关联。

wl_surface 对象的附加接口，允许客户端指定 surface 内容的裁剪和缩放。

此接口涉及两个概念：源矩形（src_x, src_y, src_width, src_height）和目标尺寸（dst_width, dst_height）。源矩形的内容被缩放到目标尺寸，源矩形之外的内容将被忽略。此状态是双缓冲的，参见 wl_surface.commit。

裁剪和缩放状态的两个部分是独立的：源矩形和目标尺寸。初始状态下两者均未设置，即不应用任何缩放。当前 wl_buffer 的全部内容用作源，surface 尺寸由 wl_surface.attach 定义。

如果设置了目标尺寸，它将使 surface 尺寸变为 dst_width, dst_height。源（矩形）被精确地缩放到此尺寸。这会覆盖已附加的 wl_buffer 的尺寸，除非 wl_buffer 为 NULL。如果 wl_buffer 为 NULL，surface 没有内容因此没有尺寸。否则，尺寸在 surface 本地坐标中始终至少为 1x1。

如果设置了源矩形，它定义了从 wl_buffer 中取出作为源的区域。如果设置了源矩形但未设置目标尺寸，则 src_width 和 src_height 必须为整数，且 surface 尺寸变为源矩形的尺寸。这将实现裁剪而不缩放。如果 src_width 或 src_height 不是整数且未设置目标尺寸，则在应用 surface 状态时将触发 bad_size 协议错误。

从缓冲区像素坐标到 surface 本地坐标的转换按以下顺序进行： 1. buffer_transform（wl_surface.set_buffer_transform） 2. buffer_scale（wl_surface.set_buffer_scale） 3. 裁剪和缩放（wp_viewport.set*） 这意味着裁剪和缩放的源矩形坐标是在缓冲区变换和缩放之后的坐标中给出的，即在未应用裁剪和缩放时将作为 surface 本地坐标的坐标。

如果 src_x 或 src_y 为负数，将触发 bad_value 协议错误。否则，如果源矩形部分或完全位于非 NULL 的 wl_buffer 之外，则在应用 surface 状态时将触发 out_of_buffer 协议错误。NULL 的 wl_buffer 不会触发 out_of_buffer 错误。

如果与 wp_viewport 关联的 wl_surface 被销毁，除 'destroy' 之外的所有 wp_viewport 请求都会触发 no_surface 协议错误。

如果 wp_viewport 对象被销毁，裁剪和缩放状态将从 wl_surface 中移除。该更改将在下次 wl_surface.commit 时应用。