From 4f8f06c449a1cafcac126189d47580cd7a38108b Mon Sep 17 00:00:00 2001 From: Miguel de Icaza Date: Tue, 12 Oct 2004 19:26:02 +0000 Subject: [PATCH] Flush svn path=/trunk/gtk-sharp/; revision=34925 --- AUTHORS | 1 + doc/en/Gdk/Drawable.xml | 290 +++++++++++++++++++++------------------- doc/en/Gtk/Window.xml | 7 +- 3 files changed, 158 insertions(+), 140 deletions(-) diff --git a/AUTHORS b/AUTHORS index 80caabeb4..7f50daa51 100644 --- a/AUTHORS +++ b/AUTHORS @@ -13,3 +13,4 @@ Documentation: chris@turchin.net (Chris Turchin) jaspervp@gmx.net (Jasper van Putten) wizito@gentelibre.org ( Néstor Salceda) + cmorgan@alum.wpi.edu diff --git a/doc/en/Gdk/Drawable.xml b/doc/en/Gdk/Drawable.xml index a4682a24a..b1d3ddfe2 100644 --- a/doc/en/Gdk/Drawable.xml +++ b/doc/en/Gdk/Drawable.xml @@ -40,9 +40,9 @@ Draws a number of points using the given graphics context. - A - An array of objects. - A + A + An array of objects. + A NOTE: Drawable.custom needs to be fixed to implement this properly. @@ -61,18 +61,18 @@ - Render a onto the Drawable + Render a onto the Drawable object, overriding the layout's normal colors with - and/or . - and + and/or . + and need not be allocated. - A , the graphics context to use - A , the X position of the left of the layout (in pixels) - A , the Y position of the top of the layout (in pixels) - A , the layout to render - A , the foreground color - A , the background color - + A , the graphics context to use + A , the X position of the left of the layout (in pixels) + A , the Y position of the top of the layout (in pixels) + A , the layout to render + A , the foreground color + A , the background color + @@ -88,13 +88,13 @@ - Render a onto the Drawable + Render a onto the Drawable object. - A , the graphics context to use - A , the X position of the start of string (in pixels) - A , the Y position of the baseline (in pixels) - A - + A , the graphics context to use + A , the X position of the start of string (in pixels) + A , the Y position of the baseline (in pixels) + A + @@ -112,18 +112,18 @@ - Render a onto the Drawable + Render a onto the Drawable object, overriding the layout's normal colors with - and/or . - and + and/or . + and need not be allocated. - A , the graphics context to use - A , the X position of the start of string (in pixels) - A , the Y position of the baseline (in pixels) - A , a line of text to render - A , the foreground color - A , the background color - + A , the graphics context to use + A , the X position of the start of string (in pixels) + A , the Y position of the baseline (in pixels) + A , a line of text to render + A , the foreground color + A , the background color + @@ -140,10 +140,10 @@ Render a onto a - A - A - A - A + A + A + A + A If you are using Gtk, the usual way to obtain a is . @@ -158,15 +158,15 @@ - Fills and - with the size of the Drawable. or - can be if you + Fills and + with the size of the Drawable. or + can be if you only want the other one. - A - A + A + A - On the X11 platform, if this Drawable object is also a , the returned + On the X11 platform, if this Drawable object is also a , the returned size is the size reported in the most-recently-processed configure event, rather than the current size on the X server. @@ -185,9 +185,9 @@ Draws a number of unconnected lines. - A - A , a list of segments to draw. - A , the number of segments. + A + A , a list of segments to draw. + A , the number of segments. TODO: Drawable.custom needs to be edited to make segs an array of Gdk.Segment objects. @@ -206,20 +206,20 @@ -

This is a low-level function; 99% of text rendering should be done - using instead.

-

A glyph is a character in a font. This function draws a sequence of +

This is a low-level function; 99% of text rendering should be done + using instead.

+

A glyph is a character in a font. This function draws a sequence of glyphs. To obtain a sequence of glyphs you have to understand a lot about internationalized text handling, which you don't want to - understand; thus, use instead of this function, - handles the details.

- - A - A - A - A - A - + understand; thus, use instead of this function, + handles the details.

+ + A + A + A + A + A + @@ -236,53 +236,58 @@ -

- A stores client-side image data (pixels). In contrast, - and are server-side +

+ A stores client-side image data (pixels). In contrast, + and are server-side objects. This method obtains the pixels from a - server-side drawable as a client-side . -

- The format of a depends on - the of the current display, which - makes manipulating extremely difficult; + server-side drawable as a client-side . +

+

+ The format of a depends on + the of the current display, which + makes manipulating extremely difficult; therefore, in - most cases you should use + most cases you should use instead of - this lower-level function. A contains + this lower-level function. A contains image data in a canonicalized RGB format, rather than a display-dependent format. Of course, there's a convenience vs. speed tradeoff here, so you'll want to think about what makes sense for your application.

