构造函数

GdkPixbufPixbufnew_from_file

声明 [src]

GdkPixbuf*
gdk_pixbuf_new_from_file (
  const char* filename,
  GError** error
)

描述 [src]

通过从文件中加载图像创建一个新的pixbuf。

文件格式将自动检测。

如果返回NULL，则将设置error。可能错误包括

  • 文件无法打开
  • 没有文件格式的加载数据
  • 没有足够的内存分配图像缓冲区
  • 图像缓冲区包含无效数据

错误域是 GDK_PIXBUF_ERROR 和 G_FILE_ERROR。

参数

filename

类型： const char*

要加载的文件名，使用GLib文件名编码。

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

类型： GError **

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

该参数可以是NULL。
如果返回位置不为NULL，则必须将其初始化为NULL GError*。
如果没有错误，构造函数将保留对参数的初始化为NULL。
在出错时，参数将被设置为一个新的分配的GError；调用者将接管数据和负责释放它。

返回值

类型： GdkPixbuf

一个新的pixbuf。

函数的调用者接管数据，并负责释放它。
返回值可以是NULL。