[gs-cvs] rev 8345 - trunk/gs/src

[giles at ghostscript.com]

Author: giles
Date: 2007-11-02 11:16:45 -0700 (Fri, 02 Nov 2007)
New Revision: 8345

Modified:
   trunk/gs/src/gdevvec.h
Log:
Document the interaction between a the vector device beginpage method
and gdev_vector_stream() more clearly.


Modified: trunk/gs/src/gdevvec.h
===================================================================
--- trunk/gs/src/gdevvec.h	2007-11-01 20:49:28 UTC (rev 8344)
+++ trunk/gs/src/gdevvec.h	2007-11-02 18:16:45 UTC (rev 8345)
@@ -1,4 +1,4 @@
-/* Copyright (C) 2001-2006 Artifex Software, Inc.
+/* Copyright (C) 2001-2007 Artifex Software, Inc.
    All Rights Reserved.
   
    This software is provided AS-IS with no warranty, either express or
@@ -96,6 +96,12 @@
 typedef struct gx_device_vector_procs_s {
     /* Page management */
     int (*beginpage) (gx_device_vector * vdev);
+    /* The beginpage proc is actually called from gdev_vector_stream(),
+       so this accessor must be used from all other procs that want
+       to be called after beginpage and *cannot* be used from within 
+       beginpage. in_page must also be set to false in the device's 
+       output_page method to request that beginpage be called again 
+       when drawing next occurs. */ 
     /* Imager state */
     int (*setlinewidth) (gx_device_vector * vdev, floatp width);
     int (*setlinecap) (gx_device_vector * vdev, gs_line_cap cap);