<HTML
><HEAD
><TITLE
>gnome-canvas-util</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.74b"><LINK
REL="HOME"
TITLE="Gnome User Interface Library Reference Manual"
HREF="book1.html"><LINK
REL="UP"
TITLE="Gnome User Interface Library"
HREF="libgnomeui.html"><LINK
REL="PREVIOUS"
TITLE="gnome-app-util"
HREF="gnomeui-gnome-app-util.html"><LINK
REL="NEXT"
TITLE="gnome-dialog-util"
HREF="gnomeui-gnome-dialog-util.html"></HEAD
><BODY
CLASS="REFENTRY"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#0000FF"
VLINK="#840084"
ALINK="#0000FF"
><DIV
CLASS="NAVHEADER"
><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TH
COLSPAN="4"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="5"
>Gnome User Interface Library Reference Manual</FONT
></TH
></TR
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dialog-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
></TABLE
></DIV
><H1
><A
NAME="GNOMEUI-GNOME-CANVAS-UTIL"
>gnome-canvas-util</A
></H1
><DIV
CLASS="REFNAMEDIV"
><A
NAME="AEN2735"
></A
><H2
>Name</H2
>gnome-canvas-util -- Auxiliary canvas functions.</DIV
><DIV
CLASS="REFSYNOPSISDIV"
><A
NAME="AEN2738"
></A
><H2
>Synopsis</H2
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="SYNOPSIS"
> #include <gnome.h>
struct <A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>;
<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>* <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POINTS-NEW"
>gnome_canvas_points_new</A
> (int num_points);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POINTS-FREE"
>gnome_canvas_points_free</A
> (<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
> *points);
int <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-GET-MITER-POINTS"
>gnome_canvas_get_miter_points</A
> (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x3,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y3,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> width,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *mx1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *my1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *mx2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *my2);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-GET-BUTT-POINTS"
>gnome_canvas_get_butt_points</A
> (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> width,
int project,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *bx1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *by1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *bx2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *by2);
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-POLYGON-TO-POINT"
>gnome_canvas_polygon_to_point</A
> (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *poly,
int num_points,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-RENDER-SVP"
>gnome_canvas_render_svp</A
> (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *svp,
<GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> rgba);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-SVP"
>gnome_canvas_update_svp</A
> (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-SVP-CLIP"
>gnome_canvas_update_svp_clip</A
> (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *clip_svp);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-RESET-BOUNDS"
>gnome_canvas_item_reset_bounds</A
> (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-UPDATE-SVP"
>gnome_canvas_item_update_svp</A
> (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-UPDATE-SVP-CLIP"
>gnome_canvas_item_update_svp_clip</A
>
(<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *clip_svp);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-ITEM-REQUEST-REDRAW-SVP"
>gnome_canvas_item_request_redraw_svp</A
>
(<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
const <GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *svp);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-UPDATE-BBOX"
>gnome_canvas_update_bbox</A
> (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
int x1,
int y1,
int x2,
int y2);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-BUF-ENSURE-BUF"
>gnome_canvas_buf_ensure_buf</A
> (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf);
<GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
>* <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-LOAD-ALPHA"
>gnome_canvas_load_alpha</A
> (char *file);
void <A
HREF="gnomeui-gnome-canvas-util.html#GNOME-CANVAS-DESTROY-IMAGE"
>gnome_canvas_destroy_image</A
> (<GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image);</PRE
></TD
></TR
></TABLE
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2808"
></A
><H2
>Description</H2
><P
>These miscellaneous functions are useful with the GnomeCanvas.</P
></DIV
><DIV
CLASS="REFSECT1"
><A
NAME="AEN2811"
></A
><H2
>Details</H2
><DIV
CLASS="REFSECT2"
><A
NAME="AEN2813"
></A
><H3
><A
NAME="GNOMECANVASPOINTS"
></A
>struct GnomeCanvasPoints</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>typedef struct {
int num_points;
double *coords;
int ref_count;
} GnomeCanvasPoints;</PRE
></TD
></TR
></TABLE
><P
></P
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2818"
></A
><H3
><A
NAME="GNOME-CANVAS-POINTS-NEW"
></A
>gnome_canvas_points_new ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
>* gnome_canvas_points_new (int num_points);</PRE
></TD
></TR
></TABLE
><P
>Creates a structure that should be used to pass an array of points to
items.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2825"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_points</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The number of points to allocate space for in the array.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A newly-created array of points. It should be filled in
by the user.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2838"
></A
><H3
><A
NAME="GNOME-CANVAS-POINTS-FREE"
></A
>gnome_canvas_points_free ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_points_free (<A
HREF="gnomeui-gnome-canvas-util.html#GNOMECANVASPOINTS"
>GnomeCanvasPoints</A
> *points);</PRE
></TD
></TR
></TABLE
><P
>Decreases the reference count of the specified points structure. If it
reaches zero, then the structure is freed.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2845"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>points</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas points structure.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2854"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-MITER-POINTS"
></A
>gnome_canvas_get_miter_points ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>int gnome_canvas_get_miter_points (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x3,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y3,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> width,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *mx1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *my1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *mx2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *my2);</PRE
></TD
></TR
></TABLE
><P
>Given three points forming an angle, computes the coordinates of the inside
and outside points of the mitered corner formed by a line of a given width at
that angle.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2871"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the first point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the first point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the second (angle) point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the second (angle) point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x3</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the third point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y3</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the third point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mx1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The X coordinate of the first miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>my1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The Y coordinate of the first miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>mx2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The X coordinate of the second miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>my2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The Y coordinate of the second miter point is returned here.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> FALSE if the angle is less than 11 degrees (this is the same
threshold as X uses. If this occurs, the return points are not modified.
Otherwise, returns TRUE.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2924"
></A
><H3
><A
NAME="GNOME-CANVAS-GET-BUTT-POINTS"
></A
>gnome_canvas_get_butt_points ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_get_butt_points (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> width,
int project,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *bx1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *by1,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *bx2,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *by2);</PRE
></TD
></TR
></TABLE
><P
>Computes the butt points of a line segment.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2939"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of first point in the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y cooordinate of first point in the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of second point (endpoint) of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of second point (endpoint) of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>width</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Width of the line</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>project</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Whether the butt points should project out by width/2 distance</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>bx1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of first butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>by1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of first butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>bx2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of second butt point is returned here</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>by2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of second butt point is returned here</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN2984"
></A
><H3
><A
NAME="GNOME-CANVAS-POLYGON-TO-POINT"
></A
>gnome_canvas_polygon_to_point ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> gnome_canvas_polygon_to_point (<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> *poly,
int num_points,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> x,
<GTKDOCLINK
HREF="DOUBLE"
>double</GTKDOCLINK
> y);</PRE
></TD
></TR
></TABLE
><P
>Computes the distance between a point and a polygon.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN2994"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>poly</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Vertices of the polygon. X coordinates are in the even indices, and Y
coordinates are in the odd indices</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>num_points</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Number of points in the polygon</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> X coordinate of the point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Y coordinate of the point</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> The distance from the point to the polygon, or zero if the
point is inside the polygon.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3019"
></A
><H3
><A
NAME="GNOME-CANVAS-RENDER-SVP"
></A
>gnome_canvas_render_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_render_svp (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *svp,
<GTKDOCLINK
HREF="GUINT32"
>guint32</GTKDOCLINK
> rgba);</PRE
></TD
></TR
></TABLE
><P
>Render the svp over the buf.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3028"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buf</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas buffer to render over</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the vector path to render</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>rgba</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the rgba color to render</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3045"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-SVP"
></A
>gnome_canvas_update_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_update_svp (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, requesting repaint on what's changed. This
function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3054"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3071"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-SVP-CLIP"
></A
>gnome_canvas_update_svp_clip ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_update_svp_clip (<A
HREF="gnomecanvas.html"
>GnomeCanvas</A
> *canvas,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *clip_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, clipping if necessary, and requesting repaint
on what's changed. This function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3081"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>canvas</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clip_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a clip path, if non-null</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3102"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-RESET-BOUNDS"
></A
>gnome_canvas_item_reset_bounds ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_item_reset_bounds (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item);</PRE
></TD
></TR
></TABLE
><P
>Resets the bounding box of a canvas item to an empty rectangle.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3109"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A canvas item</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3118"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-UPDATE-SVP"
></A
>gnome_canvas_item_update_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_item_update_svp (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, requesting repaint on what's changed. This
function takes responsibility for freeing new_svp. This routine also adds the
svp's bbox to the item's.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3127"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas item containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3144"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-UPDATE-SVP-CLIP"
></A
>gnome_canvas_item_update_svp_clip ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_item_update_svp_clip
(<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> **p_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *new_svp,
<GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *clip_svp);</PRE
></TD
></TR
></TABLE
><P
>Sets the svp to the new value, clipping if necessary, and requesting repaint
on what's changed. This function takes responsibility for freeing new_svp.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3154"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the canvas item containing the svp that needs updating.</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>p_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a pointer to the existing svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>new_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the new svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>clip_svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> a clip path, if non-null</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3175"
></A
><H3
><A
NAME="GNOME-CANVAS-ITEM-REQUEST-REDRAW-SVP"
></A
>gnome_canvas_item_request_redraw_svp ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_item_request_redraw_svp
(<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
const <GTKDOCLINK
HREF="ARTSVP"
>ArtSVP</GTKDOCLINK
> *svp);</PRE
></TD
></TR
></TABLE
><P
>Request redraw of the svp if in aa mode, or the entire item in in xlib mode.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3183"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the item containing the svp</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>svp</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> the svp that needs to be redrawn</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3196"
></A
><H3
><A
NAME="GNOME-CANVAS-UPDATE-BBOX"
></A
>gnome_canvas_update_bbox ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_update_bbox (<A
HREF="gnomecanvasitem.html"
>GnomeCanvasItem</A
> *item,
int x1,
int y1,
int x2,
int y2);</PRE
></TD
></TR
></TABLE
><P
>Sets the bbox to the new value, requesting full repaint.</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3203"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>item</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> </TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Left coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y1</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Top coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>x2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Right coordinate of the new bounding box</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>y2</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> Bottom coordinate of the new bounding box</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3228"
></A
><H3
><A
NAME="GNOME-CANVAS-BUF-ENSURE-BUF"
></A
>gnome_canvas_buf_ensure_buf ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_buf_ensure_buf (<A
HREF="gnomecanvas.html#GNOMECANVASBUF"
>GnomeCanvasBuf</A
> *buf);</PRE
></TD
></TR
></TABLE
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3234"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>buf</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> </TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3243"
></A
><H3
><A
NAME="GNOME-CANVAS-LOAD-ALPHA"
></A
>gnome_canvas_load_alpha ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
><GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
>* gnome_canvas_load_alpha (char *file);</PRE
></TD
></TR
></TABLE
><P
>This routine loads a PNG file with full alpha transparency and</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3250"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>file</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> filename to load</TD
></TR
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><SPAN
CLASS="emphasis"
><I
CLASS="EMPHASIS"
>Returns</I
></SPAN
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
>a (GdkImlibImage *).
Note that images created by this routine are not intended to be
passed to GdkImlib, we just use this to remain compatible with
the GnomeCanvasImage Canvas item. Use this with GdkImlib at
your own risk.
To release images loaded by gnome_canvas_load_alpha, use
gnome_canvas_destroy_image preferably although it works
with imlib now, in the future this might not be the case.</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
><HR><DIV
CLASS="REFSECT2"
><A
NAME="AEN3263"
></A
><H3
><A
NAME="GNOME-CANVAS-DESTROY-IMAGE"
></A
>gnome_canvas_destroy_image ()</H3
><TABLE
BORDER="0"
BGCOLOR="#D6E8FF"
WIDTH="100%"
CELLPADDING="6"
><TR
><TD
><PRE
CLASS="PROGRAMLISTING"
>void gnome_canvas_destroy_image (<GTKDOCLINK
HREF="GDKIMLIBIMAGE"
>GdkImlibImage</GTKDOCLINK
> *image);</PRE
></TD
></TR
></TABLE
><P
>Do not pass a regular GdkImlibImage to this routine, only pass
GdkImlibImage pointer that were created by gnome_canvas_load_alpha</P
><P
></P
><DIV
CLASS="INFORMALTABLE"
><A
NAME="AEN3270"
></A
><P
></P
><TABLE
BORDER="0"
WIDTH="100%"
BGCOLOR="#FFD0D0"
CELLSPACING="0"
CELLPADDING="4"
CLASS="CALSTABLE"
><TBODY
><TR
><TD
WIDTH="20%"
ALIGN="RIGHT"
VALIGN="TOP"
><TT
CLASS="PARAMETER"
><I
>image</I
></TT
> :</TD
><TD
WIDTH="80%"
ALIGN="LEFT"
VALIGN="TOP"
> A GdkImlibImage allocated by gnome_canvas_load_alpha</TD
></TR
></TBODY
></TABLE
><P
></P
></DIV
></DIV
></DIV
><DIV
CLASS="NAVFOOTER"
><BR
CLEAR="all"><BR><TABLE
WIDTH="100%"
BORDER="0"
BGCOLOR="#000000"
CELLPADDING="1"
CELLSPACING="0"
><TR
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="left"
><A
HREF="gnomeui-gnome-app-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><<< Previous Page</B
></FONT
></A
></TD
><TD
WIDTH="25%"
BGCOLOR="#0000C0"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="book1.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Home</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#00C000"
ALIGN="center"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
><A
HREF="libgnomeui.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Up</B
></FONT
></A
></B
></FONT
></TD
><TD
WIDTH="25%"
BGCOLOR="#C00000"
ALIGN="right"
><A
HREF="gnomeui-gnome-dialog-util.html"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>Next Page >>></B
></FONT
></A
></TD
></TR
><TR
><TD
COLSPAN="2"
ALIGN="left"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-app-util</B
></FONT
></TD
><TD
COLSPAN="2"
ALIGN="right"
><FONT
COLOR="#FFFFFF"
SIZE="3"
><B
>gnome-dialog-util</B
></FONT
></TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
distrib
>
Mandriva
>
2010.0
>
i586
>
media
>
contrib-release
>
by-pkgid
>
1bbf51ece72e40a5f40ad48678e7c5a5
>
files
>
480
