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

Improve Documentation for QMatrix4x4

    XMLWordPrintable

Details

    • Task
    • Resolution: Unresolved
    • P2: Important
    • None
    • None
    • Documentation
    • None

    Description

      There have been a number of reports of confusion about how functions in QMatrix4x4 operate. QTBUG-18096 relates to the translate function which Multiplies this matrix by another that translates coordinates by the components of vector.

      Since matrix multiplication is sensitive to ordering it should at least state whether this is pre-multiplying or post-multiplying. It does in fact post-multiply, which is the opposite of what you normally do with QMatrix4x4 when applying a transform to a QVector3D.

      Also since the QTransform class inter-operates with this class, and has some similar functions, users might wrongly assume that the ordering would be similar when in fact it is the opposite. The class documentation for QTransform features diagrams and extensive explanation where the class documentation for this class is one line.

      Lastly there seems to be no specific examples that are linked to the documentation although the class is widely used. Snippets would be a great help in understanding how to use it.

      Attachments

        Issue Links

          No reviews matched the request. Check your Options in the drop-down menu of this sections header.

          Activity

            People

              docteam Qt Documentation Team
              sarasmit Sarah Smith (closed Nokia identity) (Inactive)
              Votes:
              7 Vote for this issue
              Watchers:
              9 Start watching this issue

              Dates

                Created:
                Updated:

                Time Tracking

                  Estimated:
                  Original Estimate - 1 week
                  1w
                  Remaining:
                  Remaining Estimate - 1 week
                  1w
                  Logged:
                  Time Spent - Not Specified
                  Not Specified

                  Gerrit Reviews

                    There are no open Gerrit changes