wx.lib.floatcanvas.FCObjects.ScaledTextBox

Draws a text object

The object is scaled when zoomed.

The hit-test is done on the entire text extent

Bugs/Limitations:

As fonts are scaled, they do end up a little different, so you don’t get exactly the same picture as you scale up and down, but it’s pretty darn close.

On wxGTK1 on my Linux system, at least, using a font of over about 1000 pts. brings the system to a halt. It’s the Font Server using huge amounts of memory. My work around is to max the font size to 1000 points, so it won’t scale past there. GTK2 uses smarter font drawing, so that may not be an issue in future versions, so feel free to test. Another smarter way to do it would be to set a global zoom limit at that point.

Class Hierarchy

Inheritance diagram for class ScaledTextBox:

Known Superclasses

wx.lib.floatcanvas.FCObjects.DrawObject, wx.lib.floatcanvas.FCObjects.TextObjectMixin

Methods Summary

__init__	Default class constructor.
CalcBoundingBox	Calculates the Bounding Box
GetBoxRect
LayoutText	Calculates the positions of the words of text.
ReWrap
WrapToWidth

Class API

class ScaledTextBox(TextObjectMixin, DrawObject)

Draws a text object

The object is scaled when zoomed.

The hit-test is done on the entire text extent

Bugs/Limitations:

As fonts are scaled, they do end up a little different, so you don’t get exactly the same picture as you scale up and down, but it’s pretty darn close.

On wxGTK1 on my Linux system, at least, using a font of over about 1000 pts. brings the system to a halt. It’s the Font Server using huge amounts of memory. My work around is to max the font size to 1000 points, so it won’t scale past there. GTK2 uses smarter font drawing, so that may not be an issue in future versions, so feel free to test. Another smarter way to do it would be to set a global zoom limit at that point.

Methods

__init__(self, String, Point, Size, Color = "Black", BackgroundColor = None, LineColor = 'Black', LineStyle = 'Solid', LineWidth = 1, Width = None, PadSize = None, Family = wx.FONTFAMILY_MODERN, Style = wx.FONTSTYLE_NORMAL, Weight = wx.FONTWEIGHT_NORMAL, Underlined = False, Position = 'tl', Alignment = "left", Font = None, LineSpacing = 1.0, InForeground = False)

Default class constructor.

Parameters:

• Point – takes a 2-tuple, or a (2,) NumPy array of point coordinates

• Size (integer) – size in World units

• Color – see SetColor

• BackgroundColor – see SetColor

• LineColor – see SetColor

• LineWidth – see SetLineWidth

• Width – width in pixels or None, text will be wrapped to the given width.

• PadSize – padding in world units or None, if specified it will creating a space (margin) around the text

• Family (FontFamily) – a valid wx.FontFamily

• Style (FontStyle) – a valid wx.FontStyle

• Weight (FontWeight) – a valid wx.FontWeight

• Underlined (boolean) – underline the text

• Position (string) –

  a two character string indicating where in relation to the coordinates the box should be oriented

  1st character	Meaning
  t	top
  c	center
  b	bottom

  2nd character	Meaning
  l	left
  c	center
  r	right

• Alignment – see SetLineWidth

• Font (wx.Font) – alternatively a valid wx.Font can be defined in which case the above will be ignored

• LineSpacing (float) – the line space to be used

• InForeground (boolean) – should object be in foreground

---

CalcBoundingBox(self)

Calculates the Bounding Box

---

GetBoxRect(self)

---

LayoutText(self)

Calculates the positions of the words of text.

This isn’t exact, as fonts don’t scale exactly. To help this, the position of each individual word is stored separately, so that the general layout stays the same in world coordinates, as the fonts scale.

---

ReWrap(self, Width)

---

WrapToWidth(self)