###############################################################################

#

#	ReportLab Public License Version 1.0

#

#   Except for the change of names the spirit and intention of this

#   license is the same as that of Python

#

#	(C) Copyright ReportLab Inc. 1998-2000.

#

#

# All Rights Reserved

#

# Permission to use, copy, modify, and distribute this software and its

# documentation for any purpose and without fee is hereby granted, provided

# that the above copyright notice appear in all copies and that both that

# copyright notice and this permission notice appear in supporting

# documentation, and that the name of ReportLab not be used

# in advertising or publicity pertaining to distribution of the software

# without specific, written prior permission. 

# 

#

# Disclaimer

#

# ReportLab Inc. DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS

# SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS,

# IN NO EVENT SHALL ReportLab BE LIABLE FOR ANY SPECIAL, INDIRECT

# OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS

# OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR

# OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR

# PERFORMANCE OF THIS SOFTWARE. 

#

###############################################################################

#	$Log: canvas.py,v $

#	Revision 1.27  2000/04/14 11:28:32  andy_robinson

#	Removed illegal append statement usage in canvas.grid()

#	Revision 1.26  2000/04/12 16:26:51  rgbecker

#	XML Tagged Paragraph parser changes

#	

#	Revision 1.25  2000/04/10 09:21:21  andy_robinson

#	Color methods in textobject and canvas now synchronised.

#	Added 'verbosity' keyword to allow hiding of 'save myfile.pdf' messages.

#	

#	Revision 1.24  2000/04/06 09:52:02  andy_robinson

#	Removed some old comments; tweaks to experimental Outline methods.

#	

#	Revision 1.23  2000/04/05 16:26:36  rgbecker

#	Fixes to setFill/StrokeColor

#	

#	Revision 1.22  2000/04/05 16:21:02  rgbecker

#	Added _SeqTypes for efficiency

#	

#	Revision 1.21  2000/04/05 16:15:11  rgbecker

#	Made setFill/StrokeColor polymorphic

#	

#	Revision 1.20  2000/04/03 09:36:15  andy_robinson

#	Using trailing zero convention for new form and link API

#	

#	Revision 1.19  2000/04/02 02:53:49  aaron_watters

#	added support for outline trees

#	

#	Revision 1.18  2000/03/26 20:45:01  aaron_watters

#	added beginForm..endForm and fixed some naming convention issues.

#	

#	Revision 1.17  2000/03/24 21:02:21  aaron_watters

#	added support for destinations, forms, linkages

#	

#	Revision 1.15  2000/03/10 21:46:04  andy_robinson

#	fixed typo in setDash

#	

#	Revision 1.14  2000/03/08 13:40:03  andy_robinson

#	Canvas has two methods setFillColor(aColor) and setStrokeColor(aColor)

#	which accepts color objects directly.

#	

#	Revision 1.13  2000/03/06 20:06:36  rgbecker

#	Typo self._currentPageHasImages = 1

#	

#	Revision 1.12  2000/03/02 12:58:58  rgbecker

#	Remove over officious import checks Imag/zlib

#	

#	Revision 1.11  2000/03/02 10:28:54  rgbecker

#	[].extend illegal in 1.5.1

#	

#	Revision 1.10  2000/02/24 17:28:13  andy_robinson

#	Added methods setFillGray(g), setStrokeGray(g) where 0 <= g <= 1

#	

#	Revision 1.9  2000/02/24 09:12:55  andy_robinson

#	

#	Removed some constants which are no longer used.

#	

#	Revision 1.8  2000/02/20 14:43:27  rgbecker

#	_currentPageHasImages = 0 in init

#	

#	Revision 1.7  2000/02/20 11:08:56  rgbecker

#	Canvas.setPageSize fix

#	

#	Revision 1.6  2000/02/17 15:26:28  rgbecker

#	Change page compression default

#	

#	Revision 1.5  2000/02/17 02:08:04  rgbecker

#	Docstring & other fixes

#	

#	Revision 1.4  2000/02/16 09:42:50  rgbecker

#	Conversion to reportlab package

#	

#	Revision 1.3  2000/02/15 17:55:59  rgbecker

#	License text fixes

#	

#	Revision 1.2  2000/02/15 15:47:09  rgbecker

#	Added license, __version__ and Logi comment

#	

