reportlab/platypus/frames.py
author rgbecker
Mon, 18 Aug 2008 14:42:09 +0000
changeset 2950 6c243412b06c
parent 2915 f2c1f8ef3b51
permissions -rw-r--r--
platypus: add support for FramSplitter flowable
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
2332
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2213
diff changeset
     1
#Copyright ReportLab Europe Ltd. 2000-2004
494
54257447cfe9 Changed to indirect copyright
rgbecker
parents: 470
diff changeset
     2
#see license.txt for license details
2332
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2213
diff changeset
     3
#history http://www.reportlab.co.uk/cgi-bin/viewcvs.cgi/public/reportlab/trunk/reportlab/platypus/frames.py
565
179927300074 Minor changes.
dinu_gherman
parents: 541
diff changeset
     4
2332
2a7ab4405e18 Remove $Header:, fix CopyRight & history
rgbecker
parents: 2213
diff changeset
     5
__version__=''' $Id$ '''
565
179927300074 Minor changes.
dinu_gherman
parents: 541
diff changeset
     6
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
     7
__doc__="""
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
     8
"""
565
179927300074 Minor changes.
dinu_gherman
parents: 541
diff changeset
     9
2500
ea0e8cec358c added a platypus logger
andy
parents: 2379
diff changeset
    10
import logging
ea0e8cec358c added a platypus logger
andy
parents: 2379
diff changeset
    11
logger = logging.getLogger('reportlab.platypus')
ea0e8cec358c added a platypus logger
andy
parents: 2379
diff changeset
    12
565
179927300074 Minor changes.
dinu_gherman
parents: 541
diff changeset
    13
_geomAttr=('x1', 'y1', 'width', 'height', 'leftPadding', 'bottomPadding', 'rightPadding', 'topPadding')
1231
05dc2104f72d disable LayoutError error for production use (option to enable for debug)
aaron_watters
parents: 1035
diff changeset
    14
from reportlab import rl_config
2379
6226a940d978 move _FUZZ to rl_config
rgbecker
parents: 2375
diff changeset
    15
_FUZZ=rl_config._FUZZ
1231
05dc2104f72d disable LayoutError error for production use (option to enable for debug)
aaron_watters
parents: 1035
diff changeset
    16
2735
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    17
class ShowBoundaryValue:
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    18
    def __init__(self,color=(0,0,0),width=0.1):
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    19
        self.color = color
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    20
        self.width = width
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    21
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    22
    def __nonzero__(self):
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    23
        return self.color is not None and self.width>=0
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
    24
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    25
class Frame:
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    26
    '''
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    27
    A Frame is a piece of space in a document that is filled by the
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    28
    "flowables" in the story.  For example in a book like document most
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    29
    pages have the text paragraphs in one or two frames.  For generality
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    30
    a page might have several frames (for example for 3 column text or
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    31
    for text that wraps around a graphic).
1683
7fa753e4420a Removed all trailing whitespace
andy_robinson
parents: 1677
diff changeset
    32
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    33
    After creation a Frame is not usually manipulated directly by the
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    34
    applications program -- it is used internally by the platypus modules.
1683
7fa753e4420a Removed all trailing whitespace
andy_robinson
parents: 1677
diff changeset
    35
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    36
    Here is a diagramatid abstraction for the definitional part of a Frame
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    37
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    38
                width                    x2,y2
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    39
        +---------------------------------+
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    40
        | l  top padding                r | h
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    41
        | e +-------------------------+ i | e
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    42
        | f |                         | g | i
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    43
        | t |                         | h | g
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    44
        |   |                         | t | h
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    45
        | p |                         |   | t
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    46
        | a |                         | p |
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    47
        | d |                         | a |
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    48
        |   |                         | d |
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    49
        |   +-------------------------+   |
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    50
        |    bottom padding               |
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    51
        +---------------------------------+
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    52
        (x1,y1) <-- lower left corner
1683
7fa753e4420a Removed all trailing whitespace
andy_robinson
parents: 1677
diff changeset
    53
268
8414113fa500 more documentation changes
aaron_watters
parents: 253
diff changeset
    54
        NOTE!! Frames are stateful objects.  No single frame should be used in
8414113fa500 more documentation changes
aaron_watters
parents: 253
diff changeset
    55
        two documents at the same time (especially in the presence of multithreading.
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    56
    '''
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    57
    def __init__(self, x1, y1, width,height, leftPadding=6, bottomPadding=6,
2213
edf7d844279c Added overlapAttachedSpace
rgbecker
parents: 2200
diff changeset
    58
            rightPadding=6, topPadding=6, id=None, showBoundary=0,
2531
40b6f4b41f7c platypus: changes to make identity more useful
rgbecker
parents: 2525
diff changeset
    59
            overlapAttachedSpace=None,_debug=None):
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    60
        self.id = id
