gtk2/docs/reference/gdk/tmpl/visuals.sgml

181 lines
2.9 KiB
Plaintext
Raw Normal View History

1999-08-16 18:51:52 +00:00
<!-- ##### SECTION Title ##### -->
Visuals
<!-- ##### SECTION Short_Description ##### -->
Low-level display hardware information
1999-08-16 18:51:52 +00:00
<!-- ##### SECTION Long_Description ##### -->
<para>
A #GdkVisual describes a particular video hardware display format. For example,
a piece of display hardware might support 24-bit color, 16-bit color, or 8-bit
color; meaning 24/16/8-bit pixel sizes. For a given pixel size, pixels can be in
different formats; for example the "red" element of an RGB pixel may be in the
top 8 bits of the pixel, or may be in the lower 4 bits.
</para>
<para>
Usually you can avoid thinking about visuals in GTK+. Visuals are useful to
interpret the contents of a #GdkImage, but you should avoid #GdkImage precisely
because its contents depend on the display hardware; use #GdkPixbuf instead, for
all but the most low-level purposes. Also, anytime you provide a #GdkColormap,
the visual is implied as part of the colormap (gdk_colormap_get_visual()), so
you won't have to provide a visual in addition.
1999-08-16 18:51:52 +00:00
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
#GdkImage, #GdkColormap
1999-08-16 18:51:52 +00:00
</para>
<!-- ##### STRUCT GdkVisual ##### -->
<para>
Description of an image data format
</para>
1999-08-16 18:51:52 +00:00
@parent_instance: inherited portion from #GObject
1999-08-16 18:51:52 +00:00
@type:
@depth:
@byte_order:
@colormap_size:
@bits_per_rgb:
@red_mask:
@red_shift:
@red_prec:
@green_mask:
@green_shift:
@green_prec:
@blue_mask:
@blue_shift:
@blue_prec:
<!-- ##### STRUCT GdkVisualClass ##### -->
<para>
</para>
1999-08-16 18:51:52 +00:00
<!-- ##### ENUM GdkVisualType ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@GDK_VISUAL_STATIC_GRAY:
@GDK_VISUAL_GRAYSCALE:
@GDK_VISUAL_STATIC_COLOR:
@GDK_VISUAL_PSEUDO_COLOR:
@GDK_VISUAL_TRUE_COLOR:
@GDK_VISUAL_DIRECT_COLOR:
<!-- ##### ENUM GdkByteOrder ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@GDK_LSB_FIRST:
@GDK_MSB_FIRST:
<!-- ##### FUNCTION gdk_query_depths ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@depths:
@count:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_query_visual_types ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@visual_types:
@count:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_list_visuals ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best_depth ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best_type ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_system ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best_with_depth ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@depth:
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best_with_type ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@visual_type:
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### FUNCTION gdk_visual_get_best_with_both ##### -->
<para>
1999-08-16 18:51:52 +00:00
</para>
@depth:
@visual_type:
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### MACRO gdk_visual_ref ##### -->
1999-08-16 18:51:52 +00:00
<para>
Deprecated equivalent of g_object_ref().
1999-08-16 18:51:52 +00:00
</para>
@v:
@Returns:
1999-08-16 18:51:52 +00:00
<!-- ##### MACRO gdk_visual_unref ##### -->
1999-08-16 18:51:52 +00:00
<para>
Deprecated equivalent of g_object_unref().
1999-08-16 18:51:52 +00:00
</para>
@v:
1999-08-16 18:51:52 +00:00