Release note  
============  

Qt 6.1 introduces many new features and improvements as well as bugfixes  
over the 6.0.x series. For more details, refer to the online  
documentation included in this distribution. The documentation is also  
available online:  
  
https://doc.qt.io/qt-6/index.html  
  
The Qt version 6.1 series is binary compatible with the 6.0.x series.  
Applications compiled for 6.0 will continue to run with 6.1.  
  
Some of the changes listed in this file include issue tracking numbers  
corresponding to tasks in the Qt Bug Tracker:  
  
https://bugreports.qt.io/  
  
Each of these identifiers can be entered in the bug tracker to obtain  
more information about a particular change.  
  
To make it easier to port to Qt 6, we have created a porting guide to  
summarize those changes and provide guidance to handle them. In the  
guide, you can find links to articles about changes that may affect your  
application and help you transition from Qt 5.15 to Qt 6:  
  
https://doc.qt.io/qt-6/portingguide.html  
  
Important Changes  
-----------------  
  
### qtbase  
* 9a186e1da7 Fix license information for libjpeg-turbo  
Clarified that libjpeg-turbo is actually covered by three licenses, not  
only IJG.  
  
* 02a5580292 macOS: allow Qt::AA_DontShowShortcutsInContextMenus  
overrides  
The shortcutVisibleInContextMenu property defaults to the value of the  
Qt::AA_DontShowShortcutsInContextMenus attribute, which in turn defaults  
to the platform integration. To override the default, set the  
application attribute after instantiating QApplication, or override the  
default for each QAction instance.  
  
### qtwayland  
* c0ef4aa9 client: Gracefully handle shutdown and window hiding  
Fixed a crash that could happen when hiding or closing windows while Qt  
Quick was actively rendering on a different thread.  
  
### qt3d  
* eb0011ba1 Fix multi-view picking  
Non rendered entities (due to layer filtering) are no longer pickable  
  
### qtimageformats  
* f111501 Update bundled libtiff to version 4.3.0  
Bundled libtiff was updated to version 4.3.0  
  
### qtvirtualkeyboard  
* 6201217 Fix high CPU utilization caused by key repeat timer  
Fixed high CPU utilization caused by key repeat timer.  
  
* 062e4d0 Disable Windows IME when Qt Virtual Keyboard plugin is loaded  
Disable Windows IME when Qt Virtual Keyboard plugin is loaded  
  
### qtquick3d  
* 4a08fa54 Fix the occlusionMap to be compatible with GLTF2  
This patch changes how occlusionMap works in QQuick3DMaterial.  
Previously occlusionMap influences on all the diffuse colors and  
emissive colors. Now it will not affect punctual lightings.(For now it  
will affect only IBL.) The result of a lancelot test,  
principled/occlusion.qml, will be changed because it does not have  
IBL.(The occlusionMap will be ignored.) There will be 4 rows in the new  
test. Top 2 rows are without IBL, and others are with IBL in their  
materials.  
  
  
Fixes  
-----  
  
