gtk-d v3.1.2 (2015-04-12T17:18:07Z)

Pixbuf.this

gdkpixbuf Pixbuf Pixbuf

Create a #GdkPixbuf from a flat representation that is suitable for storing as inline data in a program. This is useful if you want to ship a program with images, but don't want to depend on any external files.

gdk-pixbuf ships with a program called [gdk-pixbuf-csource][gdk-pixbuf-csource], which allows for conversion of #GdkPixbufs into such a inline representation. In almost all cases, you should pass the --raw option to gdk-pixbuf-csource. A sample invocation would be:

|[ gdk-pixbuf-csource --raw --name=myimage_inline myimage.png ]|

For the typical case where the inline pixbuf is read-only static data, you don't need to copy the pixel data unless you intend to write to it, so you can pass %FALSE for @copy_pixels. (If you pass --rle to gdk-pixbuf-csource, a copy will be made even if @copy_pixels is %FALSE, so using this option is generally a bad idea.)

If you create a pixbuf from const inline data compiled into your program, it's probably safe to ignore errors and disable length checks, since things will always succeed: |[ pixbuf = gdk_pixbuf_new_from_inline (-1, myimage_inline, FALSE, NULL); ]|

For non-const inline data, you could get out of memory. For untrusted inline data located at runtime, you could have corrupt inline data in addition.

More...
  1. this(GdkPixbuf* gdkPixbuf, bool ownedRef)
  2. this(GdkColorspace colorspace, bool hasAlpha, int bitsPerSample, int width, int height)
  3. this(Bytes data, GdkColorspace colorspace, bool hasAlpha, int bitsPerSample, int width, int height, int rowstride)
  4. this(string data, GdkColorspace colorspace, bool hasAlpha, int bitsPerSample, int width, int height, int rowstride, GdkPixbufDestroyNotify destroyFn, void* destroyFnData)
  5. this(string filename)
  6. this(string filename, int width, int height, bool preserveAspectRatio)
  7. this(string filename, int width, int height)
  8. this(ubyte[] data, bool copyPixels)
    class Pixbuf
    this
    (
    ubyte[] data
    ,
    bool copyPixels
    )
  9. this(InputStream stream, Cancellable cancellable)
  10. this(InputStream stream, int width, int height, bool preserveAspectRatio, Cancellable cancellable)
  11. this(AsyncResultIF asyncResult)
  12. this(string[] data)

Parameters

data ubyte[]

Byte data containing a serialized #GdkPixdata structure

copyPixels bool

Whether to copy the pixel data, or use direct pointers @data for the resulting pixbuf

Return: A newly-created #GdkPixbuf structure with a reference, count of 1, or %NULL if an error occurred.

Detailed Description

Deprecated: Use #GResource instead.

Throws

GException on failure. ConstructionException GTK+ fails to create the object.

Meta

Source

See Implementation

gdkpixbuf Pixbuf Pixbuf constructorsfunctionsmixinsstatic functionsvariables

Page generated by adrdox