fdo-mirrors/cairo
1
0
Fork 0
mirror of https://gitlab.freedesktop.org/cairo/cairo.git synced 2026-05-04 21:08:10 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

Update ROADMAP with some comments on 0.5.2.

Browse source 
Add documentation for cairo_set_source_surface and fix some typos in other documentation blocks.
This commit is contained in:
Carl Worth 2005-06-22 17:09:08 +00:00
parent 687f3d78d6
commit b04b434db1
3 changed files with 40 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
ChangeLog
View file

@ -1,3 +1,9 @@
2005-06-22 Carl Worth <cworth@cworth.org>
* ROADMAP: Update ROADMAP with some comments on 0.5.2.
* src/cairo.c:
2005-06-22 Øyvind Kolås <pippin@freedesktop.org>
* doc/public/language-bindings.xml: spelling and whitespace fix.

16
ROADMAP
View file

@ -1,8 +1,9 @@
Here are some quick notes as far as a cairo roadmap goes.
cairo 0.5.2
===========
Get tor to sign off that the win32 stuff is up to snuff
glyph path patch reviewed and committed
See also the TODO file for a different view, (less organized, but
often in more detail, particularly for the API Shakeup work in
progress).
Fix the BadMatch error introduced between 0.5.0 and 0.5.1
cairo 1.0 release requirements
==============================
@ -15,11 +16,11 @@ Implementation work
I2. Real PostScript/PDF fallbacks (cairo_meta_surface_t)
Difficulty: hard
Status: otaylor has drafted a plan or two on the list
Status: krh has a patch that cworth has reviewed. Next version
should land.
API Issues (more detail in TODO file)
-------------------------------------
✓A1. Add cairo_paint
Difficulty: moderate or moderate to minor
Dependencies: much easier after [I1]. needs some cleanups from [A4]
@ -33,8 +34,7 @@ API Issues (more detail in TODO file)
Difficulty: easy to hard (depending on how sophisticated an
implementation is acceptable, and whether the
cairo_meta_surface_t mentioned in [I2] is done)
Status: cworth sent API proposal to the list
(still some unresolved API issues)
Status: cworth has a posted a preliminary patch (still some open questions)
✓A4. Make set_source consistent
Difficulty: easy

29
src/cairo.c
View file

@ -404,6 +404,29 @@ cairo_set_source_rgba (cairo_t *cr,
_cairo_set_source_solid (cr, &color);
}
/**
* cairo_set_source_surface:
* @cr: a cairo context
* @surface: a surface to be used to set the source pattern
* @x: User-space X coordinate for surface origin
* @y: User-space Y coordinate for surface origin
*
* This is a convenience function for creating a pattern from @surface
* and setting it as the source in @cr with cairo_set_source().
*
* The @x and @y parameters give the user-space coordinate at which
* the surface origin should appear. (The surface origin is its
* upper-left corner before any transformation has been applied.) The
* @x and @y patterns are negated and then set as translation values
* in the pattern matrix.
*
* Other than the initial translation pattern matrix, as described
* above, all other pattern attributes, (such as its extend mode), are
* set to the default values as in cairo_pattern_create_for_surface.
* The resulting pattern can be queried with cairo_get_source() so
* that these attributes can be modified if desired, (eg. to create a
* repeating pattern with cairo_pattern_set_extend()).
**/
void
cairo_set_source_surface (cairo_t *cr,
cairo_surface_t *surface,
@ -655,7 +678,7 @@ cairo_set_miter_limit (cairo_t *cr, double limit)
* @tx: amount to translate in the X direction
* @ty: amount to translate in the Y direction
*
* Modifies the current transformation matrix (CTM) by tanslating the
* Modifies the current transformation matrix (CTM) by translating the
* user-space origin by (@tx, @ty). This offset is interpreted as a
* user-space coordinate according to the CTM in place before the new
* call to cairo_translate. In other words, the translation of the
@ -1538,7 +1561,7 @@ cairo_fill_extents (cairo_t *cr,
*
* Calling cairo_clip() can only make the clip region smaller, never
* larger. But the current clip is part of the graphics state, so a
* tempoarary restriction of the clip region can be achieved by
* temporary restriction of the clip region can be achieved by
* calling cairo_clip() within a cairo_save()/cairo_restore()
* pair. The only other means of increasing the size of the clip
* region is cairo_reset_clip().
@ -1568,7 +1591,7 @@ cairo_clip (cairo_t *cr)
*
* Calling cairo_clip() can only make the clip region smaller, never
* larger. But the current clip is part of the graphics state, so a
* tempoarary restriction of the clip region can be achieved by
* temporary restriction of the clip region can be achieved by
* calling cairo_clip() within a cairo_save()/cairo_restore()
* pair. The only other means of increasing the size of the clip
* region is cairo_reset_clip().