### qtbase  
* QTBUG-49771 Backspace key is not working when CapsLock is on  
* QTBUG-88651 Can't Hide Menu Separator  
* QTBUG-92488 When a QComboBox is set to use Fusion style after changing  
the size adjust policy to AdjustToContents then it will cut off the last  
item in a list and force it to be scrollable  
* QTBUG-93736 QCombobox last item become inaccessible when a listview is  
used in popup  
* QTBUG-92583 QListVIew page turning error  
* QTBUG-93504 Running automoc with --collect-json stalls during cmake  
build with Makefiles  
* QTBUG-94064 D3D11 debug layer warning is printed when having a vertex  
shader with no inputs  
* QTBUG-36565 Some key symbols generated by xkb level 3 shift don't work  
in QTextBrowser, QTextEdit, QLineEdit  
* QTBUG-94070 Memory corruption in sqlite plugin  
* QTBUG-93174 QtDeviceUtilities doc build doesn't produce .qch file  
* QTBUG-89754 Reg->6.0/Linux/CMake build : QtGui has dependency on  
libopengl0  
* QTBUG-93600 90° X rotation as quaternion produces NaN on euler angle  
* QTBUG-83089 NameFilters not working in FileDialog in Android 10  
* QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying  
* QTBUG-83089 NameFilters not working in FileDialog in Android 10  
* QTBUG-77771 A Double click on QtreeView/QTreeWidget index is emitting  
two clicked() and one doubleClicked() signal  
* QTBUG-92266 vertical space before video on  
https://doc.qt.io/qt-6/gettingstarted.html  
* QTBUG-94057 QLineEdit should be enter editing status when FocusIn  
* QTBUG-92234 QTranslator.load problem by skipping some  
* QTBUG-93431 Android: build system dependencies are wrong  
* QTBUG-86754 [Reg 5.12.4-> 5.12.5]Action text overlaps the shortcut in  
menu when padding is used  
* QTBUG-94269 QIntValidator: integer values exceeding top "intermediate"  
according to validate() func  
* QTBUG-93868 Fix unnoticed regression after merging the fix for UNC  
path handling  
* QTBUG-92232 [REG] Option Clicking Window Close Button Crashes App  
* QTBUG-64543 When starting a drag scroll via QScroller in a listview  
there will be a slight jump right before the scrolling starts  
* QTBUG-50866 QTabBar scroll buttons overlap tabs  
* QTBUG-70498 Cannot scroll first tab right, using scroll button in  
QTabBar, when tab size do not fit into visible rect.  
* QTBUG-91025 Should mention that QPrint Support is not available for  
iOS  
* QTBUG-94248 Check scrollbar ScrollBarOverlap when computing QListView  
margins  
* QTBUG-27640 QToolButton::menu-arrow{image:none;} does not work in  
Custom TitleBar  
* QTBUG-86362 [Reg 5.14 to 5.15.0] macOS: Tabbed QDockWidgets not  
properly drawing the tabs  
* QTBUG-93742 Error in public function "setclearbuttonenabled" of  
"QLineEdit" control  
* QTBUG-94211 Windows Long Path issue for RelWithDebInfo config  
* QTBUG-71894 Hangul composition bug  
* QTBUG-94264 When building for Android, instead of an apk, just .so is  
built  
* QTBUG-91120 QDate::fromString() fails on isolated dates on macOS with  
TZ=Europe/Lisbon  
* QTBUG-94400 /EHsc flag removal wrong  
* QTBUG-94347 QRandomGenerator64 refers to functions as static, aren't.  
* QTBUG-94470 Incorrect parsing of HTTP2 frame headers.  
* QTBUG-94032 Command line is too long when building large projects  
* QTBUG-76948 IOS: disconnect second screen while app in b/g, it crashes  
when app goes into foreground  
* QTBUG-93764 QPrintPreviewDialog: printer orientation not updated by  
QPageSetupDialog  
* QTBUG-94532 Markdown checkboxes are clipped when text range selected  
* QTBUG-62102 QKeySequenceEdit handles meta keys incorrectly on Wayland  
* QTBUG-93360 Compile Qt with gcc 11  
* QTBUG-94043 MSVC warning C4996: 'ID2D1Factory::GetDesktopDpi':  
Deprecated. Use DisplayInformation::LogicalDpi for Windows Store Apps or  
GetDpiForWindow for desktop apps.  
* QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying  
* QTBUG-91147 Correct wrong snippet paths reported by CI  
* QTBUG-94194 Qt 6.1/6.1.1 compilation fails after MSVC 2019 16.10  
update with "/std:c++latest" compiler flag  
* QTBUG-73990 Context Menu Items Fonts and Hotkeys Not Displaying  
* QTBUG-94264 When building for Android, instead of an apk, just .so is  
built  
* QTBUG-85714 QOpenGLWidget with NativeWindow QDockWidget does not  
render when undocked  
* QTBUG-87263 QMap<QVariant, QVariant> compilation error  
* QTBUG-60822 [REG: 4->5] WA_TranslucentBackground cannot be changed  
after widget has been shown  
* QTBUG-38776 QDockWidget titlebar icons are not drawn with high DPI  
* QTBUG-64543 When starting a drag scroll via QScroller in a listview  
there will be a slight jump right before the scrolling starts  
* QTBUG-88248 QObject orphaned connections soft-leak  
  
### qtdeclarative  
* QTBUG-94022 Visiting FolderListModel's Qt 6 documentation results in  
404  
* QTBUG-93880 MultiPointHandlers (DragHandler, PinchHandler) don't emit  
the grabChanged signal  
* QTBUG-91549 WheelHandler enables itself although deactivated  
* QTBUG-94067 Runtime error in qv4stackframe  
* QTBUG-79163 DragHandler steals events from a MouseArea with  
preventStealing = true  
* QTBUG-93489 Not obvious how to generate key events for QML when using  
QQuickRenderControl  
* QTBUG-94502 Crash on Android caused by automatic type conversion  
between JS array and QVariantList (SIGBUS)  
* QTBUG-90869 tst_qquickdesignersupport: tests segfault when running on  
QEMU and Windows MinGW developer build  
* QTBUG-33179 QML revisioning does not work for grouped properties  
  
### qttools  
* QTBUG-94345  Qt Designer crash in QQuickWidget plugin  
* QTBUG-74353 Qt Assistant doesn't take stylesheet into account with  
search result view  
* QTBUG-94510 Failed to generate docs during qt5.git#6.1  
* QTBUG-94555 qdoc: Broken links to \internal or \dontdocument nodes  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
### qttranslations  
* PYSIDE-1598 PySide6 QTranslator can not load qm files  
  
### qtdoc  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
### qtwayland  
* QTBUG-92249 quick3d examples crashes or hangs on exit on wayland  
  
