Server IP : 85.214.239.14 / Your IP : 18.226.180.253 Web Server : Apache/2.4.62 (Debian) System : Linux h2886529.stratoserver.net 4.9.0 #1 SMP Tue Jan 9 19:45:01 MSK 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.18 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : OFF | WGET : ON | Perl : ON | Python : ON | Sudo : ON | Pkexec : OFF Directory : /srv/modoboa/env/lib64/python3.5/site-packages/reportlab/platypus/ |
Upload File : |
#Copyright ReportLab Europe Ltd. 2000-2017 #see license.txt for license details #history https://hg.reportlab.com/hg-public/reportlab/log/tip/src/reportlab/platypus/frames.py __version__='3.5.14' __doc__="""A frame is a container for content on a page. """ __all__ = ( 'ShowBoundaryValue', 'Frame', ) import logging logger = logging.getLogger('reportlab.platypus') _geomAttr=('x1', 'y1', 'width', 'height', 'leftPadding', 'bottomPadding', 'rightPadding', 'topPadding') from reportlab import rl_config, isPy3 from reportlab.lib.rl_accel import fp_str _FUZZ=rl_config._FUZZ class ShowBoundaryValue: def __init__(self,color=(0,0,0),width=0.1,dashArray=None): self.color = color self.width = width self.dashArray = dashArray if isPy3: def __bool__(self): return self.color is not None and self.width>=0 else: def __nonzero__(self): return self.color is not None and self.width>=0 class Frame: ''' A Frame is a piece of space in a document that is filled by the "flowables" in the story. For example in a book like document most pages have the text paragraphs in one or two frames. For generality a page might have several frames (for example for 3 column text or for text that wraps around a graphic). After creation a Frame is not usually manipulated directly by the applications program -- it is used internally by the platypus modules. Here is a diagramatid abstraction for the definitional part of a Frame:: width x2,y2 +---------------------------------+ | l top padding r | h | e +-------------------------+ i | e | f | | g | i | t | | h | g | | | t | h | p | | | t | a | | p | | d | | a | | | | d | | +-------------------------+ | | bottom padding | +---------------------------------+ (x1,y1) <-- lower left corner NOTE!! Frames are stateful objects. No single frame should be used in two documents at the same time (especially in the presence of multithreading. ''' def __init__(self, x1, y1, width,height, leftPadding=6, bottomPadding=6, rightPadding=6, topPadding=6, id=None, showBoundary=0, overlapAttachedSpace=None,_debug=None): self.id = id self._debug = _debug #these say where it goes on the page self.__dict__['_x1'] = x1 self.__dict__['_y1'] = y1 self.__dict__['_width'] = width self.__dict__['_height'] = height #these create some padding. self.__dict__['_leftPadding'] = leftPadding self.__dict__['_bottomPadding'] = bottomPadding self.__dict__['_rightPadding'] = rightPadding self.__dict__['_topPadding'] = topPadding # if we want a boundary to be shown self.showBoundary = showBoundary if overlapAttachedSpace is None: overlapAttachedSpace = rl_config.overlapAttachedSpace self._oASpace = overlapAttachedSpace self._geom() self._reset() def __getattr__(self,a): if a in _geomAttr: return self.__dict__['_'+a] raise AttributeError(a) def __setattr__(self,a,v): if a in _geomAttr: self.__dict__['_'+a] = v self._geom() else: self.__dict__[a] = v def _saveGeom(self, **kwds): if not self.__dict__.setdefault('_savedGeom',{}): for ga in _geomAttr: ga = '_'+ga self.__dict__['_savedGeom'][ga] = self.__dict__[ga] for k,v in kwds.items(): setattr(self,k,v) def _restoreGeom(self): if self.__dict__.get('_savedGeom',None): for ga in _geomAttr: ga = '_'+ga self.__dict__[ga] = self.__dict__[ga]['_savedGeom'] del self.__dict__['_savedGeom'] self._geom() def _geom(self): self._x2 = self._x1 + self._width self._y2 = self._y1 + self._height #efficiency self._y1p = self._y1 + self._bottomPadding #work out the available space self._aW = self._x2 - self._x1 - self._leftPadding - self._rightPadding self._aH = self._y2 - self._y1p - self._topPadding def _reset(self): self._restoreGeom() #drawing starts at top left self._x = self._x1 + self._leftPadding self._y = self._y2 - self._topPadding self._atTop = 1 self._prevASpace = 0 # these two should NOT be set on a frame. # they are used when Indenter flowables want # to adjust edges e.g. to do nested lists self._leftExtraIndent = 0.0 self._rightExtraIndent = 0.0 def _getAvailableWidth(self): return self._aW - self._leftExtraIndent - self._rightExtraIndent def _add(self, flowable, canv, trySplit=0): """ Draws the flowable at the current position. Returns 1 if successful, 0 if it would not fit. Raises a LayoutError if the object is too wide, or if it is too high for a totally empty frame, to avoid infinite loops""" flowable._frame = self flowable.canv = canv #so they can use stringWidth etc try: if getattr(flowable,'frameAction',None): flowable.frameAction(self) return 1 y = self._y p = self._y1p s = 0 aW = self._getAvailableWidth() zeroSize = getattr(flowable,'_ZEROSIZE',False) if not self._atTop: s =flowable.getSpaceBefore() if self._oASpace: if getattr(flowable,'_SPACETRANSFER',False) or zeroSize: s = self._prevASpace s = max(s-self._prevASpace,0) h = y - p - s if h>0 or zeroSize: w, h = flowable.wrap(aW, h) else: return 0 h += s y -= h if y < p-_FUZZ: if not rl_config.allowTableBoundsErrors and ((h>self._aH or w>aW) and not trySplit): from reportlab.platypus.doctemplate import LayoutError raise LayoutError("Flowable %s (%sx%s points) too large for frame (%sx%s points)." % ( flowable.__class__, w,h, aW,self._aH)) return 0 else: #now we can draw it, and update the current point. sa = flowable.getSpaceAfter() fbg = getattr(self,'_frameBGs',None) if fbg and fbg[-1].active: bg = fbg[-1] fbgl = bg.left fbgr = bg.right bgm = bg.start fbw = self._width-fbgl-fbgr fbx = self._x1+fbgl if not bgm: fbh = y + h + sa fby = max(p,y-sa) fbh = max(0,fbh-fby) else: fbh = y + h - s att = fbh>=self._y2 - self._topPadding if bgm=='frame' or bgm=='frame-permanent' or (att and bgm=='frame-permanent-1'): #first time or att top use fbh = max(0,(self._y2 if att else fbh)-self._y1) fby = self._y1 if bgm=='frame-permanent': fbg[-1].start = 'frame-permanent-1' else: fby = fbw = fbh = 0 bg.render(canv,self,fbx,fby,fbw,fbh) if bgm=='frame': fbg.pop() flowable.drawOn(canv, self._x + self._leftExtraIndent, y, _sW=aW-w) flowable.canv=canv if self._debug: logger.debug('drew %s' % flowable.identity()) y -= sa if self._oASpace: if getattr(flowable,'_SPACETRANSFER',False): sa = self._prevASpace self._prevASpace = sa if y!=self._y: self._atTop = 0 self._y = y return 1 finally: #sometimes canv/_frame aren't still on the flowable for a in ('canv', '_frame'): if hasattr(flowable,a): delattr(flowable,a) add = _add def split(self,flowable,canv): '''Ask the flowable to split using up the available space.''' y = self._y p = self._y1p s = 0 if not self._atTop: s = flowable.getSpaceBefore() if self._oASpace: s = max(s-self._prevASpace,0) h = y-p-s if h<=0 and not getattr(flowable,'_ZEROSIZE',False): return [] flowable._frame = self #some flowables might need these flowable.canv = canv try: r = flowable.split(self._aW, h) finally: #sometimes canv/_frame aren't still on the flowable for a in ('canv', '_frame'): if hasattr(flowable,a): delattr(flowable,a) return r @staticmethod def _drawBoundary(canv,sb,x1,y1,width,height): "draw the frame boundary as a rectangle (primarily for debugging)." from reportlab.lib.colors import Color, toColor ss = isinstance(sb,(str,tuple,list)) or isinstance(sb,Color) w = -1 da = None if ss: c = toColor(sb,-1) ss = c != -1 elif isinstance(sb,ShowBoundaryValue) and sb: c = toColor(sb.color,-1) ss = c != -1 if ss: w = sb.width da = sb.dashArray if ss: canv.saveState() canv.setStrokeColor(c) if w>=0: canv.setLineWidth(w) if da: canv.setDash(da) canv.rect(x1,y1,width,height) if ss: canv.restoreState() def drawBoundary(self,canv, __boundary__=None): self._drawBoundary(canv,__boundary__ or self.showBoundary, self._x1, self._y1, self._x2 - self._x1, self._y2 - self._y1) def addFromList(self, drawlist, canv): """Consumes objects from the front of the list until the frame is full. If it cannot fit one object, raises an exception.""" if self._debug: logger.debug("enter Frame.addFromlist() for frame %s" % self.id) if self.showBoundary: self.drawBoundary(canv) while len(drawlist) > 0: head = drawlist[0] if self.add(head,canv,trySplit=0): del drawlist[0] else: #leave it in the list for later break def add_generated_content(self,*C): self.__dict__.setdefault('_generated_content',[]).extend(C) def _aSpaceString(self): return '(%s x %s%s)' % (self._getAvailableWidth(),self._aH,self._atTop and '*' or '')