- class neoscore.core.rich_text.RichText
A graphical rich text object.
Unlike its simpler counterpart in
Text, this supports rich formatting with HTML input. As neoscore is currently backed by Qt, this input supports Qt’s HTML subset documented at https://doc.qt.io/qt-5/richtext-html-subset.html
- __init__(pos: PointDef, parent: Optional[PositionedObject], html_text: str, width: Optional[Unit] = None, font: Optional[Font] = None, scale: float = 1, rotation: float = 0, transform_origin: PointDef = ORIGIN)
pos – Position relative to the parent
parent – The parent (core-level) object or None
html_text – The text to be displayed, written in HTML.
width – The maximum width for the displayed text. If omitted, lines will only break when explicitly called for by the HTML.
font – The default font to display the text in.
scale – A scaling factor relative to the font size.
rotation – Rotation angle in degrees.
transform_origin – The origin point for rotation and scaling transforms
- property breakable_length: Unit
The breakable length of the object.
This is always 0, meaning RichText objects cannot be broken across Flowable lines.
- property html_text: str
The text to be displayed, written in HTML.
- property width: Optional[Unit]
The maximum width for the displayed text.
If omitted, lines will only break when explicitly called for by the HTML.
- property font: Font
The default font used to display the text.
HTML markup can override this to different styles and famililes.
- render_complete(pos: Point, flowable_line: Optional[NewLine] = None, flowable_x: Optional[Unit] = None)
Render the entire object.
This is used to render all objects outside flowables, as well as those inside flowables when they fit completely in one line of the flowable.
By default, this is a no-op. Subclasses with rendered appearances should override this.
This method behaves differently inside and outside of flowables. Whether this object is inside a flowable can be determined by whether a
flowable_lineis given. When inside a flowable, the given position is in global document coordinates, and created interfaces (or higher level classes) must not be assigned a parent. When not inside a flowable, the given position is relative to
self.parentand created interfaces (or higher level classes) must be assigned a parent. In this case, created interfaces should use
self.parent.interface_for_childrenas their parent.
This and other render methods should generally not be called directly.
pos – The rendering position. If outside a flowable, this is relative to the parent. Otherwise, it is in document coordinates.
flowable_line – If in a
Flowable, the line in which this object appears
flowable_x – If in a
Flowable, the flowable x position of this render