reportlab/pdfbase/pdfdoc.py
author rgbecker
Wed, 10 Oct 2007 18:04:56 +0000
changeset 2869 912456caa112
parent 2852 397ae33d96fe
child 2902 f15ac27dc73f
permissions -rwxr-xr-x
reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2332
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2274
diff changeset
     1
#Copyright ReportLab Europe Ltd. 2000-2004
494
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 484
diff changeset
     2
#see license.txt for license details
2332
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2274
diff changeset
     3
#history http://www.reportlab.co.uk/cgi-bin/viewcvs.cgi/public/reportlab/trunk/reportlab/pdfbase/pdfdoc.py
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2274
diff changeset
     4
__version__=''' $Id$ '''
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
     5
__doc__="""
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
     6
The module pdfdoc.py handles the 'outer structure' of PDF documents, ensuring that
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
     7
all objects are properly cross-referenced and indexed to the nearest byte.  The
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
     8
'inner structure' - the page descriptions - are presumed to be generated before
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
     9
each page is saved.
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
    10
pdfgen.py calls this and provides a 'canvas' object to handle page marking operators.
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
    11
piddlePDF calls pdfgen and offers a high-level interface.
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
    12
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    13
The classes within this generally mirror structures in the PDF file
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    14
and are not part of any public interface.  Instead, canvas and font
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    15
classes are made available elsewhere for users to manipulate.
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
    16
"""
2575
0cba68b93555 reportlab-utf8 moved to trunk
rgbecker
parents: 2571
diff changeset
    17
import string, types, binascii, codecs
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    18
from reportlab.pdfbase import pdfutils
2067
ae4fe8b9c3f4 Now deterministically formats all numbers
andy_robinson
parents: 2045
diff changeset
    19
from reportlab.pdfbase.pdfutils import LINEEND # this constant needed in both
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    20
from reportlab import rl_config
2067
ae4fe8b9c3f4 Now deterministically formats all numbers
andy_robinson
parents: 2045
diff changeset
    21
from reportlab.lib.utils import import_zlib, open_for_read, fp_str
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
    22
from reportlab.pdfbase import pdfmetrics
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    23
1653
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    24
from sys import platform
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    25
try:
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    26
    from sys import version_info
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    27
except: # pre-2.0
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    28
    # may be inaccurate but will at least
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    29
    #work in anything which seeks to format
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    30
    # version_info into a string
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    31
    version_info = (1,5,2,'unknown',0)
87b869faf50f Fixed 1.5-breakage (we imported sys.version_info which did not exist then)
andy_robinson
parents: 1635
diff changeset
    32
1622
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    33
if platform[:4] == 'java' and version_info[:2] == (2, 1):
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1653
diff changeset
    34
    # workaround for list()-bug in Jython 2.1 (should be fixed in 2.2)
1622
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    35
    def list(sequence):
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    36
        def f(x):
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    37
            return x
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    38
        return map(f, sequence)
dafbc4bbcb36 Added Dinu's Jython 2.1 workaround
rgbecker
parents: 1605
diff changeset
    39
2737
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    40
def utf8str(x):
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    41
    if isinstance(x,unicode):
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    42
        return x.encode('utf8')
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    43
    else:
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    44
        return str(x)
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
    45
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    46
class PDFError(Exception):
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    47
    pass
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
    48
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    49
# set this flag to get more vertical whitespace (and larger files)
1363
92e3fb40a784 Asian fonts now all working in major encodings, and partly documented
andy_robinson
parents: 1317
diff changeset
    50
LongFormat = 1
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    51
##if LongFormat: (doesn't work)
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    52
##    pass
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    53
##else:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    54
##    LINEEND = "\n" # no wasteful carriage returns!
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    55
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    56
# __InternalName__ is a special attribute that can only be set by the Document arbitrator
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    57
__InternalName__ = "__InternalName__"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    58
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    59
# __RefOnly__ marks reference only elements that must be formatted on top level
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    60
__RefOnly__ = "__RefOnly__"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    61
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    62
# __Comment__ provides a (one line) comment to inline with an object ref, if present
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    63
#   if it is more than one line then percentize it...
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    64
__Comment__ = "__Comment__"
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    65
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    66
# If DoComments is set then add helpful (space wasting) comment lines to PDF files
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    67
DoComments = 1
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    68
if not LongFormat:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
    69
    DoComments = 0
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    70
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    71
# name for standard font dictionary
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    72
BasicFonts = "BasicFonts"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    73
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    74
# name for the pages object
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    75
Pages = "Pages"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    76
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    77
### generic utilities
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    78
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    79
# for % substitutions
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    80
LINEENDDICT = {"LINEEND": LINEEND, "PERCENT": "%"}
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
    81
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    82
from types import InstanceType
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    83
def format(element, document, toplevel=0, InstanceType=InstanceType):
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    84
    """Indirection step for formatting.
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    85
       Ensures that document parameters alter behaviour
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    86
       of formatting for all elements.
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    87
    """
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    88
    t=type(element)
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    89
    if t is InstanceType:
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    90
        if not toplevel and hasattr(element, __RefOnly__):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    91
            # the object cannot be a component at non top level.
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    92
            # make a reference to it and return it's format
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    93
            return document.Reference(element).format(document)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    94
        else:
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
    95
            f = element.format(document)
2273
82f026361b70 Fix bug introduced during transparency/ImageReader changes
rgbecker
parents: 2234
diff changeset
    96
            if not rl_config.invariant and DoComments and hasattr(element, __Comment__):
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    97
                f = "%s%s%s%s" % ("% ", element.__Comment__, LINEEND, f)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
    98
            return f
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
    99
    elif t in (float, int):
2067
ae4fe8b9c3f4 Now deterministically formats all numbers
andy_robinson
parents: 2045
diff changeset
   100
        #use a controlled number formatting routine
ae4fe8b9c3f4 Now deterministically formats all numbers
andy_robinson
parents: 2045
diff changeset
   101
        #instead of str, so Jython/Python etc do not differ
ae4fe8b9c3f4 Now deterministically formats all numbers
andy_robinson
parents: 2045
diff changeset
   102
        return fp_str(element)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   103
    else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   104
        return str(element)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   105
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   106
def xObjectName(externalname):
1560
382bbd1f20ae revert to older internal name for backward compatibility
rgbecker
parents: 1554
diff changeset
   107
    return "FormXob.%s" % externalname
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   108
1605
fb7c31cc48d1 backwards compatible name
aaron_watters
parents: 1578
diff changeset
   109
# backwards compatibility
fb7c31cc48d1 backwards compatible name
aaron_watters
parents: 1578
diff changeset
   110
formName = xObjectName
fb7c31cc48d1 backwards compatible name
aaron_watters
parents: 1578
diff changeset
   111
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   112
# no encryption
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   113
class NoEncryption:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   114
    def encode(self, t):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   115
        "encode a string, stream, text"
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   116
        return t
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   117
    def prepare(self, document):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   118
        # get ready to do encryption
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   119
        pass
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   120
    def register(self, objnum, version):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   121
        # enter a new direct object
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   122
        pass
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   123
    def info(self):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   124
        # the representation of self in file if any (should be None or PDFDict)
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   125
        return None
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   126
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   127
class DummyDoc:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   128
    "used to bypass encryption when required"
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   129
    encrypt = NoEncryption()
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   130
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   131
### the global document structure manager
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   132
class PDFDocument:
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   133
    _ID = None
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   134
    objectcounter = 0
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   135
    inObject = None
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   136
    # set this to define filters
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   137
    defaultStreamFilters = None
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   138
    encrypt = NoEncryption() # default no encryption
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   139
    pageCounter = 1
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   140
    def __init__(self,
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   141
                 dummyoutline=0,
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   142
                 compression=rl_config.pageCompression,
2476
19fb0900fba1 pdfdoc.py: minor changes to simplify PDFInfoL/U in other apps
rgbecker
parents: 2378
diff changeset
   143
                 invariant=rl_config.invariant,
19fb0900fba1 pdfdoc.py: minor changes to simplify PDFInfoL/U in other apps
rgbecker
parents: 2378
diff changeset
   144
                 filename=None):
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   145
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   146
        # allow None value to be passed in to mean 'give system defaults'
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   147
        if invariant is None:
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   148
            self.invariant = rl_config.invariant
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   149
        else:
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   150
            self.invariant = invariant
