Uploaded image for project: 'Qt'
  1. Qt
  2. QTBUG-52640

Insufficient documentation of Qt::SvgMiterJoin

    XMLWordPrintable

Details

    • Bug
    • Resolution: Unresolved
    • P2: Important
    • None
    • 5.6.0
    • None

    Description

      The documentation of Qt::SvgMiterJoin is not on a par with the other types of line join. It is only mentioned in the Qt namespace page (http://doc.qt.io/qt-5/qt.html#PenJoinStyle-enum).

      What is lacking is:

      • a picture on the Qt namespace page.
      • mention and a picture on the QPen page (http://doc.qt.io/qt-5/qpen.html#join-style)
      • (Bug!) explanation of the different interpretation of miter limit on the QPen page (QPen page)
      • integration in the path stroking example.

      Qt::SvgMiterJoin is more important than the Name suggests because this is the type of miter join and miter limit which is implemented not only in SVG but also in PDF. So any painting which has PDF files and PDF-based print engines as major targets should be based on Qt::SvgMiterJoin rather than Qt::MiterJoin!

      (I don't know if any other paint engines have the same issue.)

      Attachments

        For Gerrit Dashboard: QTBUG-52640
        # Subject Branch Project Status CR V

        Activity

          People

            docteam Qt Documentation Team
            dg0yt Kai Pastor
            Votes:
            1 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:

              Gerrit Reviews

                There are no open Gerrit changes