构造函数

声明 [源]

GdkTexture*
gdk_texture_new_from_file (
  GFile* file,
  GError** error
)

说明 [源]

通过从文件加载图像来创建一个新纹理。

自动检测文件格式。支持的格式有PNG、JPEG和TIFF,尽管可能还有更多格式。

如果返回NULL,则表示设置错误。

此函数是线程安全的,因此例如可以使用GTask和g_task_run_in_thread()在加载大图像时避免阻塞主线程。

参数

file

类型: GFile

要加载的GFile

数据由函数的调用者拥有。
error

类型: GError **

一个可恢复错误的返回位置。

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

返回值

类型: GdkTexture

一个新的GdkTexture

函数调用者拥有数据,并负责释放它。