GimpDisplayShell-transform

GimpDisplayShell-transform

Synopsis




void                gimp_display_shell_transform_coordinate
                                                        (GimpDisplayShell *shell,
                                                         GimpCoords *image_coords,
                                                         GimpCoords *display_coords);
void                gimp_display_shell_untransform_coordinate
                                                        (GimpDisplayShell *shell,
                                                         GimpCoords *display_coords,
                                                         GimpCoords *image_coords);
void                gimp_display_shell_transform_points (GimpDisplayShell *shell,
                                                         const gdouble *points,
                                                         GdkPoint *coords,
                                                         gint n_points,
                                                         gboolean use_offsets);
void                gimp_display_shell_transform_segments
                                                        (GimpDisplayShell *shell,
                                                         const BoundSeg *src_segs,
                                                         GdkSegment *dest_segs,
                                                         gint n_segs,
                                                         gboolean use_offsets);
void                gimp_display_shell_transform_coords (GimpDisplayShell *shell,
                                                         const GimpCoords *image_coords,
                                                         GdkPoint *disp_coords,
                                                         gint n_coords,
                                                         gboolean use_offsets);
void                gimp_display_shell_transform_xy     (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gint *nx,
                                                         gint *ny,
                                                         gboolean use_offsets);
void                gimp_display_shell_untransform_xy   (GimpDisplayShell *shell,
                                                         gint x,
                                                         gint y,
                                                         gint *nx,
                                                         gint *ny,
                                                         gboolean round,
                                                         gboolean use_offsets);
void                gimp_display_shell_transform_xy_f   (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gdouble *nx,
                                                         gdouble *ny,
                                                         gboolean use_offsets);
void                gimp_display_shell_untransform_xy_f (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gdouble *nx,
                                                         gdouble *ny,
                                                         gboolean use_offsets);
void                gimp_display_shell_untransform_viewport
                                                        (GimpDisplayShell *shell,
                                                         gint *x,
                                                         gint *y,
                                                         gint *width,
                                                         gint *height);

Description

Details

gimp_display_shell_transform_coordinate ()

void                gimp_display_shell_transform_coordinate
                                                        (GimpDisplayShell *shell,
                                                         GimpCoords *image_coords,
                                                         GimpCoords *display_coords);

Transforms from image coordinates to display coordinates, so that objects can be rendered at the correct points on the display.

shell :

 a GimpDisplayShell

image_coords :

 image coordinates

display_coords :

 returns the corresponding display coordinates

gimp_display_shell_untransform_coordinate ()

void                gimp_display_shell_untransform_coordinate
                                                        (GimpDisplayShell *shell,
                                                         GimpCoords *display_coords,
                                                         GimpCoords *image_coords);

Transforms from display coordinates to image coordinates, so that points on the display can be mapped to points in the image.

shell :

 a GimpDisplayShell

display_coords :

 display coordinates

image_coords :

 returns the corresponding image coordinates

gimp_display_shell_transform_points ()

void                gimp_display_shell_transform_points (GimpDisplayShell *shell,
                                                         const gdouble *points,
                                                         GdkPoint *coords,
                                                         gint n_points,
                                                         gboolean use_offsets);

Transforms from image coordinates to display coordinates, so that objects can be rendered at the correct points on the display.

shell :

 a GimpDisplayShell

points :

 array of x, y coordinate pairs

coords :

 returns the corresponding display coordinates

n_points :

 number of points

use_offsets :

 if TRUE, the source coordinates are in the coordinate system of the active drawable instead of the image

gimp_display_shell_transform_segments ()

void                gimp_display_shell_transform_segments
                                                        (GimpDisplayShell *shell,
                                                         const BoundSeg *src_segs,
                                                         GdkSegment *dest_segs,
                                                         gint n_segs,
                                                         gboolean use_offsets);

Transforms from image coordinates to display coordinates, so that objects can be rendered at the correct points on the display.

