PySide6中基于TextObjectInterface渲染LaTeX无显示问题排查及适配Gemini API的Python版本推荐

Let's break down your problem into two actionable parts: resolving the missing LaTeX rendering in PySide6, and confirming the best Python version for both Gemini API and QTextObject functionality.

1. Fixing the Missing LaTeX in PySide6 #

Your code works flawlessly in PyQt6 but fails in PySide6 due to a subtle difference in how the two bindings handle custom QTextFormat properties. Using a raw integer (like 1) as the property key can lead to silent failures in PySide6—Qt explicitly recommends using values starting from Qt.UserRole to avoid conflicts with built-in properties.

Here's the corrected code with key fixes:

import sys
from io import BytesIO
from PySide6.QtWidgets import QApplication, QTextEdit
from PySide6.QtGui import ( QTextObjectInterface, QTextFormat, QTextCharFormat, QImage, QPainter, QColor )
from PySide6.QtCore import QSizeF, QObject, Qt
from matplotlib.figure import Figure
from matplotlib.backends.backend_agg import FigureCanvasAgg as FigureCanvas

LATEX_FORMAT = QTextFormat.UserObject + 1
# Use Qt's recommended role range to avoid property key conflicts
LATEX_PROPERTY = Qt.UserRole + 1

class LatexRenderer(QObject, QTextObjectInterface):
    def __init__(self):
        super().__init__()
        self._cache = {}

    def intrinsicSize(self, doc, posInDocument, format):
        latex = format.property(LATEX_PROPERTY)
        if not latex:
            return QSizeF(0,0)
        img = self.render_latex(latex)
        return QSizeF(img.width(), img.height())

    def drawObject(self, painter, rect, doc, posInDocument, format):
        latex = format.property(LATEX_PROPERTY)
        if not latex:
            return
        img = self.render_latex(latex)
        painter.fillRect(rect, QColor("#f0f0f0"))
        painter.drawImage(rect.topLeft(), img)

    def render_latex(self, latex):
        if latex in self._cache:
            return self._cache[latex]
        fig = Figure(figsize=(1, 1), dpi=100)
        canvas = FigureCanvas(fig)
        fig.patch.set_alpha(0)
        fig.text(0.5, 0.5, f"${latex}$", fontsize=20, ha='center', va='center', color="black")
        buf = BytesIO()
        fig.savefig(buf, format='png', bbox_inches='tight', pad_inches=0.1, transparent=True)
        img = QImage()
        img.loadFromData(buf.getvalue(), "PNG")
        self._cache[latex] = img
        return img

class MainWindow(QTextEdit):
    def __init__(self):
        super().__init__()
        self.renderer = LatexRenderer()
        self.document().documentLayout().registerHandler(LATEX_FORMAT, self.renderer)

        cursor = self.textCursor()
        cursor.insertText("The Pythagorean theorem is: ")
        self.insert_latex(cursor, r"a^2 + b^2 = c^2")
        cursor.insertText("\n\nAnd the Quadratic formula: ")
        self.insert_latex(cursor, r"x = \frac{-b \pm \sqrt{b^2 - 4ac}}{2a}")

    def insert_latex(self, cursor, latex):
        fmt = QTextCharFormat()
        fmt.setObjectType(LATEX_FORMAT)
        fmt.setProperty(LATEX_PROPERTY, latex)
        cursor.insertText("\uFFFC", fmt)

if __name__ == "__main__":
    app = QApplication(sys.argv)
    w = MainWindow()
    w.resize(600, 400)
    w.show()
    sys.exit(app.exec())

Key Changes: #

• Added LATEX_PROPERTY = Qt.UserRole + 1: Aligns with Qt's guidelines for custom properties, which fixes the property lookup failure in PySide6.
• Added null checks for latex in intrinsicSize and drawObject: Prevents silent crashes if the property isn't set correctly.

If issues persist, ensure you're using the latest PySide6 version (6.6.0 or newer) that supports Python 3.13. Install it with:

pip install PySide6 --only-binary=:all

2. Best Python Version for Gemini API + QTextObject #

Your choice of Python 3.13 is valid, but here's what to confirm for smooth compatibility:

• Gemini API: Google's official google-generativeai package supports Python 3.8 to 3.13, so 3.13 is fully compatible.
• PySide6: Versions 6.6.0 and above officially support Python 3.13. If you run into installation issues, use the --only-binary=:all flag as you did for PyQt6 to avoid building from source (which can trigger dependency conflicts).

Alternative Fallback: #

If you hit unforeseen edge bugs in Python 3.13 + PySide6, Python 3.12 is a rock-solid alternative—it's fully supported by both Gemini API and PySide6 (since version 6.5.0) and has a larger ecosystem of tested packages.

内容的提问来源于stack exchange，提问作者neutrino