警告

这个模块在pyGame 2.0及以上版本中是不起作用的，除非您已经用SDL1手动编译了pyGame。以后将不再支持此模块。

pygame.Overlay

pygame object for video overlay graphics

Overlay(format, (width, height)) -> Overlay

pygame.Overlay.display	—	set the overlay pixel data
pygame.Overlay.set_location	—	control where the overlay is displayed
pygame.Overlay.get_hardware	—	test if the Overlay is hardware accelerated

覆盖对象为访问硬件视频覆盖提供支持。视频覆盖不使用标准 RGB 像素格式，并且可以使用多种分辨率的数据来创建单个图像。

覆盖对象表示对显示硬件的较低级别访问。要使用该对象，您必须了解视频覆盖的技术细节。

覆盖格式确定所使用的像素数据的类型。并非所有硬件都支持所有类型的覆盖格式。以下是可用格式类型的列表：

YV12_OVERLAY, IYUV_OVERLAY, YUY2_OVERLAY, UYVY_OVERLAY, YVYU_OVERLAY

Width和Height参数控制覆盖图像数据的大小。覆盖图像可以以任何大小显示，而不仅仅是覆盖图像的分辨率。

覆盖对象始终可见，并且始终显示在常规显示内容的上方。

display()

set the overlay pixel data

display((y, u, v)) -> None

display() -> None

在SDL的覆盖平面中显示YUV数据。Y、u和v参数是二进制数据字符串。数据必须采用用于创建覆盖的正确格式。

如果没有传入任何参数，则只会使用当前数据重新绘制覆盖图。当覆盖不是真正的硬件加速时，这会很有用。

字符串未经过验证，大小不正确的字符串可能会使程序崩溃。

set_location()

control where the overlay is displayed

set_location(rect) -> None

设置覆盖的位置。覆盖将始终相对于主显示表面显示。这实际上不会重新绘制覆盖图，它将在下一次调用 Overlay.display() 。

get_hardware()

test if the Overlay is hardware accelerated

get_hardware(rect) -> int

当覆盖是硬件加速时，返回True值。如果平台不支持加速，则使用软件渲染。

---

Edit on GitHub