2531
40b6f4b41f7c platypus: changes to make identity more useful
rgbecker
parents: 2525
diff changeset
    61
        self._debug = _debug
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    62
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    63
        #these say where it goes on the page
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    64
        self.__dict__['_x1'] = x1
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    65
        self.__dict__['_y1'] = y1
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    66
        self.__dict__['_width'] = width
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    67
        self.__dict__['_height'] = height
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    68
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    69
        #these create some padding.
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    70
        self.__dict__['_leftPadding'] = leftPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    71
        self.__dict__['_bottomPadding'] = bottomPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    72
        self.__dict__['_rightPadding'] = rightPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    73
        self.__dict__['_topPadding'] = topPadding
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    74
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    75
        # if we want a boundary to be shown
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    76
        self.showBoundary = showBoundary
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    77
2213
edf7d844279c Added overlapAttachedSpace
rgbecker
parents: 2200
diff changeset
    78
        if overlapAttachedSpace is None: overlapAttachedSpace = rl_config.overlapAttachedSpace
edf7d844279c Added overlapAttachedSpace
rgbecker
parents: 2200
diff changeset
    79
        self._oASpace = overlapAttachedSpace
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    80
        self._geom()
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    81
        self._reset()
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
    82
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    83
    def __getattr__(self,a):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    84
        if a in _geomAttr: return self.__dict__['_'+a]
2915
f2c1f8ef3b51 reportlab: obsoletisms removed
rgbecker
parents: 2735
diff changeset
    85
        raise AttributeError(a)
410
b5c0992c9b99 geometry changing attributes now work
rgbecker
parents: 332
diff changeset
    86
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    87
    def __setattr__(self,a,v):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    88
        if a in _geomAttr:
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    89
            self.__dict__['_'+a] = v
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    90
            self._geom()
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    91
        else:
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
    92
            self.__dict__[a] = v
410
b5c0992c9b99 geometry changing attributes now work
rgbecker
parents: 332
diff changeset
    93
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    94
    def _saveGeom(self, **kwds):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    95
        if not self.__dict__.setdefault('_savedGeom',{}):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    96
            for ga in _geomAttr:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    97
                ga = '_'+ga
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    98
                self.__dict__['_savedGeom'][ga] = self.__dict__[ga]
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
    99
        for k,v in kwds.iteritems():
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   100
            setattr(self,k,v)
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   101
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   102
    def _restoreGeom(self):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   103
        if self.__dict__.get('_savedGeom',None):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   104
            for ga in _geomAttr:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   105
                ga = '_'+ga
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   106
                self.__dict__[ga] = self.__dict__[ga]['_savedGeom']
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   107
                del self.__dict__['_savedGeom']
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   108
            self._geom()
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   109
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   110
    def _geom(self):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   111
        self._x2 = self._x1 + self._width
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   112
        self._y2 = self._y1 + self._height
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   113
        #efficiency
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   114
        self._y1p = self._y1 + self._bottomPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   115
        #work out the available space
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   116
        self._aW = self._x2 - self._x1 - self._leftPadding - self._rightPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   117
        self._aH = self._y2 - self._y1p - self._topPadding
410
b5c0992c9b99 geometry changing attributes now work
rgbecker
parents: 332
diff changeset
   118
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   119
    def _reset(self):
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   120
        self._restoreGeom()
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   121
        #drawing starts at top left
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   122
        self._x = self._x1 + self._leftPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   123
        self._y = self._y2 - self._topPadding
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   124
        self._atTop = 1
2213
edf7d844279c Added overlapAttachedSpace
rgbecker
parents: 2200
diff changeset
   125
        self._prevASpace = 0
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   126
2525
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   127
        # these two should NOT be set on a frame.
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   128
        # they are used when Indenter flowables want
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   129
        # to adjust edges e.g. to do nested lists
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   130
        self._leftExtraIndent = 0.0
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   131
        self._rightExtraIndent = 0.0
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   132
1923
e692491f0967 Added relative indentation
andy_robinson
parents: 1838
diff changeset
   133
    def _getAvailableWidth(self):
e692491f0967 Added relative indentation
andy_robinson
parents: 1838
diff changeset
   134
        return self._aW - self._leftExtraIndent - self._rightExtraIndent
2200
be0cfccc662a Fixed up tabs and whitespace in all source files
andy_robinson
parents: 2013
diff changeset
   135
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   136
    def _add(self, flowable, canv, trySplit=0):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   137
        """ Draws the flowable at the current position.
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   138
        Returns 1 if successful, 0 if it would not fit.
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   139
        Raises a LayoutError if the object is too wide,
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   140
        or if it is too high for a totally empty frame,
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   141
        to avoid infinite loops"""
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   142
        flowable._frame = self
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   143
        flowable.canv = canv #so they can use stringWidth etc
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   144
        try:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   145
            if getattr(flowable,'frameAction',None):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   146
                flowable.frameAction(self)
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   147
                return 1
