suzanne.soy/racket
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

doc clarifications on dc-path

Browse Source 
svn: r11919
This commit is contained in:
Matthew Flatt 2008-10-01 15:54:36 +00:00
parent 1097cb35a6
commit 01c2214d80
3 changed files with 25 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
collects/scribblings/gui/dc-intf.scrbl
View File

@ -199,9 +199,10 @@ See also @method[dc<%> set-smoothing] for information on the
void?]{
Draws the sub-paths of the given @scheme[dc-path%] object, adding
@scheme[xoffset] and @scheme[yoffset] to each point. The current pen
is used for drawing the path as a line, and the current brush is used
for filling the area bounded by the path.
@scheme[xoffset] and @scheme[yoffset] to each point. (See
@scheme[dc-path%] for general information on paths and sub-paths.)
The current pen is used for drawing the path as a line, and the
current brush is used for filling the area bounded by the path.
If both the pen and brush are non-transparent, the path is filled with
the brush before the outline is drawn with the pen. The filling and
@ -350,11 +351,13 @@ See also @method[dc<%> set-smoothing] for information on the
[y3 real?])
void?]{
Draws a spline from (@scheme[x1], @scheme[y1]) to (@scheme[x3], @scheme[y3])
using (@scheme[x2], @scheme[y2]) as the control point.
@index['("drawing curves")]{Draws} a spline from (@scheme[x1],
@scheme[y1]) to (@scheme[x3], @scheme[y3]) using (@scheme[x2],
@scheme[y2]) as the control point.
See also @method[dc<%> set-smoothing] for information on the
@scheme['aligned] smoothing mode.
@scheme['aligned] smoothing mode. See also @scheme[dc-path%] and
@method[dc<%> draw-path] for drawing more complex curves.
@|DrawSizeNote|
@ -918,7 +921,7 @@ Starts a page, relevant only when drawing to a printer or PostScript
device (including to a PostScript file).
For printer or PostScript output, an exception is raised if
@scheme[start-doc] is called when a page is already started, or when
@scheme[start-page] is called when a page is already started, or when
@method[dc<%> start-doc] has not been called, or when @method[dc<%>
end-doc] has been called already. In addition, in the case of
PostScript output, Encapsulated PostScript (EPS) cannot contain

3
collects/scribblings/gui/dc-path-class.scrbl
View File

@ -14,7 +14,8 @@ A path consists of zero or more @deftech{closed sub-paths}, and
possibly one @deftech{open sub-path}. Some @scheme[dc-path%] methods
extend the open sub-path, some @scheme[dc-path%] methods close the
open sub-path, and some @scheme[dc-path%] methods add closed
sub-paths.
sub-paths. This approach to drawing formulation is inherited from
PostScript @cite["Adobe99"].
When a path is drawn as a line, a closed sub-path is drawn as a closed
figure, analogous to a polygon. An open sub-path is drawn with

13
collects/scribblings/gui/gui.scrbl
View File

@ -31,6 +31,19 @@ provides; this library cannot run in MzScheme.}
@include-section["config.scrbl"]
@include-section["dynamic.scrbl"]
@;------------------------------------------------------------------------
@(bibliography
(bib-entry #:key "Adobe99"
#:author "Adobe Systems Incorporated"
#:title @italic{PostScript Language Reference, third edition}
#:url "http://partners.adobe.com/public/developer/en/ps/PLRM.pdf"
#:date "1999")
)
@;------------------------------------------------------------------------
@index-section[]