方法
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 。 |