1635
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   151
        self.setCompression(compression)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   152
        # signature for creating PDF ID
1977
74967fd03ed4 Fix up invariance
rgbecker
parents: 1965
diff changeset
   153
        import md5
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   154
        sig = self.signature = md5.new()
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   155
        sig.update("a reportlab document")
1977
74967fd03ed4 Fix up invariance
rgbecker
parents: 1965
diff changeset
   156
        if not self.invariant:
1987
b2401bcddd6d Finally commit changes to allow invariant pdfencryption to work properly
rgbecker
parents: 1985
diff changeset
   157
            cat = _getTimeStamp()
b2401bcddd6d Finally commit changes to allow invariant pdfencryption to work properly
rgbecker
parents: 1985
diff changeset
   158
        else:
b2401bcddd6d Finally commit changes to allow invariant pdfencryption to work properly
rgbecker
parents: 1985
diff changeset
   159
            cat = 946684800.0
b2401bcddd6d Finally commit changes to allow invariant pdfencryption to work properly
rgbecker
parents: 1985
diff changeset
   160
        sig.update(repr(cat)) # initialize with timestamp digest
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   161
        # mapping of internal identifier ("Page001") to PDF objectnumber and generation number (34, 0)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   162
        self.idToObjectNumberAndVersion = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   163
        # mapping of internal identifier ("Page001") to PDF object (PDFPage instance)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   164
        self.idToObject = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   165
        # internal id to file location
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   166
        self.idToOffset = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   167
        # number to id
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   168
        self.numberToId = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   169
        cat = self.Catalog = self._catalog = PDFCatalog()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   170
        pages = self.Pages = PDFPages()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   171
        cat.Pages = pages
483
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   172
        if dummyoutline:
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   173
            outlines = PDFOutlines0()
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   174
        else:
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   175
            outlines = PDFOutlines()
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   176
        self.Outlines = self.outline = outlines
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   177
        cat.Outlines = outlines
603
a6f460e53b00 forms in forms now work
aaron_watters
parents: 595
diff changeset
   178
        self.info = PDFInfo()
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   179
        self.info.invariant = self.invariant
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   180
        #self.Reference(self.Catalog)
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   181
        #self.Reference(self.Info)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   182
        self.fontMapping = {}
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   183
        #make an empty font dictionary
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   184
        DD = PDFDictionary({})
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   185
        DD.__Comment__ = "The standard fonts dictionary"
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   186
        DDR = self.Reference(DD, BasicFonts)
1635
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   187
        self.delayedFonts = []
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   188
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   189
    def setCompression(self, onoff):
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   190
        # XXX: maybe this should also set self.defaultStreamFilters?
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   191
        self.compression = onoff
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   192
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   193
    def updateSignature(self, thing):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   194
        "add information to the signature"
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   195
        if self._ID: return # but not if its used already!
2737
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
   196
        self.signature.update(utf8str(thing))
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   197
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   198
    def ID(self):
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   199
        "A unique fingerprint for the file (unless in invariant mode)"
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   200
        if self._ID:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   201
            return self._ID
1985
20a5484dd812 Fix up for 1.1.4 PIL palette access
rgbecker
parents: 1977
diff changeset
   202
        digest = self.signature.digest()
20a5484dd812 Fix up for 1.1.4 PIL palette access
rgbecker
parents: 1977
diff changeset
   203
        doc = DummyDoc()
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   204
        ID = PDFString(digest,enc='raw')
1985
20a5484dd812 Fix up for 1.1.4 PIL palette access
rgbecker
parents: 1977
diff changeset
   205
        IDs = ID.format(doc)
20a5484dd812 Fix up for 1.1.4 PIL palette access
rgbecker
parents: 1977
diff changeset
   206
        self._ID = "%s %% ReportLab generated PDF document -- digest (http://www.reportlab.com) %s [%s %s] %s" % (
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   207
                LINEEND, LINEEND, IDs, IDs, LINEEND)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   208
        return self._ID
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   209
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   210
    def SaveToFile(self, filename, canvas):
1965
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   211
        if callable(getattr(filename, "write",None)):
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   212
            myfile = 0
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   213
            f = filename
2737
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
   214
            filename = utf8str(getattr(filename,'name',''))
1965
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   215
        else :
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   216
            myfile = 1
2737
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
   217
            filename = utf8str(filename)
1965
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   218
            f = open(filename, "wb")
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   219
        f.write(self.GetPDFData(canvas))
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   220
        if myfile:
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   221
            f.close()
2010
83e136234c0f Added import of os
rgbecker
parents: 2009
diff changeset
   222
            import os
2009
a6f1bd476301 Slight change to markfilename usage
rgbecker
parents: 1987
diff changeset
   223
            if os.name=='mac':
a6f1bd476301 Slight change to markfilename usage
rgbecker
parents: 1987
diff changeset
   224
                from reportlab.lib.utils import markfilename
a6f1bd476301 Slight change to markfilename usage
rgbecker
parents: 1987
diff changeset
   225
                markfilename(filename) # do platform specific file junk
1965
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   226
        if getattr(canvas,'_verbosity',None): print 'saved', filename
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   227
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   228
    def GetPDFData(self, canvas):
1635
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   229
        # realize delayed fonts
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   230
        for fnt in self.delayedFonts:
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   231
            fnt.addObjects(self)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   232
        # add info stuff to signature
1838
f7eeee67832c Changes to allow invariant documents when needed
andy_robinson
parents: 1799
diff changeset
   233
        self.info.invariant = self.invariant
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   234
        self.info.digest(self.signature)
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   235
        ### later: maybe add more info to sig?
483
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   236
        # prepare outline
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   237
        self.Reference(self.Catalog)
603
a6f460e53b00 forms in forms now work
aaron_watters
parents: 595
diff changeset
   238
        self.Reference(self.info)
483
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   239
        outline = self.outline
c4c3969d1e30 undid last checkin and added an option for a default outline (different fix)
aaron_watters
parents: 482
diff changeset
   240
        outline.prepare(self, canvas)
