方法

GdkDmabufTextureBuilderbuild

自:4.14

声明 [src]

GdkTexture*
gdk_dmabuf_texture_builder_build (
  GdkDmabufTextureBuilder* self,
  GDestroyNotify destroy,
  gpointer data,
  GError** error
)

描述 [src]

使用builder中设置的值构建一个新的 GdkTexture

如果在builder中未设置任何必需的属性,调用此函数将会是一个编程错误。

并非所有在 drm_fourcc.h 头文件中定义的格式都受支持。您可以使用 gdk_display_get_dmabuf_formats() 获取支持格式的列表。如果格式不受 GTK 支持,将返回 NULL,并将 error 设置。

当返回的纹理被释放时,会调用 destroy 函数。

调用者负责在不再使用创建的纹理之前保持文件描述符打开,并在之后关闭它们(可能使用 destroy 通知)。

可以多次调用此函数来创建多个纹理,其间可能更改属性。

自:4.14

参数

destroy

类型: GDestroyNotify

纹理释放时要调用的销毁函数。

参数可以是 NULL
data

类型: gpointer

传递给销毁函数的用户数据。

参数可以是 NULL
数据的所有权属于该方法调用者。
错误

类型: GError **

恢复错误的重写位置。

参数可以是 NULL
如果返回位置不是NULL,则必须将其初始化为NULLGError*
如果没有错误,方法将使参数保持初始化为NULL
发生错误时,参数将设置为一个新的分配的GError;调用者将负责数据的所有权,并负责释放它。

返回值

类型: GdkTexture

一个新构建的GdkTexture或如果不支持该格式则为NULL

调用者负责接收返回的数据,并负责释放它。
返回值可以为NULL