since: 4.16

void
gtk_graphics_offload_set_black_background (
  GtkGraphicsOffload* self,
  gboolean value
)

设置此 GtkGraphicsOffload 控件是否将绘制一个黑色背景。

这个方法的主要使用场景是 信封式字幕（letterboxing），如果内容的纵横比与监视器尺寸不匹配，则内容旁边将显示黑色边框。

使用此属性进行信封式字幕而不是 CSS 可以允许合成器以最高效率显示内容，使用直接扫描输出以避免在合成器中产生额外的复制。

在 Wayland 上，这是通过使用单像素缓冲区协议实现的。

自 4.16 起提供

设置属性	`Gtk.GraphicsOffload:black-background`

value

类型: gboolean

是否在内容后面绘制黑色背景。