__doc__=""" 

PDFgen is a library to generate PDF files containing text and graphics.  It is the 

foundation for a complete reporting solution in Python.  It is also the

foundation for piddlePDF, the PDF back end for PIDDLE.

Documentation is a little slim right now; run then look at testpdfgen.py

to get a clue.

Progress Reports:

8.83, 2000-01-13, gmcm:

    Packagizing:

        renamed from pdfgen.py to canvas.py

        broke out PDFTextObject to textobject.py

        broke out PDFPathObject to pathobject.py

        placed all three in a package directory named pdfgen

0.82, 1999-10-27, AR:

        Fixed some bugs on printing to Postscript.  Added 'Text Object'

        analogous to Path Object to control entry and exit from text mode.

        Much simpler clipping API.  All verified to export Postscript and

        redistill.

        One limitation still - clipping to text paths is fine in Acrobat

        but not in Postscript (any level)

0.81,1999-10-13, AR:

        Adding RoundRect; changed all format strings to use %0.2f instead of %s,

        so we don't get exponentials in the output.

0.8,1999-10-07, AR:  all changed!

"""

##  0.81    1999-10-13:

##                

##

##

import os

import sys

import string

import time

import tempfile

import cStringIO

from types import *

from math import sin, cos, tan, pi, ceil

from reportlab.pdfbase import pdfutils

from reportlab.pdfbase import pdfdoc

from reportlab.pdfbase import pdfmetrics

from reportlab.pdfgen  import pdfgeom, pathobject, textobject

from reportlab.lib.colors import ColorType

_SeqTypes=(TupleType,ListType)

# Robert Kern

# Constants for closing paths.

# May be useful if one changes 'arc' and 'rect' to take a

# default argument that tells how to close the path.

# That way we can draw filled shapes.

FILL_EVEN_ODD = 0

FILL_NON_ZERO = 1

    #this is used by path-closing routines.

    #map stroke, fill, fillmode -> operator

    # fillmode: 1 = non-Zero (obviously), 0 = evenOdd

PATH_OPS = {(0, 0, FILL_EVEN_ODD) : 'n',  #no op

            (0, 0, FILL_NON_ZERO) : 'n',  #no op

            (1, 0, FILL_EVEN_ODD) : 'S',  #stroke only

            (1, 0, FILL_NON_ZERO) : 'S',  #stroke only

            (0, 1, FILL_EVEN_ODD) : 'f*',  #Fill only

            (0, 1, FILL_NON_ZERO) : 'f',  #Fill only

            (1, 1, FILL_EVEN_ODD) : 'B*',  #Stroke and Fill

            (1, 1, FILL_NON_ZERO) : 'B',  #Stroke and Fill

            }

