From 01c2214d802977d2c2eac05f177abe88d9ef714d Mon Sep 17 00:00:00 2001 From: Matthew Flatt Date: Wed, 1 Oct 2008 15:54:36 +0000 Subject: [PATCH] doc clarifications on dc-path svn: r11919 --- collects/scribblings/gui/dc-intf.scrbl | 17 ++++++++++------- collects/scribblings/gui/dc-path-class.scrbl | 3 ++- collects/scribblings/gui/gui.scrbl | 13 +++++++++++++ 3 files changed, 25 insertions(+), 8 deletions(-) diff --git a/collects/scribblings/gui/dc-intf.scrbl b/collects/scribblings/gui/dc-intf.scrbl index 14a73d9b27..92b6c4c97b 100644 --- a/collects/scribblings/gui/dc-intf.scrbl +++ b/collects/scribblings/gui/dc-intf.scrbl @@ -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 diff --git a/collects/scribblings/gui/dc-path-class.scrbl b/collects/scribblings/gui/dc-path-class.scrbl index 131bf593f8..e37bf31158 100644 --- a/collects/scribblings/gui/dc-path-class.scrbl +++ b/collects/scribblings/gui/dc-path-class.scrbl @@ -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 diff --git a/collects/scribblings/gui/gui.scrbl b/collects/scribblings/gui/gui.scrbl index 0b319e650e..aadaf8f21e 100644 --- a/collects/scribblings/gui/gui.scrbl +++ b/collects/scribblings/gui/gui.scrbl @@ -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[]