1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297
|
<Type Name="Rgb" FullName="Gdk.Rgb">
<TypeSignature Language="C#" Value="public class Rgb" Maintainer="auto" />
<TypeSignature Language="ILAsm" Value=".class public auto ansi beforefieldinit Rgb extends System.Object" />
<AssemblyInfo>
<AssemblyName>gdk-sharp</AssemblyName>
<AssemblyPublicKey>
</AssemblyPublicKey>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ThreadSafetyStatement>Gtk# is thread aware, but not thread safe; See the <link location="node:gtk-sharp/programming/threads">Gtk# Thread Programming</link> for details.</ThreadSafetyStatement>
<Base>
<BaseTypeName>System.Object</BaseTypeName>
</Base>
<Interfaces />
<Docs>
<summary>
<para>
Gdk's <see cref="T:Gdk.Rgb" /> is a low-level module which renders RGB, grayscale, and indexed colormap images to a <see cref="T:Gdk.Drawable" />. 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.
</para>
<para>
GdkRGB allocates a color cube to use when rendering images. You can set the threshold for installing colormaps with the Gdk.<see cref="M:Gdk.Rgb.MinColors" /> 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.
</para>
</summary>
<remarks />
</Docs>
<Members>
<Member MemberName=".ctor">
<MemberSignature Language="C#" Value="public Rgb ();" />
<MemberSignature Language="ILAsm" Value=".method public hidebysig specialname rtspecialname instance void .ctor() cil managed" />
<MemberType>Constructor</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue />
<Parameters />
<Docs>
<summary>Basic constructor.</summary>
<remarks />
</Docs>
</Member>
<Member MemberName="Colormap">
<MemberSignature Language="C#" Value="public static Gdk.Colormap Colormap { get; }" />
<MemberSignature Language="ILAsm" Value=".property class Gdk.Colormap Colormap" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Gdk.Colormap</ReturnType>
</ReturnValue>
<Docs>
<summary>Get preferred colormap for using Gdk.RGB</summary>
<value>The preferred <see cref="T:Gdk.Colormap" />.</value>
<remarks>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.</remarks>
</Docs>
</Member>
<Member MemberName="ColormapDitherable">
<MemberSignature Language="C#" Value="public static bool ColormapDitherable (Gdk.Colormap cmap);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig bool ColormapDitherable(class Gdk.Colormap cmap) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="cmap" Type="Gdk.Colormap" />
</Parameters>
<Docs>
<param name="cmap">a <see cref="T:Gdk.Colormap" /></param>
<summary>To be added</summary>
<returns>a <see cref="T:System.Boolean" /></returns>
<remarks>To be added</remarks>
<since version="Gtk# 2.6" />
</Docs>
</Member>
<Member MemberName="Ditherable">
<MemberSignature Language="C#" Value="public static bool Ditherable ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig bool Ditherable() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>Whether the visual in use by GdkRGB is dithereable.</summary>
<returns>
<see langword="true" /> if the visual is ditherable.</returns>
<remarks>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.</remarks>
</Docs>
</Member>
<Member MemberName="FindColor">
<MemberSignature Language="C#" Value="public static void FindColor (Gdk.Colormap colormap, ref Gdk.Color color);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void FindColor(class Gdk.Colormap colormap, valuetype Gdk.Color color) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="colormap" Type="Gdk.Colormap" />
<Parameter Name="color" Type="Gdk.Color&" RefType="ref" />
</Parameters>
<Docs>
<param name="colormap">Tthe colormap for the graphics context and drawable you're using to draw. If you're drawing to a <see cref="T:Gtk.Widget" />, use the <see cref="P:Gtk.Widget.Colormap" /> property.</param>
<param name="color">Color should have its red, green, and blue fields initialized.</param>
<summary>Fetches a color to be used on the given colormap.</summary>
<remarks>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 <see cref="P:Gtk.GC.Foreground" /> which expects the pixel to be initialized.
<para>
In many cases, you can avoid this whole issue by setting the <see cref="P:Gdk.GC.RgbFgColor" /> or <see cref="P:Gdk.GC.RgbBgColor" />, which do not expect pixel to be initialized in advance. If you use those functions, there's no need for using FindColor.
</para></remarks>
</Docs>
</Member>
<Member MemberName="GcSetBackground">
<MemberSignature Language="C#" Value="public static void GcSetBackground (Gdk.GC gc, uint rgb);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void GcSetBackground(class Gdk.GC gc, unsigned int32 rgb) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="gc" Type="Gdk.GC" />
<Parameter Name="rgb" Type="System.UInt32" />
</Parameters>
<Docs>
<param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="rgb">a <see cref="T:System.UInt32" /></param>
<summary>To be added</summary>
<remarks>To be added</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="GcSetForeground">
<MemberSignature Language="C#" Value="public static void GcSetForeground (Gdk.GC gc, uint rgb);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void GcSetForeground(class Gdk.GC gc, unsigned int32 rgb) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="gc" Type="Gdk.GC" />
<Parameter Name="rgb" Type="System.UInt32" />
</Parameters>
<Docs>
<param name="gc">a <see cref="T:Gdk.GC" /></param>
<param name="rgb">a <see cref="T:System.UInt32" /></param>
<summary>To be added</summary>
<remarks>To be added</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="Init">
<MemberSignature Language="C#" Value="public static void Init ();" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig void Init() cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.Void</ReturnType>
</ReturnValue>
<Parameters />
<Docs>
<summary>To be added</summary>
<remarks>To be added</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
<Member MemberName="Install">
<MemberSignature Language="C#" Value="public static bool Install { set; }" />
<MemberSignature Language="ILAsm" Value=".property bool Install" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Whether to install a private colormap for Gdk.RGB</summary>
<value>a <see cref="T:System.Boolean" /></value>
<remarks>If the value is <see langword="true" />, 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.
<para>
A private colormap has more colors, leading to better quality display, but also leads to the dreaded "colormap flashing" effect.
</para></remarks>
</Docs>
</Member>
<Member MemberName="MinColors">
<MemberSignature Language="C#" Value="public static int MinColors { set; }" />
<MemberSignature Language="ILAsm" Value=".property int32 MinColors" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Int32</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>The minimum number of colors for this colormap.</summary>
<value>a <see cref="T:System.Int32" /></value>
<remarks>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.</remarks>
</Docs>
</Member>
<Member MemberName="Verbose">
<MemberSignature Language="C#" Value="public static bool Verbose { set; }" />
<MemberSignature Language="ILAsm" Value=".property bool Verbose" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>System.Boolean</ReturnType>
</ReturnValue>
<Parameters>
</Parameters>
<Docs>
<summary>Whether or not to be verbose to the console about actions. Useful for debugging.</summary>
<value>a <see cref="T:System.Boolean" /></value>
<remarks />
</Docs>
</Member>
<Member MemberName="Visual">
<MemberSignature Language="C#" Value="public static Gdk.Visual Visual { get; }" />
<MemberSignature Language="ILAsm" Value=".property class Gdk.Visual Visual" />
<MemberType>Property</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<ReturnValue>
<ReturnType>Gdk.Visual</ReturnType>
</ReturnValue>
<Docs>
<summary>The preferred visual for GdkRGB operations.</summary>
<value>a <see cref="T:Gdk.Visual" /></value>
<remarks>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.</remarks>
</Docs>
</Member>
<Member MemberName="XpixelFromRgb">
<MemberSignature Language="C#" Value="public static ulong XpixelFromRgb (uint rgb);" />
<MemberSignature Language="ILAsm" Value=".method public static hidebysig unsigned int64 XpixelFromRgb(unsigned int32 rgb) cil managed" />
<MemberType>Method</MemberType>
<AssemblyInfo>
<AssemblyVersion>2.12.0.0</AssemblyVersion>
</AssemblyInfo>
<Attributes>
<Attribute>
<AttributeName>System.Obsolete</AttributeName>
</Attribute>
</Attributes>
<ReturnValue>
<ReturnType>System.UInt64</ReturnType>
</ReturnValue>
<Parameters>
<Parameter Name="rgb" Type="System.UInt32" />
</Parameters>
<Docs>
<param name="rgb">a <see cref="T:System.UInt32" /></param>
<summary>To be added</summary>
<returns>a <see cref="T:System.UInt64" /></returns>
<remarks>To be added</remarks>
<since version="Gtk# 2.4" />
</Docs>
</Member>
</Members>
</Type>
|