shell :

 a GimpDisplayShell

src_segs :

 array of segments in image coordinates

dest_segs :

 returns the corresponding segments in display coordinates

n_segs :

 number of segments

use_offsets :

 if TRUE, the source coordinates are in the coordinate system of the active drawable instead of the image

gimp_display_shell_transform_coords ()

void                gimp_display_shell_transform_coords (GimpDisplayShell *shell,
                                                         const GimpCoords *image_coords,
                                                         GdkPoint *disp_coords,
                                                         gint n_coords,
                                                         gboolean use_offsets);

Transforms from image coordinates to display coordinates, so that objects can be rendered at the correct points on the display.

shell :

 a GimpDisplayShell

image_coords :

 array of image coordinates

disp_coords :

 returns the corresponding display coordinates

n_coords :

 number of coordinates

use_offsets :

 if TRUE, the source coordinates are in the coordinate system of the active drawable instead of the image

gimp_display_shell_transform_xy ()

void                gimp_display_shell_transform_xy     (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gint *nx,
                                                         gint *ny,
                                                         gboolean use_offsets);

shell :

x :

y :

nx :

ny :

use_offsets :

gimp_display_shell_untransform_xy ()

void                gimp_display_shell_untransform_xy   (GimpDisplayShell *shell,
                                                         gint x,
                                                         gint y,
                                                         gint *nx,
                                                         gint *ny,
                                                         gboolean round,
                                                         gboolean use_offsets);

Transform from display coordinates to image coordinates, so that points on the display can be mapped to the corresponding points in the image.

shell :

 a GimpDisplayShell

x :

 x coordinate in display coordinates

y :

 y coordinate in display coordinates

nx :

 returns x oordinate in image coordinates

ny :

 returns y coordinate in image coordinates

round :

 if TRUE, round the results to the nearest integer; if FALSE, simply cast them to gint.

use_offsets :

 if TRUE, nx and ny will be returned in the coordinate system of the active drawable instead of the image

gimp_display_shell_transform_xy_f ()

void                gimp_display_shell_transform_xy_f   (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gdouble *nx,
                                                         gdouble *ny,
                                                         gboolean use_offsets);

This function is identical to gimp_display_shell_transfrom_xy(), except that it returns its results as doubles rather than ints.

shell :

 a GimpDisplayShell

x :

 x coordinate of point in image coordinates

y :

 y coordinate of point in image coordinate

nx :

 returns the transformed x coordinate

ny :

 returns the transformed y coordinate

use_offsets :

 if TRUE, the x and y coordinates are in the coordinate system of the active drawable instead of the image

gimp_display_shell_untransform_xy_f ()

void                gimp_display_shell_untransform_xy_f (GimpDisplayShell *shell,
                                                         gdouble x,
                                                         gdouble y,
                                                         gdouble *nx,
                                                         gdouble *ny,
                                                         gboolean use_offsets);

This function is identical to gimp_display_shell_untransform_xy(), except that the input and output coordinates are doubles rather than ints, and consequently there is no option related to rounding.

shell :

 a GimpDisplayShell

x :

 x coordinate in display coordinates

y :

 y coordinate in display coordinates

nx :

 place to return x coordinate in image coordinates

ny :

 place to return y coordinate in image coordinates

use_offsets :

 if TRUE, nx and ny will be returned in the coordinate system of the active drawable instead of the image

gimp_display_shell_untransform_viewport ()

void                gimp_display_shell_untransform_viewport
                                                        (GimpDisplayShell *shell,
                                                         gint *x,
                                                         gint *y,
                                                         gint *width,
                                                         gint *height);

This function calculates the part of the image, im image coordinates, that corresponds to the display viewport.

shell :

 a GimpDisplayShell

x :

 returns image x coordinate of display upper left corner

y :

 returns image y coordinate of display upper left corner

width :

 returns width of display measured in image coordinates

height :

 returns height of display measured in image coordinates