class Canvas:

    """This is a low-level interface to the PDF file format.  The plan is to

    expose the whole pdfgen API through this.  Its drawing functions should have a

    one-to-one correspondence with PDF functionality.  Unlike PIDDLE, it thinks

    in terms of RGB values, Postscript font names, paths, and a 'current graphics

    state'.  Just started development at 5/9/99, not in use yet.

    """

    def __init__(self,filename,

                 pagesize=(595.27,841.89),

                 bottomup = 1,

                 pageCompression=0,

                 verbosity=1):

        """Most of the attributes are private - we will use set/get methods

        as the preferred interface.  Default page size is A4."""

        self._filename = filename

        self._doc = pdfdoc.PDFDocument()

        #this only controls whether it prints 'saved ...' - 0 disables

        self._verbosity = verbosity

        self._pagesize = pagesize

        #self._currentPageHasImages = 0

        self._pageTransitionString = ''

        self._destinations = {} # dictionary of destinations for cross indexing.

        self._pageCompression = pageCompression  #off by default - turn on when we're happy!

        self._pageNumber = 1   # keep a count

        #self._code = []    #where the current page's marking operators accumulate

        self._restartAccumulators()  # restart all accumulation state (generalized, arw)

        self._annotationCount = 0

        self._outlines = [] # list for a name tree

        #PostScript has the origin at bottom left. It is easy to achieve a top-

        #down coord system by translating to the top of the page and setting y

        #scale to -1, but then text is inverted.  So self.bottomup is used

        #to also set the text matrix accordingly.  You can now choose your

        #drawing coordinates.

        self.bottomup = bottomup

        self._make_preamble()

        #initial graphics state

        self._x = 0

        self._y = 0

        self._fontname = 'Times-Roman'

        self._fontsize = 12

        self._textMode = 0  #track if between BT/ET

        self._leading = 14.4

        self._currentMatrix = (1., 0., 0., 1., 0., 0.)

        self._fillMode = 0   #even-odd

        #text state        

        self._charSpace = 0

        self._wordSpace = 0

        self._horizScale = 100

        self._textRenderMode = 0

        self._rise = 0

        self._textLineMatrix = (1., 0., 0., 1., 0., 0.)

        self._textMatrix = (1., 0., 0., 1., 0., 0.)

        # line drawing        

        self._lineCap = 0

        self._lineJoin = 0

        self._lineDash = None  #not done

        self._lineWidth = 0

        self._mitreLimit = 0

        self._fillColorRGB = (0,0,0)

        self._strokeColorRGB = (0,0,0)

    def _make_preamble(self):

        if self.bottomup:

            #set initial font

            #self._preamble = 'BT /F9 12 Tf 14.4 TL ET'

            self._preamble = '1 0 0 1 0 0 cm BT /F9 12 Tf 14.4 TL ET'

        else:

            #switch coordinates, flip text and set font

            #self._preamble = '1 0 0 -1 0 %0.2f cm BT /F9 12 Tf 14.4 TL ET' % self._pagesize[1]

            self._preamble = '1 0 0 -1 0 %0.2f cm BT /F9 12 Tf 14.4 TL ET' % self._pagesize[1]

    def _escape(self, s):

        """PDF escapes are like Python ones, but brackets need slashes before them too.

        Use Python's repr function and chop off the quotes first"""

        s = repr(s)[1:-1]

        s = string.replace(s, '(','\(')

        s = string.replace(s, ')','\)')

        return s

    #info functions - non-standard

    def setAuthor(self, author):

        self._doc.setAuthor(author)

        """Adds a new entry to the outline.  If not specified,

        this gos at the top level.  If specified, it must be

        #to be completed

    def setOutlineNames0(self, *nametree):

        """nametree should can be a recursive tree like so

           c.setOutlineNames(

             "chapter1dest",

             ("chapter2dest",

              ["chapter2section1dest",

               "chapter2section2dest",

               "chapter2conclusiondest"]

             ), # end of chapter2 description

             "chapter3dest",

             ("chapter4dest", ["c4s1", "c4s2"])

             )

          each of the string names inside must be bound to a bookmark

          before the document is generated.

        """

        #print nametree

        apply(self._doc.outline.setNames, (self,)+nametree)

    def setTitle(self, title):

        self._doc.setTitle(title)

    def setSubject(self, subject):

        self._doc.setSubject(subject)

    def pageHasData(self):

        "Info function - app can call it after showPage to see if it needs a save"

        return len(self._code) == 0

    def showOutline0(self):

        "Specify that Acrobat Reader should start with the outline tree visible"

        self._doc._catalog.showOutline()

    def showPage(self):

        """This is where the fun happens"""

        page = pdfdoc.PDFPage()

        page.pagewidth = self._pagesize[0]

        page.pageheight = self._pagesize[1]

        page.hasImages = self._currentPageHasImages

        page.pageTransitionString = self._pageTransitionString

        page.setCompression(self._pageCompression)

        #print stream

        page.setStream([self._preamble] + self._code)

        self._setXObjects(page)

        self._setAnnotations(page)

        self._doc.addPage(page)

        #now get ready for the next one

        self._pageNumber = self._pageNumber + 1

        self._restartAccumulators()

    def _setAnnotations(self,page):

        page.Annots = self._annotationrefs

    def _setXObjects(self, thing):

        """for pages and forms, define the XObject dictionary for resources, if needed"""

        forms = self._formsinuse

        if forms:

            xobjectsdict = self._doc.xobjDict(forms)

            thing.XObjects = xobjectsdict

        else:

            thing.XObjects = None

    def _bookmarkReference(self, name):

        """get a reference to a (possibly undefined, possibly unbound) bookmark"""

        d = self._destinations

        try:

            return d[name]

        except:

            result = d[name] = pdfdoc.Destination(name) # newly defined, unbound

        return result

    def bookmarkPage0(self, name):

        """bind a bookmark (destination) to the current page"""

        # XXXX there are a lot of other ways a bookmark destination can be bound: should be implemented.

        # XXXX the other ways require tracking of the graphics state....

        dest = self._bookmarkReference(name)

        pageref = self._doc.thisPageRef()

        dest.fit()

        dest.setPageRef(pageref)

        return dest

    def bookmarkHorizontalAbsolute0(self, name, yhorizontal):

        """bind a bookmark (destination to the current page at a horizontal position"""

        dest = self._bookmarkReference(name)

        pageref = self._doc.thisPageRef()

        dest.fith(yhorizontal)

        dest.setPageRef(pageref)

        return dest

    def _inPage0(self):

        """declare a page, enable page features"""

        self._doc.inPage()

    def _inForm0(self):

        "deprecated in favore of beginForm...endForm"

        self._doc.inForm()

    def doForm0(self, name):

        """use a form XObj in current operation stream"""

        internalname = self._doc.hasForm(name)

        if not internalname:

            raise ValueError, "form is not defined %s" % name

        self._code.append("/%s Do" % internalname)

        self._formsinuse.append(name)

    def _restartAccumulators(self):

        self._code = []    # ready for more...

        self._currentPageHasImages = 1 # for safety...

        self._formsinuse = []

        self._annotationrefs = []

        self._formData = None

    def beginForm0(self, name, lowerx=0, lowery=0, upperx=None, uppery=None):

        "declare the current graphics stream to be a form"

        self._formData = (name, lowerx, lowery, upperx, uppery)

        self._inForm0()

    def endForm0(self):

        (name, lowerx, lowery, upperx, uppery) = self._formData

        self.makeForm0(name, lowerx, lowery, upperx, uppery)

    def makeForm0(self, name, lowerx=0, lowery=0, upperx=None, uppery=None):

        """Like showpage, but make a form using accumulated operations instead"""

        # deprecated in favor or beginForm(...)... endForm()

        (w,h) = self._pagesize

        if upperx is None: upperx=w

        if uppery is None: uppery=h

        form = pdfdoc.PDFFormXObject(lowerx=lowerx, lowery=lowery, upperx=upperx, uppery=uppery)

        form.compression = self._pageCompression

        form.setStreamList([self._preamble] + self._code) # ??? minus preamble (seems to be needed!)

        self._setXObjects(form)

        self._setAnnotations(form)

        self._doc.addForm(name, form)

        self._restartAccumulators()

    def textAnnotation0(self, contents, Rect=None, addtopage=1, name=None, **kw):

        if not Rect:

            (w,h) = self._pagesize# default to whole page (?)

            Rect = (0,0,w,h)

        annotation = apply(pdfdoc.TextAnnotation, (Rect, contents), kw)

        self._addAnnotation(annotation, name, addtopage)

    def inkAnnotation0(self, contents, InkList=None, Rect=None, addtopage=1, name=None, **kw):

        "not working?"

        (w,h) = self._pagesize

        if not Rect:

            Rect = (0,0,w,h)

        if not InkList:

            InkList = ( (100,100,100,h-100,w-100,h-100,w-100,100), )

        annotation = apply(pdfdoc.InkAnnotation, (Rect, contents, InkList), kw)

        self.addAnnotation(annotation, name, addtopage)

    def linkAbsolute0(self, contents, destinationname, Rect=None, addtopage=1, name=None, **kw):

        """link annotation positioned wrt the default user space"""

        destination = self._bookmarkReference(destinationname) # permitted to be undefined... must bind later...

        (w,h) = self._pagesize

        if not Rect:

            Rect = (0,0,w,h)

        kw["Rect"] = Rect

        kw["Contents"] = contents

        kw["Destination"] = destination

        annotation = apply(pdfdoc.LinkAnnotation, (), kw)

        self._addAnnotation(annotation, name, addtopage)

    def _addAnnotation(self, annotation, name=None, addtopage=1):

        count = self._annotationCount = self._annotationCount+1

        if not name: name="NUMBER"+repr(count)

        self._doc.addAnnotation(name, annotation)

        if addtopage:

            self._annotatePage(name)

    def _annotatePage(self, name):

        ref = self._doc.refAnnotation(name)

        self._annotationrefs.append(ref)

    def getPageNumber(self):

        return self._pageNumber

    def save(self):

        """Saves the file.  If holding data, do