Method build

Lib/pagebot/elements/text.py:296–375

Draws the text on position (x, y). Draws a background rectangle and / or frame if fill and / or stroke are defined. >>> from pagebot.document import Document >>> from pagebot.elements import * >>> from pagebot.contexts import getContext >>> from pagebot.toolb

(self, view, origin=ORIGIN, **kwargs)

        return s+'>'

    def build(self, view, origin=ORIGIN, **kwargs):
        """Draws the text on position (x, y). Draws a background rectangle and
        / or frame if fill and / or stroke are defined.

        >>> from pagebot.document import Document
        >>> from pagebot.elements import *
        >>> from pagebot.contexts import getContext
        >>> from pagebot.toolbox.units import pt, em
        >>> context = getContext()
        >>> W, H = 500, 400
        >>> doc = Document(w=W, h=H, context=context)
        >>> page = doc[1]
        >>> fontSize = pt(100)
        >>> style = dict(font='PageBot-Regular', fontSize=fontSize, leading=fontSize, textFill=(1, 0, 0), xAlign=CENTER)
        >>> bs = context.newString('Hkpx\\nHkpx', style)
        >>> t = Text(bs, x=W/2, y=H/2, parent=page, showOrigin=True, fill=0.9, yAlign=MIDDLE)
        >>> l = Line(x=t.x-t.w/2, y=t.y, w=t.w, h=0, stroke=(0, 0, 0.5), parent=page)
        >>> l = Line(x=t.x-t.w/2, y=t.y+t.bs.capHeight, w=t.w, h=0, stroke=(0, 0, 0.5), parent=page)
        >>> l = Line(x=t.x-t.w/2, y=t.y+t.bs.ascender, w=t.w, h=0, stroke=(0, 0, 0.5), parent=page)
        >>> l = Line(x=t.x-t.w/2, y=t.y+t.bs.xHeight, w=t.w, h=0, stroke=(0, 0, 0.5), parent=page)
        >>> l = Line(x=t.x-t.w/2, y=t.y+t.bs.descender, w=t.w, h=0, stroke=(0, 0, 0.5), parent=page)
        >>> doc.export('_export/Text-build1.pdf')

        >>> W, H = 700, 100
        >>> doc = Document(w=W, h=H, context=context)
        >>> view = doc.view
        >>> view.showOrigin = True
        >>> view.padding = pt(30)
        >>> view.showCropMarks = True
        >>> view.showFrame = True
        >>> style = dict(font='PageBot-Regular', leading=em(1), fontSize=pt(18), textFill=(0, 0, 0.5), xAlign=CENTER)
        >>> txt = 'Lorem ipsum dolor sit amet, consectetur adipiscing elit valim mecto trambor.'
        >>> bs = context.newString(txt, style) # Creates a BabelString with context reference.
        >>> bs.context is context
        True
        >>> t = Text(bs, x=W/2, y=H/2, parent=doc[1], yAlign=MIDDLE_X)
        >>> t.context is context
        True
        >>> doc.export('_export/Text-build2.pdf')
        """
        if not self.bs:
            return

        context = view.context # Get current context

        # Stores scaled x-value first; text is already aligned.
        p = pointOffset(self.origin, origin)
        x, _, _, = self._applyScale(view, p)

        # Determines frame position.
        p = self.getPosition(view, origin)
        px, py, _ = p

        # TODO: Add Element clipping stuff here.
        # FIXME: needs some restructuring, text box width and BabelString width
        # can be different now.

        # Let the view draw frame info for debugging, in case view.showFrame ==