- - A , X coordinate of the upper left corner of the region to get as a drawable - A , Y coordinate of the upper left corner of the region to get as a drawable. - A , width of the rectangle - A , height of the rectangle. - A containing the contents of this Drawable object. + + A , X coordinate of the upper left corner of the region to get as a drawable + A , Y coordinate of the upper left corner of the region to get as a drawable. + A , width of the rectangle + A , height of the rectangle. + A containing the contents of this Drawable object. -

-

- , , - , and define +

+

+

+ , , + , and define the region of the drawable to obtain as an image. -

+

+

You would usually copy image data to the client side if you intend to examine the values of individual pixels, for example to darken an image or add a red tint. It would be prohibitively slow to make a round-trip request to the windowing system for each pixel, so instead you get all of them at once, modify them, then copy them all back at once. -

+

+

If the X server or other windowing system backend is on the local machine, this function may use shared memory to avoid copying the image data. -

+

+

If the source drawable is a #GdkWindow and partially offscreen or obscured, then the obscured portions of the returned image will contain undefined data.

- + @@ -303,21 +308,21 @@ - Copies the x region of at coordinates (, - ) to coordinates (, ) in . - and/or may be given as -1, in which case the entire - drawable will be copied. - Most fields in are not used for this operation, but notably the + Copies the x region of at coordinates (, + ) to coordinates (, ) in . + and/or may be given as -1, in which case the entire + drawable will be copied. + Most fields in are not used for this operation, but notably the clip mask or clip region will be honored. - A - A , the source Drawable. - A - A - A - A - A - A + A + A , the source Drawable. + A + A + A + A + A + A The source and destination drawables must have the same visual and colormap, or errors will result. (On X11, failure to match @@ -326,9 +331,8 @@ a color drawable. The way to draw a bitmap is to set the bitmap as a clip mask on your #GdkGC, then use gdk_draw_rectangle() to draw a rectangle clipped to the bitmap. -

TODO: This API needs to be adjusted; should - probably not exist.

- +

TODO: This API needs to be adjusted; should + probably not exist.

 @@ -349,14 +353,14 @@ Draws a onto a drawable. - A - A - A - A - A - A - A - A + A + A + A + A + A + A + A + A The depth of the must match the depth of the . @@ -372,11 +376,11 @@ - Draws a point at (,). - A - A - A - + Draws a point at (,). + A + A + A + @@ -424,9 +428,9 @@ when using a #GdkGC to draw to a drawable, or copying one drawable to another, the colormaps should match. - A - A - + A + A + @@ -437,8 +441,8 @@ To be added - A - + A + @@ -449,8 +453,8 @@ To be added - A - + A + @@ -461,8 +465,8 @@ To be added - A - + A + @@ -473,8 +477,8 @@ To be added - A - + A + @@ -486,7 +490,7 @@ To be added a - + @@ -498,7 +502,7 @@ To be added a - + @@ -515,7 +519,7 @@ To be added a a - + @@ -576,7 +580,7 @@ a a a - + @@ -599,13 +603,27 @@ To be added a a - a - a + a +The x-coordinate of the upper left hand of the bounding box of the arc. + + a +The y-coordinate of the upper left hand of the bounding box of the arc. + a a - a - a - + a +The starting angle of the arc in the clockwise direction in reference to the 3'oclock position in terms of 1/64th of a degree. + + a +The number of 1/64ths of a degree to sweep the arc in a clockwise direction relative to the starting angle. + + + + Draw the left side of a circle with a radius of 5 units. + + Gdk.Pixmap.DrawArc(gc, false, 0, 0, 10, 10, 90 * 64, 180 * 64); + + @@ -640,7 +658,7 @@ a a a - + @@ -703,7 +721,7 @@ This is a constructor used by derivative types of Drawable. This is not typically used by C# code. a - + @@ -732,7 +750,7 @@ a a a - + @@ -765,7 +783,7 @@ a a a - + @@ -796,7 +814,7 @@ a a a - + @@ -825,7 +843,7 @@ a a a - + @@ -854,7 +872,7 @@ a a a - + @@ -887,7 +905,7 @@ a a a - + @@ -911,4 +929,4 @@ - + \ No newline at end of file diff --git a/doc/en/Gtk/Window.xml b/doc/en/Gtk/Window.xml index a4f9b3fb5..766e45f00 100644 --- a/doc/en/Gtk/Window.xml +++ b/doc/en/Gtk/Window.xml @@ -868,10 +868,9 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height); - Sets ot obtains the transient parent. + Sets or obtains the transient parent window. Parent . - - + Dialog windows should be transient for the main they were spawned from, this allows windows managers to e.g. keep the dialog on top of the main , or center the dialog over the main . @@ -1632,4 +1631,4 @@ Console.WriteLine("Width: {0}, Height: {1}" , width , height); - + \ No newline at end of file