2525
634ec1f48514 platypus: initial FrameFlowable implementation
rgbecker
parents: 2500
diff changeset
   148
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   149
            y = self._y
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   150
            p = self._y1p
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   151
            s = 0
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   152
            aW = self._getAvailableWidth()
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   153
            if not self._atTop:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   154
                s =flowable.getSpaceBefore()
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   155
                if self._oASpace:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   156
                    s = max(s-self._prevASpace,0)
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   157
            h = y - p - s
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   158
            if h>0:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   159
                w, h = flowable.wrap(aW, h)
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   160
            else:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   161
                return 0
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   162
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   163
            h += s
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   164
            y -= h
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   165
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   166
            if y < p-_FUZZ:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   167
                if not rl_config.allowTableBoundsErrors and ((h>self._aH or w>aW) and not trySplit):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   168
                    from reportlab.platypus.doctemplate import LayoutError
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   169
                    raise LayoutError("Flowable %s (%sx%s points) too large for frame (%sx%s points)." % (
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   170
                        flowable.__class__, w,h, aW,self._aH))
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   171
                return 0
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   172
            else:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   173
                #now we can draw it, and update the current point.
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   174
                flowable.drawOn(canv, self._x + self._leftExtraIndent, y, _sW=aW-w)
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   175
                flowable.canv=canv
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   176
                if self._debug: logger.debug('drew %s' % flowable.identity())
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   177
                s = flowable.getSpaceAfter()
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   178
                y -= s
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   179
                if self._oASpace: self._prevASpace = s
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   180
                if y!=self._y: self._atTop = 0
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   181
                self._y = y
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   182
                return 1
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   183
        finally:
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   184
            del flowable.canv, flowable._frame
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   185
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   186
    add = _add
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   187
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   188
    def split(self,flowable,canv):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   189
        '''Ask the flowable to split using up the available space.'''
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   190
        y = self._y
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   191
        p = self._y1p
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   192
        s = 0
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   193
        if not self._atTop: s = flowable.getSpaceBefore()
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   194
        flowable.canv = canv    #some flowables might need this
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   195
        r = flowable.split(self._aW, y-p-s)
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   196
        del flowable.canv
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   197
        return r
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   198
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   199
    def drawBoundary(self,canv):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   200
        "draw the frame boundary as a rectangle (primarily for debugging)."
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   201
        from reportlab.lib.colors import Color, CMYKColor, toColor
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   202
        sb = self.showBoundary
2735
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   203
        ss = type(sb) in (type(''),type(()),type([])) or isinstance(sb,Color)
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   204
        w = -1
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   205
        if ss:
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   206
            c = toColor(sb,self)
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   207
            ss = c is not self
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   208
        elif isinstance(sb,ShowBoundaryValue) and sb:
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   209
            c = toColor(sb.color,self)
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   210
            w = sb.width
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   211
            ss = c is not self
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   212
        if ss:
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   213
            canv.saveState()
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   214
            canv.setStrokeColor(c)
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   215
            if w>=0:
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   216
                canv.setLineWidth(w)
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   217
        canv.rect(
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   218
                self._x1,
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   219
                self._y1,
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   220
                self._x2 - self._x1,
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   221
                self._y2 - self._y1
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   222
                )
2735
70cf084e5811 reportlab: fix justification space counting bug and improve tests
rgbecker
parents: 2593
diff changeset
   223
        if ss: canv.restoreState()
1683
7fa753e4420a Removed all trailing whitespace
andy_robinson
parents: 1677
diff changeset
   224
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   225
    def addFromList(self, drawlist, canv):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   226
        """Consumes objects from the front of the list until the
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   227
        frame is full.  If it cannot fit one object, raises
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   228
        an exception."""
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   229
2532
130a873a98f6 frames.py: logger only when _debug
rgbecker
parents: 2531
diff changeset
   230
        if self._debug: logger.debug("enter Frame.addFromlist() for frame %s" % self.id)
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   231
        if self.showBoundary:
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   232
            self.drawBoundary(canv)
253
cfcf8d555a2c Platypus re-organisation
rgbecker
parents:
diff changeset
   233
1677
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   234
        while len(drawlist) > 0:
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   235
            head = drawlist[0]
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   236
            if self.add(head,canv,trySplit=0):
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   237
                del drawlist[0]
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   238
            else:
1450177dd19e Exterminated all tab characters and added a test to make sure
andy_robinson
parents: 1652
diff changeset
   239
                #leave it in the list for later
2013
6899a4177d08 I think we actually need a width check
rgbecker
parents: 1923
diff changeset
   240
                break
2950
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   241
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   242
    def add_generated_content(self,*C):
6c243412b06c platypus: add support for FramSplitter flowable
rgbecker
parents: 2915
diff changeset
   243
        self.__dict__.setdefault('_generated_content',[]).extend(C)