📄 gtkpreview.html
字号:
<HTML><HEAD><TITLE>GtkPreview</TITLE><METANAME="GENERATOR"CONTENT="Modular DocBook HTML Stylesheet Version 1.61"><LINKREL="HOME"TITLE="GTK+ Reference Manual"HREF="index.html"><LINKREL="UP"TITLE="GTK+ Widgets and Objects"HREF="gtkobjects.html"><LINKREL="PREVIOUS"TITLE="GtkPlug"HREF="gtkplug.html"><LINKREL="NEXT"TITLE="GtkProgress"HREF="gtkprogress.html"></HEAD><BODYCLASS="REFENTRY"BGCOLOR="#FFFFFF"TEXT="#000000"LINK="#0000FF"VLINK="#840084"ALINK="#0000FF"><DIVCLASS="NAVHEADER"><TABLEWIDTH="100%"BORDER="0"BGCOLOR="#000000"CELLPADDING="1"CELLSPACING="0"><TR><THCOLSPAN="4"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="5">GTK+ Reference Manual</FONT></TH></TR><TR><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="left"><AHREF="gtkplug.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B><<< Previous Page</B></FONT></A></TD><TDWIDTH="25%"BGCOLOR="#0000C0"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="index.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Home</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#00C000"ALIGN="center"><FONTCOLOR="#FFFFFF"SIZE="3"><B><AHREF="gtkobjects.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Up</B></FONT></A></B></FONT></TD><TDWIDTH="25%"BGCOLOR="#C00000"ALIGN="right"><AHREF="gtkprogress.html"><FONTCOLOR="#FFFFFF"SIZE="3"><B>Next Page >>></B></FONT></A></TD></TR></TABLE></DIV><H1><ANAME="GTKPREVIEW">GtkPreview</A></H1><DIVCLASS="REFNAMEDIV"><ANAME="AEN36253"></A><H2>Name</H2>GtkPreview -- a widget to display RGB or grayscale data.</DIV><DIVCLASS="REFSYNOPSISDIV"><ANAME="AEN36256"></A><H2>Synopsis</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> #include <gtk/gtk.h>struct <AHREF="gtkpreview.html#GTKPREVIEW-STRUCT">GtkPreview</A>;struct <AHREF="gtkpreview.html#GTKPREVIEWINFO">GtkPreviewInfo</A>;union <AHREF="gtkpreview.html#GTKDITHERINFO">GtkDitherInfo</A>;void <AHREF="gtkpreview.html#GTK-PREVIEW-UNINIT">gtk_preview_uninit</A> (void);<AHREF="gtkwidget.html">GtkWidget</A>* <AHREF="gtkpreview.html#GTK-PREVIEW-NEW">gtk_preview_new</A> (<AHREF="gtk-standard-enumerations.html#GTKPREVIEWTYPE">GtkPreviewType</A> type);void <AHREF="gtkpreview.html#GTK-PREVIEW-SIZE">gtk_preview_size</A> (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> width, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> height);void <AHREF="gtkpreview.html#GTK-PREVIEW-PUT">gtk_preview_put</A> (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../gdk/gdk-windows.html#GDKWINDOW>GdkWindow</A> *window, <AHREF=../gdk/gdk-graphics-contexts.html#GDKGC>GdkGC</A> *gc, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> srcx, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> srcy, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> destx, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> desty, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> width, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> height);void <AHREF="gtkpreview.html#GTK-PREVIEW-DRAW-ROW">gtk_preview_draw_row</A> (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../glib/glib-basic-types.html#GUCHAR>guchar</A> *data, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> x, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> y, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> w);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-EXPAND">gtk_preview_set_expand</A> (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> expand);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-GAMMA">gtk_preview_set_gamma</A> (double gamma);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-COLOR-CUBE">gtk_preview_set_color_cube</A> (<AHREF=../glib/glib-basic-types.html#GUINT>guint</A> nred_shades, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> ngreen_shades, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> nblue_shades, <AHREF=../glib/glib-basic-types.html#GUINT>guint</A> ngray_shades);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-INSTALL-CMAP">gtk_preview_set_install_cmap</A> (<AHREF=../glib/glib-basic-types.html#GINT>gint</A> install_cmap);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-RESERVED">gtk_preview_set_reserved</A> (<AHREF=../glib/glib-basic-types.html#GINT>gint</A> nreserved);void <AHREF="gtkpreview.html#GTK-PREVIEW-SET-DITHER">gtk_preview_set_dither</A> (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../gdk/gdk-gdkrgb.html#GDKRGBDITHER>GdkRgbDither</A> dither);<AHREF=../gdk/gdk-visuals.html#GDKVISUAL>GdkVisual</A>* <AHREF="gtkpreview.html#GTK-PREVIEW-GET-VISUAL">gtk_preview_get_visual</A> (void);<AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP>GdkColormap</A>* <AHREF="gtkpreview.html#GTK-PREVIEW-GET-CMAP">gtk_preview_get_cmap</A> (void);<AHREF="gtkpreview.html#GTKPREVIEWINFO">GtkPreviewInfo</A>* <AHREF="gtkpreview.html#GTK-PREVIEW-GET-INFO">gtk_preview_get_info</A> (void);void <AHREF="gtkpreview.html#GTK-PREVIEW-RESET">gtk_preview_reset</A> (void); </PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36310"></A><H2>Object Hierarchy</H2><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="SYNOPSIS"> <AHREF="gtkobject.html">GtkObject</A> +----<AHREF="gtkwidget.html">GtkWidget</A> +----GtkPreview</PRE></TD></TR></TABLE></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36315"></A><H2>Description</H2><P>The <AHREF="gtkpreview.html">GtkPreview</A> widget provides a simple interface used to display images as RGB or grayscale data.</P></DIV><DIVCLASS="REFSECT1"><ANAME="AEN36319"></A><H2>Details</H2><DIVCLASS="REFSECT2"><ANAME="AEN36321"></A><H3><ANAME="GTKPREVIEW-STRUCT"></A>struct GtkPreview</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkPreview;</PRE></TD></TR></TABLE><P>The <AHREF="gtkpreview.html#GTKPREVIEW-STRUCT">GtkPreview</A> struct contains private data only, andshould be accessed using the functions below.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36327"></A><H3><ANAME="GTKPREVIEWINFO"></A>struct GtkPreviewInfo</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">struct GtkPreviewInfo{ GdkVisual *visual; GdkColormap *cmap; guchar *lookup; gdouble gamma;};</PRE></TD></TR></TABLE><P>Contains information about global propertiesof preview widgets.The <AHREF="gtkpreview.html#GTKPREVIEWINFO">GtkPreviewInfo</A> struct contains the following fields.(These fields should be considered read-only. They should never be set byan application.)<DIVCLASS="INFORMALTABLE"><ANAME="AEN36333"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFF0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../gdk/gdk-visuals.html#GDKVISUAL>GdkVisual</A> *visual;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the visual used by all previews.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP"><AHREF=../gdk/gdk-colormaps-and-colors.html#GDKCOLORMAP>GdkColormap</A> *cmap;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the colormap used by all previews.</TD></TR><TR><TDWIDTH="20%"ALIGN="LEFT"VALIGN="TOP">gdouble gamma;</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the gamma correction value used by all previews (See <AHREF="gtkpreview.html#GTK-PREVIEW-SET-GAMMA">gtk_preview_set_gamma</A>()).</TD></TR></TBODY></TABLE><P></P></DIV> </P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36350"></A><H3><ANAME="GTKDITHERINFO"></A>union GtkDitherInfo</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">union GtkDitherInfo{ gushort s[2]; guchar c[4];};</PRE></TD></TR></TABLE><P>This union not used in GTK+.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36355"></A><H3><ANAME="GTK-PREVIEW-UNINIT"></A>gtk_preview_uninit ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_preview_uninit (void);</PRE></TD></TR></TABLE><P>This function is deprecated and does nothing.</P></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36360"></A><H3><ANAME="GTK-PREVIEW-NEW"></A>gtk_preview_new ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING"><AHREF="gtkwidget.html">GtkWidget</A>* gtk_preview_new (<AHREF="gtk-standard-enumerations.html#GTKPREVIEWTYPE">GtkPreviewType</A> type);</PRE></TD></TR></TABLE><P>Create a new preview widget.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36367"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>type</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the type data contained by the widget. (Grayscale or RGB)</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><ICLASS="EMPHASIS">Returns</I> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP"> </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36380"></A><H3><ANAME="GTK-PREVIEW-SIZE"></A>gtk_preview_size ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_preview_size (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> width, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> height);</PRE></TD></TR></TABLE><P>Set the size that the preview widget will requestin response to a "size_request" signal. The drawing area may actually be allocated a sizelarger than this depending on how it is packedwithin the enclosing containers. The effectof this is determined by whether the previewis set to expand or not (see gtk_preview_expand())</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36389"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>preview</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkpreview.html">GtkPreview</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>width</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the new width.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>height</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the new height. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36407"></A><H3><ANAME="GTK-PREVIEW-PUT"></A>gtk_preview_put ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_preview_put (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../gdk/gdk-windows.html#GDKWINDOW>GdkWindow</A> *window, <AHREF=../gdk/gdk-graphics-contexts.html#GDKGC>GdkGC</A> *gc, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> srcx, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> srcy, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> destx, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> desty, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> width, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> height);</PRE></TD></TR></TABLE><P>Takes a portion of the contents of a preview widgetand draws it onto the given drawable, <TTCLASS="PARAMETER"><I>window</I></TT>.</P><DIVCLASS="INFORMALTABLE"><ANAME="AEN36422"></A><P></P><TABLEBORDER="0"WIDTH="100%"BGCOLOR="#FFD0D0"CELLSPACING="0"CELLPADDING="4"CLASS="CALSTABLE"><TBODY><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>preview</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a <AHREF="gtkpreview.html">GtkPreview</A>.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>window</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">a window or pixmap.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>gc</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">The graphics context for the operation. Only the clip mask for this GC matters.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>srcx</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the x coordinate of the upper left corner in the source image.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>srcy</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the y coordinate of the upper left corner in the source image.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>destx</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the x coordinate of the upper left corner in the destination image.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>desty</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the y coordinate of the upper left corner in the destination image.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>width</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the width of the rectangular portion to draw.</TD></TR><TR><TDWIDTH="20%"ALIGN="RIGHT"VALIGN="TOP"><TTCLASS="PARAMETER"><I>height</I></TT> :</TD><TDWIDTH="80%"ALIGN="LEFT"VALIGN="TOP">the height of the rectangular portion to draw. </TD></TR></TBODY></TABLE><P></P></DIV></DIV><HR><DIVCLASS="REFSECT2"><ANAME="AEN36464"></A><H3><ANAME="GTK-PREVIEW-DRAW-ROW"></A>gtk_preview_draw_row ()</H3><TABLEBORDER="0"BGCOLOR="#D6E8FF"WIDTH="100%"CELLPADDING="6"><TR><TD><PRECLASS="PROGRAMLISTING">void gtk_preview_draw_row (<AHREF="gtkpreview.html">GtkPreview</A> *preview, <AHREF=../glib/glib-basic-types.html#GUCHAR>guchar</A> *data, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> x, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> y, <AHREF=../glib/glib-basic-types.html#GINT>gint</A> w);</PRE></TD></TR></TABLE><P>Sets the data for a portion of a row.</P><DIVCLASS="INFORMALTABLE"><A⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -