callisto-debian/gtk3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: Move documentation to inline comments: regions

Browse Source
This commit is contained in:
Javier Jardón
2010-10-04 03:19:43 +02:00
parent 4e71a4df7b
commit a4c2018452
4 changed files with 35 additions and 72 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
docs/reference/gdk/tmpl/.gitignore vendored
View File

@ -1,3 +1,4 @@
cairo_interaction.sgml cairo_interaction.sgml
dnd.sgml dnd.sgml
regions.sgml
windows.sgml windows.sgml

72
docs/reference/gdk/tmpl/regions.sgml
View File

@ -1,72 +0,0 @@
<!-- ##### SECTION Title ##### -->
Points and Rectangles
<!-- ##### SECTION Short_Description ##### -->
Simple graphical data types
<!-- ##### SECTION Long_Description ##### -->
<para>
GDK provides the #GdkPoint and #GdkRectangle data types for representing pixels
and sets of pixels on the screen. Together with Cairo's #cairo_region_t data
type, they make up the central types for representing graphical data.
</para>
<para>
#GdkPoint is a simple structure containing an x and y coordinate of a point.
</para>
<para>
#GdkRectangle is a structure holding the position and size of a rectangle.
The intersection of two rectangles can be computed with
gdk_rectangle_intersect(). To find the union of two rectangles use
gdk_rectangle_union().
</para>
<para>
#cairo_region_t is usually used for managing clipping of graphical operations.
</para>
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
<!-- ##### SECTION Stability_Level ##### -->
<!-- ##### SECTION Image ##### -->
<!-- ##### STRUCT GdkPoint ##### -->
<para>
Defines the x and y coordinates of a point.
</para>
@x: the x coordinate of the point.
@y: the y coordinate of the point.
<!-- ##### TYPEDEF GdkRectangle ##### -->
<para>
Defines the position and size of a rectangle. It is identical to
#cairo_rectangle_int_t.
</para>
<!-- ##### FUNCTION gdk_rectangle_intersect ##### -->
<para>
</para>
@src1:
@src2:
@dest:
@Returns:
<!-- ##### FUNCTION gdk_rectangle_union ##### -->
<para>
</para>
@src1:
@src2:
@dest:

20
gdk/gdkrectangle.c
View File

@ -28,6 +28,26 @@
#include <gdk/gdk.h> #include <gdk/gdk.h>
/**
* SECTION:regions
* @Short_description: Simple graphical data types
* @Title: Points and Rectangles
*
* GDK provides the #GdkPoint and #GdkRectangle data types for representing pixels
* and sets of pixels on the screen. Together with Cairo's #cairo_region_t data
* type, they make up the central types for representing graphical data.
*
* #GdkPoint is a simple structure containing an x and y coordinate of a point.
*
* #GdkRectangle is a structure holding the position and size of a rectangle.
* The intersection of two rectangles can be computed with
* gdk_rectangle_intersect(). To find the union of two rectangles use
* gdk_rectangle_union().
*
* #cairo_region_t is usually used for managing clipping of graphical operations.
*/
/** /**
* gdk_rectangle_union: * gdk_rectangle_union:
* @src1: a #GdkRectangle * @src1: a #GdkRectangle

14
gdk/gdktypes.h
View File

@ -64,6 +64,13 @@ G_BEGIN_DECLS
/* Type definitions for the basic structures. /* Type definitions for the basic structures.
*/ */
typedef struct _GdkPoint GdkPoint; typedef struct _GdkPoint GdkPoint;
/**
* GdkRectangle:
*
* Defines the position and size of a rectangle. It is identical to
* #cairo_rectangle_int_t.
*/
typedef cairo_rectangle_int_t GdkRectangle; typedef cairo_rectangle_int_t GdkRectangle;
typedef struct _GdkAtom *GdkAtom; typedef struct _GdkAtom *GdkAtom;
@ -245,6 +252,13 @@ typedef enum
GDK_ALL_EVENTS_MASK = 0x3FFFFE GDK_ALL_EVENTS_MASK = 0x3FFFFE
} GdkEventMask; } GdkEventMask;
/**
* GdkPoint:
* @x: the x coordinate of the point.
* @y: the y coordinate of the point.
*
* Defines the x and y coordinates of a point.
*/
struct _GdkPoint struct _GdkPoint
{ {
gint x; gint x;