diff --git a/doc/en/Gdk/Pixbuf.xml b/doc/en/Gdk/Pixbuf.xml index e6f5a1ee1..f056212a3 100644 --- a/doc/en/Gdk/Pixbuf.xml +++ b/doc/en/Gdk/Pixbuf.xml @@ -1176,12 +1176,33 @@ - Makes a Pixbuf from a compiled resource. - - Assembly with the resouce compiled - Name of resouce - a - Use null to reference the same assembly you are calling the contructor from. + Constructor for images 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 + The created from the resource stream + + + This method is used to construct a from an embedded resource in an assembly. + + + Typically this is used when application developers want to distribute images in a single executable. + + +If the assembly parameter is , the image will be looked up on the calling assembly. + + +For example: + + +Gdk.Pixbuf p = new Pixbuf (null, "image.jpg"); + + Compile with: + +mcs -resource:image.jpg sample.cs + + @@ -1541,7 +1562,7 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(memorystream); an array of option keys. an array of option values. a - >The and should contain key/value pairs. See for more details. Throws a if the save is not successful. + >The and should contain key/value pairs. See for more details. Throws a if the save is not successful. @@ -1557,7 +1578,7 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(memorystream); Saves to a buffer. an image type, such as png, jpeg, or ico a - Throws a if the save is not successful. + Throws a if the save is not successful. @@ -1574,7 +1595,7 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(memorystream); Save using a callback delegate. a an image type, such as png, jpeg, or ico - Throws a if the save is not successful. + Throws a if the save is not successful. @@ -1595,8 +1616,8 @@ Gdk.Pixbuf pb = new Gdk.Pixbuf(memorystream); an image type, such as png, jpeg, or ico an array of option keys an array of option values - The and should contain key/value pairs. See for more details. Throws a if the save is not successful. + The and should contain key/value pairs. See for more details. Throws a if the save is not successful. - + \ No newline at end of file diff --git a/doc/en/Gdk/Rgb.xml b/doc/en/Gdk/Rgb.xml index 4148cd182..47ac7f940 100644 --- a/doc/en/Gdk/Rgb.xml +++ b/doc/en/Gdk/Rgb.xml @@ -10,7 +10,14 @@ Gtk# is thread aware, but not thread safe; See the Gtk# Thread Programming for details. - To be added + + +Gdk's is a low-level module which renders RGB, grayscale, and indexed colormap images to a . It does this as efficiently as possible, handling issues such as colormaps, visuals, dithering, temporary buffers, and so on. Most code should use the higher-level GdkPixbuf features in place of this module; for example, gdk_pixbuf_render_to_drawable() uses GdkRGB in its implementation. + + +GdkRGB allocates a color cube to use when rendering images. You can set the threshold for installing colormaps with the Gdk. property. The default is 5x5x5 (125). If a colorcube of this size or larger can be allocated in the default colormap, then that's done. Otherwise, GdkRGB creates its own private colormap. Setting it to 0 means that it always tries to use the default colormap, and setting it to 216 means that it always creates a private one if it cannot allocate the 6x6x6 colormap in the default. If you always want a private colormap (to avoid consuming too many colormap entries for other apps, say), you can use gdk_rgb_set_install(TRUE). Setting the value greater than 216 exercises a bug in older versions of GdkRGB. Note, however, that setting it to 0 doesn't let you get away with ignoring the colormap and visual - a colormap is always created in grayscale and direct color modes, and the visual is changed in cases where a "better" visual than the default is available. + + @@ -30,29 +37,14 @@ - -

- should be the colormap for the graphics context and - drawable you're using to draw. If you're drawing to a , - call . -

-

- should have its red, green, and blue fields initialized; - this method will fill in 's pixel field with the best - matching pixel from a color cube. The color is then ready to be - used for drawing, e.g. you can call which - expects "pixel" to be initialized. -

-

- In many cases, you can avoid this whole issue by setting - or , which - do not expect "pixel" to be initialized in advance. If you use those - mutators, there's no need for calling this method. -

- - a - a - + Fetches a color to be used on the given colormap. + Tthe colormap for the graphics context and drawable you're using to draw. If you're drawing to a , use the property. + Color should have its red, green, and blue fields initialized. + This routine will fill in the pixel field with the best matching pixel from a color cube. The color is then ready to be used for drawing, e.g. you can use which expects the pixel to be initialized. + + +In many cases, you can avoid this whole issue by setting the or , which do not expect pixel to be initialized in advance. If you use those functions, there's no need for using FindColor. + @@ -63,9 +55,10 @@ - To be added - a - + Whether the visual in use by GdkRGB is dithereable. + + if the visual is ditherable. + Determines whether the visual is ditherable. This function may be useful for presenting a user interface choice to the user about which dither mode is desired; if the display is not ditherable, it may make sense to gray out or hide the corresponding UI widget. @@ -89,9 +82,9 @@ The minimum number of colors for this colormap. - a + The minimum number of colors accepted. a - + Sets the minimum number of colors for the color cube. Generally, GdkRGB tries to allocate the largest color cube it can. If it can't allocate a color cube at least as large as min_colors, it installs a private colormap. @@ -101,9 +94,9 @@ Gdk.Visual - To be added + The preferred visual for GdkRGB operations. a - + Gets a "preferred visual" chosen by GdkRGB for rendering image data on the default screen. In previous versions of GDK, this was the only visual GdkRGB could use for rendering. In current versions, it's simply the visual GdkRGB would have chosen as the optimal one in those previous versions. GdkRGB can now render to drawables with any visual. @@ -115,10 +108,13 @@ - To be added - a + Whether to install a private colormap for Gdk.RGB + If it will install a private colormap. a - + If the value is , it directs GdkRGB to always install a new "private" colormap rather than trying to find a best fit with the colors already allocated. Ordinarily, GdkRGB will install a colormap only if a sufficient cube cannot be allocated. + +A private colormap has more colors, leading to better quality display, but also leads to the dreaded "colormap flashing" effect. + @@ -128,9 +124,9 @@ Gdk.Colormap - To be added - a - + Get preferred colormap for using Gdk.RGB + The preferred . + Get the preferred colormap for rendering image data. Not a very useful function; historically, GDK could only render RGB image data to one colormap and visual, but in the current version it can render to any colormap and visual. So there's no need to call this function. diff --git a/doc/en/Gtk/AccelLabel.xml b/doc/en/Gtk/AccelLabel.xml index 3733ff35e..567f1c225 100644 --- a/doc/en/Gtk/AccelLabel.xml +++ b/doc/en/Gtk/AccelLabel.xml @@ -145,12 +145,12 @@ - Fetches the widget monitored by this acceleretaor label. + Fetches the widget monitored by this accelerator label. The widget to be monitored The object monitored by the accelerator label, or - Fetches the widget monitored by this acceleretaor label. + Fetches the widget monitored by this accelerator label.