#coding:utf-8
# Author: mozman --<mozman@gmx.at>
# Purpose: text objects
# Created: 20.09.2010
# Copyright (C) 2010, Manfred Moitzi
# License: MIT License
"""
Text that is to be rendered as part of an SVG document fragment is specified
using the **text** element. The characters to be drawn are expressed as XML
character data inside the **text** element.
"""
from svgwrite.base import BaseElement
from svgwrite.mixins import Presentation, Transform, XLink
from svgwrite.utils import iterflatlist, strlist, is_string, to_unicode
class TSpan(BaseElement, Presentation):
"""
Within a **Text** element, text and font properties
and the current text position can be adjusted with absolute or relative
coordinate values by using the **TSpan** element.
The characters to be drawn are expressed as XML character data inside the
**TSpan** element.
"""
elementname = 'tspan'
def __init__(self, text, insert=None, x=None, y=None, dx=None, dy=None, rotate=None,
**extra):
"""
:param string text: **tspan** content
:param 2-tuple insert: The **insert** parameter is the absolute insert point
of the text, don't use this parameter in combination
with the **x** or the **y** parameter.
:param list x: list of absolute x-axis values for characters
:param list y: list of absolute y-axis values for characters
:param list dx: list of relative x-axis values for characters
:param list dy: list of relative y-axis values for characters
:param list rotate: list of rotation-values for characters (in degrees)
"""
super(TSpan, self).__init__(**extra)
self.text = text
if insert is not None:
if is_string(insert):
raise TypeError("'insert' should be a <tuple> or a <list> with"
" at least two elements.")
if x or y:
raise ValueError("Use 'insert' and 'x' or 'y' parameter not"
" at the same time!")
x = [insert[0]]
y = [insert[1]]
if x is not None:
self['x'] = strlist(list(iterflatlist(x)), ' ')
if y is not None:
self['y'] = strlist(list(iterflatlist(y)), ' ')
if dx is not None:
self['dx'] = strlist(list(iterflatlist(dx)), ' ')
if dy is not None:
self['dy'] = strlist(list(iterflatlist(dy)), ' ')
if rotate is not None:
self['rotate'] = strlist(list(iterflatlist(rotate)), ' ')
def get_xml(self):
xml = super(TSpan, self).get_xml()
xml.text = to_unicode(self.text)
return xml
class Text(TSpan, Transform):
"""
The **Text** element defines a graphics element consisting of text.
The characters to be drawn are expressed as XML character data inside the
**Text** element.
"""
elementname = 'text'
class TRef(BaseElement, XLink, Presentation):
"""
The textual content for a **Text** can be either character data directly
embedded within the <text> element or the character data content of a
referenced element, where the referencing is specified with a **TRef**
element.
"""
elementname = 'tref'
def __init__(self, element, **extra):
"""
:param element: create a reference this element, if element is a \
`string` its the **id** name of the referenced element, \
if element is a :class:`~svgwrite.base.BaseElement` \
the **id** SVG Attribute is used to create the reference.
"""
super(TRef, self).__init__(**extra)
self.set_href(element)
def get_xml(self):
self.update_id() # if href is an object - 'id' - attribute may be changed!
return super(TRef, self).get_xml()
class TextPath(BaseElement, XLink, Presentation):
"""
In addition to text drawn in a straight line, SVG also includes the
ability to place text along the shape of a **path** element. To specify that
a block of text is to be rendered along the shape of a **path**, include
the given text within a **textPath** element which includes an **xlink:href**
attribute with a IRI reference to a **path** element.
"""
elementname = 'textPath'
def __init__(self, path, text, startOffset=None, method='align', spacing='exact',
**extra):
"""
:param path: link to **path**, **id** string or **Path** object
:param string text: **textPath** content
:param number startOffset: text starts with offset from begin of path.
:param string method: ``align|stretch``
:param string spacing: ``exact|auto``
"""
super(TextPath, self).__init__(**extra)
self.text = text
if method == 'stretch':
self['method'] = method
if spacing == 'auto':
self['spacing'] = spacing
if startOffset is not None:
self['startOffset'] = startOffset
self.set_href(path)
def get_xml(self):
self.update_id() # if href is an object - 'id' - attribute may be changed!
xml = super(TextPath, self).get_xml()
xml.text = to_unicode(self.text)
return xml
class TBreak(BaseElement):
elementname = 'tbreak'
def __init__(self, **extra):
super(TBreak, self).__init__(**extra)
def __getitem__(self, key):
raise NotImplementedError("__getitem__() not supported by TBreak class.")
def __setitem__(self, key, value):
raise NotImplementedError("__setitem__() not supported by TBreak class.")
def add(self, element):
raise NotImplementedError("add() not supported by TBreak class.")
class TextArea(BaseElement, Transform, Presentation):
"""
At this time **textArea** is only available for SVG 1.2 Tiny profile.
The **textArea** element allows simplistic wrapping of text content within a
given region. The `tiny` profile of SVG specifies a single rectangular region.
Other profiles may allow a sequence of arbitrary shapes.
Text wrapping via the **textArea** element is available as a lightweight and
convenient facility for simple text wrapping where a complete box model layout
engine is not required.
The layout of wrapped text is user agent dependent; thus, content developers
need to be aware that there might be different results, particularly with
regard to where line breaks occur.
The TextArea class wraps every text added by write() or writeline() as
**tspan** element.
"""
elementname = 'textArea'
def __init__(self, text=None, insert=None, size=None, **extra):
super(TextArea, self).__init__(**extra)
if text is not None:
self.write(text)
if insert is not None:
self['x'] = insert[0]
self['y'] = insert[1]
if size is not None:
self['width'] = size[0]
self['height'] = size[1]
def line_increment(self, value):
""" Set the line-spacing to *value*. """
self['line-increment'] = value
def write(self, text, **extra):
"""
Add text as **tspan** elements, with extra-params for the **tspan** element.
Use the '\\\\n' character for line breaks.
"""
if '\n' not in text:
self.add(TSpan(text, **extra))
else:
lines = text.split('\n')
for line in lines[:-1]:
if line: # no text between '\n'+
self.add(TSpan(line, **extra))
self.add(TBreak())
# case "text\n" : last element is ''
# case "texta\ntextb : last element is 'textb'
if lines[-1]:
self.add(TSpan(lines[-1], **extra))
