gdk-sharp 2.12.0.0 Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. PixbufLoader is a 'passive' pixbuf loader. It's not actively read pix buf data, but 'listen' for incoming data instead. It's useful in a case where you want to read the image data in small chunks. Typical use of PixbufLoader is when you want to read a very large image data or reading image from a slow media (such as a slow network connection). You can see the "Images" section of GtkDemo to learn how to use PixbufLoader. using System; using System.IO; using Gtk; using Gdk; namespace GtkDemo { public class PixbufLoaderSample : Gtk.Window { static Gdk.PixbufLoader pixbufLoader; private uint timeout_id; private static Gtk.Image progressiveImage; private VBox vbox; BinaryReader imageStream; static void Main () { Application.Init (); new PixbufLoaderSample (); Application.Run (); } public PixbufLoaderSample () : base ("images") { this.DeleteEvent += new DeleteEventHandler (WindowDelete); this.BorderWidth = 8; vbox = new VBox (false, 8); vbox.BorderWidth = 8; this.Add (vbox); Label label = new Gtk.Label ("Progressive image loading"); label.UseMarkup = true; vbox.PackStart (label); Gtk.Frame frame = new Gtk.Frame (); frame.ShadowType = ShadowType.In; Alignment alignment = new Alignment (0.5f, 0.5f, 0f, 0f); alignment.Add (frame); vbox.PackStart (alignment, false, false, 0); // Create an empty image for now; the progressive loader // will create the pixbuf and fill it in. progressiveImage = new Gtk.Image (); frame.Add (progressiveImage); StartProgressiveLoading (); this.ShowAll (); } private void WindowDelete (object o, DeleteEventArgs args) { this.Hide (); this.Destroy (); args.RetVal = true; } private void StartProgressiveLoading () { /* This is obviously totally contrived (we slow down loading * on purpose to show how incremental loading works). * The real purpose of incremental loading is the case where * you are reading data from a slow source such as the network. * The timeout simply simulates a slow data source by inserting * pauses in the reading process. */ timeout_id = GLib.Timeout.Add (150, new GLib.TimeoutHandler (ProgressiveTimeout)); } private bool ProgressiveTimeout () { if (imageStream == null) { // note you need to provide your own image // at that location to run this sample imageStream = new BinaryReader (new StreamReader ("images/alphatest.png").BaseStream); pixbufLoader = new Gdk.PixbufLoader (); pixbufLoader.AreaPrepared += new EventHandler (ProgressivePreparedCallback); pixbufLoader.AreaUpdated += new AreaUpdatedHandler (ProgressiveUpdatedCallback); } if (imageStream.PeekChar () != -1) { byte[] bytes = imageStream.ReadBytes (256); pixbufLoader.Write (bytes, (uint) bytes.Length); return true; // leave the timeout active } else { imageStream.Close (); return false; // removes the timeout } } static void ProgressivePreparedCallback (object obj, EventArgs args) { Gdk.Pixbuf pixbuf = pixbufLoader.Pixbuf; pixbuf.Fill (0xaaaaaaff); progressiveImage.FromPixbuf = pixbuf; } static void ProgressiveUpdatedCallback (object obj, AreaUpdatedArgs args) { progressiveImage.QueueDraw (); } } } GLib.Object Method System.Boolean Parses the next count bytes of image data from buffer buf. array of bytes buffer to parse. number of bytes to parse. returns true if data was parsed and loaded succesfully. If the return value is false, the PixbufLoader will be closed. Method System.Boolean Closes the loader. returns true on successful close and false on error. During the close, PixbufLoader will parse any data that has not been parsed. If the data is incomplete or corrupted, this method will return false. Constructor Internal constructor Pointer to the C object. This is an internal constructor, and should not be used by user code. Constructor Default constructor Property Gdk.Pixbuf The Pixbuf that is being loaded. an object of type Property Gdk.PixbufAnimation To be added an object of type To be added Event System.EventHandler Emitted when the area of the PixbufLoader is prepared. GLib.Signal("area_prepared") Event Gdk.AreaUpdatedHandler Emitted when the area of the PixbufLoader is updated with data. GLib.Signal("area_updated") Event System.EventHandler Emitted when the PixbufLoader is closed. GLib.Signal("closed") Property Gdk.PixbufFormat To be added a To be added Event Gdk.SizePreparedHandler Emitted when the PixbufLoader has prepared its size. GLib.Signal("size_prepared") Method System.Void Set the size of the image that will be loaded. a a Property GLib.GType GType Property. a Returns the native value for . Method System.Void Default handler for the event. Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. a a Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. a a a a Override this method in a subclass to provide a default handler for the event. Method System.Void Default handler for the event. Override this method in a subclass to provide a default handler for the event. Constructor Protected Constructor. a Chain to this constructor if you have manually registered a native value for your subclass. System.Obsolete Method System.Boolean Parses the bytes into the image data. a a This is an overload to , which determines the length automatically. Method Gdk.PixbufLoader To be added a a To be added Constructor To be added a To be added Method Gdk.PixbufLoader Loads a pixbuf from a resource file. the name of the resource a This creates a pixbuf loader to load from a resource in the calling assembly. This is equivalent to using the constructor with a assembly. Constructor Loads a Pixbuf from a . a containing the image. See also Constructor Loads a Pixbuf from a , creating it with a specific size. a containing the image. a specifying the required width. a specifying the required height. See also Constructor Loads a Pixbuf embedded in an assembly. The that contains the image. If the value is , the image will be looked up on the calling assembly. The name given as the resource in the assembly. See also Constructor Loads a Pixbuf embedded in an assembly with a specific size. The that contains the image. If the value is , the image will be looked up on the calling assembly. The name given as the resource in the assembly. The required width of the pixbuf. The required height of the pixbuf. See also Constructor Loads a Pixbuf in a buffer. The containing the image. See also Constructor Loads a Pixbuf in a buffer with a specific size. The containing the image. The required width of the pixbuf. The required height of the pixbuf. See also Constructor To be added a a a To be added Method System.Boolean Writes a Pixbuf to a buffer. a a a This overload is obsolete and has been replaced by a ulong version for 64 bit compatibility.