构造函数

GdkPixbufPixbufnew_from_stream_at_scale

自：2.14

声明 [源]

GdkPixbuf*
gdk_pixbuf_new_from_stream_at_scale (
  GInputStream* stream,
  gint width,
  gint height,
  gboolean preserve_aspect_ratio,
  GCancellable* cancellable,
  GError** error
)

描述 [源]

通过从输入流中加载图片创建一个新的 pixbuf。

文件格式将自动检测。如果返回 NULL，则 error 将被设置。可以使用 cancellable 从另一个线程中取消操作。如果操作被取消，将返回错误 G_IO_ERROR_CANCELLED。其他可能的错误在 GDK_PIXBUF_ERROR 和 G_IO_ERROR 域。

图像将被缩放到符合请求的大小，并且可以保持图像的宽高比。

当保持宽高比时，如果 width 为 -1，则图像将被缩放为精确的高度；如果 height 为 -1，则图像将被缩放为精确的宽度。如果同时给出了 width 和 height，该函数的行为就好像这两个值中的较小值被用作 -1。

如果不保持宽高比，则 width 或 height 的 -1 表示在该维度完全不缩放图像。

未关闭流。

自：2.14

参数

stream

类型： GInputStream

用来从其中加载 pixbuf 的 GInputStream。

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

类型： gint

图像应具有的宽度或 -1 表示不限制宽度。

height

类型： gint

图像应具有的高度或 -1 表示不限制高度。

preserve_aspect_ratio

类型： gboolean

若要保留图像的宽高比。

cancellable

类型： GCancellable

可选的 GCancellable 对象，NULL 表示忽略。

此参数可以是 NULL。
数据由函数的调用者拥有。
error

类型： GError **

用于保存可恢复错误的返回位置。

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

返回值

类型： GdkPixbuf

一个新的 pixbuf。

该函数的调用者将获取数据的所有权，并负责释放它。
返回值可以是 NULL。