1965
02ef6a007f0b David Fraser's GetPDFData patch (to avoid unwanted StringIOs
rgbecker
parents: 1903
diff changeset
   241
        return self.format()
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   242
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   243
    def inPage(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   244
        """specify the current object as a page (enables reference binding and other page features)"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   245
        if self.inObject is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   246
            if self.inObject=="page": return
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   247
            raise ValueError, "can't go in page already in object %s" % self.inObject
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   248
        self.inObject = "page"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   249
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   250
    def inForm(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   251
        """specify that we are in a form xobject (disable page features, etc)"""
742
df72775fc33d fixed minor bug in forms handling
aaron_watters
parents: 724
diff changeset
   252
        # don't need this check anymore since going in a form pushes old context at canvas level.
df72775fc33d fixed minor bug in forms handling
aaron_watters
parents: 724
diff changeset
   253
        #if self.inObject not in ["form", None]:
df72775fc33d fixed minor bug in forms handling
aaron_watters
parents: 724
diff changeset
   254
        #    raise ValueError, "can't go in form already in object %s" % self.inObject
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   255
        self.inObject = "form"
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   256
        # don't need to do anything else, I think...
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   257
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   258
    def getInternalFontName(self, psfontname):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   259
        fm = self.fontMapping
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   260
        if fm.has_key(psfontname):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   261
            return fm[psfontname]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   262
        else:
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   263
            try:
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   264
                # does pdfmetrics know about it? if so, add
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   265
                fontObj = pdfmetrics.getFont(psfontname)
2678
38d18a697cd0 reportlab: Python2.5 changes + minor cosmetics and improvements
rgbecker
parents: 2666
diff changeset
   266
                if fontObj._dynamicFont:
1635
45fec4b75ae3 Added Marius Gedminas' TTF support
rgbecker
parents: 1634
diff changeset
   267
                    raise PDFError, "getInternalFontName(%s) called for a dynamic font" % repr(psfontname)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   268
                fontObj.addObjects(self)
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   269
                #self.addFont(fontObj)
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   270
                return fm[psfontname]
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   271
            except KeyError:
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   272
                raise PDFError, "Font %s not known!" % repr(psfontname)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   273
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   274
    def thisPageName(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   275
        return "Page"+repr(self.pageCounter)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   276
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   277
    def thisPageRef(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   278
        return PDFObjectReference(self.thisPageName())
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   279
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   280
    def addPage(self, page):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   281
        name = self.thisPageName()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   282
        self.Reference(page, name)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   283
        self.Pages.addPage(page)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   284
        self.pageCounter = self.pageCounter+1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   285
        self.inObject = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   286
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   287
    def addForm(self, name, form):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   288
        """add a Form XObject."""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   289
        # XXX should check that name is a legal PDF name
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   290
        if self.inObject != "form":
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   291
            self.inForm()
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   292
        self.Reference(form, xObjectName(name))
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   293
        self.inObject = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   294
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   295
    def annotationName(self, externalname):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   296
        return "Annot.%s"%externalname
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   297
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   298
    def addAnnotation(self, name, annotation):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   299
        self.Reference(annotation, self.annotationName(name))
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   300
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   301
    def refAnnotation(self, name):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   302
        internalname = self.annotationName(name)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   303
        return PDFObjectReference(internalname)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   304
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   305
    def setTitle(self, title):
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   306
        "embeds in PDF file"
2666
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   307
        if title is None:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   308
            self.info.title = '(anonymous)'
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   309
        else:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   310
            self.info.title = title
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   311
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   312
    def setAuthor(self, author):
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   313
        "embedded in PDF file"
2666
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   314
        #allow resetting to clear it
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   315
        if author is None:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   316
            self.info.author = '(anonymous)'
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   317
        else:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   318
            self.info.author = author
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   319
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   320
    def setSubject(self, subject):
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   321
        "embeds in PDF file"
2666
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   322
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   323
        #allow resetting to clear it
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   324
        if subject is None:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   325
            self.info.subject = '(unspecified)'
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   326
        else:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   327
            self.info.subject = subject
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   328
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   329
    def setKeywords(self, keywords):
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   330
        "embeds a string containing keywords in PDF file"
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   331
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   332
        #allow resetting to clear it but ensure it's a string
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   333
        if keywords is None:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   334
            self.info.keywords = ''
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   335
        else:
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   336
            self.info.keywords = keywords
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   337
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   338
    def setDateFormatter(self, dateFormatter):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   339
        self.info._dateFormatter = dateFormatter
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   340
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   341
    def getAvailableFonts(self):
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   342
        fontnames = self.fontMapping.keys()
1151
431ef9e78aae "the 14 std fonts" should always be "available"
aaron_watters
parents: 1063
diff changeset
   343
        # the standard 14 are also always available! (even if not initialized yet)
431ef9e78aae "the 14 std fonts" should always be "available"
aaron_watters
parents: 1063
diff changeset
   344
        import _fontdata
431ef9e78aae "the 14 std fonts" should always be "available"
aaron_watters
parents: 1063
diff changeset
   345
        for name in _fontdata.standardFonts:
431ef9e78aae "the 14 std fonts" should always be "available"
aaron_watters
parents: 1063
diff changeset
   346
            if name not in fontnames:
431ef9e78aae "the 14 std fonts" should always be "available"
aaron_watters
parents: 1063
diff changeset
   347
                fontnames.append(name)
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   348
        fontnames.sort()
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   349
        return fontnames
681
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   350
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   351
    def format(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   352
        # register the Catalog/INfo and then format the objects one by one until exhausted
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   353
        # (possible infinite loop if there is a bug that continually makes new objects/refs...)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   354
        # Prepare encryption
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   355
        self.encrypt.prepare(self)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   356
        cat = self.Catalog
603
a6f460e53b00 forms in forms now work
aaron_watters
parents: 595
diff changeset
   357
        info = self.info
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   358
        self.Reference(self.Catalog)
603
a6f460e53b00 forms in forms now work
aaron_watters
parents: 595
diff changeset
   359
        self.Reference(self.info)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   360
        # register the encryption dictionary if present
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   361
        encryptref = None
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   362
        encryptinfo = self.encrypt.info()
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   363
        if encryptinfo:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   364
            encryptref = self.Reference(encryptinfo)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   365
        # make std fonts (this could be made optional
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   366
        counter = 0 # start at first object (object 1 after preincrement)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   367
        ids = [] # the collection of object ids in object number order
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   368
        numbertoid = self.numberToId
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   369
        idToNV = self.idToObjectNumberAndVersion
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   370
        idToOb = self.idToObject
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   371
        idToOf = self.idToOffset
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   372
        ### note that new entries may be "appended" DURING FORMATTING
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   373
        done = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   374
        File = PDFFile() # output collector
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   375
        while done is None:
2575
0cba68b93555 reportlab-utf8 moved to trunk
rgbecker
parents: 2571
diff changeset
   376
            counter += 1 # do next object...
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   377
            if numbertoid.has_key(counter):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   378
                id = numbertoid[counter]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   379
                #printidToOb
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   380
                obj = idToOb[id]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   381
                IO = PDFIndirectObject(id, obj)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   382
                # register object number and version
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   383
                #encrypt.register(id,
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   384
                IOf = IO.format(self)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   385
                # add a comment to the PDF output
2273
82f026361b70 Fix bug introduced during transparency/ImageReader changes
rgbecker
parents: 2234
diff changeset
   386
                if not rl_config.invariant and DoComments:
1840
9c20e252dcd2 Fixed how object comments are formatted - could not always __class___.__name__
andy_robinson
parents: 1838
diff changeset
   387
                    try:
9c20e252dcd2 Fixed how object comments are formatted - could not always __class___.__name__
andy_robinson
parents: 1838
diff changeset
   388
                        classname = obj.__class__.__name__
9c20e252dcd2 Fixed how object comments are formatted - could not always __class___.__name__
andy_robinson
parents: 1838
diff changeset
   389
                    except:
9c20e252dcd2 Fixed how object comments are formatted - could not always __class___.__name__
andy_robinson
parents: 1838
diff changeset
   390
                        classname = repr(obj)
9c20e252dcd2 Fixed how object comments are formatted - could not always __class___.__name__
andy_robinson
parents: 1838
diff changeset
   391
                    File.add("%% %s: class %s %s" % (repr(id), classname[:50], LINEEND))
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   392
                offset = File.add(IOf)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   393
                idToOf[id] = offset
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   394
                ids.append(id)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   395
            else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   396
                done = 1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   397
        # sanity checks (must happen AFTER formatting)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   398
        lno = len(numbertoid)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   399
        if counter-1!=lno:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   400
            raise ValueError, "counter %s doesn't match number to id dictionary %s" %(counter, lno)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   401
        # now add the xref
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   402
        xref = PDFCrossReferenceTable()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   403
        xref.addsection(0, ids)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   404
        xreff = xref.format(self)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   405
        xrefoffset = File.add(xreff)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   406
        # now add the trailer
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   407
        trailer = PDFTrailer(
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   408
            startxref = xrefoffset,
1309
2b674954263d /Size in Trailer off by one.
aaron_watters
parents: 1179
diff changeset
   409
            Size = lno+1,
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   410
            Root = self.Reference(cat),
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   411
            Info = self.Reference(info),
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   412
            Encrypt = encryptref,
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   413
            ID = self.ID(),
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   414
            )
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   415
        trailerf = trailer.format(self)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   416
        File.add(trailerf)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   417
        # return string format for pdf file
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   418
        return File.format(self)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   419
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   420
    def hasForm(self, name):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   421
        """test for existence of named form"""
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   422
        internalname = xObjectName(name)
1395
65c2c66a3a1b canvas.hasForm now gives honest answers.
andy_robinson
parents: 1363
diff changeset
   423
        return self.idToObject.has_key(internalname)
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   424
2679
b8464568f5e2 tweaks to support PDF art boxes
andy
parents: 2678
diff changeset
   425
    def getFormBBox(self, name, boxType="MediaBox"):
b8464568f5e2 tweaks to support PDF art boxes
andy
parents: 2678
diff changeset
   426
        """get the declared bounding box of the form as a list.
b8464568f5e2 tweaks to support PDF art boxes
andy
parents: 2678
diff changeset
   427
        If you specify a different PDF box definition (e.g. the
b8464568f5e2 tweaks to support PDF art boxes
andy
parents: 2678
diff changeset
   428
        ArtBox) and it has one, that's what you'll get."""
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   429
        internalname = xObjectName(name)
1430
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   430
        if self.idToObject.has_key(internalname):
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   431
            theform = self.idToObject[internalname]
2798
40f791c3cbf8 pdfdoc.py: allow for proper external forms info
rgbecker
parents: 2778
diff changeset
   432
            if hasattr(theform,'_extra_pageCatcher_info'):
40f791c3cbf8 pdfdoc.py: allow for proper external forms info
rgbecker
parents: 2778
diff changeset
   433
                return theform._extra_pageCatcher_info[boxType]
1430
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   434
            if isinstance(theform, PDFFormXObject):
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   435
                # internally defined form
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   436
                return theform.BBoxList()
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   437
            elif isinstance(theform, PDFStream):
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   438
                # externally defined form
2679
b8464568f5e2 tweaks to support PDF art boxes
andy
parents: 2678
diff changeset
   439
                return list(theform.dictionary.dict[boxType].sequence)
1430
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   440
            else:
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   441
                raise ValueError, "I don't understand the form instance %s" % repr(name)
1ba38d150a9e support for getting form bounding boxes
aaron_watters
parents: 1395
diff changeset
   442
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   443
    def getXObjectName(self, name):
1395
65c2c66a3a1b canvas.hasForm now gives honest answers.
andy_robinson
parents: 1363
diff changeset
   444
        """Lets canvas find out what form is called internally.
65c2c66a3a1b canvas.hasForm now gives honest answers.
andy_robinson
parents: 1363
diff changeset
   445
        Never mind whether it is defined yet or not."""
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   446
        return xObjectName(name)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   447
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   448
    def xobjDict(self, formnames):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   449
        """construct an xobject dict (for inclusion in a resource dict, usually)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   450
           from a list of form names (images not yet supported)"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   451
        D = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   452
        for name in formnames:
1552
f83acda4ec71 expanded docco and fixed 'natural size'
andy_robinson
parents: 1510
diff changeset
   453
            internalname = xObjectName(name)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   454
            reference = PDFObjectReference(internalname)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   455
            D[internalname] = reference
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   456
        #print "xobjDict D", D
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   457
        return PDFDictionary(D)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   458
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   459
    def Reference(self, object, name=None, InstanceType=InstanceType):
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   460
        ### note references may "grow" during the final formatting pass: don't use d.keys()!
628
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   461
        # don't make references to other references, or non instances, unless they are named!
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   462
        #print"object type is ", type(object)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   463
        tob = type(object)
628
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   464
        idToObject = self.idToObject
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   465
        if name is None and (
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   466
            (tob is not InstanceType) or (tob is InstanceType and object.__class__ is PDFObjectReference)):
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   467
            return object
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   468
        if hasattr(object, __InternalName__):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   469
            # already registered
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   470
            intname = object.__InternalName__
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   471
            if name is not None and name!=intname:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   472
                raise ValueError, "attempt to reregister object %s with new name %s" % (
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   473
                    repr(intname), repr(name))
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   474
            if not idToObject.has_key(intname):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   475
                raise ValueError, "object named but not registered"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   476
            return PDFObjectReference(intname)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   477
        # otherwise register the new object
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   478
        objectcounter = self.objectcounter = self.objectcounter+1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   479
        if name is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   480
            name = "R"+repr(objectcounter)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   481
        if idToObject.has_key(name):
628
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   482
            other = idToObject[name]
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   483
            if other!=object:
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   484
                raise ValueError, "redefining named object: "+repr(name)
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   485
            return PDFObjectReference(name)
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   486
        if tob is InstanceType:
7f5cd20a02f1 very subtle bug that is only hit by pagecatcher: indirect references to integers now work.
aaron_watters
parents: 603
diff changeset
   487
            object.__InternalName__ = name
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   488
        #print "name", name, "counter", objectcounter
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   489
        self.idToObjectNumberAndVersion[name] = (objectcounter, 0)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   490
        self.numberToId[objectcounter] = name
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   491
        idToObject[name] = object
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   492
        return PDFObjectReference(name)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   493
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   494
### chapter 4 Objects
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   495
PDFtrue = "true"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   496
PDFfalse = "false"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   497
PDFnull = "null"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   498
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   499
class PDFText:
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   500
    def __init__(self, t):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   501
        self.t = t
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   502
    def format(self, document):
2477
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   503
        result = binascii.hexlify(document.encrypt.encode(self.t))
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   504
        return "<%s>" % result
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   505
    def __str__(self):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   506
        dummydoc = DummyDoc()
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   507
        return self.format(dummydoc)
1014
ba7f9c1294ea added missing PDFText() function for consistency (needed by pagecatcher)
aaron_watters
parents: 873
diff changeset
   508
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   509
def PDFnumber(n):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   510
    return n
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   511
2517
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   512
import re
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   513
_re_cleanparens=re.compile('[^()]')
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   514
del re
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   515
def _isbalanced(s):
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   516
    '''test whether a string is balanced in parens'''
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   517
    s = _re_cleanparens.sub('',s)
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   518
    n = 0
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   519
    for c in s:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   520
        if c=='(': n+=1
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   521
        else:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   522
            n -= 1
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   523
            if n<0: return 0
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   524
    return not n and 1 or 0
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   525
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   526
def _checkPdfdoc(utext):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   527
    '''return true if no Pdfdoc encoding errors'''
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   528
    try:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   529
        utext.encode('pdfdoc')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   530
        return 1
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   531
    except UnicodeEncodeError, e:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   532
        return 0
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   533
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   534
class PDFString:
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   535
    def __init__(self, s, escape=1, enc='auto'):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   536
        '''s can be unicode/utf8 or a PDFString
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   537
        if escape is true then the output will be passed through escape
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   538
        if enc is raw then the string will be left alone
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   539
        if enc is auto we'll try and automatically adapt to utf_16_be if the
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   540
        effective string is not entirely in pdfdoc
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   541
        '''
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   542
        if isinstance(s,PDFString):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   543
            self.s = s.s
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   544
            self.escape = s.escape
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   545
            self.enc = s.enc
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   546
        else:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   547
            self.s = s
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   548
            self.escape = escape
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   549
            self.enc = enc
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   550
    def format(self, document):
2517
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   551
        s = self.s
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   552
        enc = getattr(self,'enc','auto')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   553
        if type(s) is str:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   554
            if enc is 'auto':
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   555
                try:
2740
5417e3e44724 pdfdoc.py: fix auto decode of strings
rgbecker
parents: 2737
diff changeset
   556
                    u = s.decode(s.startswith(codecs.BOM_UTF16_BE) and 'utf16' or 'utf8')
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   557
                except:
2737
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
   558
                    import sys
7aa9f936102b pdfdoc: allow for unicode in more places
rgbecker
parents: 2730
diff changeset
   559
                    print >>sys.stderr, 'Error in',repr(s)
2595
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   560
                    raise
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   561
                if _checkPdfdoc(u):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   562
                    s = u.encode('pdfdoc')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   563
                else:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   564
                    s = codecs.BOM_UTF16_BE+u.encode('utf_16_be')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   565
        elif type(s) is unicode:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   566
            if enc is 'auto':
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   567
                if _checkPdfdoc(s):
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   568
                    s = s.encode('pdfdoc')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   569
                else:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   570
                    s = codecs.BOM_UTF16_BE+s.encode('utf_16_be')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   571
            else:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   572
                s = codecs.BOM_UTF16_BE+s.encode('utf_16_be')
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   573
        else:
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   574
            raise ValueError('PDFString argument must be str/unicode not %s' % type(s))
ffb020e8ab50 reportlab: PDFString vs Unicode changes
rgbecker
parents: 2575
diff changeset
   575
2524
7e6da7c7fe2c merge stable 2687:2688 pdfdoc.py: attempt to robustify escape attribute access
rgbecker
parents: 2517
diff changeset
   576
        escape = getattr(self,'escape',1)
2517
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   577
        if not isinstance(document.encrypt,NoEncryption):
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   578
            s = document.encrypt.encode(s)
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   579
            escape = 1
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   580
        if escape:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   581
            try:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   582
                es = "(%s)" % pdfutils._escape(s)
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   583
            except:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   584
                raise ValueError("cannot escape %s %s" % (s, repr(s)))
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   585
            if escape&2:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   586
                es = es.replace('\\012','\n')
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   587
            if escape&4 and _isbalanced(s): 
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   588
                es = es.replace('\\(','(').replace('\\)',')')
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   589
            return es
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   590
        else:
c8f07edb561d pdfdoc: allow special escaping in Annotations and PDFString
rgbecker
parents: 2487
diff changeset
   591
            return '(%s)' % s
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   592
    def __str__(self):
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   593
        return "(%s)" % pdfutils._escape(self.s)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   594
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   595
def PDFName(data,lo=chr(0x21),hi=chr(0x7e)):
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   596
    # might need to change this to class for encryption
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   597
    #  NOTE: RESULT MUST ALWAYS SUPPORT MEANINGFUL COMPARISONS (EQUALITY) AND HASH
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   598
    # first convert the name
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   599
    L = list(data)
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   600
    for i,c in enumerate(L):
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   601
        if c<lo or c>hi or c in "%()<>{}[]#":
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   602
            L[i] = "#"+hex(ord(c))[2:] # forget the 0x thing...
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   603
    return "/"+(''.join(L))
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   604
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   605
class PDFDictionary:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   606
    multiline = LongFormat
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   607
    def __init__(self, dict=None):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   608
        """dict should be namestring to value eg "a": 122 NOT pdfname to value NOT "/a":122"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   609
        if dict is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   610
            self.dict = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   611
        else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   612
            self.dict = dict.copy()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   613
    def __setitem__(self, name, value):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   614
        self.dict[name] = value
2730
b3fc23a74fd1 reportlab: Dirk Holtwick's editor's fixes :)
rgbecker
parents: 2679
diff changeset
   615
    def Reference(self, name, document):
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   616
        self.dict[name] = document.Reference(self.dict[name])
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   617
    def format(self, document,IND=LINEEND+' '):
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   618
        dict = self.dict
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   619
        keys = dict.keys()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   620
        keys.sort()
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   621
        L = [(format(PDFName(k),document)+" "+format(dict[k],document)) for k in keys]
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   622
        if self.multiline:
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   623
            L = IND.join(L)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   624
        else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   625
            # break up every 6 elements anyway
2540
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   626
            t=L.insert
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   627
            for i in xrange(6, len(L), 6):
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   628
                t(i,LINEEND)
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   629
            L = " ".join(L)
fadac956b695 pdfdoc.py: speed improvements
rgbecker
parents: 2524
diff changeset
   630
        return "<< %s >>" % L
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   631
2666
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   632
    def copy(self):
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   633
        return PDFDictionary(self.dict)
2778
8cd23c6fbff3 reportlab: minor fix to linkRect and friends
rgbecker
parents: 2767
diff changeset
   634
8cd23c6fbff3 reportlab: minor fix to linkRect and friends
rgbecker
parents: 2767
diff changeset
   635
    def has_key(self,k):
8cd23c6fbff3 reportlab: minor fix to linkRect and friends
rgbecker
parents: 2767
diff changeset
   636
        return self.dict.has_key(k)
2869
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   637
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   638
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   639
class checkPDFNames:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   640
    def __init__(self,*names):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   641
        self.names = map(PDFName,names)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   642
    def __call__(self,value):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   643
        if not value.startswith('/'):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   644
            value=PDFName(value)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   645
        if value in self.names:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   646
            return value
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   647
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   648
def checkPDFBoolean(value):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   649
    if value in ('true','false'): return value
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   650
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   651
class CheckedPDFDictionary(PDFDictionary):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   652
    validate = {}
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   653
    def __init__(self,dict=None,validate=None):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   654
        PDFDictionary.__init__(self,dict)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   655
        if validate: self.validate = validate
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   656
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   657
    def __setitem__(self,name,value):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   658
        if name not in self.validate:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   659
            raise ValueError('invalid key, %r' % name)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   660
        cvalue = self.validate[name](value)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   661
        if cvalue is None:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   662
            raise ValueError('Bad value %r for key %r' % (value,name))
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   663
        PDFDictionary.__setitem__(self,name,cvalue)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   664
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   665
class ViewerPreferencesPDFDictionary(CheckedPDFDictionary):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   666
    validate=dict(
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   667
                HideToolbar=checkPDFBoolean,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   668
                HideMenubar=checkPDFBoolean,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   669
                HideWindowUI=checkPDFBoolean,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   670
                FitWindow=checkPDFBoolean,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   671
                CenterWindow=checkPDFBoolean,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   672
                NonFullScreenPageMode=checkPDFNames(*'UseNone UseOutlines UseThumbs UseOC'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   673
                Direction=checkPDFNames(*'L2R R2L'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   674
                ViewArea=checkPDFNames(*'MediaBox CropBox BleedBox TrimBox ArtBox'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   675
                ViewClip=checkPDFNames(*'MediaBox CropBox BleedBox TrimBox ArtBox'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   676
                PrintArea=checkPDFNames(*'MediaBox CropBox BleedBox TrimBox ArtBox'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   677
                PrintClip=checkPDFNames(*'MediaBox CropBox BleedBox TrimBox ArtBox'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   678
                PrintScaling=checkPDFNames(*'None AppDefault'.split()),
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
   679
                )
2666
a72c25280be2 facilitating saving info dictionary
andy
parents: 2595
diff changeset
   680
    
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   681
# stream filters are objects to support round trip and
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   682
# possibly in the future also support parameters
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   683
class PDFStreamFilterZCompress:
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   684
    pdfname = "FlateDecode"
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   685
    def encode(self, text):
674
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   686
        from reportlab.lib.utils import import_zlib
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   687
        zlib = import_zlib()
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   688
        if not zlib: raise ImportError, "cannot z-compress zlib unavailable"
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   689
        return zlib.compress(text)
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   690
    def decode(self, encoded):
674
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   691
        from reportlab.lib.utils import import_zlib
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   692
        zlib = import_zlib()
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   693
        if not zlib: raise ImportError, "cannot z-decompress zlib unavailable"
c25a9dbfc27a Improved ImportError handling
rgbecker
parents: 628
diff changeset
   694
        return zlib.decompress(encoded)
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   695
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   696
# need only one of these, unless we implement parameters later
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   697
PDFZCompress = PDFStreamFilterZCompress()
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   698
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   699
class PDFStreamFilterBase85Encode:
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   700
    pdfname = "ASCII85Decode"
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   701
    def encode(self, text):
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   702
        from pdfutils import _AsciiBase85Encode, _wrap
2767
2ba5a1d26ad0 reportlab: make a85 wrap optional, add _reset to rl_config
rgbecker
parents: 2740
diff changeset
   703
        text = _AsciiBase85Encode(text)
2ba5a1d26ad0 reportlab: make a85 wrap optional, add _reset to rl_config
rgbecker
parents: 2740
diff changeset
   704
        if rl_config.wrapA85:
2ba5a1d26ad0 reportlab: make a85 wrap optional, add _reset to rl_config
rgbecker
parents: 2740
diff changeset
   705
            text = _wrap(text)
2ba5a1d26ad0 reportlab: make a85 wrap optional, add _reset to rl_config
rgbecker
parents: 2740
diff changeset
   706
        return text
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   707
    def decode(self, text):
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   708
        from pdfutils import _AsciiBase85Decode
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   709
        return _AsciiBase85Decode(text)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   710
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   711
# need only one of these too
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   712
PDFBase85Encode = PDFStreamFilterBase85Encode()
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   713
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   714
STREAMFMT = ("%(dictionary)s%(LINEEND)s" # dictionary
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   715
             "stream" # stream keyword
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   716
             "%(LINEEND)s" # a line end (could be just a \n)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   717
             "%(content)s" # the content, with no lineend
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   718
             "endstream%(LINEEND)s" # the endstream keyword
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   719
             )
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   720
class PDFStream:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   721
    '''set dictionary elements explicitly stream.dictionary[name]=value'''
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   722
    ### compression stuff not implemented yet
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   723
    __RefOnly__ = 1 # must be at top level
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   724
    def __init__(self, dictionary=None, content=None):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   725
        if dictionary is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   726
            dictionary = PDFDictionary()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   727
        self.dictionary = dictionary
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   728
        self.content = content
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   729
        self.filters = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   730
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   731
        dictionary = self.dictionary
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   732
        # copy it for modification
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   733
        dictionary = PDFDictionary(dictionary.dict.copy())
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   734
        content = self.content
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   735
        filters = self.filters
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   736
        if self.content is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   737
            raise ValueError, "stream content not set"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   738
        if filters is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   739
            filters = document.defaultStreamFilters
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   740
        # only apply filters if they haven't been applied elsewhere
603
a6f460e53b00 forms in forms now work
aaron_watters
parents: 595
diff changeset
   741
        if filters is not None and not dictionary.dict.has_key("Filter"):
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   742
            # apply filters in reverse order listed
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   743
            rf = list(filters)
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   744
            rf.reverse()
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   745
            fnames = []
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   746
            for f in rf:
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   747
                #print "*****************content:"; print repr(content[:200])
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   748
                #print "*****************filter", f.pdfname
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   749
                content = f.encode(content)
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   750
                fnames.insert(0, PDFName(f.pdfname))
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   751
            #print "*****************finally:"; print content[:200]
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   752
            #print "****** FILTERS", fnames
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   753
            #stop
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   754
            dictionary["Filter"] = PDFArray(fnames)
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   755
        # "stream encoding is done after all filters have been applied"
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   756
        content = document.encrypt.encode(content)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   757
        fc = format(content, document)
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   758
        #print "type(content)", type(content), len(content), type(self.dictionary)
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   759
        lc = len(content)
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   760
        #if fc!=content: burp
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   761
        # set dictionary length parameter
591
8ab476fd7d96 minor changes to support pdfparse
aaron_watters
parents: 504
diff changeset
   762
        dictionary["Length"] = lc
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   763
        fd = format(dictionary, document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   764
        sdict = LINEENDDICT.copy()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   765
        sdict["dictionary"] = fd
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   766
        sdict["content"] = fc
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   767
        return STREAMFMT % sdict
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   768
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   769
def teststream(content=None):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   770
    #content = "" # test
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   771
    if content is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   772
        content = teststreamcontent
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   773
    content = string.strip(content)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   774
    content = string.replace(content, "\n", LINEEND) + LINEEND
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   775
    S = PDFStream()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   776
    S.content = content
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
   777
    S.filters = [PDFBase85Encode, PDFZCompress]
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   778
    # nothing else needed...
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   779
    S.__Comment__ = "test stream"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   780
    return S
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   781
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   782
teststreamcontent = """
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   783
1 0 0 1 0 0 cm BT /F9 12 Tf 14.4 TL ET
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   784
1.00 0.00 1.00 rg
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   785
n 72.00 72.00 432.00 648.00 re B*
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   786
"""
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   787
class PDFArray:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   788
    multiline = LongFormat
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   789
    def __init__(self, sequence):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   790
        self.sequence = list(sequence)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   791
    def References(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   792
        """make all objects in sequence references"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   793
        self.sequence = map(document.Reference, self.sequence)
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   794
    def format(self, document, IND=LINEEND+' '):
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   795
        L = [format(e, document) for e in self.sequence]
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   796
        if self.multiline:
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   797
            L = IND.join(L)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   798
        else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   799
            # break up every 10 elements anyway
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   800
            breakline = LINEEND+" "
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   801
            for i in xrange(10, len(L), 10):
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   802
                L.insert(i,breakline)
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   803
            L = ' '.join(L)
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   804
        return "[ %s ]" % L
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   805
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   806
INDIRECTOBFMT = ("%(n)s %(v)s obj%(LINEEND)s"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   807
                 "%(content)s" "%(LINEEND)s"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   808
                 "endobj" "%(LINEEND)s")
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   809
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   810
class PDFIndirectObject:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   811
    __RefOnly__ = 1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   812
    def __init__(self, name, content):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   813
        self.name = name
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   814
        self.content = content
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   815
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   816
        name = self.name
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   817
        (n, v) = document.idToObjectNumberAndVersion[name]
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   818
        # set encryption parameters
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   819
        document.encrypt.register(n, v)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   820
        content = self.content
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   821
        fcontent = format(content, document, toplevel=1) # yes this is at top level
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   822
        sdict = LINEENDDICT.copy()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   823
        sdict["n"] = n
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   824
        sdict["v"] = v
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   825
        sdict["content"] = fcontent
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   826
        return INDIRECTOBFMT % sdict
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   827
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   828
class PDFObjectReference:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   829
    def __init__(self, name):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   830
        self.name = name
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   831
    def format(self, document):
1317
2c0575047463 allow forms to be forward references (to allow table of contents, eg).
aaron_watters
parents: 1309
diff changeset
   832
        try:
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   833
            return "%s %s R" % document.idToObjectNumberAndVersion[self.name]
1317
2c0575047463 allow forms to be forward references (to allow table of contents, eg).
aaron_watters
parents: 1309
diff changeset
   834
        except:
2541
495aea8213fb pdfdoc.py: more optimisations
rgbecker
parents: 2540
diff changeset
   835
            raise KeyError, "forward reference to %s not resolved upon final formatting" % repr(self.name)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   836
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   837
### chapter 5
681
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   838
# Following Ken Lunde's advice and the PDF spec, this includes
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   839
# some high-order bytes.  I chose the characters for Tokyo
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   840
# in Shift-JIS encoding, as these cannot be mistaken for
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   841
# any other encoding, and we'll be able to tell if something
934a4f24ea5d Added explicit font and encoding support
andy_robinson
parents: 674
diff changeset
   842
# has run our PDF files through a dodgy Unicode conversion.
1063
378a0f553608 cosmetics
aaron_watters
parents: 1062
diff changeset
   843
PDFHeader = (
378a0f553608 cosmetics
aaron_watters
parents: 1062
diff changeset
   844
"%PDF-1.3"+LINEEND+
378a0f553608 cosmetics
aaron_watters
parents: 1062
diff changeset
   845
"%\223\214\213\236 ReportLab Generated PDF document http://www.reportlab.com"+LINEEND)
0
f19e0a2433ab Initial revision
gmcm
parents:
diff changeset
   846
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   847
class PDFFile:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   848
    ### just accumulates strings: keeps track of current offset
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   849
    def __init__(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   850
        self.strings = []
2477
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   851
        self.write = self.strings.append
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   852
        self.offset = 0
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   853
        self.add(PDFHeader)
2477
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   854
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   855
    def closeOrReset(self):
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   856
        pass
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   857
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   858
    def add(self, s):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   859
        """should be constructed as late as possible, return position where placed"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   860
        result = self.offset
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   861
        self.offset = result+len(s)
2477
704e05bad378 pdfdoc.py: minor changes to bring into line with TBlatter's early serializer version
rgbecker
parents: 2476
diff changeset
   862
        self.write(s)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   863
        return result
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   864
    def format(self, document):
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   865
        strings = map(str, self.strings) # final conversion, in case of lazy objects
2359
d7991ae46607 pdfdoc: fix rare bug (exposed in tinyrml)
rgbecker
parents: 2332
diff changeset
   866
        return string.join(strings, "")
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   867
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   868
XREFFMT = '%0.10d %0.5d n'
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   869
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   870
class PDFCrossReferenceSubsection:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   871
    def __init__(self, firstentrynumber, idsequence):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   872
        self.firstentrynumber = firstentrynumber
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   873
        self.idsequence = idsequence
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   874
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   875
        """id sequence should represent contiguous object nums else error. free numbers not supported (yet)"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   876
        firstentrynumber = self.firstentrynumber
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   877
        idsequence = self.idsequence
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   878
        entries = list(idsequence)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   879
        nentries = len(idsequence)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   880
        # special case: object number 0 is always free
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   881
        taken = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   882
        if firstentrynumber==0:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   883
            taken[0] = "standard free entry"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   884
            nentries = nentries+1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   885
            entries.insert(0, "0000000000 65535 f")
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   886
        idToNV = document.idToObjectNumberAndVersion
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   887
        idToOffset = document.idToOffset
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   888
        lastentrynumber = firstentrynumber+nentries-1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   889
        for id in idsequence:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   890
            (num, version) = idToNV[id]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   891
            if taken.has_key(num):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   892
                raise ValueError, "object number collision %s %s %s" % (num, repr(id), repr(taken[id]))
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   893
            if num>lastentrynumber or num<firstentrynumber:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   894
                raise ValueError, "object number %s not in range %s..%s" % (num, firstentrynumber, lastentrynumber)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   895
            # compute position in list
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   896
            rnum = num-firstentrynumber
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   897
            taken[num] = id
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   898
            offset = idToOffset[id]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   899
            entries[num] = XREFFMT % (offset, version)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   900
        # now add the initial line
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   901
        firstline = "%s %s" % (firstentrynumber, nentries)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   902
        entries.insert(0, firstline)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   903
        # make sure it ends with a LINEEND
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   904
        entries.append("")
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   905
        if LINEEND=="\n" or LINEEND=="\r":
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   906
            reflineend = " "+LINEEND # as per spec
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   907
        elif LINEEND=="\r\n":
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   908
            reflineend = LINEEND
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   909
        else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   910
            raise ValueError, "bad end of line! %s" % repr(LINEEND)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   911
        return string.join(entries, LINEEND)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   912
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   913
class PDFCrossReferenceTable:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   914
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   915
    def __init__(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   916
        self.sections = []
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   917
    def addsection(self, firstentry, ids):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   918
        section = PDFCrossReferenceSubsection(firstentry, ids)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   919
        self.sections.append(section)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   920
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   921
        sections = self.sections
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   922
        if not sections:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   923
            raise ValueError, "no crossref sections"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   924
        L = ["xref"+LINEEND]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   925
        for s in self.sections:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   926
            fs = format(s, document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   927
            L.append(fs)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   928
        return string.join(L, "")
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   929
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   930
TRAILERFMT = ("trailer%(LINEEND)s"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   931
              "%(dict)s%(LINEEND)s"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   932
              "startxref%(LINEEND)s"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   933
              "%(startxref)s%(LINEEND)s"
873
62ba1388703d New font embedding stuff.
rgbecker
parents: 742
diff changeset
   934
              "%(PERCENT)s%(PERCENT)sEOF%(LINEEND)s")
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   935
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   936
class PDFTrailer:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   937
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   938
    def __init__(self, startxref, Size=None, Prev=None, Root=None, Info=None, ID=None, Encrypt=None):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   939
        self.startxref = startxref
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   940
        if Size is None or Root is None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   941
            raise ValueError, "Size and Root keys required"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   942
        dict = self.dict = PDFDictionary()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   943
        for (n,v) in [("Size", Size), ("Prev", Prev), ("Root", Root),
1062
c6dec1c5a962 extensions to support encryption plugins
aaron_watters
parents: 1014
diff changeset
   944
                      ("Info", Info), ("ID", ID), ("Encrypt", Encrypt)]:
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   945
            if v is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   946
                dict[n] = v
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   947
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   948
        fdict = format(self.dict, document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   949
        D = LINEENDDICT.copy()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   950
        D["dict"] = fdict
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   951
        D["startxref"] = self.startxref
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   952
        return TRAILERFMT % D
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   953
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   954
#### XXXX skipping incremental update,
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   955
#### encryption
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   956
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   957
#### chapter 6, doc structure
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   958
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   959
class PDFCatalog:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   960
    __Comment__ = "Document Root"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   961
    __RefOnly__ = 1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   962
    # to override, set as attributes
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   963
    __Defaults__ = {"Type": PDFName("Catalog"),
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   964
                "PageMode": PDFName("UseNone"),
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   965
                }
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   966
    __NoDefault__ = string.split("""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   967
        Dests Outlines Pages Threads AcroForm Names OpenActions PageMode URI
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   968
        ViewerPreferences PageLabels PageLayout JavaScript StructTreeRoot SpiderInfo"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   969
                                 )
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   970
    __Refs__ = __NoDefault__ # make these all into references, if present
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
   971
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   972
    def format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   973
        self.check_format(document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   974
        defaults = self.__Defaults__
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   975
        Refs = self.__Refs__
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   976
        D = {}
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   977
        for k in defaults.keys():
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   978
            default = defaults[k]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   979
            v = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   980
            if hasattr(self, k) and getattr(self,k) is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   981
                v = getattr(self, k)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   982
            elif default is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   983
                v = default
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   984
            if v is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   985
                D[k] = v
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   986
        for k in self.__NoDefault__:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   987
            if hasattr(self, k):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   988
                v = getattr(self,k)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   989
                if v is not None:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   990
                    D[k] = v
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   991
        # force objects to be references where required
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   992
        for k in Refs:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   993
            if D.has_key(k):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   994
                #print"k is", k, "value", D[k]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   995
                D[k] = document.Reference(D[k])
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   996
        dict = PDFDictionary(D)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   997
        return format(dict, document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   998
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
   999
    def showOutline(self):
2852
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1000
        self.setPageMode("UseOutlines")
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1001
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1002
    def showFullScreen(self):
2852
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1003
        self.setPageMode("FullScreen")
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1004
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1005
    def setPageLayout(self,layout):
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1006
        if layout:
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1007
            self.PageLayout = PDFName(layout)
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1008
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1009
    def setPageMode(self,mode):
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1010
        if mode:
397ae33d96fe pdfdoc.py: added setPageLayout and setPageMode
rgbecker
parents: 2838
diff changeset
  1011
            self.PageMode = PDFName(mode)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
  1012
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1013
    def check_format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1014
        """for use in subclasses"""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1015
        pass
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1016
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1017
class PDFPages(PDFCatalog):
2229
99cb312c5269 Fix transparency & jpeg behaviour
rgbecker
parents: 2200
diff changeset
  1018
    """PAGES TREE WITH ONE INTERNAL NODE, FOR "BALANCING" CHANGE IMPLEMENTATION"""
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1019
    __Comment__ = "page tree"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1020
    __RefOnly__ = 1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1021
    # note: could implement page attribute inheritance...
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1022
    __Defaults__ = {"Type": PDFName("Pages"),
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1023
                    }
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1024
    __NoDefault__ = string.split("Kids Count Parent")
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1025
    __Refs__ = ["Parent"]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1026
    def __init__(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1027
        self.pages = []
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1028
    def __getitem__(self, item):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1029
        return self.pages[item]
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1030
    def addPage(self, page):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1031
        self.pages.append(page)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1032
    def check_format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1033
        # convert all pages to page references
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1034
        pages = self.pages
2229
99cb312c5269 Fix transparency & jpeg behaviour
rgbecker
parents: 2200
diff changeset
  1035
        kids = PDFArray(pages)
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1036
        # make sure all pages are references
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1037
        kids.References(document)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1038
        self.Kids = kids
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1039
        self.Count = len(pages)
2678
38d18a697cd0 reportlab: Python2.5 changes + minor cosmetics and improvements
rgbecker
parents: 2666
diff changeset
  1040
 
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1041
class PDFPage(PDFCatalog):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1042
    __Comment__ = "Page dictionary"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1043
    # all PDF attributes can be set explicitly
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1044
    # if this flag is set, the "usual" behavior will be suppressed
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1045
    Override_default_compilation = 0
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1046
    __RefOnly__ = 1
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1047
    __Defaults__ = {"Type": PDFName("Page"),
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1048
                   # "Parent": PDFObjectReference(Pages),  # no! use document.Pages
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1049
                    }
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1050
    __NoDefault__ = string.split(""" Parent
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1051
        MediaBox Resources Contents CropBox Rotate Thumb Annots B Dur Hid Trans AA
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1052
        PieceInfo LastModified SeparationInfo ArtBox TrimBox BleedBox ID PZ
500
58d712fef651 Fixed page transitions; extended Pythonpoint
andy_robinson
parents: 494
diff changeset
  1053
        Trans
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1054
    """)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1055
    __Refs__ = string.split("""
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1056
        Contents Parent ID
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1057
    """)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1058
    pagewidth = 595
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1059
    pageheight = 842
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1060
    stream = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1061
    hasImages = 0
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1062
    compression = 0
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1063
    XObjects = None
500
58d712fef651 Fixed page transitions; extended Pythonpoint
andy_robinson
parents: 494
diff changeset
  1064
    Trans = None
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1065
    # transitionstring?
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1066
    # xobjects?
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1067
    # annotations
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1068
    def __init__(self):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1069
        # set all nodefaults to None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1070
        for name in self.__NoDefault__:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1071
            setattr(self, name, None)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1072
    def setCompression(self, onoff):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1073
        self.compression = onoff
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1074
    def setStream(self, code):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1075
        if self.Override_default_compilation:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1076
            raise ValueError, "overridden! must set stream explicitly"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1077
        from types import ListType
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1078
        if type(code) is ListType:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1079
            code = string.join(code, LINEEND)+LINEEND
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1080
        self.stream = code
500
58d712fef651 Fixed page transitions; extended Pythonpoint
andy_robinson
parents: 494
diff changeset
  1081
58d712fef651 Fixed page transitions; extended Pythonpoint
andy_robinson
parents: 494
diff changeset
  1082
    def setPageTransition(self, tranDict):
58d712fef651 Fixed page transitions; extended Pythonpoint
andy_robinson
parents: 494
diff changeset
  1083
        self.Trans = PDFDictionary(tranDict)
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
  1084
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1085
    def check_format(self, document):
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1086
        # set up parameters unless usual behaviour is suppressed
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1087
        if self.Override_default_compilation:
1577
ad1dd1f8e061 Jerome Alet's auto transparency patch
rgbecker
parents: 1576
diff changeset
  1088
            return
2798
40f791c3cbf8 pdfdoc.py: allow for proper external forms info
rgbecker
parents: 2778
diff changeset
  1089
        self.MediaBox = self.MediaBox or PDFArray(self.Rotate in (90,270) and [0,0,self.pageheight,self.pagewidth] or [0, 0, self.pagewidth, self.pageheight])
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1090
        if not self.Annots:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1091
            self.Annots = None
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1092
        else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1093
            #print self.Annots
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1094
            #raise ValueError, "annotations not reimplemented yet"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1095
            if type(self.Annots) is not types.InstanceType:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1096
                self.Annots = PDFArray(self.Annots)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1097
        if not self.Contents:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1098
            stream = self.stream
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1099
            if not stream:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1100
                self.Contents = teststream()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1101
            else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1102
                S = PDFStream()
484
cc20a344973c Aaron's latest update from the newslist
rgbecker
parents: 483
diff changeset
  1103
                if self.compression:
1679
e77be1edcd61 Fixed page stream filter order (Thanks Bernhard)
andy_robinson
parents: 1677
diff changeset
  1104
                    S.filters = [PDFBase85Encode, PDFZCompress]
481
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1105
                S.content = stream
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1106
                S.__Comment__ = "page stream"
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1107
                self.Contents = S
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1108
        if not self.Resources:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1109
            resources = PDFResourceDictionary()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1110
            # fonts!
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1111
            resources.basicFonts()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1112
            if self.hasImages:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1113
                resources.allProcs()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1114
            else:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1115
                resources.basicProcs()
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1116
            if self.XObjects:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1117
                #print "XObjects", self.XObjects.dict
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1118
                resources.XObject = self.XObjects
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1119
            self.Resources = resources
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1120
        if not self.Parent:
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1121
            pages = document.Pages
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1122
            self.Parent = document.Reference(pages)
136669babedf complete revision of pdfdoc. Not finished (compression missing, testing needed)
aaron_watters
parents: 479
diff changeset
  1123
2869
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1124
#this code contributed by  Christian Jacobs <cljacobsen@gmail.com> 
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1125
class PDFPageLabels(PDFCatalog):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1126
    __comment__ = None
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1127
    __RefOnly__ = 0
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1128
    __Defaults__ = {}
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1129
    __NoDefault__ = ["Nums"]
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1130
    __Refs__ = []
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1131
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1132
    def __init__(self):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1133
        self.labels = []
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1134
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1135
    def addPageLabel(self, page, label):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1136
        """ Adds a new PDFPageLabel to this catalog.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1137
        The 'page' argument, an integer, is the page number in the PDF document
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1138
        with which the 'label' should be associated. Page numbering in the PDF
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1139
        starts at zero! Thus, to change the label on the first page, '0' should be
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1140
        provided as an argument, and to change the 6th page, '5' should be provided
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1141
        as the argument.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1142
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1143
        The 'label' argument should be a PDFPageLabel instance, which describes the
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1144
        format of the labels starting on page 'page' in the PDF and continuing
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1145
        until the next encounter of a PDFPageLabel.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1146
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1147
        The order in which labels are added is not important.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1148
        """
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1149
        self.labels.append((page, label))
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1150
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1151
    def format(self, document):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1152
        self.labels.sort() 
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1153
        labels = []
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1154
        for page, label in self.labels:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1155
            labels.append(page)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1156
            labels.append(label)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1157
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1158
        self.Nums = PDFArray(labels)    #PDFArray makes a copy with list()
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1159
        return PDFCatalog.format(self, document)
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1160
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1161
class PDFPageLabel(PDFCatalog):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1162
    __Comment__ = None
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1163
    __RefOnly__ = 0
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1164
    __Defaults__ = {}
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1165
    __NoDefault__ = "Type S P St".split()
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1166
    __convertible__ = 'ARABIC ROMAN_UPPER ROMAN_LOWER LETTERS_UPPER LETTERS_LOWER'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1167
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1168
    ARABIC = 'D'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1169
    ROMAN_UPPER = 'R'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1170
    ROMAN_LOWER = 'r'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1171
    LETTERS_UPPER = 'A'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1172
    LETTERS_LOWER = 'a'
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1173
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1174
    def __init__(self, style=None, start=None, prefix=None):
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1175
        """
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1176
        A PDFPageLabel changes the style of page numbering as displayed in a PDF
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1177
        viewer. PDF page labels have nothing to do with 'physical' page numbers
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1178
        printed on a canvas, but instead influence the 'logical' page numbers
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1179
        displayed by PDF viewers. However, when using roman numerals (i, ii,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1180
        iii...) or page prefixes for appendecies (A.1, A.2...) on the physical
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1181
        pages PDF page labels are necessary to change the logical page numbers
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1182
        displayed by the PDF viewer to match up with the physical numbers. A
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1183
        PDFPageLabel changes the properties of numbering at the page on which it
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1184
        appears (see the class 'PDFPageLabels' for specifying where a PDFPageLabel
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1185
        is associated) and all subsequent pages, until a new PDFPageLabel is
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1186
        encountered.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1187
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1188
        The arguments to this initialiser determine the properties of all
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1189
        subsequent page labels. 'style' determines the numberings style, arabic,
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1190
        roman, letters; 'start' specifies the starting number; and 'prefix' any
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1191
        prefix to be applied to the page numbers. All these arguments can be left
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1192
        out or set to None.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1193
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1194
        * style:
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1195
          - None:                       No numbering, can be used to display the
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1196
                                        prefix only.
912456caa112 reportlab: add in PageLabel stuff from Christian jacobs and Date fix from Dinu Gherman
rgbecker
parents: 2852
diff changeset
  1197
          - PDFPageLabel.ARABIC:        Use arabic numbers: 1, 2, 3, 4...