mirror of
https://gitlab.freedesktop.org/cairo/cairo.git
synced 2025-12-25 00:10:10 +01:00
doc fix - 90 degrees is MI_PI/2 radians.
src/cairo.c src/cairo_matrix.c src/cairo_ft_font.c src/cairo_ps_surface.c src/cairo_quartz_surface.c src/cairo_win32_font.c src/cairo_win32_surface.c src/cairo_xlib_surface.c: Cairo is only capitalized at the beginning of sentences.
This commit is contained in:
Owen Taylor
parent
58420806bb
commit
2ad590a0ee
16 changed files with 49 additions and 38 deletions
11
ChangeLog
11
ChangeLog
|
|
@ -1,3 +1,14 @@
|
|||
2005-03-17 Owen Taylor <otaylor@redhat.com>
|
||||
|
||||
* src/cairo_matrix.c (cairo_matrix_rotate): doc fix -
|
||||
90 degrees is MI_PI/2 radians.
|
||||
|
||||
* src/cairo.c src/cairo_matrix.c src/cairo_ft_font.c
|
||||
src/cairo_ps_surface.c src/cairo_quartz_surface.c
|
||||
src/cairo_win32_font.c src/cairo_win32_surface.c
|
||||
src/cairo_xlib_surface.c: Cairo is only capitalized
|
||||
at the beginning of sentences.
|
||||
|
||||
2005-03-17 Kristian Høgsberg <krh@redhat.com>
|
||||
|
||||
From Tor Lillqvist <tml@novell.com>:
|
||||
|
|
|
|||
|
|
@ -1372,7 +1372,7 @@ cairo_ft_font_create (FcPattern *pattern,
|
|||
* Creates a new font forthe FreeType font backend from a pre-opened
|
||||
* FreeType face. This font can then be used with cairo_set_font(),
|
||||
* cairo_font_glyph_extents(), or FreeType backend specific
|
||||
* functions like cairo_ft_font_lock_face() Cairo will determine the
|
||||
* functions like cairo_ft_font_lock_face() cairo will determine the
|
||||
* pixel size and transformation from the @scale parameter and call
|
||||
* FT_Set_Transform() and FT_Set_Pixel_Sizes().
|
||||
*
|
||||
|
|
|
|||
|
|
@ -297,9 +297,9 @@ _cairo_matrix_set_rotate (cairo_matrix_t *matrix,
|
|||
* cairo_matrix_rotate:
|
||||
* @matrix: a @cairo_matrix_t
|
||||
* @radians: angle of rotation, in radians. Angles are defined
|
||||
* so that an angle of 90 degrees (%M_PI radians) rotates the
|
||||
* so that an angle of 90 degrees (%M_PI/2 radians) rotates the
|
||||
* positive X axis into the positive Y axis. With the default
|
||||
* Cairo choice of axis orientation, positive rotations are
|
||||
* cairo choice of axis orientation, positive rotations are
|
||||
* clockwise.
|
||||
*
|
||||
* Applies rotation by @radians to the transformation in
|
||||
|
|
|
|||
|
|
@ -49,8 +49,8 @@ static const cairo_surface_backend_t cairo_ps_surface_backend;
|
|||
* @width_inches: width of the output page, in inches
|
||||
* @height_inches: height of the output page, in inches
|
||||
* @x_pixels_per_inch: X resolution to use for image fallbacks;
|
||||
* not all Cairo drawing can be represented in a postscript
|
||||
* file, so Cairo will write out images for some portions
|
||||
* not all cairo drawing can be represented in a postscript
|
||||
* file, so cairo will write out images for some portions
|
||||
* of the output.
|
||||
* @y_pixels_per_inch: Y resolution to use for image fallbacks.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -151,7 +151,7 @@ _cairo_quartz_surface_get_image(void *abstract_surface)
|
|||
|
||||
|
||||
// We keep a cached (cairo_image_surface_t *) in the cairo_quartz_surface_t
|
||||
// struct. If the window is ever drawn to without going through Cairo, then
|
||||
// struct. If the window is ever drawn to without going through cairo, then
|
||||
// we would need to refetch the pixel data from the window into the cached
|
||||
// image surface.
|
||||
if (surface->image)
|
||||
|
|
@ -195,7 +195,7 @@ _cairo_quartz_surface_get_image(void *abstract_surface)
|
|||
rowBytes);
|
||||
|
||||
|
||||
// Set the image surface Cairo state to match our own.
|
||||
// Set the image surface cairo state to match our own.
|
||||
_cairo_image_surface_set_repeat(surface->image, surface->base.repeat);
|
||||
_cairo_image_surface_set_matrix(surface->image, &(surface->base.matrix));
|
||||
|
||||
|
|
@ -381,7 +381,7 @@ cairo_quartz_surface_create( CGContextRef context,
|
|||
surface->cgImage = NULL;
|
||||
|
||||
|
||||
// Set up the image surface which Cairo draws into and we blit to & from.
|
||||
// Set up the image surface which cairo draws into and we blit to & from.
|
||||
surface->image = _cairo_quartz_surface_get_image(surface);
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1174,7 +1174,7 @@ cairo_win32_font_create_for_logfontw (LOGFONTW *logfont,
|
|||
* map mode and world transformation of the device context to match
|
||||
* that of the font. This function is intended for use when using
|
||||
* layout APIs such as Uniscribe to do text layout with the
|
||||
* Cairo font. After finishing using the device context, you must call
|
||||
* cairo font. After finishing using the device context, you must call
|
||||
* cairo_win32_font_done_font() to release any resources allocated
|
||||
* by this function.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -46,7 +46,7 @@ static const cairo_surface_backend_t cairo_win32_surface_backend;
|
|||
* Helper function to dump out a human readable form of the
|
||||
* current error code.
|
||||
*
|
||||
* Return value: A Cairo status code for the error code
|
||||
* Return value: A cairo status code for the error code
|
||||
**/
|
||||
cairo_status_t
|
||||
_cairo_win32_print_gdi_error (const char *context)
|
||||
|
|
@ -739,14 +739,14 @@ _cairo_win32_surface_set_clip_region (void *abstract_surface,
|
|||
if (surface->image)
|
||||
_cairo_surface_set_clip_region (surface->image, region);
|
||||
|
||||
/* The semantics we want is that any clip set by Cairo combines
|
||||
/* The semantics we want is that any clip set by cairo combines
|
||||
* is intersected with the clip on device context that the
|
||||
* surface was created for. To implement this, we need to
|
||||
* save the original clip when first setting a clip on surface.
|
||||
*/
|
||||
|
||||
if (region == NULL) {
|
||||
/* Clear any clip set by Cairo, return to the original */
|
||||
/* Clear any clip set by cairo, return to the original */
|
||||
|
||||
if (surface->set_clip) {
|
||||
if (SelectClipRgn (surface->dc, surface->saved_clip) == ERROR)
|
||||
|
|
|
|||
|
|
@ -1043,13 +1043,13 @@ DEPRECATE (cairo_surface_create_for_drawable, cairo_xlib_surface_create);
|
|||
* cairo_xlib_surface_create_for_pixmap:
|
||||
* @dpy: an X display
|
||||
* @pixmap: an X pixmap
|
||||
* @format: a standard Cairo pixel data format. The depth (number of
|
||||
* @format: a standard cairo pixel data format. The depth (number of
|
||||
* of bits used) for the format must match the depth of
|
||||
* @pixmap.
|
||||
*
|
||||
* Creates an Xlib surface that draws to the given pixmap.
|
||||
* The way that colors are represented in the pixmap is specified
|
||||
* by giving one of Cairo's standard pixel data formats.
|
||||
* by giving one of cairo's standard pixel data formats.
|
||||
*
|
||||
* For maximum efficiency, if you know the size of the pixmap,
|
||||
* you should call cairo_xlib_surface_set_size().
|
||||
|
|
@ -1080,7 +1080,7 @@ cairo_xlib_surface_create_for_pixmap (Display *dpy,
|
|||
*
|
||||
* Normally, you would use this function instead of
|
||||
* cairo_xlib_surface_create_for_pixmap() when you double-buffering by
|
||||
* using Cairo to draw to pixmap and then XCopyArea() to copy the
|
||||
* using cairo to draw to pixmap and then XCopyArea() to copy the
|
||||
* results to a window. In that case, @visual is the visual of the
|
||||
* window.
|
||||
*
|
||||
|
|
@ -1110,7 +1110,7 @@ cairo_xlib_surface_create_for_pixmap_with_visual (Display *dpy,
|
|||
* Creates a new XLib backend surface that draws to the given Window.
|
||||
*
|
||||
* For maximum efficiency, you should use cairo_xlib_surface_set_size()
|
||||
* to inform Cairo of the size of the window.
|
||||
* to inform cairo of the size of the window.
|
||||
*
|
||||
* Return value: the newly created surface.
|
||||
**/
|
||||
|
|
@ -1131,8 +1131,8 @@ cairo_xlib_surface_create_for_window_with_visual (Display *dpy,
|
|||
* @width: the new width of the surface
|
||||
* @height: the new height of the surface
|
||||
*
|
||||
* Informs Cairo of the size of the X drawable underlying the
|
||||
* surface. This allows Cairo to avoid querying the server for the
|
||||
* Informs cairo of the size of the X drawable underlying the
|
||||
* surface. This allows cairo to avoid querying the server for the
|
||||
* size, which can be a significant performance bottleneck.
|
||||
*
|
||||
* For a surface created for a pixmap, it is only necessary to call
|
||||
|
|
|
|||
|
|
@ -795,7 +795,7 @@ cairo_curve_to (cairo_t *cr,
|
|||
|
||||
/**
|
||||
* cairo_arc:
|
||||
* @cr: a Cairo context
|
||||
* @cr: a cairo context
|
||||
* @xc: X position of the center of the arc
|
||||
* @yc: Y position of the center of the arc
|
||||
* @radius: the radius of the arc
|
||||
|
|
@ -845,7 +845,7 @@ cairo_arc (cairo_t *cr,
|
|||
|
||||
/**
|
||||
* cairo_arc_negative:
|
||||
* @cr: a Cairo context
|
||||
* @cr: a cairo context
|
||||
* @xc: X position of the center of the arc
|
||||
* @yc: Y position of the center of the arc
|
||||
* @radius: the radius of the arc
|
||||
|
|
|
|||
|
|
@ -1372,7 +1372,7 @@ cairo_ft_font_create (FcPattern *pattern,
|
|||
* Creates a new font forthe FreeType font backend from a pre-opened
|
||||
* FreeType face. This font can then be used with cairo_set_font(),
|
||||
* cairo_font_glyph_extents(), or FreeType backend specific
|
||||
* functions like cairo_ft_font_lock_face() Cairo will determine the
|
||||
* functions like cairo_ft_font_lock_face() cairo will determine the
|
||||
* pixel size and transformation from the @scale parameter and call
|
||||
* FT_Set_Transform() and FT_Set_Pixel_Sizes().
|
||||
*
|
||||
|
|
|
|||
|
|
@ -297,9 +297,9 @@ _cairo_matrix_set_rotate (cairo_matrix_t *matrix,
|
|||
* cairo_matrix_rotate:
|
||||
* @matrix: a @cairo_matrix_t
|
||||
* @radians: angle of rotation, in radians. Angles are defined
|
||||
* so that an angle of 90 degrees (%M_PI radians) rotates the
|
||||
* so that an angle of 90 degrees (%M_PI/2 radians) rotates the
|
||||
* positive X axis into the positive Y axis. With the default
|
||||
* Cairo choice of axis orientation, positive rotations are
|
||||
* cairo choice of axis orientation, positive rotations are
|
||||
* clockwise.
|
||||
*
|
||||
* Applies rotation by @radians to the transformation in
|
||||
|
|
|
|||
|
|
@ -49,8 +49,8 @@ static const cairo_surface_backend_t cairo_ps_surface_backend;
|
|||
* @width_inches: width of the output page, in inches
|
||||
* @height_inches: height of the output page, in inches
|
||||
* @x_pixels_per_inch: X resolution to use for image fallbacks;
|
||||
* not all Cairo drawing can be represented in a postscript
|
||||
* file, so Cairo will write out images for some portions
|
||||
* not all cairo drawing can be represented in a postscript
|
||||
* file, so cairo will write out images for some portions
|
||||
* of the output.
|
||||
* @y_pixels_per_inch: Y resolution to use for image fallbacks.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -151,7 +151,7 @@ _cairo_quartz_surface_get_image(void *abstract_surface)
|
|||
|
||||
|
||||
// We keep a cached (cairo_image_surface_t *) in the cairo_quartz_surface_t
|
||||
// struct. If the window is ever drawn to without going through Cairo, then
|
||||
// struct. If the window is ever drawn to without going through cairo, then
|
||||
// we would need to refetch the pixel data from the window into the cached
|
||||
// image surface.
|
||||
if (surface->image)
|
||||
|
|
@ -195,7 +195,7 @@ _cairo_quartz_surface_get_image(void *abstract_surface)
|
|||
rowBytes);
|
||||
|
||||
|
||||
// Set the image surface Cairo state to match our own.
|
||||
// Set the image surface cairo state to match our own.
|
||||
_cairo_image_surface_set_repeat(surface->image, surface->base.repeat);
|
||||
_cairo_image_surface_set_matrix(surface->image, &(surface->base.matrix));
|
||||
|
||||
|
|
@ -381,7 +381,7 @@ cairo_quartz_surface_create( CGContextRef context,
|
|||
surface->cgImage = NULL;
|
||||
|
||||
|
||||
// Set up the image surface which Cairo draws into and we blit to & from.
|
||||
// Set up the image surface which cairo draws into and we blit to & from.
|
||||
surface->image = _cairo_quartz_surface_get_image(surface);
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1174,7 +1174,7 @@ cairo_win32_font_create_for_logfontw (LOGFONTW *logfont,
|
|||
* map mode and world transformation of the device context to match
|
||||
* that of the font. This function is intended for use when using
|
||||
* layout APIs such as Uniscribe to do text layout with the
|
||||
* Cairo font. After finishing using the device context, you must call
|
||||
* cairo font. After finishing using the device context, you must call
|
||||
* cairo_win32_font_done_font() to release any resources allocated
|
||||
* by this function.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -46,7 +46,7 @@ static const cairo_surface_backend_t cairo_win32_surface_backend;
|
|||
* Helper function to dump out a human readable form of the
|
||||
* current error code.
|
||||
*
|
||||
* Return value: A Cairo status code for the error code
|
||||
* Return value: A cairo status code for the error code
|
||||
**/
|
||||
cairo_status_t
|
||||
_cairo_win32_print_gdi_error (const char *context)
|
||||
|
|
@ -739,14 +739,14 @@ _cairo_win32_surface_set_clip_region (void *abstract_surface,
|
|||
if (surface->image)
|
||||
_cairo_surface_set_clip_region (surface->image, region);
|
||||
|
||||
/* The semantics we want is that any clip set by Cairo combines
|
||||
/* The semantics we want is that any clip set by cairo combines
|
||||
* is intersected with the clip on device context that the
|
||||
* surface was created for. To implement this, we need to
|
||||
* save the original clip when first setting a clip on surface.
|
||||
*/
|
||||
|
||||
if (region == NULL) {
|
||||
/* Clear any clip set by Cairo, return to the original */
|
||||
/* Clear any clip set by cairo, return to the original */
|
||||
|
||||
if (surface->set_clip) {
|
||||
if (SelectClipRgn (surface->dc, surface->saved_clip) == ERROR)
|
||||
|
|
|
|||
|
|
@ -1043,13 +1043,13 @@ DEPRECATE (cairo_surface_create_for_drawable, cairo_xlib_surface_create);
|
|||
* cairo_xlib_surface_create_for_pixmap:
|
||||
* @dpy: an X display
|
||||
* @pixmap: an X pixmap
|
||||
* @format: a standard Cairo pixel data format. The depth (number of
|
||||
* @format: a standard cairo pixel data format. The depth (number of
|
||||
* of bits used) for the format must match the depth of
|
||||
* @pixmap.
|
||||
*
|
||||
* Creates an Xlib surface that draws to the given pixmap.
|
||||
* The way that colors are represented in the pixmap is specified
|
||||
* by giving one of Cairo's standard pixel data formats.
|
||||
* by giving one of cairo's standard pixel data formats.
|
||||
*
|
||||
* For maximum efficiency, if you know the size of the pixmap,
|
||||
* you should call cairo_xlib_surface_set_size().
|
||||
|
|
@ -1080,7 +1080,7 @@ cairo_xlib_surface_create_for_pixmap (Display *dpy,
|
|||
*
|
||||
* Normally, you would use this function instead of
|
||||
* cairo_xlib_surface_create_for_pixmap() when you double-buffering by
|
||||
* using Cairo to draw to pixmap and then XCopyArea() to copy the
|
||||
* using cairo to draw to pixmap and then XCopyArea() to copy the
|
||||
* results to a window. In that case, @visual is the visual of the
|
||||
* window.
|
||||
*
|
||||
|
|
@ -1110,7 +1110,7 @@ cairo_xlib_surface_create_for_pixmap_with_visual (Display *dpy,
|
|||
* Creates a new XLib backend surface that draws to the given Window.
|
||||
*
|
||||
* For maximum efficiency, you should use cairo_xlib_surface_set_size()
|
||||
* to inform Cairo of the size of the window.
|
||||
* to inform cairo of the size of the window.
|
||||
*
|
||||
* Return value: the newly created surface.
|
||||
**/
|
||||
|
|
@ -1131,8 +1131,8 @@ cairo_xlib_surface_create_for_window_with_visual (Display *dpy,
|
|||
* @width: the new width of the surface
|
||||
* @height: the new height of the surface
|
||||
*
|
||||
* Informs Cairo of the size of the X drawable underlying the
|
||||
* surface. This allows Cairo to avoid querying the server for the
|
||||
* Informs cairo of the size of the X drawable underlying the
|
||||
* surface. This allows cairo to avoid querying the server for the
|
||||
* size, which can be a significant performance bottleneck.
|
||||
*
|
||||
* For a surface created for a pixmap, it is only necessary to call
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue