方法
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,则必须将其初始化为NULL的GError*。如果没有错误,方法将使参数保持初始化为 NULL。发生错误时,参数将设置为一个新的分配的 GError;调用者将负责数据的所有权,并负责释放它。
返回值
类型: GdkTexture
一个新构建的GdkTexture或如果不支持该格式则为NULL。
| 调用者负责接收返回的数据,并负责释放它。 |
返回值可以为NULL。 |