gnome-canvas-util

Name

gnome-canvas-util — one line description goes here.

Synopsis


#include <gnome.h>


struct      GnomeCanvasPoints;
GnomeCanvasPoints* gnome_canvas_points_new  (int num_points);
void        gnome_canvas_points_free        (GnomeCanvasPoints *points);
int         gnome_canvas_get_miter_points   (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double x3,
                                             double y3,
                                             double width,
                                             double *mx1,
                                             double *my1,
                                             double *mx2,
                                             double *my2);
void        gnome_canvas_get_butt_points    (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double width,
                                             int project,
                                             double *bx1,
                                             double *by1,
                                             double *bx2,
                                             double *by2);
double      gnome_canvas_polygon_to_point   (double *poly,
                                             int num_points,
                                             double x,
                                             double y);
void        gnome_canvas_render_svp         (GnomeCanvasBuf *buf,
                                             ArtSVP *svp,
                                             guint32 rgba);
void        gnome_canvas_update_svp         (GnomeCanvas *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);
void        gnome_canvas_update_svp_clip    (GnomeCanvas *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);
void        gnome_canvas_item_reset_bounds  (GnomeCanvasItem *item);
void        gnome_canvas_item_update_svp    (GnomeCanvasItem *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);
void        gnome_canvas_item_update_svp_clip
                                            (GnomeCanvasItem *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);
void        gnome_canvas_item_request_redraw_svp
                                            (GnomeCanvasItem *item,
                                             const ArtSVP *svp);
void        gnome_canvas_update_bbox        (GnomeCanvasItem *item,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);
void        gnome_canvas_buf_ensure_buf     (GnomeCanvasBuf *buf);
GdkImlibImage* gnome_canvas_load_alpha      (char *file);
void        gnome_canvas_destroy_image      (GdkImlibImage *image);

Description

Details

struct GnomeCanvasPoints

typedef struct {
	int num_points;
	double *coords;
	int ref_count;
} GnomeCanvasPoints;


gnome_canvas_points_new ()

GnomeCanvasPoints* gnome_canvas_points_new  (int num_points);

Creates a structure that should be used to pass an array of points to items.

num_points : The number of points to allocate space for in the array.Returns : A newly-created array of points. It should be filled in by the user.


gnome_canvas_points_free ()

void        gnome_canvas_points_free        (GnomeCanvasPoints *points);

Decreases the reference count of the specified points structure. If it reaches zero, then the structure is freed.

points : A canvas points structure.


gnome_canvas_get_miter_points ()

int         gnome_canvas_get_miter_points   (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double x3,
                                             double y3,
                                             double width,
                                             double *mx1,
                                             double *my1,
                                             double *mx2,
                                             double *my2);

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.

x1 : X coordinate of the first pointy1 : Y coordinate of the first pointx2 : X coordinate of the second (angle) pointy2 : Y coordinate of the second (angle) pointx3 : X coordinate of the third pointy3 : Y coordinate of the third pointwidth : Width of the linemx1 : The X coordinate of the first miter point is returned here.my1 : The Y coordinate of the first miter point is returned here.mx2 : The X coordinate of the second miter point is returned here.my2 : The Y coordinate of the second miter point is returned here.Returns : 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.


gnome_canvas_get_butt_points ()

void        gnome_canvas_get_butt_points    (double x1,
                                             double y1,
                                             double x2,
                                             double y2,
                                             double width,
                                             int project,
                                             double *bx1,
                                             double *by1,
                                             double *bx2,
                                             double *by2);

Computes the butt points of a line segment.

x1 : X coordinate of first point in the liney1 : Y cooordinate of first point in the linex2 : X coordinate of second point (endpoint) of the liney2 : Y coordinate of second point (endpoint) of the linewidth : Width of the lineproject : Whether the butt points should project out by width/2 distancebx1 : X coordinate of first butt point is returned hereby1 : Y coordinate of first butt point is returned herebx2 : X coordinate of second butt point is returned hereby2 : Y coordinate of second butt point is returned here


gnome_canvas_polygon_to_point ()

double      gnome_canvas_polygon_to_point   (double *poly,
                                             int num_points,
                                             double x,
                                             double y);

Computes the distance between a point and a polygon.

poly : Vertices of the polygon. X coordinates are in the even indices, and Y coordinates are in the odd indicesnum_points : Number of points in the polygonx : X coordinate of the pointy : Y coordinate of the pointReturns : The distance from the point to the polygon, or zero if the point is inside the polygon.


gnome_canvas_render_svp ()

void        gnome_canvas_render_svp         (GnomeCanvasBuf *buf,
                                             ArtSVP *svp,
                                             guint32 rgba);

Render the svp over the buf.

buf : the canvas buffer to render oversvp : the vector path to renderrgba : the rgba color to render


gnome_canvas_update_svp ()

void        gnome_canvas_update_svp         (GnomeCanvas *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);

Sets the svp to the new value, requesting repaint on what's changed. This function takes responsibility for freeing new_svp.

canvas : the canvas containing the svp that needs updating.p_svp : a pointer to the existing svpnew_svp : the new svp


gnome_canvas_update_svp_clip ()

void        gnome_canvas_update_svp_clip    (GnomeCanvas *canvas,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);

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.

canvas : the canvas containing the svp that needs updating.p_svp : a pointer to the existing svpnew_svp : the new svpclip_svp : a clip path, if non-null


gnome_canvas_item_reset_bounds ()

void        gnome_canvas_item_reset_bounds  (GnomeCanvasItem *item);

Resets the bounding box of a canvas item to an empty rectangle.

item : A canvas item


gnome_canvas_item_update_svp ()

void        gnome_canvas_item_update_svp    (GnomeCanvasItem *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp);

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.

item : the canvas item containing the svp that needs updating.p_svp : a pointer to the existing svpnew_svp : the new svp


gnome_canvas_item_update_svp_clip ()

void        gnome_canvas_item_update_svp_clip
                                            (GnomeCanvasItem *item,
                                             ArtSVP **p_svp,
                                             ArtSVP *new_svp,
                                             ArtSVP *clip_svp);

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.

item : the canvas item containing the svp that needs updating.p_svp : a pointer to the existing svpnew_svp : the new svpclip_svp : a clip path, if non-null


gnome_canvas_item_request_redraw_svp ()

void        gnome_canvas_item_request_redraw_svp
                                            (GnomeCanvasItem *item,
                                             const ArtSVP *svp);

Request redraw of the svp if in aa mode, or the entire item in in xlib mode.

item : the item containing the svpsvp : the svp that needs to be redrawn


gnome_canvas_update_bbox ()

void        gnome_canvas_update_bbox        (GnomeCanvasItem *item,
                                             int x1,
                                             int y1,
                                             int x2,
                                             int y2);

Sets the bbox to the new value, requesting full repaint.

item : x1 : Left coordinate of the new bounding boxy1 : Top coordinate of the new bounding boxx2 : Right coordinate of the new bounding boxy2 : Bottom coordinate of the new bounding box


gnome_canvas_buf_ensure_buf ()

void        gnome_canvas_buf_ensure_buf     (GnomeCanvasBuf *buf);

buf : 


gnome_canvas_load_alpha ()

GdkImlibImage* gnome_canvas_load_alpha      (char *file);

This routine loads a PNG file with full alpha transparency and

file : filename to loadReturns :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.


gnome_canvas_destroy_image ()

void        gnome_canvas_destroy_image      (GdkImlibImage *image);

Do not pass a regular GdkImlibImage to this routine, only pass GdkImlibImage pointer that were created by gnome_canvas_load_alpha

image : A GdkImlibImage allocated by gnome_canvas_load_alpha