Package: gdk

Function gdk:dmabuf-texture-builder-build

Lambda List

gdk:dmabuf-texture-builder-build (builder)

Arguments

builder -- a gdk:dmabuf-texture-builder object

Return Value

The newly built gdk:texture object or nil if the format is not supported.

Details

Builds a new gdk:texture object with the values set up in the builder. It is a programming error to call this function if any mandatory property has not been set.

Not all formats defined in the drm_fourcc.h header are supported. You can use the gdk:display-dmabuf-formats function to get a list of supported formats. If the format is not supported by GTK, nil will be returned.

It is the responsibility of the caller to keep the file descriptors for the planes open until the created texture is no longer used, and close them afterwards (possibly using the destroy notify).

It is possible to call this function multiple times to create multiple textures, possibly with changing properties in between.

Since 4.14
 

See also

2026-02-14