alto.ui.degree_text
Draw scale-degree carets above their digits without relying on font-specific combining accents.
Examples
>>> button = DegreeButton("♭3̂")
>>> button.text()
'♭3̂'
draw_degree_text
def draw_degree_text(
painter: QPainter,
*,
rect: QRectF,
text: str,
alignment: Qt.AlignmentFlag = Qt.AlignmentFlag.AlignCenter,
) -> None
Draw text with each combining circumflex centered above its preceding digit.
Parameters
painter(QPainter): The active painter, with the desired font and color.rect(QRectF): The rectangle in which to align the text. Keyword-only.text(str): The text, retaining combining circumflexes for copying and accessibility. Keyword-only.alignment(Qt.AlignmentFlag, default AlignCenter): Horizontal and vertical alignment. Keyword-only.
Examples
>>> from PySide6.QtGui import QPixmap
>>> pixmap = QPixmap(100, 40)
>>> painter_ = QPainter(pixmap)
>>> draw_degree_text(painter_, rect=QRectF(0, 0, 100, 40), text="3̂")
>>> painter_.end()
True
degree_tooltip
def degree_tooltip(text: str) -> str
Render caret examples as an inline image for Qt’s rich-text tooltip.
Parameters
text(str): The tooltip text. Text without combining carets is returned unchanged.
Returns
- str: Plain text or HTML containing the explicitly centered carets.
Examples
>>> degree_tooltip("Letters")
'Letters'
>>> "data:image/png;base64," in degree_tooltip("Caret (1̂ 2̂ 3̂)")
True
DegreeButton
class DegreeButton(QPushButton)
An answer button that draws scale-degree carets directly above the digits.
Examples
>>> DegreeButton("2̂").text()
'2̂'
DegreeButton.paintEvent
def paintEvent(event: QPaintEvent) -> None
Keep the native button appearance and position degree accents explicitly.
Parameters
event(QPaintEvent): The paint request.
Examples
>>> DegreeButton("2̂").grab().isNull()
False
DegreeCheckBox
class DegreeCheckBox(QCheckBox)
Draw the scale degree caret centered above the checkbox label’s digit.
DegreeCheckBox.paintEvent
def paintEvent(event: QPaintEvent) -> None
Paint the native checkbox and use the shared scale degree renderer for its label.
DegreeLabel
class DegreeLabel(QLabel)
A plain-text label with explicitly positioned scale-degree carets.
Examples
>>> DegreeLabel("Note to place: 2̂ / 4").text()
'Note to place: 2̂ / 4'
DegreeLabel.paintEvent
def paintEvent(event: QPaintEvent) -> None
Paint degree labels with carets centered above their numbers.
Parameters
event(QPaintEvent): The paint request.
Examples
>>> DegreeLabel("2̂").grab().isNull()
False