### qtquickcontrols2  
* QTBUG-93039 Crash when scrolling ScrollView with zero-sized item  
* QTBUG-93994 QML ComboBox hide error  
* QTBUG-93958 Crash with ScrollView + TextArea + Item when the app is  
closing  
* QTBUG-55705 SwipeDelegate is not swiping inside SwipeView  
* QTBUG-77946 tst_QQuickDrawer::Universal::position(right) failed on  
Linux openSUSE_15_0 (gcc-x86_64)  
* QTBUG-94251 tst_QQuickPopup fails with OpenSUSE 15.3  
  
### qtcharts  
* QTBUG-94469 Doc: Wrong return type for QValueAxis::labelFormat qml  
property  
  
### qtdatavis3d  
* QTBUG-90665 RenderingMode changing does not work correctly  
* QTBUG-90371 The labels for the bars are not displayed when property  
"Rotate horizontally" set max to the right  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
### qtvirtualkeyboard  
* QTBUG-93997 Warnings with virtual keyboard in Qt 6  
* QTBUG-94259 High CPU load on embedded targets caused by timers  
* QTBUG-93042 Program crashed when type with keyboard  
* QTBUG-94560 The first item of selection list sometimes get highlight  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
### qtscxml  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
* QTBUG-94144 Incorrect Qt version numbers on Qt 6.1.1 source code  
package  
  
### qtnetworkauth  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
### qtquicktimeline  
* QDS-4403 Errors with imported 3D component, DS built with Qt 6.1  
  
### qtquick3d  
* QTBUG-94185 Misplaced Joint{} element may crash application  
* QTBUG-94230 Node method map***() causes crash if node if null  
* QTBUG-94263 Balsam seems to interpret a sphere parented under leaf  
joint as joint  
* QDS-4399 Properties missing for some components  
* QDS-4477 Imported Qt3DStudio project looks different in DS built with  
Qt6.1 compared to QDS 2.1  
* QTBUG-94453 Rectangles can't be used for light probs in View3D  
* QTBUG-94453 Rectangles can't be used for light probs in View3D  
  
### qt5compat  
* QTBUG-86726 qt_add_resource BASE argument doesn't behave as the qmake  
counterpart  
  
Known Issues  
------------  

* Check that your system meets Qt's requirements:  
https://doc.qt.io/qt-6/gettingstarted.html#platform-requirements  
* RTA reported issues from Qt 6.1  
https://qt-project.atlassian.net/issues/?filter=15397  
* Supported development platforms are listed here:  
https://bugreports.qt.io/browse/QTBUG-86432  
  
### Linux
* Minimum glibc version for prebuild binaries is still 2.28, see  
https://bugreports.qt.io/browse/QTBUG-88833.  
Workaround: compile Qt 6.1.2 by yourself or update glibc to 2.28 or newer  
  
### Windows
* Wrong rendering in Dialog with native Windows style  
https://bugreports.qt.io/browse/QTBUG-91755  
  
### Android
* Old openssl version used on Linux hosts  
https://bugreports.qt.io/browse/QTBUG-94355  
https://bugreports.qt.io/browse/QTQAINFRA-4501  
  
Credits for the  release goes to:  
---------------------------------  
  
Aavitsland Eirik  
Agocs Laszlo  
Astals Cid Albert  
Bennett Nicholas  
Blomfeldt Eskil Abrahamsen  
Bornemann Joerg  
Boudjelthia Assam  
Buddenhagen Oswald  
Butirsky Andrey  
Croitor Alexandru  
Curtis Mitch  
D'Angelo Giuseppe  
Edelev Alexey  
Faure David  
Ferrer Josep Ma.  
Gustavsen Richard Moe  
Haixiang Tang  
Halmet Heikki  
Hao Zhang  
Hartmann Thomas  
Heikkinen Jani  
Heikkinen Miikka  
Heimrich Karsten  
Hermann Ulf  
Hilsheimer Volker  
Jensen Allan Sandfeld  
Jokiniva Jukka  
Kleint Friedemann  
Knoll Lars  
Kobus Jarek  
Koehne Kai  
Koivikko Jarkko  
Kosmale Fabian  
Krus Mike  
Kushnir Igor  
Köhne Kai  
Lee Inho  
Leinonen Tony  
Lemire Paul  
Liu Haoyu  
Löhning Robert  
Nikiforov Aleksei  
Nordheim Mårten  
Ollila Kimmo  
Pocheptsov Timur  
Reinio Topi  
RuiJie Fan  
Rutledge Shawn  
Shaw Andy  
Strømme Christian  
Suzuki Tasuku  
Varanka Sami  
Vertriest Nico  
Vestbø Tor Arne  
Vuolle Juha  
Welbourne Edward  
Wicking Paul  
Wolff Oliver  
Xinwei Li  
Zhang JiDe  
