构造函数

GdkTexturenew_from_filename

自4.6版起

声明 [src]

GdkTexture*
gdk_texture_new_from_filename (
  const char* path,
  GError** error
)

描述 [src]

通过从文件加载数字创建一个新纹理。

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

如果返回NULL,则error将被设置。

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

自4.6版起可用

参数

路径

类型: const char*

要加载的文件名。

数据由函数的调用者拥有。
该值是一个平台原生的字符串,在Unix上使用首选的操作系统编码,在Windows上使用UTF-8。
错误

类型: GError **

恢复错误的返回位置。

该参数可以为NULL。
如果返回位置不是NULL,则必须将其初始化为NULL GError*。
如果没有错误,构造函数将留初始化为NULL。
在出现错误的情况下,该参数将被设置为一个新的GError分配;调用者将拥有数据,并负责释放它。

返回值

类型: GdkTexture

一个新创建的GdkTexture。

函数的调用者将对数据进行处理,并负责释放它。