[TOC] # **pygame.Overlay** Pygame 中用于視頻疊加圖形的 pygame 對象。 Overlay(format, (width, height)) -> Overlay ## **方法** * pygame.Overlay.display — 設置覆蓋像素數據 * pygame.Overlay.set\_location — 控制顯示的地方 * pygame.Overlay.get\_hardware — 測試是否支持硬件加速 Overlay 對象對使用硬件視頻覆蓋提供支持。視頻覆蓋不使用標準 RGB 像素格式，并且可以使用多個分辨率的數據來創建一個圖像。 Overlay 對象使用硬件級別的“低級”訪問，所以使用這個對象你必須理解視頻覆蓋的技術細節。 覆蓋的格式決定了使用的像素數據類型。并不是所有的硬件都支持所有類型的覆蓋格式。以下是可用的格式類型列表： > YV12\_OVERLAY, IYUV\_OVERLAY, YUV2\_OVERLAY, UYVY\_OVERLAY, YVYU\_OVERLAY 寬度和高度參數控制覆蓋圖像的大小。覆蓋的圖像大小可任意調整，不僅是覆蓋圖像的原分辨率。覆蓋對象總是可見的，并且總是顯示在原圖像上方顯示。 ## **方法詳解** ### **display()** 設置覆蓋像素。 display((y, u, v)) -> None display() -> None 顯示 SDL 的覆蓋平面的 YUV 數據。，y、u 和 v 參數都是二進制字符串數據，需使用正確格式的數據以創建覆蓋圖像。 如果沒有參數傳入，覆蓋的圖像僅是當前數據的重新繪制。當覆蓋不支持硬件加速，這可能是很有用的。 如果不是合法、可用的字符串數據，將導致崩潰。 ### **set\_location()** 設置覆蓋圖像的顯示位置。 set\_location(rect) -> None 設置覆蓋圖圖像的位置，覆蓋的圖像總是顯示在原圖像的上面，調用此方法并沒有立即重繪圖像，它將在下一次調用 display() 方法時重新繪制。 ### **get\_hardware()** 測試覆蓋是否支持硬件加速。 get\_hardware(rect) -> int 如果支持硬件加速返回 true，若不支持則會使用軟件渲染。