构造函数

GdkPixbufPixbufnew_from_file_at_size

自2.4以来

声明 [src]

GdkPixbuf*
gdk_pixbuf_new_from_file_at_size (
  const char* filename,
  int width,
  int height,
  GError** error
)

描述 [src]

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

文件格式将自动检测。

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

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

错误域是GDK_PIXBUF_ERROR和G_FILE_ERROR。

图像将被缩放到适应请求的大小，同时保持图像的纵横比。请注意，如果纵横比要求，返回的pixbuf可能小于width x height。要加载图像并适应请求的大小，而不管纵横比如何，请使用gdk_pixbuf_new_from_file_at_scale()。

自2.4以来可用

参数

filename

类型： const char*

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

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

类型： int

图像应有的宽度，或-1以不限制宽度。

height

类型： int

图像应有的高度，或-1以不限制高度。

error

类型： GError **

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

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

返回值

类型： GdkPixbuf

一个新的pixbuf。

该函数的调用者负责拥有数据，并且负责释放它。
返回值可以是 NULL。