From 10323c33f7f51afe890abf70869621e293b7d0a9 Mon Sep 17 00:00:00 2001 From: Patrick Franz Date: Sun, 9 Feb 2025 22:21:12 +0100 Subject: [PATCH 1/1] Import qt6-multimedia_6.8.2.orig.tar.xz [dgit import orig qt6-multimedia_6.8.2.orig.tar.xz] --- .QT-ENTERPRISE-LICENSE-AGREEMENT | 262 + .cmake.conf | 5 + .tag | 1 + CMakeLists.txt | 75 + LICENSES/Apache-2.0.txt | 61 + LICENSES/BSD-3-Clause.txt | 9 + LICENSES/GFDL-1.3-no-invariants-only.txt | 451 + LICENSES/GPL-2.0-only.txt | 339 + LICENSES/GPL-3.0-only.txt | 674 + LICENSES/LGPL-3.0-only.txt | 165 + LICENSES/LicenseRef-Qt-Commercial.txt | 8 + LICENSES/MPL-2.0.txt | 373 + LICENSES/Qt-GPL-exception-1.0.txt | 22 + REUSE.toml | 51 + cmake/FindAVFoundation.cmake | 14 + cmake/FindFFmpeg.cmake | 393 + cmake/FindGObject.cmake | 58 + cmake/FindGStreamer.cmake | 258 + cmake/FindMMRenderer.cmake | 29 + cmake/FindMMRendererCore.cmake | 12 + cmake/FindPipeWire.cmake | 123 + cmake/FindVAAPI.cmake | 92 + cmake/FindWMF.cmake | 52 + cmake/FindWrapPulseAudio.cmake | 37 + cmake/REUSE.toml | 7 + coin/axivion/ci_config_linux.json | 45 + .../run_ffmpeg_backend_tests.yaml | 33 + .../run_gstreamer_backend_tests.yaml | 27 + coin/module_config.yaml | 14 + config.tests/evr/CMakeLists.txt | 33 + config.tests/evr/main.cpp | 9 + config.tests/gpu_vivante/CMakeLists.txt | 33 + config.tests/gpu_vivante/main.cpp | 12 + config.tests/linux_v4l/CMakeLists.txt | 33 + config.tests/linux_v4l/main.cpp | 9 + config.tests/wmsdk/CMakeLists.txt | 33 + config.tests/wmsdk/main.cpp | 9 + config_help.txt | 8 + configure.cmake | 24 + dependencies.yaml | 13 + dist/REUSE.toml | 8 + dist/changes-5.0.1 | 76 + dist/changes-5.0.2 | 48 + dist/changes-5.1.0 | 38 + dist/changes-5.1.1 | 45 + dist/changes-5.10.0 | 41 + dist/changes-5.10.1 | 72 + dist/changes-5.11.0 | 75 + dist/changes-5.11.1 | 73 + dist/changes-5.11.2 | 61 + dist/changes-5.11.3 | 58 + dist/changes-5.12.0 | 59 + dist/changes-5.12.1 | 68 + dist/changes-5.12.2 | 45 + dist/changes-5.12.3 | 40 + dist/changes-5.12.4 | 57 + dist/changes-5.12.5 | 35 + dist/changes-5.13.0 | 64 + dist/changes-5.13.1 | 46 + dist/changes-5.13.2 | 68 + dist/changes-5.14.0 | 54 + dist/changes-5.14.1 | 25 + dist/changes-5.14.2 | 45 + dist/changes-5.15.0 | 57 + dist/changes-5.15.1 | 45 + dist/changes-5.15.2 | 29 + dist/changes-5.2.0 | 86 + dist/changes-5.2.1 | 35 + dist/changes-5.3.1 | 61 + dist/changes-5.3.2 | 65 + dist/changes-5.4.0 | 111 + dist/changes-5.4.1 | 49 + dist/changes-5.4.2 | 64 + dist/changes-5.5.0 | 118 + dist/changes-5.5.1 | 68 + dist/changes-5.6.0 | 138 + dist/changes-5.6.1 | 64 + dist/changes-5.6.2 | 90 + dist/changes-5.6.3 | 66 + dist/changes-5.7.0 | 67 + dist/changes-5.7.1 | 34 + dist/changes-5.8.0 | 70 + dist/changes-5.9.0 | 74 + dist/changes-5.9.1 | 43 + dist/changes-5.9.2 | 42 + dist/changes-5.9.3 | 58 + dist/changes-5.9.4 | 57 + dist/changes-5.9.5 | 45 + dist/changes-5.9.6 | 34 + examples/CMakeLists.txt | 11 + examples/examples.pro | 3 + examples/multimedia/CMakeLists.txt | 20 + .../multimedia/audiodevices/CMakeLists.txt | 43 + .../multimedia/audiodevices/Info.plist.in | 47 + .../multimedia/audiodevices/audiodevices.cpp | 209 + .../multimedia/audiodevices/audiodevices.h | 46 + .../multimedia/audiodevices/audiodevices.pro | 17 + .../audiodevices/audiodevicesbase.ui | 311 + .../audiodevices/doc/images/audiodevices.png | Bin 0 -> 37896 bytes .../audiodevices/doc/src/audiodevices.qdoc | 20 + examples/multimedia/audiodevices/main.cpp | 17 + .../multimedia/audiooutput/CMakeLists.txt | 40 + .../multimedia/audiooutput/audiooutput.cpp | 239 + examples/multimedia/audiooutput/audiooutput.h | 81 + .../multimedia/audiooutput/audiooutput.pro | 12 + .../doc/images/audiooutput-example.png | Bin 0 -> 9249 bytes .../audiooutput/doc/src/audiooutput.qdoc | 22 + examples/multimedia/audiooutput/main.cpp | 17 + .../multimedia/audiorecorder/CMakeLists.txt | 43 + .../multimedia/audiorecorder/Info.plist.in | 44 + .../multimedia/audiorecorder/audiolevel.cpp | 33 + .../multimedia/audiorecorder/audiolevel.h | 25 + .../audiorecorder/audiorecorder.cpp | 329 + .../multimedia/audiorecorder/audiorecorder.h | 60 + .../audiorecorder/audiorecorder.pro | 24 + .../multimedia/audiorecorder/audiorecorder.ui | 270 + .../doc/images/audiorecorder.png | Bin 0 -> 28212 bytes .../audiorecorder/doc/src/audiorecorder.qdoc | 84 + examples/multimedia/audiorecorder/main.cpp | 16 + .../multimedia/audiosource/CMakeLists.txt | 41 + examples/multimedia/audiosource/Info.plist.in | 44 + .../multimedia/audiosource/audiosource.cpp | 257 + examples/multimedia/audiosource/audiosource.h | 95 + .../multimedia/audiosource/audiosource.pro | 13 + .../doc/images/audiosource-example.png | Bin 0 -> 10383 bytes .../audiosource/doc/src/audiosource.qdoc | 24 + examples/multimedia/audiosource/main.cpp | 17 + examples/multimedia/camera/CMakeLists.txt | 83 + .../camera/android/AndroidManifest.xml | 39 + examples/multimedia/camera/camera.cpp | 421 + examples/multimedia/camera/camera.h | 104 + examples/multimedia/camera/camera.pro | 40 + examples/multimedia/camera/camera.qrc | 5 + examples/multimedia/camera/camera.ui | 488 + examples/multimedia/camera/camera_mobile.ui | 504 + .../camera/doc/images/camera-example.png | Bin 0 -> 151290 bytes .../multimedia/camera/doc/src/camera.qdoc | 92 + examples/multimedia/camera/images/shutter.svg | 21 + examples/multimedia/camera/imagesettings.cpp | 84 + examples/multimedia/camera/imagesettings.h | 41 + examples/multimedia/camera/imagesettings.ui | 123 + examples/multimedia/camera/ios/Info.plist.in | 50 + .../multimedia/camera/macos/Info.plist.in | 49 + examples/multimedia/camera/main.cpp | 20 + examples/multimedia/camera/metadatadialog.cpp | 107 + examples/multimedia/camera/metadatadialog.h | 31 + examples/multimedia/camera/videosettings.cpp | 196 + examples/multimedia/camera/videosettings.h | 42 + examples/multimedia/camera/videosettings.ui | 213 + .../multimedia/camera/videosettings_mobile.ui | 207 + .../declarative-camera/CMakeLists.txt | 77 + .../declarative-camera/CameraButton.qml | 41 + .../declarative-camera/CameraListButton.qml | 74 + .../declarative-camera/CameraListPopup.qml | 66 + .../CameraPropertyButton.qml | 72 + .../CameraPropertyPopup.qml | 81 + .../declarative-camera/FlashControl.qml | 65 + .../multimedia/declarative-camera/Info.plist | 43 + .../declarative-camera/Info.plist.in | 46 + .../PhotoCaptureControls.qml | 231 + .../declarative-camera/PhotoPreview.qml | 24 + .../multimedia/declarative-camera/Popup.qml | 39 + .../VideoCaptureControls.qml | 213 + .../declarative-camera/VideoPreview.qml | 42 + .../declarative-camera/ZoomControl.qml | 80 + .../declarative-camera/declarative-camera.pro | 12 + .../declarative-camera/declarative-camera.qml | 147 + .../declarative-camera.qmlproject | 18 + .../declarative-camera/declarative-camera.qrc | 29 + .../doc/images/CaptureControls.png | Bin 0 -> 41278 bytes .../doc/images/FlashControls.png | Bin 0 -> 69725 bytes .../doc/images/VideoCaptureControls.png | Bin 0 -> 35913 bytes .../doc/images/ZoomControl.png | Bin 0 -> 28291 bytes .../doc/images/qml-camera.png | Bin 0 -> 51620 bytes .../doc/images/qml-declarative-portrait.png | Bin 0 -> 49057 bytes .../doc/src/declarative-camera.qdoc | 158 + .../images/camera_auto_mode.png | Bin 0 -> 778 bytes .../images/camera_camera_setting.png | Bin 0 -> 717 bytes .../images/camera_flash_auto.png | Bin 0 -> 1119 bytes .../images/camera_flash_fill.png | Bin 0 -> 610 bytes .../images/camera_flash_off.png | Bin 0 -> 717 bytes .../images/camera_flash_redeye.png | Bin 0 -> 945 bytes .../images/camera_white_balance_cloudy.png | Bin 0 -> 625 bytes .../camera_white_balance_flourescent.png | Bin 0 -> 554 bytes .../camera_white_balance_incandescent.png | Bin 0 -> 600 bytes .../images/camera_white_balance_sunny.png | Bin 0 -> 587 bytes .../declarative-camera/images/toolbutton.png | Bin 0 -> 2550 bytes .../declarative-camera/images/toolbutton.sci | 5 + .../declarative-camera/permission-denied.qml | 20 + .../declarative-camera/qmlcamera.cpp | 39 + examples/multimedia/multimedia.pro | 21 + examples/multimedia/player/CMakeLists.txt | 44 + .../player/doc/images/mediaplayerex.jpg | Bin 0 -> 28825 bytes .../multimedia/player/doc/src/player.qdoc | 49 + examples/multimedia/player/main.cpp | 37 + examples/multimedia/player/player.cpp | 555 + examples/multimedia/player/player.h | 105 + examples/multimedia/player/player.pro | 28 + examples/multimedia/player/playercontrols.cpp | 185 + examples/multimedia/player/playercontrols.h | 64 + examples/multimedia/player/playlistmodel.cpp | 105 + examples/multimedia/player/playlistmodel.h | 50 + examples/multimedia/player/qmediaplaylist.cpp | 643 + examples/multimedia/player/qmediaplaylist.h | 90 + .../multimedia/player/qmediaplaylist_p.cpp | 65 + examples/multimedia/player/qmediaplaylist_p.h | 66 + .../multimedia/player/qplaylistfileparser.cpp | 621 + .../multimedia/player/qplaylistfileparser.h | 76 + examples/multimedia/player/videowidget.cpp | 46 + examples/multimedia/player/videowidget.h | 22 + .../multimedia/screencapture/CMakeLists.txt | 61 + .../multimedia/screencapture/Info.plist.in | 41 + .../screencapture/android/AndroidManifest.xml | 53 + .../doc/images/screencapture.jpg | Bin 0 -> 42725 bytes .../screencapture/doc/src/screencapture.qdoc | 48 + examples/multimedia/screencapture/main.cpp | 14 + .../screencapture/screencapture.pro | 18 + .../screencapture/screencapturepreview.cpp | 179 + .../screencapture/screencapturepreview.h | 67 + .../screencapture/screenlistmodel.cpp | 54 + .../screencapture/screenlistmodel.h | 30 + .../screencapture/windowlistmodel.cpp | 42 + .../screencapture/windowlistmodel.h | 31 + examples/multimedia/shared/shared.pri | 92 + examples/multimedia/video/CMakeLists.txt | 10 + .../video/mediaplayer/CMakeLists.txt | 71 + .../multimedia/video/mediaplayer/Main.qml | 178 + .../mediaplayer/controls/AudioControl.qml | 50 + .../mediaplayer/controls/MetadataInfo.qml | 30 + .../mediaplayer/controls/PlaybackControl.qml | 317 + .../controls/PlaybackSeekControl.qml | 56 + .../mediaplayer/controls/SettingsPopup.qml | 204 + .../video/mediaplayer/controls/TracksInfo.qml | 25 + .../video/mediaplayer/controls/UrlPopup.qml | 54 + ...dia-examples-qml-media-player-settings.png | Bin 0 -> 33956 bytes ...qtmultimedia-examples-qml-media-player.png | Bin 0 -> 49506 bytes .../mediaplayer/doc/src/mediaplayer.qdoc | 151 + .../video/mediaplayer/images/backward10.svg | 5 + .../video/mediaplayer/images/ff.svg | 4 + .../video/mediaplayer/images/forward10.svg | 5 + .../video/mediaplayer/images/link.svg | 3 + .../video/mediaplayer/images/loop.svg | 3 + .../video/mediaplayer/images/more.svg | 5 + .../video/mediaplayer/images/mute.svg | 6 + .../video/mediaplayer/images/open_new.svg | 6 + .../video/mediaplayer/images/pause_symbol.svg | 4 + .../video/mediaplayer/images/play_symbol.svg | 3 + .../video/mediaplayer/images/rewind.svg | 4 + .../video/mediaplayer/images/settings.svg | 4 + .../video/mediaplayer/images/speaker.svg | 7 + .../video/mediaplayer/images/stop_symbol.svg | 3 + .../video/mediaplayer/images/url.svg | 6 + .../video/mediaplayer/images/volume.svg | 4 + .../video/mediaplayer/images/volume_mute.svg | 4 + .../mediaplayer/images/zoom_maximize.svg | 4 + .../mediaplayer/images/zoom_minimize.svg | 4 + .../multimedia/video/mediaplayer/main.cpp | 38 + .../multimedia/video/qmlvideo/CMakeLists.txt | 71 + .../multimedia/video/qmlvideo/Info.plist.in | 48 + .../qmlvideo/doc/images/qmlvideo-menu.jpg | Bin 0 -> 21959 bytes .../qmlvideo/doc/images/qmlvideo-overlay.jpg | Bin 0 -> 23787 bytes .../video/qmlvideo/doc/src/qmlvideo.qdoc | 115 + .../video/qmlvideo/frequencymonitor.cpp | 216 + .../video/qmlvideo/frequencymonitor.h | 67 + .../qmlvideo/frequencymonitor/CMakeLists.txt | 30 + .../frequencymonitor/FrequencyItem.qml | 67 + .../video/qmlvideo/frequencymonitor/qmldir | 3 + .../qmlvideo/frequencymonitordeclarative.cpp | 10 + examples/multimedia/video/qmlvideo/main.cpp | 125 + .../video/qmlvideo/performancemonitor.cpp | 31 + .../video/qmlvideo/performancemonitor.h | 33 + .../performancemonitor/CMakeLists.txt | 31 + .../performancemonitor/PerformanceItem.qml | 100 + .../video/qmlvideo/performancemonitor/qmldir | 3 + .../performancemonitordeclarative.cpp | 12 + .../qmlvideo/performancemonitordeclarative.h | 11 + .../multimedia/video/qmlvideo/qmlvideo.png | Bin 0 -> 3400 bytes .../multimedia/video/qmlvideo/qmlvideo.pro | 99 + .../multimedia/video/qmlvideo/qmlvideo.svg | 93 + .../video/qmlvideo/qmlvideo/CMakeLists.txt | 81 + .../video/qmlvideo/qmlvideo/CameraBasic.qml | 7 + .../video/qmlvideo/qmlvideo/CameraDrag.qml | 6 + .../video/qmlvideo/qmlvideo/CameraDummy.qml | 31 + .../qmlvideo/qmlvideo/CameraFullScreen.qml | 7 + .../qmlvideo/CameraFullScreenInverted.qml | 7 + .../video/qmlvideo/qmlvideo/CameraItem.qml | 47 + .../video/qmlvideo/qmlvideo/CameraMove.qml | 6 + .../video/qmlvideo/qmlvideo/CameraOverlay.qml | 6 + .../video/qmlvideo/qmlvideo/CameraResize.qml | 6 + .../video/qmlvideo/qmlvideo/CameraRotate.qml | 6 + .../video/qmlvideo/qmlvideo/CameraSpin.qml | 6 + .../video/qmlvideo/qmlvideo/Content.qml | 125 + .../video/qmlvideo/qmlvideo/ErrorDialog.qml | 70 + .../video/qmlvideo/qmlvideo/Main.qml | 188 + .../video/qmlvideo/qmlvideo/Scene.qml | 31 + .../video/qmlvideo/qmlvideo/SceneBasic.qml | 47 + .../video/qmlvideo/qmlvideo/SceneDrag.qml | 34 + .../qmlvideo/qmlvideo/SceneFullScreen.qml | 67 + .../qmlvideo/SceneFullScreenInverted.qml | 70 + .../video/qmlvideo/qmlvideo/SceneMove.qml | 49 + .../video/qmlvideo/qmlvideo/SceneMulti.qml | 186 + .../video/qmlvideo/qmlvideo/SceneOverlay.qml | 83 + .../video/qmlvideo/qmlvideo/SceneResize.qml | 41 + .../video/qmlvideo/qmlvideo/SceneRotate.qml | 57 + .../qmlvideo/qmlvideo/SceneSelectionPanel.qml | 88 + .../video/qmlvideo/qmlvideo/SceneSpin.qml | 34 + .../video/qmlvideo/qmlvideo/SeekControl.qml | 105 + .../video/qmlvideo/qmlvideo/VideoBasic.qml | 6 + .../video/qmlvideo/qmlvideo/VideoDrag.qml | 6 + .../video/qmlvideo/qmlvideo/VideoDummy.qml | 37 + .../video/qmlvideo/qmlvideo/VideoFillMode.qml | 49 + .../qmlvideo/qmlvideo/VideoFullScreen.qml | 7 + .../qmlvideo/VideoFullScreenInverted.qml | 7 + .../video/qmlvideo/qmlvideo/VideoItem.qml | 42 + .../video/qmlvideo/qmlvideo/VideoMetadata.qml | 80 + .../video/qmlvideo/qmlvideo/VideoMove.qml | 6 + .../video/qmlvideo/qmlvideo/VideoOverlay.qml | 6 + .../qmlvideo/qmlvideo/VideoPlaybackRate.qml | 65 + .../video/qmlvideo/qmlvideo/VideoResize.qml | 6 + .../video/qmlvideo/qmlvideo/VideoRotate.qml | 6 + .../video/qmlvideo/qmlvideo/VideoSeek.qml | 36 + .../video/qmlvideo/qmlvideo/VideoSpin.qml | 6 + .../video/qmlvideo/qmlvideo/images/folder.png | Bin 0 -> 1829 bytes .../video/qmlvideo/qmlvideo/images/leaves.jpg | Bin 0 -> 257378 bytes .../video/qmlvideo/qmlvideo/images/up.png | Bin 0 -> 1268 bytes .../multimedia/video/qmlvideo/qmlvideo/qmldir | 44 + .../video/qmlvideo/qmlvideo/qmlvideo_global.h | 10 + .../qmlvideo/qmlvideo/videosingleton.cpp | 54 + .../video/qmlvideo/qmlvideo/videosingleton.h | 48 + examples/multimedia/video/qmlvideo/trace.h | 81 + .../video/recorder/AudioInputSelect.qml | 53 + .../multimedia/video/recorder/CMakeLists.txt | 65 + .../multimedia/video/recorder/Controls.qml | 83 + .../multimedia/video/recorder/Info.plist.in | 46 + .../multimedia/video/recorder/MediaList.qml | 67 + .../multimedia/video/recorder/Playback.qml | 55 + .../video/recorder/RecordButton.qml | 45 + .../video/recorder/SettingsEncoder.qml | 102 + .../video/recorder/SettingsMetaData.qml | 145 + examples/multimedia/video/recorder/Style.qml | 31 + .../video/recorder/StyleParameter.qml | 42 + .../video/recorder/StyleRectangle.qml | 11 + .../multimedia/video/recorder/StyleSlider.qml | 35 + .../video/recorder/VideoSourceSelect.qml | 165 + .../recorder/android/AndroidManifest.xml | 53 + .../qml-recorder-control-bar-overview.gif | Bin 0 -> 111693 bytes .../doc/images/qml-recorder-overview.gif | Bin 0 -> 138905 bytes .../video/recorder/doc/images/qmlrecorder.jpg | Bin 0 -> 95965 bytes .../video/recorder/doc/src/recorder.qdoc | 102 + examples/multimedia/video/recorder/main.cpp | 51 + examples/multimedia/video/recorder/main.qml | 144 + .../video/recorder/main_no_permissions.qml | 26 + examples/multimedia/video/recorder/qmldir | 2 + examples/multimedia/video/video.pro | 3 + .../videographicsitem/CMakeLists.txt | 41 + .../doc/images/video-videographicsitem.png | Bin 0 -> 54436 bytes .../doc/src/videographicsitem.qdoc | 20 + .../multimedia/videographicsitem/main.cpp | 37 + .../videographicsitem/videographicsitem.pro | 14 + .../videographicsitem/videoplayer.cpp | 148 + .../videographicsitem/videoplayer.h | 47 + .../multimedia/videowidget/CMakeLists.txt | 41 + .../doc/images/video-videowidget.png | Bin 0 -> 54199 bytes .../videowidget/doc/src/videowidget.qdoc | 18 + examples/multimedia/videowidget/main.cpp | 40 + .../multimedia/videowidget/videoplayer.cpp | 137 + examples/multimedia/videowidget/videoplayer.h | 44 + .../multimedia/videowidget/videowidget.pro | 16 + examples/spatialaudio/CMakeLists.txt | 4 + .../spatialaudio/audiopanning/CMakeLists.txt | 38 + .../audiopanning/audiopanning.pro | 9 + .../doc/images/audiopanning-example.png | Bin 0 -> 171760 bytes .../audiopanning/doc/src/audiopanning.qdoc | 28 + examples/spatialaudio/audiopanning/main.cpp | 241 + examples/spatialaudio/spatialaudio.pro | 3 + licenseRule.json | 114 + qt_cmdline.cmake | 4 + src/3rdparty/eigen/COPYING.BSD | 24 + src/3rdparty/eigen/COPYING.MPL2 | 373 + src/3rdparty/eigen/COPYING.README | 18 + src/3rdparty/eigen/COPYRIGHTS | 45 + src/3rdparty/eigen/Eigen/Cholesky | 45 + src/3rdparty/eigen/Eigen/Core | 384 + src/3rdparty/eigen/Eigen/Dense | 7 + src/3rdparty/eigen/Eigen/Eigenvalues | 60 + src/3rdparty/eigen/Eigen/Geometry | 59 + src/3rdparty/eigen/Eigen/Householder | 29 + src/3rdparty/eigen/Eigen/Jacobi | 32 + src/3rdparty/eigen/Eigen/LU | 47 + src/3rdparty/eigen/Eigen/QR | 50 + src/3rdparty/eigen/Eigen/SVD | 50 + src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h | 688 + src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h | 558 + .../eigen/Eigen/src/Cholesky/LLT_LAPACKE.h | 99 + .../eigen/Eigen/src/Core/ArithmeticSequence.h | 413 + src/3rdparty/eigen/Eigen/src/Core/Array.h | 417 + src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h | 226 + .../eigen/Eigen/src/Core/ArrayWrapper.h | 209 + src/3rdparty/eigen/Eigen/src/Core/Assign.h | 90 + .../eigen/Eigen/src/Core/AssignEvaluator.h | 1010 + .../eigen/Eigen/src/Core/Assign_MKL.h | 178 + .../eigen/Eigen/src/Core/BandMatrix.h | 353 + src/3rdparty/eigen/Eigen/src/Core/Block.h | 448 + .../eigen/Eigen/src/Core/BooleanRedux.h | 162 + .../eigen/Eigen/src/Core/CommaInitializer.h | 164 + .../eigen/Eigen/src/Core/ConditionEstimator.h | 175 + .../eigen/Eigen/src/Core/CoreEvaluators.h | 1741 ++ .../eigen/Eigen/src/Core/CoreIterators.h | 132 + .../eigen/Eigen/src/Core/CwiseBinaryOp.h | 183 + .../eigen/Eigen/src/Core/CwiseNullaryOp.h | 1001 + .../eigen/Eigen/src/Core/CwiseTernaryOp.h | 197 + .../eigen/Eigen/src/Core/CwiseUnaryOp.h | 103 + .../eigen/Eigen/src/Core/CwiseUnaryView.h | 132 + src/3rdparty/eigen/Eigen/src/Core/DenseBase.h | 701 + .../eigen/Eigen/src/Core/DenseCoeffsBase.h | 685 + .../eigen/Eigen/src/Core/DenseStorage.h | 652 + src/3rdparty/eigen/Eigen/src/Core/Diagonal.h | 258 + .../eigen/Eigen/src/Core/DiagonalMatrix.h | 391 + .../eigen/Eigen/src/Core/DiagonalProduct.h | 28 + src/3rdparty/eigen/Eigen/src/Core/Dot.h | 318 + src/3rdparty/eigen/Eigen/src/Core/EigenBase.h | 160 + .../eigen/Eigen/src/Core/ForceAlignedAccess.h | 150 + src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h | 155 + .../eigen/Eigen/src/Core/GeneralProduct.h | 465 + .../eigen/Eigen/src/Core/GenericPacketMath.h | 1040 + .../eigen/Eigen/src/Core/GlobalFunctions.h | 194 + src/3rdparty/eigen/Eigen/src/Core/IO.h | 258 + .../eigen/Eigen/src/Core/IndexedView.h | 237 + src/3rdparty/eigen/Eigen/src/Core/Inverse.h | 117 + src/3rdparty/eigen/Eigen/src/Core/Map.h | 171 + src/3rdparty/eigen/Eigen/src/Core/MapBase.h | 310 + .../eigen/Eigen/src/Core/MathFunctions.h | 2057 ++ .../eigen/Eigen/src/Core/MathFunctionsImpl.h | 200 + src/3rdparty/eigen/Eigen/src/Core/Matrix.h | 565 + .../eigen/Eigen/src/Core/MatrixBase.h | 547 + .../eigen/Eigen/src/Core/NestByValue.h | 85 + src/3rdparty/eigen/Eigen/src/Core/NoAlias.h | 109 + src/3rdparty/eigen/Eigen/src/Core/NumTraits.h | 335 + .../Eigen/src/Core/PartialReduxEvaluator.h | 232 + .../eigen/Eigen/src/Core/PermutationMatrix.h | 605 + .../eigen/Eigen/src/Core/PlainObjectBase.h | 1128 ++ src/3rdparty/eigen/Eigen/src/Core/Product.h | 191 + .../eigen/Eigen/src/Core/ProductEvaluators.h | 1179 ++ src/3rdparty/eigen/Eigen/src/Core/Random.h | 218 + src/3rdparty/eigen/Eigen/src/Core/Redux.h | 515 + src/3rdparty/eigen/Eigen/src/Core/Ref.h | 381 + src/3rdparty/eigen/Eigen/src/Core/Replicate.h | 142 + src/3rdparty/eigen/Eigen/src/Core/Reshaped.h | 454 + .../eigen/Eigen/src/Core/ReturnByValue.h | 119 + src/3rdparty/eigen/Eigen/src/Core/Reverse.h | 217 + src/3rdparty/eigen/Eigen/src/Core/Select.h | 164 + .../eigen/Eigen/src/Core/SelfAdjointView.h | 365 + .../eigen/Eigen/src/Core/SelfCwiseBinaryOp.h | 47 + src/3rdparty/eigen/Eigen/src/Core/Solve.h | 188 + .../eigen/Eigen/src/Core/SolveTriangular.h | 235 + .../eigen/Eigen/src/Core/SolverBase.h | 168 + .../eigen/Eigen/src/Core/StableNorm.h | 251 + .../eigen/Eigen/src/Core/StlIterators.h | 463 + src/3rdparty/eigen/Eigen/src/Core/Stride.h | 116 + src/3rdparty/eigen/Eigen/src/Core/Swap.h | 68 + src/3rdparty/eigen/Eigen/src/Core/Transpose.h | 464 + .../eigen/Eigen/src/Core/Transpositions.h | 386 + .../eigen/Eigen/src/Core/TriangularMatrix.h | 1001 + .../eigen/Eigen/src/Core/VectorBlock.h | 96 + .../eigen/Eigen/src/Core/VectorwiseOp.h | 784 + src/3rdparty/eigen/Eigen/src/Core/Visitor.h | 381 + .../eigen/Eigen/src/Core/arch/AVX/Complex.h | 372 + .../Eigen/src/Core/arch/AVX/MathFunctions.h | 228 + .../Eigen/src/Core/arch/AVX/PacketMath.h | 1574 ++ .../Eigen/src/Core/arch/AVX/TypeCasting.h | 115 + .../Eigen/src/Core/arch/AVX512/Complex.h | 422 + .../src/Core/arch/AVX512/MathFunctions.h | 362 + .../Eigen/src/Core/arch/AVX512/PacketMath.h | 2303 +++ .../Eigen/src/Core/arch/AVX512/TypeCasting.h | 89 + .../Eigen/src/Core/arch/AltiVec/Complex.h | 417 + .../src/Core/arch/AltiVec/MathFunctions.h | 90 + .../src/Core/arch/AltiVec/MatrixProduct.h | 2937 +++ .../Core/arch/AltiVec/MatrixProductCommon.h | 221 + .../src/Core/arch/AltiVec/MatrixProductMMA.h | 629 + .../Eigen/src/Core/arch/AltiVec/PacketMath.h | 2711 +++ .../eigen/Eigen/src/Core/arch/CUDA/Complex.h | 258 + .../Eigen/src/Core/arch/Default/BFloat16.h | 700 + .../Eigen/src/Core/arch/Default/ConjHelper.h | 117 + .../arch/Default/GenericPacketMathFunctions.h | 1649 ++ .../Default/GenericPacketMathFunctionsFwd.h | 110 + .../eigen/Eigen/src/Core/arch/Default/Half.h | 942 + .../Eigen/src/Core/arch/Default/Settings.h | 49 + .../Eigen/src/Core/arch/Default/TypeCasting.h | 120 + .../Eigen/src/Core/arch/GPU/MathFunctions.h | 103 + .../Eigen/src/Core/arch/GPU/PacketMath.h | 1685 ++ .../Eigen/src/Core/arch/GPU/TypeCasting.h | 80 + .../src/Core/arch/HIP/hcc/math_constants.h | 23 + .../eigen/Eigen/src/Core/arch/MSA/Complex.h | 648 + .../Eigen/src/Core/arch/MSA/MathFunctions.h | 387 + .../Eigen/src/Core/arch/MSA/PacketMath.h | 1233 ++ .../eigen/Eigen/src/Core/arch/NEON/Complex.h | 584 + .../Core/arch/NEON/GeneralBlockPanelKernel.h | 183 + .../Eigen/src/Core/arch/NEON/MathFunctions.h | 75 + .../Eigen/src/Core/arch/NEON/PacketMath.h | 4587 +++++ .../Eigen/src/Core/arch/NEON/TypeCasting.h | 1419 ++ .../eigen/Eigen/src/Core/arch/SSE/Complex.h | 351 + .../Eigen/src/Core/arch/SSE/MathFunctions.h | 199 + .../Eigen/src/Core/arch/SSE/PacketMath.h | 1505 ++ .../Eigen/src/Core/arch/SSE/TypeCasting.h | 142 + .../Eigen/src/Core/arch/SVE/MathFunctions.h | 44 + .../Eigen/src/Core/arch/SVE/PacketMath.h | 752 + .../Eigen/src/Core/arch/SVE/TypeCasting.h | 49 + .../Eigen/src/Core/arch/SYCL/InteropHeaders.h | 232 + .../Eigen/src/Core/arch/SYCL/MathFunctions.h | 301 + .../Eigen/src/Core/arch/SYCL/PacketMath.h | 670 + .../src/Core/arch/SYCL/SyclMemoryModel.h | 694 + .../Eigen/src/Core/arch/SYCL/TypeCasting.h | 85 + .../Eigen/src/Core/arch/ZVector/Complex.h | 426 + .../src/Core/arch/ZVector/MathFunctions.h | 233 + .../Eigen/src/Core/arch/ZVector/PacketMath.h | 1060 + .../src/Core/functors/AssignmentFunctors.h | 177 + .../Eigen/src/Core/functors/BinaryFunctors.h | 541 + .../Eigen/src/Core/functors/NullaryFunctors.h | 189 + .../Eigen/src/Core/functors/StlFunctors.h | 166 + .../Eigen/src/Core/functors/TernaryFunctors.h | 25 + .../Eigen/src/Core/functors/UnaryFunctors.h | 1131 ++ .../Core/products/GeneralBlockPanelKernel.h | 2645 +++ .../src/Core/products/GeneralMatrixMatrix.h | 517 + .../products/GeneralMatrixMatrixTriangular.h | 317 + .../GeneralMatrixMatrixTriangular_BLAS.h | 145 + .../Core/products/GeneralMatrixMatrix_BLAS.h | 124 + .../src/Core/products/GeneralMatrixVector.h | 518 + .../Core/products/GeneralMatrixVector_BLAS.h | 136 + .../Eigen/src/Core/products/Parallelizer.h | 180 + .../Core/products/SelfadjointMatrixMatrix.h | 544 + .../products/SelfadjointMatrixMatrix_BLAS.h | 295 + .../Core/products/SelfadjointMatrixVector.h | 262 + .../products/SelfadjointMatrixVector_BLAS.h | 118 + .../src/Core/products/SelfadjointProduct.h | 133 + .../Core/products/SelfadjointRank2Update.h | 94 + .../Core/products/TriangularMatrixMatrix.h | 472 + .../products/TriangularMatrixMatrix_BLAS.h | 317 + .../Core/products/TriangularMatrixVector.h | 350 + .../products/TriangularMatrixVector_BLAS.h | 255 + .../Core/products/TriangularSolverMatrix.h | 337 + .../products/TriangularSolverMatrix_BLAS.h | 167 + .../Core/products/TriangularSolverVector.h | 148 + .../eigen/Eigen/src/Core/util/BlasUtil.h | 583 + .../src/Core/util/ConfigureVectorization.h | 512 + .../eigen/Eigen/src/Core/util/Constants.h | 563 + .../src/Core/util/DisableStupidWarnings.h | 106 + .../Eigen/src/Core/util/ForwardDeclarations.h | 322 + .../Eigen/src/Core/util/IndexedViewHelper.h | 186 + .../Eigen/src/Core/util/IntegralConstant.h | 272 + .../eigen/Eigen/src/Core/util/MKL_support.h | 137 + .../eigen/Eigen/src/Core/util/Macros.h | 1464 ++ .../eigen/Eigen/src/Core/util/Memory.h | 1163 ++ src/3rdparty/eigen/Eigen/src/Core/util/Meta.h | 812 + .../eigen/Eigen/src/Core/util/NonMPL2.h | 3 + .../src/Core/util/ReenableStupidWarnings.h | 31 + .../Eigen/src/Core/util/ReshapedHelper.h | 51 + .../eigen/Eigen/src/Core/util/StaticAssert.h | 221 + .../eigen/Eigen/src/Core/util/SymbolicIndex.h | 293 + .../eigen/Eigen/src/Core/util/XprHelper.h | 856 + .../src/Eigenvalues/ComplexEigenSolver.h | 346 + .../Eigen/src/Eigenvalues/ComplexSchur.h | 462 + .../src/Eigenvalues/ComplexSchur_LAPACKE.h | 91 + .../eigen/Eigen/src/Eigenvalues/EigenSolver.h | 622 + .../src/Eigenvalues/GeneralizedEigenSolver.h | 418 + .../GeneralizedSelfAdjointEigenSolver.h | 226 + .../src/Eigenvalues/HessenbergDecomposition.h | 374 + .../src/Eigenvalues/MatrixBaseEigenvalues.h | 158 + .../eigen/Eigen/src/Eigenvalues/RealQZ.h | 657 + .../eigen/Eigen/src/Eigenvalues/RealSchur.h | 558 + .../Eigen/src/Eigenvalues/RealSchur_LAPACKE.h | 77 + .../src/Eigenvalues/SelfAdjointEigenSolver.h | 904 + .../SelfAdjointEigenSolver_LAPACKE.h | 87 + .../src/Eigenvalues/Tridiagonalization.h | 561 + .../eigen/Eigen/src/Geometry/AlignedBox.h | 486 + .../eigen/Eigen/src/Geometry/AngleAxis.h | 247 + .../eigen/Eigen/src/Geometry/EulerAngles.h | 114 + .../eigen/Eigen/src/Geometry/Homogeneous.h | 501 + .../eigen/Eigen/src/Geometry/Hyperplane.h | 282 + .../eigen/Eigen/src/Geometry/OrthoMethods.h | 235 + .../Eigen/src/Geometry/ParametrizedLine.h | 232 + .../eigen/Eigen/src/Geometry/Quaternion.h | 870 + .../eigen/Eigen/src/Geometry/Rotation2D.h | 199 + .../eigen/Eigen/src/Geometry/RotationBase.h | 206 + .../eigen/Eigen/src/Geometry/Scaling.h | 188 + .../eigen/Eigen/src/Geometry/Transform.h | 1563 ++ .../eigen/Eigen/src/Geometry/Translation.h | 202 + .../eigen/Eigen/src/Geometry/Umeyama.h | 166 + .../Eigen/src/Geometry/arch/Geometry_SIMD.h | 168 + .../Eigen/src/Householder/BlockHouseholder.h | 110 + .../eigen/Eigen/src/Householder/Householder.h | 176 + .../src/Householder/HouseholderSequence.h | 545 + src/3rdparty/eigen/Eigen/src/Jacobi/Jacobi.h | 483 + src/3rdparty/eigen/Eigen/src/LU/Determinant.h | 117 + src/3rdparty/eigen/Eigen/src/LU/FullPivLU.h | 877 + src/3rdparty/eigen/Eigen/src/LU/InverseImpl.h | 432 + .../eigen/Eigen/src/LU/PartialPivLU.h | 624 + .../eigen/Eigen/src/LU/PartialPivLU_LAPACKE.h | 83 + .../eigen/Eigen/src/LU/arch/InverseSize4.h | 351 + .../eigen/Eigen/src/QR/ColPivHouseholderQR.h | 674 + .../src/QR/ColPivHouseholderQR_LAPACKE.h | 97 + .../src/QR/CompleteOrthogonalDecomposition.h | 635 + .../eigen/Eigen/src/QR/FullPivHouseholderQR.h | 713 + .../eigen/Eigen/src/QR/HouseholderQR.h | 434 + .../Eigen/src/QR/HouseholderQR_LAPACKE.h | 68 + src/3rdparty/eigen/Eigen/src/SVD/BDCSVD.h | 1366 ++ src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD.h | 812 + .../eigen/Eigen/src/SVD/JacobiSVD_LAPACKE.h | 91 + src/3rdparty/eigen/Eigen/src/SVD/SVDBase.h | 376 + .../Eigen/src/SVD/UpperBidiagonalization.h | 414 + src/3rdparty/eigen/Eigen/src/misc/Image.h | 82 + src/3rdparty/eigen/Eigen/src/misc/Kernel.h | 79 + .../eigen/Eigen/src/misc/RealSvd2x2.h | 55 + src/3rdparty/eigen/Eigen/src/misc/blas.h | 440 + src/3rdparty/eigen/Eigen/src/misc/lapack.h | 152 + src/3rdparty/eigen/Eigen/src/misc/lapacke.h | 16292 ++++++++++++++++ .../eigen/Eigen/src/misc/lapacke_mangling.h | 17 + .../Eigen/src/plugins/ArrayCwiseBinaryOps.h | 358 + .../Eigen/src/plugins/ArrayCwiseUnaryOps.h | 696 + .../eigen/Eigen/src/plugins/BlockMethods.h | 1442 ++ .../Eigen/src/plugins/CommonCwiseBinaryOps.h | 115 + .../Eigen/src/plugins/CommonCwiseUnaryOps.h | 177 + .../Eigen/src/plugins/IndexedViewMethods.h | 262 + .../Eigen/src/plugins/MatrixCwiseBinaryOps.h | 152 + .../Eigen/src/plugins/MatrixCwiseUnaryOps.h | 95 + .../eigen/Eigen/src/plugins/ReshapedMethods.h | 149 + src/3rdparty/eigen/INSTALL | 35 + src/3rdparty/eigen/README.md | 5 + src/3rdparty/eigen/REUSE.toml | 44 + src/3rdparty/eigen/qt_attribution.json | 20 + src/3rdparty/ffmpeg/LICENSE.BSD-2-Clause.txt | 9 + .../ffmpeg/LICENSE.BSD-Source-Code.txt | 10 + src/3rdparty/ffmpeg/LICENSE.BSL-1.0.txt | 7 + src/3rdparty/ffmpeg/LICENSE.IJG.txt | 38 + src/3rdparty/ffmpeg/LICENSE.ISC.txt | 8 + .../ffmpeg/LICENSE.LGPL-2.1-or-later.txt | 468 + src/3rdparty/ffmpeg/LICENSE.MIT.txt | 9 + src/3rdparty/ffmpeg/LICENSE.Zlib.txt | 11 + src/3rdparty/ffmpeg/qt_attribution.json | 55 + src/3rdparty/pffft/COPYRIGHTS | 2 + src/3rdparty/pffft/LICENSE | 45 + src/3rdparty/pffft/README.md | 320 + src/3rdparty/pffft/REUSE.toml | 9 + src/3rdparty/pffft/fftpack.c | 3111 +++ src/3rdparty/pffft/fftpack.h | 799 + src/3rdparty/pffft/pffft.c | 1906 ++ src/3rdparty/pffft/pffft.h | 181 + src/3rdparty/pffft/qt_attribution.json | 16 + src/3rdparty/pffft/test_pffft.c | 526 + src/3rdparty/resonance-audio/.travis.yml | 17 + src/3rdparty/resonance-audio/AUTHORS | 10 + src/3rdparty/resonance-audio/CMakeLists.txt | 109 + src/3rdparty/resonance-audio/CODEOWNERS | 6 + src/3rdparty/resonance-audio/CONTRIBUTING.md | 14 + src/3rdparty/resonance-audio/COPYRIGHTS | 1 + src/3rdparty/resonance-audio/LICENSE | 202 + src/3rdparty/resonance-audio/README.md | 192 + src/3rdparty/resonance-audio/REUSE.toml | 7 + src/3rdparty/resonance-audio/build.sh | 151 + .../0001-resonance_audio-fix-C-20-build.patch | 36 + .../resonance-audio/platforms/CMakeLists.txt | 30 + .../platforms/common/room_effects_utils.cc | 327 + .../platforms/common/room_effects_utils.h | 83 + .../common/room_effects_utils_test.cc | 197 + .../platforms/common/room_properties.h | 123 + .../resonance-audio/platforms/common/utils.cc | 59 + .../resonance-audio/platforms/common/utils.h | 55 + .../platforms/common/utils_test.cc | 107 + .../resonance-audio/qt_attribution.json | 18 + .../resonance_audio/CMakeLists.txt | 335 + .../ambisonics/ambisonic_binaural_decoder.cc | 80 + .../ambisonics/ambisonic_binaural_decoder.h | 71 + .../ambisonic_binaural_decoder_test.cc | 162 + .../ambisonics/ambisonic_codec.h | 62 + .../ambisonics/ambisonic_codec_impl.h | 295 + .../ambisonics/ambisonic_codec_impl_test.cc | 354 + .../ambisonics/ambisonic_lookup_table.cc | 231 + .../ambisonics/ambisonic_lookup_table.h | 92 + .../ambisonics/ambisonic_lookup_table_test.cc | 240 + .../ambisonic_spread_coefficients.h | 610 + ...sociated_legendre_polynomials_generator.cc | 147 + ...ssociated_legendre_polynomials_generator.h | 89 + ...ted_legendre_polynomials_generator_test.cc | 167 + .../resonance_audio/ambisonics/foa_rotator.cc | 117 + .../resonance_audio/ambisonics/foa_rotator.h | 61 + .../ambisonics/foa_rotator_test.cc | 201 + .../resonance_audio/ambisonics/hoa_rotator.cc | 308 + .../resonance_audio/ambisonics/hoa_rotator.h | 69 + .../ambisonics/hoa_rotator_test.cc | 201 + .../stereo_from_soundfield_converter.cc | 52 + .../stereo_from_soundfield_converter.h | 35 + .../stereo_from_soundfield_converter_test.cc | 103 + .../resonance_audio/ambisonics/utils.h | 120 + .../resonance_audio/ambisonics/utils_test.cc | 65 + .../api/binaural_surround_renderer.cc | 35 + .../api/binaural_surround_renderer.h | 255 + .../api/resonance_audio_api.cc | 30 + .../resonance_audio/api/resonance_audio_api.h | 416 + .../resonance_audio/base/aligned_allocator.h | 117 + .../base/aligned_allocator_test.cc | 53 + .../resonance_audio/base/audio_buffer.cc | 74 + .../resonance_audio/base/audio_buffer.h | 222 + .../resonance_audio/base/audio_buffer_test.cc | 144 + .../resonance_audio/base/channel_view.cc | 50 + .../resonance_audio/base/channel_view.h | 138 + .../resonance_audio/base/channel_view_test.cc | 157 + .../base/constants_and_types.h | 176 + .../resonance_audio/base/integral_types.h | 121 + .../resonance_audio/base/logging.h | 108 + .../resonance_audio/base/misc_math.cc | 94 + .../resonance_audio/base/misc_math.h | 385 + .../resonance_audio/base/misc_math_test.cc | 373 + .../resonance_audio/base/object_transform.h | 31 + .../resonance_audio/base/simd_macros.h | 65 + .../resonance_audio/base/simd_utils.cc | 1299 ++ .../resonance_audio/base/simd_utils.h | 296 + .../resonance_audio/base/simd_utils_test.cc | 711 + .../resonance_audio/base/source_parameters.h | 101 + .../resonance_audio/base/spherical_angle.cc | 78 + .../resonance_audio/base/spherical_angle.h | 87 + .../base/spherical_angle_test.cc | 122 + .../resonance_audio/base/unique_ptr_wrapper.h | 33 + .../resonance_audio/config/global_config.h | 37 + .../resonance_audio/config/source_config.cc | 76 + .../resonance_audio/config/source_config.h | 32 + .../resonance_audio/dsp/biquad_filter.cc | 149 + .../resonance_audio/dsp/biquad_filter.h | 137 + .../resonance_audio/dsp/biquad_filter_test.cc | 303 + .../resonance_audio/dsp/channel_converter.cc | 45 + .../resonance_audio/dsp/channel_converter.h | 40 + .../dsp/channel_converter_test.cc | 80 + .../resonance_audio/dsp/circular_buffer.cc | 120 + .../resonance_audio/dsp/circular_buffer.h | 96 + .../dsp/circular_buffer_test.cc | 230 + .../resonance_audio/dsp/delay_filter.cc | 180 + .../resonance_audio/dsp/delay_filter.h | 85 + .../resonance_audio/dsp/delay_filter_test.cc | 197 + .../dsp/distance_attenuation.cc | 121 + .../dsp/distance_attenuation.h | 82 + .../dsp/distance_attenuation_test.cc | 132 + .../resonance_audio/dsp/fft_manager.cc | 209 + .../resonance_audio/dsp/fft_manager.h | 182 + .../resonance_audio/dsp/fft_manager_test.cc | 260 + .../dsp/filter_coefficient_generators.cc | 165 + .../dsp/filter_coefficient_generators.h | 177 + .../dsp/filter_coefficient_generators_test.cc | 146 + .../resonance_audio/dsp/fir_filter.cc | 148 + .../resonance_audio/dsp/fir_filter.h | 62 + .../resonance_audio/dsp/fir_filter_test.cc | 104 + .../resonance_audio/dsp/gain.cc | 102 + .../resonance_audio/dsp/gain.h | 67 + .../resonance_audio/dsp/gain_mixer.cc | 115 + .../resonance_audio/dsp/gain_mixer.h | 96 + .../resonance_audio/dsp/gain_mixer_test.cc | 188 + .../resonance_audio/dsp/gain_processor.cc | 94 + .../resonance_audio/dsp/gain_processor.h | 74 + .../dsp/gain_processor_test.cc | 181 + .../resonance_audio/dsp/gain_test.cc | 132 + .../resonance_audio/dsp/mixer.cc | 56 + .../resonance_audio/dsp/mixer.h | 62 + .../resonance_audio/dsp/mixer_test.cc | 163 + .../resonance_audio/dsp/mono_pole_filter.cc | 59 + .../resonance_audio/dsp/mono_pole_filter.h | 57 + .../dsp/mono_pole_filter_test.cc | 59 + .../resonance_audio/dsp/multi_channel_iir.cc | 152 + .../resonance_audio/dsp/multi_channel_iir.h | 88 + .../dsp/multi_channel_iir_test.cc | 117 + .../dsp/near_field_processor.cc | 97 + .../dsp/near_field_processor.h | 75 + .../dsp/occlusion_calculator.cc | 52 + .../dsp/occlusion_calculator.h | 54 + .../dsp/occlusion_calculator_test.cc | 139 + .../dsp/partitioned_fft_filter.cc | 267 + .../dsp/partitioned_fft_filter.h | 167 + .../dsp/partitioned_fft_filter_test.cc | 761 + .../resonance_audio/dsp/reflection.h | 34 + .../dsp/reflections_processor.cc | 177 + .../dsp/reflections_processor.h | 128 + .../dsp/reflections_processor_test.cc | 142 + .../resonance_audio/dsp/resampler.cc | 335 + .../resonance_audio/dsp/resampler.h | 135 + .../resonance_audio/dsp/resampler_test.cc | 325 + .../dsp/reverb_onset_compensator.cc | 214 + .../dsp/reverb_onset_compensator.h | 110 + .../dsp/reverb_onset_update_processor.cc | 184 + .../dsp/reverb_onset_update_processor.h | 113 + .../resonance_audio/dsp/sh_hrir_creator.cc | 72 + .../resonance_audio/dsp/sh_hrir_creator.h | 54 + .../resonance_audio/dsp/shoe_box_room.cc | 61 + .../resonance_audio/dsp/shoe_box_room.h | 44 + .../resonance_audio/dsp/shoe_box_room_test.cc | 96 + .../resonance_audio/dsp/spectral_reverb.cc | 350 + .../resonance_audio/dsp/spectral_reverb.h | 173 + .../spectral_reverb_constants_and_tables.h | 6508 ++++++ .../dsp/spectral_reverb_test.cc | 324 + .../resonance_audio/dsp/stereo_panner.cc | 46 + .../resonance_audio/dsp/stereo_panner.h | 35 + .../resonance_audio/dsp/stereo_panner_test.cc | 88 + .../resonance_audio/dsp/utils.cc | 190 + .../resonance_audio/dsp/utils.h | 93 + .../resonance_audio/dsp/utils_test.cc | 194 + .../geometrical_acoustics/acoustic_listener.h | 57 + .../geometrical_acoustics/acoustic_ray.cc | 27 + .../geometrical_acoustics/acoustic_ray.h | 195 + .../acoustic_ray_test.cc | 243 + .../geometrical_acoustics/acoustic_source.h | 111 + .../acoustic_source_test.cc | 136 + .../collection_kernel.cc | 128 + .../geometrical_acoustics/collection_kernel.h | 79 + .../collection_kernel_test.cc | 353 + .../geometrical_acoustics/estimating_rt60.cc | 155 + .../geometrical_acoustics/estimating_rt60.h | 38 + .../estimating_rt60_test.cc | 185 + .../impulse_response_computer.cc | 188 + .../impulse_response_computer.h | 112 + .../impulse_response_computer_test.cc | 377 + .../geometrical_acoustics/mesh.h | 40 + .../geometrical_acoustics/parallel_for.cc | 44 + .../geometrical_acoustics/parallel_for.h | 53 + .../parallel_for_test.cc | 65 + .../geometrical_acoustics/path.h | 36 + .../geometrical_acoustics/path_tracer.cc | 96 + .../geometrical_acoustics/path_tracer.h | 59 + .../geometrical_acoustics/path_tracer_test.cc | 193 + .../proxy_room_estimator.cc | 438 + .../proxy_room_estimator.h | 156 + .../proxy_room_estimator_test.cc | 317 + .../reflection_kernel.cc | 99 + .../geometrical_acoustics/reflection_kernel.h | 104 + .../reflection_kernel_test.cc | 300 + .../geometrical_acoustics/sampling.h | 126 + .../geometrical_acoustics/scene_manager.cc | 153 + .../geometrical_acoustics/scene_manager.h | 130 + .../scene_manager_test.cc | 202 + .../geometrical_acoustics/sphere.cc | 120 + .../geometrical_acoustics/sphere.h | 69 + .../geometrical_acoustics/sphere_test.cc | 267 + .../geometrical_acoustics/test_util.cc | 231 + .../geometrical_acoustics/test_util.h | 131 + .../graph/ambisonic_binaural_decoder_node.cc | 111 + .../graph/ambisonic_binaural_decoder_node.h | 88 + .../graph/ambisonic_mixing_encoder_node.cc | 69 + .../graph/ambisonic_mixing_encoder_node.h | 71 + .../ambisonic_mixing_encoder_node_test.cc | 150 + .../graph/binaural_surround_renderer_impl.cc | 495 + .../graph/binaural_surround_renderer_impl.h | 190 + .../binaural_surround_renderer_impl_test.cc | 202 + .../graph/buffered_source_node.cc | 46 + .../graph/buffered_source_node.h | 62 + .../resonance_audio/graph/foa_rotator_node.cc | 67 + .../resonance_audio/graph/foa_rotator_node.h | 54 + .../resonance_audio/graph/gain_mixer_node.cc | 66 + .../resonance_audio/graph/gain_mixer_node.h | 68 + .../graph/gain_mixer_node_test.cc | 246 + .../resonance_audio/graph/gain_node.cc | 82 + .../resonance_audio/graph/gain_node.h | 69 + .../resonance_audio/graph/gain_node_test.cc | 138 + .../resonance_audio/graph/graph_manager.cc | 290 + .../resonance_audio/graph/graph_manager.h | 404 + .../graph/graph_manager_config.h | 40 + .../resonance_audio/graph/hoa_rotator_node.cc | 69 + .../resonance_audio/graph/hoa_rotator_node.h | 55 + .../resonance_audio/graph/mixer_node.cc | 57 + .../resonance_audio/graph/mixer_node.h | 54 + .../resonance_audio/graph/mixer_node_test.cc | 112 + .../graph/mono_from_soundfield_node.cc | 45 + .../graph/mono_from_soundfield_node.h | 44 + .../graph/near_field_effect_node.cc | 117 + .../graph/near_field_effect_node.h | 69 + .../graph/near_field_effect_node_test.cc | 127 + .../resonance_audio/graph/occlusion_node.cc | 101 + .../resonance_audio/graph/occlusion_node.h | 59 + .../graph/occlusion_node_test.cc | 186 + .../resonance_audio/graph/reflections_node.cc | 113 + .../resonance_audio/graph/reflections_node.h | 78 + .../graph/resonance_audio_api_impl.cc | 586 + .../graph/resonance_audio_api_impl.h | 175 + .../resonance_audio/graph/reverb_node.cc | 162 + .../resonance_audio/graph/reverb_node.h | 99 + .../graph/source_graph_config.h | 43 + .../graph/source_parameters_manager.cc | 58 + .../graph/source_parameters_manager.h | 68 + .../graph/source_parameters_manager_test.cc | 91 + .../graph/stereo_mixing_panner_node.cc | 65 + .../graph/stereo_mixing_panner_node.h | 61 + .../resonance_audio/graph/system_settings.h | 189 + .../resonance_audio/node/audio_nodes_test.cc | 407 + .../resonance_audio/node/node.h | 258 + .../resonance_audio/node/node_test.cc | 330 + .../resonance_audio/node/processing_node.cc | 89 + .../resonance_audio/node/processing_node.h | 115 + .../resonance_audio/node/publisher_node.h | 51 + .../resonance_audio/node/sink_node.cc | 54 + .../resonance_audio/node/sink_node.h | 59 + .../resonance_audio/node/source_node.cc | 41 + .../resonance_audio/node/source_node.h | 68 + .../resonance_audio/node/subscriber_node.h | 48 + .../utils/buffer_crossfader.cc | 66 + .../resonance_audio/utils/buffer_crossfader.h | 48 + .../utils/buffer_crossfader_test.cc | 53 + .../utils/buffer_partitioner.cc | 160 + .../utils/buffer_partitioner.h | 152 + .../utils/buffer_partitioner_test.cc | 241 + .../utils/buffer_unpartitioner.cc | 132 + .../utils/buffer_unpartitioner.h | 135 + .../utils/buffer_unpartitioner_test.cc | 294 + .../utils/lockless_task_queue.cc | 156 + .../utils/lockless_task_queue.h | 124 + .../utils/lockless_task_queue_test.cc | 215 + .../utils/ogg_vorbis_recorder.cc | 107 + .../utils/ogg_vorbis_recorder.h | 94 + .../utils/planar_interleaved_conversion.cc | 505 + .../utils/planar_interleaved_conversion.h | 421 + .../planar_interleaved_conversion_test.cc | 875 + .../resonance_audio/utils/pseudoinverse.h | 45 + .../utils/pseudoinverse_test.cc | 87 + .../utils/sample_type_conversion.cc | 40 + .../utils/sample_type_conversion.h | 79 + .../utils/sample_type_conversion_test.cc | 80 + .../utils/semi_lockless_fifo.h | 232 + .../utils/sum_and_difference_processor.cc | 40 + .../utils/sum_and_difference_processor.h | 44 + .../sum_and_difference_processor_test.cc | 42 + .../resonance_audio/utils/task_thread_pool.cc | 249 + .../resonance_audio/utils/task_thread_pool.h | 121 + .../utils/task_thread_pool_test.cc | 185 + .../resonance_audio/utils/test_util.cc | 190 + .../resonance_audio/utils/test_util.h | 91 + .../resonance_audio/utils/test_util_test.cc | 249 + .../resonance_audio/utils/threadsafe_fifo.h | 258 + .../utils/vorbis_stream_encoder.cc | 174 + .../utils/vorbis_stream_encoder.h | 114 + .../resonance_audio/utils/wav.cc | 53 + .../resonance_audio/utils/wav.h | 66 + .../resonance_audio/utils/wav_reader.cc | 214 + .../resonance_audio/utils/wav_reader.h | 103 + .../third_party/SADIE_hrtf_database/LICENSE | 157 + .../generate_hrtf_assets.py | 287 + .../SADIE_hrtf_database/generated/README | 5 + .../generated/hrtf_assets.cc | 1200 ++ .../generated/hrtf_assets.h | 45 + .../SADIE_hrtf_database/hrtf_assets.iad | 8 + src/CMakeLists.txt | 41 + src/android/CMakeLists.txt | 6 + src/android/jar/AndroidManifest.xml | 6 + src/android/jar/CMakeLists.txt | 36 + .../multimedia/QtAndroidMediaPlayer.java | 752 + .../multimedia/QtAudioDeviceManager.java | 417 + .../qt/android/multimedia/QtCamera2.java | 664 + .../android/multimedia/QtCameraListener.java | 207 + .../android/multimedia/QtExifDataHandler.java | 51 + .../multimedia/QtMediaRecorderListener.java | 31 + .../android/multimedia/QtMultimediaUtils.java | 149 + .../multimedia/QtScreenCaptureService.java | 212 + .../android/multimedia/QtScreenGrabber.java | 116 + .../multimedia/QtSurfaceHolderCallback.java | 37 + .../multimedia/QtSurfaceTextureHolder.java | 89 + .../multimedia/QtSurfaceTextureListener.java | 24 + .../multimedia/QtVideoDeviceManager.java | 317 + src/multimedia/CMakeLists.txt | 416 + src/multimedia/Qt6MultimediaMacros.cmake | 34 + src/multimedia/alsa/qalsaaudiodevice.cpp | 71 + src/multimedia/alsa/qalsaaudiodevice_p.h | 49 + src/multimedia/alsa/qalsaaudiodevices.cpp | 130 + src/multimedia/alsa/qalsaaudiodevices_p.h | 43 + src/multimedia/alsa/qalsaaudiosink.cpp | 698 + src/multimedia/alsa/qalsaaudiosink_p.h | 121 + src/multimedia/alsa/qalsaaudiosource.cpp | 770 + src/multimedia/alsa/qalsaaudiosource_p.h | 142 + .../android/qandroidaudiodevice.cpp | 40 + .../android/qandroidaudiodevice_p.h | 37 + .../android/qandroidaudiodevices.cpp | 108 + .../android/qandroidaudiodevices_p.h | 44 + src/multimedia/android/qandroidaudiosink.cpp | 614 + src/multimedia/android/qandroidaudiosink_p.h | 127 + .../android/qandroidaudiosource.cpp | 470 + .../android/qandroidaudiosource_p.h | 101 + src/multimedia/android/qopenslesengine.cpp | 380 + src/multimedia/android/qopenslesengine_p.h | 65 + src/multimedia/audio/qaudio.h | 53 + src/multimedia/audio/qaudiobuffer.cpp | 326 + src/multimedia/audio/qaudiobuffer.h | 175 + src/multimedia/audio/qaudiobuffer_support_p.h | 100 + src/multimedia/audio/qaudiobufferinput.cpp | 201 + src/multimedia/audio/qaudiobufferinput.h | 48 + src/multimedia/audio/qaudiobufferoutput.cpp | 81 + src/multimedia/audio/qaudiobufferoutput.h | 38 + src/multimedia/audio/qaudiobufferoutput_p.h | 43 + src/multimedia/audio/qaudiodecoder.cpp | 389 + src/multimedia/audio/qaudiodecoder.h | 85 + src/multimedia/audio/qaudiodecoder_p.h | 40 + src/multimedia/audio/qaudiodevice.cpp | 377 + src/multimedia/audio/qaudiodevice.h | 84 + src/multimedia/audio/qaudiodevice_p.h | 64 + src/multimedia/audio/qaudioformat.cpp | 478 + src/multimedia/audio/qaudioformat.h | 158 + src/multimedia/audio/qaudioformat_p.h | 43 + src/multimedia/audio/qaudiohelpers.cpp | 63 + src/multimedia/audio/qaudiohelpers_p.h | 30 + src/multimedia/audio/qaudioinput.cpp | 192 + src/multimedia/audio/qaudioinput.h | 54 + src/multimedia/audio/qaudiooutput.cpp | 209 + src/multimedia/audio/qaudiooutput.h | 55 + src/multimedia/audio/qaudioringbuffer_p.h | 159 + src/multimedia/audio/qaudiosink.cpp | 347 + src/multimedia/audio/qaudiosink.h | 74 + src/multimedia/audio/qaudiosource.cpp | 369 + src/multimedia/audio/qaudiosource.h | 72 + src/multimedia/audio/qaudiostatemachine.cpp | 149 + src/multimedia/audio/qaudiostatemachine_p.h | 154 + .../audio/qaudiostatemachineutils_p.h | 96 + src/multimedia/audio/qaudiosystem.cpp | 23 + src/multimedia/audio/qaudiosystem_p.h | 96 + src/multimedia/audio/qsamplecache_p.cpp | 461 + src/multimedia/audio/qsamplecache_p.h | 149 + src/multimedia/audio/qsoundeffect.cpp | 902 + src/multimedia/audio/qsoundeffect.h | 99 + src/multimedia/audio/qtaudio.cpp | 245 + src/multimedia/audio/qtaudio.h | 18 + src/multimedia/audio/qwavedecoder.cpp | 485 + src/multimedia/audio/qwavedecoder.h | 115 + src/multimedia/camera/qcamera.cpp | 1432 ++ src/multimedia/camera/qcamera.h | 270 + src/multimedia/camera/qcamera_p.h | 42 + src/multimedia/camera/qcameradevice.cpp | 478 + src/multimedia/camera/qcameradevice.h | 104 + src/multimedia/camera/qcameradevice_p.h | 75 + src/multimedia/camera/qimagecapture.cpp | 548 + src/multimedia/camera/qimagecapture.h | 131 + src/multimedia/compat/removed_api.cpp | 16 + src/multimedia/configure.cmake | 287 + .../darwin/qcoreaudiosessionmanager.mm | 437 + .../darwin/qcoreaudiosessionmanager_p.h | 95 + src/multimedia/darwin/qcoreaudioutils.cpp | 240 + src/multimedia/darwin/qcoreaudioutils_p.h | 49 + src/multimedia/darwin/qdarwinaudiodevice.mm | 143 + src/multimedia/darwin/qdarwinaudiodevice_p.h | 49 + src/multimedia/darwin/qdarwinaudiodevices.mm | 247 + src/multimedia/darwin/qdarwinaudiodevices_p.h | 47 + src/multimedia/darwin/qdarwinaudiosink.mm | 634 + src/multimedia/darwin/qdarwinaudiosink_p.h | 173 + src/multimedia/darwin/qdarwinaudiosource.mm | 830 + src/multimedia/darwin/qdarwinaudiosource_p.h | 222 + src/multimedia/darwin/qdarwinaudiounit_p.h | 31 + .../darwin/qmacosaudiodatautils.cpp | 203 + .../darwin/qmacosaudiodatautils_p.h | 130 + src/multimedia/doc/QtMultimediaDoc | 5 + src/multimedia/doc/qtmultimedia.qdocconf | 82 + src/multimedia/doc/snippets/CMakeLists.txt | 15 + .../custommediainputsnippets/CMakeLists.txt | 31 + .../custommediainputsnippets.cpp | 90 + .../custommediainputsnippets.h | 42 + .../custommediainputsnippets/main.cpp | 16 + .../snippets/multimedia-snippets/audio.cpp | 226 + .../snippets/multimedia-snippets/camera.cpp | 212 + .../snippets/multimedia-snippets/devices.cpp | 38 + .../multimedia-snippets/images/qt-logo.png | Bin 0 -> 1301 bytes .../snippets/multimedia-snippets/media.cpp | 109 + .../multiple-videooutputs.qml | 33 + .../snippets/multimedia-snippets/qsound.cpp | 35 + .../multimedia-snippets/qtvideosink.qml | 29 + .../multimedia-snippets/soundeffect.qml | 25 + .../snippets/multimedia-snippets/video.cpp | 118 + .../src/advanced-ffmpeg-configuration.qdoc | 135 + src/multimedia/doc/src/audiooverview.qdoc | 143 + .../doc/src/backend-notes-gstreamer.qdoc | 101 + src/multimedia/doc/src/cameraoverview.qdoc | 290 + src/multimedia/doc/src/classic.css | 284 + .../doc/src/cmake/cmake-variables.qdoc | 26 + .../cmake/qt_add_ios_ffmpeg_libraries.qdoc | 48 + .../src/examples/video-qml-paint-rate.qdocinc | 41 + src/multimedia/doc/src/images/Zoom.gif | Bin 0 -> 706673 bytes .../doc/src/images/annotatedurl.png | Bin 0 -> 34705 bytes .../src/images/camera_correctionAngle_90.png | Bin 0 -> 48562 bytes src/multimedia/doc/src/images/codeless.png | Bin 0 -> 4636 bytes .../doc/src/images/how-focus-works.gif | Bin 0 -> 289878 bytes .../doc/src/images/image_processing.png | Bin 0 -> 215435 bytes .../doc/src/images/noun_Media_166644.svg | 64 + src/multimedia/doc/src/images/qS1FmgPVL.jpg | Bin 0 -> 23184 bytes .../doc/src/images/qmlcamera-menu.png | Bin 0 -> 64550 bytes .../doc/src/images/radio-example.png | Bin 0 -> 11702 bytes .../doc/src/images/slideshow-img1.png | Bin 0 -> 596624 bytes .../doc/src/images/sound-wave-small.jpg | Bin 0 -> 37707 bytes .../doc/src/images/video-graphics-memory.png | Bin 0 -> 12945 bytes .../doc/src/images/video-qml-paint-rate.png | Bin 0 -> 6121 bytes .../doc/src/multimedia-overview.qdoc | 141 + .../doc/src/platform-notes-apple.qdoc | 34 + .../doc/src/platform-notes-wasm.qdoc | 35 + .../doc/src/platform-notes-wayland.qdoc | 24 + .../doc/src/platform-notes-windows.qdoc | 29 + src/multimedia/doc/src/qm-external-pages.qdoc | 237 + src/multimedia/doc/src/qt6-changes.qdoc | 145 + .../qtmultimedia-building-FFmpeg-macos.qdoc | 127 + .../qtmultimedia-building-FFmpeg-windows.qdoc | 168 + .../doc/src/qtmultimedia-building-FFmpeg.qdoc | 36 + .../qtmultimedia-building-from-source.qdoc | 98 + src/multimedia/doc/src/qtmultimedia-cpp.qdoc | 45 + .../doc/src/qtmultimedia-examples.qdoc | 15 + .../doc/src/qtmultimedia-index.qdoc | 319 + .../doc/src/qtmultimedia-qml-types.qdoc | 45 + src/multimedia/doc/src/videooverview.qdoc | 124 + .../pipewire/qpipewire_screencapture.cpp | 42 + .../pipewire/qpipewire_screencapture_p.h | 48 + .../qpipewire_screencapturehelper.cpp | 968 + .../qpipewire_screencapturehelper_p.h | 151 + src/multimedia/pipewire/qpipewire_support_p.h | 79 + .../pipewire/qpipewire_symbolloader.cpp | 67 + .../pipewire/qpipewire_symbolloader_p.h | 17 + .../qgstreamer_platformspecificinterface.cpp | 27 + .../qgstreamer_platformspecificinterface_p.h | 48 + .../platform/qplatformaudiobufferinput.cpp | 10 + .../platform/qplatformaudiobufferinput_p.h | 56 + .../platform/qplatformaudiodecoder.cpp | 81 + .../platform/qplatformaudiodecoder_p.h | 94 + .../platform/qplatformaudiodevices.cpp | 134 + .../platform/qplatformaudiodevices_p.h | 80 + .../platform/qplatformaudioinput_p.h | 46 + .../platform/qplatformaudiooutput_p.h | 44 + .../platform/qplatformaudioresampler_p.h | 33 + src/multimedia/platform/qplatformcamera.cpp | 233 + src/multimedia/platform/qplatformcamera_p.h | 232 + .../platform/qplatformcapturablewindows_p.h | 44 + .../platform/qplatformimagecapture.cpp | 27 + .../platform/qplatformimagecapture_p.h | 97 + .../platform/qplatformmediacapture.cpp | 37 + .../platform/qplatformmediacapture_p.h | 89 + .../platform/qplatformmediaformatinfo.cpp | 78 + .../platform/qplatformmediaformatinfo_p.h | 50 + .../platform/qplatformmediaintegration.cpp | 216 + .../platform/qplatformmediaintegration_p.h | 140 + .../platform/qplatformmediaplayer.cpp | 40 + .../platform/qplatformmediaplayer_p.h | 172 + .../platform/qplatformmediaplugin.cpp | 14 + .../platform/qplatformmediaplugin_p.h | 42 + .../platform/qplatformmediarecorder.cpp | 76 + .../platform/qplatformmediarecorder_p.h | 162 + .../platform/qplatformsurfacecapture.cpp | 83 + .../platform/qplatformsurfacecapture_p.h | 87 + .../platform/qplatformvideodevices.cpp | 12 + .../platform/qplatformvideodevices_p.h | 47 + .../platform/qplatformvideoframeinput.cpp | 10 + .../platform/qplatformvideoframeinput_p.h | 55 + .../platform/qplatformvideosink.cpp | 78 + .../platform/qplatformvideosink_p.h | 84 + .../platform/qplatformvideosource.cpp | 15 + .../platform/qplatformvideosource_p.h | 58 + src/multimedia/playback/qmediaplayer.cpp | 1436 ++ src/multimedia/playback/qmediaplayer.h | 201 + src/multimedia/playback/qmediaplayer_p.h | 90 + .../pulseaudio/qaudioengine_pulse.cpp | 566 + .../pulseaudio/qaudioengine_pulse_p.h | 104 + .../pulseaudio/qpulseaudiodevices.cpp | 54 + .../pulseaudio/qpulseaudiodevices_p.h | 50 + src/multimedia/pulseaudio/qpulseaudiosink.cpp | 765 + src/multimedia/pulseaudio/qpulseaudiosink_p.h | 138 + .../pulseaudio/qpulseaudiosource.cpp | 572 + .../pulseaudio/qpulseaudiosource_p.h | 121 + src/multimedia/pulseaudio/qpulsehelpers.cpp | 284 + src/multimedia/pulseaudio/qpulsehelpers_p.h | 83 + src/multimedia/qcachedvalue_p.h | 71 + src/multimedia/qerrorinfo_p.h | 57 + src/multimedia/qmaybe_p.h | 96 + src/multimedia/qmediadevices.cpp | 297 + src/multimedia/qmediadevices.h | 56 + src/multimedia/qmediaformat.cpp | 906 + src/multimedia/qmediaformat.h | 149 + src/multimedia/qmediaframeinput.cpp | 43 + src/multimedia/qmediaframeinput_p.h | 74 + .../qmediainputencoderinterface_p.h | 31 + src/multimedia/qmediametadata.cpp | 550 + src/multimedia/qmediametadata.h | 101 + src/multimedia/qmediastoragelocation.cpp | 94 + src/multimedia/qmediastoragelocation_p.h | 35 + src/multimedia/qmediatimerange.cpp | 579 + src/multimedia/qmediatimerange.h | 129 + .../qmultimedia_enum_to_string_converter_p.h | 81 + src/multimedia/qmultimediautils.cpp | 185 + src/multimedia/qmultimediautils_p.h | 97 + src/multimedia/qnx/qqnxaudiodevice.cpp | 85 + src/multimedia/qnx/qqnxaudiodevice_p.h | 35 + src/multimedia/qnx/qqnxaudiodevices.cpp | 70 + src/multimedia/qnx/qqnxaudiodevices_p.h | 41 + src/multimedia/qnx/qqnxaudiosink.cpp | 516 + src/multimedia/qnx/qqnxaudiosink_p.h | 119 + src/multimedia/qnx/qqnxaudiosource.cpp | 376 + src/multimedia/qnx/qqnxaudiosource_p.h | 113 + src/multimedia/qnx/qqnxaudioutils.cpp | 148 + src/multimedia/qnx/qqnxaudioutils_p.h | 51 + src/multimedia/qrhivaluemapper.cpp | 84 + src/multimedia/qrhivaluemapper_p.h | 152 + src/multimedia/qsharedhandle_p.h | 112 + src/multimedia/qsymbolsresolveutils.cpp | 85 + src/multimedia/qsymbolsresolveutils_p.h | 191 + src/multimedia/qt_cmdline.cmake | 8 + src/multimedia/qtmultimediaglobal.h | 11 + src/multimedia/qtmultimediaglobal_p.h | 22 + src/multimedia/qvideotransformation.cpp | 16 + src/multimedia/qvideotransformation_p.h | 75 + .../recording/qcapturablewindow.cpp | 156 + src/multimedia/recording/qcapturablewindow.h | 66 + .../recording/qcapturablewindow_p.h | 41 + .../recording/qmediacapturesession.cpp | 688 + .../recording/qmediacapturesession.h | 106 + .../recording/qmediacapturesession_p.h | 53 + src/multimedia/recording/qmediarecorder.cpp | 1138 ++ src/multimedia/recording/qmediarecorder.h | 179 + src/multimedia/recording/qmediarecorder_p.h | 55 + .../qscreencapture-limitations.qdocinc | 45 + src/multimedia/recording/qscreencapture.cpp | 261 + src/multimedia/recording/qscreencapture.h | 72 + src/multimedia/recording/qvideoframeinput.cpp | 199 + src/multimedia/recording/qvideoframeinput.h | 49 + .../qwindowcapture-limitations.qdocinc | 12 + src/multimedia/recording/qwindowcapture.cpp | 272 + src/multimedia/recording/qwindowcapture.h | 71 + src/multimedia/shaders/abgr.frag | 22 + src/multimedia/shaders/argb.frag | 22 + src/multimedia/shaders/ayuv.frag | 28 + src/multimedia/shaders/bgra.frag | 22 + src/multimedia/shaders/colorconvert.glsl | 22 + src/multimedia/shaders/colortransfer.glsl | 121 + src/multimedia/shaders/compile.bat | 16 + src/multimedia/shaders/externalsampler.frag | 17 + src/multimedia/shaders/externalsampler.vert | 19 + .../shaders/externalsampler_gles.frag | 31 + src/multimedia/shaders/hdrtonemapper.glsl | 41 + src/multimedia/shaders/imc2.frag | 32 + src/multimedia/shaders/imc2_a.frag | 32 + src/multimedia/shaders/imc4.frag | 32 + src/multimedia/shaders/imc4_a.frag | 32 + src/multimedia/shaders/nv12.frag | 30 + src/multimedia/shaders/nv12_a.frag | 30 + src/multimedia/shaders/nv12_bt2020_hlg.frag | 45 + src/multimedia/shaders/nv12_bt2020_pq.frag | 51 + src/multimedia/shaders/nv21.frag | 30 + src/multimedia/shaders/nv21_a.frag | 30 + src/multimedia/shaders/rectsampler.vert | 19 + src/multimedia/shaders/rectsampler_bgra.frag | 22 + src/multimedia/shaders/rgba.frag | 22 + src/multimedia/shaders/uniformbuffer.glsl | 14 + src/multimedia/shaders/uyvy.frag | 51 + src/multimedia/shaders/vertex.vert | 19 + src/multimedia/shaders/y.frag | 28 + src/multimedia/shaders/y_a.frag | 28 + src/multimedia/shaders/yuv_triplanar.frag | 32 + src/multimedia/shaders/yuv_triplanar_a.frag | 32 + src/multimedia/shaders/yuv_triplanar_p10.frag | 32 + src/multimedia/shaders/yuyv.frag | 51 + src/multimedia/shaders/yvu_triplanar.frag | 32 + src/multimedia/shaders/yvu_triplanar_a.frag | 32 + src/multimedia/video/qabstractvideobuffer.cpp | 141 + src/multimedia/video/qabstractvideobuffer.h | 33 + src/multimedia/video/qhwvideobuffer.cpp | 19 + src/multimedia/video/qhwvideobuffer_p.h | 108 + src/multimedia/video/qimagevideobuffer.cpp | 78 + src/multimedia/video/qimagevideobuffer_p.h | 40 + src/multimedia/video/qmemoryvideobuffer.cpp | 52 + src/multimedia/video/qmemoryvideobuffer_p.h | 40 + src/multimedia/video/qtvideo.cpp | 32 + src/multimedia/video/qtvideo.h | 30 + src/multimedia/video/qvideoframe.cpp | 1065 + src/multimedia/video/qvideoframe.h | 164 + src/multimedia/video/qvideoframe_p.h | 95 + .../video/qvideoframeconversionhelper.cpp | 630 + .../qvideoframeconversionhelper_avx2.cpp | 135 + .../video/qvideoframeconversionhelper_p.h | 142 + .../qvideoframeconversionhelper_sse2.cpp | 123 + .../qvideoframeconversionhelper_ssse3.cpp | 89 + src/multimedia/video/qvideoframeconverter.cpp | 467 + src/multimedia/video/qvideoframeconverter_p.h | 40 + src/multimedia/video/qvideoframeformat.cpp | 1069 + src/multimedia/video/qvideoframeformat.h | 225 + .../video/qvideoframetexturefromsource.cpp | 55 + .../video/qvideoframetexturefromsource_p.h | 77 + .../video/qvideoframetexturepool.cpp | 41 + .../video/qvideoframetexturepool_p.h | 85 + .../video/qvideooutputorientationhandler.cpp | 52 + .../video/qvideooutputorientationhandler_p.h | 50 + src/multimedia/video/qvideosink.cpp | 194 + src/multimedia/video/qvideosink.h | 57 + src/multimedia/video/qvideotexturehelper.cpp | 932 + src/multimedia/video/qvideotexturehelper_p.h | 129 + src/multimedia/video/qvideowindow.cpp | 529 + src/multimedia/video/qvideowindow_p.h | 123 + src/multimedia/wasm/qwasmaudiodevice.cpp | 56 + src/multimedia/wasm/qwasmaudiodevice_p.h | 31 + src/multimedia/wasm/qwasmaudiosink.cpp | 464 + src/multimedia/wasm/qwasmaudiosink_p.h | 89 + src/multimedia/wasm/qwasmaudiosource.cpp | 315 + src/multimedia/wasm/qwasmaudiosource_p.h | 75 + src/multimedia/wasm/qwasmmediadevices.cpp | 262 + src/multimedia/wasm/qwasmmediadevices_p.h | 94 + src/multimedia/windows/qcominitializer.cpp | 28 + src/multimedia/windows/qcominitializer_p.h | 36 + src/multimedia/windows/qcomptr_p.h | 33 + src/multimedia/windows/qcomtaskresource_p.h | 152 + .../windows/qwindowsaudiodevice.cpp | 291 + .../windows/qwindowsaudiodevice_p.h | 50 + .../windows/qwindowsaudiodevices.cpp | 362 + .../windows/qwindowsaudiodevices_p.h | 70 + src/multimedia/windows/qwindowsaudiosink.cpp | 478 + src/multimedia/windows/qwindowsaudiosink_p.h | 120 + .../windows/qwindowsaudiosource.cpp | 411 + .../windows/qwindowsaudiosource_p.h | 96 + src/multimedia/windows/qwindowsaudioutils.cpp | 218 + src/multimedia/windows/qwindowsaudioutils_p.h | 47 + .../windows/qwindowsmediafoundation.cpp | 70 + .../windows/qwindowsmediafoundation_p.h | 59 + src/multimedia/windows/qwindowsmfdefs.cpp | 26 + src/multimedia/windows/qwindowsmfdefs_p.h | 94 + .../windows/qwindowsmultimediautils.cpp | 215 + .../windows/qwindowsmultimediautils_p.h | 47 + src/multimedia/windows/qwindowsresampler.cpp | 241 + src/multimedia/windows/qwindowsresampler_p.h | 75 + src/multimediaquick/CMakeLists.txt | 44 + src/multimediaquick/Video.qml | 377 + src/multimediaquick/multimedia_plugin.cpp | 42 + src/multimediaquick/qquickimagecapture.cpp | 189 + src/multimediaquick/qquickimagecapture_p.h | 57 + .../qquickimagepreviewprovider.cpp | 59 + .../qquickimagepreviewprovider_p.h | 35 + src/multimediaquick/qquickmediaplayer.cpp | 95 + src/multimediaquick/qquickmediaplayer_p.h | 75 + src/multimediaquick/qquickplaylist.cpp | 594 + src/multimediaquick/qquickplaylist_p.h | 171 + src/multimediaquick/qquickscreencapture.cpp | 27 + src/multimediaquick/qquickscreencapture_p.h | 44 + src/multimediaquick/qquicksoundeffect.cpp | 29 + src/multimediaquick/qquicksoundeffect_p.h | 47 + src/multimediaquick/qquickvideooutput.cpp | 572 + src/multimediaquick/qquickvideooutput_p.h | 146 + src/multimediaquick/qsgvideonode_p.cpp | 374 + src/multimediaquick/qsgvideonode_p.h | 72 + src/multimediaquick/qsgvideotexture.cpp | 77 + src/multimediaquick/qsgvideotexture_p.h | 47 + .../qtmultimediaquickglobal_p.h | 28 + .../qtmultimediaquicktypes.cpp | 12 + .../qtmultimediaquicktypes_p.h | 194 + src/multimediatestlib/CMakeLists.txt | 31 + .../audiogenerationutils_p.h | 153 + .../capturesessionfixture.cpp | 107 + .../capturesessionfixture_p.h | 63 + src/multimediatestlib/framegenerator.cpp | 124 + src/multimediatestlib/framegenerator_p.h | 73 + src/multimediatestlib/mediabackendutils_p.h | 93 + src/multimediatestlib/mediafileselector_p.h | 190 + src/multimediatestlib/mediainfo_p.h | 131 + src/multimediatestlib/qcolorutil.cpp | 40 + src/multimediatestlib/qcolorutil_p.h | 30 + src/multimediatestlib/qfileutil.cpp | 38 + src/multimediatestlib/qfileutil_p.h | 26 + src/multimediatestlib/qmockiodevice_p.h | 38 + .../qscopedenvironmentvariable_p.h | 40 + .../qsequentialfileadaptor_p.h | 55 + src/multimediatestlib/qsinewavevalidator.cpp | 61 + src/multimediatestlib/qsinewavevalidator_p.h | 50 + src/multimediatestlib/testvideosink_p.h | 80 + src/multimediawidgets/CMakeLists.txt | 31 + .../snippets/multimedia-snippets/camera.cpp | 37 + .../snippets/multimedia-snippets/video.cpp | 63 + .../doc/src/qtmultimediawidgets-index.qdoc | 36 + .../doc/src/qtmultimediawidgets.qdoc | 13 + src/multimediawidgets/qgraphicsvideoitem.cpp | 260 + src/multimediawidgets/qgraphicsvideoitem.h | 71 + .../qtmultimediawidgetsglobal.h | 9 + src/multimediawidgets/qvideowidget.cpp | 215 + src/multimediawidgets/qvideowidget.h | 59 + src/multimediawidgets/qvideowidget_p.h | 47 + src/plugins/CMakeLists.txt | 4 + src/plugins/multimedia/CMakeLists.txt | 24 + src/plugins/multimedia/android/CMakeLists.txt | 62 + src/plugins/multimedia/android/android.json | 3 + .../android/audio/qandroidaudiodecoder.cpp | 437 + .../android/audio/qandroidaudiodecoder_p.h | 118 + .../android/common/qandroidaudioinput.cpp | 47 + .../android/common/qandroidaudioinput_p.h | 47 + .../android/common/qandroidaudiooutput_p.h | 30 + .../android/common/qandroidglobal_p.h | 28 + .../common/qandroidmultimediautils.cpp | 125 + .../common/qandroidmultimediautils_p.h | 40 + .../android/common/qandroidvideooutput.cpp | 468 + .../android/common/qandroidvideooutput_p.h | 93 + .../android/common/qandroidvideosink.cpp | 35 + .../android/common/qandroidvideosink_p.h | 41 + .../android/mediacapture/qandroidcamera.cpp | 562 + .../android/mediacapture/qandroidcamera_p.h | 99 + .../mediacapture/qandroidcamerasession.cpp | 808 + .../mediacapture/qandroidcamerasession_p.h | 166 + .../mediacapture/qandroidcapturesession.cpp | 472 + .../mediacapture/qandroidcapturesession_p.h | 158 + .../mediacapture/qandroidimagecapture.cpp | 73 + .../mediacapture/qandroidimagecapture_p.h | 48 + .../qandroidmediacapturesession.cpp | 115 + .../qandroidmediacapturesession_p.h | 66 + .../mediacapture/qandroidmediaencoder.cpp | 72 + .../mediacapture/qandroidmediaencoder_p.h | 50 + .../mediaplayer/qandroidmediaplayer.cpp | 999 + .../mediaplayer/qandroidmediaplayer_p.h | 127 + .../android/mediaplayer/qandroidmetadata.cpp | 163 + .../android/mediaplayer/qandroidmetadata_p.h | 47 + .../android/qandroidformatsinfo.cpp | 160 + .../android/qandroidformatsinfo_p.h | 40 + .../android/qandroidintegration.cpp | 159 + .../android/qandroidintegration_p.h | 48 + .../android/wrappers/jni/androidcamera.cpp | 1797 ++ .../android/wrappers/jni/androidcamera_p.h | 208 + .../jni/androidmediametadataretriever.cpp | 136 + .../jni/androidmediametadataretriever_p.h | 66 + .../wrappers/jni/androidmediaplayer.cpp | 535 + .../wrappers/jni/androidmediaplayer_p.h | 135 + .../wrappers/jni/androidmediarecorder.cpp | 337 + .../wrappers/jni/androidmediarecorder_p.h | 161 + .../wrappers/jni/androidmultimediautils.cpp | 43 + .../wrappers/jni/androidmultimediautils_p.h | 40 + .../wrappers/jni/androidsurfacetexture.cpp | 152 + .../wrappers/jni/androidsurfacetexture_p.h | 61 + .../wrappers/jni/androidsurfaceview.cpp | 152 + .../wrappers/jni/androidsurfaceview_p.h | 78 + src/plugins/multimedia/darwin/CMakeLists.txt | 63 + .../multimedia/darwin/avfaudiodecoder.mm | 544 + .../multimedia/darwin/avfaudiodecoder_p.h | 99 + .../multimedia/darwin/avfvideobuffer.mm | 214 + .../multimedia/darwin/avfvideobuffer_p.h | 64 + src/plugins/multimedia/darwin/avfvideosink.mm | 221 + .../multimedia/darwin/avfvideosink_p.h | 95 + .../darwin/camera/avfaudiopreviewdelegate.mm | 100 + .../darwin/camera/avfaudiopreviewdelegate_p.h | 40 + .../multimedia/darwin/camera/avfcamera.mm | 78 + .../multimedia/darwin/camera/avfcamera_p.h | 49 + .../darwin/camera/avfcameradebug_p.h | 26 + .../darwin/camera/avfcamerarenderer.mm | 293 + .../darwin/camera/avfcamerarenderer_p.h | 95 + .../darwin/camera/avfcameraservice.mm | 169 + .../darwin/camera/avfcameraservice_p.h | 84 + .../darwin/camera/avfcamerasession.mm | 513 + .../darwin/camera/avfcamerasession_p.h | 132 + .../darwin/camera/avfcamerautility.mm | 743 + .../darwin/camera/avfcamerautility_p.h | 174 + .../darwin/camera/avfimagecapture.mm | 385 + .../darwin/camera/avfimagecapture_p.h | 81 + .../darwin/camera/avfmediaassetwriter.mm | 556 + .../darwin/camera/avfmediaassetwriter_p.h | 54 + .../darwin/camera/avfmediaencoder.mm | 665 + .../darwin/camera/avfmediaencoder_p.h | 96 + .../darwin/camera/qavfcamerabase.mm | 1229 ++ .../darwin/camera/qavfcamerabase_p.h | 144 + .../multimedia/darwin/common/avfmetadata.mm | 401 + .../multimedia/darwin/common/avfmetadata_p.h | 37 + src/plugins/multimedia/darwin/darwin.json | 3 + .../darwin/mediaplayer/avfdisplaylink.mm | 207 + .../darwin/mediaplayer/avfdisplaylink_p.h | 65 + .../darwin/mediaplayer/avfmediaplayer.mm | 1277 ++ .../darwin/mediaplayer/avfmediaplayer_p.h | 151 + .../mediaplayer/avfvideorenderercontrol.mm | 223 + .../mediaplayer/avfvideorenderercontrol_p.h | 72 + src/plugins/multimedia/darwin/qavfhelpers.mm | 136 + src/plugins/multimedia/darwin/qavfhelpers_p.h | 41 + .../multimedia/darwin/qdarwinformatsinfo.mm | 211 + .../multimedia/darwin/qdarwinformatsinfo_p.h | 38 + .../multimedia/darwin/qdarwinintegration.mm | 93 + .../multimedia/darwin/qdarwinintegration_p.h | 45 + src/plugins/multimedia/ffmpeg/CMakeLists.txt | 265 + .../ffmpeg/cmake/QtAddFFmpegStubs.cmake | 199 + .../ffmpeg/cmake/QtDeployFFmpeg.cmake | 73 + src/plugins/multimedia/ffmpeg/ffmpeg.json | 3 + .../playbackengine/qffmpegaudiorenderer.cpp | 407 + .../playbackengine/qffmpegaudiorenderer_p.h | 132 + .../playbackengine/qffmpegcodeccontext.cpp | 120 + .../playbackengine/qffmpegcodeccontext_p.h | 68 + .../ffmpeg/playbackengine/qffmpegdemuxer.cpp | 241 + .../ffmpeg/playbackengine/qffmpegdemuxer_p.h | 87 + .../ffmpeg/playbackengine/qffmpegframe_p.h | 119 + .../playbackengine/qffmpegmediadataholder.cpp | 430 + .../playbackengine/qffmpegmediadataholder_p.h | 107 + .../ffmpeg/playbackengine/qffmpegpacket_p.h | 60 + .../qffmpegplaybackenginedefs_p.h | 46 + .../qffmpegplaybackengineobject.cpp | 113 + .../qffmpegplaybackengineobject_p.h | 85 + .../qffmpegpositionwithoffset_p.h | 40 + .../ffmpeg/playbackengine/qffmpegrenderer.cpp | 218 + .../ffmpeg/playbackengine/qffmpegrenderer_p.h | 125 + .../playbackengine/qffmpegstreamdecoder.cpp | 259 + .../playbackengine/qffmpegstreamdecoder_p.h | 89 + .../qffmpegsubtitlerenderer.cpp | 50 + .../qffmpegsubtitlerenderer_p.h | 48 + .../playbackengine/qffmpegtimecontroller.cpp | 165 + .../playbackengine/qffmpegtimecontroller_p.h | 94 + .../playbackengine/qffmpegvideorenderer.cpp | 87 + .../playbackengine/qffmpegvideorenderer_p.h | 48 + .../multimedia/ffmpeg/qandroidcamera.cpp | 815 + .../multimedia/ffmpeg/qandroidcamera_p.h | 99 + .../ffmpeg/qandroidimagecapture.cpp | 46 + .../ffmpeg/qandroidimagecapture_p.h | 38 + .../ffmpeg/qandroidscreencapture.cpp | 174 + .../ffmpeg/qandroidscreencapture_p.h | 49 + .../ffmpeg/qandroidvideodevices.cpp | 117 + .../ffmpeg/qandroidvideodevices_p.h | 35 + .../ffmpeg/qandroidvideoframebuffer.cpp | 262 + .../ffmpeg/qandroidvideoframebuffer_p.h | 90 + .../ffmpeg/qandroidvideoframefactory.cpp | 51 + .../ffmpeg/qandroidvideoframefactory_p.h | 42 + src/plugins/multimedia/ffmpeg/qavfcamera.mm | 447 + src/plugins/multimedia/ffmpeg/qavfcamera_p.h | 107 + .../ffmpeg/qavfsamplebufferdelegate.mm | 236 + .../ffmpeg/qavfsamplebufferdelegate_p.h | 63 + .../multimedia/ffmpeg/qavfscreencapture.mm | 201 + .../multimedia/ffmpeg/qavfscreencapture_p.h | 60 + .../multimedia/ffmpeg/qcgcapturablewindows.mm | 48 + .../ffmpeg/qcgcapturablewindows_p.h | 32 + .../multimedia/ffmpeg/qcgwindowcapture.mm | 197 + .../multimedia/ffmpeg/qcgwindowcapture_p.h | 43 + .../multimedia/ffmpeg/qeglfsscreencapture.cpp | 180 + .../multimedia/ffmpeg/qeglfsscreencapture_p.h | 48 + src/plugins/multimedia/ffmpeg/qffmpeg.cpp | 396 + src/plugins/multimedia/ffmpeg/qffmpeg_p.h | 315 + .../multimedia/ffmpeg/qffmpegaudiodecoder.cpp | 246 + .../multimedia/ffmpeg/qffmpegaudiodecoder_p.h | 68 + .../multimedia/ffmpeg/qffmpegaudioinput.cpp | 203 + .../multimedia/ffmpeg/qffmpegaudioinput_p.h | 57 + .../ffmpeg/qffmpegavaudioformat.cpp | 96 + .../ffmpeg/qffmpegavaudioformat_p.h | 70 + .../multimedia/ffmpeg/qffmpegcodec.cpp | 279 + .../multimedia/ffmpeg/qffmpegcodec_p.h | 83 + .../multimedia/ffmpeg/qffmpegcodecstorage.cpp | 411 + .../multimedia/ffmpeg/qffmpegcodecstorage_p.h | 47 + .../multimedia/ffmpeg/qffmpegconverter.cpp | 267 + .../multimedia/ffmpeg/qffmpegconverter_p.h | 30 + src/plugins/multimedia/ffmpeg/qffmpegdefs_p.h | 75 + .../ffmpeg/qffmpegencodingformatcontext.cpp | 116 + .../ffmpeg/qffmpegencodingformatcontext_p.h | 60 + .../multimedia/ffmpeg/qffmpeghwaccel.cpp | 434 + .../ffmpeg/qffmpeghwaccel_d3d11.cpp | 392 + .../ffmpeg/qffmpeghwaccel_d3d11_p.h | 107 + .../ffmpeg/qffmpeghwaccel_mediacodec.cpp | 139 + .../ffmpeg/qffmpeghwaccel_mediacodec_p.h | 41 + .../multimedia/ffmpeg/qffmpeghwaccel_p.h | 104 + .../ffmpeg/qffmpeghwaccel_vaapi.cpp | 366 + .../ffmpeg/qffmpeghwaccel_vaapi_p.h | 49 + .../ffmpeg/qffmpeghwaccel_videotoolbox.mm | 309 + .../ffmpeg/qffmpeghwaccel_videotoolbox_p.h | 64 + .../multimedia/ffmpeg/qffmpegimagecapture.cpp | 269 + .../multimedia/ffmpeg/qffmpegimagecapture_p.h | 71 + .../multimedia/ffmpeg/qffmpegioutils.cpp | 55 + .../multimedia/ffmpeg/qffmpegioutils_p.h | 40 + .../ffmpeg/qffmpegmediacapturesession.cpp | 318 + .../ffmpeg/qffmpegmediacapturesession_p.h | 112 + .../ffmpeg/qffmpegmediaformatinfo.cpp | 515 + .../ffmpeg/qffmpegmediaformatinfo_p.h | 52 + .../ffmpeg/qffmpegmediaintegration.cpp | 392 + .../ffmpeg/qffmpegmediaintegration_p.h | 59 + .../ffmpeg/qffmpegmediametadata.cpp | 181 + .../ffmpeg/qffmpegmediametadata_p.h | 35 + .../multimedia/ffmpeg/qffmpegmediaplayer.cpp | 411 + .../multimedia/ffmpeg/qffmpegmediaplayer_p.h | 119 + .../ffmpeg/qffmpegmediarecorder.cpp | 200 + .../ffmpeg/qffmpegmediarecorder_p.h | 73 + .../ffmpeg/qffmpegplaybackengine.cpp | 650 + .../ffmpeg/qffmpegplaybackengine_p.h | 234 + .../multimedia/ffmpeg/qffmpegresampler.cpp | 113 + .../multimedia/ffmpeg/qffmpegresampler_p.h | 62 + .../ffmpeg/qffmpegscreencapture_dxgi.cpp | 478 + .../ffmpeg/qffmpegscreencapture_dxgi_p.h | 44 + .../ffmpeg/qffmpegsurfacecapturegrabber.cpp | 202 + .../ffmpeg/qffmpegsurfacecapturegrabber_p.h | 92 + .../ffmpeg/qffmpegtextureconverter.cpp | 152 + .../ffmpeg/qffmpegtextureconverter_p.h | 140 + .../multimedia/ffmpeg/qffmpegthread.cpp | 54 + .../multimedia/ffmpeg/qffmpegthread_p.h | 102 + .../multimedia/ffmpeg/qffmpegvideobuffer.cpp | 400 + .../multimedia/ffmpeg/qffmpegvideobuffer_p.h | 76 + .../multimedia/ffmpeg/qffmpegvideosink.cpp | 33 + .../multimedia/ffmpeg/qffmpegvideosink_p.h | 43 + .../ffmpeg/qffmpegwindowcapture_uwp.cpp | 505 + .../ffmpeg/qffmpegwindowcapture_uwp_p.h | 46 + .../multimedia/ffmpeg/qgdiwindowcapture.cpp | 197 + .../multimedia/ffmpeg/qgdiwindowcapture_p.h | 43 + .../ffmpeg/qgrabwindowsurfacecapture.cpp | 223 + .../ffmpeg/qgrabwindowsurfacecapture_p.h | 48 + .../multimedia/ffmpeg/qopenglvideobuffer.cpp | 95 + .../multimedia/ffmpeg/qopenglvideobuffer_p.h | 44 + src/plugins/multimedia/ffmpeg/qv4l2camera.cpp | 707 + src/plugins/multimedia/ffmpeg/qv4l2camera_p.h | 133 + .../multimedia/ffmpeg/qv4l2cameradevices.cpp | 182 + .../multimedia/ffmpeg/qv4l2cameradevices_p.h | 46 + .../multimedia/ffmpeg/qv4l2filedescriptor.cpp | 71 + .../multimedia/ffmpeg/qv4l2filedescriptor_p.h | 50 + .../multimedia/ffmpeg/qv4l2memorytransfer.cpp | 223 + .../multimedia/ffmpeg/qv4l2memorytransfer_p.h | 66 + .../ffmpeg/qwincapturablewindows.cpp | 74 + .../ffmpeg/qwincapturablewindows_p.h | 32 + .../multimedia/ffmpeg/qwindowscamera.cpp | 330 + .../multimedia/ffmpeg/qwindowscamera_p.h | 45 + .../ffmpeg/qx11capturablewindows.cpp | 74 + .../ffmpeg/qx11capturablewindows_p.h | 45 + .../multimedia/ffmpeg/qx11surfacecapture.cpp | 342 + .../multimedia/ffmpeg/qx11surfacecapture_p.h | 48 + .../recordingengine/qffmpegaudioencoder.cpp | 411 + .../recordingengine/qffmpegaudioencoder_p.h | 74 + .../qffmpegaudioencoderutils.cpp | 108 + .../qffmpegaudioencoderutils_p.h | 25 + .../recordingengine/qffmpegencoderoptions.cpp | 365 + .../recordingengine/qffmpegencoderoptions_p.h | 32 + .../recordingengine/qffmpegencoderthread.cpp | 56 + .../recordingengine/qffmpegencoderthread_p.h | 83 + .../qffmpegencodinginitializer.cpp | 165 + .../qffmpegencodinginitializer_p.h | 77 + .../ffmpeg/recordingengine/qffmpegmuxer.cpp | 65 + .../ffmpeg/recordingengine/qffmpegmuxer_p.h | 41 + .../qffmpegrecordingengine.cpp | 332 + .../qffmpegrecordingengine_p.h | 149 + .../qffmpegrecordingengineutils.cpp | 63 + .../qffmpegrecordingengineutils_p.h | 81 + .../recordingengine/qffmpegvideoencoder.cpp | 261 + .../recordingengine/qffmpegvideoencoder_p.h | 65 + .../qffmpegvideoencoderutils.cpp | 237 + .../qffmpegvideoencoderutils_p.h | 68 + .../qffmpegvideoframeencoder.cpp | 661 + .../qffmpegvideoframeencoder_p.h | 128 + .../ffmpeg/symbolstubs/openssl3.ver | 7 + .../symbolstubs/qffmpegsymbols-crypto.cpp | 6 + .../ffmpeg/symbolstubs/qffmpegsymbols-ssl.cpp | 300 + .../symbolstubs/qffmpegsymbols-va-drm.cpp | 14 + .../symbolstubs/qffmpegsymbols-va-x11.cpp | 14 + .../ffmpeg/symbolstubs/qffmpegsymbols-va.cpp | 150 + .../multimedia/ffmpeg/symbolstubs/va.ver | 7 + .../multimedia/gstreamer/CMakeLists.txt | 97 + .../audio/qgstreameraudiodecoder.cpp | 536 + .../audio/qgstreameraudiodecoder_p.h | 115 + .../gstreamer/audio/qgstreameraudiodevice.cpp | 47 + .../gstreamer/audio/qgstreameraudiodevice_p.h | 47 + .../gstreamer/common/qglist_helper_p.h | 91 + .../multimedia/gstreamer/common/qgst.cpp | 1527 ++ .../gstreamer/common/qgst_bus_observer.cpp | 109 + .../gstreamer/common/qgst_bus_observer_p.h | 72 + .../gstreamer/common/qgst_debug.cpp | 675 + .../gstreamer/common/qgst_debug_p.h | 87 + .../gstreamer/common/qgst_discoverer.cpp | 315 + .../gstreamer/common/qgst_discoverer_p.h | 128 + .../gstreamer/common/qgst_handle_types_p.h | 223 + .../multimedia/gstreamer/common/qgst_p.h | 1071 + .../multimedia/gstreamer/common/qgst_play.cpp | 77 + .../multimedia/gstreamer/common/qgst_play_p.h | 86 + .../gstreamer/common/qgstpipeline.cpp | 321 + .../gstreamer/common/qgstpipeline_p.h | 89 + .../gstreamer/common/qgstreameraudioinput.cpp | 148 + .../gstreamer/common/qgstreameraudioinput_p.h | 55 + .../common/qgstreameraudiooutput.cpp | 199 + .../common/qgstreameraudiooutput_p.h | 61 + .../common/qgstreamerbufferprobe.cpp | 88 + .../common/qgstreamerbufferprobe_p.h | 56 + .../common/qgstreamermediaplayer.cpp | 1061 + .../common/qgstreamermediaplayer_p.h | 167 + .../gstreamer/common/qgstreamermessage_p.h | 55 + .../gstreamer/common/qgstreamermetadata.cpp | 569 + .../gstreamer/common/qgstreamermetadata_p.h | 47 + .../common/qgstreamervideooutput.cpp | 196 + .../common/qgstreamervideooutput_p.h | 81 + .../gstreamer/common/qgstreamervideosink.cpp | 315 + .../gstreamer/common/qgstreamervideosink_p.h | 76 + .../gstreamer/common/qgstsubtitlesink.cpp | 160 + .../gstreamer/common/qgstsubtitlesink_p.h | 64 + .../multimedia/gstreamer/common/qgstutils.cpp | 146 + .../multimedia/gstreamer/common/qgstutils_p.h | 44 + .../gstreamer/common/qgstvideobuffer.cpp | 392 + .../gstreamer/common/qgstvideobuffer_p.h | 55 + .../common/qgstvideorenderersink.cpp | 544 + .../common/qgstvideorenderersink_p.h | 202 + .../multimedia/gstreamer/gstreamer.json | 3 + .../mediacapture/qgstreamercamera.cpp | 772 + .../mediacapture/qgstreamercamera_p.h | 170 + .../mediacapture/qgstreamerimagecapture.cpp | 483 + .../mediacapture/qgstreamerimagecapture_p.h | 107 + .../qgstreamermediacapturesession.cpp | 539 + .../qgstreamermediacapturesession_p.h | 117 + .../mediacapture/qgstreamermediarecorder.cpp | 400 + .../mediacapture/qgstreamermediarecorder_p.h | 82 + .../gstreamer/qgstreamerformatinfo.cpp | 461 + .../gstreamer/qgstreamerformatinfo_p.h | 46 + .../gstreamer/qgstreamerintegration.cpp | 258 + .../gstreamer/qgstreamerintegration_p.h | 80 + .../multimedia/gstreamer/qgstreamerplugin.cpp | 28 + .../gstreamer/qgstreamervideodevices.cpp | 239 + .../gstreamer/qgstreamervideodevices_p.h | 59 + .../qgstreamer_qiodevice_handler.cpp | 497 + .../qgstreamer_qiodevice_handler_p.h | 34 + .../uri_handler/qgstreamer_qrc_handler.cpp | 361 + .../uri_handler/qgstreamer_qrc_handler_p.h | 27 + src/plugins/multimedia/qnx/CMakeLists.txt | 39 + .../multimedia/qnx/camera/qqnxcamera.cpp | 820 + .../multimedia/qnx/camera/qqnxcamera_p.h | 201 + .../qnx/camera/qqnxcameraframebuffer.cpp | 299 + .../qnx/camera/qqnxcameraframebuffer_p.h | 60 + .../qnx/camera/qqnxcamerahandle_p.h | 102 + .../qnx/camera/qqnximagecapture.cpp | 257 + .../qnx/camera/qqnximagecapture_p.h | 63 + .../qnx/camera/qqnxplatformcamera.cpp | 426 + .../qnx/camera/qqnxplatformcamera_p.h | 113 + .../qnx/capture/qqnxaudiorecorder.cpp | 284 + .../qnx/capture/qqnxaudiorecorder_p.h | 103 + .../qnx/capture/qqnxmediacapturesession.cpp | 121 + .../qnx/capture/qqnxmediacapturesession_p.h | 67 + .../qnx/capture/qqnxmediarecorder.cpp | 115 + .../qnx/capture/qqnxmediarecorder_p.h | 51 + .../multimedia/qnx/common/mmrenderertypes.h | 95 + .../multimedia/qnx/common/qqnxaudioinput.cpp | 25 + .../multimedia/qnx/common/qqnxaudioinput_p.h | 33 + .../multimedia/qnx/common/qqnxaudiooutput.cpp | 52 + .../multimedia/qnx/common/qqnxaudiooutput_p.h | 39 + .../qnx/common/qqnxmediaeventthread.cpp | 98 + .../qnx/common/qqnxmediaeventthread_p.h | 55 + .../qnx/common/qqnxwindowgrabber.cpp | 435 + .../qnx/common/qqnxwindowgrabber_p.h | 114 + .../qnx/mediaplayer/qqnxmediametadata.cpp | 262 + .../qnx/mediaplayer/qqnxmediametadata_p.h | 74 + .../qnx/mediaplayer/qqnxmediaplayer.cpp | 887 + .../qnx/mediaplayer/qqnxmediaplayer_p.h | 167 + .../qnx/mediaplayer/qqnxmediautil.cpp | 126 + .../qnx/mediaplayer/qqnxmediautil_p.h | 32 + .../qnx/mediaplayer/qqnxvideosink.cpp | 26 + .../qnx/mediaplayer/qqnxvideosink_p.h | 41 + src/plugins/multimedia/qnx/qnx.json | 3 + src/plugins/multimedia/qnx/qqnxformatinfo.cpp | 36 + src/plugins/multimedia/qnx/qqnxformatinfo_p.h | 33 + .../multimedia/qnx/qqnxmediaintegration.cpp | 79 + .../multimedia/qnx/qqnxmediaintegration_p.h | 50 + .../multimedia/qnx/qqnxvideodevices.cpp | 111 + .../multimedia/qnx/qqnxvideodevices_p.h | 32 + src/plugins/multimedia/wasm/CMakeLists.txt | 28 + .../wasm/common/qwasmaudioinput.cpp | 109 + .../wasm/common/qwasmaudioinput_p.h | 57 + .../wasm/common/qwasmaudiooutput.cpp | 378 + .../wasm/common/qwasmaudiooutput_p.h | 98 + .../wasm/common/qwasmvideooutput.cpp | 1055 + .../wasm/common/qwasmvideooutput_p.h | 162 + .../wasm/mediacapture/qwasmcamera.cpp | 491 + .../wasm/mediacapture/qwasmcamera_p.h | 100 + .../wasm/mediacapture/qwasmimagecapture.cpp | 133 + .../wasm/mediacapture/qwasmimagecapture_p.h | 58 + .../mediacapture/qwasmmediacapturesession.cpp | 117 + .../mediacapture/qwasmmediacapturesession_p.h | 73 + .../wasm/mediacapture/qwasmmediarecorder.cpp | 520 + .../wasm/mediacapture/qwasmmediarecorder_p.h | 89 + .../wasm/mediaplayer/qwasmmediaplayer.cpp | 482 + .../wasm/mediaplayer/qwasmmediaplayer_p.h | 125 + .../wasm/mediaplayer/qwasmvideosink.cpp | 26 + .../wasm/mediaplayer/qwasmvideosink_p.h | 40 + .../multimedia/wasm/qwasmmediaintegration.cpp | 104 + .../multimedia/wasm/qwasmmediaintegration_p.h | 49 + src/plugins/multimedia/wasm/wasm.json | 5 + src/plugins/multimedia/windows/CMakeLists.txt | 70 + .../multimedia/windows/common/mfmetadata.cpp | 408 + .../multimedia/windows/common/mfmetadata_p.h | 30 + .../windows/decoder/mfaudiodecodercontrol.cpp | 227 + .../windows/decoder/mfaudiodecodercontrol_p.h | 74 + .../windows/decoder/mfdecodersourcereader.cpp | 72 + .../windows/decoder/mfdecodersourcereader_p.h | 48 + .../decoder/mfdecodersourcereadercallback.cpp | 25 + .../decoder/mfdecodersourcereadercallback_p.h | 43 + .../windows/evr/evrcustompresenter.cpp | 1847 ++ .../windows/evr/evrcustompresenter_p.h | 357 + .../windows/evr/evrd3dpresentengine.cpp | 699 + .../windows/evr/evrd3dpresentengine_p.h | 153 + .../multimedia/windows/evr/evrhelpers.cpp | 140 + .../multimedia/windows/evr/evrhelpers_p.h | 93 + .../windows/evr/evrvideowindowcontrol.cpp | 228 + .../windows/evr/evrvideowindowcontrol_p.h | 72 + .../windows/mediacapture/qwindowscamera.cpp | 101 + .../windows/mediacapture/qwindowscamera_p.h | 55 + .../mediacapture/qwindowsimagecapture.cpp | 207 + .../mediacapture/qwindowsimagecapture_p.h | 64 + .../mediacapture/qwindowsmediacapture.cpp | 109 + .../mediacapture/qwindowsmediacapture_p.h | 62 + .../qwindowsmediadevicereader.cpp | 1019 + .../qwindowsmediadevicereader_p.h | 154 + .../qwindowsmediadevicesession.cpp | 376 + .../qwindowsmediadevicesession_p.h | 100 + .../mediacapture/qwindowsmediaencoder.cpp | 224 + .../mediacapture/qwindowsmediaencoder_p.h | 71 + src/plugins/multimedia/windows/mfstream.cpp | 326 + src/plugins/multimedia/windows/mfstream_p.h | 124 + .../multimedia/windows/player/mfactivate.cpp | 17 + .../multimedia/windows/player/mfactivate_p.h | 202 + .../player/mfevrvideowindowcontrol.cpp | 55 + .../player/mfevrvideowindowcontrol_p.h | 38 + .../windows/player/mfplayercontrol.cpp | 306 + .../windows/player/mfplayercontrol_p.h | 103 + .../windows/player/mfplayersession.cpp | 1736 ++ .../windows/player/mfplayersession_p.h | 240 + .../windows/player/mfvideorenderercontrol.cpp | 148 + .../windows/player/mfvideorenderercontrol_p.h | 48 + .../multimedia/windows/qwindowsformatinfo.cpp | 187 + .../multimedia/windows/qwindowsformatinfo_p.h | 31 + .../windows/qwindowsintegration.cpp | 94 + .../windows/qwindowsintegration_p.h | 55 + .../windows/qwindowsvideodevices.cpp | 224 + .../windows/qwindowsvideodevices_p.h | 46 + .../multimedia/windows/sourceresolver.cpp | 294 + .../multimedia/windows/sourceresolver_p.h | 83 + src/plugins/multimedia/windows/windows.json | 3 + src/resonance-audio/CMakeLists.txt | 242 + src/resonance-audio/resonance_audio.cpp | 42 + src/resonance-audio/resonance_audio.h | 33 + src/spatialaudio/CMakeLists.txt | 28 + src/spatialaudio/doc/qtspatialaudio.qdocconf | 62 + .../doc/src/qtspatialaudio-cpp.qdoc | 33 + .../doc/src/qtspatialaudio-examples.qdoc | 15 + .../doc/src/qtspatialaudio-index.qdoc | 104 + .../doc/src/qtspatialaudio-qml-types.qdoc | 26 + .../doc/src/spatialaudiooverview.qdoc | 64 + src/spatialaudio/qambientsound.cpp | 283 + src/spatialaudio/qambientsound.h | 68 + src/spatialaudio/qambientsound_p.h | 84 + src/spatialaudio/qambisonicdecoder.cpp | 314 + src/spatialaudio/qambisonicdecoder_p.h | 69 + src/spatialaudio/qambisonicdecoderdata_p.h | 279 + src/spatialaudio/qaudioengine.cpp | 603 + src/spatialaudio/qaudioengine.h | 80 + src/spatialaudio/qaudioengine_p.h | 92 + src/spatialaudio/qaudiolistener.cpp | 134 + src/spatialaudio/qaudiolistener.h | 37 + src/spatialaudio/qaudioroom.cpp | 399 + src/spatialaudio/qaudioroom.h | 107 + src/spatialaudio/qaudioroom_p.h | 50 + src/spatialaudio/qspatialsound.cpp | 595 + src/spatialaudio/qspatialsound.h | 127 + src/spatialaudio/qspatialsound_p.h | 62 + src/spatialaudio/qtspatialaudioglobal.h | 10 + src/spatialaudio/qtspatialaudioglobal_p.h | 21 + src/spatialaudioquick3d/CMakeLists.txt | 32 + .../qquick3dambientsound.cpp | 146 + .../qquick3dambientsound_p.h | 74 + .../qquick3daudio-qml-types.qdoc | 32 + .../qquick3daudioengine.cpp | 128 + .../qquick3daudioengine_p.h | 64 + .../qquick3daudiolistener.cpp | 49 + .../qquick3daudiolistener_p.h | 47 + src/spatialaudioquick3d/qquick3daudioroom.cpp | 270 + src/spatialaudioquick3d/qquick3daudioroom_p.h | 129 + .../qquick3dspatialaudio_plugin.cpp | 35 + .../qquick3dspatialsound.cpp | 323 + .../qquick3dspatialsound_p.h | 127 + .../qtquick3daudioglobal_p.h | 28 + .../qtquick3daudiotypes_p.h | 27 + tests/CMakeLists.txt | 10 + tests/auto/CMakeLists.txt | 6 + tests/auto/cmake/CMakeLists.txt | 26 + tests/auto/integration/CMakeLists.txt | 40 + .../auto/integration/backends/CMakeLists.txt | 9 + .../integration/backends/tst_backends.cpp | 62 + .../auto/integration/multiapp/CMakeLists.txt | 21 + .../auto/integration/multiapp/double-drop.wav | Bin 0 -> 20626 bytes .../integration/multiapp/tst_multiapp.cpp | 161 + .../qaudiodecoderbackend/CMakeLists.txt | 26 + .../testdata/test-corrupted.wav | Bin 0 -> 1952 bytes .../testdata/test-no-audio-track.mp4 | Bin 0 -> 1589 bytes .../testdata/test-unsupported.avi | Bin 0 -> 17934 bytes .../qaudiodecoderbackend/testdata/test.wav | Bin 0 -> 88232 bytes .../tst_qaudiodecoderbackend.cpp | 967 + .../qaudiodevicebackend/CMakeLists.txt | 14 + .../tst_qaudiodevicebackend.cpp | 164 + tests/auto/integration/qaudiosink/BLACKLIST | 13 + .../integration/qaudiosink/CMakeLists.txt | 15 + .../integration/qaudiosink/tst_qaudiosink.cpp | 1115 ++ .../integration/qaudiosource/CMakeLists.txt | 22 + .../auto/integration/qaudiosource/Info.plist | 44 + .../qaudiosource/tst_qaudiosource.cpp | 968 + .../auto/integration/qcamerabackend/BLACKLIST | 12 + .../integration/qcamerabackend/CMakeLists.txt | 23 + .../integration/qcamerabackend/Info.plist | 46 + .../qcamerabackend/tst_qcamerabackend.cpp | 849 + .../qmediacapturesession/BLACKLIST | 2 + .../qmediacapturesession/CMakeLists.txt | 23 + .../qmediacapturesession/Info.plist | 46 + .../tst_qmediacapturesession.cpp | 1369 ++ .../qmediaformatbackend/CMakeLists.txt | 10 + .../tst_qmediaformatbackend.cpp | 1115 ++ .../qmediaframeinputsbackend/CMakeLists.txt | 18 + .../tst_qmediaframeinputsbackend.cpp | 463 + .../tst_qmediaframeinputsbackend.h | 43 + .../3colors_with_sound_1s.mp4 | Bin 0 -> 37261 bytes .../qmediaplayer_concurrent/CMakeLists.txt | 13 + .../tst_qmediaplayer_concurrent.cpp | 83 + .../integration/qmediaplayerbackend/BLACKLIST | 20 + .../qmediaplayerbackend/CMakeLists.txt | 34 + .../qmediaplayerbackend/LazyLoad.qml | 52 + .../integration/qmediaplayerbackend/fake.h | 29 + .../integration/qmediaplayerbackend/fixture.h | 98 + .../qmediaplayerbackend/mediaplayerstate.h | 173 + .../integration/qmediaplayerbackend/server.h | 48 + .../qmediaplayerbackend/testdata/15s.mkv | Bin 0 -> 61283 bytes .../testdata/3colors_with_sound_1s.mp4 | Bin 0 -> 37261 bytes .../testdata/BigBuckBunny.mp4 | Bin 0 -> 36724 bytes .../qmediaplayerbackend/testdata/_test.wav | Bin 0 -> 88232 bytes .../audio_video_with_jpg_thumbnail.mp4 | Bin 0 -> 37930 bytes .../audio_video_with_png_thumbnail.mp4 | Bin 0 -> 37436 bytes .../qmediaplayerbackend/testdata/busAv1.webm | Bin 0 -> 16108 bytes .../qmediaplayerbackend/testdata/busMpeg4.mp4 | Bin 0 -> 25954 bytes .../testdata/color_matrix.mp4 | Bin 0 -> 21412 bytes .../color_matrix_180_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...olor_matrix_180_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../color_matrix_270_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...olor_matrix_270_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../color_matrix_90_deg_clockwise.mp4 | Bin 0 -> 21412 bytes ...color_matrix_90_deg_clockwise_mirrored.mp4 | Bin 0 -> 21412 bytes .../testdata/color_matrix_mirrored.mp4 | Bin 0 -> 21412 bytes .../qmediaplayerbackend/testdata/colors.mp4 | Bin 0 -> 26042 bytes .../qmediaplayerbackend/testdata/colors.ogv | Bin 0 -> 12090 bytes .../testdata/corrupt_end.ogg | Bin 0 -> 5946 bytes .../testdata/duration_issues.webm | Bin 0 -> 34940 bytes .../h264_avc1_yuv420p10le_tv_bt2020.mov | Bin 0 -> 20164 bytes .../testdata/invalid_media.m3u | 1 + .../testdata/invalid_media2.m3u | 3 + .../multitrack-subtitle-start-at-zero.mkv | Bin 0 -> 153449 bytes .../testdata/multitrack.mkv | Bin 0 -> 153452 bytes .../qmediaplayerbackend/testdata/nested1.m3u | 4 + .../qmediaplayerbackend/testdata/nested2.m3u | 3 + .../testdata/nokia-tune.mkv | Bin 0 -> 50694 bytes .../testdata/nokia-tune.mp3 | Bin 0 -> 33988 bytes .../testdata/one_red_frame.mp4 | Bin 0 -> 1589 bytes .../qmediaplayerbackend/testdata/par_2_3.mp4 | Bin 0 -> 1656 bytes .../qmediaplayerbackend/testdata/par_3_2.mp4 | Bin 0 -> 1652 bytes .../testdata/recursive.m3u | 2 + .../testdata/recursive_master.m3u | 3 + .../qmediaplayerbackend/testdata/sample.m3u | 4 + .../testdata/subtitletest.mkv | Bin 0 -> 17398 bytes .../qmediaplayerbackend/testdata/test.wav | Bin 0 -> 88232 bytes .../tst_qmediaplayerbackend.cpp | 4686 +++++ .../qmediaplayerformatsupport/CMakeLists.txt | 21 + .../testdata/README.md | 35 + .../containers/supported/container.avi | Bin 0 -> 11284 bytes .../containers/supported/container.mkv | Bin 0 -> 3019 bytes .../containers/supported/container.mp4 | Bin 0 -> 3280 bytes .../containers/supported/container.mpeg | Bin 0 -> 34816 bytes .../containers/supported/container.wmv | Bin 0 -> 29587 bytes .../containers/unsupported/container.webp | Bin 0 -> 2676 bytes .../testdata/flipable.gif | Bin 0 -> 131710 bytes .../pixel_formats/supported/h264_bgr0.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_bgr24.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_gray.mp4 | Bin 0 -> 6289 bytes .../pixel_formats/supported/h264_gray10le.mp4 | Bin 0 -> 6326 bytes .../pixel_formats/supported/h264_nv12.mp4 | Bin 0 -> 7734 bytes .../pixel_formats/supported/h264_nv16.mp4 | Bin 0 -> 8646 bytes .../pixel_formats/supported/h264_nv21.mp4 | Bin 0 -> 7734 bytes .../pixel_formats/supported/h264_rgb24.mp4 | Bin 0 -> 12335 bytes .../pixel_formats/supported/h264_yuv420p.mp4 | Bin 0 -> 7747 bytes .../supported/h264_yuv420p10.mp4 | Bin 0 -> 7699 bytes .../supported/h264_yuv420p10le.mp4 | Bin 0 -> 7699 bytes .../pixel_formats/supported/h264_yuv422p.mp4 | Bin 0 -> 8646 bytes .../supported/h264_yuv422p10.mp4 | Bin 0 -> 8675 bytes .../supported/h264_yuv422p10le.mp4 | Bin 0 -> 8675 bytes .../pixel_formats/supported/h264_yuv444p.mp4 | Bin 0 -> 7575 bytes .../supported/h264_yuv444p10.mp4 | Bin 0 -> 7549 bytes .../pixel_formats/supported/h264_yuvj420p.mp4 | Bin 0 -> 8081 bytes .../pixel_formats/supported/h264_yuvj422p.mp4 | Bin 0 -> 9059 bytes .../pixel_formats/supported/h264_yuvj444p.mp4 | Bin 0 -> 7939 bytes .../tst_qmediaplayerformatsupport.cpp | 123 + .../qmediarecorderbackend/CMakeLists.txt | 10 + .../tst_qmediarecorderbackend.cpp | 508 + tests/auto/integration/qml/CMakeLists.txt | 23 + .../qml/soundeffect/tst_soundeffect.qml | 169 + tests/auto/integration/qml/tst_qml.cpp | 5 + .../qquickvideooutput/CMakeLists.txt | 32 + .../integration/qquickvideooutput/main.qml | 7 + .../tst_qquickvideooutput.cpp | 392 + .../qquickvideooutput_window/CMakeLists.txt | 32 + .../qquickvideooutput_window/main.qml | 13 + .../tst_qquickvideooutput_window.cpp | 96 + .../qscreencapturebackend/BLACKLIST | 11 + .../qscreencapturebackend/CMakeLists.txt | 22 + .../android/AndroidManifest.xml | 57 + .../tst_qscreencapturebackend.cpp | 588 + .../integration/qsoundeffect/CMakeLists.txt | 18 + tests/auto/integration/qsoundeffect/test.wav | Bin 0 -> 38316 bytes .../qsoundeffect/test_corrupted.wav | Bin 0 -> 38316 bytes .../integration/qsoundeffect/test_tone.wav | Bin 0 -> 265388 bytes .../qsoundeffect/tst_qsoundeffect.cpp | 463 + .../qsoundeffect_concurrent/CMakeLists.txt | 12 + .../qsoundeffect_concurrent/double-drop.wav | Bin 0 -> 20626 bytes .../tst_qsoundeffect_concurrent.cpp | 75 + .../qvideoframebackend/CMakeLists.txt | 24 + .../qvideoframebackend/testdata/colors.mp4 | Bin 0 -> 26042 bytes .../testdata/one_red_frame.mp4 | Bin 0 -> 1589 bytes .../tst_qvideoframebackend.cpp | 264 + .../qwindowcapturebackend/BLACKLIST | 11 + .../qwindowcapturebackend/CMakeLists.txt | 23 + .../qwindowcapturebackend/fixture.cpp | 234 + .../qwindowcapturebackend/fixture.h | 147 + .../qwindowcapturebackend/grabber.cpp | 65 + .../qwindowcapturebackend/grabber.h | 43 + .../tst_qwindowcapturebackend.cpp | 271 + .../qwindowcapturebackend/widget.cpp | 125 + .../qwindowcapturebackend/widget.h | 43 + tests/auto/runautotests.py | 173 + tests/auto/unit/CMakeLists.txt | 10 + tests/auto/unit/mockbackend/CMakeLists.txt | 28 + tests/auto/unit/mockbackend/mock.json | 3 + .../unit/mockbackend/qmockaudiodecoder.cpp | 139 + .../auto/unit/mockbackend/qmockaudiodecoder.h | 69 + .../unit/mockbackend/qmockaudiodevices.cpp | 43 + .../auto/unit/mockbackend/qmockaudiodevices.h | 47 + .../auto/unit/mockbackend/qmockaudiooutput.h | 30 + tests/auto/unit/mockbackend/qmockcamera.cpp | 158 + tests/auto/unit/mockbackend/qmockcamera.h | 81 + .../unit/mockbackend/qmockimagecapture.cpp | 59 + .../auto/unit/mockbackend/qmockimagecapture.h | 48 + .../unit/mockbackend/qmockintegration.cpp | 206 + .../auto/unit/mockbackend/qmockintegration.h | 104 + .../mockbackend/qmockmediacapturesession.h | 86 + .../auto/unit/mockbackend/qmockmediaencoder.h | 85 + .../auto/unit/mockbackend/qmockmediaplayer.h | 175 + .../unit/mockbackend/qmocksurfacecapture.h | 88 + .../auto/unit/mockbackend/qmockvideobuffer.h | 38 + tests/auto/unit/mockbackend/qmockvideosink.h | 33 + tests/auto/unit/multimedia/CMakeLists.txt | 47 + .../gstreamer_backend/CMakeLists.txt | 20 + .../color_matrix_90_deg_clockwise.mp4 | Bin 0 -> 21412 bytes .../gstreamer_backend/metadata_test_file.mp4 | Bin 0 -> 29324 bytes .../tst_gstreamer_backend.cpp | 585 + .../gstreamer_backend/tst_gstreamer_backend.h | 63 + .../qabstractvideobuffer/CMakeLists.txt | 14 + .../tst_qabstractvideobuffer.cpp | 101 + .../multimedia/qaudiobuffer/CMakeLists.txt | 13 + .../qaudiobuffer/tst_qaudiobuffer.cpp | 387 + .../multimedia/qaudiodecoder/CMakeLists.txt | 18 + .../qaudiodecoder/tst_qaudiodecoder.cpp | 337 + .../multimedia/qaudiodevice/CMakeLists.txt | 13 + .../qaudiodevice/tst_qaudiodevice.cpp | 107 + .../multimedia/qaudioformat/CMakeLists.txt | 14 + .../qaudioformat/tst_qaudioformat.cpp | 267 + .../multimedia/qaudionamespace/CMakeLists.txt | 14 + .../qaudionamespace/tst_qaudionamespace.cpp | 216 + .../multimedia/qaudiorecorder/CMakeLists.txt | 17 + .../qaudiorecorder/tst_qaudiorecorder.cpp | 87 + .../qaudioringbuffer/CMakeLists.txt | 13 + .../qaudioringbuffer/tst_qaudioringbuffer.cpp | 157 + .../qaudiostatemachine/CMakeLists.txt | 11 + .../tst_qaudiostatemachine.cpp | 664 + .../unit/multimedia/qcamera/CMakeLists.txt | 18 + .../unit/multimedia/qcamera/tst_qcamera.cpp | 847 + .../multimedia/qcameradevice/CMakeLists.txt | 17 + .../qcameradevice/tst_qcameradevice.cpp | 139 + .../unit/multimedia/qerrorinfo/CMakeLists.txt | 9 + .../multimedia/qerrorinfo/tst_qerrorinfo.cpp | 117 + .../multimedia/qimagecapture/CMakeLists.txt | 17 + .../qimagecapture/tst_qimagecapture.cpp | 284 + .../unit/multimedia/qmaybe/CMakeLists.txt | 9 + .../unit/multimedia/qmaybe/tst_qmaybe.cpp | 124 + .../qmediacapture_gstreamer/BLACKLIST | 2 + .../qmediacapture_gstreamer/CMakeLists.txt | 16 + .../tst_qmediacapture_gstreamer.cpp | 212 + .../multimedia/qmediadevices/CMakeLists.txt | 13 + .../qmediadevices/tst_qmediadevices.cpp | 58 + .../multimedia/qmediaformat/CMakeLists.txt | 13 + .../qmediaformat/tst_qmediaformat.cpp | 194 + .../multimedia/qmediametadata/CMakeLists.txt | 13 + .../qmediametadata/tst_qmediametadata.cpp | 96 + .../multimedia/qmediaplayer/CMakeLists.txt | 30 + .../qmediaplayer/testdata/nokia-tune.mp3 | Bin 0 -> 62715 bytes .../qmediaplayer/tst_qmediaplayer.cpp | 876 + .../qmediaplayer_gstreamer/BLACKLIST | 2 + .../qmediaplayer_gstreamer/CMakeLists.txt | 19 + .../testdata/color_matrix.mp4 | Bin 0 -> 21412 bytes .../tst_qmediaplayer_gstreamer.cpp | 162 + .../tst_qmediaplayer_gstreamer.h | 51 + .../multimedia/qmediaplaylist/CMakeLists.txt | 23 + .../qmediaplaylist/testdata/empty.pls | 2 + .../qmediaplaylist/testdata/test.m3u | 11 + .../qmediaplaylist/testdata/test.pls | 27 + .../qmediaplaylist/testdata/testfile | 0 .../qmediaplaylist/testdata/testfile2#suffix | 0 .../testdata/totem-pl-example.pls | 5 + .../qmediaplaylist/tst_qmediaplaylist.cpp | 903 + .../multimedia/qmediarecorder/CMakeLists.txt | 17 + .../qmediarecorder/tst_qmediarecorder.cpp | 540 + .../qmediastoragelocation/CMakeLists.txt | 9 + .../tst_qmediastoragelocation.cpp | 120 + .../multimedia/qmediatimerange/CMakeLists.txt | 14 + .../qmediatimerange/tst_qmediatimerange.cpp | 766 + .../qmultimediautils/CMakeLists.txt | 9 + .../qmultimediautils/tst_qmultimediautils.cpp | 424 + .../multimedia/qrhivaluemapper/CMakeLists.txt | 10 + .../qrhivaluemapper/tst_qrhivaluemapper.cpp | 241 + .../multimedia/qsamplecache/CMakeLists.txt | 22 + .../qsamplecache/testdata/corrupted.wav | Bin 0 -> 864 bytes .../multimedia/qsamplecache/testdata/test.wav | Bin 0 -> 88232 bytes .../qsamplecache/testdata/test2.wav | Bin 0 -> 88232 bytes .../qsamplecache/tst_qsamplecache.cpp | 207 + .../multimedia/qscreencapture/CMakeLists.txt | 17 + .../qscreencapture/tst_qscreencapture.cpp | 64 + .../multimedia/qvideobuffers/CMakeLists.txt | 10 + .../qvideobuffers/tst_qvideobuffers.cpp | 234 + .../multimedia/qvideoframe/CMakeLists.txt | 15 + .../qvideoframe/tst_qvideoframe.cpp | 1468 ++ .../qvideoframe_nogui/CMakeLists.txt | 10 + .../tst_qvideoframe_nogui.cpp | 34 + .../qvideoframecolormanagement/CMakeLists.txt | 20 + .../testdata/umbrellas.jpg | Bin 0 -> 12786 bytes .../umbrellas.jpg_abgr8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_abgr8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_abgr8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_abgr8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_abgr8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_abgr8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_abgr8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_abgr8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_argb8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_argb8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_argb8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_argb8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_argb8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_argb8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_argb8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes ...g_argb8888_premultiplied_adobergb_full.png | Bin 0 -> 41243 bytes ...gb8888_premultiplied_adobergb_full_cpu.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_adobergb_video.png | Bin 0 -> 41243 bytes ...b8888_premultiplied_adobergb_video_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt2020_full.png | Bin 0 -> 41243 bytes ...argb8888_premultiplied_bt2020_full_cpu.png | Bin 0 -> 41243 bytes ...pg_argb8888_premultiplied_bt2020_video.png | Bin 0 -> 41243 bytes ...rgb8888_premultiplied_bt2020_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_argb8888_premultiplied_bt601_full.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_bt601_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt601_video.png | Bin 0 -> 41243 bytes ...argb8888_premultiplied_bt601_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_argb8888_premultiplied_bt709_full.png | Bin 0 -> 41243 bytes ..._argb8888_premultiplied_bt709_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_argb8888_premultiplied_bt709_video.png | Bin 0 -> 41243 bytes ...argb8888_premultiplied_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_bgra8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_bgra8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgra8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_bgra8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgra8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgra8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgra8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes ...g_bgra8888_premultiplied_adobergb_full.png | Bin 0 -> 41243 bytes ...ra8888_premultiplied_adobergb_full_cpu.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_adobergb_video.png | Bin 0 -> 41243 bytes ...a8888_premultiplied_adobergb_video_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt2020_full.png | Bin 0 -> 41243 bytes ...bgra8888_premultiplied_bt2020_full_cpu.png | Bin 0 -> 41243 bytes ...pg_bgra8888_premultiplied_bt2020_video.png | Bin 0 -> 41243 bytes ...gra8888_premultiplied_bt2020_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_bgra8888_premultiplied_bt601_full.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_bt601_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt601_video.png | Bin 0 -> 41243 bytes ...bgra8888_premultiplied_bt601_video_cpu.png | Bin 0 -> 41243 bytes ....jpg_bgra8888_premultiplied_bt709_full.png | Bin 0 -> 41243 bytes ..._bgra8888_premultiplied_bt709_full_cpu.png | Bin 0 -> 41243 bytes ...jpg_bgra8888_premultiplied_bt709_video.png | Bin 0 -> 41243 bytes ...bgra8888_premultiplied_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_bgrx8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_bgrx8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgrx8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_bgrx8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgrx8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_bgrx8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_bgrx8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_bgrx8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_imc1_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc1_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc1_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc1_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc1_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc1_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc1_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_imc1_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc1_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_imc1_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc1_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_imc1_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc1_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_imc1_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc1_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_imc1_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc2_adobergb_full.png | Bin 0 -> 40934 bytes .../umbrellas.jpg_imc2_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc2_adobergb_video.png | Bin 0 -> 40934 bytes .../umbrellas.jpg_imc2_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc2_bt2020_full.png | Bin 0 -> 40912 bytes .../umbrellas.jpg_imc2_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc2_bt2020_video.png | Bin 0 -> 41004 bytes .../umbrellas.jpg_imc2_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc2_bt601_full.png | Bin 0 -> 40870 bytes .../umbrellas.jpg_imc2_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc2_bt601_video.png | Bin 0 -> 40924 bytes .../umbrellas.jpg_imc2_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc2_bt709_full.png | Bin 0 -> 40966 bytes .../umbrellas.jpg_imc2_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc2_bt709_video.png | Bin 0 -> 40975 bytes .../umbrellas.jpg_imc2_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc3_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc3_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc3_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_imc3_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc3_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc3_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc3_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_imc3_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc3_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_imc3_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc3_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_imc3_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc3_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_imc3_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc3_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_imc3_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_imc4_adobergb_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc4_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc4_adobergb_video.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_imc4_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_imc4_bt2020_full.png | Bin 0 -> 40912 bytes .../umbrellas.jpg_imc4_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_imc4_bt2020_video.png | Bin 0 -> 40987 bytes .../umbrellas.jpg_imc4_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_imc4_bt601_full.png | Bin 0 -> 40877 bytes .../umbrellas.jpg_imc4_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc4_bt601_video.png | Bin 0 -> 40918 bytes .../umbrellas.jpg_imc4_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_imc4_bt709_full.png | Bin 0 -> 40967 bytes .../umbrellas.jpg_imc4_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_imc4_bt709_video.png | Bin 0 -> 40961 bytes .../umbrellas.jpg_imc4_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_nv12_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv12_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv12_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv12_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv12_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_nv12_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_nv12_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_nv12_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_nv12_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_nv12_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv12_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_nv12_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_nv12_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_nv12_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv12_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_nv12_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_nv21_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv21_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv21_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_nv21_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_nv21_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_nv21_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_nv21_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_nv21_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_nv21_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_nv21_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv21_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_nv21_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_nv21_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_nv21_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_nv21_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_nv21_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_p010_adobergb_full.png | Bin 0 -> 40927 bytes .../umbrellas.jpg_p010_adobergb_full_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_adobergb_video.png | Bin 0 -> 40927 bytes .../umbrellas.jpg_p010_adobergb_video_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_bt2020_full.png | Bin 0 -> 40923 bytes .../umbrellas.jpg_p010_bt2020_full_cpu.png | Bin 0 -> 35936 bytes .../umbrellas.jpg_p010_bt2020_video.png | Bin 0 -> 40964 bytes .../umbrellas.jpg_p010_bt2020_video_cpu.png | Bin 0 -> 35927 bytes .../umbrellas.jpg_p010_bt601_full.png | Bin 0 -> 40897 bytes .../umbrellas.jpg_p010_bt601_full_cpu.png | Bin 0 -> 35887 bytes .../umbrellas.jpg_p010_bt601_video.png | Bin 0 -> 40914 bytes .../umbrellas.jpg_p010_bt601_video_cpu.png | Bin 0 -> 35881 bytes .../umbrellas.jpg_p010_bt709_full.png | Bin 0 -> 40936 bytes .../umbrellas.jpg_p010_bt709_full_cpu.png | Bin 0 -> 35887 bytes .../umbrellas.jpg_p010_bt709_video.png | Bin 0 -> 40991 bytes .../umbrellas.jpg_p010_bt709_video_cpu.png | Bin 0 -> 35933 bytes .../umbrellas.jpg_p016_adobergb_full.png | Bin 0 -> 40913 bytes .../umbrellas.jpg_p016_adobergb_full_cpu.png | Bin 0 -> 35941 bytes .../umbrellas.jpg_p016_adobergb_video.png | Bin 0 -> 40913 bytes .../umbrellas.jpg_p016_adobergb_video_cpu.png | Bin 0 -> 35941 bytes .../umbrellas.jpg_p016_bt2020_full.png | Bin 0 -> 40969 bytes .../umbrellas.jpg_p016_bt2020_full_cpu.png | Bin 0 -> 35925 bytes .../umbrellas.jpg_p016_bt2020_video.png | Bin 0 -> 40951 bytes .../umbrellas.jpg_p016_bt2020_video_cpu.png | Bin 0 -> 35968 bytes .../umbrellas.jpg_p016_bt601_full.png | Bin 0 -> 40860 bytes .../umbrellas.jpg_p016_bt601_full_cpu.png | Bin 0 -> 35857 bytes .../umbrellas.jpg_p016_bt601_video.png | Bin 0 -> 40946 bytes .../umbrellas.jpg_p016_bt601_video_cpu.png | Bin 0 -> 35908 bytes .../umbrellas.jpg_p016_bt709_full.png | Bin 0 -> 40942 bytes .../umbrellas.jpg_p016_bt709_full_cpu.png | Bin 0 -> 35857 bytes .../umbrellas.jpg_p016_bt709_video.png | Bin 0 -> 40966 bytes .../umbrellas.jpg_p016_bt709_video_cpu.png | Bin 0 -> 35945 bytes .../umbrellas.jpg_rgba8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_rgba8888_adobergb_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_rgba8888_adobergb_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgba8888_bt2020_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_rgba8888_bt2020_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgba8888_bt601_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_full_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgba8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgba8888_bt709_video_cpu.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_rgbx8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_rgbx8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgbx8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_rgbx8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgbx8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_rgbx8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_rgbx8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_rgbx8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_uyvy_adobergb_full.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_uyvy_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_uyvy_adobergb_video.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_uyvy_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_uyvy_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_uyvy_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_uyvy_bt2020_video.png | Bin 0 -> 41199 bytes .../umbrellas.jpg_uyvy_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_uyvy_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_uyvy_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_uyvy_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_uyvy_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_uyvy_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_uyvy_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_uyvy_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_uyvy_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_xbgr8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_xbgr8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_xbgr8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xbgr8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_xbgr8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xbgr8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xbgr8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xbgr8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xbgr8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xbgr8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_adobergb_full.png | Bin 0 -> 41243 bytes ...brellas.jpg_xrgb8888_adobergb_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_adobergb_video.png | Bin 0 -> 41243 bytes ...rellas.jpg_xrgb8888_adobergb_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt2020_full.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xrgb8888_bt2020_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt2020_video.png | Bin 0 -> 41243 bytes ...mbrellas.jpg_xrgb8888_bt2020_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt601_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xrgb8888_bt601_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt601_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xrgb8888_bt601_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt709_full.png | Bin 0 -> 41243 bytes .../umbrellas.jpg_xrgb8888_bt709_full_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_xrgb8888_bt709_video.png | Bin 0 -> 41243 bytes ...umbrellas.jpg_xrgb8888_bt709_video_cpu.png | Bin 0 -> 36154 bytes .../umbrellas.jpg_y16_adobergb_full.png | Bin 0 -> 25240 bytes .../umbrellas.jpg_y16_adobergb_full_cpu.png | Bin 0 -> 23434 bytes .../umbrellas.jpg_y16_adobergb_video.png | Bin 0 -> 25240 bytes .../umbrellas.jpg_y16_adobergb_video_cpu.png | Bin 0 -> 23434 bytes .../umbrellas.jpg_y16_bt2020_full.png | Bin 0 -> 25544 bytes .../umbrellas.jpg_y16_bt2020_full_cpu.png | Bin 0 -> 23596 bytes .../umbrellas.jpg_y16_bt2020_video.png | Bin 0 -> 24030 bytes .../umbrellas.jpg_y16_bt2020_video_cpu.png | Bin 0 -> 22241 bytes .../testdata/umbrellas.jpg_y16_bt601_full.png | Bin 0 -> 25557 bytes .../umbrellas.jpg_y16_bt601_full_cpu.png | Bin 0 -> 23545 bytes .../umbrellas.jpg_y16_bt601_video.png | Bin 0 -> 23884 bytes .../umbrellas.jpg_y16_bt601_video_cpu.png | Bin 0 -> 22208 bytes .../testdata/umbrellas.jpg_y16_bt709_full.png | Bin 0 -> 25557 bytes .../umbrellas.jpg_y16_bt709_full_cpu.png | Bin 0 -> 23545 bytes .../umbrellas.jpg_y16_bt709_video.png | Bin 0 -> 24021 bytes .../umbrellas.jpg_y16_bt709_video_cpu.png | Bin 0 -> 22392 bytes .../umbrellas.jpg_y8_adobergb_full.png | Bin 0 -> 25364 bytes .../umbrellas.jpg_y8_adobergb_full_cpu.png | Bin 0 -> 23481 bytes .../umbrellas.jpg_y8_adobergb_video.png | Bin 0 -> 25364 bytes .../umbrellas.jpg_y8_adobergb_video_cpu.png | Bin 0 -> 23481 bytes .../testdata/umbrellas.jpg_y8_bt2020_full.png | Bin 0 -> 25430 bytes .../umbrellas.jpg_y8_bt2020_full_cpu.png | Bin 0 -> 23425 bytes .../umbrellas.jpg_y8_bt2020_video.png | Bin 0 -> 23981 bytes .../umbrellas.jpg_y8_bt2020_video_cpu.png | Bin 0 -> 22350 bytes .../testdata/umbrellas.jpg_y8_bt601_full.png | Bin 0 -> 25497 bytes .../umbrellas.jpg_y8_bt601_full_cpu.png | Bin 0 -> 23568 bytes .../testdata/umbrellas.jpg_y8_bt601_video.png | Bin 0 -> 23904 bytes .../umbrellas.jpg_y8_bt601_video_cpu.png | Bin 0 -> 22203 bytes .../testdata/umbrellas.jpg_y8_bt709_full.png | Bin 0 -> 25497 bytes .../umbrellas.jpg_y8_bt709_full_cpu.png | Bin 0 -> 23568 bytes .../testdata/umbrellas.jpg_y8_bt709_video.png | Bin 0 -> 23979 bytes .../umbrellas.jpg_y8_bt709_video_cpu.png | Bin 0 -> 22331 bytes .../umbrellas.jpg_yuv420p10_adobergb_full.png | Bin 0 -> 40919 bytes ...umbrellas.jpg_yuv420p10_adobergb_video.png | Bin 0 -> 40919 bytes .../umbrellas.jpg_yuv420p10_bt2020_full.png | Bin 0 -> 40952 bytes .../umbrellas.jpg_yuv420p10_bt2020_video.png | Bin 0 -> 40967 bytes .../umbrellas.jpg_yuv420p10_bt601_full.png | Bin 0 -> 40881 bytes .../umbrellas.jpg_yuv420p10_bt601_video.png | Bin 0 -> 40962 bytes .../umbrellas.jpg_yuv420p10_bt709_full.png | Bin 0 -> 40954 bytes .../umbrellas.jpg_yuv420p10_bt709_video.png | Bin 0 -> 40987 bytes .../umbrellas.jpg_yuv420p_adobergb_full.png | Bin 0 -> 40898 bytes ...mbrellas.jpg_yuv420p_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yuv420p_adobergb_video.png | Bin 0 -> 40898 bytes ...brellas.jpg_yuv420p_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yuv420p_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_yuv420p_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_yuv420p_bt2020_video.png | Bin 0 -> 40978 bytes ...umbrellas.jpg_yuv420p_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_yuv420p_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_yuv420p_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yuv420p_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_yuv420p_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_yuv420p_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_yuv420p_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yuv420p_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_yuv420p_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../umbrellas.jpg_yuv422p_adobergb_full.png | Bin 0 -> 41163 bytes ...mbrellas.jpg_yuv422p_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuv422p_adobergb_video.png | Bin 0 -> 41163 bytes ...brellas.jpg_yuv422p_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuv422p_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_yuv422p_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_yuv422p_bt2020_video.png | Bin 0 -> 41199 bytes ...umbrellas.jpg_yuv422p_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_yuv422p_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_yuv422p_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuv422p_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_yuv422p_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_yuv422p_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_yuv422p_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuv422p_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_yuv422p_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_yuyv_adobergb_full.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_yuyv_adobergb_full_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuyv_adobergb_video.png | Bin 0 -> 41163 bytes .../umbrellas.jpg_yuyv_adobergb_video_cpu.png | Bin 0 -> 36094 bytes .../umbrellas.jpg_yuyv_bt2020_full.png | Bin 0 -> 41160 bytes .../umbrellas.jpg_yuyv_bt2020_full_cpu.png | Bin 0 -> 36087 bytes .../umbrellas.jpg_yuyv_bt2020_video.png | Bin 0 -> 41199 bytes .../umbrellas.jpg_yuyv_bt2020_video_cpu.png | Bin 0 -> 36215 bytes .../umbrellas.jpg_yuyv_bt601_full.png | Bin 0 -> 41000 bytes .../umbrellas.jpg_yuyv_bt601_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuyv_bt601_video.png | Bin 0 -> 41177 bytes .../umbrellas.jpg_yuyv_bt601_video_cpu.png | Bin 0 -> 36258 bytes .../umbrellas.jpg_yuyv_bt709_full.png | Bin 0 -> 41183 bytes .../umbrellas.jpg_yuyv_bt709_full_cpu.png | Bin 0 -> 36021 bytes .../umbrellas.jpg_yuyv_bt709_video.png | Bin 0 -> 41209 bytes .../umbrellas.jpg_yuyv_bt709_video_cpu.png | Bin 0 -> 36189 bytes .../umbrellas.jpg_yv12_adobergb_full.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_yv12_adobergb_full_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yv12_adobergb_video.png | Bin 0 -> 40898 bytes .../umbrellas.jpg_yv12_adobergb_video_cpu.png | Bin 0 -> 35874 bytes .../umbrellas.jpg_yv12_bt2020_full.png | Bin 0 -> 40908 bytes .../umbrellas.jpg_yv12_bt2020_full_cpu.png | Bin 0 -> 35882 bytes .../umbrellas.jpg_yv12_bt2020_video.png | Bin 0 -> 40978 bytes .../umbrellas.jpg_yv12_bt2020_video_cpu.png | Bin 0 -> 35946 bytes .../umbrellas.jpg_yv12_bt601_full.png | Bin 0 -> 40854 bytes .../umbrellas.jpg_yv12_bt601_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yv12_bt601_video.png | Bin 0 -> 40904 bytes .../umbrellas.jpg_yv12_bt601_video_cpu.png | Bin 0 -> 35900 bytes .../umbrellas.jpg_yv12_bt709_full.png | Bin 0 -> 40945 bytes .../umbrellas.jpg_yv12_bt709_full_cpu.png | Bin 0 -> 35877 bytes .../umbrellas.jpg_yv12_bt709_video.png | Bin 0 -> 40959 bytes .../umbrellas.jpg_yv12_bt709_video_cpu.png | Bin 0 -> 35898 bytes .../tst_qvideoframecolormanagement.cpp | 458 + .../qvideoframeformat/CMakeLists.txt | 14 + .../tst_qvideoframeformat.cpp | 567 + .../qvideotexturehelper/CMakeLists.txt | 10 + .../tst_qvideotexturehelper.cpp | 260 + .../qvideotransformation/CMakeLists.txt | 9 + .../tst_qvideotransformation.cpp | 245 + .../multimedia/qwavedecoder/CMakeLists.txt | 30 + .../data/corrupt_datadesc_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../data/corrupt_fmtdesc_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../data/corrupt_fmtstring_1_16_8000.le.wav | Bin 0 -> 4044 bytes .../multimedia/qwavedecoder/data/empty.wav | 0 .../multimedia/qwavedecoder/data/gendata.sh | 30 + .../data/isawav_1_16_44100_le.wav | Bin 0 -> 22094 bytes .../data/isawav_1_16_44100_le_2.wav | Bin 0 -> 22096 bytes .../qwavedecoder/data/isawav_1_16_8000_le.wav | Bin 0 -> 4044 bytes .../data/isawav_1_24_44100_le.wav | Bin 0 -> 33156 bytes .../qwavedecoder/data/isawav_1_24_8000_le.wav | Bin 0 -> 6080 bytes .../data/isawav_1_32_44100_le.wav | Bin 0 -> 44180 bytes .../qwavedecoder/data/isawav_1_32_8000_le.wav | Bin 0 -> 8080 bytes .../qwavedecoder/data/isawav_1_8_44100.wav | Bin 0 -> 11070 bytes .../qwavedecoder/data/isawav_1_8_8000.wav | Bin 0 -> 2044 bytes .../data/isawav_1_8_8000_even_bext.wav | Bin 0 -> 2064 bytes .../data/isawav_1_8_8000_odd_bext.wav | Bin 0 -> 2064 bytes .../data/isawav_1_f32_44100_le.wav | Bin 0 -> 44158 bytes .../data/isawav_1_f32_8000_le.wav | Bin 0 -> 8058 bytes .../data/isawav_2_16_44100_be.wav | Bin 0 -> 44144 bytes .../qwavedecoder/data/isawav_2_16_8000_be.wav | Bin 0 -> 8044 bytes .../data/isawav_2_24_44100_be.wav | Bin 0 -> 66230 bytes .../qwavedecoder/data/isawav_2_24_8000_be.wav | Bin 0 -> 12080 bytes .../data/isawav_2_32_44100_be.wav | Bin 0 -> 88280 bytes .../qwavedecoder/data/isawav_2_32_8000_be.wav | Bin 0 -> 16080 bytes .../qwavedecoder/data/isawav_2_8_44100.wav | Bin 0 -> 22094 bytes .../qwavedecoder/data/isawav_2_8_8000.wav | Bin 0 -> 4044 bytes .../data/isawav_2_f32_44100_be.wav | Bin 0 -> 88258 bytes .../data/isawav_2_f32_8000_be.wav | Bin 0 -> 16058 bytes .../qwavedecoder/data/nosampledata.wav | Bin 0 -> 44 bytes .../multimedia/qwavedecoder/data/notawav.wav | 1 + .../multimedia/qwavedecoder/data/onebyte.wav | 1 + .../qwavedecoder/tst_qwavedecoder.cpp | 322 + .../unit/multimediawidgets/CMakeLists.txt | 13 + .../qcamerawidgets/CMakeLists.txt | 19 + .../qcamerawidgets/tst_qcamerawidgets.cpp | 114 + .../qgraphicsvideoitem/CMakeLists.txt | 19 + .../tst_qgraphicsvideoitem.cpp | 389 + .../qmediaplayerwidgets/CMakeLists.txt | 19 + .../tst_qmediaplayerwidgets.cpp | 107 + .../qvideowidget/CMakeLists.txt | 20 + .../qvideowidget/tst_qvideowidget.cpp | 271 + tests/global/global.cfg | 6 + tests/manual/CMakeLists.txt | 29 + tests/manual/audiodecoder/CMakeLists.txt | 47 + tests/manual/audiodecoder/audiodecoder.cpp | 161 + tests/manual/audiodecoder/audiodecoder.h | 55 + tests/manual/audiodecoder/audiodecoder.pro | 13 + tests/manual/audiodecoder/main.cpp | 83 + tests/manual/devices/CMakeLists.txt | 42 + tests/manual/devices/devices.pro | 12 + tests/manual/devices/main.cpp | 140 + .../CMakeLists.txt | 41 + .../gstreamer-custom-camera-rtp/Info.plist.in | 46 + .../gstreamer-custom-camera-rtp.cpp | 57 + .../gstreamer-custom-camera/CMakeLists.txt | 39 + .../gstreamer-custom-camera/Info.plist.in | 46 + .../gstreamer-custom-camera.cpp | 50 + tests/manual/media-metadata/CMakeLists.txt | 36 + tests/manual/media-metadata/Info.plist.in | 38 + .../manual/media-metadata/media-metadata.cpp | 110 + tests/manual/mediaformats/CMakeLists.txt | 39 + tests/manual/mediaformats/main.cpp | 87 + tests/manual/mediaframeinputs/CMakeLists.txt | 40 + .../mediaframeinputs/commandlineparser.cpp | 390 + .../mediaframeinputs/commandlineparser.h | 164 + tests/manual/mediaframeinputs/main.cpp | 41 + .../mediaframeinputs/mediaframeinputqueue.h | 65 + .../mediaframeinputs/mediagenerator.cpp | 178 + .../manual/mediaframeinputs/mediagenerator.h | 59 + .../manual/mediaframeinputs/previewrunner.cpp | 67 + tests/manual/mediaframeinputs/previewrunner.h | 38 + .../mediaframeinputs/pushmodemediasource.h | 47 + .../mediaframeinputs/recordingrunner.cpp | 154 + .../manual/mediaframeinputs/recordingrunner.h | 91 + tests/manual/mediaframeinputs/settings.h | 67 + .../minimal-audio-recorder/CMakeLists.txt | 37 + .../minimal-audio-recorder/info.plist.in | 46 + .../minimal-audio-recorder.cpp | 114 + tests/manual/minimal-player/CMakeLists.txt | 37 + tests/manual/minimal-player/Info.plist.in | 46 + .../manual/minimal-player/minimal-player.cpp | 139 + .../minimal-screen-recorder/CMakeLists.txt | 39 + .../minimal-screen-recorder/Info.plist.in | 46 + .../minimal-screen-recorder.cpp | 75 + .../qml-gstreamer-pipeline/CMakeLists.txt | 44 + .../qml-gstreamer-pipeline/Info.plist.in | 46 + .../qml-gstreamer-pipeline.cpp | 20 + .../qml-gstreamer-pipeline.qml | 50 + tests/manual/qml-gstreamer-rtp/CMakeLists.txt | 44 + tests/manual/qml-gstreamer-rtp/Info.plist.in | 46 + .../qml-gstreamer-rtp/qml-gstreamer-rtp.cpp | 32 + .../qml-gstreamer-rtp/qml-gstreamer-rtp.qml | 29 + .../qml-minimal-audio-recorder/CMakeLists.txt | 44 + .../qml-minimal-audio-recorder/Info.plist.in | 46 + .../qml-minimal-audio-recorder.cpp | 17 + .../qml-minimal-audio-recorder.qml | 107 + .../manual/qml-minimal-camera/CMakeLists.txt | 44 + tests/manual/qml-minimal-camera/Info.plist.in | 46 + .../qml-minimal-camera/qml-minimal-camera.cpp | 17 + .../qml-minimal-camera/qml-minimal-camera.qml | 34 + .../manual/qml-minimal-player/CMakeLists.txt | 44 + tests/manual/qml-minimal-player/Info.plist.in | 46 + .../qml-minimal-player/qml-minimal-player.cpp | 17 + .../qml-minimal-player/qml-minimal-player.qml | 42 + .../qml-minimal-sound-effect/CMakeLists.txt | 56 + .../qml-minimal-sound-effect/Info.plist.in | 46 + .../qml-minimal-sound-effect/double-drop.wav | Bin 0 -> 20452 bytes .../qml-minimal-sound-effect.cpp | 17 + .../qml-minimal-sound-effect.qml | 92 + .../qml-minimal-sound-effect/triple-click.wav | Bin 0 -> 21256 bytes tests/manual/wasm/CMakeLists.txt | 6 + tests/manual/wasm/camera/CMakeLists.txt | 44 + tests/manual/wasm/camera/camera-test.pro | 69 + tests/manual/wasm/camera/main.cpp | 17 + tests/manual/wasm/camera/mainwindow.cpp | 261 + tests/manual/wasm/camera/mainwindow.h | 53 + tests/manual/wasm/camera/mainwindow.ui | 107 + util/REUSE.toml | 8 + util/adt_generate_qt.m | 165 + util/macos_test_audio_config/CMakeLists.txt | 13 + util/macos_test_audio_config/README | 25 + .../compile_and_run.sh | 19 + util/macos_test_audio_config/main.cpp | 498 + 2635 files changed, 395919 insertions(+) create mode 100644 .QT-ENTERPRISE-LICENSE-AGREEMENT create mode 100644 .cmake.conf create mode 100644 .tag create mode 100644 CMakeLists.txt create mode 100644 LICENSES/Apache-2.0.txt create mode 100644 LICENSES/BSD-3-Clause.txt create mode 100644 LICENSES/GFDL-1.3-no-invariants-only.txt create mode 100644 LICENSES/GPL-2.0-only.txt create mode 100644 LICENSES/GPL-3.0-only.txt create mode 100644 LICENSES/LGPL-3.0-only.txt create mode 100644 LICENSES/LicenseRef-Qt-Commercial.txt create mode 100644 LICENSES/MPL-2.0.txt create mode 100644 LICENSES/Qt-GPL-exception-1.0.txt create mode 100644 REUSE.toml create mode 100644 cmake/FindAVFoundation.cmake create mode 100644 cmake/FindFFmpeg.cmake create mode 100644 cmake/FindGObject.cmake create mode 100644 cmake/FindGStreamer.cmake create mode 100644 cmake/FindMMRenderer.cmake create mode 100644 cmake/FindMMRendererCore.cmake create mode 100644 cmake/FindPipeWire.cmake create mode 100644 cmake/FindVAAPI.cmake create mode 100644 cmake/FindWMF.cmake create mode 100644 cmake/FindWrapPulseAudio.cmake create mode 100644 cmake/REUSE.toml create mode 100644 coin/axivion/ci_config_linux.json create mode 100644 coin/instructions/run_ffmpeg_backend_tests.yaml create mode 100644 coin/instructions/run_gstreamer_backend_tests.yaml create mode 100644 coin/module_config.yaml create mode 100644 config.tests/evr/CMakeLists.txt create mode 100644 config.tests/evr/main.cpp create mode 100644 config.tests/gpu_vivante/CMakeLists.txt create mode 100644 config.tests/gpu_vivante/main.cpp create mode 100644 config.tests/linux_v4l/CMakeLists.txt create mode 100644 config.tests/linux_v4l/main.cpp create mode 100644 config.tests/wmsdk/CMakeLists.txt create mode 100644 config.tests/wmsdk/main.cpp create mode 100644 config_help.txt create mode 100644 configure.cmake create mode 100644 dependencies.yaml create mode 100644 dist/REUSE.toml create mode 100644 dist/changes-5.0.1 create mode 100644 dist/changes-5.0.2 create mode 100644 dist/changes-5.1.0 create mode 100644 dist/changes-5.1.1 create mode 100644 dist/changes-5.10.0 create mode 100644 dist/changes-5.10.1 create mode 100644 dist/changes-5.11.0 create mode 100644 dist/changes-5.11.1 create mode 100644 dist/changes-5.11.2 create mode 100644 dist/changes-5.11.3 create mode 100644 dist/changes-5.12.0 create mode 100644 dist/changes-5.12.1 create mode 100644 dist/changes-5.12.2 create mode 100644 dist/changes-5.12.3 create mode 100644 dist/changes-5.12.4 create mode 100644 dist/changes-5.12.5 create mode 100644 dist/changes-5.13.0 create mode 100644 dist/changes-5.13.1 create mode 100644 dist/changes-5.13.2 create mode 100644 dist/changes-5.14.0 create mode 100644 dist/changes-5.14.1 create mode 100644 dist/changes-5.14.2 create mode 100644 dist/changes-5.15.0 create mode 100644 dist/changes-5.15.1 create mode 100644 dist/changes-5.15.2 create mode 100644 dist/changes-5.2.0 create mode 100644 dist/changes-5.2.1 create mode 100644 dist/changes-5.3.1 create mode 100644 dist/changes-5.3.2 create mode 100644 dist/changes-5.4.0 create mode 100644 dist/changes-5.4.1 create mode 100644 dist/changes-5.4.2 create mode 100644 dist/changes-5.5.0 create mode 100644 dist/changes-5.5.1 create mode 100644 dist/changes-5.6.0 create mode 100644 dist/changes-5.6.1 create mode 100644 dist/changes-5.6.2 create mode 100644 dist/changes-5.6.3 create mode 100644 dist/changes-5.7.0 create mode 100644 dist/changes-5.7.1 create mode 100644 dist/changes-5.8.0 create mode 100644 dist/changes-5.9.0 create mode 100644 dist/changes-5.9.1 create mode 100644 dist/changes-5.9.2 create mode 100644 dist/changes-5.9.3 create mode 100644 dist/changes-5.9.4 create mode 100644 dist/changes-5.9.5 create mode 100644 dist/changes-5.9.6 create mode 100644 examples/CMakeLists.txt create mode 100644 examples/examples.pro create mode 100644 examples/multimedia/CMakeLists.txt create mode 100644 examples/multimedia/audiodevices/CMakeLists.txt create mode 100644 examples/multimedia/audiodevices/Info.plist.in create mode 100644 examples/multimedia/audiodevices/audiodevices.cpp create mode 100644 examples/multimedia/audiodevices/audiodevices.h create mode 100644 examples/multimedia/audiodevices/audiodevices.pro create mode 100644 examples/multimedia/audiodevices/audiodevicesbase.ui create mode 100644 examples/multimedia/audiodevices/doc/images/audiodevices.png create mode 100644 examples/multimedia/audiodevices/doc/src/audiodevices.qdoc create mode 100644 examples/multimedia/audiodevices/main.cpp create mode 100644 examples/multimedia/audiooutput/CMakeLists.txt create mode 100644 examples/multimedia/audiooutput/audiooutput.cpp create mode 100644 examples/multimedia/audiooutput/audiooutput.h create mode 100644 examples/multimedia/audiooutput/audiooutput.pro create mode 100644 examples/multimedia/audiooutput/doc/images/audiooutput-example.png create mode 100644 examples/multimedia/audiooutput/doc/src/audiooutput.qdoc create mode 100644 examples/multimedia/audiooutput/main.cpp create mode 100644 examples/multimedia/audiorecorder/CMakeLists.txt create mode 100644 examples/multimedia/audiorecorder/Info.plist.in create mode 100644 examples/multimedia/audiorecorder/audiolevel.cpp create mode 100644 examples/multimedia/audiorecorder/audiolevel.h create mode 100644 examples/multimedia/audiorecorder/audiorecorder.cpp create mode 100644 examples/multimedia/audiorecorder/audiorecorder.h create mode 100644 examples/multimedia/audiorecorder/audiorecorder.pro create mode 100644 examples/multimedia/audiorecorder/audiorecorder.ui create mode 100644 examples/multimedia/audiorecorder/doc/images/audiorecorder.png create mode 100644 examples/multimedia/audiorecorder/doc/src/audiorecorder.qdoc create mode 100644 examples/multimedia/audiorecorder/main.cpp create mode 100644 examples/multimedia/audiosource/CMakeLists.txt create mode 100644 examples/multimedia/audiosource/Info.plist.in create mode 100644 examples/multimedia/audiosource/audiosource.cpp create mode 100644 examples/multimedia/audiosource/audiosource.h create mode 100644 examples/multimedia/audiosource/audiosource.pro create mode 100644 examples/multimedia/audiosource/doc/images/audiosource-example.png create mode 100644 examples/multimedia/audiosource/doc/src/audiosource.qdoc create mode 100644 examples/multimedia/audiosource/main.cpp create mode 100644 examples/multimedia/camera/CMakeLists.txt create mode 100644 examples/multimedia/camera/android/AndroidManifest.xml create mode 100644 examples/multimedia/camera/camera.cpp create mode 100644 examples/multimedia/camera/camera.h create mode 100644 examples/multimedia/camera/camera.pro create mode 100644 examples/multimedia/camera/camera.qrc create mode 100644 examples/multimedia/camera/camera.ui create mode 100644 examples/multimedia/camera/camera_mobile.ui create mode 100644 examples/multimedia/camera/doc/images/camera-example.png create mode 100644 examples/multimedia/camera/doc/src/camera.qdoc create mode 100644 examples/multimedia/camera/images/shutter.svg create mode 100644 examples/multimedia/camera/imagesettings.cpp create mode 100644 examples/multimedia/camera/imagesettings.h create mode 100644 examples/multimedia/camera/imagesettings.ui create mode 100644 examples/multimedia/camera/ios/Info.plist.in create mode 100644 examples/multimedia/camera/macos/Info.plist.in create mode 100644 examples/multimedia/camera/main.cpp create mode 100644 examples/multimedia/camera/metadatadialog.cpp create mode 100644 examples/multimedia/camera/metadatadialog.h create mode 100644 examples/multimedia/camera/videosettings.cpp create mode 100644 examples/multimedia/camera/videosettings.h create mode 100644 examples/multimedia/camera/videosettings.ui create mode 100644 examples/multimedia/camera/videosettings_mobile.ui create mode 100644 examples/multimedia/declarative-camera/CMakeLists.txt create mode 100644 examples/multimedia/declarative-camera/CameraButton.qml create mode 100644 examples/multimedia/declarative-camera/CameraListButton.qml create mode 100644 examples/multimedia/declarative-camera/CameraListPopup.qml create mode 100644 examples/multimedia/declarative-camera/CameraPropertyButton.qml create mode 100644 examples/multimedia/declarative-camera/CameraPropertyPopup.qml create mode 100644 examples/multimedia/declarative-camera/FlashControl.qml create mode 100644 examples/multimedia/declarative-camera/Info.plist create mode 100644 examples/multimedia/declarative-camera/Info.plist.in create mode 100644 examples/multimedia/declarative-camera/PhotoCaptureControls.qml create mode 100644 examples/multimedia/declarative-camera/PhotoPreview.qml create mode 100644 examples/multimedia/declarative-camera/Popup.qml create mode 100644 examples/multimedia/declarative-camera/VideoCaptureControls.qml create mode 100644 examples/multimedia/declarative-camera/VideoPreview.qml create mode 100644 examples/multimedia/declarative-camera/ZoomControl.qml create mode 100644 examples/multimedia/declarative-camera/declarative-camera.pro create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qml create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qmlproject create mode 100644 examples/multimedia/declarative-camera/declarative-camera.qrc create mode 100644 examples/multimedia/declarative-camera/doc/images/CaptureControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/FlashControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png create mode 100644 examples/multimedia/declarative-camera/doc/images/ZoomControl.png create mode 100644 examples/multimedia/declarative-camera/doc/images/qml-camera.png create mode 100644 examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png create mode 100644 examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc create mode 100644 examples/multimedia/declarative-camera/images/camera_auto_mode.png create mode 100644 examples/multimedia/declarative-camera/images/camera_camera_setting.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_auto.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_fill.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_off.png create mode 100644 examples/multimedia/declarative-camera/images/camera_flash_redeye.png create mode 100644 examples/multimedia/declarative-camera/images/camera_white_balance_cloudy.png create mode 100644 examples/multimedia/declarative-camera/images/camera_white_balance_flourescent.png create mode 100644 examples/multimedia/declarative-camera/images/camera_white_balance_incandescent.png create mode 100644 examples/multimedia/declarative-camera/images/camera_white_balance_sunny.png create mode 100644 examples/multimedia/declarative-camera/images/toolbutton.png create mode 100644 examples/multimedia/declarative-camera/images/toolbutton.sci create mode 100644 examples/multimedia/declarative-camera/permission-denied.qml create mode 100644 examples/multimedia/declarative-camera/qmlcamera.cpp create mode 100644 examples/multimedia/multimedia.pro create mode 100644 examples/multimedia/player/CMakeLists.txt create mode 100644 examples/multimedia/player/doc/images/mediaplayerex.jpg create mode 100644 examples/multimedia/player/doc/src/player.qdoc create mode 100644 examples/multimedia/player/main.cpp create mode 100644 examples/multimedia/player/player.cpp create mode 100644 examples/multimedia/player/player.h create mode 100644 examples/multimedia/player/player.pro create mode 100644 examples/multimedia/player/playercontrols.cpp create mode 100644 examples/multimedia/player/playercontrols.h create mode 100644 examples/multimedia/player/playlistmodel.cpp create mode 100644 examples/multimedia/player/playlistmodel.h create mode 100644 examples/multimedia/player/qmediaplaylist.cpp create mode 100644 examples/multimedia/player/qmediaplaylist.h create mode 100644 examples/multimedia/player/qmediaplaylist_p.cpp create mode 100644 examples/multimedia/player/qmediaplaylist_p.h create mode 100644 examples/multimedia/player/qplaylistfileparser.cpp create mode 100644 examples/multimedia/player/qplaylistfileparser.h create mode 100644 examples/multimedia/player/videowidget.cpp create mode 100644 examples/multimedia/player/videowidget.h create mode 100644 examples/multimedia/screencapture/CMakeLists.txt create mode 100644 examples/multimedia/screencapture/Info.plist.in create mode 100644 examples/multimedia/screencapture/android/AndroidManifest.xml create mode 100644 examples/multimedia/screencapture/doc/images/screencapture.jpg create mode 100644 examples/multimedia/screencapture/doc/src/screencapture.qdoc create mode 100644 examples/multimedia/screencapture/main.cpp create mode 100644 examples/multimedia/screencapture/screencapture.pro create mode 100644 examples/multimedia/screencapture/screencapturepreview.cpp create mode 100644 examples/multimedia/screencapture/screencapturepreview.h create mode 100644 examples/multimedia/screencapture/screenlistmodel.cpp create mode 100644 examples/multimedia/screencapture/screenlistmodel.h create mode 100644 examples/multimedia/screencapture/windowlistmodel.cpp create mode 100644 examples/multimedia/screencapture/windowlistmodel.h create mode 100644 examples/multimedia/shared/shared.pri create mode 100644 examples/multimedia/video/CMakeLists.txt create mode 100644 examples/multimedia/video/mediaplayer/CMakeLists.txt create mode 100644 examples/multimedia/video/mediaplayer/Main.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/AudioControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/TracksInfo.qml create mode 100644 examples/multimedia/video/mediaplayer/controls/UrlPopup.qml create mode 100644 examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png create mode 100644 examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png create mode 100644 examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc create mode 100644 examples/multimedia/video/mediaplayer/images/backward10.svg create mode 100644 examples/multimedia/video/mediaplayer/images/ff.svg create mode 100644 examples/multimedia/video/mediaplayer/images/forward10.svg create mode 100644 examples/multimedia/video/mediaplayer/images/link.svg create mode 100644 examples/multimedia/video/mediaplayer/images/loop.svg create mode 100644 examples/multimedia/video/mediaplayer/images/more.svg create mode 100644 examples/multimedia/video/mediaplayer/images/mute.svg create mode 100644 examples/multimedia/video/mediaplayer/images/open_new.svg create mode 100644 examples/multimedia/video/mediaplayer/images/pause_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/play_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/rewind.svg create mode 100644 examples/multimedia/video/mediaplayer/images/settings.svg create mode 100644 examples/multimedia/video/mediaplayer/images/speaker.svg create mode 100644 examples/multimedia/video/mediaplayer/images/stop_symbol.svg create mode 100644 examples/multimedia/video/mediaplayer/images/url.svg create mode 100644 examples/multimedia/video/mediaplayer/images/volume.svg create mode 100644 examples/multimedia/video/mediaplayer/images/volume_mute.svg create mode 100644 examples/multimedia/video/mediaplayer/images/zoom_maximize.svg create mode 100644 examples/multimedia/video/mediaplayer/images/zoom_minimize.svg create mode 100644 examples/multimedia/video/mediaplayer/main.cpp create mode 100644 examples/multimedia/video/qmlvideo/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/Info.plist.in create mode 100644 examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg create mode 100644 examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg create mode 100644 examples/multimedia/video/qmlvideo/doc/src/qmlvideo.qdoc create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor.cpp create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor.h create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitor/qmldir create mode 100644 examples/multimedia/video/qmlvideo/frequencymonitordeclarative.cpp create mode 100644 examples/multimedia/video/qmlvideo/main.cpp create mode 100644 examples/multimedia/video/qmlvideo/performancemonitor.cpp create mode 100644 examples/multimedia/video/qmlvideo/performancemonitor.h create mode 100644 examples/multimedia/video/qmlvideo/performancemonitor/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/performancemonitor/PerformanceItem.qml create mode 100644 examples/multimedia/video/qmlvideo/performancemonitor/qmldir create mode 100644 examples/multimedia/video/qmlvideo/performancemonitordeclarative.cpp create mode 100644 examples/multimedia/video/qmlvideo/performancemonitordeclarative.h create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.pro create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo.svg create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Content.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Main.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/leaves.jpg create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/images/up.png create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/qmldir create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp create mode 100644 examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h create mode 100644 examples/multimedia/video/qmlvideo/trace.h create mode 100644 examples/multimedia/video/recorder/AudioInputSelect.qml create mode 100644 examples/multimedia/video/recorder/CMakeLists.txt create mode 100644 examples/multimedia/video/recorder/Controls.qml create mode 100644 examples/multimedia/video/recorder/Info.plist.in create mode 100644 examples/multimedia/video/recorder/MediaList.qml create mode 100644 examples/multimedia/video/recorder/Playback.qml create mode 100644 examples/multimedia/video/recorder/RecordButton.qml create mode 100644 examples/multimedia/video/recorder/SettingsEncoder.qml create mode 100644 examples/multimedia/video/recorder/SettingsMetaData.qml create mode 100644 examples/multimedia/video/recorder/Style.qml create mode 100644 examples/multimedia/video/recorder/StyleParameter.qml create mode 100644 examples/multimedia/video/recorder/StyleRectangle.qml create mode 100644 examples/multimedia/video/recorder/StyleSlider.qml create mode 100644 examples/multimedia/video/recorder/VideoSourceSelect.qml create mode 100644 examples/multimedia/video/recorder/android/AndroidManifest.xml create mode 100644 examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif create mode 100644 examples/multimedia/video/recorder/doc/images/qml-recorder-overview.gif create mode 100644 examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg create mode 100644 examples/multimedia/video/recorder/doc/src/recorder.qdoc create mode 100644 examples/multimedia/video/recorder/main.cpp create mode 100644 examples/multimedia/video/recorder/main.qml create mode 100644 examples/multimedia/video/recorder/main_no_permissions.qml create mode 100644 examples/multimedia/video/recorder/qmldir create mode 100644 examples/multimedia/video/video.pro create mode 100644 examples/multimedia/videographicsitem/CMakeLists.txt create mode 100644 examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png create mode 100644 examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc create mode 100644 examples/multimedia/videographicsitem/main.cpp create mode 100644 examples/multimedia/videographicsitem/videographicsitem.pro create mode 100644 examples/multimedia/videographicsitem/videoplayer.cpp create mode 100644 examples/multimedia/videographicsitem/videoplayer.h create mode 100644 examples/multimedia/videowidget/CMakeLists.txt create mode 100644 examples/multimedia/videowidget/doc/images/video-videowidget.png create mode 100644 examples/multimedia/videowidget/doc/src/videowidget.qdoc create mode 100644 examples/multimedia/videowidget/main.cpp create mode 100644 examples/multimedia/videowidget/videoplayer.cpp create mode 100644 examples/multimedia/videowidget/videoplayer.h create mode 100644 examples/multimedia/videowidget/videowidget.pro create mode 100644 examples/spatialaudio/CMakeLists.txt create mode 100644 examples/spatialaudio/audiopanning/CMakeLists.txt create mode 100644 examples/spatialaudio/audiopanning/audiopanning.pro create mode 100644 examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png create mode 100644 examples/spatialaudio/audiopanning/doc/src/audiopanning.qdoc create mode 100644 examples/spatialaudio/audiopanning/main.cpp create mode 100644 examples/spatialaudio/spatialaudio.pro create mode 100644 licenseRule.json create mode 100644 qt_cmdline.cmake create mode 100644 src/3rdparty/eigen/COPYING.BSD create mode 100644 src/3rdparty/eigen/COPYING.MPL2 create mode 100644 src/3rdparty/eigen/COPYING.README create mode 100644 src/3rdparty/eigen/COPYRIGHTS create mode 100644 src/3rdparty/eigen/Eigen/Cholesky create mode 100644 src/3rdparty/eigen/Eigen/Core create mode 100644 src/3rdparty/eigen/Eigen/Dense create mode 100644 src/3rdparty/eigen/Eigen/Eigenvalues create mode 100644 src/3rdparty/eigen/Eigen/Geometry create mode 100644 src/3rdparty/eigen/Eigen/Householder create mode 100644 src/3rdparty/eigen/Eigen/Jacobi create mode 100644 src/3rdparty/eigen/Eigen/LU create mode 100644 src/3rdparty/eigen/Eigen/QR create mode 100644 src/3rdparty/eigen/Eigen/SVD create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h create mode 100644 src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Array.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Assign.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Block.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/BooleanRedux.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseTernaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Diagonal.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Dot.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/EigenBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/IO.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/IndexedView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Inverse.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Map.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MapBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Matrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NestByValue.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NoAlias.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/NumTraits.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Product.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Random.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Redux.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Ref.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Replicate.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Reshaped.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Reverse.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Select.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SelfAdjointView.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SelfCwiseBinaryOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Solve.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SolveTriangular.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/SolverBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/StableNorm.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/StlIterators.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Stride.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Swap.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Transpose.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Transpositions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/TriangularMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/VectorBlock.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/VectorwiseOp.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/Visitor.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AVX512/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProductCommon.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/MatrixProductMMA.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/AltiVec/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/CUDA/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/BFloat16.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/ConjHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/GenericPacketMathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/GenericPacketMathFunctionsFwd.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/Half.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/Settings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/Default/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/GPU/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/HIP/hcc/math_constants.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/MSA/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/GeneralBlockPanelKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/NEON/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SSE/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SVE/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/InteropHeaders.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/SyclMemoryModel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/SYCL/TypeCasting.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/Complex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/MathFunctions.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/arch/ZVector/PacketMath.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/AssignmentFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/BinaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/NullaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/StlFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/TernaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/functors/UnaryFunctors.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralBlockPanelKernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrixTriangular.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/GeneralMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/Parallelizer.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointProduct.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/SelfadjointRank2Update.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularMatrixVector_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverMatrix.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverMatrix_BLAS.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/products/TriangularSolverVector.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/BlasUtil.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ConfigureVectorization.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Constants.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/DisableStupidWarnings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ForwardDeclarations.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/IndexedViewHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/IntegralConstant.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/MKL_support.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Macros.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Memory.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/Meta.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/NonMPL2.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ReenableStupidWarnings.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/ReshapedHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/StaticAssert.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/SymbolicIndex.h create mode 100644 src/3rdparty/eigen/Eigen/src/Core/util/XprHelper.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexSchur.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/ComplexSchur_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/EigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/GeneralizedEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/HessenbergDecomposition.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/MatrixBaseEigenvalues.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealQZ.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealSchur.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/RealSchur_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/SelfAdjointEigenSolver.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/Eigenvalues/Tridiagonalization.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/AlignedBox.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/AngleAxis.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/EulerAngles.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Homogeneous.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Hyperplane.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/OrthoMethods.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/ParametrizedLine.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Quaternion.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Rotation2D.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/RotationBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Scaling.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Transform.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Translation.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/Umeyama.h create mode 100644 src/3rdparty/eigen/Eigen/src/Geometry/arch/Geometry_SIMD.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/BlockHouseholder.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/Householder.h create mode 100644 src/3rdparty/eigen/Eigen/src/Householder/HouseholderSequence.h create mode 100644 src/3rdparty/eigen/Eigen/src/Jacobi/Jacobi.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/Determinant.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/FullPivLU.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/InverseImpl.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/PartialPivLU.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/PartialPivLU_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/LU/arch/InverseSize4.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/ColPivHouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/ColPivHouseholderQR_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/CompleteOrthogonalDecomposition.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/FullPivHouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/HouseholderQR.h create mode 100644 src/3rdparty/eigen/Eigen/src/QR/HouseholderQR_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/BDCSVD.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/JacobiSVD_LAPACKE.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/SVDBase.h create mode 100644 src/3rdparty/eigen/Eigen/src/SVD/UpperBidiagonalization.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/Image.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/Kernel.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/RealSvd2x2.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/blas.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapack.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapacke.h create mode 100644 src/3rdparty/eigen/Eigen/src/misc/lapacke_mangling.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ArrayCwiseBinaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ArrayCwiseUnaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/BlockMethods.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/CommonCwiseBinaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/CommonCwiseUnaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/IndexedViewMethods.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/MatrixCwiseBinaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/MatrixCwiseUnaryOps.h create mode 100644 src/3rdparty/eigen/Eigen/src/plugins/ReshapedMethods.h create mode 100644 src/3rdparty/eigen/INSTALL create mode 100644 src/3rdparty/eigen/README.md create mode 100644 src/3rdparty/eigen/REUSE.toml create mode 100644 src/3rdparty/eigen/qt_attribution.json create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSD-2-Clause.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSD-Source-Code.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.BSL-1.0.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.IJG.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.ISC.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.LGPL-2.1-or-later.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.MIT.txt create mode 100644 src/3rdparty/ffmpeg/LICENSE.Zlib.txt create mode 100644 src/3rdparty/ffmpeg/qt_attribution.json create mode 100644 src/3rdparty/pffft/COPYRIGHTS create mode 100644 src/3rdparty/pffft/LICENSE create mode 100644 src/3rdparty/pffft/README.md create mode 100644 src/3rdparty/pffft/REUSE.toml create mode 100644 src/3rdparty/pffft/fftpack.c create mode 100644 src/3rdparty/pffft/fftpack.h create mode 100644 src/3rdparty/pffft/pffft.c create mode 100644 src/3rdparty/pffft/pffft.h create mode 100644 src/3rdparty/pffft/qt_attribution.json create mode 100644 src/3rdparty/pffft/test_pffft.c create mode 100644 src/3rdparty/resonance-audio/.travis.yml create mode 100644 src/3rdparty/resonance-audio/AUTHORS create mode 100644 src/3rdparty/resonance-audio/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/CODEOWNERS create mode 100644 src/3rdparty/resonance-audio/CONTRIBUTING.md create mode 100644 src/3rdparty/resonance-audio/COPYRIGHTS create mode 100644 src/3rdparty/resonance-audio/LICENSE create mode 100644 src/3rdparty/resonance-audio/README.md create mode 100644 src/3rdparty/resonance-audio/REUSE.toml create mode 100755 src/3rdparty/resonance-audio/build.sh create mode 100644 src/3rdparty/resonance-audio/patches/0001-resonance_audio-fix-C-20-build.patch create mode 100644 src/3rdparty/resonance-audio/platforms/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_effects_utils_test.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/room_properties.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils.cc create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils.h create mode 100644 src/3rdparty/resonance-audio/platforms/common/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/qt_attribution.json create mode 100644 src/3rdparty/resonance-audio/resonance_audio/CMakeLists.txt create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_binaural_decoder_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_codec_impl_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_lookup_table_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/ambisonic_spread_coefficients.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/associated_legendre_polynomials_generator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/foa_rotator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/hoa_rotator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/stereo_from_soundfield_converter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/ambisonics/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/binaural_surround_renderer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/binaural_surround_renderer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/resonance_audio_api.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/api/resonance_audio_api.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/aligned_allocator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/aligned_allocator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/audio_buffer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/channel_view_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/constants_and_types.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/integral_types.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/logging.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/misc_math_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/object_transform.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_macros.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/simd_utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/source_parameters.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/spherical_angle_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/base/unique_ptr_wrapper.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/global_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/source_config.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/config/source_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/biquad_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/channel_converter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/circular_buffer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/delay_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/distance_attenuation_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fft_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/filter_coefficient_generators_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/fir_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_mixer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/gain_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mixer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/mono_pole_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/multi_channel_iir_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/near_field_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/near_field_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/occlusion_calculator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/partitioned_fft_filter_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflection.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reflections_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/resampler_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_compensator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_compensator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_update_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/reverb_onset_update_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/sh_hrir_creator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/sh_hrir_creator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/shoe_box_room_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb_constants_and_tables.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/spectral_reverb_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/stereo_panner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/dsp/utils_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_listener.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_ray_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_source.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/acoustic_source_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/collection_kernel_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/estimating_rt60_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/impulse_response_computer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/mesh.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/parallel_for_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/path_tracer_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/proxy_room_estimator_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/reflection_kernel_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sampling.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/scene_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/sphere_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/test_util.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/geometrical_acoustics/test_util.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_binaural_decoder_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_binaural_decoder_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/ambisonic_mixing_encoder_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/binaural_surround_renderer_impl_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/buffered_source_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/buffered_source_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/foa_rotator_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/foa_rotator_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_mixer_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/gain_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/graph_manager_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/hoa_rotator_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/hoa_rotator_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mixer_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mono_from_soundfield_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/mono_from_soundfield_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/near_field_effect_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/occlusion_node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reflections_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reflections_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/resonance_audio_api_impl.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/resonance_audio_api_impl.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reverb_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/reverb_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_graph_config.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/source_parameters_manager_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/stereo_mixing_panner_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/stereo_mixing_panner_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/graph/system_settings.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/audio_nodes_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/node_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/processing_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/processing_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/publisher_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/sink_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/sink_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/source_node.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/source_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/node/subscriber_node.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_crossfader_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_partitioner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/buffer_unpartitioner_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/lockless_task_queue_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/ogg_vorbis_recorder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/ogg_vorbis_recorder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/planar_interleaved_conversion_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/pseudoinverse.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/pseudoinverse_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sample_type_conversion_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/semi_lockless_fifo.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/sum_and_difference_processor_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/task_thread_pool_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/test_util_test.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/threadsafe_fifo.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/vorbis_stream_encoder.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/vorbis_stream_encoder.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav.h create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav_reader.cc create mode 100644 src/3rdparty/resonance-audio/resonance_audio/utils/wav_reader.h create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/LICENSE create mode 100755 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generate_hrtf_assets.py create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/README create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/hrtf_assets.cc create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/generated/hrtf_assets.h create mode 100644 src/3rdparty/resonance-audio/third_party/SADIE_hrtf_database/hrtf_assets.iad create mode 100644 src/CMakeLists.txt create mode 100644 src/android/CMakeLists.txt create mode 100644 src/android/jar/AndroidManifest.xml create mode 100644 src/android/jar/CMakeLists.txt create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtAndroidMediaPlayer.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtAudioDeviceManager.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtCamera2.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtCameraListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtExifDataHandler.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtMediaRecorderListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtMultimediaUtils.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtScreenCaptureService.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtScreenGrabber.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceHolderCallback.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceTextureHolder.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtSurfaceTextureListener.java create mode 100644 src/android/jar/src/org/qtproject/qt/android/multimedia/QtVideoDeviceManager.java create mode 100644 src/multimedia/CMakeLists.txt create mode 100644 src/multimedia/Qt6MultimediaMacros.cmake create mode 100644 src/multimedia/alsa/qalsaaudiodevice.cpp create mode 100644 src/multimedia/alsa/qalsaaudiodevice_p.h create mode 100644 src/multimedia/alsa/qalsaaudiodevices.cpp create mode 100644 src/multimedia/alsa/qalsaaudiodevices_p.h create mode 100644 src/multimedia/alsa/qalsaaudiosink.cpp create mode 100644 src/multimedia/alsa/qalsaaudiosink_p.h create mode 100644 src/multimedia/alsa/qalsaaudiosource.cpp create mode 100644 src/multimedia/alsa/qalsaaudiosource_p.h create mode 100644 src/multimedia/android/qandroidaudiodevice.cpp create mode 100644 src/multimedia/android/qandroidaudiodevice_p.h create mode 100644 src/multimedia/android/qandroidaudiodevices.cpp create mode 100644 src/multimedia/android/qandroidaudiodevices_p.h create mode 100644 src/multimedia/android/qandroidaudiosink.cpp create mode 100644 src/multimedia/android/qandroidaudiosink_p.h create mode 100644 src/multimedia/android/qandroidaudiosource.cpp create mode 100644 src/multimedia/android/qandroidaudiosource_p.h create mode 100644 src/multimedia/android/qopenslesengine.cpp create mode 100644 src/multimedia/android/qopenslesengine_p.h create mode 100644 src/multimedia/audio/qaudio.h create mode 100644 src/multimedia/audio/qaudiobuffer.cpp create mode 100644 src/multimedia/audio/qaudiobuffer.h create mode 100644 src/multimedia/audio/qaudiobuffer_support_p.h create mode 100644 src/multimedia/audio/qaudiobufferinput.cpp create mode 100644 src/multimedia/audio/qaudiobufferinput.h create mode 100644 src/multimedia/audio/qaudiobufferoutput.cpp create mode 100644 src/multimedia/audio/qaudiobufferoutput.h create mode 100644 src/multimedia/audio/qaudiobufferoutput_p.h create mode 100644 src/multimedia/audio/qaudiodecoder.cpp create mode 100644 src/multimedia/audio/qaudiodecoder.h create mode 100644 src/multimedia/audio/qaudiodecoder_p.h create mode 100644 src/multimedia/audio/qaudiodevice.cpp create mode 100644 src/multimedia/audio/qaudiodevice.h create mode 100644 src/multimedia/audio/qaudiodevice_p.h create mode 100644 src/multimedia/audio/qaudioformat.cpp create mode 100644 src/multimedia/audio/qaudioformat.h create mode 100644 src/multimedia/audio/qaudioformat_p.h create mode 100644 src/multimedia/audio/qaudiohelpers.cpp create mode 100644 src/multimedia/audio/qaudiohelpers_p.h create mode 100644 src/multimedia/audio/qaudioinput.cpp create mode 100644 src/multimedia/audio/qaudioinput.h create mode 100644 src/multimedia/audio/qaudiooutput.cpp create mode 100644 src/multimedia/audio/qaudiooutput.h create mode 100644 src/multimedia/audio/qaudioringbuffer_p.h create mode 100644 src/multimedia/audio/qaudiosink.cpp create mode 100644 src/multimedia/audio/qaudiosink.h create mode 100644 src/multimedia/audio/qaudiosource.cpp create mode 100644 src/multimedia/audio/qaudiosource.h create mode 100644 src/multimedia/audio/qaudiostatemachine.cpp create mode 100644 src/multimedia/audio/qaudiostatemachine_p.h create mode 100644 src/multimedia/audio/qaudiostatemachineutils_p.h create mode 100644 src/multimedia/audio/qaudiosystem.cpp create mode 100644 src/multimedia/audio/qaudiosystem_p.h create mode 100644 src/multimedia/audio/qsamplecache_p.cpp create mode 100644 src/multimedia/audio/qsamplecache_p.h create mode 100644 src/multimedia/audio/qsoundeffect.cpp create mode 100644 src/multimedia/audio/qsoundeffect.h create mode 100644 src/multimedia/audio/qtaudio.cpp create mode 100644 src/multimedia/audio/qtaudio.h create mode 100644 src/multimedia/audio/qwavedecoder.cpp create mode 100644 src/multimedia/audio/qwavedecoder.h create mode 100644 src/multimedia/camera/qcamera.cpp create mode 100644 src/multimedia/camera/qcamera.h create mode 100644 src/multimedia/camera/qcamera_p.h create mode 100644 src/multimedia/camera/qcameradevice.cpp create mode 100644 src/multimedia/camera/qcameradevice.h create mode 100644 src/multimedia/camera/qcameradevice_p.h create mode 100644 src/multimedia/camera/qimagecapture.cpp create mode 100644 src/multimedia/camera/qimagecapture.h create mode 100644 src/multimedia/compat/removed_api.cpp create mode 100644 src/multimedia/configure.cmake create mode 100644 src/multimedia/darwin/qcoreaudiosessionmanager.mm create mode 100644 src/multimedia/darwin/qcoreaudiosessionmanager_p.h create mode 100644 src/multimedia/darwin/qcoreaudioutils.cpp create mode 100644 src/multimedia/darwin/qcoreaudioutils_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiodevice.mm create mode 100644 src/multimedia/darwin/qdarwinaudiodevice_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiodevices.mm create mode 100644 src/multimedia/darwin/qdarwinaudiodevices_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiosink.mm create mode 100644 src/multimedia/darwin/qdarwinaudiosink_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiosource.mm create mode 100644 src/multimedia/darwin/qdarwinaudiosource_p.h create mode 100644 src/multimedia/darwin/qdarwinaudiounit_p.h create mode 100644 src/multimedia/darwin/qmacosaudiodatautils.cpp create mode 100644 src/multimedia/darwin/qmacosaudiodatautils_p.h create mode 100644 src/multimedia/doc/QtMultimediaDoc create mode 100644 src/multimedia/doc/qtmultimedia.qdocconf create mode 100644 src/multimedia/doc/snippets/CMakeLists.txt create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/CMakeLists.txt create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/custommediainputsnippets.cpp create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/custommediainputsnippets.h create mode 100644 src/multimedia/doc/snippets/custommediainputsnippets/main.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/audio.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/camera.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/devices.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/images/qt-logo.png create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/media.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/multiple-videooutputs.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/qsound.cpp create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/qtvideosink.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/soundeffect.qml create mode 100644 src/multimedia/doc/snippets/multimedia-snippets/video.cpp create mode 100644 src/multimedia/doc/src/advanced-ffmpeg-configuration.qdoc create mode 100644 src/multimedia/doc/src/audiooverview.qdoc create mode 100644 src/multimedia/doc/src/backend-notes-gstreamer.qdoc create mode 100644 src/multimedia/doc/src/cameraoverview.qdoc create mode 100644 src/multimedia/doc/src/classic.css create mode 100644 src/multimedia/doc/src/cmake/cmake-variables.qdoc create mode 100644 src/multimedia/doc/src/cmake/qt_add_ios_ffmpeg_libraries.qdoc create mode 100644 src/multimedia/doc/src/examples/video-qml-paint-rate.qdocinc create mode 100644 src/multimedia/doc/src/images/Zoom.gif create mode 100644 src/multimedia/doc/src/images/annotatedurl.png create mode 100644 src/multimedia/doc/src/images/camera_correctionAngle_90.png create mode 100644 src/multimedia/doc/src/images/codeless.png create mode 100644 src/multimedia/doc/src/images/how-focus-works.gif create mode 100644 src/multimedia/doc/src/images/image_processing.png create mode 100644 src/multimedia/doc/src/images/noun_Media_166644.svg create mode 100644 src/multimedia/doc/src/images/qS1FmgPVL.jpg create mode 100644 src/multimedia/doc/src/images/qmlcamera-menu.png create mode 100644 src/multimedia/doc/src/images/radio-example.png create mode 100644 src/multimedia/doc/src/images/slideshow-img1.png create mode 100644 src/multimedia/doc/src/images/sound-wave-small.jpg create mode 100644 src/multimedia/doc/src/images/video-graphics-memory.png create mode 100644 src/multimedia/doc/src/images/video-qml-paint-rate.png create mode 100644 src/multimedia/doc/src/multimedia-overview.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-apple.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-wasm.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-wayland.qdoc create mode 100644 src/multimedia/doc/src/platform-notes-windows.qdoc create mode 100644 src/multimedia/doc/src/qm-external-pages.qdoc create mode 100644 src/multimedia/doc/src/qt6-changes.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-macos.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg-windows.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-FFmpeg.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-building-from-source.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-cpp.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-examples.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-index.qdoc create mode 100644 src/multimedia/doc/src/qtmultimedia-qml-types.qdoc create mode 100644 src/multimedia/doc/src/videooverview.qdoc create mode 100644 src/multimedia/pipewire/qpipewire_screencapture.cpp create mode 100644 src/multimedia/pipewire/qpipewire_screencapture_p.h create mode 100644 src/multimedia/pipewire/qpipewire_screencapturehelper.cpp create mode 100644 src/multimedia/pipewire/qpipewire_screencapturehelper_p.h create mode 100644 src/multimedia/pipewire/qpipewire_support_p.h create mode 100644 src/multimedia/pipewire/qpipewire_symbolloader.cpp create mode 100644 src/multimedia/pipewire/qpipewire_symbolloader_p.h create mode 100644 src/multimedia/platform/qgstreamer_platformspecificinterface.cpp create mode 100644 src/multimedia/platform/qgstreamer_platformspecificinterface_p.h create mode 100644 src/multimedia/platform/qplatformaudiobufferinput.cpp create mode 100644 src/multimedia/platform/qplatformaudiobufferinput_p.h create mode 100644 src/multimedia/platform/qplatformaudiodecoder.cpp create mode 100644 src/multimedia/platform/qplatformaudiodecoder_p.h create mode 100644 src/multimedia/platform/qplatformaudiodevices.cpp create mode 100644 src/multimedia/platform/qplatformaudiodevices_p.h create mode 100644 src/multimedia/platform/qplatformaudioinput_p.h create mode 100644 src/multimedia/platform/qplatformaudiooutput_p.h create mode 100644 src/multimedia/platform/qplatformaudioresampler_p.h create mode 100644 src/multimedia/platform/qplatformcamera.cpp create mode 100644 src/multimedia/platform/qplatformcamera_p.h create mode 100644 src/multimedia/platform/qplatformcapturablewindows_p.h create mode 100644 src/multimedia/platform/qplatformimagecapture.cpp create mode 100644 src/multimedia/platform/qplatformimagecapture_p.h create mode 100644 src/multimedia/platform/qplatformmediacapture.cpp create mode 100644 src/multimedia/platform/qplatformmediacapture_p.h create mode 100644 src/multimedia/platform/qplatformmediaformatinfo.cpp create mode 100644 src/multimedia/platform/qplatformmediaformatinfo_p.h create mode 100644 src/multimedia/platform/qplatformmediaintegration.cpp create mode 100644 src/multimedia/platform/qplatformmediaintegration_p.h create mode 100644 src/multimedia/platform/qplatformmediaplayer.cpp create mode 100644 src/multimedia/platform/qplatformmediaplayer_p.h create mode 100644 src/multimedia/platform/qplatformmediaplugin.cpp create mode 100644 src/multimedia/platform/qplatformmediaplugin_p.h create mode 100644 src/multimedia/platform/qplatformmediarecorder.cpp create mode 100644 src/multimedia/platform/qplatformmediarecorder_p.h create mode 100644 src/multimedia/platform/qplatformsurfacecapture.cpp create mode 100644 src/multimedia/platform/qplatformsurfacecapture_p.h create mode 100644 src/multimedia/platform/qplatformvideodevices.cpp create mode 100644 src/multimedia/platform/qplatformvideodevices_p.h create mode 100644 src/multimedia/platform/qplatformvideoframeinput.cpp create mode 100644 src/multimedia/platform/qplatformvideoframeinput_p.h create mode 100644 src/multimedia/platform/qplatformvideosink.cpp create mode 100644 src/multimedia/platform/qplatformvideosink_p.h create mode 100644 src/multimedia/platform/qplatformvideosource.cpp create mode 100644 src/multimedia/platform/qplatformvideosource_p.h create mode 100644 src/multimedia/playback/qmediaplayer.cpp create mode 100644 src/multimedia/playback/qmediaplayer.h create mode 100644 src/multimedia/playback/qmediaplayer_p.h create mode 100644 src/multimedia/pulseaudio/qaudioengine_pulse.cpp create mode 100644 src/multimedia/pulseaudio/qaudioengine_pulse_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiodevices.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiodevices_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiosink.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiosink_p.h create mode 100644 src/multimedia/pulseaudio/qpulseaudiosource.cpp create mode 100644 src/multimedia/pulseaudio/qpulseaudiosource_p.h create mode 100644 src/multimedia/pulseaudio/qpulsehelpers.cpp create mode 100644 src/multimedia/pulseaudio/qpulsehelpers_p.h create mode 100644 src/multimedia/qcachedvalue_p.h create mode 100644 src/multimedia/qerrorinfo_p.h create mode 100644 src/multimedia/qmaybe_p.h create mode 100644 src/multimedia/qmediadevices.cpp create mode 100644 src/multimedia/qmediadevices.h create mode 100644 src/multimedia/qmediaformat.cpp create mode 100644 src/multimedia/qmediaformat.h create mode 100644 src/multimedia/qmediaframeinput.cpp create mode 100644 src/multimedia/qmediaframeinput_p.h create mode 100644 src/multimedia/qmediainputencoderinterface_p.h create mode 100644 src/multimedia/qmediametadata.cpp create mode 100644 src/multimedia/qmediametadata.h create mode 100644 src/multimedia/qmediastoragelocation.cpp create mode 100644 src/multimedia/qmediastoragelocation_p.h create mode 100644 src/multimedia/qmediatimerange.cpp create mode 100644 src/multimedia/qmediatimerange.h create mode 100644 src/multimedia/qmultimedia_enum_to_string_converter_p.h create mode 100644 src/multimedia/qmultimediautils.cpp create mode 100644 src/multimedia/qmultimediautils_p.h create mode 100644 src/multimedia/qnx/qqnxaudiodevice.cpp create mode 100644 src/multimedia/qnx/qqnxaudiodevice_p.h create mode 100644 src/multimedia/qnx/qqnxaudiodevices.cpp create mode 100644 src/multimedia/qnx/qqnxaudiodevices_p.h create mode 100644 src/multimedia/qnx/qqnxaudiosink.cpp create mode 100644 src/multimedia/qnx/qqnxaudiosink_p.h create mode 100644 src/multimedia/qnx/qqnxaudiosource.cpp create mode 100644 src/multimedia/qnx/qqnxaudiosource_p.h create mode 100644 src/multimedia/qnx/qqnxaudioutils.cpp create mode 100644 src/multimedia/qnx/qqnxaudioutils_p.h create mode 100644 src/multimedia/qrhivaluemapper.cpp create mode 100644 src/multimedia/qrhivaluemapper_p.h create mode 100644 src/multimedia/qsharedhandle_p.h create mode 100644 src/multimedia/qsymbolsresolveutils.cpp create mode 100644 src/multimedia/qsymbolsresolveutils_p.h create mode 100644 src/multimedia/qt_cmdline.cmake create mode 100644 src/multimedia/qtmultimediaglobal.h create mode 100644 src/multimedia/qtmultimediaglobal_p.h create mode 100644 src/multimedia/qvideotransformation.cpp create mode 100644 src/multimedia/qvideotransformation_p.h create mode 100644 src/multimedia/recording/qcapturablewindow.cpp create mode 100644 src/multimedia/recording/qcapturablewindow.h create mode 100644 src/multimedia/recording/qcapturablewindow_p.h create mode 100644 src/multimedia/recording/qmediacapturesession.cpp create mode 100644 src/multimedia/recording/qmediacapturesession.h create mode 100644 src/multimedia/recording/qmediacapturesession_p.h create mode 100644 src/multimedia/recording/qmediarecorder.cpp create mode 100644 src/multimedia/recording/qmediarecorder.h create mode 100644 src/multimedia/recording/qmediarecorder_p.h create mode 100644 src/multimedia/recording/qscreencapture-limitations.qdocinc create mode 100644 src/multimedia/recording/qscreencapture.cpp create mode 100644 src/multimedia/recording/qscreencapture.h create mode 100644 src/multimedia/recording/qvideoframeinput.cpp create mode 100644 src/multimedia/recording/qvideoframeinput.h create mode 100644 src/multimedia/recording/qwindowcapture-limitations.qdocinc create mode 100644 src/multimedia/recording/qwindowcapture.cpp create mode 100644 src/multimedia/recording/qwindowcapture.h create mode 100644 src/multimedia/shaders/abgr.frag create mode 100644 src/multimedia/shaders/argb.frag create mode 100644 src/multimedia/shaders/ayuv.frag create mode 100644 src/multimedia/shaders/bgra.frag create mode 100644 src/multimedia/shaders/colorconvert.glsl create mode 100644 src/multimedia/shaders/colortransfer.glsl create mode 100755 src/multimedia/shaders/compile.bat create mode 100644 src/multimedia/shaders/externalsampler.frag create mode 100644 src/multimedia/shaders/externalsampler.vert create mode 100644 src/multimedia/shaders/externalsampler_gles.frag create mode 100644 src/multimedia/shaders/hdrtonemapper.glsl create mode 100644 src/multimedia/shaders/imc2.frag create mode 100644 src/multimedia/shaders/imc2_a.frag create mode 100644 src/multimedia/shaders/imc4.frag create mode 100644 src/multimedia/shaders/imc4_a.frag create mode 100644 src/multimedia/shaders/nv12.frag create mode 100644 src/multimedia/shaders/nv12_a.frag create mode 100644 src/multimedia/shaders/nv12_bt2020_hlg.frag create mode 100644 src/multimedia/shaders/nv12_bt2020_pq.frag create mode 100644 src/multimedia/shaders/nv21.frag create mode 100644 src/multimedia/shaders/nv21_a.frag create mode 100644 src/multimedia/shaders/rectsampler.vert create mode 100644 src/multimedia/shaders/rectsampler_bgra.frag create mode 100644 src/multimedia/shaders/rgba.frag create mode 100644 src/multimedia/shaders/uniformbuffer.glsl create mode 100644 src/multimedia/shaders/uyvy.frag create mode 100644 src/multimedia/shaders/vertex.vert create mode 100644 src/multimedia/shaders/y.frag create mode 100644 src/multimedia/shaders/y_a.frag create mode 100644 src/multimedia/shaders/yuv_triplanar.frag create mode 100644 src/multimedia/shaders/yuv_triplanar_a.frag create mode 100644 src/multimedia/shaders/yuv_triplanar_p10.frag create mode 100644 src/multimedia/shaders/yuyv.frag create mode 100644 src/multimedia/shaders/yvu_triplanar.frag create mode 100644 src/multimedia/shaders/yvu_triplanar_a.frag create mode 100644 src/multimedia/video/qabstractvideobuffer.cpp create mode 100644 src/multimedia/video/qabstractvideobuffer.h create mode 100644 src/multimedia/video/qhwvideobuffer.cpp create mode 100644 src/multimedia/video/qhwvideobuffer_p.h create mode 100644 src/multimedia/video/qimagevideobuffer.cpp create mode 100644 src/multimedia/video/qimagevideobuffer_p.h create mode 100644 src/multimedia/video/qmemoryvideobuffer.cpp create mode 100644 src/multimedia/video/qmemoryvideobuffer_p.h create mode 100644 src/multimedia/video/qtvideo.cpp create mode 100644 src/multimedia/video/qtvideo.h create mode 100644 src/multimedia/video/qvideoframe.cpp create mode 100644 src/multimedia/video/qvideoframe.h create mode 100644 src/multimedia/video/qvideoframe_p.h create mode 100644 src/multimedia/video/qvideoframeconversionhelper.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_avx2.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_p.h create mode 100644 src/multimedia/video/qvideoframeconversionhelper_sse2.cpp create mode 100644 src/multimedia/video/qvideoframeconversionhelper_ssse3.cpp create mode 100644 src/multimedia/video/qvideoframeconverter.cpp create mode 100644 src/multimedia/video/qvideoframeconverter_p.h create mode 100644 src/multimedia/video/qvideoframeformat.cpp create mode 100644 src/multimedia/video/qvideoframeformat.h create mode 100644 src/multimedia/video/qvideoframetexturefromsource.cpp create mode 100644 src/multimedia/video/qvideoframetexturefromsource_p.h create mode 100644 src/multimedia/video/qvideoframetexturepool.cpp create mode 100644 src/multimedia/video/qvideoframetexturepool_p.h create mode 100644 src/multimedia/video/qvideooutputorientationhandler.cpp create mode 100644 src/multimedia/video/qvideooutputorientationhandler_p.h create mode 100644 src/multimedia/video/qvideosink.cpp create mode 100644 src/multimedia/video/qvideosink.h create mode 100644 src/multimedia/video/qvideotexturehelper.cpp create mode 100644 src/multimedia/video/qvideotexturehelper_p.h create mode 100644 src/multimedia/video/qvideowindow.cpp create mode 100644 src/multimedia/video/qvideowindow_p.h create mode 100644 src/multimedia/wasm/qwasmaudiodevice.cpp create mode 100644 src/multimedia/wasm/qwasmaudiodevice_p.h create mode 100644 src/multimedia/wasm/qwasmaudiosink.cpp create mode 100644 src/multimedia/wasm/qwasmaudiosink_p.h create mode 100644 src/multimedia/wasm/qwasmaudiosource.cpp create mode 100644 src/multimedia/wasm/qwasmaudiosource_p.h create mode 100644 src/multimedia/wasm/qwasmmediadevices.cpp create mode 100644 src/multimedia/wasm/qwasmmediadevices_p.h create mode 100644 src/multimedia/windows/qcominitializer.cpp create mode 100644 src/multimedia/windows/qcominitializer_p.h create mode 100644 src/multimedia/windows/qcomptr_p.h create mode 100644 src/multimedia/windows/qcomtaskresource_p.h create mode 100644 src/multimedia/windows/qwindowsaudiodevice.cpp create mode 100644 src/multimedia/windows/qwindowsaudiodevice_p.h create mode 100644 src/multimedia/windows/qwindowsaudiodevices.cpp create mode 100644 src/multimedia/windows/qwindowsaudiodevices_p.h create mode 100644 src/multimedia/windows/qwindowsaudiosink.cpp create mode 100644 src/multimedia/windows/qwindowsaudiosink_p.h create mode 100644 src/multimedia/windows/qwindowsaudiosource.cpp create mode 100644 src/multimedia/windows/qwindowsaudiosource_p.h create mode 100644 src/multimedia/windows/qwindowsaudioutils.cpp create mode 100644 src/multimedia/windows/qwindowsaudioutils_p.h create mode 100644 src/multimedia/windows/qwindowsmediafoundation.cpp create mode 100644 src/multimedia/windows/qwindowsmediafoundation_p.h create mode 100644 src/multimedia/windows/qwindowsmfdefs.cpp create mode 100644 src/multimedia/windows/qwindowsmfdefs_p.h create mode 100644 src/multimedia/windows/qwindowsmultimediautils.cpp create mode 100644 src/multimedia/windows/qwindowsmultimediautils_p.h create mode 100644 src/multimedia/windows/qwindowsresampler.cpp create mode 100644 src/multimedia/windows/qwindowsresampler_p.h create mode 100644 src/multimediaquick/CMakeLists.txt create mode 100644 src/multimediaquick/Video.qml create mode 100644 src/multimediaquick/multimedia_plugin.cpp create mode 100644 src/multimediaquick/qquickimagecapture.cpp create mode 100644 src/multimediaquick/qquickimagecapture_p.h create mode 100644 src/multimediaquick/qquickimagepreviewprovider.cpp create mode 100644 src/multimediaquick/qquickimagepreviewprovider_p.h create mode 100644 src/multimediaquick/qquickmediaplayer.cpp create mode 100644 src/multimediaquick/qquickmediaplayer_p.h create mode 100644 src/multimediaquick/qquickplaylist.cpp create mode 100644 src/multimediaquick/qquickplaylist_p.h create mode 100644 src/multimediaquick/qquickscreencapture.cpp create mode 100644 src/multimediaquick/qquickscreencapture_p.h create mode 100644 src/multimediaquick/qquicksoundeffect.cpp create mode 100644 src/multimediaquick/qquicksoundeffect_p.h create mode 100644 src/multimediaquick/qquickvideooutput.cpp create mode 100644 src/multimediaquick/qquickvideooutput_p.h create mode 100644 src/multimediaquick/qsgvideonode_p.cpp create mode 100644 src/multimediaquick/qsgvideonode_p.h create mode 100644 src/multimediaquick/qsgvideotexture.cpp create mode 100644 src/multimediaquick/qsgvideotexture_p.h create mode 100644 src/multimediaquick/qtmultimediaquickglobal_p.h create mode 100644 src/multimediaquick/qtmultimediaquicktypes.cpp create mode 100644 src/multimediaquick/qtmultimediaquicktypes_p.h create mode 100644 src/multimediatestlib/CMakeLists.txt create mode 100644 src/multimediatestlib/audiogenerationutils_p.h create mode 100644 src/multimediatestlib/capturesessionfixture.cpp create mode 100644 src/multimediatestlib/capturesessionfixture_p.h create mode 100644 src/multimediatestlib/framegenerator.cpp create mode 100644 src/multimediatestlib/framegenerator_p.h create mode 100644 src/multimediatestlib/mediabackendutils_p.h create mode 100644 src/multimediatestlib/mediafileselector_p.h create mode 100644 src/multimediatestlib/mediainfo_p.h create mode 100644 src/multimediatestlib/qcolorutil.cpp create mode 100644 src/multimediatestlib/qcolorutil_p.h create mode 100644 src/multimediatestlib/qfileutil.cpp create mode 100644 src/multimediatestlib/qfileutil_p.h create mode 100644 src/multimediatestlib/qmockiodevice_p.h create mode 100644 src/multimediatestlib/qscopedenvironmentvariable_p.h create mode 100644 src/multimediatestlib/qsequentialfileadaptor_p.h create mode 100644 src/multimediatestlib/qsinewavevalidator.cpp create mode 100644 src/multimediatestlib/qsinewavevalidator_p.h create mode 100644 src/multimediatestlib/testvideosink_p.h create mode 100644 src/multimediawidgets/CMakeLists.txt create mode 100644 src/multimediawidgets/doc/snippets/multimedia-snippets/camera.cpp create mode 100644 src/multimediawidgets/doc/snippets/multimedia-snippets/video.cpp create mode 100644 src/multimediawidgets/doc/src/qtmultimediawidgets-index.qdoc create mode 100644 src/multimediawidgets/doc/src/qtmultimediawidgets.qdoc create mode 100644 src/multimediawidgets/qgraphicsvideoitem.cpp create mode 100644 src/multimediawidgets/qgraphicsvideoitem.h create mode 100644 src/multimediawidgets/qtmultimediawidgetsglobal.h create mode 100644 src/multimediawidgets/qvideowidget.cpp create mode 100644 src/multimediawidgets/qvideowidget.h create mode 100644 src/multimediawidgets/qvideowidget_p.h create mode 100644 src/plugins/CMakeLists.txt create mode 100644 src/plugins/multimedia/CMakeLists.txt create mode 100644 src/plugins/multimedia/android/CMakeLists.txt create mode 100644 src/plugins/multimedia/android/android.json create mode 100644 src/plugins/multimedia/android/audio/qandroidaudiodecoder.cpp create mode 100644 src/plugins/multimedia/android/audio/qandroidaudiodecoder_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidaudioinput.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidaudioinput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidaudiooutput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidglobal_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidmultimediautils.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidmultimediautils_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidvideooutput.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidvideooutput_p.h create mode 100644 src/plugins/multimedia/android/common/qandroidvideosink.cpp create mode 100644 src/plugins/multimedia/android/common/qandroidvideosink_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamera.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamera_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamerasession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcamerasession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcapturesession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidcapturesession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidimagecapture.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidimagecapture_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediacapturesession.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediacapturesession_p.h create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediaencoder.cpp create mode 100644 src/plugins/multimedia/android/mediacapture/qandroidmediaencoder_p.h create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmediaplayer.cpp create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmediaplayer_p.h create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmetadata.cpp create mode 100644 src/plugins/multimedia/android/mediaplayer/qandroidmetadata_p.h create mode 100644 src/plugins/multimedia/android/qandroidformatsinfo.cpp create mode 100644 src/plugins/multimedia/android/qandroidformatsinfo_p.h create mode 100644 src/plugins/multimedia/android/qandroidintegration.cpp create mode 100644 src/plugins/multimedia/android/qandroidintegration_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidcamera.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidcamera_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediametadataretriever.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediametadataretriever_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediaplayer.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediaplayer_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediarecorder.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmediarecorder_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmultimediautils.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidmultimediautils_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfacetexture.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfacetexture_p.h create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfaceview.cpp create mode 100644 src/plugins/multimedia/android/wrappers/jni/androidsurfaceview_p.h create mode 100644 src/plugins/multimedia/darwin/CMakeLists.txt create mode 100644 src/plugins/multimedia/darwin/avfaudiodecoder.mm create mode 100644 src/plugins/multimedia/darwin/avfaudiodecoder_p.h create mode 100644 src/plugins/multimedia/darwin/avfvideobuffer.mm create mode 100644 src/plugins/multimedia/darwin/avfvideobuffer_p.h create mode 100644 src/plugins/multimedia/darwin/avfvideosink.mm create mode 100644 src/plugins/multimedia/darwin/avfvideosink_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfaudiopreviewdelegate.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfaudiopreviewdelegate_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamera.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamera_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcameradebug_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerarenderer.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerarenderer_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcameraservice.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcameraservice_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerasession.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerasession_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerautility.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfcamerautility_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfimagecapture.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfimagecapture_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaassetwriter.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaassetwriter_p.h create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaencoder.mm create mode 100644 src/plugins/multimedia/darwin/camera/avfmediaencoder_p.h create mode 100644 src/plugins/multimedia/darwin/camera/qavfcamerabase.mm create mode 100644 src/plugins/multimedia/darwin/camera/qavfcamerabase_p.h create mode 100644 src/plugins/multimedia/darwin/common/avfmetadata.mm create mode 100644 src/plugins/multimedia/darwin/common/avfmetadata_p.h create mode 100644 src/plugins/multimedia/darwin/darwin.json create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfdisplaylink.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfdisplaylink_p.h create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfmediaplayer.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfmediaplayer_p.h create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfvideorenderercontrol.mm create mode 100644 src/plugins/multimedia/darwin/mediaplayer/avfvideorenderercontrol_p.h create mode 100644 src/plugins/multimedia/darwin/qavfhelpers.mm create mode 100644 src/plugins/multimedia/darwin/qavfhelpers_p.h create mode 100644 src/plugins/multimedia/darwin/qdarwinformatsinfo.mm create mode 100644 src/plugins/multimedia/darwin/qdarwinformatsinfo_p.h create mode 100644 src/plugins/multimedia/darwin/qdarwinintegration.mm create mode 100644 src/plugins/multimedia/darwin/qdarwinintegration_p.h create mode 100644 src/plugins/multimedia/ffmpeg/CMakeLists.txt create mode 100644 src/plugins/multimedia/ffmpeg/cmake/QtAddFFmpegStubs.cmake create mode 100644 src/plugins/multimedia/ffmpeg/cmake/QtDeployFFmpeg.cmake create mode 100644 src/plugins/multimedia/ffmpeg/ffmpeg.json create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudiorenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegaudiorenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegcodeccontext.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegcodeccontext_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegdemuxer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegdemuxer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegframe_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegmediadataholder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegmediadataholder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegpacket_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackenginedefs_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackengineobject.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegplaybackengineobject_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegpositionwithoffset_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegrenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegrenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegstreamdecoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegstreamdecoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegsubtitlerenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegsubtitlerenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegtimecontroller.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegtimecontroller_p.h create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegvideorenderer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/playbackengine/qffmpegvideorenderer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidcamera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidcamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidimagecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidimagecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidscreencapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideodevices.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideodevices_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideoframebuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideoframebuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideoframefactory.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qandroidvideoframefactory_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qavfcamera.mm create mode 100644 src/plugins/multimedia/ffmpeg/qavfcamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qavfsamplebufferdelegate.mm create mode 100644 src/plugins/multimedia/ffmpeg/qavfsamplebufferdelegate_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qavfscreencapture.mm create mode 100644 src/plugins/multimedia/ffmpeg/qavfscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qcgcapturablewindows.mm create mode 100644 src/plugins/multimedia/ffmpeg/qcgcapturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qcgwindowcapture.mm create mode 100644 src/plugins/multimedia/ffmpeg/qcgwindowcapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qeglfsscreencapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qeglfsscreencapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeg.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeg_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudiodecoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudiodecoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudioinput.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegaudioinput_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegavaudioformat.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegavaudioformat_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodec.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodec_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodecstorage.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegcodecstorage_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegconverter.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegconverter_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegdefs_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegencodingformatcontext.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegencodingformatcontext_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_d3d11.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_d3d11_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_mediacodec.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_mediacodec_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_vaapi.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_vaapi_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_videotoolbox.mm create mode 100644 src/plugins/multimedia/ffmpeg/qffmpeghwaccel_videotoolbox_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegimagecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegimagecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegioutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegioutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediacapturesession.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediacapturesession_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaformatinfo.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaformatinfo_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaintegration.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaintegration_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediametadata.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediametadata_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaplayer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediaplayer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediarecorder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegmediarecorder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegplaybackengine.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegplaybackengine_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegresampler.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegresampler_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegscreencapture_dxgi.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegscreencapture_dxgi_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegsurfacecapturegrabber.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegsurfacecapturegrabber_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegtextureconverter.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegtextureconverter_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegthread.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegthread_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideobuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideobuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideosink.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegvideosink_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegwindowcapture_uwp.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qffmpegwindowcapture_uwp_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qgdiwindowcapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qgdiwindowcapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qgrabwindowsurfacecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qgrabwindowsurfacecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qopenglvideobuffer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qopenglvideobuffer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2camera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2camera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2cameradevices.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2cameradevices_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2filedescriptor.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2filedescriptor_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2memorytransfer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qv4l2memorytransfer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qwincapturablewindows.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qwincapturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qwindowscamera.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qwindowscamera_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qx11capturablewindows.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qx11capturablewindows_p.h create mode 100644 src/plugins/multimedia/ffmpeg/qx11surfacecapture.cpp create mode 100644 src/plugins/multimedia/ffmpeg/qx11surfacecapture_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoderutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegaudioencoderutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderoptions.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderoptions_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderthread.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencoderthread_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencodinginitializer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegencodinginitializer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegmuxer.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegmuxer_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengine.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengine_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengineutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegrecordingengineutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoderutils.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoencoderutils_p.h create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoframeencoder.cpp create mode 100644 src/plugins/multimedia/ffmpeg/recordingengine/qffmpegvideoframeencoder_p.h create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/openssl3.ver create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-crypto.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-ssl.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va-drm.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va-x11.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/qffmpegsymbols-va.cpp create mode 100644 src/plugins/multimedia/ffmpeg/symbolstubs/va.ver create mode 100644 src/plugins/multimedia/gstreamer/CMakeLists.txt create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodecoder.cpp create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodecoder_p.h create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodevice.cpp create mode 100644 src/plugins/multimedia/gstreamer/audio/qgstreameraudiodevice_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qglist_helper_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_bus_observer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_bus_observer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_debug.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_debug_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_discoverer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_discoverer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_handle_types_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_play.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgst_play_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstpipeline.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstpipeline_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudioinput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudioinput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudiooutput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreameraudiooutput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamerbufferprobe.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamerbufferprobe_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermediaplayer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermediaplayer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermessage_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermetadata.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamermetadata_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideooutput.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideooutput_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideosink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstreamervideosink_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstsubtitlesink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstsubtitlesink_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstutils.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstutils_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideobuffer.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideobuffer_p.h create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideorenderersink.cpp create mode 100644 src/plugins/multimedia/gstreamer/common/qgstvideorenderersink_p.h create mode 100644 src/plugins/multimedia/gstreamer/gstreamer.json create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamercamera.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamercamera_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamerimagecapture.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamerimagecapture_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediacapturesession.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediacapturesession_p.h create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediarecorder.cpp create mode 100644 src/plugins/multimedia/gstreamer/mediacapture/qgstreamermediarecorder_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerformatinfo.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerformatinfo_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerintegration.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerintegration_p.h create mode 100644 src/plugins/multimedia/gstreamer/qgstreamerplugin.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamervideodevices.cpp create mode 100644 src/plugins/multimedia/gstreamer/qgstreamervideodevices_p.h create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qiodevice_handler.cpp create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qiodevice_handler_p.h create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qrc_handler.cpp create mode 100644 src/plugins/multimedia/gstreamer/uri_handler/qgstreamer_qrc_handler_p.h create mode 100644 src/plugins/multimedia/qnx/CMakeLists.txt create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamera.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamera_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcameraframebuffer.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcameraframebuffer_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxcamerahandle_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnximagecapture.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnximagecapture_p.h create mode 100644 src/plugins/multimedia/qnx/camera/qqnxplatformcamera.cpp create mode 100644 src/plugins/multimedia/qnx/camera/qqnxplatformcamera_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxaudiorecorder.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxaudiorecorder_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediacapturesession.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediacapturesession_p.h create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediarecorder.cpp create mode 100644 src/plugins/multimedia/qnx/capture/qqnxmediarecorder_p.h create mode 100644 src/plugins/multimedia/qnx/common/mmrenderertypes.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudioinput.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudioinput_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudiooutput.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxaudiooutput_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxmediaeventthread.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxmediaeventthread_p.h create mode 100644 src/plugins/multimedia/qnx/common/qqnxwindowgrabber.cpp create mode 100644 src/plugins/multimedia/qnx/common/qqnxwindowgrabber_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediametadata.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediametadata_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediaplayer.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediaplayer_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediautil.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxmediautil_p.h create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxvideosink.cpp create mode 100644 src/plugins/multimedia/qnx/mediaplayer/qqnxvideosink_p.h create mode 100644 src/plugins/multimedia/qnx/qnx.json create mode 100644 src/plugins/multimedia/qnx/qqnxformatinfo.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxformatinfo_p.h create mode 100644 src/plugins/multimedia/qnx/qqnxmediaintegration.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxmediaintegration_p.h create mode 100644 src/plugins/multimedia/qnx/qqnxvideodevices.cpp create mode 100644 src/plugins/multimedia/qnx/qqnxvideodevices_p.h create mode 100644 src/plugins/multimedia/wasm/CMakeLists.txt create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudioinput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudioinput_p.h create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudiooutput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmaudiooutput_p.h create mode 100644 src/plugins/multimedia/wasm/common/qwasmvideooutput.cpp create mode 100644 src/plugins/multimedia/wasm/common/qwasmvideooutput_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcamera.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmcamera_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmimagecapture.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmimagecapture_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediacapturesession.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediacapturesession_p.h create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediarecorder.cpp create mode 100644 src/plugins/multimedia/wasm/mediacapture/qwasmmediarecorder_p.h create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmmediaplayer.cpp create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmmediaplayer_p.h create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmvideosink.cpp create mode 100644 src/plugins/multimedia/wasm/mediaplayer/qwasmvideosink_p.h create mode 100644 src/plugins/multimedia/wasm/qwasmmediaintegration.cpp create mode 100644 src/plugins/multimedia/wasm/qwasmmediaintegration_p.h create mode 100644 src/plugins/multimedia/wasm/wasm.json create mode 100644 src/plugins/multimedia/windows/CMakeLists.txt create mode 100644 src/plugins/multimedia/windows/common/mfmetadata.cpp create mode 100644 src/plugins/multimedia/windows/common/mfmetadata_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfaudiodecodercontrol.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfaudiodecodercontrol_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereader.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereader_p.h create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereadercallback.cpp create mode 100644 src/plugins/multimedia/windows/decoder/mfdecodersourcereadercallback_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrcustompresenter.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrcustompresenter_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrd3dpresentengine.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrd3dpresentengine_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrhelpers.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrhelpers_p.h create mode 100644 src/plugins/multimedia/windows/evr/evrvideowindowcontrol.cpp create mode 100644 src/plugins/multimedia/windows/evr/evrvideowindowcontrol_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowscamera.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowscamera_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsimagecapture.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsimagecapture_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediacapture.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediacapture_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicereader.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicereader_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicesession.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediadevicesession_p.h create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediaencoder.cpp create mode 100644 src/plugins/multimedia/windows/mediacapture/qwindowsmediaencoder_p.h create mode 100644 src/plugins/multimedia/windows/mfstream.cpp create mode 100644 src/plugins/multimedia/windows/mfstream_p.h create mode 100644 src/plugins/multimedia/windows/player/mfactivate.cpp create mode 100644 src/plugins/multimedia/windows/player/mfactivate_p.h create mode 100644 src/plugins/multimedia/windows/player/mfevrvideowindowcontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfevrvideowindowcontrol_p.h create mode 100644 src/plugins/multimedia/windows/player/mfplayercontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfplayercontrol_p.h create mode 100644 src/plugins/multimedia/windows/player/mfplayersession.cpp create mode 100644 src/plugins/multimedia/windows/player/mfplayersession_p.h create mode 100644 src/plugins/multimedia/windows/player/mfvideorenderercontrol.cpp create mode 100644 src/plugins/multimedia/windows/player/mfvideorenderercontrol_p.h create mode 100644 src/plugins/multimedia/windows/qwindowsformatinfo.cpp create mode 100644 src/plugins/multimedia/windows/qwindowsformatinfo_p.h create mode 100644 src/plugins/multimedia/windows/qwindowsintegration.cpp create mode 100644 src/plugins/multimedia/windows/qwindowsintegration_p.h create mode 100644 src/plugins/multimedia/windows/qwindowsvideodevices.cpp create mode 100644 src/plugins/multimedia/windows/qwindowsvideodevices_p.h create mode 100644 src/plugins/multimedia/windows/sourceresolver.cpp create mode 100644 src/plugins/multimedia/windows/sourceresolver_p.h create mode 100644 src/plugins/multimedia/windows/windows.json create mode 100644 src/resonance-audio/CMakeLists.txt create mode 100644 src/resonance-audio/resonance_audio.cpp create mode 100644 src/resonance-audio/resonance_audio.h create mode 100644 src/spatialaudio/CMakeLists.txt create mode 100644 src/spatialaudio/doc/qtspatialaudio.qdocconf create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-cpp.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-examples.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-index.qdoc create mode 100644 src/spatialaudio/doc/src/qtspatialaudio-qml-types.qdoc create mode 100644 src/spatialaudio/doc/src/spatialaudiooverview.qdoc create mode 100644 src/spatialaudio/qambientsound.cpp create mode 100644 src/spatialaudio/qambientsound.h create mode 100644 src/spatialaudio/qambientsound_p.h create mode 100644 src/spatialaudio/qambisonicdecoder.cpp create mode 100644 src/spatialaudio/qambisonicdecoder_p.h create mode 100644 src/spatialaudio/qambisonicdecoderdata_p.h create mode 100644 src/spatialaudio/qaudioengine.cpp create mode 100644 src/spatialaudio/qaudioengine.h create mode 100644 src/spatialaudio/qaudioengine_p.h create mode 100644 src/spatialaudio/qaudiolistener.cpp create mode 100644 src/spatialaudio/qaudiolistener.h create mode 100644 src/spatialaudio/qaudioroom.cpp create mode 100644 src/spatialaudio/qaudioroom.h create mode 100644 src/spatialaudio/qaudioroom_p.h create mode 100644 src/spatialaudio/qspatialsound.cpp create mode 100644 src/spatialaudio/qspatialsound.h create mode 100644 src/spatialaudio/qspatialsound_p.h create mode 100644 src/spatialaudio/qtspatialaudioglobal.h create mode 100644 src/spatialaudio/qtspatialaudioglobal_p.h create mode 100644 src/spatialaudioquick3d/CMakeLists.txt create mode 100644 src/spatialaudioquick3d/qquick3dambientsound.cpp create mode 100644 src/spatialaudioquick3d/qquick3dambientsound_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudio-qml-types.qdoc create mode 100644 src/spatialaudioquick3d/qquick3daudioengine.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudioengine_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudiolistener.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudiolistener_p.h create mode 100644 src/spatialaudioquick3d/qquick3daudioroom.cpp create mode 100644 src/spatialaudioquick3d/qquick3daudioroom_p.h create mode 100644 src/spatialaudioquick3d/qquick3dspatialaudio_plugin.cpp create mode 100644 src/spatialaudioquick3d/qquick3dspatialsound.cpp create mode 100644 src/spatialaudioquick3d/qquick3dspatialsound_p.h create mode 100644 src/spatialaudioquick3d/qtquick3daudioglobal_p.h create mode 100644 src/spatialaudioquick3d/qtquick3daudiotypes_p.h create mode 100644 tests/CMakeLists.txt create mode 100644 tests/auto/CMakeLists.txt create mode 100644 tests/auto/cmake/CMakeLists.txt create mode 100644 tests/auto/integration/CMakeLists.txt create mode 100644 tests/auto/integration/backends/CMakeLists.txt create mode 100644 tests/auto/integration/backends/tst_backends.cpp create mode 100644 tests/auto/integration/multiapp/CMakeLists.txt create mode 100644 tests/auto/integration/multiapp/double-drop.wav create mode 100644 tests/auto/integration/multiapp/tst_multiapp.cpp create mode 100644 tests/auto/integration/qaudiodecoderbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-corrupted.wav create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-no-audio-track.mp4 create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test-unsupported.avi create mode 100644 tests/auto/integration/qaudiodecoderbackend/testdata/test.wav create mode 100644 tests/auto/integration/qaudiodecoderbackend/tst_qaudiodecoderbackend.cpp create mode 100644 tests/auto/integration/qaudiodevicebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiodevicebackend/tst_qaudiodevicebackend.cpp create mode 100644 tests/auto/integration/qaudiosink/BLACKLIST create mode 100644 tests/auto/integration/qaudiosink/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiosink/tst_qaudiosink.cpp create mode 100644 tests/auto/integration/qaudiosource/CMakeLists.txt create mode 100644 tests/auto/integration/qaudiosource/Info.plist create mode 100644 tests/auto/integration/qaudiosource/tst_qaudiosource.cpp create mode 100644 tests/auto/integration/qcamerabackend/BLACKLIST create mode 100644 tests/auto/integration/qcamerabackend/CMakeLists.txt create mode 100644 tests/auto/integration/qcamerabackend/Info.plist create mode 100644 tests/auto/integration/qcamerabackend/tst_qcamerabackend.cpp create mode 100644 tests/auto/integration/qmediacapturesession/BLACKLIST create mode 100644 tests/auto/integration/qmediacapturesession/CMakeLists.txt create mode 100644 tests/auto/integration/qmediacapturesession/Info.plist create mode 100644 tests/auto/integration/qmediacapturesession/tst_qmediacapturesession.cpp create mode 100644 tests/auto/integration/qmediaformatbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaformatbackend/tst_qmediaformatbackend.cpp create mode 100644 tests/auto/integration/qmediaframeinputsbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaframeinputsbackend/tst_qmediaframeinputsbackend.cpp create mode 100644 tests/auto/integration/qmediaframeinputsbackend/tst_qmediaframeinputsbackend.h create mode 100644 tests/auto/integration/qmediaplayer_concurrent/3colors_with_sound_1s.mp4 create mode 100644 tests/auto/integration/qmediaplayer_concurrent/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayer_concurrent/tst_qmediaplayer_concurrent.cpp create mode 100644 tests/auto/integration/qmediaplayerbackend/BLACKLIST create mode 100644 tests/auto/integration/qmediaplayerbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayerbackend/LazyLoad.qml create mode 100644 tests/auto/integration/qmediaplayerbackend/fake.h create mode 100644 tests/auto/integration/qmediaplayerbackend/fixture.h create mode 100644 tests/auto/integration/qmediaplayerbackend/mediaplayerstate.h create mode 100644 tests/auto/integration/qmediaplayerbackend/server.h create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/15s.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/3colors_with_sound_1s.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/BigBuckBunny.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/_test.wav create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/audio_video_with_jpg_thumbnail.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/audio_video_with_png_thumbnail.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/busAv1.webm create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/busMpeg4.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_180_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_180_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_270_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_270_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_90_deg_clockwise.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_90_deg_clockwise_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/color_matrix_mirrored.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/colors.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/colors.ogv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/corrupt_end.ogg create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/duration_issues.webm create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/h264_avc1_yuv420p10le_tv_bt2020.mov create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/invalid_media.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/invalid_media2.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/multitrack-subtitle-start-at-zero.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/multitrack.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nested1.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nested2.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nokia-tune.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/nokia-tune.mp3 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/one_red_frame.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/par_2_3.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/par_3_2.mp4 create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/recursive.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/recursive_master.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/sample.m3u create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/subtitletest.mkv create mode 100644 tests/auto/integration/qmediaplayerbackend/testdata/test.wav create mode 100644 tests/auto/integration/qmediaplayerbackend/tst_qmediaplayerbackend.cpp create mode 100644 tests/auto/integration/qmediaplayerformatsupport/CMakeLists.txt create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/README.md create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.avi create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mkv create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.mpeg create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/supported/container.wmv create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/containers/unsupported/container.webp create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/flipable.gif create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_bgr0.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_bgr24.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_gray.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_gray10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv12.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv16.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_nv21.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_rgb24.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv420p10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv422p10le.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv444p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuv444p10.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj420p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj422p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/testdata/pixel_formats/supported/h264_yuvj444p.mp4 create mode 100644 tests/auto/integration/qmediaplayerformatsupport/tst_qmediaplayerformatsupport.cpp create mode 100644 tests/auto/integration/qmediarecorderbackend/CMakeLists.txt create mode 100644 tests/auto/integration/qmediarecorderbackend/tst_qmediarecorderbackend.cpp create mode 100644 tests/auto/integration/qml/CMakeLists.txt create mode 100644 tests/auto/integration/qml/soundeffect/tst_soundeffect.qml create mode 100644 tests/auto/integration/qml/tst_qml.cpp create mode 100644 tests/auto/integration/qquickvideooutput/CMakeLists.txt create mode 100644 tests/auto/integration/qquickvideooutput/main.qml create mode 100644 tests/auto/integration/qquickvideooutput/tst_qquickvideooutput.cpp create mode 100644 tests/auto/integration/qquickvideooutput_window/CMakeLists.txt create mode 100644 tests/auto/integration/qquickvideooutput_window/main.qml create mode 100644 tests/auto/integration/qquickvideooutput_window/tst_qquickvideooutput_window.cpp create mode 100644 tests/auto/integration/qscreencapturebackend/BLACKLIST create mode 100644 tests/auto/integration/qscreencapturebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qscreencapturebackend/android/AndroidManifest.xml create mode 100644 tests/auto/integration/qscreencapturebackend/tst_qscreencapturebackend.cpp create mode 100644 tests/auto/integration/qsoundeffect/CMakeLists.txt create mode 100644 tests/auto/integration/qsoundeffect/test.wav create mode 100644 tests/auto/integration/qsoundeffect/test_corrupted.wav create mode 100644 tests/auto/integration/qsoundeffect/test_tone.wav create mode 100644 tests/auto/integration/qsoundeffect/tst_qsoundeffect.cpp create mode 100644 tests/auto/integration/qsoundeffect_concurrent/CMakeLists.txt create mode 100644 tests/auto/integration/qsoundeffect_concurrent/double-drop.wav create mode 100644 tests/auto/integration/qsoundeffect_concurrent/tst_qsoundeffect_concurrent.cpp create mode 100644 tests/auto/integration/qvideoframebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qvideoframebackend/testdata/colors.mp4 create mode 100644 tests/auto/integration/qvideoframebackend/testdata/one_red_frame.mp4 create mode 100644 tests/auto/integration/qvideoframebackend/tst_qvideoframebackend.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/BLACKLIST create mode 100644 tests/auto/integration/qwindowcapturebackend/CMakeLists.txt create mode 100644 tests/auto/integration/qwindowcapturebackend/fixture.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/fixture.h create mode 100644 tests/auto/integration/qwindowcapturebackend/grabber.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/grabber.h create mode 100644 tests/auto/integration/qwindowcapturebackend/tst_qwindowcapturebackend.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/widget.cpp create mode 100644 tests/auto/integration/qwindowcapturebackend/widget.h create mode 100755 tests/auto/runautotests.py create mode 100644 tests/auto/unit/CMakeLists.txt create mode 100644 tests/auto/unit/mockbackend/CMakeLists.txt create mode 100644 tests/auto/unit/mockbackend/mock.json create mode 100644 tests/auto/unit/mockbackend/qmockaudiodecoder.cpp create mode 100644 tests/auto/unit/mockbackend/qmockaudiodecoder.h create mode 100644 tests/auto/unit/mockbackend/qmockaudiodevices.cpp create mode 100644 tests/auto/unit/mockbackend/qmockaudiodevices.h create mode 100644 tests/auto/unit/mockbackend/qmockaudiooutput.h create mode 100644 tests/auto/unit/mockbackend/qmockcamera.cpp create mode 100644 tests/auto/unit/mockbackend/qmockcamera.h create mode 100644 tests/auto/unit/mockbackend/qmockimagecapture.cpp create mode 100644 tests/auto/unit/mockbackend/qmockimagecapture.h create mode 100644 tests/auto/unit/mockbackend/qmockintegration.cpp create mode 100644 tests/auto/unit/mockbackend/qmockintegration.h create mode 100644 tests/auto/unit/mockbackend/qmockmediacapturesession.h create mode 100644 tests/auto/unit/mockbackend/qmockmediaencoder.h create mode 100644 tests/auto/unit/mockbackend/qmockmediaplayer.h create mode 100644 tests/auto/unit/mockbackend/qmocksurfacecapture.h create mode 100644 tests/auto/unit/mockbackend/qmockvideobuffer.h create mode 100644 tests/auto/unit/mockbackend/qmockvideosink.h create mode 100644 tests/auto/unit/multimedia/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/gstreamer_backend/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/gstreamer_backend/color_matrix_90_deg_clockwise.mp4 create mode 100644 tests/auto/unit/multimedia/gstreamer_backend/metadata_test_file.mp4 create mode 100644 tests/auto/unit/multimedia/gstreamer_backend/tst_gstreamer_backend.cpp create mode 100644 tests/auto/unit/multimedia/gstreamer_backend/tst_gstreamer_backend.h create mode 100644 tests/auto/unit/multimedia/qabstractvideobuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qabstractvideobuffer/tst_qabstractvideobuffer.cpp create mode 100644 tests/auto/unit/multimedia/qaudiobuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiobuffer/tst_qaudiobuffer.cpp create mode 100644 tests/auto/unit/multimedia/qaudiodecoder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiodecoder/tst_qaudiodecoder.cpp create mode 100644 tests/auto/unit/multimedia/qaudiodevice/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiodevice/tst_qaudiodevice.cpp create mode 100644 tests/auto/unit/multimedia/qaudioformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudioformat/tst_qaudioformat.cpp create mode 100644 tests/auto/unit/multimedia/qaudionamespace/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudionamespace/tst_qaudionamespace.cpp create mode 100644 tests/auto/unit/multimedia/qaudiorecorder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiorecorder/tst_qaudiorecorder.cpp create mode 100644 tests/auto/unit/multimedia/qaudioringbuffer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudioringbuffer/tst_qaudioringbuffer.cpp create mode 100644 tests/auto/unit/multimedia/qaudiostatemachine/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qaudiostatemachine/tst_qaudiostatemachine.cpp create mode 100644 tests/auto/unit/multimedia/qcamera/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qcamera/tst_qcamera.cpp create mode 100644 tests/auto/unit/multimedia/qcameradevice/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qcameradevice/tst_qcameradevice.cpp create mode 100644 tests/auto/unit/multimedia/qerrorinfo/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qerrorinfo/tst_qerrorinfo.cpp create mode 100644 tests/auto/unit/multimedia/qimagecapture/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qimagecapture/tst_qimagecapture.cpp create mode 100644 tests/auto/unit/multimedia/qmaybe/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmaybe/tst_qmaybe.cpp create mode 100644 tests/auto/unit/multimedia/qmediacapture_gstreamer/BLACKLIST create mode 100644 tests/auto/unit/multimedia/qmediacapture_gstreamer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediacapture_gstreamer/tst_qmediacapture_gstreamer.cpp create mode 100644 tests/auto/unit/multimedia/qmediadevices/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediadevices/tst_qmediadevices.cpp create mode 100644 tests/auto/unit/multimedia/qmediaformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaformat/tst_qmediaformat.cpp create mode 100644 tests/auto/unit/multimedia/qmediametadata/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediametadata/tst_qmediametadata.cpp create mode 100644 tests/auto/unit/multimedia/qmediaplayer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaplayer/testdata/nokia-tune.mp3 create mode 100644 tests/auto/unit/multimedia/qmediaplayer/tst_qmediaplayer.cpp create mode 100644 tests/auto/unit/multimedia/qmediaplayer_gstreamer/BLACKLIST create mode 100644 tests/auto/unit/multimedia/qmediaplayer_gstreamer/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaplayer_gstreamer/testdata/color_matrix.mp4 create mode 100644 tests/auto/unit/multimedia/qmediaplayer_gstreamer/tst_qmediaplayer_gstreamer.cpp create mode 100644 tests/auto/unit/multimedia/qmediaplayer_gstreamer/tst_qmediaplayer_gstreamer.h create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/empty.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/test.m3u create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/test.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/testfile create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/testfile2#suffix create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/testdata/totem-pl-example.pls create mode 100644 tests/auto/unit/multimedia/qmediaplaylist/tst_qmediaplaylist.cpp create mode 100644 tests/auto/unit/multimedia/qmediarecorder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediarecorder/tst_qmediarecorder.cpp create mode 100644 tests/auto/unit/multimedia/qmediastoragelocation/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediastoragelocation/tst_qmediastoragelocation.cpp create mode 100644 tests/auto/unit/multimedia/qmediatimerange/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmediatimerange/tst_qmediatimerange.cpp create mode 100644 tests/auto/unit/multimedia/qmultimediautils/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qmultimediautils/tst_qmultimediautils.cpp create mode 100644 tests/auto/unit/multimedia/qrhivaluemapper/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qrhivaluemapper/tst_qrhivaluemapper.cpp create mode 100644 tests/auto/unit/multimedia/qsamplecache/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/corrupted.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/test.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/testdata/test2.wav create mode 100644 tests/auto/unit/multimedia/qsamplecache/tst_qsamplecache.cpp create mode 100644 tests/auto/unit/multimedia/qscreencapture/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qscreencapture/tst_qscreencapture.cpp create mode 100644 tests/auto/unit/multimedia/qvideobuffers/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideobuffers/tst_qvideobuffers.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframe/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframe/tst_qvideoframe.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframe_nogui/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframe_nogui/tst_qvideoframe_nogui.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_abgr8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_argb8888_premultiplied_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgra8888_premultiplied_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_bgrx8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc1_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc2_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc3_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_imc4_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv12_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_nv21_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p010_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_p016_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgba8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_rgbx8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_uyvy_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xbgr8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_xrgb8888_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y16_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_y8_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p10_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv420p_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuv422p_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yuyv_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_adobergb_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt2020_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt601_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_full.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_full_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_video.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/testdata/umbrellas.jpg_yv12_bt709_video_cpu.png create mode 100644 tests/auto/unit/multimedia/qvideoframecolormanagement/tst_qvideoframecolormanagement.cpp create mode 100644 tests/auto/unit/multimedia/qvideoframeformat/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideoframeformat/tst_qvideoframeformat.cpp create mode 100644 tests/auto/unit/multimedia/qvideotexturehelper/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideotexturehelper/tst_qvideotexturehelper.cpp create mode 100644 tests/auto/unit/multimedia/qvideotransformation/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qvideotransformation/tst_qvideotransformation.cpp create mode 100644 tests/auto/unit/multimedia/qwavedecoder/CMakeLists.txt create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_datadesc_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_fmtdesc_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/corrupt_fmtstring_1_16_8000.le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/empty.wav create mode 100755 tests/auto/unit/multimedia/qwavedecoder/data/gendata.sh create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_44100_le_2.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_16_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_24_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_24_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_32_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_32_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_44100.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000_even_bext.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_8_8000_odd_bext.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_f32_44100_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_1_f32_8000_le.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_16_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_16_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_24_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_24_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_32_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_32_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_8_44100.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_8_8000.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_f32_44100_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/isawav_2_f32_8000_be.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/nosampledata.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/notawav.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/data/onebyte.wav create mode 100644 tests/auto/unit/multimedia/qwavedecoder/tst_qwavedecoder.cpp create mode 100644 tests/auto/unit/multimediawidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qcamerawidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qcamerawidgets/tst_qcamerawidgets.cpp create mode 100644 tests/auto/unit/multimediawidgets/qgraphicsvideoitem/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qgraphicsvideoitem/tst_qgraphicsvideoitem.cpp create mode 100644 tests/auto/unit/multimediawidgets/qmediaplayerwidgets/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qmediaplayerwidgets/tst_qmediaplayerwidgets.cpp create mode 100644 tests/auto/unit/multimediawidgets/qvideowidget/CMakeLists.txt create mode 100644 tests/auto/unit/multimediawidgets/qvideowidget/tst_qvideowidget.cpp create mode 100644 tests/global/global.cfg create mode 100644 tests/manual/CMakeLists.txt create mode 100644 tests/manual/audiodecoder/CMakeLists.txt create mode 100644 tests/manual/audiodecoder/audiodecoder.cpp create mode 100644 tests/manual/audiodecoder/audiodecoder.h create mode 100644 tests/manual/audiodecoder/audiodecoder.pro create mode 100644 tests/manual/audiodecoder/main.cpp create mode 100644 tests/manual/devices/CMakeLists.txt create mode 100644 tests/manual/devices/devices.pro create mode 100644 tests/manual/devices/main.cpp create mode 100644 tests/manual/gstreamer-custom-camera-rtp/CMakeLists.txt create mode 100644 tests/manual/gstreamer-custom-camera-rtp/Info.plist.in create mode 100644 tests/manual/gstreamer-custom-camera-rtp/gstreamer-custom-camera-rtp.cpp create mode 100644 tests/manual/gstreamer-custom-camera/CMakeLists.txt create mode 100644 tests/manual/gstreamer-custom-camera/Info.plist.in create mode 100644 tests/manual/gstreamer-custom-camera/gstreamer-custom-camera.cpp create mode 100644 tests/manual/media-metadata/CMakeLists.txt create mode 100644 tests/manual/media-metadata/Info.plist.in create mode 100644 tests/manual/media-metadata/media-metadata.cpp create mode 100644 tests/manual/mediaformats/CMakeLists.txt create mode 100644 tests/manual/mediaformats/main.cpp create mode 100644 tests/manual/mediaframeinputs/CMakeLists.txt create mode 100644 tests/manual/mediaframeinputs/commandlineparser.cpp create mode 100644 tests/manual/mediaframeinputs/commandlineparser.h create mode 100644 tests/manual/mediaframeinputs/main.cpp create mode 100644 tests/manual/mediaframeinputs/mediaframeinputqueue.h create mode 100644 tests/manual/mediaframeinputs/mediagenerator.cpp create mode 100644 tests/manual/mediaframeinputs/mediagenerator.h create mode 100644 tests/manual/mediaframeinputs/previewrunner.cpp create mode 100644 tests/manual/mediaframeinputs/previewrunner.h create mode 100644 tests/manual/mediaframeinputs/pushmodemediasource.h create mode 100644 tests/manual/mediaframeinputs/recordingrunner.cpp create mode 100644 tests/manual/mediaframeinputs/recordingrunner.h create mode 100644 tests/manual/mediaframeinputs/settings.h create mode 100644 tests/manual/minimal-audio-recorder/CMakeLists.txt create mode 100644 tests/manual/minimal-audio-recorder/info.plist.in create mode 100644 tests/manual/minimal-audio-recorder/minimal-audio-recorder.cpp create mode 100644 tests/manual/minimal-player/CMakeLists.txt create mode 100644 tests/manual/minimal-player/Info.plist.in create mode 100644 tests/manual/minimal-player/minimal-player.cpp create mode 100644 tests/manual/minimal-screen-recorder/CMakeLists.txt create mode 100644 tests/manual/minimal-screen-recorder/Info.plist.in create mode 100644 tests/manual/minimal-screen-recorder/minimal-screen-recorder.cpp create mode 100644 tests/manual/qml-gstreamer-pipeline/CMakeLists.txt create mode 100644 tests/manual/qml-gstreamer-pipeline/Info.plist.in create mode 100644 tests/manual/qml-gstreamer-pipeline/qml-gstreamer-pipeline.cpp create mode 100644 tests/manual/qml-gstreamer-pipeline/qml-gstreamer-pipeline.qml create mode 100644 tests/manual/qml-gstreamer-rtp/CMakeLists.txt create mode 100644 tests/manual/qml-gstreamer-rtp/Info.plist.in create mode 100644 tests/manual/qml-gstreamer-rtp/qml-gstreamer-rtp.cpp create mode 100644 tests/manual/qml-gstreamer-rtp/qml-gstreamer-rtp.qml create mode 100644 tests/manual/qml-minimal-audio-recorder/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-audio-recorder/Info.plist.in create mode 100644 tests/manual/qml-minimal-audio-recorder/qml-minimal-audio-recorder.cpp create mode 100644 tests/manual/qml-minimal-audio-recorder/qml-minimal-audio-recorder.qml create mode 100644 tests/manual/qml-minimal-camera/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-camera/Info.plist.in create mode 100644 tests/manual/qml-minimal-camera/qml-minimal-camera.cpp create mode 100644 tests/manual/qml-minimal-camera/qml-minimal-camera.qml create mode 100644 tests/manual/qml-minimal-player/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-player/Info.plist.in create mode 100644 tests/manual/qml-minimal-player/qml-minimal-player.cpp create mode 100644 tests/manual/qml-minimal-player/qml-minimal-player.qml create mode 100644 tests/manual/qml-minimal-sound-effect/CMakeLists.txt create mode 100644 tests/manual/qml-minimal-sound-effect/Info.plist.in create mode 100644 tests/manual/qml-minimal-sound-effect/double-drop.wav create mode 100644 tests/manual/qml-minimal-sound-effect/qml-minimal-sound-effect.cpp create mode 100644 tests/manual/qml-minimal-sound-effect/qml-minimal-sound-effect.qml create mode 100644 tests/manual/qml-minimal-sound-effect/triple-click.wav create mode 100644 tests/manual/wasm/CMakeLists.txt create mode 100644 tests/manual/wasm/camera/CMakeLists.txt create mode 100644 tests/manual/wasm/camera/camera-test.pro create mode 100644 tests/manual/wasm/camera/main.cpp create mode 100644 tests/manual/wasm/camera/mainwindow.cpp create mode 100644 tests/manual/wasm/camera/mainwindow.h create mode 100644 tests/manual/wasm/camera/mainwindow.ui create mode 100644 util/REUSE.toml create mode 100644 util/adt_generate_qt.m create mode 100644 util/macos_test_audio_config/CMakeLists.txt create mode 100644 util/macos_test_audio_config/README create mode 100755 util/macos_test_audio_config/compile_and_run.sh create mode 100644 util/macos_test_audio_config/main.cpp diff --git a/.QT-ENTERPRISE-LICENSE-AGREEMENT b/.QT-ENTERPRISE-LICENSE-AGREEMENT new file mode 100644 index 0000000..2d225ec --- /dev/null +++ b/.QT-ENTERPRISE-LICENSE-AGREEMENT @@ -0,0 +1,262 @@ +Qt Frame Agreement +Version 2024-02 + +1. PARTIES OF THIS AGREEMENT +1.1. This Qt Frame Agreement—comprised of these general terms together with the appendices attached hereto, (hereinafter “Agreement”) is made by and between: The Qt Company, as defined below (hereinafter ”The Qt Company”) AND Customer name (hereinafter “Customer"):___________________ Business Id (e.g. VAT or EIN number):___________________ +1.2. The parties above are hereinafter individually referred to as a "Party" and collectively as the "Parties". + +2. STRUCTURE AND OBJECT OF THE AGREEMENT +2.1. The Parties have entered into this Agreement to agree on the terms and conditions applicable to The Qt Company's delivery of products and services ("Services") to Customer. +2.2. This Agreement is comprised of the following components: +(i) This Agreement, which contains the general terms applicable to all Services, +(ii) Appendices for each of the Services, containing terms applicable to that individual set of Services ("Service Terms"), +(iii) a Qt Appendix for Pricing, if applicable, which contains pricing for specific Services, and +(iv) other topic-specific appendices, such as Support or Marketing Rights. +2.3. Any and all Services purchased shall be specified in, and agreed upon between, the Parties under a separate purchase order, statement of work, quote, or similar document ("Purchase Document"). Each Purchase Document concluded under this Agreement shall include a reference to this Agreement and be governed by this Agreement. + +3. DEFINITIONS +3.1. "Affiliate" of a Party shall mean an entity (i) which is directly or indirectly controlling such Party; (ii) which is under the same direct or indirect ownership or control as such Party; or (iii) which is directly or indirectly owned or controlled by such Party. For these purposes, an entity shall be treated as being controlled by another if that other entity has fifty percent (50 %) or more of the votes in such entity, is able to direct its affairs and/or to control the composition of its board of directors or equivalent body. +3.2. "Contractor" shall mean third-party consultants, distributors and contractors performing services to Customer under an applicable contractual arrangement. +3.3. "Customer" shall mean the individual or legal entity specified in Section 1 above, that is a Party to this Agreement. +3.4. "Force Majeure Event" shall have the meaning set forth in Section 11.7. +3.5. "Licensed Software" shall mean The Qt Company's commercial software product which is licensed for use by Customer under this Agreement and corresponding Service Terms. Licensed Software shall include, if and to the extent applicable and specified in the applicable relevant Service Terms, corresponding online or electronic documentation, associated media and printed materials, including the source code, and example programs. The Qt Company may in the course of its development activities, at its free and absolute discretion and without any obligation to send or publish any notifications to Customer or in general, make changes, additions or deletions in the components and functionalities of the Licensed Software, provided that no such changes, additions or deletions will affect the already released version of the Licensed Software, but only upcoming version(s). Licensed Software is commercial computer software, developed at private expense and offered to the public under standard commercial terms. +3.6. "Professional Services" shall mean The Qt Company's professional-, consulting-, training- and/or project services delivered to Customer under this Agreement and specified in a Purchase Document. +3.7. "Support" shall mean maintenance and support services provided by The Qt Company to assist Customer in using the Licensed Software, as further specified in the Appendix for Support Terms. +3.8. "The Qt Company" shall mean: +(i) in the event Customer is an entity residing in the United States or a legal entity incorporated in or having its headquarters in the United States, The Qt Company Inc., a Delaware corporation with its office at 3031 Tisch Way, 110 Plaza West, San Jose, CA 95128, USA.; or +(ii) in the event Customer is an entity residing outside of the United States or a legal entity incorporated or having its registered office outside of the United States, The Qt Company Oy., a Finnish company with its registered office at Miestentie 7, 02150 Espoo, Finland. + +4. PRICES AND PAYMENT +4.1. The Qt Company agrees to make Services available to Customer subject to the prices set forth in the Appendix for Pricing. In the event that the Appendix for Pricing does not include a price for certain Services, the applicable price shall be the price agreed by the Parties in the respective Purchase Document. +4.2. All prices are exclusive of value added tax or other taxes, levels, or duties. Value added tax as well as other possible public charges imposed by authorities shall be added to the prices. +4.3. All fees under this Agreement are non-cancellable and non-refundable. +4.4. All fees under this Agreement shall be paid by Customer no later than thirty (30) days from the date of the applicable invoice from The Qt Company. +4.5. Unless otherwise agreed or provided in the respective Service Terms or Purchase Document, The Qt Company will invoice fees for: +4.5.1. Licensed Software and Support in advance upon conclusion of the Purchase Document, and +4.5.2. Professional Services monthly in arrears after the Service has been performed. +4.6. A late payment charge of the lower of: (a) one percent (1%) per month; or (b) the highest interest rate stipulated by applicable law, shall be charged on any unpaid balances that remain past due and which have not been disputed by Customer in good faith within thirty (30) days of receipt of invoice from The Qt Company. +4.7. The Qt Company may either (i) invoice Customer based on existing agreement, (ii) request Customer to place a purchase order corresponding to a quote by The Qt Company, or (iii) use Customer's stored Credit Card information to automatically charge the Customer for the relevant Renewal Term. +4.8. Unless and to the extent otherwise agreed in the Appendix for Pricing or in the Purchase Document, The Qt Company shall be entitled to adjust the prices set forth in the Appendix for Pricing by notifying Customer of the change in writing at least sixty (60) days before the effective date of the change. The change shall not affect the current pricing term of Services agreed upon before the effective date of the change. + +5. CONFIDENTIALITY +5.1. The Parties shall keep confidential, and shall not use or disclose to any unauthorized third parties, the existence and content of this Agreement as well as any Confidential Information received from the other Party or otherwise learned in connection with the Agreement or the performance of the Services, without the prior written consent of the other Party. Confidential Information shall mean information that is designated as confidential or that would be reasonably understood to be confidential given the circumstances of disclosure and the nature of the information. The Parties shall not use Confidential Information received from the other Party for any other purposes than the performance of the Agreement or the fulfilment of their rights and obligations hereunder. +5.2. Each Party shall limit access the other Party's Confidential Information only to those of its employees, subcontractors, Contractors, Affiliates or financial or legal advisors who necessarily need access to the Confidential Information for the proper performance of the Party's rights and obligations under the Agreement. Each Party shall ensure that the persons receiving Confidential Information of the other Party are bound by confidentiality obligations not less restrictive than those stipulated herein. +5.3. Each Party shall protect the confidentiality of the other Party's Confidential Information with at least the same degree of security as it exercises to its own confidential information, but no less than a standard of reasonable care. +5.4. The confidentiality obligation stipulated herein shall not be applied to material and information which: +(iii) has become generally available or otherwise public prior to its submission by the other Party; +(iv) becomes generally available or otherwise public due to a reason other than the negligence or omission of the recipient or its personnel or other actions in violation of this Agreement or applicable legislation; +(v) the Party has lawfully received from a third party without any obligation of confidentiality; +(vi) was lawfully in the possession of the receiving Party prior to receipt of the same from the other Party without any obligation of confidentiality related thereto; +(vii) a Party has developed independently without using material or information received from the other Party; or +(viii) a Party must disclose pursuant to law, decree or other order issued by competent regulatory or governmental body or other public authority or a judicial order, in which case the Party shall, to the extent permitted by applicable law, inform the other Party in writing of the disclosure of information prior to such disclosure. +5.5. Each Party shall, upon request of the other Party at any time, including upon termination, cancellation or expiry of the Agreement, promptly destroy or deliver to the other Party any and all the documents, files, copies and material containing Confidential Information of the other Party. Notwithstanding the foregoing, a Party may retain one copy of the Confidential Information in a secure location, if and solely to the extent required to comply with applicable laws or regulations. Any Confidential Information stored in electronic back-up form shall be rendered inaccessible and destroyed in accordance with standard back-up procedures. + +6. INTELLECTUAL PROPERTY RIGHTS +6.1. Unless and to the extent expressly provided in the respective Service Terms, this Agreement carries no assignment or license to the intellectual property rights of either Party and all such rights are and shall remain the exclusive property of the Party to whom such rights are vested under applicable law at the signing of this Agreement or thereafter. +6.2. Where The Qt Company's delivery includes any materials owned by a third party, such third party materials shall be governed in all respects by the applicable license terms of such third-party right holders. The Qt Company shall duly inform the Customer whenever such third party materials are included in the Services and of applicable license terms to be followed by the Customer in using such third party materials. + +7. FEES AND ORDERING +7.1. Services Fees. Services Fees are described in the Purchase Document. +7.2. Ordering Services. +(i) Customer may purchase Services pursuant to agreed pricing terms or, if no specific pricing terms have been agreed upon, at The Qt Company's standard pricing terms applicable at the time of purchase. +(ii) Unless expressly otherwise agreed, any price or other term quoted to Customer shall only be valid for the thirty (30) days from the date such price has been quoted. + +8. LIMITED WARRANTY AND WARRANTY DISCLAIMER +8.1. The Qt Company hereby represents and warrants that: (i) it has the power and authority to grant the rights and licenses granted to Customer under this Agreement; (ii) the Licensed Software will operate materially in accordance with its specifications (as set forth in the applicable product documentation or, where relevant, program description); (iii) Professional Services and Support will be performed in a professional, workmanlike manner pursuant to the Agreement; and (iv) during the ten years prior to the effective date of this Agreement, there have not been any claims alleging that the Licensed Software has infringed any intellectual property rights of a third party and, to the knowledge of The Qt Company as of the effective date of this Agreement, no such infringement exists. These warranties do not apply to issues arising from, or relating to, any third-party materials or Customer's use of the Licensed Software in violation of applicable law or the terms of this Agreement. +8.2. Except to the extent set forth above, the Services are delivered to Customer "as is" and to the maximum extent permitted by applicable law, exclusive of other warranties, whether express, implied, or otherwise. Customer's sole and exclusive remedy and The Qt Company's entire liability for deficiencies or errors in the Services shall be limited, at The Qt Company's option, to correction of the error, replacement of the Services, re-performance of the Service or return of the applicable fees paid for the defective Service for the time period during which Customer was not able to utilize the Service as agreed. + +9. LIMITATION OF LIABILITY +9.1. EXCEPT FOR (I) CASES OF GROSS NEGLIGENCE OR INTENTIONAL MISCONDUCT, (II) A BREACH OR VIOLATION OF THE OTHER PARTY'S INTELLECTUAL PROPERTY RIGHTS, OR (III) WHERE REQUIRED BY APPLICABLE LAW, IN NO EVENT SHALL EITHER PARTY BE LIABLE TO THE OTHER PARTY FOR ANY LOST PROFITS, LOSS OF DATA, LOSS OF BUSINESS OR GOODWILL OR ANY OTHER INDIRECT, SPECIAL, CONSEQUENTIAL, INCIDENTAL OR PUNITIVE COST, DAMAGES OR EXPENSE OF ANY KIND, HOWSOEVER ARISING UNDER OR IN CONNECTION WITH THIS AGREEMENT. +9.2. EXCEPT FOR (I) CASES OF GROSS NEGLIGENCE OR INTENTIONAL MISCONDUCT, (II) A BREACH OR VIOLATION OF THE OTHER PARTY'S INTELLECTUAL PROPERTY RIGHTS, AND TO THE EXTENT PERMITTED BY APPLICABLE LAW, IN NO EVENT SHALL EITHER PARTY'S TOTAL AGGREGATE LIABILITY UNDER THIS AGREEMENT EXCEED THE AGGREGATE FEES PAID OR PAYABLE TO THE QT COMPANY BY CUSTOMER FOR THE RESPECTIVE LICENSED SOFTWARE OR SERVICE GIVING RISE TO THE LIABILITY. THE FOREGOING LIMITATION WILL NOT APPLY TO CUSTOMER'S OBLIGATION TO PAY THE APPLICABLE FEES CORRESPONDING TO ITS ACTUAL USE OF LICENSED SOFTWARE OR SERVICES. + +10. TERM AND TERMINATION +10.1. This Agreement shall enter into force upon signing by both Parties and is effective as of the last date of signature. +10.2. This Agreement shall remain in force until further notice and may be terminated without cause by either Party by no less than three (3) months' prior written notice to the other Party. +10.3. Termination of a particular Purchase Document and the Services governed thereunder shall be stipulated under the applicable Service Terms. +10.4. Either Party may terminate this Agreement with immediate effect, if the other Party: +(i) commits a material breach of the terms of this Agreement (including applicable Service Terms) and has not remedied such breach within a reasonable period of time (which shall be no less than thirty (30) days) of the non-breaching Party's written notice specifying the breach, or +(ii) becomes bankrupt, insolvent or goes into liquidation or debt restructuring. +10.5. Termination of this Agreement shall, as such, have no effect on the validity of any Services ordered and agreed prior to the effective date of such termination, and such Services shall continue to remain in force pursuant to applicable Service Terms (including the terms of this Agreement) for the remainder of the duration of the applicable Service validity term. + +11. GOVERNING LAW AND DISPUTE RESOLUTION +11.1. The United Nations Convention on Contracts for the International Sale of Goods will not apply to this Agreement. +11.2. Where this Agreement is concluded with The Qt Company, Inc., a Delaware corporation, the Parties agree that this Section 10.2 will apply. This Agreement will be governed by, and construed in accordance with the laws of the State of California and any controlling United States federal law. Any dispute, controversy or claim arising out of or relating to this contract, including the formation, interpretation, breach or termination thereof, and whether the claims asserted are arbitrable, will be referred to and finally determined by arbitration in accordance with the JAMS International Arbitration Rules. The tribunal will consist of one arbitrator. The place of arbitration will be San Francisco, California, USA. The language to be used in the arbitral proceedings will be English. Judgment upon the award rendered by the arbitrator(s) may be entered in any court having jurisdiction thereof. This Section 10.2 shall not preclude parties from seeking provisional remedies in aid of arbitration from a court of appropriate jurisdiction. Notwithstanding the foregoing, any action by The Qt Company solely to collect license or other fees hereunder may be brought in any court of competent jurisdiction. +11.3. Where this Agreement is concluded with The Qt Company, Oy., a Finnish company, the parties agree that this Section 10.3 will apply. This Agreement shall be construed and interpreted in accordance with the laws of Finland, excluding its choice of law provisions. All disputes arising out of or in connection with this Agreement shall be finally settled in accordance with the laws of Finland, excluding its choice of law provisions. All disputes arising out of or in connection with this Agreement shall be finally settled under the Rules of Arbitration of the International Chamber of Commerce by one or more arbitrators appointed in accordance with the said Rules. The place of arbitration will be Helsinki, Finland. The language to be used in arbitral proceedings will be English. This Section 10.3 shall not preclude parties from seeking provisional remedies in aid of arbitration from a court of appropriate jurisdiction. + +12. MISCELLANOUS +12.1. No Assignment. Customer shall not be entitled to assign or transfer all or any of its rights, benefits and obligations under this Agreement except in case of sale of relevant business or assets or otherwise with prior written consent of The Qt Company, which shall not be unreasonably withheld or delayed. The Qt Company shall be entitled to freely assign or transfer any of its rights, benefits or obligations under this Agreement. +12.2. Surviving Sections. Any terms and conditions that by their nature or otherwise reasonably should survive termination of this Agreement shall so be deemed to survive. +12.3. Entire Agreement. This Agreement, its Appendices and any applicable Purchase Documents constitute the complete agreement between the Parties and supersedes all prior or contemporaneous discussions, representations, contracts (including prior License Agreements and similar prior agreements), and proposals, written or oral, with respect to the subject matters discussed herein. +12.4. Subcontractors. The Qt Company may utilize subcontractors in the performance of Services under this Agreement, provided that The Qt Company remains responsible for the performance of the Services and compliance with this Agreement, as well as ensuring that subcontractors are required to abide by relevant restrictions (e.g., confidentiality) set forth in this Agreement. +12.5. Modifications. No modification of this Agreement shall be effective unless contained in a writing executed by an authorized representative of each Party. No standard terms and conditions or provisions of any Customer purchase order or other ordering form that Customer may use in connection with the acquisition of Services will modify or affect this Agreement, the parties agree that any such terms and conditions are void with no legal effect. +12.6. Affiliate Orders. Customer Affiliates may purchase Services via this Agreement as follows: +(i) any purchases by Customer Affiliates from The Qt Company or its Affiliates will create a contractual relationship directly between the relevant The Qt Company entity and the respective ordering Customer Affiliate; +(ii) the entry into a Purchase Document between The Qt Company and Customer Affiliate creates an agreement between The Qt Company and Customer Affiliate and incorporates all terms and conditions of this Agreement as the governing agreement between The Qt Company and Customer Affiliate ("Accession Agreement"): and +(iii) Customer Affiliate will be deemed "Customer" under the terms of this Agreement and all rights and obligations under such Accession Agreement are vested and borne solely by the ordering Customer Affiliate and the relevant The Qt Company entity as contracting parties under such Accession Agreement. +12.7. Force Majeure. Neither Party shall be liable to the other for any delay or non-performance of its obligations hereunder in the event and to the extent that such delay or non-performance is due to an event of act of God, terrorist attack or other similar unforeseeable catastrophic event that prevents either Party for fulfilling its obligations under this Agreement and which such Party cannot avoid or circumvent ("Force Majeure Event"). If the Force Majeure Event results in a delay or non-performance of a Party for a period of three (3) months or longer, then either Party shall have the right to terminate the relevant Purchase Document and Services thereunder with immediate effect without any liability (except for the obligations of payment arising prior to the Force Majeure Event) towards the other Party. +12.8. Notices. Any notice given by one Party to the other shall be deemed properly given and deemed received if specifically acknowledged by the receiving Party in writing or when successfully delivered to the recipient by hand, fax, or special courier during normal business hours on a business day to the addresses specified for each Party in this Agreement. Each communication and document made or delivered by one Party to the other Party pursuant to this Agreement shall be in the English language. +12.9. Attorney Fees. The prevailing Party in any action to enforce this Agreement shall be entitled to recover its attorney's fees and costs in connection with such action. +12.10. Privacy and Security. The Parties commit to and comply with their respective applicable obligations under the privacy and security terms set forth in the Privacy and Security Appendix and relevant Appendices attached hereto. +12.11. Feedback. Customer agrees that, from time to time, The Qt Company, may request feedback from Customer regarding the Services ("Feedback"). Customer may choose to provide Feedback and agrees that The Qt Company may freely use, copy, disclose, and exploit any Feedback. No Feedback will be considered Customer Confidential Information unless explicitly agreed otherwise between the Parties. +12.12. Export Control. Customer acknowledges that the Services, or portions thereof, may be subject to export control restrictions under the applicable laws of respective countries. Customer shall fully comply with all applicable export license restrictions and requirements, economic sanctions restrictions, as well as with all laws and regulations relating thereto, and shall procure all necessary governmental authorizations, including without limitation, all necessary licenses, approvals, permissions, or consents, where necessary (e.g., for re-exportation of the Redistributables, Applications and/or Devices, each as defined in the relevant Service Terms). +12.13. Severability. If any provision of this Agreement shall be adjudged by any court of competent jurisdiction to be unenforceable or invalid, that provision shall be limited or eliminated to the minimum extent necessary so that this Agreement shall otherwise remain in full force and effect and enforceable. + +13. APPENDICES +13.1. The following appendices form an integral part of this Agreement. In case of a discrepancy between this Agreement and any of its Appendices, this Agreement shall prevail. In case of discrepancies between the Purchase Document(s) and this Agreement or applicable Service Terms, the terms of this Agreement or the applicable Service Terms shall prevail, except in cases where an express deliberate deviation from the terms of this Agreement or applicable Service Terms has been concluded pursuant to Section 2.3 hereof, in which case the Purchase Document shall prevail. +1. Appendix for Qt Development Framework +2. Appendix for Support Terms https://www.qt.io/terms-conditions/support-terms +3. Appendix for Privacy and Security Terms https://www.qt.io/terms-conditions/privacy-and-security + +Appendix for Qt Development Framework +Version 2024-02 + +1. This Appendix for Qt Development Framework is an integral part of the Agreement and specifies the legal terms for the licensing of Licensed Software (as defined below) between The Qt Company and the Customer. Entry into this Appendix governs the use of and supersedes any prior contracts between the Parties (including prior License Agreements and similar prior agreements), with respect to the Licensed Software under this Appendix. + +2. DEFINITIONS +2.1. Capitalized words used in this Appendix shall have the meanings described in the Agreement or as defined below. +2.2. "Add-on Products" shall mean The Qt Company's specific add-on software products which are not licensed as part of The Qt Company's standard Services offerings, but shall be included into the scope of Licensed Software only if so specifically agreed between the Parties. +2.3. "Application" means software products created using the Licensed Software, which include the Redistributables, or part thereof. +2.4. "End Customer" shall mean Customer's customer(s) to whom Customer, directly or indirectly, distributes copies of the Redistributables as integrated or incorporated into Applications or Devices. +2.5. "Data Protection Legislation" shall mean the General Data Protection Regulation (EU 2016/679) (GDPR) and any national implementing laws, regulations and secondary legislation, as may be amended or updated from time to time, as well as any other data protection laws or regulations applicable in the relevant territory. +2.6. "Deployment Platforms" shall mean target operating systems and/or hardware specified in the License Certificate, on which the Redistributables can be distributed pursuant to the terms and conditions of this Appendix. +2.7. "Designated User(s)" shall mean the employee(s) of Customer or Customer's Affiliates acting within the scope of their employment or Customer's Contractors acting within the scope of their services on behalf of Customer. +2.8. "Development License" shall mean the license needed by the Customer for each Designated User to use Licensed Software under the license grant described in Section 5 of this Appendix. Development Licenses are available per respective Licensed Software products; each product having its designated scope and purpose of use. +2.9. "Development Platforms" shall mean the host operating system(s) specified in the License Certificate, on which Licensed Software can be used under the Development License. +2.10. "Devices" shall mean +(i) hardware devices or products that +a. are manufactured and/or distributed by the Customer, its Affiliates, Contractors or End Customer, and +b. incorporate, integrate or link to Applications such that substantial functionality of such unit, when used by an End User, is provided by Application(s) or otherwise depends on the Licensed Software; or +(ii) Applications designed for the hardware devices specified in item (i). +Devices covered by this Appendix shall be specified in the Pricing Appendix or Purchase Document. +2.11. "Distribution License(s)" shall mean a royalty-bearing license required for any kind of sale, trade, exchange, loan, lease, rental or other distribution by or on behalf of Customer to a third party of Redistributables in connection with Devices pursuant to license grant described in Section 5.3 of this Appendix. Distribution Licenses are sold separately for each type of Device respectively and cannot be used for any other type of Devices. +2.12. "Distribution License Packs" shall mean set of prepaid Distribution Licenses for distribution of Redistributables, as defined in The Qt Company's standard price list, quote, Pricing Appendix or in the Purchase Document, as applicable. +2.13. "Evaluation License Term" shall mean a time period specified in the License Certificate for the Customer to use the relevant Licensed Software for evaluation purposes according to Section 5.6 of this Appendix. +2.14. "Intellectual Property Rights" shall mean patents (including utility models), design patents, and designs (whether or not capable of registration), chip topography rights and other like protection, copyrights, trademarks, service marks, trade names, logos or other words or symbols and any other form of statutory protection of any kind and applications for any of the foregoing as well as any trade secrets. +2.15. "License Certificate" shall mean a certificate generated by The Qt Company for each Designated User respectively upon their download of the Licensed Software, which will be available under the respective Designated User's Qt Account at account.qt.io. License Certificates will specify relevant information pertaining to the Licensed Software purchased by Customer and the license to the Licensed Software. +2.16. "License Fee" shall mean the fee charged to Customer for rights granted under this Appendix. +2.17. "Licensed Software" shall mean the specified product(s) of Qt Software which Customer has purchased and which is provided to Customer under the terms of this Appendix (including its Exhibits). Licensed Software shall include corresponding online or electronic documentation, associated media and printed materials, including source code (where applicable), example programs and the documentation. Licensed Software does not include Third Party Software (as defined in Section 6) or Qt Community Edition. The Qt Company may, in the course of its development activities, at its free and absolute discretion and without any obligation to send or publish any notifications to Customer or in general, make changes, additions or deletions in the components and functionalities of the Licensed Software, provided that no such changes, additions or deletions will affect the already released version of the Licensed Software, but only upcoming version(s). +2.18. "License Term" shall mean the agreed validity period of the Development License during which the relevant Licensed Software product can be used pursuant to this Appendix. The agreed License Term, as ordered and paid for by Customer, shall be memorialized in the applicable License Certificate. +2.19. "Customer's Records" shall mean books and records that contain information bearing on Customer's compliance with the Agreement, Customer's use of Qt Community Edition and/or the payments due to The Qt Company under the Agreement, including, but not limited to user information, assembly logs, sales records and distribution records. +2.20. "Modified Software" shall have the meaning as set forth below in Section 4. +2.21. "Qt Software" shall mean the development and design software of The Qt Company, which The Qt Company makes available under commercial and/or open source licenses as either the "Licensed Software" or the "Qt Community Edition". +2.22. "Permitted Software" shall mean third party products that are generally available to the public, which may include parts of Qt Community Edition or be developed using Qt Community Edition. +2.23. "Pre-Release Code" shall have the meaning as set forth in Section 7. +2.24. "Prohibited Combination" shall mean any effort to use, combine, incorporate, link or integrate Licensed Software with any software created with or incorporating Qt Community Edition, or use Licensed Software for creation of any such software. +2.25. "Qt Community Edition" shall mean the open source version of Qt Software available under the terms of the GNU Lesser General Public License, version 2.1 or later ("LGPL") or the GNU General Public License, version 2.0 or later ("GPL"). For clarity, Qt Community Edition shall not be provided, governed or used under this Appendix. +2.26. "Redistributables" shall mean the portions of Licensed Software as set forth in Exhibit 1 hereto that may be distributed pursuant to this Appendix in object code form only, including any relevant documentation. Where relevant, any reference to Licensed Software in this Appendix includes and refers to Redistributables. +2.27. "Renewal Term" shall mean an extension of the previous License Term as agreed between the Parties. +2.28. "Submitted Modified Software" shall have the meaning as set forth in Section 4.2 of this Appendix. +2.29. "Third-Party Software" shall have the meaning set forth in Section 6 of this Appendix. +2.30. "Updates" shall mean a release or version of the Licensed Software containing bug fixes, error corrections and other changes that are generally made available to users of the Licensed Software that have contracted for Support. Updates are generally depicted as a change to the digits following the decimal in the Licensed Software version number. The Qt Company shall make Updates available to Customer under the Support. Updates shall be considered as part of the Licensed Software hereunder. +2.31. "Upgrades" shall mean a release or version of the Licensed Software containing enhancements and new features and are generally depicted as a change to the first digit of the Licensed Software version number. In the event that Upgrades are provided to Customer under this Appendix, they shall be considered as part of the Licensed Software hereunder. + +3. OWNERSHIP +3.1. Ownership of The Qt Company +3.1.1. The Licensed Software is protected by copyright laws and international copyright treaties, as well as other intellectual property laws and treaties. The Licensed Software is licensed, not sold. +3.1.2. All of The Qt Company's Intellectual Property Rights are and shall remain the exclusive property of The Qt Company or its respective licensors . No rights to The Qt Company's Intellectual Property Rights are assigned or granted to Customer under this Appendix, except when and to the extent expressly specified herein. +3.2. Ownership of Customer +3.2.1. All of Customer's Intellectual Property Rights are and shall remain the exclusive property of Customer or its licensors respectively. +3.2.2. Except to the extent set forth in this Appendix, all Intellectual Property Rights to the Modified Software, Applications and Devices (except to Redistributables included therein) shall remain with Customer. + +4. MODIFIED SOFTWARE +4.1. Customer may create bug-fixes, error corrections, patches or modifications to the Licensed Software ("Modified Software"). To the extent that Customer's Modified Software breaks source or binary compatibility or other functionality with the Licensed Software, Customer acknowledges that The Qt Company's ability to provide Support may be prevented or limited and Customer's ability to make use of Updates may be restricted. +4.2. Customer may, at its sole and absolute discretion, choose to submit Modified Software to The Qt Company ("Submitted Modified Software") in connection with Customer's Support request, service request or otherwise. In the event Customer does so, then, Customer hereby grants The Qt Company a sublicensable, assignable, irrevocable, perpetual, worldwide, non-exclusive, royalty-free and fully paid-up license, under all of Customer's Intellectual Property Rights, to reproduce, adapt, translate, modify, and prepare derivative works of, publicly display, publicly perform, sublicense, make available and distribute such Submitted Modified Software as The Qt Company sees fit at its free and absolute discretion. + +5. LICENSES GRANTED +5.1. Development with Licensed Software +5.1.1. Subject to the terms of the Agreement, The Qt Company grants to Customer a worldwide, non-exclusive, non-transferable license, valid for each License Term, to use, modify and copy the Licensed Software by Designated Users on the Development Platforms for the sole purposes of designing, developing, demonstrating and testing Application(s) and/or Devices, and to provide support and other services related to such Applications and Devices to End Customers. Each Application and/or Device can only include, incorporate or integrate contributions by such Designated Users who are duly licensed for the applicable Development Platform(s) and Deployment Platform(s) (i.e have a valid license for the appropriate Licensed Software product and only use one type of Qt Development License per Customer Application and/or Device(s)). +5.1.2. Customer may install copies of the Licensed Software on five (5) computers per Designated User, provided that only Designated Users who have a valid Development License may use the Licensed Software. +5.1.3. Customer may designate another Designated User to replace a then-current Designated User by notifying The Qt Company in writing, where such replacement is due to termination of employment, long-term absence or other permanent reason affecting Designated User's need for Licensed Software. +5.1.4. Upon expiry of the initially agreed License Term, the respective License Term shall be automatically extended by one or more Renewal Term(s), unless and until either Party notifies the other Party in writing, that it does not wish to continue the License Term, such notification to be provided to the other Party no less than thirty (30) days before expiry of the respective License Term. The Qt Company shall, in good time before the due date for the above notification, remind the Customer on the coming Renewal Term. Unless otherwise agreed between the Parties, Renewal Term shall be equal to the length of the previous License Term, but no longer than thirty-six (36) months. +5.1.5. Any such Renewal Term shall be subject to License Fees agreed between the Parties or, if no advance agreement exists, subject to The Qt Company's standard list pricing applicable at the commencement date of any such Renewal Term. +5.2. Distribution of Applications +5.2.1. Subject to the terms of the Agreement, The Qt Company grants to Customer a worldwide, non-exclusive, non-transferable, perpetual, royalty-free and revocable (only for Customer’s material breach of agreement) right and license to: +(i) distribute, by itself or through its Contractors, Redistributables as installed, incorporated or integrated into Applications for execution on the Deployment Platforms; and +(ii) grant perpetual and irrevocable sublicenses to Redistributables, as distributed hereunder, for End Customers solely to the extent necessary in order for the End Customers to use the Applications for their respective intended purposes. +5.2.2. Right to distribute the Redistributables as part of an Application as provided herein is not royalty-bearing but is conditional upon the Application having been created, updated and maintained under a valid and duly paid Development License. +5.3. Distribution of Devices +5.3.1. Subject to the terms of the Agreement, The Qt Company grants to Customer a worldwide, non-exclusive, non-transferable, perpetual, revocable (only for Customer’s material breach of agreement), royalty-bearing right and license to: +(i) distribute, by itself or through one or more tiers of Contractors, Redistributables as installed, incorporated or integrated, or intended to be installed, incorporated or integrated into Devices for execution on the Deployment Platforms; and +(ii) grant perpetual and irrevocable sublicenses to Redistributables, as distributed hereunder, for End Customers solely to the extent necessary in order for the End Customers to use the Devices for their respective intended purposes. +5.3.2. Right to distribute the Devices as provided herein is conditional upon (i) the Devices having been created, updated and maintained under a valid and duly paid Development License, and (ii) Customer having acquired corresponding Distribution Licenses at the time of distribution of any Devices to End Customers. +5.4. Further Requirements +5.4.1. The licenses granted in this Section 5 by The Qt Company to Customer are conditional and subject to Customer's compliance with the following terms: +(i) Customer acknowledges that The Qt Company has separate products for the purpose of Applications and Devices respectively, where development and distribution of Devices is only allowed using the correct designated product. Customer shall ensure and bear the burden of proof that Customer is using a correct product entitling Customer to development and distribution of Devices; +(ii) Customer shall not remove or alter any copyright, trademark or other proprietary rights notice(s) contained in any portion of the Licensed Software; +(iii) Applications must add primary and substantial functionality to Licensed Software so as not to compete with the Licensed Software; +(iv) Applications may not pass on functionality which in any way makes it possible for others to create software with Licensed Software; provided however that Customer may use Licensed Software’s scripting and QML ("Qt Quick") functionality solely in order to enable scripting, themes and styles that augment the functionality and appearance of the Application(s) without adding primary and substantial functionality to the Application(s); +(v) Customer shall not use Licensed Software in any manner or for any purpose that infringes, misappropriates or otherwise violates any Intellectual Property Right or right of any third party, or that violates any applicable law; +(vi) Customer shall not use The Qt Company's or any of its suppliers' names, logos, or trademarks to market Applications, except that Customer may use “Built with Qt” logo to indicate that an Application or Device was developed using Licensed Software; +(vii) Customer shall not distribute, sublicense or disclose source code of Licensed Software to any third party (provided however that Customer may appoint employee(s) of Contractors and Affiliates as Designated Users to use Licensed Software pursuant to this Appendix). +(viii) Customer shall not grant the End Customers a right to: (a) make copies of the Redistributables except when and to the extent required to use the Applications and/or Devices for their intended purpose; (b) modify the Redistributables or create derivative works thereof; (c) decompile, disassemble or otherwise reverse engineer Redistributables; or (d) redistribute any copy or portion of the Redistributables to any third party, except as part of the onward sale of the Application or Device on which the Redistributables are installed; +(ix) Customer shall not, and shall cause that its Affiliates or Contractors shall not, use Licensed Software in any Prohibited Combination, unless Customer has received specific advance written permission from The Qt Company to do so. Absent such written permission, any and all distribution by Customer during the term of the Agreement of a hardware device or product: a) which incorporates or integrates any part of Licensed Software or Qt Community Edition; or b) where substantial functionality is provided by software built with Licensed Software or Qt Community Edition or otherwise depends on Licensed Software or Qt Community Edition, shall be considered to be Device distribution under this Appendix and shall be dependent on Customer’s compliance thereof (including but not limited to the obligation to pay applicable License Fees for such distribution). Notwithstanding the foregoing, Customer is entitled to use and combine Licensed Software with Permitted Software; +(x) Customer shall cause all of its Affiliates, Contractors and End Customer entitled to make use of the licenses granted under this Appendix, to be contractually bound to comply with the relevant terms hereof and not to use the Licensed Software beyond the terms hereof nor for any purposes other than operating within the scope of their services for Customer. Customer shall be responsible for any and all actions and omissions of its Affiliates, Contractors, and End Customers relating to the Licensed Software and use thereof (including but not limited to payment of all applicable License Fees); +(xi) Except when and to the extent explicitly provided in this Section 5, Customer shall not transfer, publish, disclose, display or otherwise make available the Licensed Software; and +(xii) Customer shall not attempt or enlist a third party to conduct or attempt to conduct any of the above. +5.4.2. The above terms shall not be applicable if and solely to the extent they conflict with any mandatory provisions of applicable laws. +5.4.3. Any use of Licensed Software beyond the provisions of this Appendix is strictly prohibited and requires, at a minimum an additional license from The Qt Company (e.g. certain additional rights granted under software development kit “SDK” agreement with regard to limitations of Section 5.4.1 iv, vii or viii). +5.5. Evaluation License +5.5.1. Subject to the terms of this Appendix, The Qt Company grants to Customer a worldwide, non-exclusive, non-transferable license, valid for the Evaluation License Term to use the relevant Licensed Software product solely for Customer’s internal use to evaluate and determine whether the Licensed Software meets Customer's business requirements, specifically excluding any commercial use of the Licensed Software or any derived work thereof. +5.5.2. Upon the expiry of the Evaluation License Term, Customer must either discontinue use of the relevant Licensed Software or acquire a commercial Development License specified herein. + +6. THIRD-PARTY SOFTWARE. The Licensed Software may provide links or access to third party libraries or code (collectively "Third-Party Software") to implement various functions. Third-Party Software does not, however, comprise part of the Licensed Software, but is provided to Customer complimentary and use thereof is discretionary for Customer. Third-Party Software will be listed in the ".../src/3rdparty" source tree delivered with the Licensed Software or documented in the Licensed Software, as such may be amended from time to time. Customer acknowledges that use or distribution of Third-Party Software is in all respects subject to applicable license terms of applicable third-party right holders. + +7. PRE-RELEASE CODE +7.1. The Licensed Software may contain pre-release code and functionality, or sample code marked or otherwise stated with appropriate designation such as "Technology Preview", "Alpha", "Beta", "Experimental", "Sample", "Example" etc. ("Pre-Release Code"). +7.2. Such Pre-Release Code may be provided complimentary for Customer, in order to provide experimental support or information for new platforms or preliminary versions of one or more new functionalities, or for other similar reasons. Pre-Release Code may not be at the level of performance and compatibility of a final, generally available, product offering. Pre-Release Code may not operate correctly, may contain errors and may be substantially modified by The Qt Company prior to a commercial product release, if any. The Qt Company is under no obligation to make Pre-Release Code commercially available, or provide any Support or Updates relating thereto. To the maximum extent permitted by law, the Qt Company assumes no liability whatsoever regarding any Pre-Release Code and any use thereof is exclusively at Customer's own risk and expense. +7.3. Unless Licensed Software specifies different license terms for the respective Pre-Release Code, Customer is entitled to use such pre-release code pursuant to Section 5 of this Appendix, just like other Licensed Software. + +8. SUPPORT. Support is provided according to agreed support level and subject to applicable requirements and restrictions, as specified in the Appendix for Support Terms. + +9. FEES AND ORDERING: DISTRIBUTION LICENSES +9.1. Distribution License Packs +9.1.1. Unless otherwise agreed in writing, Distribution Licenses shall be purchased by way of Distribution License Packs. +9.1.2. Upon due payment of the ordered Distribution License Pack(s), Customer will have an account of Distribution Licenses available for distributing the Redistributables in accordance with this Agreement. +9.2. Each time Customer distributes a copy of Redistributables, one Distribution License is used and Customer's account of available Distribution Licenses is decreased accordingly. +9.3. Customer may distribute copies of the Redistributables so long as Customer has Distribution Licenses remaining on its account. + +10. RECORD-KEEPING AND REPORTING OBLIGATIONS; AUDIT RIGHTS +10.1. Customer's Record-keeping +10.1.1. Customer shall at all times during the term of the Agreement or validity of any of the licenses hereunder, whichever is later, and for a period of two (2) years thereafter, maintain Customer's Records in an accurate and up-to-date form. Customer's Records shall be adequate to reasonably enable The Qt Company to determine Customer's compliance with the provisions of the Agreement. The records shall conform to general good accounting practices. +10.1.2. Customer shall, within thirty (30) days from receiving The Qt Company's request to that effect, deliver to The Qt Company a report based on Customer's Records, such report to contain information, in sufficient detail, on: (i) number and identity of users working with Licensed Software or Qt Community Edition, (ii) copies of Redistributables distributed by Customer during the most recent calendar quarter and/or any other term specified by The Qt Company, and (iii) any other information pertaining to Customer's compliance with the terms of the Agreement (e.g. information on products and/or projects relating to use of Distribution Licenses), as The Qt Company may reasonably require from time to time. +10.2. The Qt Company's Audit Rights +10.2.1. The Qt Company or an independent auditor acting on behalf of The Qt Company may, upon at least thirty (30) days' prior written notice and at The Qt Company expense, audit Customer with respect to Customer's use of the Licensed Software, but not more frequently than once during each six (6) month period. Such audit may be conducted by mail, electronic means or through an in-person visit to Customer's place of business. Any possible in-person audit shall be conducted during regular business hours at Customer's facilities, shall not unreasonably interfere with Customer's business activities and shall be limited in scope to verify Customer's compliance with the terms of the Agreement. The Qt Company or its independent auditor shall be entitled to inspect Customer's Records and conduct necessary interviews of Customer's relevant employees and Contractors. All Customer's Records and use thereof shall be subject to the obligation of confidentiality under the Agreement. +10.2.2. If an audit reveals that Customer is using the Licensed Software beyond scope of the licenses Customer has paid for, Customer shall pay to The Qt Company any amounts owed for such unauthorized use within thirty (30) days from receipt of the corresponding invoice from The Qt Company. +10.2.3. In addition, in the event the audit reveals a material violation of the terms of the Agreement (without limitation, either (i) underpayment of more than 10% of License Fees or 10,000 euros (whichever is more) or (ii) distribution of products, which include or result from Prohibited Combination, shall be deemed a material violation for purposes of this section), then Customer shall pay The Qt Company's reasonable cost of conducting such audit. + +11. TERMINATION +11.1. Termination of Licenses +11.1.1. The Qt Company may terminate Customer's rights to any and all Licensed Software (including access to Support), if Customer: +(i) commits a material breach of the Agreement (including this Appendix) and has not remedied the breach within a reasonable period of time (which shall be no less than 30 days) of The Qt Company's written notice specifying the breach, or +(ii) becomes bankrupt, insolvent or goes into liquidation or debt restructuring. +11.2. Suspension of rights: Instead of termination, The Qt Company reserves the right to suspend or withhold grants of any and all rights to the Licensed Software (including Support), should Customer fail to make payment in timely fashion or otherwise violate or is reasonably suspected of violating its obligations under the Agreement and/or this Appendix, and where such violation or breach is not cured within ten (10) business days following The Qt Company's written notice thereof. +11.3. Parties Rights and Duties upon Termination +11.3.1. Upon expiry or termination of the Development Licenses, Customer shall cease and shall cause all Designated Users (including those of its Affiliates' and Contractors') to cease using the relevant Licensed Software. +11.3.2. Upon such expiry or termination of Development Licenses, Customer shall destroy or return to The Qt Company all copies of the respective Licensed Software and all related materials and will certify the same by Customer's duly authorized officer to The Qt Company upon its request, provided however that Customer may retain and utilize such copies of the Licensed Software to the extent required to provide Customer's continued support to End Customers, for archiving purposes or as is required under applicable law. +11.3.3. Distribution Licenses are perpetual and, therefore, Customer's distribution rights hereunder shall only terminate upon The Qt Company's termination of Distribution Licenses due to Customer's material breach as set forth in Section 11.1.1(i) of this Appendix. In case of such termination by The Qt Company due to Customer's material breach, Customer must cease any distribution of Applications and Devices at the effective date of termination. +11.3.4. Expiry or termination of any of Customer's licenses hereunder for any reason whatsoever shall not: +(i) relieve Customer of its obligation to pay any License Fees accrued or payable to The Qt Company prior to the effective date of termination, and Customer pay to The Qt Company all such fees within 30 days from the effective date of termination of the licenses; +(ii) relieve Customer of its obligation to ensure that Applications and Devices (including those already distributed) remain in compliance with the terms of the Agreement; nor +(iii) affect any rights of End Customer to continue use of Applications and Devices (and therein incorporated Redistributables). +11.4. Extension of Rights under Special Circumstances. In the event that, during the applicable License Term, The Qt Company is declared bankrupt under a final, non-cancellable decision by relevant court of law, and the Agreement is not, at the date of expiry of the Development License(s), assigned to a party who has assumed The Qt Company's position as a legitimate licensor of Licensed Software under the Agreement, then all valid Development Licenses possessed by Customer at such date of expiry, and which Customer has not notified for expiry, shall be extended to be valid in perpetuity under the terms of the Agreement. Any such extension shall not apply to The Qt Company's Support obligations. + +EXHIBIT 1, Licensed Software +At the time of conclusion of this Appendix, the latest available version of Licensed Software includes the software libraries and tools set forth in Exhibit 1 (as provided below), depending on which product(s) Customer has purchased under the relevant Purchase Document. +The modules and tools are specific to each product version respectively and may vary from version to version. Modules and tools included in the latest publicly available version of the respective product at any given time are listed in Exhibit 1 of https://www.qt.io/terms-conditions/qt-dev-framework/exhibit-1. If a new version of Licensed Software does not include a module or tool present in an older version which Customer is entitled to use under a valid license from The Qt Company, then Customer will continue to have such right during the validity of Customer's license to relevant Licensed Software. In the event a new version of the Licensed Software adds modules or tools to any previous version(s), Customer's rights will extend to cover also such additional modules and tools. + +EXHIBIT 2 - Small Business Terms +1. This Exhibit applies to entities that qualify as a Qualified Small Business (defined below) and provides additional terms and conditions applicable to small business pricing and licensing. In the event that Customer is a Qualified Small Business and there is any conflict between the terms of this Exhibit and any other terms of the Agreement, the terms in this Exhibit shall take precedence. + +2. APPLICABILITY FOR SMALL BUSINESS LICENSES. Any small business discounts applied require that Customer (including any Customer Affiliates or group entities) has an annual revenue (including annual capital funding) below 1 Million EUR, or the equivalent thereof, as approved by The Qt Company (each, a "Qualified Small Business"). The annual revenue, including funding, must be evidenced upon request by business records and approved by The Qt Company in its reasonable discretion. + +3. SUPPORT. Support is limited to: (i) Install Support; and (ii) for any other Standard Support issue, five (5) support tickets annually. + +4. LIMITATION ON NUMBER OF SMALL BUSINESS DEVELOPER LICENSES. Qualified Small Business discounts and purchasing structure may be applied to a maximum of three discounted developer licenses (either ADE or DCP) per Qualified Small Business. Any additional licenses purchased will be at The Qt Company list price in effect at the time. + +5. LIMITATION FOR NUMBER OF INSTALLATIONS. Customer may install copies of the Licensed Software on two (2) computers per Designated User, provided that only the Designated Users who have a valid Development License may use the Licensed Software. + +6. CONDITIONAL WAIVER OF DISTRIBUTION LICENSES. For Qualified Small Businesses, the Agreement requirements to purchase Distribution Licenses for Devices shall apply only when Customer ceases to be a Qualified Small Business (e.g., when annual revenue threshholds are bypassed). + +7. ADDITIONAL TERMS FOR RENEWALS. The initial subscription purchase term for Qualified Small Business Licenses is twelve (12) months. Upon expiration of the initial twelve (12) month term and unless terminated in accordance with the Agreement, the Licenses will automatically renew for additional twelve (12) month terms with applicable Qualified Small Business discounts. If Customer ceases to be a Qualified Small Business, renewal pricing shall be at The Qt Company list price in effect at the time of renewal, or as agreed in writing between the parties. + +8. ADDITIONAL AUDIT RIGHTS. In addition to the audit rights set forth in the Agreement, The Qt Company reserves the right to audit Customer financial records in order to determine whether Customer is a Qualified Small Business. diff --git a/.cmake.conf b/.cmake.conf new file mode 100644 index 0000000..f38db14 --- /dev/null +++ b/.cmake.conf @@ -0,0 +1,5 @@ +set(QT_REPO_MODULE_VERSION "6.8.2") +set(QT_REPO_MODULE_PRERELEASE_VERSION_SEGMENT "alpha1") +set(QT_EXTRA_INTERNAL_TARGET_DEFINES "QT_NO_AS_CONST=1") +list(APPEND QT_EXTRA_INTERNAL_TARGET_DEFINES "QT_NO_FOREACH=1") +list(APPEND QT_EXTRA_INTERNAL_TARGET_DEFINES "QT_NO_CONTEXTLESS_CONNECT=1") diff --git a/.tag b/.tag new file mode 100644 index 0000000..8a8c709 --- /dev/null +++ b/.tag @@ -0,0 +1 @@ +e9d452b68333b06386d3b1ab0ad14daf9cb03f36 diff --git a/CMakeLists.txt b/CMakeLists.txt new file mode 100644 index 0000000..040c447 --- /dev/null +++ b/CMakeLists.txt @@ -0,0 +1,75 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from qtmultimedia.pro. + +cmake_minimum_required(VERSION 3.16) + +include(.cmake.conf) +project(QtMultimedia + VERSION "${QT_REPO_MODULE_VERSION}" + DESCRIPTION "Qt Multimedia Libraries" + HOMEPAGE_URL "https://qt.io/" + LANGUAGES CXX C +) + +find_package(Qt6 ${PROJECT_VERSION} CONFIG REQUIRED COMPONENTS BuildInternals Core) +find_package(Qt6 ${PROJECT_VERSION} QUIET CONFIG OPTIONAL_COMPONENTS Gui Network Svg Widgets Quick Qml QuickTest QuickControls2 Quick3D) +qt_internal_project_setup() + +if(NOT TARGET Qt::Gui) + message(NOTICE "Skipping the build as the condition \"TARGET Qt::Gui\" is not met.") + return() +endif() + +include(src/multimedia/Qt6MultimediaMacros.cmake) + +set(QT_BUILD_EXTRA_IDE_FILE_PATTERNS + src/multimedia/doc/QtMultimediaDoc + src/multimedia/doc/qtmultimedia.qdocconf + src/multimedia/doc/snippets/CMakeLists.txt + src/multimedia/doc/snippets/multimedia-snippets/audio.cpp + src/multimedia/doc/snippets/multimedia-snippets/camera.cpp + src/multimedia/doc/snippets/multimedia-snippets/devices.cpp + src/multimedia/doc/snippets/multimedia-snippets/images/qt-logo.png + src/multimedia/doc/snippets/multimedia-snippets/media.cpp + src/multimedia/doc/snippets/multimedia-snippets/multiple-videooutputs.qml + src/multimedia/doc/snippets/multimedia-snippets/qsound.cpp + src/multimedia/doc/snippets/multimedia-snippets/qtvideosink.qml + src/multimedia/doc/snippets/multimedia-snippets/soundeffect.qml + src/multimedia/doc/snippets/multimedia-snippets/video.cpp + src/multimedia/doc/src/audiooverview.qdoc + src/multimedia/doc/src/backend-notes-apple.qdoc + src/multimedia/doc/src/cameraoverview.qdoc + src/multimedia/doc/src/classic.css + src/multimedia/doc/src/multimedia-overview.qdoc + src/multimedia/doc/src/platform-notes-apple.qdoc + src/multimedia/doc/src/platform-notes-wasm.qdoc + src/multimedia/doc/src/platform-notes-wayland.qdoc + src/multimedia/doc/src/qm-external-pages.qdoc + src/multimedia/doc/src/qt6-changes.qdoc + src/multimedia/doc/src/qtmultimedia-building-from-source.qdoc + src/multimedia/doc/src/qtmultimedia-cpp.qdoc + src/multimedia/doc/src/qtmultimedia-examples.qdoc + src/multimedia/doc/src/qtmultimedia-index.qdoc + src/multimedia/doc/src/qtmultimedia-qml-types.qdoc + src/multimedia/doc/src/videooverview.qdoc + src/multimedia/doc/src/advanced-ffmpeg-configuration.qdoc + src/multimedia/doc/src/examples/video-qml-paint-rate.qdocinc + src/multimedia/doc/src/images/Zoom.gif + src/multimedia/doc/src/images/annotatedurl.png + src/multimedia/doc/src/images/camera_correctionAngle_90.png + src/multimedia/doc/src/images/codeless.png + src/multimedia/doc/src/images/how-focus-works.gif + src/multimedia/doc/src/images/image_processing.png + src/multimedia/doc/src/images/noun_Media_166644.svg + src/multimedia/doc/src/images/qS1FmgPVL.jpg + src/multimedia/doc/src/images/qmlcamera-menu.png + src/multimedia/doc/src/images/radio-example.png + src/multimedia/doc/src/images/slideshow-img1.png + src/multimedia/doc/src/images/sound-wave-small.jpg + src/multimedia/doc/src/images/video-graphics-memory.png + src/multimedia/doc/src/images/video-qml-paint-rate.png +) + +qt_build_repo() diff --git a/LICENSES/Apache-2.0.txt b/LICENSES/Apache-2.0.txt new file mode 100644 index 0000000..136d900 --- /dev/null +++ b/LICENSES/Apache-2.0.txt @@ -0,0 +1,61 @@ +Apache License +Version 2.0, January 2004 +http://www.apache.org/licenses/ + +TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION + + 1. Definitions. + + "License" shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document. + + "Licensor" shall mean the copyright owner or entity authorized by the copyright owner that is granting the License. + + "Legal Entity" shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, "control" means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity. + + "You" (or "Your") shall mean an individual or Legal Entity exercising permissions granted by this License. + + "Source" form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files. + + "Object" form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types. + + "Work" shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work (an example is provided in the Appendix below). + + "Derivative Works" shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship. For the purposes of this License, Derivative Works shall not include works that remain separable from, or merely link (or bind by name) to the interfaces of, the Work and Derivative Works thereof. + + "Contribution" shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work by the copyright owner or by an individual or Legal Entity authorized to submit on behalf of the copyright owner. For the purposes of this definition, "submitted" means any form of electronic, verbal, or written communication sent to the Licensor or its representatives, including but not limited to communication on electronic mailing lists, source code control systems, and issue tracking systems that are managed by, or on behalf of, the Licensor for the purpose of discussing and improving the Work, but excluding communication that is conspicuously marked or otherwise designated in writing by the copyright owner as "Not a Contribution." + + "Contributor" shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work. + 2. Grant of Copyright License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form. + 3. Grant of Patent License. Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable (except as stated in this section) patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work, where such license applies only to those patent claims licensable by such Contributor that are necessarily infringed by their Contribution(s) alone or by combination of their Contribution(s) with the Work to which such Contribution(s) was submitted. If You institute patent litigation against any entity (including a cross-claim or counterclaim in a lawsuit) alleging that the Work or a Contribution incorporated within the Work constitutes direct or contributory patent infringement, then any patent licenses granted to You under this License for that Work shall terminate as of the date such litigation is filed. + 4. Redistribution. You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions: + (a) You must give any other recipients of the Work or Derivative Works a copy of this License; and + (b) You must cause any modified files to carry prominent notices stating that You changed the files; and + (c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work, excluding those notices that do not pertain to any part of the Derivative Works; and + (d) If the Work includes a "NOTICE" text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file, excluding those notices that do not pertain to any part of the Derivative Works, in at least one of the following places: within a NOTICE text file distributed as part of the Derivative Works; within the Source form or documentation, if provided along with the Derivative Works; or, within a display generated by the Derivative Works, if and wherever such third-party notices normally appear. The contents of the NOTICE file are for informational purposes only and do not modify the License. You may add Your own attribution notices within Derivative Works that You distribute, alongside or as an addendum to the NOTICE text from the Work, provided that such additional attribution notices cannot be construed as modifying the License. + + You may add Your own copyright statement to Your modifications and may provide additional or different license terms and conditions for use, reproduction, or distribution of Your modifications, or for any such Derivative Works as a whole, provided Your use, reproduction, and distribution of the Work otherwise complies with the conditions stated in this License. + 5. Submission of Contributions. Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License, without any additional terms or conditions. Notwithstanding the above, nothing herein shall supersede or modify the terms of any separate license agreement you may have executed with Licensor regarding such Contributions. + 6. Trademarks. This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work and reproducing the content of the NOTICE file. + 7. Disclaimer of Warranty. Unless required by applicable law or agreed to in writing, Licensor provides the Work (and each Contributor provides its Contributions) on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE. You are solely responsible for determining the appropriateness of using or redistributing the Work and assume any risks associated with Your exercise of permissions under this License. + 8. Limitation of Liability. In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law (such as deliberate and grossly negligent acts) or agreed to in writing, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages of any character arising as a result of this License or out of the use or inability to use the Work (including but not limited to damages for loss of goodwill, work stoppage, computer failure or malfunction, or any and all other commercial damages or losses), even if such Contributor has been advised of the possibility of such damages. + 9. Accepting Warranty or Additional Liability. While redistributing the Work or Derivative Works thereof, You may choose to offer, and charge a fee for, acceptance of support, warranty, indemnity, or other liability obligations and/or rights consistent with this License. However, in accepting such obligations, You may act only on Your own behalf and on Your sole responsibility, not on behalf of any other Contributor, and only if You agree to indemnify, defend, and hold each Contributor harmless for any liability incurred by, or claims asserted against, such Contributor by reason of your accepting any such warranty or additional liability. + +END OF TERMS AND CONDITIONS + +APPENDIX: How to apply the Apache License to your work. + +To apply the Apache License to your work, attach the following boilerplate notice, with the fields enclosed by brackets "[]" replaced with your own identifying information. (Don't include the brackets!) The text should be enclosed in the appropriate comment syntax for the file format. We also recommend that a file or class name and description of purpose be included on the same "printed page" as the copyright notice for easier identification within third-party archives. + +Copyright [yyyy] [name of copyright owner] + +Licensed under the Apache License, Version 2.0 (the "License"); +you may not use this file except in compliance with the License. +You may obtain a copy of the License at + +http://www.apache.org/licenses/LICENSE-2.0 + +Unless required by applicable law or agreed to in writing, software +distributed under the License is distributed on an "AS IS" BASIS, +WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. +See the License for the specific language governing permissions and +limitations under the License. diff --git a/LICENSES/BSD-3-Clause.txt b/LICENSES/BSD-3-Clause.txt new file mode 100644 index 0000000..b91bbd8 --- /dev/null +++ b/LICENSES/BSD-3-Clause.txt @@ -0,0 +1,9 @@ +Copyright (c) . + +Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: + + 1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. + 2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. + 3. Neither the name of the copyright holder nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. + +THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/LICENSES/GFDL-1.3-no-invariants-only.txt b/LICENSES/GFDL-1.3-no-invariants-only.txt new file mode 100644 index 0000000..857214d --- /dev/null +++ b/LICENSES/GFDL-1.3-no-invariants-only.txt @@ -0,0 +1,451 @@ + + GNU Free Documentation License + Version 1.3, 3 November 2008 + + + Copyright (C) 2000, 2001, 2002, 2007, 2008 Free Software Foundation, Inc. + + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + +0. PREAMBLE + +The purpose of this License is to make a manual, textbook, or other +functional and useful document "free" in the sense of freedom: to +assure everyone the effective freedom to copy and redistribute it, +with or without modifying it, either commercially or noncommercially. +Secondarily, this License preserves for the author and publisher a way +to get credit for their work, while not being considered responsible +for modifications made by others. + +This License is a kind of "copyleft", which means that derivative +works of the document must themselves be free in the same sense. It +complements the GNU General Public License, which is a copyleft +license designed for free software. + +We have designed this License in order to use it for manuals for free +software, because free software needs free documentation: a free +program should come with manuals providing the same freedoms that the +software does. But this License is not limited to software manuals; +it can be used for any textual work, regardless of subject matter or +whether it is published as a printed book. We recommend this License +principally for works whose purpose is instruction or reference. + + +1. APPLICABILITY AND DEFINITIONS + +This License applies to any manual or other work, in any medium, that +contains a notice placed by the copyright holder saying it can be +distributed under the terms of this License. Such a notice grants a +world-wide, royalty-free license, unlimited in duration, to use that +work under the conditions stated herein. The "Document", below, +refers to any such manual or work. Any member of the public is a +licensee, and is addressed as "you". You accept the license if you +copy, modify or distribute the work in a way requiring permission +under copyright law. + +A "Modified Version" of the Document means any work containing the +Document or a portion of it, either copied verbatim, or with +modifications and/or translated into another language. + +A "Secondary Section" is a named appendix or a front-matter section of +the Document that deals exclusively with the relationship of the +publishers or authors of the Document to the Document's overall +subject (or to related matters) and contains nothing that could fall +directly within that overall subject. (Thus, if the Document is in +part a textbook of mathematics, a Secondary Section may not explain +any mathematics.) The relationship could be a matter of historical +connection with the subject or with related matters, or of legal, +commercial, philosophical, ethical or political position regarding +them. + +The "Invariant Sections" are certain Secondary Sections whose titles +are designated, as being those of Invariant Sections, in the notice +that says that the Document is released under this License. If a +section does not fit the above definition of Secondary then it is not +allowed to be designated as Invariant. The Document may contain zero +Invariant Sections. If the Document does not identify any Invariant +Sections then there are none. + +The "Cover Texts" are certain short passages of text that are listed, +as Front-Cover Texts or Back-Cover Texts, in the notice that says that +the Document is released under this License. A Front-Cover Text may +be at most 5 words, and a Back-Cover Text may be at most 25 words. + +A "Transparent" copy of the Document means a machine-readable copy, +represented in a format whose specification is available to the +general public, that is suitable for revising the document +straightforwardly with generic text editors or (for images composed of +pixels) generic paint programs or (for drawings) some widely available +drawing editor, and that is suitable for input to text formatters or +for automatic translation to a variety of formats suitable for input +to text formatters. A copy made in an otherwise Transparent file +format whose markup, or absence of markup, has been arranged to thwart +or discourage subsequent modification by readers is not Transparent. +An image format is not Transparent if used for any substantial amount +of text. A copy that is not "Transparent" is called "Opaque". + +Examples of suitable formats for Transparent copies include plain +ASCII without markup, Texinfo input format, LaTeX input format, SGML +or XML using a publicly available DTD, and standard-conforming simple +HTML, PostScript or PDF designed for human modification. Examples of +transparent image formats include PNG, XCF and JPG. Opaque formats +include proprietary formats that can be read and edited only by +proprietary word processors, SGML or XML for which the DTD and/or +processing tools are not generally available, and the +machine-generated HTML, PostScript or PDF produced by some word +processors for output purposes only. + +The "Title Page" means, for a printed book, the title page itself, +plus such following pages as are needed to hold, legibly, the material +this License requires to appear in the title page. For works in +formats which do not have any title page as such, "Title Page" means +the text near the most prominent appearance of the work's title, +preceding the beginning of the body of the text. + +The "publisher" means any person or entity that distributes copies of +the Document to the public. + +A section "Entitled XYZ" means a named subunit of the Document whose +title either is precisely XYZ or contains XYZ in parentheses following +text that translates XYZ in another language. (Here XYZ stands for a +specific section name mentioned below, such as "Acknowledgements", +"Dedications", "Endorsements", or "History".) To "Preserve the Title" +of such a section when you modify the Document means that it remains a +section "Entitled XYZ" according to this definition. + +The Document may include Warranty Disclaimers next to the notice which +states that this License applies to the Document. These Warranty +Disclaimers are considered to be included by reference in this +License, but only as regards disclaiming warranties: any other +implication that these Warranty Disclaimers may have is void and has +no effect on the meaning of this License. + +2. VERBATIM COPYING + +You may copy and distribute the Document in any medium, either +commercially or noncommercially, provided that this License, the +copyright notices, and the license notice saying this License applies +to the Document are reproduced in all copies, and that you add no +other conditions whatsoever to those of this License. You may not use +technical measures to obstruct or control the reading or further +copying of the copies you make or distribute. However, you may accept +compensation in exchange for copies. If you distribute a large enough +number of copies you must also follow the conditions in section 3. + +You may also lend copies, under the same conditions stated above, and +you may publicly display copies. + + +3. COPYING IN QUANTITY + +If you publish printed copies (or copies in media that commonly have +printed covers) of the Document, numbering more than 100, and the +Document's license notice requires Cover Texts, you must enclose the +copies in covers that carry, clearly and legibly, all these Cover +Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on +the back cover. Both covers must also clearly and legibly identify +you as the publisher of these copies. The front cover must present +the full title with all words of the title equally prominent and +visible. You may add other material on the covers in addition. +Copying with changes limited to the covers, as long as they preserve +the title of the Document and satisfy these conditions, can be treated +as verbatim copying in other respects. + +If the required texts for either cover are too voluminous to fit +legibly, you should put the first ones listed (as many as fit +reasonably) on the actual cover, and continue the rest onto adjacent +pages. + +If you publish or distribute Opaque copies of the Document numbering +more than 100, you must either include a machine-readable Transparent +copy along with each Opaque copy, or state in or with each Opaque copy +a computer-network location from which the general network-using +public has access to download using public-standard network protocols +a complete Transparent copy of the Document, free of added material. +If you use the latter option, you must take reasonably prudent steps, +when you begin distribution of Opaque copies in quantity, to ensure +that this Transparent copy will remain thus accessible at the stated +location until at least one year after the last time you distribute an +Opaque copy (directly or through your agents or retailers) of that +edition to the public. + +It is requested, but not required, that you contact the authors of the +Document well before redistributing any large number of copies, to +give them a chance to provide you with an updated version of the +Document. + + +4. MODIFICATIONS + +You may copy and distribute a Modified Version of the Document under +the conditions of sections 2 and 3 above, provided that you release +the Modified Version under precisely this License, with the Modified +Version filling the role of the Document, thus licensing distribution +and modification of the Modified Version to whoever possesses a copy +of it. In addition, you must do these things in the Modified Version: + +A. Use in the Title Page (and on the covers, if any) a title distinct + from that of the Document, and from those of previous versions + (which should, if there were any, be listed in the History section + of the Document). You may use the same title as a previous version + if the original publisher of that version gives permission. +B. List on the Title Page, as authors, one or more persons or entities + responsible for authorship of the modifications in the Modified + Version, together with at least five of the principal authors of the + Document (all of its principal authors, if it has fewer than five), + unless they release you from this requirement. +C. State on the Title page the name of the publisher of the + Modified Version, as the publisher. +D. Preserve all the copyright notices of the Document. +E. Add an appropriate copyright notice for your modifications + adjacent to the other copyright notices. +F. Include, immediately after the copyright notices, a license notice + giving the public permission to use the Modified Version under the + terms of this License, in the form shown in the Addendum below. +G. Preserve in that license notice the full lists of Invariant Sections + and required Cover Texts given in the Document's license notice. +H. Include an unaltered copy of this License. +I. Preserve the section Entitled "History", Preserve its Title, and add + to it an item stating at least the title, year, new authors, and + publisher of the Modified Version as given on the Title Page. If + there is no section Entitled "History" in the Document, create one + stating the title, year, authors, and publisher of the Document as + given on its Title Page, then add an item describing the Modified + Version as stated in the previous sentence. +J. Preserve the network location, if any, given in the Document for + public access to a Transparent copy of the Document, and likewise + the network locations given in the Document for previous versions + it was based on. These may be placed in the "History" section. + You may omit a network location for a work that was published at + least four years before the Document itself, or if the original + publisher of the version it refers to gives permission. +K. For any section Entitled "Acknowledgements" or "Dedications", + Preserve the Title of the section, and preserve in the section all + the substance and tone of each of the contributor acknowledgements + and/or dedications given therein. +L. Preserve all the Invariant Sections of the Document, + unaltered in their text and in their titles. Section numbers + or the equivalent are not considered part of the section titles. +M. Delete any section Entitled "Endorsements". Such a section + may not be included in the Modified Version. +N. Do not retitle any existing section to be Entitled "Endorsements" + or to conflict in title with any Invariant Section. +O. Preserve any Warranty Disclaimers. + +If the Modified Version includes new front-matter sections or +appendices that qualify as Secondary Sections and contain no material +copied from the Document, you may at your option designate some or all +of these sections as invariant. To do this, add their titles to the +list of Invariant Sections in the Modified Version's license notice. +These titles must be distinct from any other section titles. + +You may add a section Entitled "Endorsements", provided it contains +nothing but endorsements of your Modified Version by various +parties--for example, statements of peer review or that the text has +been approved by an organization as the authoritative definition of a +standard. + +You may add a passage of up to five words as a Front-Cover Text, and a +passage of up to 25 words as a Back-Cover Text, to the end of the list +of Cover Texts in the Modified Version. Only one passage of +Front-Cover Text and one of Back-Cover Text may be added by (or +through arrangements made by) any one entity. If the Document already +includes a cover text for the same cover, previously added by you or +by arrangement made by the same entity you are acting on behalf of, +you may not add another; but you may replace the old one, on explicit +permission from the previous publisher that added the old one. + +The author(s) and publisher(s) of the Document do not by this License +give permission to use their names for publicity for or to assert or +imply endorsement of any Modified Version. + + +5. COMBINING DOCUMENTS + +You may combine the Document with other documents released under this +License, under the terms defined in section 4 above for modified +versions, provided that you include in the combination all of the +Invariant Sections of all of the original documents, unmodified, and +list them all as Invariant Sections of your combined work in its +license notice, and that you preserve all their Warranty Disclaimers. + +The combined work need only contain one copy of this License, and +multiple identical Invariant Sections may be replaced with a single +copy. If there are multiple Invariant Sections with the same name but +different contents, make the title of each such section unique by +adding at the end of it, in parentheses, the name of the original +author or publisher of that section if known, or else a unique number. +Make the same adjustment to the section titles in the list of +Invariant Sections in the license notice of the combined work. + +In the combination, you must combine any sections Entitled "History" +in the various original documents, forming one section Entitled +"History"; likewise combine any sections Entitled "Acknowledgements", +and any sections Entitled "Dedications". You must delete all sections +Entitled "Endorsements". + + +6. COLLECTIONS OF DOCUMENTS + +You may make a collection consisting of the Document and other +documents released under this License, and replace the individual +copies of this License in the various documents with a single copy +that is included in the collection, provided that you follow the rules +of this License for verbatim copying of each of the documents in all +other respects. + +You may extract a single document from such a collection, and +distribute it individually under this License, provided you insert a +copy of this License into the extracted document, and follow this +License in all other respects regarding verbatim copying of that +document. + + +7. AGGREGATION WITH INDEPENDENT WORKS + +A compilation of the Document or its derivatives with other separate +and independent documents or works, in or on a volume of a storage or +distribution medium, is called an "aggregate" if the copyright +resulting from the compilation is not used to limit the legal rights +of the compilation's users beyond what the individual works permit. +When the Document is included in an aggregate, this License does not +apply to the other works in the aggregate which are not themselves +derivative works of the Document. + +If the Cover Text requirement of section 3 is applicable to these +copies of the Document, then if the Document is less than one half of +the entire aggregate, the Document's Cover Texts may be placed on +covers that bracket the Document within the aggregate, or the +electronic equivalent of covers if the Document is in electronic form. +Otherwise they must appear on printed covers that bracket the whole +aggregate. + + +8. TRANSLATION + +Translation is considered a kind of modification, so you may +distribute translations of the Document under the terms of section 4. +Replacing Invariant Sections with translations requires special +permission from their copyright holders, but you may include +translations of some or all Invariant Sections in addition to the +original versions of these Invariant Sections. You may include a +translation of this License, and all the license notices in the +Document, and any Warranty Disclaimers, provided that you also include +the original English version of this License and the original versions +of those notices and disclaimers. In case of a disagreement between +the translation and the original version of this License or a notice +or disclaimer, the original version will prevail. + +If a section in the Document is Entitled "Acknowledgements", +"Dedications", or "History", the requirement (section 4) to Preserve +its Title (section 1) will typically require changing the actual +title. + + +9. TERMINATION + +You may not copy, modify, sublicense, or distribute the Document +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense, or distribute it is void, and +will automatically terminate your rights under this License. + +However, if you cease all violation of this License, then your license +from a particular copyright holder is reinstated (a) provisionally, +unless and until the copyright holder explicitly and finally +terminates your license, and (b) permanently, if the copyright holder +fails to notify you of the violation by some reasonable means prior to +60 days after the cessation. + +Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + +Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, receipt of a copy of some or all of the same material does +not give you any rights to use it. + + +10. FUTURE REVISIONS OF THIS LICENSE + +The Free Software Foundation may publish new, revised versions of the +GNU Free Documentation License from time to time. Such new versions +will be similar in spirit to the present version, but may differ in +detail to address new problems or concerns. See +https://www.gnu.org/licenses/. + +Each version of the License is given a distinguishing version number. +If the Document specifies that a particular numbered version of this +License "or any later version" applies to it, you have the option of +following the terms and conditions either of that specified version or +of any later version that has been published (not as a draft) by the +Free Software Foundation. If the Document does not specify a version +number of this License, you may choose any version ever published (not +as a draft) by the Free Software Foundation. If the Document +specifies that a proxy can decide which future versions of this +License can be used, that proxy's public statement of acceptance of a +version permanently authorizes you to choose that version for the +Document. + +11. RELICENSING + +"Massive Multiauthor Collaboration Site" (or "MMC Site") means any +World Wide Web server that publishes copyrightable works and also +provides prominent facilities for anybody to edit those works. A +public wiki that anybody can edit is an example of such a server. A +"Massive Multiauthor Collaboration" (or "MMC") contained in the site +means any set of copyrightable works thus published on the MMC site. + +"CC-BY-SA" means the Creative Commons Attribution-Share Alike 3.0 +license published by Creative Commons Corporation, a not-for-profit +corporation with a principal place of business in San Francisco, +California, as well as future copyleft versions of that license +published by that same organization. + +"Incorporate" means to publish or republish a Document, in whole or in +part, as part of another Document. + +An MMC is "eligible for relicensing" if it is licensed under this +License, and if all works that were first published under this License +somewhere other than this MMC, and subsequently incorporated in whole or +in part into the MMC, (1) had no cover texts or invariant sections, and +(2) were thus incorporated prior to November 1, 2008. + +The operator of an MMC Site may republish an MMC contained in the site +under CC-BY-SA on the same site at any time before August 1, 2009, +provided the MMC is eligible for relicensing. + + +ADDENDUM: How to use this License for your documents + +To use this License in a document you have written, include a copy of +the License in the document and put the following copyright and +license notices just after the title page: + + Copyright (c) YEAR YOUR NAME. + Permission is granted to copy, distribute and/or modify this document + under the terms of the GNU Free Documentation License, Version 1.3 + or any later version published by the Free Software Foundation; + with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. + A copy of the license is included in the section entitled "GNU + Free Documentation License". + +If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts, +replace the "with...Texts." line with this: + + with the Invariant Sections being LIST THEIR TITLES, with the + Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST. + +If you have Invariant Sections without Cover Texts, or some other +combination of the three, merge those two alternatives to suit the +situation. + +If your document contains nontrivial examples of program code, we +recommend releasing these examples in parallel under your choice of +free software license, such as the GNU General Public License, +to permit their use in free software. diff --git a/LICENSES/GPL-2.0-only.txt b/LICENSES/GPL-2.0-only.txt new file mode 100644 index 0000000..d159169 --- /dev/null +++ b/LICENSES/GPL-2.0-only.txt @@ -0,0 +1,339 @@ + GNU GENERAL PUBLIC LICENSE + Version 2, June 1991 + + Copyright (C) 1989, 1991 Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The licenses for most software are designed to take away your +freedom to share and change it. By contrast, the GNU General Public +License is intended to guarantee your freedom to share and change free +software--to make sure the software is free for all its users. This +General Public License applies to most of the Free Software +Foundation's software and to any other program whose authors commit to +using it. (Some other Free Software Foundation software is covered by +the GNU Lesser General Public License instead.) You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +this service if you wish), that you receive source code or can get it +if you want it, that you can change the software or use pieces of it +in new free programs; and that you know you can do these things. + + To protect your rights, we need to make restrictions that forbid +anyone to deny you these rights or to ask you to surrender the rights. +These restrictions translate to certain responsibilities for you if you +distribute copies of the software, or if you modify it. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must give the recipients all the rights that +you have. You must make sure that they, too, receive or can get the +source code. And you must show them these terms so they know their +rights. + + We protect your rights with two steps: (1) copyright the software, and +(2) offer you this license which gives you legal permission to copy, +distribute and/or modify the software. + + Also, for each author's protection and ours, we want to make certain +that everyone understands that there is no warranty for this free +software. If the software is modified by someone else and passed on, we +want its recipients to know that what they have is not the original, so +that any problems introduced by others will not reflect on the original +authors' reputations. + + Finally, any free program is threatened constantly by software +patents. We wish to avoid the danger that redistributors of a free +program will individually obtain patent licenses, in effect making the +program proprietary. To prevent this, we have made it clear that any +patent must be licensed for everyone's free use or not licensed at all. + + The precise terms and conditions for copying, distribution and +modification follow. + + GNU GENERAL PUBLIC LICENSE + TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION + + 0. This License applies to any program or other work which contains +a notice placed by the copyright holder saying it may be distributed +under the terms of this General Public License. The "Program", below, +refers to any such program or work, and a "work based on the Program" +means either the Program or any derivative work under copyright law: +that is to say, a work containing the Program or a portion of it, +either verbatim or with modifications and/or translated into another +language. (Hereinafter, translation is included without limitation in +the term "modification".) Each licensee is addressed as "you". + +Activities other than copying, distribution and modification are not +covered by this License; they are outside its scope. The act of +running the Program is not restricted, and the output from the Program +is covered only if its contents constitute a work based on the +Program (independent of having been made by running the Program). +Whether that is true depends on what the Program does. + + 1. You may copy and distribute verbatim copies of the Program's +source code as you receive it, in any medium, provided that you +conspicuously and appropriately publish on each copy an appropriate +copyright notice and disclaimer of warranty; keep intact all the +notices that refer to this License and to the absence of any warranty; +and give any other recipients of the Program a copy of this License +along with the Program. + +You may charge a fee for the physical act of transferring a copy, and +you may at your option offer warranty protection in exchange for a fee. + + 2. You may modify your copy or copies of the Program or any portion +of it, thus forming a work based on the Program, and copy and +distribute such modifications or work under the terms of Section 1 +above, provided that you also meet all of these conditions: + + a) You must cause the modified files to carry prominent notices + stating that you changed the files and the date of any change. + + b) You must cause any work that you distribute or publish, that in + whole or in part contains or is derived from the Program or any + part thereof, to be licensed as a whole at no charge to all third + parties under the terms of this License. + + c) If the modified program normally reads commands interactively + when run, you must cause it, when started running for such + interactive use in the most ordinary way, to print or display an + announcement including an appropriate copyright notice and a + notice that there is no warranty (or else, saying that you provide + a warranty) and that users may redistribute the program under + these conditions, and telling the user how to view a copy of this + License. (Exception: if the Program itself is interactive but + does not normally print such an announcement, your work based on + the Program is not required to print an announcement.) + +These requirements apply to the modified work as a whole. If +identifiable sections of that work are not derived from the Program, +and can be reasonably considered independent and separate works in +themselves, then this License, and its terms, do not apply to those +sections when you distribute them as separate works. But when you +distribute the same sections as part of a whole which is a work based +on the Program, the distribution of the whole must be on the terms of +this License, whose permissions for other licensees extend to the +entire whole, and thus to each and every part regardless of who wrote it. + +Thus, it is not the intent of this section to claim rights or contest +your rights to work written entirely by you; rather, the intent is to +exercise the right to control the distribution of derivative or +collective works based on the Program. + +In addition, mere aggregation of another work not based on the Program +with the Program (or with a work based on the Program) on a volume of +a storage or distribution medium does not bring the other work under +the scope of this License. + + 3. You may copy and distribute the Program (or a work based on it, +under Section 2) in object code or executable form under the terms of +Sections 1 and 2 above provided that you also do one of the following: + + a) Accompany it with the complete corresponding machine-readable + source code, which must be distributed under the terms of Sections + 1 and 2 above on a medium customarily used for software interchange; or, + + b) Accompany it with a written offer, valid for at least three + years, to give any third party, for a charge no more than your + cost of physically performing source distribution, a complete + machine-readable copy of the corresponding source code, to be + distributed under the terms of Sections 1 and 2 above on a medium + customarily used for software interchange; or, + + c) Accompany it with the information you received as to the offer + to distribute corresponding source code. (This alternative is + allowed only for noncommercial distribution and only if you + received the program in object code or executable form with such + an offer, in accord with Subsection b above.) + +The source code for a work means the preferred form of the work for +making modifications to it. For an executable work, complete source +code means all the source code for all modules it contains, plus any +associated interface definition files, plus the scripts used to +control compilation and installation of the executable. However, as a +special exception, the source code distributed need not include +anything that is normally distributed (in either source or binary +form) with the major components (compiler, kernel, and so on) of the +operating system on which the executable runs, unless that component +itself accompanies the executable. + +If distribution of executable or object code is made by offering +access to copy from a designated place, then offering equivalent +access to copy the source code from the same place counts as +distribution of the source code, even though third parties are not +compelled to copy the source along with the object code. + + 4. You may not copy, modify, sublicense, or distribute the Program +except as expressly provided under this License. Any attempt +otherwise to copy, modify, sublicense or distribute the Program is +void, and will automatically terminate your rights under this License. +However, parties who have received copies, or rights, from you under +this License will not have their licenses terminated so long as such +parties remain in full compliance. + + 5. You are not required to accept this License, since you have not +signed it. However, nothing else grants you permission to modify or +distribute the Program or its derivative works. These actions are +prohibited by law if you do not accept this License. Therefore, by +modifying or distributing the Program (or any work based on the +Program), you indicate your acceptance of this License to do so, and +all its terms and conditions for copying, distributing or modifying +the Program or works based on it. + + 6. Each time you redistribute the Program (or any work based on the +Program), the recipient automatically receives a license from the +original licensor to copy, distribute or modify the Program subject to +these terms and conditions. You may not impose any further +restrictions on the recipients' exercise of the rights granted herein. +You are not responsible for enforcing compliance by third parties to +this License. + + 7. If, as a consequence of a court judgment or allegation of patent +infringement or for any other reason (not limited to patent issues), +conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot +distribute so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you +may not distribute the Program at all. For example, if a patent +license would not permit royalty-free redistribution of the Program by +all those who receive copies directly or indirectly through you, then +the only way you could satisfy both it and this License would be to +refrain entirely from distribution of the Program. + +If any portion of this section is held invalid or unenforceable under +any particular circumstance, the balance of the section is intended to +apply and the section as a whole is intended to apply in other +circumstances. + +It is not the purpose of this section to induce you to infringe any +patents or other property right claims or to contest validity of any +such claims; this section has the sole purpose of protecting the +integrity of the free software distribution system, which is +implemented by public license practices. Many people have made +generous contributions to the wide range of software distributed +through that system in reliance on consistent application of that +system; it is up to the author/donor to decide if he or she is willing +to distribute software through any other system and a licensee cannot +impose that choice. + +This section is intended to make thoroughly clear what is believed to +be a consequence of the rest of this License. + + 8. If the distribution and/or use of the Program is restricted in +certain countries either by patents or by copyrighted interfaces, the +original copyright holder who places the Program under this License +may add an explicit geographical distribution limitation excluding +those countries, so that distribution is permitted only in or among +countries not thus excluded. In such case, this License incorporates +the limitation as if written in the body of this License. + + 9. The Free Software Foundation may publish revised and/or new versions +of the General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + +Each version is given a distinguishing version number. If the Program +specifies a version number of this License which applies to it and "any +later version", you have the option of following the terms and conditions +either of that version or of any later version published by the Free +Software Foundation. If the Program does not specify a version number of +this License, you may choose any version ever published by the Free Software +Foundation. + + 10. If you wish to incorporate parts of the Program into other free +programs whose distribution conditions are different, write to the author +to ask for permission. For software which is copyrighted by the Free +Software Foundation, write to the Free Software Foundation; we sometimes +make exceptions for this. Our decision will be guided by the two goals +of preserving the free status of all derivatives of our free software and +of promoting the sharing and reuse of software generally. + + NO WARRANTY + + 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY +FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN +OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES +PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED +OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF +MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS +TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE +PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, +REPAIR OR CORRECTION. + + 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR +REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, +INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING +OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED +TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY +YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER +PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE +POSSIBILITY OF SUCH DAMAGES. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +convey the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software; you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation; either version 2 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License along + with this program; if not, write to the Free Software Foundation, Inc., + 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. + +Also add information on how to contact you by electronic and paper mail. + +If the program is interactive, make it output a short notice like this +when it starts in an interactive mode: + + Gnomovision version 69, Copyright (C) year name of author + Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, the commands you use may +be called something other than `show w' and `show c'; they could even be +mouse-clicks or menu items--whatever suits your program. + +You should also get your employer (if you work as a programmer) or your +school, if any, to sign a "copyright disclaimer" for the program, if +necessary. Here is a sample; alter the names: + + Yoyodyne, Inc., hereby disclaims all copyright interest in the program + `Gnomovision' (which makes passes at compilers) written by James Hacker. + + , 1 April 1989 + Ty Coon, President of Vice + +This General Public License does not permit incorporating your program into +proprietary programs. If your program is a subroutine library, you may +consider it more useful to permit linking proprietary applications with the +library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. diff --git a/LICENSES/GPL-3.0-only.txt b/LICENSES/GPL-3.0-only.txt new file mode 100644 index 0000000..94a9ed0 --- /dev/null +++ b/LICENSES/GPL-3.0-only.txt @@ -0,0 +1,674 @@ + GNU GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + Preamble + + The GNU General Public License is a free, copyleft license for +software and other kinds of works. + + The licenses for most software and other practical works are designed +to take away your freedom to share and change the works. By contrast, +the GNU General Public License is intended to guarantee your freedom to +share and change all versions of a program--to make sure it remains free +software for all its users. We, the Free Software Foundation, use the +GNU General Public License for most of our software; it applies also to +any other work released this way by its authors. You can apply it to +your programs, too. + + When we speak of free software, we are referring to freedom, not +price. Our General Public Licenses are designed to make sure that you +have the freedom to distribute copies of free software (and charge for +them if you wish), that you receive source code or can get it if you +want it, that you can change the software or use pieces of it in new +free programs, and that you know you can do these things. + + To protect your rights, we need to prevent others from denying you +these rights or asking you to surrender the rights. Therefore, you have +certain responsibilities if you distribute copies of the software, or if +you modify it: responsibilities to respect the freedom of others. + + For example, if you distribute copies of such a program, whether +gratis or for a fee, you must pass on to the recipients the same +freedoms that you received. You must make sure that they, too, receive +or can get the source code. And you must show them these terms so they +know their rights. + + Developers that use the GNU GPL protect your rights with two steps: +(1) assert copyright on the software, and (2) offer you this License +giving you legal permission to copy, distribute and/or modify it. + + For the developers' and authors' protection, the GPL clearly explains +that there is no warranty for this free software. For both users' and +authors' sake, the GPL requires that modified versions be marked as +changed, so that their problems will not be attributed erroneously to +authors of previous versions. + + Some devices are designed to deny users access to install or run +modified versions of the software inside them, although the manufacturer +can do so. This is fundamentally incompatible with the aim of +protecting users' freedom to change the software. The systematic +pattern of such abuse occurs in the area of products for individuals to +use, which is precisely where it is most unacceptable. Therefore, we +have designed this version of the GPL to prohibit the practice for those +products. If such problems arise substantially in other domains, we +stand ready to extend this provision to those domains in future versions +of the GPL, as needed to protect the freedom of users. + + Finally, every program is threatened constantly by software patents. +States should not allow patents to restrict development and use of +software on general-purpose computers, but in those that do, we wish to +avoid the special danger that patents applied to a free program could +make it effectively proprietary. To prevent this, the GPL assures that +patents cannot be used to render the program non-free. + + The precise terms and conditions for copying, distribution and +modification follow. + + TERMS AND CONDITIONS + + 0. Definitions. + + "This License" refers to version 3 of the GNU General Public License. + + "Copyright" also means copyright-like laws that apply to other kinds of +works, such as semiconductor masks. + + "The Program" refers to any copyrightable work licensed under this +License. Each licensee is addressed as "you". "Licensees" and +"recipients" may be individuals or organizations. + + To "modify" a work means to copy from or adapt all or part of the work +in a fashion requiring copyright permission, other than the making of an +exact copy. The resulting work is called a "modified version" of the +earlier work or a work "based on" the earlier work. + + A "covered work" means either the unmodified Program or a work based +on the Program. + + To "propagate" a work means to do anything with it that, without +permission, would make you directly or secondarily liable for +infringement under applicable copyright law, except executing it on a +computer or modifying a private copy. Propagation includes copying, +distribution (with or without modification), making available to the +public, and in some countries other activities as well. + + To "convey" a work means any kind of propagation that enables other +parties to make or receive copies. Mere interaction with a user through +a computer network, with no transfer of a copy, is not conveying. + + An interactive user interface displays "Appropriate Legal Notices" +to the extent that it includes a convenient and prominently visible +feature that (1) displays an appropriate copyright notice, and (2) +tells the user that there is no warranty for the work (except to the +extent that warranties are provided), that licensees may convey the +work under this License, and how to view a copy of this License. If +the interface presents a list of user commands or options, such as a +menu, a prominent item in the list meets this criterion. + + 1. Source Code. + + The "source code" for a work means the preferred form of the work +for making modifications to it. "Object code" means any non-source +form of a work. + + A "Standard Interface" means an interface that either is an official +standard defined by a recognized standards body, or, in the case of +interfaces specified for a particular programming language, one that +is widely used among developers working in that language. + + The "System Libraries" of an executable work include anything, other +than the work as a whole, that (a) is included in the normal form of +packaging a Major Component, but which is not part of that Major +Component, and (b) serves only to enable use of the work with that +Major Component, or to implement a Standard Interface for which an +implementation is available to the public in source code form. A +"Major Component", in this context, means a major essential component +(kernel, window system, and so on) of the specific operating system +(if any) on which the executable work runs, or a compiler used to +produce the work, or an object code interpreter used to run it. + + The "Corresponding Source" for a work in object code form means all +the source code needed to generate, install, and (for an executable +work) run the object code and to modify the work, including scripts to +control those activities. However, it does not include the work's +System Libraries, or general-purpose tools or generally available free +programs which are used unmodified in performing those activities but +which are not part of the work. For example, Corresponding Source +includes interface definition files associated with source files for +the work, and the source code for shared libraries and dynamically +linked subprograms that the work is specifically designed to require, +such as by intimate data communication or control flow between those +subprograms and other parts of the work. + + The Corresponding Source need not include anything that users +can regenerate automatically from other parts of the Corresponding +Source. + + The Corresponding Source for a work in source code form is that +same work. + + 2. Basic Permissions. + + All rights granted under this License are granted for the term of +copyright on the Program, and are irrevocable provided the stated +conditions are met. This License explicitly affirms your unlimited +permission to run the unmodified Program. The output from running a +covered work is covered by this License only if the output, given its +content, constitutes a covered work. This License acknowledges your +rights of fair use or other equivalent, as provided by copyright law. + + You may make, run and propagate covered works that you do not +convey, without conditions so long as your license otherwise remains +in force. You may convey covered works to others for the sole purpose +of having them make modifications exclusively for you, or provide you +with facilities for running those works, provided that you comply with +the terms of this License in conveying all material for which you do +not control copyright. Those thus making or running the covered works +for you must do so exclusively on your behalf, under your direction +and control, on terms that prohibit them from making any copies of +your copyrighted material outside their relationship with you. + + Conveying under any other circumstances is permitted solely under +the conditions stated below. Sublicensing is not allowed; section 10 +makes it unnecessary. + + 3. Protecting Users' Legal Rights From Anti-Circumvention Law. + + No covered work shall be deemed part of an effective technological +measure under any applicable law fulfilling obligations under article +11 of the WIPO copyright treaty adopted on 20 December 1996, or +similar laws prohibiting or restricting circumvention of such +measures. + + When you convey a covered work, you waive any legal power to forbid +circumvention of technological measures to the extent such circumvention +is effected by exercising rights under this License with respect to +the covered work, and you disclaim any intention to limit operation or +modification of the work as a means of enforcing, against the work's +users, your or third parties' legal rights to forbid circumvention of +technological measures. + + 4. Conveying Verbatim Copies. + + You may convey verbatim copies of the Program's source code as you +receive it, in any medium, provided that you conspicuously and +appropriately publish on each copy an appropriate copyright notice; +keep intact all notices stating that this License and any +non-permissive terms added in accord with section 7 apply to the code; +keep intact all notices of the absence of any warranty; and give all +recipients a copy of this License along with the Program. + + You may charge any price or no price for each copy that you convey, +and you may offer support or warranty protection for a fee. + + 5. Conveying Modified Source Versions. + + You may convey a work based on the Program, or the modifications to +produce it from the Program, in the form of source code under the +terms of section 4, provided that you also meet all of these conditions: + + a) The work must carry prominent notices stating that you modified + it, and giving a relevant date. + + b) The work must carry prominent notices stating that it is + released under this License and any conditions added under section + 7. This requirement modifies the requirement in section 4 to + "keep intact all notices". + + c) You must license the entire work, as a whole, under this + License to anyone who comes into possession of a copy. This + License will therefore apply, along with any applicable section 7 + additional terms, to the whole of the work, and all its parts, + regardless of how they are packaged. This License gives no + permission to license the work in any other way, but it does not + invalidate such permission if you have separately received it. + + d) If the work has interactive user interfaces, each must display + Appropriate Legal Notices; however, if the Program has interactive + interfaces that do not display Appropriate Legal Notices, your + work need not make them do so. + + A compilation of a covered work with other separate and independent +works, which are not by their nature extensions of the covered work, +and which are not combined with it such as to form a larger program, +in or on a volume of a storage or distribution medium, is called an +"aggregate" if the compilation and its resulting copyright are not +used to limit the access or legal rights of the compilation's users +beyond what the individual works permit. Inclusion of a covered work +in an aggregate does not cause this License to apply to the other +parts of the aggregate. + + 6. Conveying Non-Source Forms. + + You may convey a covered work in object code form under the terms +of sections 4 and 5, provided that you also convey the +machine-readable Corresponding Source under the terms of this License, +in one of these ways: + + a) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by the + Corresponding Source fixed on a durable physical medium + customarily used for software interchange. + + b) Convey the object code in, or embodied in, a physical product + (including a physical distribution medium), accompanied by a + written offer, valid for at least three years and valid for as + long as you offer spare parts or customer support for that product + model, to give anyone who possesses the object code either (1) a + copy of the Corresponding Source for all the software in the + product that is covered by this License, on a durable physical + medium customarily used for software interchange, for a price no + more than your reasonable cost of physically performing this + conveying of source, or (2) access to copy the + Corresponding Source from a network server at no charge. + + c) Convey individual copies of the object code with a copy of the + written offer to provide the Corresponding Source. This + alternative is allowed only occasionally and noncommercially, and + only if you received the object code with such an offer, in accord + with subsection 6b. + + d) Convey the object code by offering access from a designated + place (gratis or for a charge), and offer equivalent access to the + Corresponding Source in the same way through the same place at no + further charge. You need not require recipients to copy the + Corresponding Source along with the object code. If the place to + copy the object code is a network server, the Corresponding Source + may be on a different server (operated by you or a third party) + that supports equivalent copying facilities, provided you maintain + clear directions next to the object code saying where to find the + Corresponding Source. Regardless of what server hosts the + Corresponding Source, you remain obligated to ensure that it is + available for as long as needed to satisfy these requirements. + + e) Convey the object code using peer-to-peer transmission, provided + you inform other peers where the object code and Corresponding + Source of the work are being offered to the general public at no + charge under subsection 6d. + + A separable portion of the object code, whose source code is excluded +from the Corresponding Source as a System Library, need not be +included in conveying the object code work. + + A "User Product" is either (1) a "consumer product", which means any +tangible personal property which is normally used for personal, family, +or household purposes, or (2) anything designed or sold for incorporation +into a dwelling. In determining whether a product is a consumer product, +doubtful cases shall be resolved in favor of coverage. For a particular +product received by a particular user, "normally used" refers to a +typical or common use of that class of product, regardless of the status +of the particular user or of the way in which the particular user +actually uses, or expects or is expected to use, the product. A product +is a consumer product regardless of whether the product has substantial +commercial, industrial or non-consumer uses, unless such uses represent +the only significant mode of use of the product. + + "Installation Information" for a User Product means any methods, +procedures, authorization keys, or other information required to install +and execute modified versions of a covered work in that User Product from +a modified version of its Corresponding Source. The information must +suffice to ensure that the continued functioning of the modified object +code is in no case prevented or interfered with solely because +modification has been made. + + If you convey an object code work under this section in, or with, or +specifically for use in, a User Product, and the conveying occurs as +part of a transaction in which the right of possession and use of the +User Product is transferred to the recipient in perpetuity or for a +fixed term (regardless of how the transaction is characterized), the +Corresponding Source conveyed under this section must be accompanied +by the Installation Information. But this requirement does not apply +if neither you nor any third party retains the ability to install +modified object code on the User Product (for example, the work has +been installed in ROM). + + The requirement to provide Installation Information does not include a +requirement to continue to provide support service, warranty, or updates +for a work that has been modified or installed by the recipient, or for +the User Product in which it has been modified or installed. Access to a +network may be denied when the modification itself materially and +adversely affects the operation of the network or violates the rules and +protocols for communication across the network. + + Corresponding Source conveyed, and Installation Information provided, +in accord with this section must be in a format that is publicly +documented (and with an implementation available to the public in +source code form), and must require no special password or key for +unpacking, reading or copying. + + 7. Additional Terms. + + "Additional permissions" are terms that supplement the terms of this +License by making exceptions from one or more of its conditions. +Additional permissions that are applicable to the entire Program shall +be treated as though they were included in this License, to the extent +that they are valid under applicable law. If additional permissions +apply only to part of the Program, that part may be used separately +under those permissions, but the entire Program remains governed by +this License without regard to the additional permissions. + + When you convey a copy of a covered work, you may at your option +remove any additional permissions from that copy, or from any part of +it. (Additional permissions may be written to require their own +removal in certain cases when you modify the work.) You may place +additional permissions on material, added by you to a covered work, +for which you have or can give appropriate copyright permission. + + Notwithstanding any other provision of this License, for material you +add to a covered work, you may (if authorized by the copyright holders of +that material) supplement the terms of this License with terms: + + a) Disclaiming warranty or limiting liability differently from the + terms of sections 15 and 16 of this License; or + + b) Requiring preservation of specified reasonable legal notices or + author attributions in that material or in the Appropriate Legal + Notices displayed by works containing it; or + + c) Prohibiting misrepresentation of the origin of that material, or + requiring that modified versions of such material be marked in + reasonable ways as different from the original version; or + + d) Limiting the use for publicity purposes of names of licensors or + authors of the material; or + + e) Declining to grant rights under trademark law for use of some + trade names, trademarks, or service marks; or + + f) Requiring indemnification of licensors and authors of that + material by anyone who conveys the material (or modified versions of + it) with contractual assumptions of liability to the recipient, for + any liability that these contractual assumptions directly impose on + those licensors and authors. + + All other non-permissive additional terms are considered "further +restrictions" within the meaning of section 10. If the Program as you +received it, or any part of it, contains a notice stating that it is +governed by this License along with a term that is a further +restriction, you may remove that term. If a license document contains +a further restriction but permits relicensing or conveying under this +License, you may add to a covered work material governed by the terms +of that license document, provided that the further restriction does +not survive such relicensing or conveying. + + If you add terms to a covered work in accord with this section, you +must place, in the relevant source files, a statement of the +additional terms that apply to those files, or a notice indicating +where to find the applicable terms. + + Additional terms, permissive or non-permissive, may be stated in the +form of a separately written license, or stated as exceptions; +the above requirements apply either way. + + 8. Termination. + + You may not propagate or modify a covered work except as expressly +provided under this License. Any attempt otherwise to propagate or +modify it is void, and will automatically terminate your rights under +this License (including any patent licenses granted under the third +paragraph of section 11). + + However, if you cease all violation of this License, then your +license from a particular copyright holder is reinstated (a) +provisionally, unless and until the copyright holder explicitly and +finally terminates your license, and (b) permanently, if the copyright +holder fails to notify you of the violation by some reasonable means +prior to 60 days after the cessation. + + Moreover, your license from a particular copyright holder is +reinstated permanently if the copyright holder notifies you of the +violation by some reasonable means, this is the first time you have +received notice of violation of this License (for any work) from that +copyright holder, and you cure the violation prior to 30 days after +your receipt of the notice. + + Termination of your rights under this section does not terminate the +licenses of parties who have received copies or rights from you under +this License. If your rights have been terminated and not permanently +reinstated, you do not qualify to receive new licenses for the same +material under section 10. + + 9. Acceptance Not Required for Having Copies. + + You are not required to accept this License in order to receive or +run a copy of the Program. Ancillary propagation of a covered work +occurring solely as a consequence of using peer-to-peer transmission +to receive a copy likewise does not require acceptance. However, +nothing other than this License grants you permission to propagate or +modify any covered work. These actions infringe copyright if you do +not accept this License. Therefore, by modifying or propagating a +covered work, you indicate your acceptance of this License to do so. + + 10. Automatic Licensing of Downstream Recipients. + + Each time you convey a covered work, the recipient automatically +receives a license from the original licensors, to run, modify and +propagate that work, subject to this License. You are not responsible +for enforcing compliance by third parties with this License. + + An "entity transaction" is a transaction transferring control of an +organization, or substantially all assets of one, or subdividing an +organization, or merging organizations. If propagation of a covered +work results from an entity transaction, each party to that +transaction who receives a copy of the work also receives whatever +licenses to the work the party's predecessor in interest had or could +give under the previous paragraph, plus a right to possession of the +Corresponding Source of the work from the predecessor in interest, if +the predecessor has it or can get it with reasonable efforts. + + You may not impose any further restrictions on the exercise of the +rights granted or affirmed under this License. For example, you may +not impose a license fee, royalty, or other charge for exercise of +rights granted under this License, and you may not initiate litigation +(including a cross-claim or counterclaim in a lawsuit) alleging that +any patent claim is infringed by making, using, selling, offering for +sale, or importing the Program or any portion of it. + + 11. Patents. + + A "contributor" is a copyright holder who authorizes use under this +License of the Program or a work on which the Program is based. The +work thus licensed is called the contributor's "contributor version". + + A contributor's "essential patent claims" are all patent claims +owned or controlled by the contributor, whether already acquired or +hereafter acquired, that would be infringed by some manner, permitted +by this License, of making, using, or selling its contributor version, +but do not include claims that would be infringed only as a +consequence of further modification of the contributor version. For +purposes of this definition, "control" includes the right to grant +patent sublicenses in a manner consistent with the requirements of +this License. + + Each contributor grants you a non-exclusive, worldwide, royalty-free +patent license under the contributor's essential patent claims, to +make, use, sell, offer for sale, import and otherwise run, modify and +propagate the contents of its contributor version. + + In the following three paragraphs, a "patent license" is any express +agreement or commitment, however denominated, not to enforce a patent +(such as an express permission to practice a patent or covenant not to +sue for patent infringement). To "grant" such a patent license to a +party means to make such an agreement or commitment not to enforce a +patent against the party. + + If you convey a covered work, knowingly relying on a patent license, +and the Corresponding Source of the work is not available for anyone +to copy, free of charge and under the terms of this License, through a +publicly available network server or other readily accessible means, +then you must either (1) cause the Corresponding Source to be so +available, or (2) arrange to deprive yourself of the benefit of the +patent license for this particular work, or (3) arrange, in a manner +consistent with the requirements of this License, to extend the patent +license to downstream recipients. "Knowingly relying" means you have +actual knowledge that, but for the patent license, your conveying the +covered work in a country, or your recipient's use of the covered work +in a country, would infringe one or more identifiable patents in that +country that you have reason to believe are valid. + + If, pursuant to or in connection with a single transaction or +arrangement, you convey, or propagate by procuring conveyance of, a +covered work, and grant a patent license to some of the parties +receiving the covered work authorizing them to use, propagate, modify +or convey a specific copy of the covered work, then the patent license +you grant is automatically extended to all recipients of the covered +work and works based on it. + + A patent license is "discriminatory" if it does not include within +the scope of its coverage, prohibits the exercise of, or is +conditioned on the non-exercise of one or more of the rights that are +specifically granted under this License. You may not convey a covered +work if you are a party to an arrangement with a third party that is +in the business of distributing software, under which you make payment +to the third party based on the extent of your activity of conveying +the work, and under which the third party grants, to any of the +parties who would receive the covered work from you, a discriminatory +patent license (a) in connection with copies of the covered work +conveyed by you (or copies made from those copies), or (b) primarily +for and in connection with specific products or compilations that +contain the covered work, unless you entered into that arrangement, +or that patent license was granted, prior to 28 March 2007. + + Nothing in this License shall be construed as excluding or limiting +any implied license or other defenses to infringement that may +otherwise be available to you under applicable patent law. + + 12. No Surrender of Others' Freedom. + + If conditions are imposed on you (whether by court order, agreement or +otherwise) that contradict the conditions of this License, they do not +excuse you from the conditions of this License. If you cannot convey a +covered work so as to satisfy simultaneously your obligations under this +License and any other pertinent obligations, then as a consequence you may +not convey it at all. For example, if you agree to terms that obligate you +to collect a royalty for further conveying from those to whom you convey +the Program, the only way you could satisfy both those terms and this +License would be to refrain entirely from conveying the Program. + + 13. Use with the GNU Affero General Public License. + + Notwithstanding any other provision of this License, you have +permission to link or combine any covered work with a work licensed +under version 3 of the GNU Affero General Public License into a single +combined work, and to convey the resulting work. The terms of this +License will continue to apply to the part which is the covered work, +but the special requirements of the GNU Affero General Public License, +section 13, concerning interaction through a network will apply to the +combination as such. + + 14. Revised Versions of this License. + + The Free Software Foundation may publish revised and/or new versions of +the GNU General Public License from time to time. Such new versions will +be similar in spirit to the present version, but may differ in detail to +address new problems or concerns. + + Each version is given a distinguishing version number. If the +Program specifies that a certain numbered version of the GNU General +Public License "or any later version" applies to it, you have the +option of following the terms and conditions either of that numbered +version or of any later version published by the Free Software +Foundation. If the Program does not specify a version number of the +GNU General Public License, you may choose any version ever published +by the Free Software Foundation. + + If the Program specifies that a proxy can decide which future +versions of the GNU General Public License can be used, that proxy's +public statement of acceptance of a version permanently authorizes you +to choose that version for the Program. + + Later license versions may give you additional or different +permissions. However, no additional obligations are imposed on any +author or copyright holder as a result of your choosing to follow a +later version. + + 15. Disclaimer of Warranty. + + THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY +APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT +HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY +OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, +THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR +PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM +IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF +ALL NECESSARY SERVICING, REPAIR OR CORRECTION. + + 16. Limitation of Liability. + + IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING +WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS +THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY +GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE +USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF +DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD +PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), +EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF +SUCH DAMAGES. + + 17. Interpretation of Sections 15 and 16. + + If the disclaimer of warranty and limitation of liability provided +above cannot be given local legal effect according to their terms, +reviewing courts shall apply local law that most closely approximates +an absolute waiver of all civil liability in connection with the +Program, unless a warranty or assumption of liability accompanies a +copy of the Program in return for a fee. + + END OF TERMS AND CONDITIONS + + How to Apply These Terms to Your New Programs + + If you develop a new program, and you want it to be of the greatest +possible use to the public, the best way to achieve this is to make it +free software which everyone can redistribute and change under these terms. + + To do so, attach the following notices to the program. It is safest +to attach them to the start of each source file to most effectively +state the exclusion of warranty; and each file should have at least +the "copyright" line and a pointer to where the full notice is found. + + + Copyright (C) + + This program is free software: you can redistribute it and/or modify + it under the terms of the GNU General Public License as published by + the Free Software Foundation, either version 3 of the License, or + (at your option) any later version. + + This program is distributed in the hope that it will be useful, + but WITHOUT ANY WARRANTY; without even the implied warranty of + MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + GNU General Public License for more details. + + You should have received a copy of the GNU General Public License + along with this program. If not, see . + +Also add information on how to contact you by electronic and paper mail. + + If the program does terminal interaction, make it output a short +notice like this when it starts in an interactive mode: + + Copyright (C) + This program comes with ABSOLUTELY NO WARRANTY; for details type `show w'. + This is free software, and you are welcome to redistribute it + under certain conditions; type `show c' for details. + +The hypothetical commands `show w' and `show c' should show the appropriate +parts of the General Public License. Of course, your program's commands +might be different; for a GUI interface, you would use an "about box". + + You should also get your employer (if you work as a programmer) or school, +if any, to sign a "copyright disclaimer" for the program, if necessary. +For more information on this, and how to apply and follow the GNU GPL, see +. + + The GNU General Public License does not permit incorporating your program +into proprietary programs. If your program is a subroutine library, you +may consider it more useful to permit linking proprietary applications with +the library. If this is what you want to do, use the GNU Lesser General +Public License instead of this License. But first, please read +. diff --git a/LICENSES/LGPL-3.0-only.txt b/LICENSES/LGPL-3.0-only.txt new file mode 100644 index 0000000..65c5ca8 --- /dev/null +++ b/LICENSES/LGPL-3.0-only.txt @@ -0,0 +1,165 @@ + GNU LESSER GENERAL PUBLIC LICENSE + Version 3, 29 June 2007 + + Copyright (C) 2007 Free Software Foundation, Inc. + Everyone is permitted to copy and distribute verbatim copies + of this license document, but changing it is not allowed. + + + This version of the GNU Lesser General Public License incorporates +the terms and conditions of version 3 of the GNU General Public +License, supplemented by the additional permissions listed below. + + 0. Additional Definitions. + + As used herein, "this License" refers to version 3 of the GNU Lesser +General Public License, and the "GNU GPL" refers to version 3 of the GNU +General Public License. + + "The Library" refers to a covered work governed by this License, +other than an Application or a Combined Work as defined below. + + An "Application" is any work that makes use of an interface provided +by the Library, but which is not otherwise based on the Library. +Defining a subclass of a class defined by the Library is deemed a mode +of using an interface provided by the Library. + + A "Combined Work" is a work produced by combining or linking an +Application with the Library. The particular version of the Library +with which the Combined Work was made is also called the "Linked +Version". + + The "Minimal Corresponding Source" for a Combined Work means the +Corresponding Source for the Combined Work, excluding any source code +for portions of the Combined Work that, considered in isolation, are +based on the Application, and not on the Linked Version. + + The "Corresponding Application Code" for a Combined Work means the +object code and/or source code for the Application, including any data +and utility programs needed for reproducing the Combined Work from the +Application, but excluding the System Libraries of the Combined Work. + + 1. Exception to Section 3 of the GNU GPL. + + You may convey a covered work under sections 3 and 4 of this License +without being bound by section 3 of the GNU GPL. + + 2. Conveying Modified Versions. + + If you modify a copy of the Library, and, in your modifications, a +facility refers to a function or data to be supplied by an Application +that uses the facility (other than as an argument passed when the +facility is invoked), then you may convey a copy of the modified +version: + + a) under this License, provided that you make a good faith effort to + ensure that, in the event an Application does not supply the + function or data, the facility still operates, and performs + whatever part of its purpose remains meaningful, or + + b) under the GNU GPL, with none of the additional permissions of + this License applicable to that copy. + + 3. Object Code Incorporating Material from Library Header Files. + + The object code form of an Application may incorporate material from +a header file that is part of the Library. You may convey such object +code under terms of your choice, provided that, if the incorporated +material is not limited to numerical parameters, data structure +layouts and accessors, or small macros, inline functions and templates +(ten or fewer lines in length), you do both of the following: + + a) Give prominent notice with each copy of the object code that the + Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the object code with a copy of the GNU GPL and this license + document. + + 4. Combined Works. + + You may convey a Combined Work under terms of your choice that, +taken together, effectively do not restrict modification of the +portions of the Library contained in the Combined Work and reverse +engineering for debugging such modifications, if you also do each of +the following: + + a) Give prominent notice with each copy of the Combined Work that + the Library is used in it and that the Library and its use are + covered by this License. + + b) Accompany the Combined Work with a copy of the GNU GPL and this license + document. + + c) For a Combined Work that displays copyright notices during + execution, include the copyright notice for the Library among + these notices, as well as a reference directing the user to the + copies of the GNU GPL and this license document. + + d) Do one of the following: + + 0) Convey the Minimal Corresponding Source under the terms of this + License, and the Corresponding Application Code in a form + suitable for, and under terms that permit, the user to + recombine or relink the Application with a modified version of + the Linked Version to produce a modified Combined Work, in the + manner specified by section 6 of the GNU GPL for conveying + Corresponding Source. + + 1) Use a suitable shared library mechanism for linking with the + Library. A suitable mechanism is one that (a) uses at run time + a copy of the Library already present on the user's computer + system, and (b) will operate properly with a modified version + of the Library that is interface-compatible with the Linked + Version. + + e) Provide Installation Information, but only if you would otherwise + be required to provide such information under section 6 of the + GNU GPL, and only to the extent that such information is + necessary to install and execute a modified version of the + Combined Work produced by recombining or relinking the + Application with a modified version of the Linked Version. (If + you use option 4d0, the Installation Information must accompany + the Minimal Corresponding Source and Corresponding Application + Code. If you use option 4d1, you must provide the Installation + Information in the manner specified by section 6 of the GNU GPL + for conveying Corresponding Source.) + + 5. Combined Libraries. + + You may place library facilities that are a work based on the +Library side by side in a single library together with other library +facilities that are not Applications and are not covered by this +License, and convey such a combined library under terms of your +choice, if you do both of the following: + + a) Accompany the combined library with a copy of the same work based + on the Library, uncombined with any other library facilities, + conveyed under the terms of this License. + + b) Give prominent notice with the combined library that part of it + is a work based on the Library, and explaining where to find the + accompanying uncombined form of the same work. + + 6. Revised Versions of the GNU Lesser General Public License. + + The Free Software Foundation may publish revised and/or new versions +of the GNU Lesser General Public License from time to time. Such new +versions will be similar in spirit to the present version, but may +differ in detail to address new problems or concerns. + + Each version is given a distinguishing version number. If the +Library as you received it specifies that a certain numbered version +of the GNU Lesser General Public License "or any later version" +applies to it, you have the option of following the terms and +conditions either of that published version or of any later version +published by the Free Software Foundation. If the Library as you +received it does not specify a version number of the GNU Lesser +General Public License, you may choose any version of the GNU Lesser +General Public License ever published by the Free Software Foundation. + + If the Library as you received it specifies that a proxy can decide +whether future versions of the GNU Lesser General Public License shall +apply, that proxy's public statement of acceptance of any version is +permanent authorization for you to choose that version for the +Library. diff --git a/LICENSES/LicenseRef-Qt-Commercial.txt b/LICENSES/LicenseRef-Qt-Commercial.txt new file mode 100644 index 0000000..825b1f3 --- /dev/null +++ b/LICENSES/LicenseRef-Qt-Commercial.txt @@ -0,0 +1,8 @@ +Licensees holding valid commercial Qt licenses may use this software in +accordance with the the terms contained in a written agreement between +you and The Qt Company. Alternatively, the terms and conditions that were +accepted by the licensee when buying and/or downloading the +software do apply. + +For the latest licensing terms and conditions, see https://www.qt.io/terms-conditions. +For further information use the contact form at https://www.qt.io/contact-us. diff --git a/LICENSES/MPL-2.0.txt b/LICENSES/MPL-2.0.txt new file mode 100644 index 0000000..ee6256c --- /dev/null +++ b/LICENSES/MPL-2.0.txt @@ -0,0 +1,373 @@ +Mozilla Public License Version 2.0 +================================== + +1. Definitions +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at https://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/LICENSES/Qt-GPL-exception-1.0.txt b/LICENSES/Qt-GPL-exception-1.0.txt new file mode 100644 index 0000000..d0322bf --- /dev/null +++ b/LICENSES/Qt-GPL-exception-1.0.txt @@ -0,0 +1,22 @@ +The Qt Company GPL Exception 1.0 + +Exception 1: + +As a special exception you may create a larger work which contains the +output of this application and distribute that work under terms of your +choice, so long as the work is not otherwise derived from or based on +this application and so long as the work does not in itself generate +output that contains the output from this application in its original +or modified form. + +Exception 2: + +As a special exception, you have permission to combine this application +with Plugins licensed under the terms of your choice, to produce an +executable, and to copy and distribute the resulting executable under +the terms of your choice. However, the executable must be accompanied +by a prominent notice offering all users of the executable the entire +source code to this application, excluding the source code of the +independent modules, but including any changes you have made to this +application, under the terms of this license. + diff --git a/REUSE.toml b/REUSE.toml new file mode 100644 index 0000000..589742e --- /dev/null +++ b/REUSE.toml @@ -0,0 +1,51 @@ +version = 1 + +[[annotations]] +path = "src/android/jar/AndroidManifest.xml" +precedence = "closest" +comment = "source and plugins" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only" + +[[annotations]] +path = "tests/**" +precedence = "closest" +comment = "test" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GPL-3.0-only" + +[[annotations]] +path = ["**.pro", "**.qrc", ".cmake.conf", "**.yaml", "**.json", + "**.cfg", "**BLACKLIST", "**.plist.in", "**.pri", "**.plist"] +precedence = "closest" +comment = "build system" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "BSD-3-Clause" + +[[annotations]] +path = [".tag", "**/.gitattributes", "**.gitignore"] +comment = "version control system. Licensed as build system" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "BSD-3-Clause" + +[[annotations]] +path = ["**/doc/src/images/**", "examples/**", "**/doc/snippets/**"] +comment = "this must be after the build system table because example and snippets take precedence over build system" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR BSD-3-Clause" + +[[annotations]] +path = ["util/macos_test_audio_config/README", "**.qdocconf", "**.qdocinc", "src/multimedia/doc/src/classic.css", "config_help.txt"] +comment = "documentation" +precedence = "closest" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" + +[[annotations]] +path = ["**.toml", "licenseRule.json", "**/qt_attribution.json"] +comment = "documentation" +precedence = "override" +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" diff --git a/cmake/FindAVFoundation.cmake b/cmake/FindAVFoundation.cmake new file mode 100644 index 0000000..3dad5d6 --- /dev/null +++ b/cmake/FindAVFoundation.cmake @@ -0,0 +1,14 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +find_library(AVFoundation_LIBRARY NAMES AVFoundation) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(AVFoundation DEFAULT_MSG AVFoundation_LIBRARY) + +if(AVFoundation_FOUND AND NOT TARGET AVFoundation::AVFoundation) + add_library(AVFoundation::AVFoundation INTERFACE IMPORTED) + set_target_properties(AVFoundation::AVFoundation PROPERTIES + INTERFACE_LINK_LIBRARIES "${AVFoundation_LIBRARY}") +endif() + +mark_as_advanced(AVFoundation_LIBRARY) diff --git a/cmake/FindFFmpeg.cmake b/cmake/FindFFmpeg.cmake new file mode 100644 index 0000000..7ca637f --- /dev/null +++ b/cmake/FindFFmpeg.cmake @@ -0,0 +1,393 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause +#.rst: +# FindFFmpeg +# ---------- +# +# Try to find the required ffmpeg components (default: AVFORMAT, AVUTIL, AVCODEC) +# +# Next variables can be used to hint FFmpeg libs search: +# +# :: +# +# PC__LIBRARY_DIRS +# PC_FFMPEG_LIBRARY_DIRS +# PC__INCLUDE_DIRS +# PC_FFMPEG_INCLUDE_DIRS +# +# Once done this will define +# +# :: +# +# FFMPEG_FOUND - System has the all required components. +# FFMPEG_SHARED_LIBRARIES - Found FFmpeg shared libraries. +# +# For each of the components it will additionally set. +# +# :: +# +# AVCODEC +# AVDEVICE +# AVFORMAT +# AVFILTER +# AVUTIL +# POSTPROC +# SWSCALE +# +# the following variables will be defined +# +# :: +# +# _FOUND - System has +# FFMPEG__FOUND - System has (as checked by FHSPA) +# _INCLUDE_DIRS - Include directory necessary for using the headers +# _LIBRARIES - Link these to use +# _LIBRARY_DIRS - Link directories +# _DEFINITIONS - Compiler switches required for using +# _VERSION - The components version +# +# the following import targets is created +# +# :: +# +# FFmpeg::FFmpeg - for all components +# FFmpeg:: - where in lower case (FFmpeg::avcodec) for each components +# +# Copyright (c) 2006, Matthias Kretz, +# Copyright (c) 2008, Alexander Neundorf, +# Copyright (c) 2011, Michael Jansen, +# Copyright (c) 2017, Alexander Drozdov, +# + +include(FindPackageHandleStandardArgs) + +# The default components were taken from a survey over other FindFFMPEG.cmake files +if (NOT FFmpeg_FIND_COMPONENTS) + set(FFmpeg_FIND_COMPONENTS AVCODEC AVFORMAT AVUTIL) +endif () + +if (QT_DEPLOY_FFMPEG AND BUILD_SHARED_LIBS) + set(shared_libs_desired TRUE) +endif() + +# finds FFmpeg libs, including symlinks, for the specified component. +macro(find_shared_libs_for_component _component) + # the searching pattern is pretty rough but it seems to be sufficient to gather dynamic libs + get_filename_component(name_we ${${_component}_LIBRARY} NAME_WE) + + if (WIN32) + get_filename_component(dir_name ${${_component}_LIBRARY_DIR} NAME) + if (${dir_name} STREQUAL "lib" AND EXISTS "${${_component}_LIBRARY_DIR}/../bin") + # llvm-mingv builds aux ffmpeg static libs like lib/libavutil.dll.a and cmake finds + # only them even though the folder bin/ contains proper *.dll and *.lib. + + string(REGEX REPLACE "^lib" "" name_we "${name_we}") + set(shared_lib_pattern "../bin/${name_we}*${CMAKE_SHARED_LIBRARY_SUFFIX}") + else() + set(shared_lib_pattern "${name_we}*${CMAKE_SHARED_LIBRARY_SUFFIX}") + endif() + + else() + set(shared_lib_pattern "${name_we}*${CMAKE_SHARED_LIBRARY_SUFFIX}*") + endif() + + file(GLOB ${_component}_SHARED_LIBRARIES "${${_component}_LIBRARY_DIR}/${shared_lib_pattern}") +endmacro() + +# +### Macro: set_component_found +# +# Marks the given component as found if both *_LIBRARY_NAME AND *_INCLUDE_DIRS is present. +# +macro(set_component_found _component) + if (${_component}_LIBRARY_NAME AND ${_component}_INCLUDE_DIR) + # message(STATUS " - ${_component} found.") + set(${_component}_FOUND TRUE) + set(${CMAKE_FIND_PACKAGE_NAME}_${_component}_FOUND TRUE) + else () + # message(STATUS " - ${_component} not found.") + endif () +endmacro() + +find_package(PkgConfig QUIET) +if (NOT PKG_CONFIG_FOUND AND NOT FFMPEG_DIR) + set(FFMPEG_DIR "/usr/local") +endif() +# +### Macro: find_component +# +# Checks for the given component by invoking pkgconfig and then looking up the libraries and +# include directories. +# +macro(find_component _component _pkgconfig _library _header) + # use pkg-config to get the directories and then use these values + # in the FIND_PATH() and FIND_LIBRARY() calls + if (PKG_CONFIG_FOUND AND NOT FFMPEG_DIR) + pkg_check_modules(PC_${_component} ${_pkgconfig}) + endif () + + if (FFMPEG_DIR OR FFMPEG_ROOT) + set(__find_ffmpeg_backup_root_dir "${CMAKE_FIND_ROOT_PATH}") + endif() + + if(FFMPEG_DIR) + list(APPEND CMAKE_FIND_ROOT_PATH "${FFMPEG_DIR}") + endif() + + if(FFMPEG_ROOT) + list(APPEND CMAKE_FIND_ROOT_PATH "${FFMPEG_ROOT}") + endif() + + if (${_component}_INCLUDE_DIR AND NOT EXISTS ${${_component}_INCLUDE_DIR}) + message(STATUS "Cached include dir ${${_component}_INCLUDE_DIR} doesn't exist") + unset(${_component}_INCLUDE_DIR CACHE) + endif() + + find_path(${_component}_INCLUDE_DIR ${_header} + HINTS + ${PC_${_component}_INCLUDEDIR} + ${PC_${_component}_INCLUDE_DIRS} + ${PC_FFMPEG_INCLUDE_DIRS} + PATHS + ${FFMPEG_DIR} + PATH_SUFFIXES + ffmpeg include + ) + + if (shared_libs_desired AND NOT WIN32) + set(CMAKE_FIND_LIBRARY_SUFFIXES "${CMAKE_SHARED_LIBRARY_SUFFIX};${CMAKE_STATIC_LIBRARY_SUFFIX}") + endif() + + if (${_component}_LIBRARY AND NOT EXISTS ${${_component}_LIBRARY}) + message(STATUS "Cached library ${${_component}_LIBRARY} doesn't exist") + unset(${_component}_LIBRARY CACHE) + endif() + + find_library(${_component}_LIBRARY + NAMES ${PC_${_component}_LIBRARIES} ${_library} + HINTS + ${PC_${_component}_LIBDIR} + ${PC_${_component}_LIBRARY_DIRS} + ${PC_FFMPEG_LIBRARY_DIRS} + PATHS + ${FFMPEG_DIR} + PATH_SUFFIXES + lib bin + ) + + if(FFMPEG_DIR OR FFMPEG_ROOT) + set(CMAKE_FIND_ROOT_PATH "${__find_ffmpeg_backup_root_dir}") + endif() + + if (${_component}_LIBRARY) + get_filename_component(${_component}_LIBRARY_DIR ${${_component}_LIBRARY} DIRECTORY) + get_filename_component(${_component}_LIBRARY_NAME ${${_component}_LIBRARY} NAME) + + # On Windows, shared linking goes through 'integration' static libs, so we should look for shared ones anyway + # On Unix, we gather symlinks as well so that we could install them. + if (WIN32 OR ${${_component}_LIBRARY_NAME} MATCHES "\\${CMAKE_SHARED_LIBRARY_SUFFIX}$") + find_shared_libs_for_component(${_component}) + endif() + + endif() + + set(${_component}_DEFINITIONS ${PC_${_component}_CFLAGS_OTHER}) + set_component_found(${_component}) + + mark_as_advanced(${_component}_LIBRARY) +endmacro() + +# Clear the previously cached variables, because they are recomputed every time +# the Find script is included. +unset(FFMPEG_SHARED_LIBRARIES CACHE) +unset(FFMPEG_STUBS CACHE) + +# Check for components. +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + string(TOLOWER ${_component} library) + find_component(${_component} "lib${library}" ${library} "lib${library}/${library}.h") + + if (${_component}_FOUND) + list(APPEND FFMPEG_LIBRARIES ${${_component}_LIBRARY_NAME}) + list(APPEND FFMPEG_DEFINITIONS ${${_component}_DEFINITIONS}) + list(APPEND FFMPEG_INCLUDE_DIRS ${${_component}_INCLUDE_DIR}) + list(APPEND FFMPEG_LIBRARY_DIRS ${${_component}_LIBRARY_DIR}) + + if (${_component}_SHARED_LIBRARIES) + list(APPEND FFMPEG_SHARED_LIBRARIES ${${_component}_SHARED_LIBRARIES}) + list(APPEND FFMPEG_SHARED_COMPONENTS ${_component}) + else() + list(APPEND FFMPEG_STATIC_COMPONENTS ${_component}) + endif() + + mark_as_advanced(${_component}_LIBRARY_NAME ${_component}_DEFINITIONS ${_component}_INCLUDE_DIR + ${_component}_LIBRARY_DIR ${_component}_SHARED_LIBRARIES) + endif() +endforeach() + + +function(qt_internal_multimedia_try_add_dynamic_resolve_dependency _component dep) + set(dynamic_resolve_added FALSE PARENT_SCOPE) + + if (NOT ANDROID AND NOT LINUX) + return() + endif() + + set(supported_stubs "ssl|crypto|va|va-drm|va-x11") + if(${_component}_SHARED_LIBRARIES) + set(stub_prefix "Qt${PROJECT_VERSION_MAJOR}FFmpegStub-") + if (${dep} MATCHES "^${stub_prefix}(${supported_stubs})$") + string(REPLACE "${stub_prefix}" "" dep "${dep}") + set(FFMPEG_STUBS ${FFMPEG_STUBS} ${dep} CACHE INTERNAL "") + + set(dynamic_resolve_added TRUE PARENT_SCOPE) + endif() + elseif (${dep} MATCHES "^(${supported_stubs})$") + set(FFMPEG_STUBS ${FFMPEG_STUBS} ${dep} CACHE INTERNAL "") + set(dynamic_resolve_added TRUE PARENT_SCOPE) + endif() +endfunction() + +# Function parses package config file to find the static library dependencies +# and adds them to the target library. +function(__ffmpeg_internal_set_dependencies _component) + string(TOLOWER ${_component} lib) + + # The pkgconfig directory is always in lib/pkgconfig/, even on Windows + # where libs and dlls are in bin/ + set(PC_FILE ${${_component}_LIBRARY_DIR}/../lib/pkgconfig/lib${lib}.pc) + + if(EXISTS ${PC_FILE}) + file(READ ${PC_FILE} pcfile) + + set(prefix_l "(^| )\\-l") + set(suffix_lib "\\.lib($| )") + + string(REGEX REPLACE ".*Libs:([^\n\r]+).*" "\\1" out "${pcfile}") + string(REGEX MATCHALL "${prefix_l}[^ ]+" libs_dependency ${out}) + string(REGEX MATCHALL "[^ ]+${suffix_lib}" libs_dependency_lib ${out}) + + string(REGEX REPLACE ".*Libs.private:([^\n\r]+).*" "\\1" out "${pcfile}") + string(REGEX MATCHALL "${prefix_l}[^ ]+" libs_private_dependency ${out}) + string(REGEX MATCHALL "[^ ]+${suffix_lib}" libs_private_dependency_lib ${out}) + + list(APPEND deps_no_suffix ${libs_dependency} ${libs_private_dependency}) + foreach(dependency ${deps_no_suffix}) + string(REGEX REPLACE ${prefix_l} "" dependency ${dependency}) + if(NOT ${lib} STREQUAL ${dependency}) + qt_internal_multimedia_try_add_dynamic_resolve_dependency(${_component} ${dependency}) + if(NOT dynamic_resolve_added AND NOT ${_component}_SHARED_LIBRARIES) + target_link_libraries(FFmpeg::${lib} INTERFACE ${dependency}) + endif() + endif() + endforeach() + + if(NOT ${_component}_SHARED_LIBRARIES) + list(APPEND deps_lib_suffix ${libs_dependency_lib} ${libs_private_dependency_lib}) + foreach(dependency ${deps_lib_suffix}) + string(REGEX REPLACE ${suffix_lib} "" dependency ${dependency}) + target_link_libraries(FFmpeg::${lib} INTERFACE ${dependency}) + endforeach() + endif() + else() + message(WARNING "FFmpeg pc file ${PC_FILE} is not found") + endif() +endfunction() + +# Check for cached results. If there are skip the costly part. +#if (NOT FFMPEG_LIBRARIES) + + # Check if the required components were found and add their stuff to the FFMPEG_* vars. + + +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + if (${_component}_FOUND) + string(TOLOWER ${_component} _lowerComponent) + if (NOT TARGET FFmpeg::${_lowerComponent}) + add_library(FFmpeg::${_lowerComponent} INTERFACE IMPORTED) + set_target_properties(FFmpeg::${_lowerComponent} PROPERTIES + INTERFACE_COMPILE_OPTIONS "${${_component}_DEFINITIONS}" + INTERFACE_INCLUDE_DIRECTORIES ${${_component}_INCLUDE_DIR} + INTERFACE_LINK_LIBRARIES "${${_component}_LIBRARY_NAME}" + INTERFACE_LINK_DIRECTORIES "${${_component}_LIBRARY_DIR}" + ) + + __ffmpeg_internal_set_dependencies(${_component}) + target_link_libraries(FFmpeg::${_lowerComponent} INTERFACE "${${_component}_LIBRARY_NAME}") + if (UNIX AND NOT APPLE) + target_link_options(FFmpeg::${_lowerComponent} INTERFACE "-Wl,--exclude-libs=lib${_lowerComponent}") + endif () + endif() + endif() +endforeach () + +# Build the include path with duplicates removed. +list(REMOVE_DUPLICATES FFMPEG_INCLUDE_DIRS) +list(REMOVE_DUPLICATES FFMPEG_LIBRARY_DIRS) +list(REMOVE_DUPLICATES FFMPEG_SHARED_LIBRARIES) +list(REMOVE_DUPLICATES FFMPEG_STUBS) + +message(STATUS "FFmpeg shared libs: ${FFMPEG_SHARED_LIBRARIES}") +message(STATUS "FFmpeg stubs: ${FFMPEG_STUBS}") + +# cache the vars. +set(FFMPEG_SHARED_LIBRARIES ${FFMPEG_SHARED_LIBRARIES} CACHE STRING "The FFmpeg dynamic libraries." FORCE) +set(FFMPEG_STUBS ${FFMPEG_STUBS} CACHE STRING "The FFmpeg stubs." FORCE) + +mark_as_advanced(FFMPEG_SHARED_LIBRARIES) +mark_as_advanced(FFMPEG_STUBS) + +# endif () + +list(LENGTH FFMPEG_LIBRARY_DIRS DIRS_COUNT) +if (${DIRS_COUNT} GREATER 1) + message(WARNING "One ffmpeg library dir is expected, found dirs: ${FFMPEG_LIBRARY_DIRS}") +endif() + +if(FFMPEG_SHARED_COMPONENTS AND FFMPEG_STATIC_COMPONENTS) + message(WARNING + "Only static or shared components are expected\n" + " static components: ${FFMPEG_STATIC_COMPONENTS}\n" + " shared components: ${FFMPEG_SHARED_COMPONENTS}") +endif() + +if (shared_libs_desired AND NOT FFMPEG_SHARED_COMPONENTS) + message(WARNING + "Shared FFmpeg libs are desired as QT_DEPLOY_FFMPEG=TRUE, but haven't been found!\n" + "Remove QT_DEPLOY_FFMPEG or set the proper path to shared FFmpeg via FFMPEG_DIR.") +endif() + +if (NOT TARGET FFmpeg::FFmpeg) + add_library(FFmpeg INTERFACE) + set_target_properties(FFmpeg PROPERTIES + INTERFACE_COMPILE_OPTIONS "${FFMPEG_DEFINITIONS}" + INTERFACE_INCLUDE_DIRECTORIES "${FFMPEG_INCLUDE_DIRS}" + INTERFACE_LINK_LIBRARIES "${FFMPEG_LIBRARIES}" + INTERFACE_LINK_DIRECTORIES "${FFMPEG_LIBRARY_DIRS}" + ) + add_library(FFmpeg::FFmpeg ALIAS FFmpeg) +endif() + +# Compile the list of required vars +set(_FFmpeg_REQUIRED_VARS FFMPEG_LIBRARIES FFMPEG_INCLUDE_DIRS) +foreach (_component ${FFmpeg_FIND_COMPONENTS}) + list(APPEND _FFmpeg_REQUIRED_VARS ${_component}_LIBRARY ${_component}_INCLUDE_DIR) +endforeach () + +set(FIND_FFMPEG_HELP_STRING +[=[FFMPEG_DIR CMake variable is not correct. + Make sure that the FFMPEG_DIR CMake variable is set to a path that + contains FFmpeg 'lib' and 'include' directories and that the FFmpeg + installation is built with the avformat, avcodec, swresample, + swscale, and avutil libraries. To resolve the issue, please delete + CMakeCache.txt and run configure again with the correct FFMPEG_DIR + CMake variable set. +]=]) + +# Give a nice error message if some of the required vars are missing. +find_package_handle_standard_args(FFmpeg + REQUIRED_VARS ${_FFmpeg_REQUIRED_VARS} + HANDLE_COMPONENTS + REASON_FAILURE_MESSAGE + ${FIND_FFMPEG_HELP_STRING} +) diff --git a/cmake/FindGObject.cmake b/cmake/FindGObject.cmake new file mode 100644 index 0000000..89a0243 --- /dev/null +++ b/cmake/FindGObject.cmake @@ -0,0 +1,58 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindGObject +# --------- +# +# Try to locate the gobject-2.0 library. +# If found, this will define the following variables: +# +# ``GObject_FOUND`` +# True if the gobject-2.0 library is available +# +# If ``GObject_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``GObject::GObject`` +# The gobject-2.0 library + +include(CMakeFindDependencyMacro) +find_dependency(GLIB2) +qt_internal_disable_find_package_global_promotion(GLIB2::GLIB2) + +if(NOT TARGET GObject::GObject) + find_package(PkgConfig QUIET) + pkg_check_modules(PC_GOBJECT gobject-2.0 IMPORTED_TARGET) + if(TARGET PkgConfig::PC_GOBJECT) + add_library(GObject::GObject INTERFACE IMPORTED) + target_link_libraries(GObject::GObject INTERFACE + PkgConfig::PC_GOBJECT + GLIB2::GLIB2 + ) + else() + find_path(GObject_INCLUDE_DIR + NAMES gobject.h + PATH_SUFFIXES glib-2.0/gobject/ + ) + find_library(GObject_LIBRARY NAMES gobject-2.0) + if(GObject_LIBRARY AND GObject_INCLUDE_DIR) + add_library(GObject::GObject INTERFACE IMPORTED) + target_include_directories(GObject::GObject INTERFACE + ${GObject_INCLUDE_DIR} + ) + target_link_libraries(GObject::GObject INTERFACE + ${GObject_LIBRARY} + GLIB2::GLIB2 + ) + endif() + include(FindPackageHandleStandardArgs) + find_package_handle_standard_args(GObject REQUIRED_VARS + GObject_LIBRARY + GObject_INCLUDE_DIR + ) + endif() +endif() + +if(TARGET GObject::GObject) + set(GObject_FOUND TRUE) +endif() diff --git a/cmake/FindGStreamer.cmake b/cmake/FindGStreamer.cmake new file mode 100644 index 0000000..2587d3f --- /dev/null +++ b/cmake/FindGStreamer.cmake @@ -0,0 +1,258 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindGStreamer +# --------- +# +# Locate the gstreamer-1.0 library and some of its plugins. +# Defines the following imported target: +# +# ``GStreamer::GStreamer`` +# If the gstreamer-1.0 library is available and target GStreamer::Base, +# GStreamer::Audio, GStreamer::Video, GStreamer::Pbutils and +# GStreamer::Allocators exist +# +# If target GStreamer::GStreamer exists, the following targets may be defined: +# +# ``GStreamer::App`` +# If the gstapp-1.0 library is available and its dependencies exist +# ``GStreamer::Photography`` +# If the gstphotography-1.0 library is available and its dependencies exist +# ``GStreamer::Gl`` +# If the gstgl-1.0 library is available and its dependencies exist +# ``GStreamer::GlEgl`` +# If the gstreamer-gl-egl-1.0 library is available and its dependencies exist +# ``GStreamer::GlWayland`` +# If the gstreamer-gl-wayland-1.0 library is available and its dependencies exist +# ``GStreamer::GlX11`` +# If the gstreamer-gl-x11-1.0 library is available and its dependencies exist +# + +include(CMakeFindDependencyMacro) +find_dependency(GObject) + +find_package(PkgConfig QUIET) + +function(find_gstreamer_component component) + cmake_parse_arguments(PARSE_ARGV 1 ARGS "" "PC_NAME;HEADER;LIBRARY" "DEPENDENCIES") + + set(pkgconfig_name ${ARGS_PC_NAME}) + set(header ${ARGS_HEADER}) + set(library ${ARGS_LIBRARY}) + + set(target GStreamer::${component}) + + if(NOT TARGET ${target}) + if(PKG_CONFIG_FOUND) + string(TOUPPER ${component} upper) + pkg_check_modules(PC_GSTREAMER_${upper} IMPORTED_TARGET ${pkgconfig_name}>=${GStreamer_FIND_VERSION} ) + if(TARGET PkgConfig::PC_GSTREAMER_${upper}) + add_library(GStreamer::${component} INTERFACE IMPORTED) + target_link_libraries(GStreamer::${component} INTERFACE PkgConfig::PC_GSTREAMER_${upper}) + endif() + else() + foreach(dependency IN LISTS ARGS_DEPENDENCIES) + if (NOT TARGET ${dependency}) + set(GStreamer_${component}_FOUND FALSE PARENT_SCOPE) + return() + endif() + endforeach() + + find_path(GStreamer_${component}_INCLUDE_DIR + NAMES ${header} + PATH_SUFFIXES gstreamer-1.0 + ) + find_library(GStreamer_${component}_LIBRARY + NAMES ${library} + ) + + if(${component} STREQUAL "Gl") + # search the gstglconfig.h include dir under the same root where the library is found + get_filename_component(gstglLibDir "${GStreamer_Gl_LIBRARY}" PATH) + find_path(GStreamer_GlConfig_INCLUDE_DIR + NAMES gst/gl/gstglconfig.h + PATH_SUFFIXES gstreamer-1.0/include + HINTS ${PC_GSTREAMER_GL_INCLUDE_DIRS} ${PC_GSTREAMER_GL_INCLUDEDIR} "${gstglLibDir}" + ) + if(GStreamer_GlConfig_INCLUDE_DIR) + list(APPEND GStreamer_Gl_INCLUDE_DIR "${GStreamer_GlConfig_INCLUDE_DIR}") + list(REMOVE_DUPLICATES GStreamer_Gl_INCLUDE_DIR) + endif() + endif() + if(GStreamer_${component}_LIBRARY AND GStreamer_${component}_INCLUDE_DIR) + + if (NOT TARGET DUMMY_GStreamer::${component}) + + string(REGEX MATCH "^([0-9]+)\\.([0-9]+)" GStreamerVersionMatch ${GStreamer_FIND_VERSION}) + set(VERSION_MAJOR ${CMAKE_MATCH_1}) + set(VERSION_MINOR ${CMAKE_MATCH_2}) + + # hack alert: we cannot obtain the installed gstreamer version without a try_compile. however we + # cannot try_compile without creating a target, as try_compile does not accept include paths. So we + # need to create a dummy target + + add_library(DUMMY_GStreamer::${component} INTERFACE IMPORTED) + target_include_directories(DUMMY_GStreamer::${component} INTERFACE ${GStreamer_${component}_INCLUDE_DIR}) + target_link_libraries(DUMMY_GStreamer::${component} INTERFACE ${GStreamer_${component}_LIBRARY}) + if(ARGS_DEPENDENCIES) + target_link_libraries(DUMMY_GStreamer::${component} INTERFACE ${ARGS_DEPENDENCIES}) + endif() + + qt_config_compile_test(gstreamer_version_check_${component} + LABEL "GStreamer Version test" + LIBRARIES + DUMMY_GStreamer::${component} + CODE + "#include + + static_assert(GST_CHECK_VERSION(${VERSION_MAJOR}, ${VERSION_MINOR}, 0), + \"Minimum required GStreamer version is ${VERSION_MAJOR}.${VERSION_MINOR}\"); + + int main() + { + return 0; + }") + + if (${TEST_gstreamer_version_check_${component}}) + add_library(GStreamer::${component} INTERFACE IMPORTED) + + target_include_directories(GStreamer::${component} INTERFACE ${GStreamer_${component}_INCLUDE_DIR}) + target_link_libraries(GStreamer::${component} INTERFACE ${GStreamer_${component}_LIBRARY}) + if(ARGS_DEPENDENCIES) + target_link_libraries(GStreamer::${component} INTERFACE ${ARGS_DEPENDENCIES}) + endif() + endif() + endif() + endif() + mark_as_advanced(GStreamer_${component}_INCLUDE_DIR GStreamer_${component}_LIBRARY) + endif() + endif() + + if(TARGET ${target}) + set(GStreamer_${component}_FOUND TRUE PARENT_SCOPE) + endif() +endfunction() + +# GStreamer required dependencies +find_gstreamer_component(Core + PC_NAME gstreamer-1.0 + HEADER gst/gst.h + LIBRARY gstreamer-1.0 + DEPENDENCIES GObject::GObject) +find_gstreamer_component(Base + PC_NAME gstreamer-base-1.0 + HEADER gst/gst.h + LIBRARY gstbase-1.0 + DEPENDENCIES GStreamer::Core) +find_gstreamer_component(Audio + PC_NAME gstreamer-audio-1.0 + HEADER gst/audio/audio.h + LIBRARY gstaudio-1.0 + DEPENDENCIES GStreamer::Base) +find_gstreamer_component(Video + PC_NAME gstreamer-video-1.0 + HEADER gst/video/video.h + LIBRARY gstvideo-1.0 + DEPENDENCIES GStreamer::Base) +find_gstreamer_component(Pbutils + PC_NAME gstreamer-pbutils-1.0 + HEADER gst/pbutils/pbutils.h + LIBRARY gstpbutils-1.0 + DEPENDENCIES GStreamer::Audio GStreamer::Video) +find_gstreamer_component(Allocators + PC_NAME gstreamer-allocators-1.0 + HEADER gst/allocators/allocators.h + LIBRARY gstallocators-1.0 + DEPENDENCIES GStreamer::Core) + +if(Play IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Play + PC_NAME gstreamer-play-1.0 + HEADER gst/gst.h + LIBRARY gstplay-1.0 + DEPENDENCIES GStreamer::Core GStreamer::Video) +endif() + +if(App IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(App + PC_NAME gstreamer-app-1.0 + HEADER gst/app/gstappsink.h + LIBRARY gstapp-1.0 + DEPENDENCIES GStreamer::Base) +endif() + +if(Photography IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Photography + PC_NAME gstreamer-photography-1.0 + HEADER gst/interfaces/photography.h + LIBRARY gstphotography-1.0 + DEPENDENCIES GStreamer::Core) +endif() + +if(Gl IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(Gl + PC_NAME gstreamer-gl-1.0 + HEADER gst/gl/gl.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Core) +endif() + +if(GlEgl IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlEgl + PC_NAME gstreamer-gl-egl-1.0 + HEADER gst/gl/egl/gstgldisplay_egl.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl EGL::EGL ) +endif() + +if(GlX11 IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlX11 + PC_NAME gstreamer-gl-x11-1.0 + HEADER gst/gl/x11/gstgldisplay_x11.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl XCB::XCB ) +endif() + +if(GlWayland IN_LIST GStreamer_FIND_COMPONENTS) + find_gstreamer_component(GlWayland + PC_NAME gstreamer-gl-wayland-1.0 + HEADER gst/gl/wayland/gstgldisplay_wayland.h + LIBRARY gstgl-1.0 + DEPENDENCIES GStreamer::Video GStreamer::Base GStreamer::Core GStreamer::Gl Wayland::Client ) +endif() + +# Create target GStreamer::GStreamer +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(GStreamer + REQUIRED_VARS + GStreamer_Core_FOUND + GStreamer_Base_FOUND + GStreamer_Audio_FOUND + GStreamer_Video_FOUND + GStreamer_Pbutils_FOUND + GStreamer_Allocators_FOUND + HANDLE_COMPONENTS +) + +if(GStreamer_FOUND AND NOT TARGET GStreamer::GStreamer) + add_library(GStreamer::GStreamer INTERFACE IMPORTED) + target_link_libraries(GStreamer::GStreamer INTERFACE + GStreamer::Core + GStreamer::Base + GStreamer::Audio + GStreamer::Video + GStreamer::Pbutils + GStreamer::Allocators + ) +endif() + +if(TARGET PkgConfig::PC_GSTREAMER_GL) + get_target_property(_qt_incs PkgConfig::PC_GSTREAMER_GL INTERFACE_INCLUDE_DIRECTORIES) + set(__qt_fixed_incs) + foreach(path IN LISTS _qt_incs) + if(IS_DIRECTORY "${path}") + list(APPEND __qt_fixed_incs "${path}") + endif() + endforeach() + set_property(TARGET PkgConfig::PC_GSTREAMER_GL PROPERTY INTERFACE_INCLUDE_DIRECTORIES "${__qt_fixed_incs}") +endif() diff --git a/cmake/FindMMRenderer.cmake b/cmake/FindMMRenderer.cmake new file mode 100644 index 0000000..43dcf3f --- /dev/null +++ b/cmake/FindMMRenderer.cmake @@ -0,0 +1,29 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindMMRenderer +# --------- +# +# Try to locate the mm-renderer library. +# If found, this will define the following variables: +# +# ``MMRenderer_FOUND`` +# True if the mm-renderer library is available +# ``MMRenderer_LIBRARY`` +# The mm-renderer library +# +# If ``MMRenderer_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``MMRenderer::MMRenderer`` +# The mm-renderer library to link to + +find_library(MMRenderer_LIBRARY NAMES mmrndclient) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(MMRenderer DEFAULT_MSG MMRenderer_LIBRARY) +if(MMRenderer_FOUND AND NOT TARGET MMRenderer::MMRenderer) + add_library(MMRenderer::MMRenderer INTERFACE IMPORTED) + target_link_libraries(MMRenderer::MMRenderer + INTERFACE "${MMRenderer_LIBRARY}") +endif() +mark_as_advanced(MMRenderer_LIBRARY) diff --git a/cmake/FindMMRendererCore.cmake b/cmake/FindMMRendererCore.cmake new file mode 100644 index 0000000..3f07e37 --- /dev/null +++ b/cmake/FindMMRendererCore.cmake @@ -0,0 +1,12 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +find_library(MMRendererCore_LIBRARY NAMES mmrndcore) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(MMRendererCore DEFAULT_MSG MMRendererCore_LIBRARY) +if(MMRendererCore_FOUND AND NOT TARGET MMRendererCore::MMRendererCore) + add_library(MMRendererCore::MMRendererCore INTERFACE IMPORTED) + target_link_libraries(MMRendererCore::MMRendererCore + INTERFACE "${MMRendererCore_LIBRARY}") +endif() +mark_as_advanced(MMRendererCore_LIBRARY) diff --git a/cmake/FindPipeWire.cmake b/cmake/FindPipeWire.cmake new file mode 100644 index 0000000..5812bac --- /dev/null +++ b/cmake/FindPipeWire.cmake @@ -0,0 +1,123 @@ +#.rst: +# FindPipeWire +# ------- +# +# Try to find PipeWire on a Unix system. +# +# This will define the following variables: +# +# ``PipeWire_FOUND`` +# True if (the requested version of) PipeWire is available +# ``PipeWire_VERSION`` +# The version of PipeWire +# ``PipeWire_LIBRARIES`` +# This can be passed to target_link_libraries() instead of the ``PipeWire::PipeWire`` +# target +# ``PipeWire_INCLUDE_DIRS`` +# This should be passed to target_include_directories() if the target is not +# used for linking +# ``PipeWire_DEFINITIONS`` +# This should be passed to target_compile_options() if the target is not +# used for linking +# +# If ``PipeWire_FOUND`` is TRUE, it will also define the following imported target: +# +# ``PipeWire::PipeWire`` +# The PipeWire library +# +# In general we recommend using the imported target, as it is easier to use. +# Bear in mind, however, that if the target is in the link interface of an +# exported library, it must be made available by the package config file. + +#============================================================================= +# Copyright 2014 Alex Merry +# Copyright 2014 Martin Gräßlin +# Copyright 2018-2020 Jan Grulich +# +# Redistribution and use in source and binary forms, with or without +# modification, are permitted provided that the following conditions +# are met: +# +# 1. Redistributions of source code must retain the copyright +# notice, this list of conditions and the following disclaimer. +# 2. Redistributions in binary form must reproduce the copyright +# notice, this list of conditions and the following disclaimer in the +# documentation and/or other materials provided with the distribution. +# 3. The name of the author may not be used to endorse or promote products +# derived from this software without specific prior written permission. +# +# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR +# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES +# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. +# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, +# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT +# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, +# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY +# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT +# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF +# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. +#============================================================================= + +# Use pkg-config to get the directories and then use these values +# in the FIND_PATH() and FIND_LIBRARY() calls +find_package(PkgConfig QUIET) + +if(PkgConfig_FOUND) + pkg_search_module(PKG_PipeWire QUIET libpipewire-0.3) + pkg_search_module(PKG_Spa QUIET libspa-0.2) +endif() + +set(PipeWire_DEFINITIONS "${PKG_PipeWire_CFLAGS}" "${PKG_Spa_CFLAGS}") +set(PipeWire_VERSION "${PKG_PipeWire_VERSION}") + +find_path(PipeWire_INCLUDE_DIRS + NAMES + pipewire/pipewire.h + HINTS + ${PKG_PipeWire_INCLUDE_DIRS} + ${PKG_PipeWire_INCLUDE_DIRS}/pipewire-0.3 +) + +find_path(Spa_INCLUDE_DIRS + NAMES + spa/param/props.h + HINTS + ${PKG_Spa_INCLUDE_DIRS} + ${PKG_Spa_INCLUDE_DIRS}/spa-0.2 +) + +find_library(PipeWire_LIBRARIES + NAMES + pipewire-0.3 + HINTS + ${PKG_PipeWire_LIBRARY_DIRS} +) + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(PipeWire + FOUND_VAR + PipeWire_FOUND + REQUIRED_VARS + PipeWire_LIBRARIES + PipeWire_INCLUDE_DIRS + Spa_INCLUDE_DIRS + VERSION_VAR + PipeWire_VERSION +) + +if(PipeWire_FOUND AND NOT TARGET PipeWire::PipeWire) + add_library(PipeWire::PipeWire UNKNOWN IMPORTED) + set_target_properties(PipeWire::PipeWire PROPERTIES + IMPORTED_LOCATION "${PipeWire_LIBRARIES}" + INTERFACE_COMPILE_OPTIONS "${PipeWire_DEFINITIONS}" + INTERFACE_INCLUDE_DIRECTORIES "${PipeWire_INCLUDE_DIRS};${Spa_INCLUDE_DIRS}" + ) +endif() + +mark_as_advanced(PipeWire_LIBRARIES PipeWire_INCLUDE_DIRS) + +include(FeatureSummary) +set_package_properties(PipeWire PROPERTIES + URL "https://www.pipewire.org" + DESCRIPTION "PipeWire - multimedia processing" +) diff --git a/cmake/FindVAAPI.cmake b/cmake/FindVAAPI.cmake new file mode 100644 index 0000000..b1170dc --- /dev/null +++ b/cmake/FindVAAPI.cmake @@ -0,0 +1,92 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + + +find_package(PkgConfig QUIET) + +function(qt_internal_multimedia_set_va_outputs component include_dir lib_path) + if ("${component}" STREQUAL "VA") + set(VAAPI_INCLUDE_DIR "${include_dir}" CACHE INTERNAL "") + get_filename_component(lib_realpath "${lib_path}" REALPATH) + + string(REGEX MATCH "[0-9]+(\\.[0-9]+)*$" VAAPI_SUFFIX "${lib_realpath}") + set(VAAPI_SUFFIX "${VAAPI_SUFFIX}" CACHE INTERNAL "") + + mark_as_advanced(VAAPI_SUFFIX VAAPI_INCLUDE_DIR) + endif() +endfunction() + +function(find_component component prefix header library) + if(NOT TARGET VAAPI::${component}) + string(TOUPPER ${component} upper) + pkg_search_module(PC_VAAPI_${upper} ${prefix} IMPORTED_TARGET) + if(TARGET PkgConfig::PC_VAAPI_${upper}) + add_library(VAAPI::${component} INTERFACE IMPORTED) + target_link_libraries(VAAPI::${component} INTERFACE PkgConfig::PC_VAAPI_${upper}) + + if (NOT PC_VAAPI_${upper}_LINK_LIBRARIES) + get_target_property(PC_VAAPI_${upper}_LINK_LIBRARIES PkgConfig::PC_VAAPI_${upper} INTERFACE_LINK_LIBRARIES) + message(STATUS "PC_VAAPI_${upper}_LINK_LIBRARIES is not defined by PkgConfig; " + "Get the value from target properties: ${PC_VAAPI_${upper}_LINK_LIBRARIES}") + endif() + + foreach (lib_path ${PC_VAAPI_${upper}_LINK_LIBRARIES}) + get_filename_component(lib_name "${lib_path}" NAME_WLE) + if (${lib_name} STREQUAL ${prefix}) + qt_internal_multimedia_set_va_outputs(${component} + "${PC_VAAPI_${upper}_INCLUDEDIR}" "${lib_path}") + break() + endif() + endforeach() + else() + find_path(VAAPI_${component}_INCLUDE_DIR + NAMES ${header} + PATH_SUFFIXES VAAPI-1.0 + ) + find_library(VAAPI_${component}_LIBRARY + NAMES ${library} + ) + if(VAAPI_${component}_LIBRARY AND VAAPI_${component}_INCLUDE_DIR) + add_library(VAAPI::${component} INTERFACE IMPORTED) + target_include_directories(VAAPI::${component} INTERFACE ${VAAPI_${component}_INCLUDE_DIR}) + target_link_libraries(VAAPI::${component} INTERFACE ${VAAPI_${component}_LIBRARY}) + endif() + mark_as_advanced(VAAPI_${component}_INCLUDE_DIR VAAPI_${component}_LIBRARY) + + qt_internal_multimedia_set_va_outputs(${component} + "${VAAPI_${component}_INCLUDE_DIR}" "${VAAPI_${component}_LIBRARY}") + endif() + endif() + + if(TARGET VAAPI::${component}) + set(VAAPI_${component}_FOUND TRUE PARENT_SCOPE) + endif() +endfunction() + +find_component(VA libva va/va.h libva) +find_component(DRM libva-drm va/va-drm.h libva-drm) + +if(TARGET VAAPI::VA) + target_link_libraries(VAAPI::VA) +endif() +if(TARGET VAAPI::VA AND TARGET VAAPI::DRM) + target_link_libraries(VAAPI::DRM INTERFACE VAAPI::VA) +endif() + +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(VAAPI + REQUIRED_VARS + VAAPI_VA_FOUND + VAAPI_DRM_FOUND + VAAPI_INCLUDE_DIR + VAAPI_SUFFIX + HANDLE_COMPONENTS +) + +if(VAAPI_FOUND AND NOT TARGET VAAPI::VAAPI) + add_library(VAAPI::VAAPI INTERFACE IMPORTED) + target_link_libraries(VAAPI::VAAPI INTERFACE + VAAPI::VA + VAAPI::DRM + ) +endif() diff --git a/cmake/FindWMF.cmake b/cmake/FindWMF.cmake new file mode 100644 index 0000000..79306a3 --- /dev/null +++ b/cmake/FindWMF.cmake @@ -0,0 +1,52 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindWMF +# --------- +# +# Try to locate the Windows Media Foundation library. +# If found, this will define the following variables: +# +# ``WMF_FOUND`` +# True if Windows Media Foundation is available +# ``WMF_LIBRARIES`` +# The Windows Media Foundation set of libraries +# +# If ``WMF_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``WMF::WMF`` +# The Windows Media Foundation library to link to + +find_library(WMF_STRMIIDS_LIBRARY strmiids HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_AMSTRMID_LIBRARY amstrmid HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_DMOGUIDS_LIBRARY dmoguids HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_UUID_LIBRARY uuid HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_MSDMO_LIBRARY msdmo HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_OLE32_LIBRARY ole32 HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_OLEAUT32_LIBRARY oleaut32 HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_MF_LIBRARY mf HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_MFUUID_LIBRARY mfuuid HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_MFPLAT_LIBRARY mfplat HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_MFCORE_LIBRARY mfcore HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) +find_library(WMF_PROPSYS_LIBRARY propsys HINTS ${CMAKE_C_IMPLICIT_LINK_DIRECTORIES}) + + +set(WMF_LIBRARIES ${WMF_STRMIIDS_LIBRARY} ${WMF_AMSTRMID_LIBRARY} ${WMF_DMOGUIDS_LIBRARY} ${WMF_UUID_LIBRARY} + ${WMF_MSDMO_LIBRARY} ${WMF_OLE32_LIBRARY} ${WMF_OLEAUT32_LIBRARY} ${WMF_MF_LIBRARY} + ${WMF_MFUUID_LIBRARY} ${WMF_MFPLAT_LIBRARY} ${WMF_MFCORE_LIBRARY} ${WMF_PROPSYS_LIBRARY}) +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(WMF REQUIRED_VARS + WMF_STRMIIDS_LIBRARY WMF_AMSTRMID_LIBRARY WMF_DMOGUIDS_LIBRARY WMF_UUID_LIBRARY + WMF_MSDMO_LIBRARY WMF_OLE32_LIBRARY WMF_OLEAUT32_LIBRARY WMF_MF_LIBRARY + WMF_MFUUID_LIBRARY WMF_MFPLAT_LIBRARY WMF_MFCORE_LIBRARY WMF_PROPSYS_LIBRARY) + +if(WMF_FOUND AND NOT TARGET WMF::WMF) + add_library(WMF::WMF INTERFACE IMPORTED) + set_target_properties(WMF::WMF PROPERTIES + INTERFACE_LINK_LIBRARIES "${WMF_LIBRARIES}") +endif() + +mark_as_advanced(WMF_LIBRARIES WMF_STRMIIDS_LIBRARY WMF_AMSTRMID_LIBRARY WMF_DMOGUIDS_LIBRARY WMF_UUID_LIBRARY + WMF_MSDMO_LIBRARY WMF_OLE32_LIBRARY WMF_OLEAUT32_LIBRARY WMF_MF_LIBRARY WMF_MFUUID_LIBRARY WMF_MFPLAT_LIBRARY + WMF_MFCORE_LIBRARY WMF_PROPSYS_LIBRARY) diff --git a/cmake/FindWrapPulseAudio.cmake b/cmake/FindWrapPulseAudio.cmake new file mode 100644 index 0000000..ce170da --- /dev/null +++ b/cmake/FindWrapPulseAudio.cmake @@ -0,0 +1,37 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# FindWrapPulseAudio +# --------- +# +# Try to locate the pulseaudio library. +# If found, this will define the following variables: +# +# ``WrapPulseAudio_FOUND`` +# True if the pulseaudio library is available +# +# If ``WrapPulseAduio_FOUND`` is TRUE, it will also define the following +# imported target: +# +# ``WrapPulseAudio::WrapPulseAudio`` +# The pulseaudio library to link to + +if(TARGET WrapPulseAudio::WrapPulseAudio) + set(WrapPulseAudio_FOUND ON) + return() +endif() +find_package(PulseAudio QUIET) +if(PulseAudio_FOUND) + set(WrapPulseAudio_FOUND 1) +endif() +if(WrapPulseAudio_FOUND AND NOT TARGET WrapPulseAudio::WrapPulseAudio) + add_library(WrapPulseAudio::WrapPulseAudio INTERFACE IMPORTED) + target_include_directories(WrapPulseAudio::WrapPulseAudio INTERFACE "${PULSEAUDIO_INCLUDE_DIR}") + target_link_libraries(WrapPulseAudio::WrapPulseAudio + INTERFACE "${PULSEAUDIO_LIBRARY}") +endif() +include(FindPackageHandleStandardArgs) +find_package_handle_standard_args(WrapPulseAudio REQUIRED_VARS + PULSEAUDIO_LIBRARY PULSEAUDIO_INCLUDE_DIR WrapPulseAudio_FOUND) + +mark_as_advanced(PULSEAUDIO_LIBRARY PULSEAUDIO_INCLUDE_DIR) diff --git a/cmake/REUSE.toml b/cmake/REUSE.toml new file mode 100644 index 0000000..6fcb066 --- /dev/null +++ b/cmake/REUSE.toml @@ -0,0 +1,7 @@ +version = 1 + +[[annotations]] +path = ["FindPipeWire.cmake"] +precedence = "aggregate" +comment = "build system. The copyright is provided in file." +SPDX-License-Identifier = "BSD-3-Clause" diff --git a/coin/axivion/ci_config_linux.json b/coin/axivion/ci_config_linux.json new file mode 100644 index 0000000..1741f34 --- /dev/null +++ b/coin/axivion/ci_config_linux.json @@ -0,0 +1,45 @@ +{ + "Project": { + "BuildSystemIntegration": { + "child_order": [ + "GCCSetup", + "CMake", + "LinkLibraries" + ] + }, + "CMake": { + "_active": true, + "_copy_from": "CMakeIntegration", + "build_environment": {}, + "build_options": "-j4", + "generate_options": "--fresh", + "generator": "Ninja" + }, + "GCCSetup": { + "_active": true, + "_copy_from": "Command", + "build_command": "gccsetup --cc gcc --cxx g++ --config ../../../axivion/" + }, + "LinkLibraries": { + "_active": true, + "_copy_from": "AxivionLinker", + "input_files": [ + "build/lib/lib*.so*.ir", + "build/qml/*/lib*.so*.ir", + "build/qml/*/*/lib*.so*.ir" + ], + "ir": "build/$(env:TESTED_MODULE_COIN).ir", + "plugin_files": [ + "build/plugins/*/lib*.so*.ir" + ] + } + }, + "_Format": "1.0", + "_Version": "7.6.2", + "_VersionNum": [ + 7, + 6, + 2, + 12725 + ] +} diff --git a/coin/instructions/run_ffmpeg_backend_tests.yaml b/coin/instructions/run_ffmpeg_backend_tests.yaml new file mode 100644 index 0000000..1a25876 --- /dev/null +++ b/coin/instructions/run_ffmpeg_backend_tests.yaml @@ -0,0 +1,33 @@ +type: Group +enable_if: + condition: or + conditions: + - condition: runtime + env_var: TARGET_OS_COIN + equals_value: macos + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: ios_any + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: ubuntu + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: rhel + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: opensuse + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: android_any + - condition: runtime + env_var: TARGET_OSVERSION_COIN + contains_value: windows + - condition: runtime + env_var: NON_QTBASE_CMAKE_ARGS + contains_value: "-DFFMPEG_DIR=/" +instructions: + - type: EnvironmentVariable + variableName: QT_MEDIA_BACKEND + variableValue: ffmpeg + - !include "{{qt/qtbase}}/coin_module_test_template_v3.yaml" diff --git a/coin/instructions/run_gstreamer_backend_tests.yaml b/coin/instructions/run_gstreamer_backend_tests.yaml new file mode 100644 index 0000000..62e9a74 --- /dev/null +++ b/coin/instructions/run_gstreamer_backend_tests.yaml @@ -0,0 +1,27 @@ +type: Group +enable_if: + condition: or + conditions: + - condition: runtime + env_var: TARGET_OSVERSION_COIN + # QTBUG-129469 as long as we have flaky tests, we need to disable all gstreamer tests on CI to avoid blocking + # dependency update rounds + contains_value: disabled_ubuntu + # Disabling on rhel/opensuse for now due to missing h264 codecs on CI + # - condition: runtime + # env_var: TARGET_OSVERSION_COIN + # contains_value: rhel + # - condition: runtime + # env_var: TARGET_OSVERSION_COIN + # contains_value: opensuse + +instructions: + - type: EnvironmentVariable + variableName: QT_MEDIA_BACKEND + variableValue: gstreamer + + # QTBUG-127927 + # - type: EnvironmentVariable + # variableName: G_DEBUG + # variableValue: fatal_criticals + - !include "{{qt/qtbase}}/coin_module_test_template_v3.yaml" diff --git a/coin/module_config.yaml b/coin/module_config.yaml new file mode 100644 index 0000000..3b34329 --- /dev/null +++ b/coin/module_config.yaml @@ -0,0 +1,14 @@ +version: 2 +accept_configuration: + condition: property + property: features + not_contains_value: Disable + +instructions: + Build: + - !include "{{qt/qtbase}}/coin_module_build_template_v2.yaml" + + Test: + - !include "{{qt/qtmultimedia}}/run_ffmpeg_backend_tests.yaml" + - !include "{{qt/qtmultimedia}}/run_gstreamer_backend_tests.yaml" + - !include "{{qt/qtbase}}/coin_module_test_docs.yaml" diff --git a/config.tests/evr/CMakeLists.txt b/config.tests/evr/CMakeLists.txt new file mode 100644 index 0000000..20f4d2c --- /dev/null +++ b/config.tests/evr/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from evr.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_evr LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/evr/main.cpp b/config.tests/evr/main.cpp new file mode 100644 index 0000000..eb72c59 --- /dev/null +++ b/config.tests/evr/main.cpp @@ -0,0 +1,9 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: BSD-3-Clause + +#include + +int main(int, char**) +{ + return 0; +} diff --git a/config.tests/gpu_vivante/CMakeLists.txt b/config.tests/gpu_vivante/CMakeLists.txt new file mode 100644 index 0000000..84f5be9 --- /dev/null +++ b/config.tests/gpu_vivante/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from gpu_vivante.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_gpu_vivante LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/gpu_vivante/main.cpp b/config.tests/gpu_vivante/main.cpp new file mode 100644 index 0000000..4786cf5 --- /dev/null +++ b/config.tests/gpu_vivante/main.cpp @@ -0,0 +1,12 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: BSD-3-Clause + +#include +#include + +const int format = GL_VIV_YV12; + +int main(int argc, char** argv) +{ + return 0; +} diff --git a/config.tests/linux_v4l/CMakeLists.txt b/config.tests/linux_v4l/CMakeLists.txt new file mode 100644 index 0000000..1ebaf3c --- /dev/null +++ b/config.tests/linux_v4l/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from linux_v4l.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_linux_v4l LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/linux_v4l/main.cpp b/config.tests/linux_v4l/main.cpp new file mode 100644 index 0000000..0c468d5 --- /dev/null +++ b/config.tests/linux_v4l/main.cpp @@ -0,0 +1,9 @@ +// Copyright (C) 2016 The Qt Company Ltd and/or its subsidiary(-ies). +// SPDX-License-Identifier: BSD-3-Clause + +#include + +int main(int argc, char** argv) +{ + return 0; +} diff --git a/config.tests/wmsdk/CMakeLists.txt b/config.tests/wmsdk/CMakeLists.txt new file mode 100644 index 0000000..7f957ad --- /dev/null +++ b/config.tests/wmsdk/CMakeLists.txt @@ -0,0 +1,33 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +# Generated from wmsdk.pro. + +cmake_minimum_required(VERSION 3.16) +project(config_test_wmsdk LANGUAGES C CXX) + +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH) + set(CMAKE_SYSTEM_PREFIX_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_PREFIX_PATH}") +endif() +if(DEFINED QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH) + set(CMAKE_SYSTEM_FRAMEWORK_PATH "${QT_CONFIG_COMPILE_TEST_CMAKE_SYSTEM_FRAMEWORK_PATH}") +endif() + +foreach(p ${QT_CONFIG_COMPILE_TEST_PACKAGES}) + find_package(${p}) +endforeach() + +if(QT_CONFIG_COMPILE_TEST_LIBRARIES) + link_libraries(${QT_CONFIG_COMPILE_TEST_LIBRARIES}) +endif() +if(QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS) + foreach(lib ${QT_CONFIG_COMPILE_TEST_LIBRARY_TARGETS}) + if(TARGET ${lib}) + link_libraries(${lib}) + endif() + endforeach() +endif() + +add_executable(${PROJECT_NAME} + main.cpp +) diff --git a/config.tests/wmsdk/main.cpp b/config.tests/wmsdk/main.cpp new file mode 100644 index 0000000..24300ee --- /dev/null +++ b/config.tests/wmsdk/main.cpp @@ -0,0 +1,9 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: BSD-3-Clause + +#include + +int main(int, char**) +{ + return 0; +} diff --git a/config_help.txt b/config_help.txt new file mode 100644 index 0000000..f9d357a --- /dev/null +++ b/config_help.txt @@ -0,0 +1,8 @@ +Multimedia options: + + -pulseaudio .......... Enable PulseAudio support [auto] (Unix only) + -alsa ................ Enable ALSA support [auto] (Unix only) + -no-gstreamer ........ Disable support for GStreamer + -gstreamer [version] . Enable GStreamer support [auto] + With no parameter, 1.0 is tried first, then 0.10. + -evr ................. Enables EVR in WMF [auto] diff --git a/configure.cmake b/configure.cmake new file mode 100644 index 0000000..68f54ce --- /dev/null +++ b/configure.cmake @@ -0,0 +1,24 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + + + +#### Inputs + + + +#### Libraries + + + +#### Tests + + + +#### Features + + +qt_extra_definition("QT_VERSION_STR" "\"${PROJECT_VERSION}\"" PUBLIC) +qt_extra_definition("QT_VERSION_MAJOR" ${PROJECT_VERSION_MAJOR} PUBLIC) +qt_extra_definition("QT_VERSION_MINOR" ${PROJECT_VERSION_MINOR} PUBLIC) +qt_extra_definition("QT_VERSION_PATCH" ${PROJECT_VERSION_PATCH} PUBLIC) diff --git a/dependencies.yaml b/dependencies.yaml new file mode 100644 index 0000000..2c24850 --- /dev/null +++ b/dependencies.yaml @@ -0,0 +1,13 @@ +dependencies: + ../qtbase: + ref: f1136de66638060b8a1ab9bc0cdf1a91dcb5ec01 + required: true + ../qtdeclarative: + ref: 75534f3e7fff24ed7ccb364e2ed9950a73da879f + required: false + ../qtquick3d: + ref: 54c6b395d954b05c36863433a76ac861e8820479 + required: false + ../qtshadertools: + ref: 9b81996cea92b13d9f896504516d920976a77a86 + required: true diff --git a/dist/REUSE.toml b/dist/REUSE.toml new file mode 100644 index 0000000..f14104b --- /dev/null +++ b/dist/REUSE.toml @@ -0,0 +1,8 @@ +version = 1 + +[[annotations]] +path = ["*"] +precedence = "override" +comment = "Licensed as documentation." +SPDX-FileCopyrightText = "Copyright (C) 2024 The Qt Company Ltd." +SPDX-License-Identifier = "LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only" diff --git a/dist/changes-5.0.1 b/dist/changes-5.0.1 new file mode 100644 index 0000000..84935ad --- /dev/null +++ b/dist/changes-5.0.1 @@ -0,0 +1,76 @@ +Qt 5.0.1 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.0.0. + +However, to fix a bug we detected after the 5.0 release, this release +has a limited binary compatibility break. We therefore recommend all +users to recompile their applications that provided QtMultimedia +plugins or dealt with them directly. This is an exceptional case: +compatibility will be kept for further releases. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.0/ + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + +**************************************************************************** +* General * +**************************************************************************** + +General Improvements +-------------------- + + * Documentation: Various documentation fixes such as spelling and + snippet corrections. + + * Fixed an issue that could cause memory leak when certain objects + were destroyed. The fix for this issue required a binary + compatibility break in two classes: QAudioSystemFactoryInterface + and QMediaServiceProviderFactoryInterface. Those two classes are + used only in QtMultimedia plugins and code directly dealing with + them and recompilation is only strictly necessary for them. + +Third party components +---------------------- + +**************************************************************************** +* Library * +**************************************************************************** + + - WMF: added more metadata keys (on Windows 7 and later). + - Compile in 32-bit mode. + - remove leftover code from multimediawidgets carve-out + - WMF: release video controls before releasing the session + - WMF: Fixed uninitialized member variable. + - WMF: re-enabled video probes and made it more robust. + - [QTBUG-28376] Make QtMultimedia an identified module + - [QTBUG-28727] Doc: Moved the qdocinc and image to the sourcedirs + - Remove comma at the end of the enum + - fix include statements + - Use qrc to deploy qml files in declarative-camera examples + - [QTBUG-26621] WMF: Fixed incorrect QMediaPlayer volume reporting. + - Polish and fix qmlvideofx example + - Add qmake generated files to .gitignore. + - Example: Notify user of errors + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + +**************************************************************************** +* Compiler Specific Changes * +**************************************************************************** + + +**************************************************************************** +* Plugins * +**************************************************************************** diff --git a/dist/changes-5.0.2 b/dist/changes-5.0.2 new file mode 100644 index 0000000..53d93e6 --- /dev/null +++ b/dist/changes-5.0.2 @@ -0,0 +1,48 @@ +Qt 5.0.2 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.0.0 and 5.0.1. + +However, to fix a bug we detected after the 5.0 release, this release +has a limited binary compatibility break. We therefore recommend all +users to recompile their applications that provided QtMultimedia +plugins or dealt with them directly. This is an exceptional case: +compatibility will be kept for further releases. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.0/ + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + + +**************************************************************************** +* General * +**************************************************************************** + +General Improvements +-------------------- + +**************************************************************************** +* Library * +**************************************************************************** + + - WMF: Enabled HW-accelerated video decoding for the QML video item. + - WMF: Fixed unresolved topologies when using the custom MediaSink. + - Disable FFT when building in static mode. + - [QTBUG-28741] Added seek() function to QML Video item. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Qt for BlackBerry +----------------- + + - Fixed playback of streamed audio. + diff --git a/dist/changes-5.1.0 b/dist/changes-5.1.0 new file mode 100644 index 0000000..937d6fa --- /dev/null +++ b/dist/changes-5.1.0 @@ -0,0 +1,38 @@ +Qt 5.1 introduces many new features and improvements as well as bugfixes +over the 5.0.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.1 + +The Qt version 5.1 series is binary compatible with the 5.0.x series. +Applications compiled for 5.0 will continue to run with 5.1. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* General * +**************************************************************************** + + - Fixed signal not being emitted in QDeclarativeCameraFocus. + - Decouple qmediametadata.h from qmultimedia.h + - Reset VideoSurface pointer when deleted + - Fix crash on idle status change with 64 bit architectures. + - Add support for m3u8 playlist formats + - Fix calculation bug in QWaveDecoder. + + - [QTBUG-28047] Make directshow-plugin available. + - [QTBUG-28589] Add error handling in image capturing in camera + - [QTBUG-30411] AVFoundation: Emit error when media fails to load + +Qt for Android +-------------- + + - Add libQt5MultimediaQuick_p to the list of dependencies. + - Fixed crash when resetting the video surface. + - Add MediaPlayer support for Android diff --git a/dist/changes-5.1.1 b/dist/changes-5.1.1 new file mode 100644 index 0000000..45fc4de --- /dev/null +++ b/dist/changes-5.1.1 @@ -0,0 +1,45 @@ +Qt 5.1.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.1.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.1/ + +The Qt version 5.1 series is binary compatible with the 5.0.x series. +Applications compiled for 5.0 will continue to run with 5.1. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Qt for Windows +-------------- + + - Use correct default audio output and input devices on Windows. + - [QTBUG-29206] DirectShow: avoid unnecessary RGB32 -> BGR32 conversion. + - [QTBUG-32282] DirectShow: Don't create the widget and renderer controls + until requested. + - [QTBUG-23822] Fix resource leak in directshow plugin. + - WMF: fixed MediaPlayer buffering logic. + +Qt for Android +-------------- + + - Fixed potential memory leak when destroying a media player. + - Fixed media player showing black frames on some hardware. + - [QTBUG-31422] Make it possible for the media player to play assets. + - Fixed Java exception being thrown at app startup when using multimedia. + +Qt for BlackBerry +----------------- + + - [QTBUG-31534] Fix frame size of video playback. diff --git a/dist/changes-5.10.0 b/dist/changes-5.10.0 new file mode 100644 index 0000000..cbdb75b --- /dev/null +++ b/dist/changes-5.10.0 @@ -0,0 +1,41 @@ +Qt 5.10 introduces many new features and improvements as well as bugfixes +over the 5.9.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.10 series is binary compatible with the 5.9.x series. +Applications compiled for 5.9 will continue to run with 5.10. + +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. + +**************************************************************************** +* Qt 5.10.0 Changes * +**************************************************************************** + + - [QTBUG-57045] Fixed crash when calling pause in the onPositionChanged + handler. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +QNX +--- + - Added support for setting audio roles. + +Linux +----- + - [QTBUG-62621] Unsupported audio formats in PulseAudio will now be rejected + instead of being played incorrectly. + - [QTBUG-63427] QSoundEffect with PulseAudio now supports 24 bit samples. + +Windows +------- + - Added support for QMediaMetaData::Orientation. diff --git a/dist/changes-5.10.1 b/dist/changes-5.10.1 new file mode 100644 index 0000000..e76dd20 --- /dev/null +++ b/dist/changes-5.10.1 @@ -0,0 +1,72 @@ +Qt 5.10.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.10.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.10 series is binary compatible with the 5.9.x series. +Applications compiled for 5.9 will continue to run with 5.10. + +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. + +This release contains all fixes included in the Qt 5.9.4 release. + +**************************************************************************** +* Qt 5.10.1 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-62155] Improved the quality when rendering YUVY and UYVY video frames. +- [QTBUG-43098] The alpha channel for ARGB32 video frames are now retained. +- [QTBUG-57197] Fixed media players state reporting when called in a slot. +- [QTBUG-53099] Fixed sizing issue when rendering to widgets backed by + a QOffscreenSurface. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +macOS +----- + +- [QTBUG-49558] Fixed duration updates for HTTP streams. + +PulseAudio +---------- + +- [QTBUG-65220] Fixed deadlock in QSoundEffect when using PulseAudio + +DirectShow +---------- + +- [QTBUG-59320] Made it possible to call DirectShow with only QCoreApplication. +- [QTBUG-51405] Fixed rendering of overlapping MDI subwindows. +- [QTBUG-64438] Fixed rendering of videos with pixel aspect ration other then 1:1. + +WinRT +----- + +- [QTBUG-60904] Enabled the AudioCapture backend on WinRT. + +GStreamer +--------- + +- [QTBUG-64080] Fixed camera selection logic to handle devices being + loaded and unloaded. +- [QTBUG-64155] Fixed error handling when no input device is provided. + +ALSA +---- + +- [QTBUG-63007] Improved the latency in QSoundEffect, by not querying the available + devices each time a new track got played. diff --git a/dist/changes-5.11.0 b/dist/changes-5.11.0 new file mode 100644 index 0000000..802eec7 --- /dev/null +++ b/dist/changes-5.11.0 @@ -0,0 +1,75 @@ +Qt 5.11 introduces many new features and improvements as well as bugfixes +over the 5.10.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +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. + +**************************************************************************** +* Qt 5.11.0 Changes * +**************************************************************************** + +QtMultimedia +------------ + + - Added customAudioRole string property to enable use of audio roles + beyond those available via the audioRole enum property. + - [QTBUG-45336] Added supportedFocusModes and supportedFocusPointModes + to QML CameraFocus. + - [QTBUG-45336] Added property supportedExposureModes to CameraExposure. + - [QTBUG-47606] Added mirrored API to QVideoSurfaceFormat. + - [QTBUG-45336] Added missing capability properties to CameraImageProcessing. + - [QTBUG-65207] Fixed setting QAudioEncoderSettings::bitRate. + - [QTBUG-30728] Made it possible to receive mouse move events in QVideoWidget. + - [QTBUG-60579] Added support for changing the volume on 24-bit audio samples. + - [QTBUG-53594] Fixed target rectangle coordinates while painting image + with QPainter. + - [QTBUG-51825] Fixed error reporting when QCamera::start() fails. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +PulseAudio +---------- + + - [QTBUG-49569] Emitted QAudio::StoppedState on QAudio::OpenError. + +Gstreamer +--------- + + - Fixed udpsrc timeout setting. + - [QTBUG-23761] Fixed setting vaapi sink properties. + - [QTBUG-64142] Fixed leak in prepare-window-handle message. + +DirectShow +---------- + + - Added support for manual camera exposure control. + - Added support for setting the capture destination and format. + - Added support for video probes in the camera. + - Added camera zoom support. + - [QTBUG-55354] Setting an unsupported playback rate will now fallback to the previous set rate. + - [QTBUG-65780] Fixed blank QVideoWidget when it is paused. + - Improved matching, filter and connecting pins. + +QNX +--- + + - Added support for QNX 7.0.0 audio management. + - Implemented QCustomAudioRoleControl for QNX. + +AVFoundation +------------ + + - Added support for the buffer status. diff --git a/dist/changes-5.11.1 b/dist/changes-5.11.1 new file mode 100644 index 0000000..11421db --- /dev/null +++ b/dist/changes-5.11.1 @@ -0,0 +1,73 @@ +Qt 5.11.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +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. + +**************************************************************************** +* Qt 5.11.1 Changes * +**************************************************************************** + +QtMultimedia +------------ + + - Made it possible for QSound to play source files using the qrc schema. + - [QTBUG-54680] Added a fix to show content + when the renderer beackend got recreated. + - [QTBUG-54262] QAudioOutput is now properly released when a new source is set. + - [QTBUG-66754] Fixed possible double release of QSoundEffect's network + access manager. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +WinRT +----- + + - [QTBUG-67614] Prevented deadlock when playing mp3 with QMediaPlayer. + - [QTBUG-67417] Fixed white screen for camera output. + - [QTBUG-63016] Avoided a crash when QImage is being destroyed within capturing. + - [QTBUG-63014] Fixed rotation of camera image. + - [QTBUG-68054] Fixed to keep camera as uninitialized when an error. + - [QTBUG-68054] Fixed a crash when using IMFMediaSink from IMFStreamSink. + +WasAPI +------ + + - [QTBUG-67353] The WasAPI backend will now always use the multithreaded + concurrency model. + +Gstreamer +--------- + + - [QTBUG-67920] Postponeed fetching supported viewfinder camerabin settings. + - [QTBUG-67706] Added better error and warning reporting in QGstreamerRecorderControl. + +WindowsAudio +------------ + + - [QTBUG-61920] Fixed adjusting volume for the default device. + +DirectShow +---------- + + - [QTBUG-64931] Fixed crackling sound when playing with a custom sample rate. + +QNX +--- + + - Switched WindowGrabber to a private parent window. diff --git a/dist/changes-5.11.2 b/dist/changes-5.11.2 new file mode 100644 index 0000000..a3bc3b2 --- /dev/null +++ b/dist/changes-5.11.2 @@ -0,0 +1,61 @@ +Qt 5.11.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0 through 5.11.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +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. + +**************************************************************************** +* Qt 5.11.2 Changes * +**************************************************************************** + + - [QTBUG-66910] Fixed warning on deleteLater on nullptr in QSampleCache. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-60884] Setting a custom video source through QT_GSTREAMER_CAMERABIN_VIDEOSRC + will now use gst_parse_launch(). + - [QTBUG-69468] gst_bus_remove_watch() will now be used if available. + - [QTBUG-69895] The video profile is now correctly set before CamerBin enters GST_STATE_READY. + - Fixed crash when resolution or frame rates are requested on an unloaded camera. + +Directshow +---------- + + - Removed reporting of failure for stream source with no video output. + - [QTBUG-69143] Postponed setting camera image processing param if not ready. + - [QTBUG-68035] Added a notification if camera has been unplugged. + +WinRT +----- + + - [QTBUG-67417] Obtained new camera sample format and size on camera change. + +AVFoundation +------------ + + - [QTBUG-65740] Fixed crash when no video capture device. + - [QTBUG-69076] Fixed linker error when building Qt without opengl support. + - Improved how context sharing is set-up in frame renderer. + +Android +------- + + - [QTBUG-68998] Fixed the player state when play() is called with no media. diff --git a/dist/changes-5.11.3 b/dist/changes-5.11.3 new file mode 100644 index 0000000..39f8d60 --- /dev/null +++ b/dist/changes-5.11.3 @@ -0,0 +1,58 @@ +Qt 5.11.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.11.0 through 5.11.2. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.11 series is binary compatible with the 5.10.x series. +Applications compiled for 5.10 will continue to run with 5.11. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.11.3 Changes * +**************************************************************************** + + - [QTBUG-51064] Added OpenGL core profile support to QtMultimediaQuickTools. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-50539] Fixed setting http/rtsp url on the media player. + - [QTBUG-70653] Fixed crash when play() is called prior to a state being set. + +DirectShow +---------- + + - [QTBUG-70932] Fixed crash when the camera got destroyed.. + - [QTBUG-70672] Fixed crash when no resources could be created. + +QNX +--- + + - Retrieved some information from the track metadata if available. + - Fixed video window parenting and positioning. + +PulseAudio +---------- + + - [QTBUG-69734] Fixed crash when stop() is called while reading buffers. + +Gstreamer +--------- + + - [QTBUG-63517] Fixed tst_QMediaPlayerBackend to make it pass. diff --git a/dist/changes-5.12.0 b/dist/changes-5.12.0 new file mode 100644 index 0000000..e775f19 --- /dev/null +++ b/dist/changes-5.12.0 @@ -0,0 +1,59 @@ +Qt 5.12 introduces many new features and improvements as well as bugfixes +over the 5.11.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-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.0 Changes * +**************************************************************************** + + - [QTBUG-52114] Interpreted ARGB32 as premultiplied for GraphicsVideoItem. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-39327] Added an ability to pass custom pipeline and video sink. + Also registered "qtvideosink" gstreamer element to be used in pipelines. + - [QTBUG-69402] Emitted stateChanged(StoppedState) when recording is finished. + +WindowsAudio +------------ + + - [QTBUG-63492] Fixed crackling at the end of playback. + - [QTBUG-45174] Introduced QT_WAVE_BUFFERS env var to define numbers of buffers. + +DirectShow +---------- + + - [QTBUG-32743] Implemented image capture settings. + - [QTBUG-53019] Added option to allow building without evr support. + The environment variable QT_DIRECTHSOW_NO_EVR can now be used to disable EVR at runtime. + +Android +------- + + - [QTBUG-61115] Implemented QMediaPlayer::setPlaybackRate(). + +IMX +--- + + - [QTBUG-50927] Copied data and uploaded back if mapping has not succeeded. diff --git a/dist/changes-5.12.1 b/dist/changes-5.12.1 new file mode 100644 index 0000000..6aa1c02 --- /dev/null +++ b/dist/changes-5.12.1 @@ -0,0 +1,68 @@ +Qt 5.12.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + +**************************************************************************** +* Qt 5.12.1 Changes * +**************************************************************************** + + - [QTBUG-54901 Fixed QCamera to return ServiceMissingError + if no camera can be found by name. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-51769] Fixed camera example to apply video settings. + - [QTBUG-64178] Fixed compilation error + if GST_VIDEO_REGION_OF_INTEREST_META_INFO is not available. + - Added fix to avoid creating video profile if no codec provided. + - Added fix to build gstreamer on Windows and MSVC. + +CoreAudio +--------- + + - [QTBUG-63492] Added logic to decrease volume when playback is stopped + to avoid popping noise. + +DirectShow +---------- + + - [QTBUG-68768] The camera will now use the pixel format requested by + QCameraViewFinderSettings, if supported, instead of defaulting to RGB32. + - [QTBUG-71851] Added fix to display windows error string when camera fails. + - [QTBUG-42057] Added fix to restart an inactive surface when a new frame is received. + - [QTBUG-72012] Added fix to keep the last video buffer from sample grabber. + +Alsa +---- + + - Fixed QSoundEffect to prevent openning a device twice. + +Windows +------- + + - [QTBUG-71326] Added fix to repaint QVideoWidget when WM_PAINT or WM_ERASEBKGND received. + +WMF +--- + + - [QTBUG-72287] Mapped PKEY_Media_EncodingSettings to QMediaMetaData::Description. diff --git a/dist/changes-5.12.2 b/dist/changes-5.12.2 new file mode 100644 index 0000000..c67fb9c --- /dev/null +++ b/dist/changes-5.12.2 @@ -0,0 +1,45 @@ +Qt 5.12.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.2 Changes * +**************************************************************************** + +- Fixed a crash in the media player when an application is exited while a media player is still playing. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-39327] Introduced possibility to set custom pipeline using gst-pipeline url scheme. + +Android +------- + + - [QTBUG-67280] Fixed memory leak of GL resources when DeferredDelete event is not delivered. + +DirectShow +---------- + + - [QTBUG-73461] Fixed a crash when camera is being destroyed. diff --git a/dist/changes-5.12.3 b/dist/changes-5.12.3 new file mode 100644 index 0000000..f306ef2 --- /dev/null +++ b/dist/changes-5.12.3 @@ -0,0 +1,40 @@ +Qt 5.12.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.2. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.3 Changes * +**************************************************************************** + +- Fixed QCameraInfo to be invalid if camera failed to find device. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Gstreamer +--------- + + - [QTBUG-73557] Fixed setting surface from current renderer after changing the pipeline. + + WinRT + ----- + + - [QTBUG-72874] Fixed camera preview/image capture to use highest supported resolution. diff --git a/dist/changes-5.12.4 b/dist/changes-5.12.4 new file mode 100644 index 0000000..e9e1a73 --- /dev/null +++ b/dist/changes-5.12.4 @@ -0,0 +1,57 @@ +Qt 5.12.4 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.3. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Qt 5.12.4 Changes * +**************************************************************************** + +- [QTBUG-57836] Fixed QGraphicsVideoItem to always use the generic painter + when no gl paint engine is available. +- [QTBUG-74277] Fixed usage of makeCurrent in QPainterVideoSurface. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- Android: + * [QTBUG-73582] Fixed QMediaRecorder's status changes after start/stop. + * [QTBUG-73582] The camera's stateChanged signal is now immediately sent + regardless of the current activity state. + * [QTBUG-73582] Fixed the camera to prevent it from opening the same device twice. + * [QTBUG-73237] Added support for starting the camera without an available viewfinder. + +- AVFoundation: + * [QTBUG-75285] Fixed the usage of $PRODUCT_NAME in the Info.plist to only be used + with the macx-xcode spec. + +- GStreamer: + * [QTBUG-75314] The pipeline will now be reset to GST_STATE_PAUSED instead of + GST_STATE_NULL after EndIfStream. + * [QTBUG-72468] Fixed deadlock when the state of the pipeline is requested in ASYNC mode. + * Added a possibility to use streams in the player's custom pipeline + if it contains an appsrc element. + * Added dumping of dot file of the player's pipeline if GST_DEBUG_DUMP_DOT_DIR is set. + +- DirectShow: + * [QTBUG-65574] Fixed the media player to prevent updating the status + when there are no finished tasks. + * [QTBUG-65574] Removed the start/end times in QVideoFrame. + * [QTBUG-65574] Fixed the player to return an error for invalid urls. diff --git a/dist/changes-5.12.5 b/dist/changes-5.12.5 new file mode 100644 index 0000000..34cf7ee --- /dev/null +++ b/dist/changes-5.12.5 @@ -0,0 +1,35 @@ +Qt 5.12.5 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.12.0 through 5.12.4. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.12 series is binary compatible with the 5.11.x series. +Applications compiled for 5.11 will continue to run with 5.12. + +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. + + - This release contains only minor code improvements. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- GStreamer: + * Added "audio/x-raw" codec to use "audio/x-wav" container in QAudioRecorder. + * Fixed bug where a player, without its own video surface, would end up using + another players video surface. + * [QTBUG-65399] Added fix to prevent seeking to the beginning when playback + is started. + +- AVFoundation: + * [QTBUG-77270] Added fix to avoid showing black frames when the current + OpenGL context changes. diff --git a/dist/changes-5.13.0 b/dist/changes-5.13.0 new file mode 100644 index 0000000..44a45a8 --- /dev/null +++ b/dist/changes-5.13.0 @@ -0,0 +1,64 @@ +Qt 5.13 introduces many new features and improvements as well as bugfixes +over the 5.12.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-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +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. + +**************************************************************************** +* Qt 5.13.0 Changes * +**************************************************************************** + +- [QTBUG-63596] Added support for selecting the output device used by QSoundEffect. +- [QTBUG-28850] QMediaResource class is now deprecated. +- [QTBUG-37301] Added flushMode property to QML VideoOutput element to define + what should be shown when flush is requested. +- Fixed QCameraInfo::defaultCamera() to return first non-empty name. +- Introduced QVideoFrame::buffer() to get access to the video buffer. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - Android: + * [QTBUG-73119] Implemented audio roles. + * [QTBUG-69968] Changed video frame format from BGR32 to ABGR32. + * [QTBUG-74073] Introduced HTTP headers to MediaPlayer. + * [QTBUG-73583] Fixed a crash when the audio output is unable to get the min buffer size. + + - Windows: + * [QTBUG-32783] Removed -mediaplayer-backend config param which allowed + to build wmf together with DirectShow. + * [QTBUG-71610] The surface is now stopped when EndOfStream is received. + * [QTBUG-66526] Moved parsing of metadata to worker thread. + * [QTBUG-56400] Added QT_MULTIMEDIA_PREFERRED_PLUGINS to + specify preferred plugins if multiple backends are available. + * DircetShow or WMF can now be disabled by -no-directshow or -no-wmf + within configuring. + * [QTBUG-71819] Fixed video and audio probes in media player. + * [QTBUG-74180] Fixed to avoid setting camera zoom to 1x on restart when it is not requested. + * [QTBUG-75024] Fixed to avoid setting volume to 100% on restart when it is not requested. + * [QTBUG-65574] Fixed bug in EVR to prevent repainting with black + when the surface is not active. + * Now position of QMediaPlayer should be reset on pause after EOS. + + - GStreamer: + * [QTBUG-65402] Added fix to avoid appending a second extension to the file name, + if it already contains one. + * [QTBUG-72125] Add support for ksvideosrc and avfvideosrc within camerabin. + * Enabled gstreamer support by default for Windows and macOS. + * Added support of video orientation metadata. + * Now GstBuffer could be retrieved from QGstVideoBuffer. + + - PulseAudio: + * [QTBUG-71710] Introduced QT_PA_CHANNEL_MAP for QAudioOutput. diff --git a/dist/changes-5.13.1 b/dist/changes-5.13.1 new file mode 100644 index 0000000..78a7243 --- /dev/null +++ b/dist/changes-5.13.1 @@ -0,0 +1,46 @@ +Qt 5.13.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.13.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +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. + +**************************************************************************** +* Qt 5.13.1 Changes * +**************************************************************************** + +- [QTBUG-76090] Fixed crash when an app is destroyed before QSample::load finishes. +- [QTBUG-76205] Added fix to only update the VideoOutput's geometry when the surface is active. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - DirectShow: + * [QTBUG-65574] Added error when attempting to play a video without a video output set. + * [QTBUG-65574] Added fix to prevent the same media content from being set twice. + * [QTBUG-65574] Returns QMediaPlayer::NoMedia if an empty url is provided. + * [QTBUG-75959] Mapped MEDIASUBTYPE_RGB24 to QVideoSurfaceFormat::Format_BGR24. + * [QTBUG-70655] Fixed build issues with newer MinGW versions. + * Fixed memory leak introduced by using GetFrameRateList. + + - AVFoundation: + * [QTBUG-75287] QMediaRecorder will now only send state changes when the state actually changes. + + - GStreamer: + * [QTBUG-76236] Now busy cameras are also returned in availableCameras. + * Fixed a crash when the bus helper is destroyed but is still receiving events. + * GstUDPSrc caps can now be passed via the url's query item. + * Added implementation for fetching audio/video codecs by container and vice versa. diff --git a/dist/changes-5.13.2 b/dist/changes-5.13.2 new file mode 100644 index 0000000..a132744 --- /dev/null +++ b/dist/changes-5.13.2 @@ -0,0 +1,68 @@ +Qt 5.13.2 is a bug-fix release. It maintains both forward and backward +source compatibility with Qt 5.13.0 through 5.13.1. +In Qt 5.13.0, binary compatibility was broken due to the usage of the enum +QVideoSurfaceFormat::PixelFormat, the break has been reverted, +thus introducing a binary compatibility break with earlier Qt 5.13.0 and 5.13.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.13 series is binary compatible with the 5.12.x series. +Applications compiled for 5.12 will continue to run with 5.13. + +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. + +**************************************************************************** +* Qt 5.13.2 Changes * +**************************************************************************** + + - In Qt 5.13.0 binary compatibility was broken + for usage of the enum QVideoSurfaceFormat::PixelFormat by introducing + QVideoSurfaceFormat::Format_ABGR32. + To minimize the impact of this, the break has been reverted, + thus introducing a binary compatibility break with earlier Qt 5.13.x + versions, but restoring compatibility with all earlier versions of Qt 5. + - Fixed crash when VideoOutput.sourceRect is requested but playback is stopped. + - [QTBUG-51588] Fixed leaking of QVideoFilterRunnable when window is closed. + - [QTBUG-45064] Introduced QGraphicsVideoItem::type(). + - Fixed camera.viewfinder to respect camera's media status + if the viewfinder is requested after the camera is loaded. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - GStreamer: + * CameraBin plugin now fetches supported viewfinder settings at status + higher or equal to LoadedStatus if it has not been fetched. + * Fixed duplicated entries in supported Camera's resolution/framerate if the + underlying element uses caps' features. + * Introduced audio/x-raw codec in QAudioRecorder. + * [QTBUG-65399] Fixed media player to show pre-rolled frame on new media + (means to seek to the beginning) only when pause() is called. + * [QTBUG-76135] Show image processing warnings only when the camera is loaded. + * [QTBUG-78079] Fixed media player to recreate playbin features after custom pipeline. + * [QTBUG-73084] Fixed mapping of VPU texture using real physical address of data + which prevents leaks in the kernel for iMX boards. + + - AVFoundation: + * [QTBUG-77270] Fixed black frames being shown if current OpenGL context has been changed. + * [QTBUG-49806] Fixed media player to send StalledMedia status when no enough data to play + and resume playback afterwards. + + - DirectShow: + * [QTBUG-77829] Fixed crash when there is no surface on flush(). + * [QTBUG-77849] Introduced startTime and endTime to QVideoFrame. + * [QTBUG-77163] Introduced support to use QMediaPlayer in secondary thread. + * [QTBUG-46368] Implemented QMediaVideoProbeControl->flush(). + * [QTBUG-46368] Fixed media player to send media status before errors. + * [QTBUG-68778] Fixed media player to postpone seeking if the playback is stopped. + * Fixed crash when qrc media resource is set twice to media player. diff --git a/dist/changes-5.14.0 b/dist/changes-5.14.0 new file mode 100644 index 0000000..fb4f46b --- /dev/null +++ b/dist/changes-5.14.0 @@ -0,0 +1,54 @@ +Qt 5.14 introduces many new features and improvements as well as bugfixes +over the 5.13.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-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +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. + +**************************************************************************** +* Qt 5.14.0 Changes * +**************************************************************************** + + - [QTBUG-73878] Removed the Mir client code as it is no longer used. + - Added QVideoSurfaceFormat::Format_YUV422P. + - Deprecated canonicalUrl and canonicalRequest in QMediaContent. + - [QTBUG-74422] Moved dtors of QCameraExposure, QCameraFocus, + QCameraImageProcessing from private to protected. + - [QTBUG-75781] QAudioDeviceInfo::realm() is moved from private to public. + - [QTBUG-77630] QMediaServicePrivate is now inherited from QObjectPrivate. + - [QTBUG-75943] Qt Audio Engine QML types are now deprecated. + QMediaServiceProviderPlugin, QMediaServiceProviderHint, QMediaServiceProvider, + QMediaServiceProviderPlugin, QMediaServiceSupportedFormatsInterface, + QMediaServiceSupportedDevicesInterface,QMediaServiceDefaultDeviceInterface, + QMediaServiceCameraInfoInterface, QMediaServiceFeaturesInterface, + QRadioTuner, QRadioData + classes are now deprecated. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + + - GStreamer: + * [QTBUG-65398] Stopping a camera will now be postponed until the pipeline is ready. + * [QTBUG-66162] Introduced support of OpenGL plugin. + * The media player will no longer send an EOS signal for sequential devices when read() returns 0. + * [QTBUG-78855] Fixed wrong texture format being used on iMX. + * [QTBUG-72125] Added GStreamer support for Android. + + - AVFoundation: + * [QTBUG-67985] Fixed the front camera to use 270 instead of 90 orientation. + + - Android: + * [QTBUG-70368] Added SL_ANDROID_RECORDING_PRESET_VOICE_COMMUNICATION support. + * [QTBUG-69333] Fixed crash when fetching video frame data from the GUI thread. + * [QTBUG-79909] Fixed crash when audio recording permission is asked on active camera. diff --git a/dist/changes-5.14.1 b/dist/changes-5.14.1 new file mode 100644 index 0000000..877e778 --- /dev/null +++ b/dist/changes-5.14.1 @@ -0,0 +1,25 @@ +Qt 5.14.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.14.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +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. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- WebGL: + * [QTBUG-79181] Fixed video rendering for WebGL on iMX platforms. diff --git a/dist/changes-5.14.2 b/dist/changes-5.14.2 new file mode 100644 index 0000000..ad36891 --- /dev/null +++ b/dist/changes-5.14.2 @@ -0,0 +1,45 @@ +Qt 5.14.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.14.0 through 5.14.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.14 series is binary compatible with the 5.13.x series. +Applications compiled for 5.13 will continue to run with 5.14. + +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. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- Android: + * [QTBUG-81006] Fixed issue when multimedia plugins were not loaded. + * [QTBUG-59517] Fixed to prevent multiple copies of one tmp file + when playing video from qrc. + +- GStreamer: + * [QTBUG-81075] Fixed creating incorrect encoding profile + to avoid errors when the media container is not supported + in the video recorder. + * Fixed to have separate resolution settings for capturing and + camera's viewfinder. + +- AVFoundation: + * [QTBUG-81048] Fixed applying viewfinder settings when starting the camera. + * [QTBUG-79935] Fixed applying viewfinder settings for iOS. + * [QTBUG-81804] Removed usage of deperecated AVPlayerItem::seekToTime::CMTime. + * [QTBUG-81912] Fixed to resume playback after a stalled buffer + only if it was already in playing state. + * [QTBUG-65536] Fixed to have proper size bounds when resizing the window + while playing video. + * [QTBUG-82542] Fixed content flickering on resize for video player. + * [QTBUG-82264] Fixed to use only video surface's supported pixel formats in Camera. diff --git a/dist/changes-5.15.0 b/dist/changes-5.15.0 new file mode 100644 index 0000000..d4a42d6 --- /dev/null +++ b/dist/changes-5.15.0 @@ -0,0 +1,57 @@ +Qt 5.15 introduces many new features and improvements as well as bugfixes +over the 5.14.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-5/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +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. + +**************************************************************************** +* Deprecation Notice * +**************************************************************************** + + - Functions taking or returning QNetworkConfiguration have been + deprecated. + - QCamera::error() (the signal) is deprecated; superseded by + errorOccurred() + - Camera::error() signal is deprecated in favor of errorOccurred(). + - [QTBUG-75943] QMediaService and QMediaControl classes are now + deprecated. + +**************************************************************************** +* Qt 5.15.0 Changes * +**************************************************************************** + + - Introduced QVideoFrame::image() to return an image based on the frame. + - [QTBUG-80431] Introduced videoSurface property to QVideoWidget, + QGraphicsVideoItem and QDeclarativeVideoOutput. + - [QTBUG-80431] Introduced QVideoWidget::videoSurface(), + QGraphicsVideoItem::videoSurface(), QDeclarativeVideoOutput::videoSurface(). + - [QTBUG-32939] Introduced rendering to multiple surfaces. + - [QTBUG-32939] Introduced MediaPlayer::videoOutput property. + - [QTBUG-81902] Removed usage of QGL* APIs. + - [QTBUG-82299] Added flushMode to Video QML element. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- GStreamer: + * Added watching for zoom and max-zoom property changes in CameraBin. + * Introduced reverse playback. + +- AVFoundation: + * Added watching for QAbstractVideoSurface::supportedFormatsChanged + in the media player to enable gl if the surface starts to support it. + * [QTBUG-69101] Introduced adoption of AVAssetResourceLoaderDelegate protocol. + * [QTBUG-68779] Added QVideoWindowControl implementation, now it is used + by default for QVideoWidget instead of QVideoWidgetControl. diff --git a/dist/changes-5.15.1 b/dist/changes-5.15.1 new file mode 100644 index 0000000..d7ec2c5 --- /dev/null +++ b/dist/changes-5.15.1 @@ -0,0 +1,45 @@ +Qt 5.15.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.15.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +https://doc.qt.io/qt-5/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +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. + +**************************************************************************** +* Qt 5.15.1 Changes * +**************************************************************************** + +- [QTBUG-85202] QMemoryVideoBuffer is not mapped when there is no data inside. +- [QTBUG-52455] QVideoSurfaceFormat::Format_Y8 is mapped to QImage::Format_Grayscale8. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +- AVFoundation: + * Fixed playback of files with spaces in their names. + * [QTBUG-83776] If just list of devices are requested, + audio session categories are not applied. + +- GStreamer: + * [QTBUG-85545] Fixed to update a render rect only for glimagesink. + * [QTBUG-84556] Fixed regression where the playback did not start + after data is buffered. + * [QTBUG-83663] Removed a dependency to gstreamer_imxcommon. + * [QTBUG-76179] Introduced QT_GSTREAMER_PLAYBIN_CONVERT to inject + a converter in playbin. + * Fixed to keep only one frame in vivante video node for iMX devices. + This fixes jerky playback when frames are not coming at constant rate. + * [QTBUG-83945] Fixed reverse playback. diff --git a/dist/changes-5.15.2 b/dist/changes-5.15.2 new file mode 100644 index 0000000..2dfc02b --- /dev/null +++ b/dist/changes-5.15.2 @@ -0,0 +1,29 @@ +Qt 5.15.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.15.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + https://doc.qt.io/qt-5.15/index.html + +The Qt version 5.15 series is binary compatible with the 5.14.x series. +Applications compiled for 5.14 will continue to run with 5.15. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +AVFoundation: + - [QTBUG-85470] Fixed the capture signal emission. CaptureToBuffer, + and CaptureToFile will now emit imageAvailable, and imageSaved, respectively. + Additionally imageCaptured will now only be emitted if there is a video + frame available. + diff --git a/dist/changes-5.2.0 b/dist/changes-5.2.0 new file mode 100644 index 0000000..e485659 --- /dev/null +++ b/dist/changes-5.2.0 @@ -0,0 +1,86 @@ +Qt 5.2 introduces many new features and improvements as well as bugfixes +over the 5.1.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.2 + +The Qt version 5.2 series is binary compatible with the 5.1.x series. +Applications compiled for 5.1 will continue to run with 5.2. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* General * +**************************************************************************** + + - Improved ALSA implementation of the audio APIs. + - Improved WAV support in QSoundEffect. + - New resource policy plugin based on libresourceqt. + - Fix QVideoSurfaceArbFpPainter mistakenly failing to start in some cases. + - Improved QAudioRecorder implementation on Windows and Mac OS. + - Various documentation fixes. + - Improved audiorecorder example. + - [QTBUG-32487] Make PulseAudio implementation of QSoundEffect more robust. + - [QTBUG-32882] Enable QSoundEffect with loopCount of Infinite to play. + - [QTBUG-31731] WMF and GStreamer: fixed incorrect frame startTime and endTime. + - [QTBUG-30442] VideoOutput: take the video format's scanLineDirection into account. + - [QTBUG-34125] Correctly clear the current media in Audio and MediaPlayer qml elements. + +Qt for Android +-------------- + + - New OpenSL ES plugin for low-latency audio support on Android. + - New camera support on Android. + - Improved video renderering with Qt Quick. + - Camera and recording permissions are now automatically added when using QtMultimedia on Android. + - [QTBUG-32635] Fixed media player buffering logic. + - [QTBUG-34558] Fix two race conditions in the media player. + +Qt for iOS +---------- + + - New media player and basic camera support on iOS. + +Qt for BlackBerry +----------------- + + - Fix setting a URL containing reserved characters on a media player. + - Enable camera on the Playbook. + - New QAudioRecorder support. + - Fix video recording with BB 10.2. + - Improve camera focus handling. + - Fixed pixel aspect ratio for video windows. + - [QTBUG-33739] Fix camera viewfinder. + +Qt for Windows +-------------- + + - WMF: emit positionChanged() signal when reaching the end of a media. + - [QTBUG-30776] DirectShow: improve metadata support. + - [QTBUG-33631][QTBUG-33518] WMF: allow to load media whose content doesn't match its file extension. + - [QTBUG-33518] WMF: allow to load QRC files with QAudioDecoder. + - [QTBUG-30435] WMF: fixed the media player failing to play some media formats. + - [QTBUG-32360] WMF: fixed compilation with Visual Studio 2008. + - [QTBUG-34479] DirectShow: fixed compilation with Visual Studio 2008. + - [QTBUG-32864] WMF: fixed compilation on Windows Vista. + - [QTBUG-30825] WMF: fixed QMediaPlayer changing to EndOfMedia status too early. + - [QTBUG-33160] Fix QAudioOutput::setVolume() limited to 50% on 32-bit Windows. + +Qt for QNX +---------- + + - New camera and media player support when mmrenderer is available. + +**************************************************************************** +* Plugins * +**************************************************************************** + + - New QML import version QtMultimedia 5.2 adds a new autoOrientation + property to the VideoOutput type, which allows the video output to + always match the screen orientation. diff --git a/dist/changes-5.2.1 b/dist/changes-5.2.1 new file mode 100644 index 0000000..17a39e6 --- /dev/null +++ b/dist/changes-5.2.1 @@ -0,0 +1,35 @@ +Qt 5.2.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.2.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.2 + +The Qt version 5.2 series is binary compatible with the 5.1.x series. +Applications compiled for 5.1 will continue to run with 5.2. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Android: + * [QTBUG-31422] The mediaplayer can now read files from the Qt + Resource system. + * [QTBUG-35416] QVideoProbe is now functional when used with a camera + source + * [QTBUG-35086] Fixed VideoOutput not showing video frames in the + correct orientation when used with a Camera. + * [QTBUG-35868] Multiple MediaPlayer elements now show correct video + frames when playing simultaneously. diff --git a/dist/changes-5.3.1 b/dist/changes-5.3.1 new file mode 100644 index 0000000..e83a219 --- /dev/null +++ b/dist/changes-5.3.1 @@ -0,0 +1,61 @@ +Qt 5.3.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.3.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.3 + +The Qt version 5.3 series is binary compatible with the 5.2.x series. +Applications compiled for 5.2 will continue to run with 5.3. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Importing QtMultimedia in QML with the 5.3 version number is now + correctly recognized. + - [QTBUG-38218][QTBUG-30447] VideoOutput (QML): Fix garbled rendering of + video frames when the stride is not equal to the width. + - [QTBUG-38755] Fixed parsing PLS playlist files when the system's locale + is not English. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - A media player's volume is now preserved when loading a new media. + - QMediaPlayer can now play Qt resource files on Android 4.1 and lower. + - [QTBUG-39015] Fixed sound being in rare occasions garbled when playing + audio with QAudioOutput and QSoundEffect. + - [QTBUG-39346] QMediaPlayer and the corresponding QML types can now play + files located in the application private storage, such as temporary + files. + +Linux +----- + + - [QTBUG-39202] Fixed crash on application startup when using a static + version of Qt. + - [QTBUG-38465] Fixed media player dropping a lot of frames when playing a + live stream. + +Windows +------- + + - [QTBUG-39202] Fixed crash on application startup when using a static + version of Qt. diff --git a/dist/changes-5.3.2 b/dist/changes-5.3.2 new file mode 100644 index 0000000..b427bb8 --- /dev/null +++ b/dist/changes-5.3.2 @@ -0,0 +1,65 @@ +Qt 5.3.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.3.0 and 5.3.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.3 + +The Qt version 5.3 series is binary compatible with the 5.2.x series. +Applications compiled for 5.2 will continue to run with 5.3. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed regression causing videos recorded with the camera not to be registered with the Android + media scanner, making them invisible to media browsing apps. + - Fixed crash when unloading a QCamera while a recording is active. + - [QTBUG-39307] Setting camera parameters on the QML Camera type (e.g. digitalZoom, flashMode) + now works correctly when set before the camera is loaded. + - [QTBUG-40208] QAudioOutput::setNotifyInterval() can now be used when the output is active. + - [QTBUG-40274] Fixed metadata not being loaded by the MediaPlayer when playing a remote media, + from a qrc file or from assets. + +iOS +--- + + - [QTBUG-39036] Audio played using SoundEffect or QAudioOutput is now correctly muted when the + device is set to silent mode or when the screen is locked. + - [QTBUG-39385] The last video frame displayed in a QML VideoOutput doesn't remain on screen + anymore after destroying the VideoOutput. + +Linux +----- + + - MediaPlayer's loops property now works correctly when playing a media from a qrc file. + - [QTBUG-29742] Fixed Qt apps hanging when audio APIs are used and PulseAudio is not running. + - [QTBUG-39949] Fixed QMediaRecorder::setOutputLocation() not working with QUrl::fromLocalFile(). + +OS X +---- + + - Application doesn't freeze anymore when changing the system audio output device while audio + is being played with QSoundEffect or QAudioOutput. + - [QTBUG-38666] Video frames are now correctly positioned on screen when playing a live stream + in a QVideoWidget. This also applies to iOS. + - [QTBUG-38668] Fixed crash when setting QMediaRecorder's output location to a URL containing + nonstandard characters. + +Windows +------- + + - The DirectShow camera backend has been almost entirely rewritten. It doesn't provide any new + feature but it now works as it should. diff --git a/dist/changes-5.4.0 b/dist/changes-5.4.0 new file mode 100644 index 0000000..543638e --- /dev/null +++ b/dist/changes-5.4.0 @@ -0,0 +1,111 @@ +Qt 5.4 introduces many new features and improvements as well as bugfixes +over the 5.3.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Important Behavior Changes * +**************************************************************************** + + - Using QAudioOutput and QSoundEffect with the PulseAudio backend won't + cause the system volume to be automatically changed to the maximum value + anymore. Audio streams will now respect the system-wide volume unless + explicitly set with setVolume(). + - On Linux, both Alsa and PulseAudio backends are now present. PulseAudio + is used by default if available on the system and if the server is + running, otherwise Alsa is used instead. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added new QAbstractPlanarVideoBuffer class. + + - Camera (QML): + * Added deviceId, displayName, position, orientation, metadata, + viewfinder.resolution, viewfinder.minimumFrameRate and + viewfinder.maximumFrameRate properties. + * Camera device can be selected by setting the deviceId or position + properties. + * + + - QtMultimedia global QML object: + * Added defaultCamera and availableCameras properties. + + - QAbstractVideoBuffer: + * Added mapPlanes() function. + + - QVideoFrame: + * Added support for planar video formats. New planeCount(), + bytesPerLine(int plane) and bits(int plane) functions. + + - [QTBUG-40515] Improved PLS parser. It is now more permissive, allowing + to load virtually any kind of PLS file. It also correctly resolve + relative paths. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Changing a media player's position after reaching the end of a media + now correctly works. + - [QTBUG-40314] Fixed playing a QMediaPlaylit with a QMediaPlayer. + +Linux +----- + + - Added support for QCameraInfo::position() and QCameraInfo::orientation(). + - Added support for QCameraFocus::customFocusPoint. + - QMediaRecorder::duration() now returns the correct value when recording + with a camera source. + - QMediaMetaData::ContributingArtist and QMediaMetaData::AlbumArtist + now map to the correct metadata. + - Fixed QMediaPlayer's metaDataAvailableChanged() signal, which was never + emitted. + +OS X +---- + + - OS X 10.6 not being supported anymore, the QuickTime backend has been + removed. + +QNX +--- + + - [QTBUG-40746] Fixed crash when detroying a QML VideoOutput or Video item. + +Windows +------- + + - [QTBUG-32481] Fixed various memory leaks when using a media player. + - [QTBUG-39980] Fixed crash occasionally happening when playing and + stopping repeatedly a media with QMediaPlayer. + - [QTBUG-40954] Buffers retrieved with QAudioProbe now have a correct + startTime(). + - [QTBUG-41158] Fixed crash occasionally happening when destroying a + QML MediaPlayer. + +WinRT +----- + + - Enabled media player support for WinRT. + - Enabled basic camera support for WinRT (viewfinder, still image capture + and camera device selection). diff --git a/dist/changes-5.4.1 b/dist/changes-5.4.1 new file mode 100644 index 0000000..7175885 --- /dev/null +++ b/dist/changes-5.4.1 @@ -0,0 +1,49 @@ +Qt 5.4.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.4.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - VideoOutput's autoOrientation property now correctly works after + switching cameras. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-42159] QAudioInput::setVolume() is now functioning. + +Linux +----- + + - [QTBUG-43514] Fixed static linking. + + WinRT +----- + + - [QTBUG-41066] Fix VideoOutput autoOrientation when used with a Camera. + - [QTBUG-41065] Show Camera viewfinder frames in a resolution adapted to + the current capture mode. diff --git a/dist/changes-5.4.2 b/dist/changes-5.4.2 new file mode 100644 index 0000000..07e5530 --- /dev/null +++ b/dist/changes-5.4.2 @@ -0,0 +1,64 @@ +Qt 5.4.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.4.0 and 5.4.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://qt-project.org/doc/qt-5.4 + +The Qt version 5.4 series is binary compatible with the 5.3.x series. +Applications compiled for 5.3 will continue to run with 5.4. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt-project.org/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - QCameraInfo::availableCameras() and QtMultimedia.availableCameras (QML) + now return an up-to-date list when a camera is added or removed from the + system. + - Fixed memory leak in QMediaPlaylist::load(). + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-37525] Fixed VideoOutput not working on some devices when used + with a Camera. + - [QTBUG-44383] Fixed setting a URL with special characters on a + MediaPlayer. + +iOS +--- + + - [QTBUG-44790] Fixed crash when using QAudioOutput/QAudioInput on iOS 5. + - [QTBUG-45659] Using QCamera doesn't always prompt for microphone + permission anymore, it now only does so when using the CaptureVideo mode. + +Linux +----- + + - [QTBUG-42326] Fixed regression causing software devices to not be + included in QAudioDeviceInfo::availableDevices() when using the ALSA + backend. + +Windows +------- + + - [QTBUG-32746] QMediaPlayer doesn't resume playback anymore when seeking + an audio media while paused. + - [QTBUG-42648] Greatly improved QAudioDeviceInfo supported formats detection. + - [QTBUG-44305] QAudioDeviceInfo: Fixed memory leak in availableDevices(). diff --git a/dist/changes-5.5.0 b/dist/changes-5.5.0 new file mode 100644 index 0000000..14b9cc0 --- /dev/null +++ b/dist/changes-5.5.0 @@ -0,0 +1,118 @@ +Qt 5.5 introduces many new features and improvements as well as bugfixes +over the 5.4.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.5 + +The Qt version 5.5 series is binary compatible with the 5.4.x series. +Applications compiled for 5.4 will continue to run with 5.5. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added QAbstractVideoFilter that serves as a base class for QML + video filtering elements that integrate compute, vision, and image + processing frameworks with VideoOutput. + - Added new QCameraViewfinderSettings class. + - [QTBUG-40571] Fixed memory leak in QAudioDecoder. + + - Camera (QML): + * Added imageProcessing.colorFilter, viewfinder.minimumFrameRate and + viewfinder.maximumFrameRate properties. + * Added new supportedViewfinderResolutions() and + supportedViewfinderFrameRateRanges() methods. + * Exposure modes extended to support Action, Landscape, NightPortrait, + Theatre, Sunset, SteadyPhoto, Fireworks, Party, Candlelight, and + Barcode modes + + - QCamera: + * Added support for viewfinder settings. In addition to the getter and + setter, supportedViewfinderSettings(), + supportedViewfinderResolutions(), supportedViewfinderFrameRateRanges() + and supportedViewfinderPixelFormats() can be used to query for + supported values. + * Fixed searchAndLock() and supportedLocks() functions which could not + work at all on some platforms. + + - QCameraExposure: + * Exposure modes extended to support Action, Landscape, NightPortrait, + Theatre, Sunset, SteadyPhoto, Fireworks, Party, Candlelight, and + Barcode modes + + - QCameraImageProcessing: + * Added support for color filters. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Added support for additional camera exposure modes (see list in + QCameraExposure changes). + +iOS / OS X +---------- + + - Improved camera support: + * Image capture settings, focus, flash, exposure (iOS only) and + zoom (iOS only) APIs are now functional. + * QVideoProbe can now be used with a QCamera. + + - VideoOutput, when used with a MediaPlayer on iOS, can now be displayed + under other elements and supports shader effects and advanced + transformations. + - QMediaRecorder now uses the correct system default audio capture + device. + - [QTBUG-36175] QMediaPlayer and the QML Audio and Mediaplayer types can + now play media files stored in a Qt resource file. + - [QTBUG-37655] Fixed video capture on iOS. + - [QTBUG-39240] QMediaPlayer and the QML Audio and Mediaplayer types now + support volume and mute on iOS 7.0 and later. + - [QTBUG-42035] Fixed crash when capturing an image after changing the + active camera device. + +Linux +----- + + - Added support for GStreamer 1.0. The 0.10 series is still used by default + and Qt needs to be configured with '-gstreamer 1.0' to enable 1.0 + support. If only GStreamer 1.0 is available on the system, the configure + script will automatically configure Qt with GStreamer 1.0 support. + - QCamera now supports exposure and white balance locks. + - Added support for additional camera exposure modes (see list in + QCameraExposure changes). + - Fixed QCameraImageCapture::supportedResolutions(), + QMediaRecorder::supportedResolutions() and + QMediaRecorder::supportedFrameRates() that could return empty lists. + - [QTBUG-46169] QVideoWidget now works with any windowing system. It was + previously only working with X11. + +Windows +------- + + - [QTBUG-45571] QAudioBuffer::startTime() now returns the time in the + correct time scale. + +WinRT +----- + + - [QTBUG-42263] QMediaPlayer and the QML Audio and Mediaplayer types can + now play media files stored in a Qt resource file. + - [QTBUG-44838] Fixed camera preview on Lumia 630. + - [QTBUG-45920] Fixed camera preview on Lumia 530. + - [QTBUG-45667] Fixed crash that could occur when using the camera + preview. diff --git a/dist/changes-5.5.1 b/dist/changes-5.5.1 new file mode 100644 index 0000000..d81d815 --- /dev/null +++ b/dist/changes-5.5.1 @@ -0,0 +1,68 @@ +Qt 5.5.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.5.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.5/ + +The Qt version 5.5 series is binary compatible with the 5.4.x series. +Applications compiled for 5.4 will continue to run with 5.5. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - The environment variable QT_QUICK_NO_TEXTURE_VIDEOFRAMES can now be used + to disable OpenGL texture based video frames when using the VideoOutput + QML type. This can be useful in applications that wish to filter and + process the video frames using QAbstractVideoFilter and are not GPU + based. + - QCamera's viewfinder capabilities functions now report correct values + when filtering by pixel aspect ratio. + - [QTBUG-46359] fixed crash after using moveToThread() on a QSoundEffect. + - [QTBUG-47205] fixed VideoOutput (QML) rendering frames from the wrong + source when having multiple VideoOutputs using different sources. + - [QTBUG-47630] fixed Camera.supportedViewfinderFrameRateRanges() (QML) + returning incorrect values when the argument is not of type 'size'. + - [QTBUG-47859] fixed crash when using Radio.radioData (QML) without + a radio backend available. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed QVideoProbe stopping to work when using QMediaRecorder to record + the camera. + - Video frames passed to a QAbstractVideoFilter can now be mapped to + system memory. + +Linux +----- + + - QCameraImageProcessing::isWhiteBalanceModeSupported() now correctly + reports if a given white balance mode is supported. + - [QTBUG-45707] fixed QAudioRecorder::stop() sometimes failing to + actually stop the recording. + + WinRT +----- + + - [QTBUG-46456] QCameraImageCapture: getting the list of supported + image capture resolutions and setting the image capture resolution is + now supported. + - [QTBUG-47373] fixed crash occurring with some camera operations. diff --git a/dist/changes-5.6.0 b/dist/changes-5.6.0 new file mode 100644 index 0000000..5051431 --- /dev/null +++ b/dist/changes-5.6.0 @@ -0,0 +1,138 @@ +Qt 5.6 introduces many new features and improvements as well as bugfixes +over the 5.5.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5.6 + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +Some of the changes listed in this file include issue tracking numbers +corresponding to tasks in the Qt Bug Tracker: + + http://bugreports.qt.io/ + +Each of these identifiers can be entered in the bug tracker to obtain more +information about a particular change. + +**************************************************************************** +* Important Behavior Changes * +**************************************************************************** + + - QAudioOutput now transitions to IdleState instead of ActiveState when + calling resume() in push mode. This was already the documented behavior + but in practice, it was not respected on any platform. See QTBUG-50390. + + - DirectShow is now the default backend on all desktop versions of Windows, + regardless of the compiler used. The Windows Media Foundation backend + (WMF) can be re-enabled by configuring Qt with the -wmf-backend option. + See QTBUG-45597. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added new Playlist QML type. + + - Audio Engine QML types + * All types can now be created dynamically and added to the engine + using new 'add' functions. + + - MediaPlayer, Audio and Video (QML): + * Added new audio role API. + * Added playlist support. + + - QMediaPlayer: + * Added new audio role API. + + - [QTBUG-49838] Fixed crash when playing very short WAV files with + QSoundEffect. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - QAudioOutput: improved detection of the default buffer size and sample + rate. + - [QTBUG-35416] Camera QVideoFrames can now me mapped when retrieved using + QAbstractVideoSurface or QVideoProbe. + - [QTBUG-37837] Fixed crash when recording the camera on specific devices. + - [QTBUG-46491] Fixed media player blocking the UI when loading a media. + - [QTBUG-49134] Fixed crash when starting the camera on specific devices. + - [QTBUG-50282] Fixed QAudioRecorder crashing when trying to start it + with invalid settings. + +iOS / OS X +---------- + + - Greatly improved performance of displaying camera frames using the QML + VideoOutput type on iOS. + - Camera capture previews from the imageCaptured() signal are now in higher + resolutions. + - QMediaPlayer::isSeekable() (and QML counterpart) now correctly reports + the seekable status. + - QAudioRecorder::setVolume() is now functional. + - [QTBUG-45570] Fixed media player playback rate not working when set + before calling play(). + - [QTBUG-48057] Media player now correctly seeks as soon as playback starts + when the position is changed before calling play(). + - [QTBUG-48154] Fixed media player volume not working when set before + loading a media. + - [QTBUG-49170] It is not necessary anymore to set a viewfinder on a + QCamera to be able to query the supported viewfinder settings. + - [QTBUG-49170] Fixed QCamera ignoring the resolution set in + QCameraViewfinderSettings. + +Linux +----- + + - QCameraImageProcessing is now functional. + - [QTBUG-49531] Fixed QMediaPlayer not being able to play the same resource + file more than once. + +QNX +--- + + - QAudioRecorder::setVolume() is now functional. + - [QTBUG-49668] Fixed 'loops' property not working for Audio, Video and + MediaPlayer QML types. + +Windows +------- + + - [QTBUG-45593] The DirectShow backend now supports HW-accelerated video + decoding. + - The QML MediaPlayer and Video types previously supported HW-accelerated + video decoding only when using the ANGLE OpenGL implementation. It now + works with desktop OpenGL as well. + - QAudioRecorder::setVolume() is now functional. + - QCameraImageProcessing is now functional. + - Fixed media player volume not working when set before a media is loaded. + - Fixed QVideoFrame::startTime() not returning any value. + - Fixed seek requests never being processed when QMediaPlayer::setPosition() + is called while the media is not playing. + +WinRT +----- + + - Improved camera support: focus, focus lock and video probe APIs are now + functional. + - [QTBUG-47465] Fixed camera viewfinder aspect ratio. + - [QTBUG-47809] Fixed camera frames being upside down after switching + between front and back cameras. + - [QTBUG-48331][QTBUG-49660] Fixed camera viewfinder frames not being + displayed on the Lumia 930 and 1520. + - [QTBUG-48534] Fixed QCamera::searchAndLock() blocking the UI. + - [QTBUG-48569] Fixed crash when resuming an application that uses the + camera. + - [QTBUG-48672] Fixed crash when mapping camera frames after the camera + has stopped. + - [QTBUG-49236] Fixed playback of local files. + - [QTBUG-49347] Fixed crash when the application is suspended while + a camera focus lock is in progress. diff --git a/dist/changes-5.6.1 b/dist/changes-5.6.1 new file mode 100644 index 0000000..df0e3c1 --- /dev/null +++ b/dist/changes-5.6.1 @@ -0,0 +1,64 @@ +Qt 5.6.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + https://doc.qt.io/qt-5.6 + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +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. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-51911] fixed camera frames appearing flipped for a brief moment + when starting or stopping a video recording. + +iOS / OS X +---------- + + - Fixed the camera resolution incorrectly being changed when switching + to image capture mode. + +Linux +----- + + - PulseAudio: fixed playback of short streams never starting with + QAudioOutput in pull mode. + - [QTBUG-40823][QTBUG-49461] changing the volume of a QAudioOutput or + QAudioInput doesn't affect the system volume anymore. + - [QTBUG-51607] fixed camera not working when QT_NO_GLIB is set. + +QNX +--- + + - Fixed video playback in VMWare. + +Windows +------- + + - The DirectShow backend is now available on Windows CE. + - [QTBUG-49281] fixed a memory leak when stopping the camera. + - [QTBUG-53114] QMediaPlayer can now load UNC paths. + +WinRT +----- + + - [QTBUG-38802] the manifest now automatically includes permissions for + microphone and camera when a project contains QT += multimedia. + - [QTBUG-47803] fixed camera image capture signals not being emitted when + the first capture is done. diff --git a/dist/changes-5.6.2 b/dist/changes-5.6.2 new file mode 100644 index 0000000..72a4af9 --- /dev/null +++ b/dist/changes-5.6.2 @@ -0,0 +1,90 @@ +Qt 5.6.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0 and 5.6.1. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Fixed QMediaPlayer never starting the playback of a playlist containing + an invalid media as first item. + - [QTBUG-54710] The header of WAV files recorded with QAudioRecorder now + have the correct size. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Fixed a memory leak when restarting a QAudioOutput in push mode. + - The camera viewfinder no longer stops after an image capture fails. + - [QTBUG-48975] Calling QCameraImageCapture::capture() several times in a + row in a short amount of time now correctly triggers the imageCaptured() + signal the same amount of times. + - [QTBUG-53536] fixed a crash when trying to load a Camera while it is + already being used by another application. + - [QTBUG-54340] fixed a memory leak when changing a media player's source + on Android 4.1 or higher. + - [QTBUG-54709] fixed a deadlock when capturing camera images on some + devices and on the emulator. + +iOS / OS X +---------- + + - Fixed the orientation of recorded videos. + - [QTBUG-40338] QMediaRecorder now supports video, audio and container + settings. + - [QTBUG-49578] Fixed QMediaPlayer never notifying the EndOfMedia status + when playing a QMediaPlaylist. + - [QTBUG-54890] fixed a possible crash when deleting a QCamera while a + video recording is ongoing. + +Linux +----- + + - Fixed QAudioDeviceInfo::availableDevices() not including PulseAudio + devices added or removed after the application has started. + - [QTBUG-48982] fixed QSoundEffect playing both old and new sources on + the first call to play() after having changed the source. + +QNX +--- + + - Fixed a bug that would cause QMediaPlayer to start at the wrong position + after loading a new media. + +Windows +------- + + - [QTBUG-41573] fixed a possible deadlock when capturing a camera image. + - [QTBUG-46899] fixed resource files not being played by QMediaPlayer + - [QTBUG-54504] fixed a possible deadlock when deleting a QMediaPlayer + right after playback starts. + +WinRT +----- + + - [QTBUG-49578] Fixed QMediaPlayer never notifying the EndOfMedia status + when playing a QMediaPlaylist. + - [QTBUG-53722] fixed a crash that could occur when switching cameras + on Windows 10 Mobile. diff --git a/dist/changes-5.6.3 b/dist/changes-5.6.3 new file mode 100644 index 0000000..32a581d --- /dev/null +++ b/dist/changes-5.6.3 @@ -0,0 +1,66 @@ +Qt 5.6.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.6.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.6 series is binary compatible with the 5.5.x series. +Applications compiled for 5.5 will continue to run with 5.6. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-55007] Fixed Playlist's documentation to include signals that were + wrongly listed under the Audio element. + +- [QTBUG-54849] Optimized QMediaPlaylistPrivate::readItems() to pass items + to the backend in bulk instead of doing it one item at a time. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Windows +------- + +- Enabled DirectShow plugin on WinCE. + +- Made it possible to build the audio decode service from the WMF as a + standalone service, making it possible to use the audio decode service even + when DirectShow is used as the media player backend. + +- [QTBUG-43765] Fixed setting volume per stream when using multiple + QAudioOutputs. + +- [QTBUG-55359] Added support for MJPEG cameras in DirectShow. + +Android +------- + +- [QTBUG-49578] Fixed mediaStatus signal reporting to work as documented. + +Linux +----- + +- [QTBUG-49578] Fixed mediaStatus signal reporting to work as documented. + +- [QTBUG-50775] Improved handling of missing camerabin plugin. + +QNX +--- + + - [QTBUG-50775] Fixed static linking. diff --git a/dist/changes-5.7.0 b/dist/changes-5.7.0 new file mode 100644 index 0000000..dfa2785 --- /dev/null +++ b/dist/changes-5.7.0 @@ -0,0 +1,67 @@ +Qt 5.7 introduces many new features and improvements as well as bugfixes +over the 5.6.x series. Also, there is a change in the licensing terms. +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.7 series is binary compatible with the 5.6.x series. +Applications compiled for 5.6 will continue to run with 5.7. + +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. + +**************************************************************************** +* Important License Changes * +**************************************************************************** + + This module is no longer available under LGPLv2.1. The libraries are + now available under the following licenses: + * Commercial License + * GNU General Public License v2.0 (LICENSE.GPL2) and later + * GNU Lesser General Public License v3.0 (LICENSE.LGPL3) + + The tools are now available under the following licenses: + * Commercial License + * GNU General Public License 3.0 (LICENSE.GPL3) with exceptions + described in The Qt Company GPL Exception 1.0 (LICENSE.GPL3-EXCEPT) + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Playlist (QML): + * Added new addItems(), insertItems(), moveItem() and removeItems() + methods. + + - CameraImageProcessing (QML): + * Added new brightness property. + + - QCameraImageProcessing: + * Added new brightness property. + + - QPlaylist: + * Added new moveMedia() function. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +tvOS +---- + + - Added support for media player and camera APIs. + +WinRT +----- + + - [QTBUG-42287] Added support for QAudioDeviceInfo, QAudioInput, + QAudioOutput, and QSoundEffect. diff --git a/dist/changes-5.7.1 b/dist/changes-5.7.1 new file mode 100644 index 0000000..d7cf470 --- /dev/null +++ b/dist/changes-5.7.1 @@ -0,0 +1,34 @@ +Qt 5.7.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.7.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.7 series is binary compatible with the 5.6.x series. +Applications compiled for 5.6 will continue to run with 5.7. + +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. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - QCamera::setViewfinderSettings() and all the related functions to query + the supported viewfinder settings are now functional. + +WinRT +----- + + - [QTBUG-55894] The QIODevice passed to a QAudioInput / QAudioOutput is + now written / read from the same thread it was created in. diff --git a/dist/changes-5.8.0 b/dist/changes-5.8.0 new file mode 100644 index 0000000..06b0ad1 --- /dev/null +++ b/dist/changes-5.8.0 @@ -0,0 +1,70 @@ +Qt 5.8 introduces many new features and improvements as well as bugfixes +over the 5.7.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + + http://doc.qt.io/qt-5/index.html + +The Qt version 5.8 series is binary compatible with the 5.7.x series. +Applications compiled for 5.7 will continue to run with 5.8. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + + - Added QAudio::convertVolume() function. + + - QtMultimedia global object (QML): + * Added convertVolume() function. + + - VideoOutput (QML): + * Can now render frames having the YUV 4:2:2 8-bit (UYVY/YUYV) pixel + format. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - Audio volumes passed to a media player are now correctly interpreted + as a linear factor. + +Linux +----- + + - Metadata containing a date information is now correctly returned as a + QDate or QDateTime. + - Added support for QMediaMetaData::CoverArtImage metadata key. + - QVideoProbe is now supported when used with a QCamera. + +OS X +---- + + - Cameras can now support the YUV 4:2:2 8-bit (UYVY/YUYV) pixel format. + +Windows +------- + + - DirectShow: + * Audio volumes passed to a media player are now correctly interpreted + as a linear factor. + +WinRT +----- + + - Cameras can now support the YUV 4:2:2 8-bit (UYVY/YUYV) pixel format. + - [QTBUG-48539] Fixed Camera (QML) focus mode and focus point mode not + being synced with the actual value. + - [QTBUG-48541] Camera flash is now supported. diff --git a/dist/changes-5.9.0 b/dist/changes-5.9.0 new file mode 100644 index 0000000..d85a095 --- /dev/null +++ b/dist/changes-5.9.0 @@ -0,0 +1,74 @@ +Qt 5.9 introduces many new features and improvements as well as bugfixes +over the 5.8.x series. For more details, refer to the online documentation +included in this distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMutlimedia +------------ + + - [QTBUG-45323] Added new supportedModes property in the CameraFlash's QML API + + - [QTBUG-44961] Added new notifyInterval property in the MediaPlayer's QML API. + + - [QTBUG-45289] Added new supportedResolution property in the CameraCaptures's + QML API. + + - [QTBUG-57145] Fixed high dpi scaling with QVideoWidget. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + + - [QTBUG-55992] Added run-time permission checks for the media-recorder, + camera, and audio input. + + - [QTBUG-60115] Fixed crash caused by stale video-frame objects. + + - [QTBUG-56536] Fixed Camera preview orientation on devices running on + Android devices with API level 24 or newer. + +DirectShow +---------- + + - [QTBUG-56415] Added support for audio and video probes in the + mediaplayer. + +GStreamer +--------- + + - Added QT_GSTREAMER_PLAYBIN_AUDIOSINK environment variable, for setting + a custom audio sink to be used together with the media player. + + - Improved the list of default recording formats. + + - [QTBUG-50460] Fixed potential crash when using multiple mediaplayers. + + - [QTBUG-50567] Improved codec support by dynamically compiling the list of + supported codecs through QGstCodecsInfo. + +WinRT +----- + + - [QTBUG-58152] Fixed video playback without autoplay enabled. + + - [QTBUG-57288] Removed support for WinRT 81 and Windows Phone 8.1. diff --git a/dist/changes-5.9.1 b/dist/changes-5.9.1 new file mode 100644 index 0000000..f01a33e --- /dev/null +++ b/dist/changes-5.9.1 @@ -0,0 +1,43 @@ +Qt 5.9.1 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Library * +**************************************************************************** + +QtMultimedia +------------ + +- Fixed overflow in the QML MediaPlayer/Audio items loop counter. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Android +------- + +- [QTBUG-61085] Fixed crash in OpenSL ES input device caused by over-committing + the device with data. + +macOS & iOS +----------- + +- [QTBUG-50588] Fixed the StoppedState signal in the media-recorder, so it's not + emitted before the file has been written. diff --git a/dist/changes-5.9.2 b/dist/changes-5.9.2 new file mode 100644 index 0000000..2601d0c --- /dev/null +++ b/dist/changes-5.9.2 @@ -0,0 +1,42 @@ +Qt 5.9.2 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Qt 5.9.2 Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-62435] Fixed regression that caused the selected device in the + audio input to be tested against the available output devices. +- [QTBUG-61725] Fixed improper locking logic in QSoundEffect (PulseAudio) + that caused a crash if when context creation failed. + +Windows +------- + +- [QTBUG-61817] Fixed crash in the camera caused by stale frame data. + +macOS & iOS +----------- + +- [QTBUG-60329] Made AVFImageCaptureControl work without a preview. +- [QTBUG-61367] Fixed deadlock caused by stopping the camera session + before the image capture thread was done processing. diff --git a/dist/changes-5.9.3 b/dist/changes-5.9.3 new file mode 100644 index 0000000..5682242 --- /dev/null +++ b/dist/changes-5.9.3 @@ -0,0 +1,58 @@ +Qt 5.9.3 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Qt 5.9.3 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-53268] Fixed regression that caused relevant properties of the surface + format to be discarded when the video node was created. +- [QTBUG-62255] Fixed loading of remote m3u files. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-62789] Fixed memory leak in QGstreamerAudioDecoderSession. +- [QTBUG-62245] Fixed input query in V4L code to correctly detect all cameras. +- Fixed memory leak in CameraBinImageCapture. + +QNX +--- + +- Switched to mmr_event_t based metadata retrieval, as PPS based retrieval is no + longer supported by Multimedia for QNX 7.0.0. + + +Android +------- + +- [QTBUG-51213] The scan line for the video surface format is now correctly + set to bottom-up. + +WinRT +----- + +- [QTBUG-63308] Added permission check for the camera. diff --git a/dist/changes-5.9.4 b/dist/changes-5.9.4 new file mode 100644 index 0000000..7aaaedb --- /dev/null +++ b/dist/changes-5.9.4 @@ -0,0 +1,57 @@ +Qt 5.9.4 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Qt 5.9.4 Changes * +**************************************************************************** + +QtMultimedia +------------ +- [QTBUG-64407] Fixed memory leak in QSoundEffect. The sample cache didn't + release all the resources that where allocated by its worker thread. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Windows +------- + +- [QTBUG-51405] Fixed bad rendering when a video widget got overlapped by + a MDI subwindow. +- [QTBUG-64044] Fixed calculation of pixel aspect ratio due to precision loss. +- [QTBUG-52713] Fixed memory leak in the DirectShow filter graph. +- [QTBUG-61407] Fixed video rendering in QML when using ANGLE. +- [QTBUG-54242] Fixed crash in QAudioDeviceInfo::availableDevices() that could + happen if one of the device returned an empty list for its supported formats. +- [QTBUG-35916] Removed unneeded delay in the audio output, which caused an + unnecessary long wait when stopping the QSoundEffect. +- [QTBUG-53534] Fixed potential deadlock in the media player when attempting + to load a new resource while the media player was in loading state. + +iOS +--- +- [QTBUG-37955] Fixed front facing camera's orientation. + +Android +------- +- [QTBUG-52366] Fixed a crash in the camera the could happen when an + application got suspended while it still was processing a captured image. +- [QTBUG-64764] Fixed regression that would cause the video output to be shown + upside down. diff --git a/dist/changes-5.9.5 b/dist/changes-5.9.5 new file mode 100644 index 0000000..0b8bc2e --- /dev/null +++ b/dist/changes-5.9.5 @@ -0,0 +1,45 @@ +Qt 5.9.5 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Qt 5.9.5 Changes * +**************************************************************************** + +QtMultimedia +------------ + +- [QTBUG-62155] Improved rendering of YUVY and UYVY texture frames. + + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +Linux +----- + +- [QTBUG-66196] Fixed regression in Camera that caused GST_STATE_PLAYER to + never be set. +- Fixed udpsrc timeout setting in gstreamer, as the unit changed from mirco- + to nanoseconds in gstreamer 1.0. + +macOS / iOS +----------- + +- [QTBUG-49558] Fixed duration reporting when playing HTTP content. diff --git a/dist/changes-5.9.6 b/dist/changes-5.9.6 new file mode 100644 index 0000000..1b86549 --- /dev/null +++ b/dist/changes-5.9.6 @@ -0,0 +1,34 @@ +Qt 5.9.6 is a bug-fix release. It maintains both forward and backward +compatibility (source and binary) with Qt 5.9.0 through 5.9.5. + +For more details, refer to the online documentation included in this +distribution. The documentation is also available online: + +http://doc.qt.io/qt-5/index.html + +The Qt version 5.9 series is binary compatible with the 5.8.x series. +Applications compiled for 5.8 will continue to run with 5.9. + +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. + +**************************************************************************** +* Qt 5.9.6 Changes * +**************************************************************************** + + - This release contains only minor code improvements. + +**************************************************************************** +* Platform Specific Changes * +**************************************************************************** + +WinRT +----- + +- [QTBUG-63016] Avoided crash when QImage is being destroyed within capturing. +- [QTBUG-63014] Fixed rotation of camera image. diff --git a/examples/CMakeLists.txt b/examples/CMakeLists.txt new file mode 100644 index 0000000..76d0158 --- /dev/null +++ b/examples/CMakeLists.txt @@ -0,0 +1,11 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_examples_build_begin(EXTERNAL_BUILD) + +add_subdirectory(multimedia) +if(QT_FEATURE_spatialaudio) + add_subdirectory(spatialaudio) +endif() + +qt_examples_build_end() diff --git a/examples/examples.pro b/examples/examples.pro new file mode 100644 index 0000000..3cda360 --- /dev/null +++ b/examples/examples.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs + +SUBDIRS += multimedia spatialaudio diff --git a/examples/multimedia/CMakeLists.txt b/examples/multimedia/CMakeLists.txt new file mode 100644 index 0000000..dbe9b5f --- /dev/null +++ b/examples/multimedia/CMakeLists.txt @@ -0,0 +1,20 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(TARGET Qt::Widgets) + if(NOT ANDROID AND NOT IOS) + qt_internal_add_example(audiodevices) + endif() + qt_internal_add_example(audiooutput) + qt_internal_add_example(audiorecorder) + qt_internal_add_example(audiosource) + qt_internal_add_example(camera) + qt_internal_add_example(player) + qt_internal_add_example(videographicsitem) + qt_internal_add_example(videowidget) + qt_internal_add_example(screencapture) +endif() +if(TARGET Qt::Quick) + qt_internal_add_example(declarative-camera) + add_subdirectory(video) +endif() diff --git a/examples/multimedia/audiodevices/CMakeLists.txt b/examples/multimedia/audiodevices/CMakeLists.txt new file mode 100644 index 0000000..b8be47b --- /dev/null +++ b/examples/multimedia/audiodevices/CMakeLists.txt @@ -0,0 +1,43 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiodevices LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiodevices") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiodevices + audiodevices.cpp audiodevices.h + audiodevicesbase.ui + main.cpp +) + +set_target_properties(audiodevices PROPERTIES +    WIN32_EXECUTABLE TRUE +    MACOSX_BUNDLE TRUE +    MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiodevices PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +qt_add_ios_ffmpeg_libraries(audiodevices) + +install(TARGETS audiodevices + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiodevices/Info.plist.in b/examples/multimedia/audiodevices/Info.plist.in new file mode 100644 index 0000000..7083ca4 --- /dev/null +++ b/examples/multimedia/audiodevices/Info.plist.in @@ -0,0 +1,47 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSCameraUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiodevices/audiodevices.cpp b/examples/multimedia/audiodevices/audiodevices.cpp new file mode 100644 index 0000000..d211189 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.cpp @@ -0,0 +1,209 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiodevices.h" + +#include +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +// Utility functions for converting QAudioFormat fields into text + +static QString toString(QAudioFormat::SampleFormat sampleFormat) +{ + switch (sampleFormat) { + case QAudioFormat::UInt8: + return "Unsigned 8 bit"; + case QAudioFormat::Int16: + return "Signed 16 bit"; + case QAudioFormat::Int32: + return "Signed 32 bit"; + case QAudioFormat::Float: + return "Float"; + default: + return "Unknown"; + } +} + +AudioDevicesBase::AudioDevicesBase(QWidget *parent) : QMainWindow(parent) +{ + setupUi(this); +} + +AudioDevicesBase::~AudioDevicesBase() = default; + +AudioTest::AudioTest(QWidget *parent) : AudioDevicesBase(parent), m_devices(new QMediaDevices(this)) +{ + init(); +} + +void AudioTest::init() +{ +#if QT_CONFIG(permissions) + // camera + QCameraPermission cameraPermission; + switch (qApp->checkPermission(cameraPermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(cameraPermission, this, &AudioTest::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Camera permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } + // microphone + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &AudioTest::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + m_devices->videoInputs(); + QMediaFormat().supportedFileFormats(QMediaFormat::Encode); + connect(testButton, &QPushButton::clicked, this, &AudioTest::test); + connect(modeBox, QOverload::of(&QComboBox::activated), this, &AudioTest::modeChanged); + connect(deviceBox, QOverload::of(&QComboBox::activated), this, &AudioTest::deviceChanged); + connect(sampleRateSpinBox, &QSpinBox::valueChanged, this, &AudioTest::sampleRateChanged); + connect(channelsSpinBox, &QSpinBox::valueChanged, this, &AudioTest::channelChanged); + connect(sampleFormatBox, QOverload::of(&QComboBox::activated), this, + &AudioTest::sampleFormatChanged); + connect(populateTableButton, &QPushButton::clicked, this, &AudioTest::populateTable); + connect(m_devices, &QMediaDevices::audioInputsChanged, this, &AudioTest::updateAudioDevices); + connect(m_devices, &QMediaDevices::audioOutputsChanged, this, &AudioTest::updateAudioDevices); + + modeBox->setCurrentIndex(0); + modeChanged(0); + deviceBox->setCurrentIndex(0); + deviceChanged(0); +} + +void AudioTest::test() +{ + // tries to set all the settings picked. + testResult->clear(); + + if (!m_deviceInfo.isNull()) { + if (m_deviceInfo.isFormatSupported(m_settings)) { + testResult->setText(tr("Success")); + nearestSampleRate->setText(""); + nearestChannel->setText(""); + nearestSampleFormat->setText(""); + } else { + QAudioFormat nearest = m_deviceInfo.preferredFormat(); + testResult->setText(tr("Failed")); + nearestSampleRate->setText(QStringLiteral("%1").arg(nearest.sampleRate())); + nearestChannel->setText(QStringLiteral("%1").arg(nearest.channelCount())); + nearestSampleFormat->setText(toString(nearest.sampleFormat())); + } + } else + testResult->setText(tr("No Device")); +} + +void AudioTest::updateAudioDevices() +{ + deviceBox->clear(); + const auto devices = + m_mode == QAudioDevice::Input ? m_devices->audioInputs() : m_devices->audioOutputs(); + for (auto &deviceInfo : devices) + deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); +} + +void AudioTest::modeChanged(int idx) +{ + testResult->clear(); + m_mode = idx == 0 ? QAudioDevice::Input : QAudioDevice::Output; + updateAudioDevices(); + deviceBox->setCurrentIndex(0); + deviceChanged(0); +} + +void AudioTest::deviceChanged(int idx) +{ + testResult->clear(); + + if (deviceBox->count() == 0) + return; + + // device has changed + m_deviceInfo = deviceBox->itemData(idx).value(); + + sampleRateSpinBox->clear(); + sampleRateSpinBox->setMinimum(m_deviceInfo.minimumSampleRate()); + sampleRateSpinBox->setMaximum(m_deviceInfo.maximumSampleRate()); + int sampleValue = + qBound(m_deviceInfo.minimumSampleRate(), 48000, m_deviceInfo.maximumSampleRate()); + sampleRateSpinBox->setValue(sampleValue); + m_settings.setSampleRate(sampleValue); + + channelsSpinBox->clear(); + channelsSpinBox->setMinimum(m_deviceInfo.minimumChannelCount()); + channelsSpinBox->setMaximum(m_deviceInfo.maximumChannelCount()); + int channelValue = + qBound(m_deviceInfo.minimumChannelCount(), 2, m_deviceInfo.maximumChannelCount()); + channelsSpinBox->setValue(channelValue); + + sampleFormatBox->clear(); + const QList sampleFormats = m_deviceInfo.supportedSampleFormats(); + for (auto sampleFormat : sampleFormats) + sampleFormatBox->addItem(toString(sampleFormat)); + if (sampleFormats.size()) + m_settings.setSampleFormat(sampleFormats.at(0)); + + allFormatsTable->clearContents(); +} + +void AudioTest::populateTable() +{ + int row = 0; + + for (auto sampleFormat : m_deviceInfo.supportedSampleFormats()) { + allFormatsTable->setRowCount(row + 1); + + QTableWidgetItem *sampleTypeItem = new QTableWidgetItem(toString(sampleFormat)); + allFormatsTable->setItem(row, 0, sampleTypeItem); + + QTableWidgetItem *sampleRateItem = + new QTableWidgetItem(QStringLiteral("%1 - %2") + .arg(m_deviceInfo.minimumSampleRate()) + .arg(m_deviceInfo.maximumSampleRate())); + allFormatsTable->setItem(row, 1, sampleRateItem); + + QTableWidgetItem *channelsItem = + new QTableWidgetItem(QStringLiteral("%1 - %2") + .arg(m_deviceInfo.minimumChannelCount()) + .arg(m_deviceInfo.maximumChannelCount())); + allFormatsTable->setItem(row, 2, channelsItem); + + ++row; + } +} + +void AudioTest::sampleRateChanged(int value) +{ + // sample rate has changed + m_settings.setSampleRate(value); +} + +void AudioTest::channelChanged(int channels) +{ + m_settings.setChannelCount(channels); +} + +void AudioTest::sampleFormatChanged(int idx) +{ + auto formats = m_deviceInfo.supportedSampleFormats(); + m_settings.setSampleFormat(formats.at(idx)); +} + +#include "moc_audiodevices.cpp" diff --git a/examples/multimedia/audiodevices/audiodevices.h b/examples/multimedia/audiodevices/audiodevices.h new file mode 100644 index 0000000..efe4e37 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.h @@ -0,0 +1,46 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIODEVICES_H +#define AUDIODEVICES_H + +#include "ui_audiodevicesbase.h" + +#include +#include +#include +#include + +class AudioDevicesBase : public QMainWindow, public Ui::AudioDevicesBase +{ +public: + AudioDevicesBase(QWidget *parent = nullptr); + virtual ~AudioDevicesBase(); +}; + +class AudioTest : public AudioDevicesBase +{ + Q_OBJECT + +public: + explicit AudioTest(QWidget *parent = nullptr); + +private: + QAudioDevice m_deviceInfo; + QAudioFormat m_settings; + QAudioDevice::Mode m_mode = QAudioDevice::Input; + QMediaDevices *m_devices = nullptr; + +private slots: + void init(); + void updateAudioDevices(); + void modeChanged(int idx); + void deviceChanged(int idx); + void sampleRateChanged(int idx); + void channelChanged(int idx); + void sampleFormatChanged(int idx); + void test(); + void populateTable(); +}; + +#endif diff --git a/examples/multimedia/audiodevices/audiodevices.pro b/examples/multimedia/audiodevices/audiodevices.pro new file mode 100644 index 0000000..5565720 --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevices.pro @@ -0,0 +1,17 @@ +TEMPLATE = app +TARGET = audiodevices + +QT += multimedia + +HEADERS = audiodevices.h + +SOURCES = audiodevices.cpp \ + main.cpp + +FORMS += audiodevicesbase.ui + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiodevices +INSTALLS += target + +QT+=widgets +include(../shared/shared.pri) diff --git a/examples/multimedia/audiodevices/audiodevicesbase.ui b/examples/multimedia/audiodevices/audiodevicesbase.ui new file mode 100644 index 0000000..9618a3d --- /dev/null +++ b/examples/multimedia/audiodevices/audiodevicesbase.ui @@ -0,0 +1,311 @@ + + + AudioDevicesBase + + + + 0 + 0 + 646 + 528 + + + + Audio Devices + + + + + + + + 0 + 0 + + + + true + + + + + 0 + 0 + 626 + 480 + + + + + + + + + Mode + + + + + + + Device + + + + + + + + Input + + + + + Output + + + + + + + + + + + 0 + + + + Test format + + + + + + Test + + + + + + + + + + + + + + Channels + + + + + + + false + + + + + + + false + + + + + + + Sample Format + + + + + + + false + + + + + + + + + + Frequency (Hz) + + + + + + + + 0 + 0 + + + + QFrame::NoFrame + + + QFrame::Plain + + + <i>Actual Settings</i> + + + Qt::RichText + + + Qt::AlignCenter + + + + + + + + 0 + 0 + + + + QFrame::NoFrame + + + QFrame::Plain + + + <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN" "http://www.w3.org/TR/REC-html40/strict.dtd"> +<html><head><meta name="qrichtext" content="1" /><style type="text/css"> +p, li { white-space: pre-wrap; } +</style></head><body style=" font-family:'MS Shell Dlg 2'; font-size:8.25pt; font-weight:400; font-style:normal;"> +<p style=" margin-top:0px; margin-bottom:0px; margin-left:0px; margin-right:0px; -qt-block-indent:0; text-indent:0px;"><span style=" font-style:italic;">Nearest Settings</span></p></body></html> + + + Qt::RichText + + + Qt::AlignCenter + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + + + + + + + + + All formats + + + + + + Populate table + + + + + + + QAbstractItemView::NoEditTriggers + + + false + + + QAbstractItemView::NoSelection + + + QAbstractItemView::SelectItems + + + Qt::ElideNone + + + false + + + false + + + false + + + 3 + + + false + + + true + + + false + + + false + + + + Sample Format + + + AlignCenter + + + + + Frequency (Hz) + + + AlignCenter + + + + + Channels + + + AlignCenter + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/audiodevices/doc/images/audiodevices.png b/examples/multimedia/audiodevices/doc/images/audiodevices.png new file mode 100644 index 0000000000000000000000000000000000000000..419b40f48c19505d554c78dd5107fbe69cd7e33b GIT binary patch literal 37896 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%0A61dvF&C8!JAaxk!(f8@_j@J>1P0_|m|=z9{C+S% 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc b/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc new file mode 100644 index 0000000..1aac6ab --- /dev/null +++ b/examples/multimedia/audiodevices/doc/src/audiodevices.qdoc @@ -0,0 +1,20 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example audiodevices + \title Audio Devices Example + \ingroup multimedia_examples + \ingroup audio_examples + \examplecategory {Multimedia} + \brief Testing the available audio devices and their configuration. + \meta {tag} {widgets} + + \e{Audio Devices} demonstrates how to create a simple application to list + and test the configuration for the various audio devices available on the + target device or desktop PC. + + \image audiodevices.png + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/audiodevices/main.cpp b/examples/multimedia/audiodevices/main.cpp new file mode 100644 index 0000000..411f670 --- /dev/null +++ b/examples/multimedia/audiodevices/main.cpp @@ -0,0 +1,17 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiodevices.h" + +#include + +int main(int argv, char **args) +{ + QApplication app(argv, args); + app.setApplicationName("Audio Device Test"); + + AudioTest audio; + audio.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiooutput/CMakeLists.txt b/examples/multimedia/audiooutput/CMakeLists.txt new file mode 100644 index 0000000..9c279cb --- /dev/null +++ b/examples/multimedia/audiooutput/CMakeLists.txt @@ -0,0 +1,40 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiooutput LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiooutput") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiooutput + audiooutput.cpp audiooutput.h + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiooutput) + +set_target_properties(audiooutput PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(audiooutput PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiooutput + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiooutput/audiooutput.cpp b/examples/multimedia/audiooutput/audiooutput.cpp new file mode 100644 index 0000000..d301d56 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.cpp @@ -0,0 +1,239 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiooutput.h" + +#include +#include +#include +#include +#include +#include + +Generator::Generator(const QAudioFormat &format, qint64 durationUs, int sampleRate) +{ + if (format.isValid()) + generateData(format, durationUs, sampleRate); +} + +void Generator::start() +{ + open(QIODevice::ReadOnly); +} + +void Generator::stop() +{ + m_pos = 0; + close(); +} + +void Generator::generateData(const QAudioFormat &format, qint64 durationUs, int sampleRate) +{ + const int channelBytes = format.bytesPerSample(); + const int sampleBytes = format.channelCount() * channelBytes; + qint64 length = format.bytesForDuration(durationUs); + Q_ASSERT(length % sampleBytes == 0); + Q_UNUSED(sampleBytes); // suppress warning in release builds + + m_buffer.resize(length); + unsigned char *ptr = reinterpret_cast(m_buffer.data()); + int sampleIndex = 0; + + while (length) { + // Produces value (-1..1) + const qreal x = qSin(2 * M_PI * sampleRate * qreal(sampleIndex++ % format.sampleRate()) + / format.sampleRate()); + for (int i = 0; i < format.channelCount(); ++i) { + switch (format.sampleFormat()) { + case QAudioFormat::UInt8: + *reinterpret_cast(ptr) = static_cast((1.0 + x) / 2 * 255); + break; + case QAudioFormat::Int16: + *reinterpret_cast(ptr) = static_cast(x * 32767); + break; + case QAudioFormat::Int32: + *reinterpret_cast(ptr) = + static_cast(x * std::numeric_limits::max()); + break; + case QAudioFormat::Float: + *reinterpret_cast(ptr) = x; + break; + default: + break; + } + + ptr += channelBytes; + length -= channelBytes; + } + } +} + +qint64 Generator::readData(char *data, qint64 len) +{ + qint64 total = 0; + if (!m_buffer.isEmpty()) { + while (len - total > 0) { + const qint64 chunk = qMin((m_buffer.size() - m_pos), len - total); + memcpy(data + total, m_buffer.constData() + m_pos, chunk); + m_pos = (m_pos + chunk) % m_buffer.size(); + total += chunk; + } + } + return total; +} + +qint64 Generator::writeData(const char *data, qint64 len) +{ + Q_UNUSED(data); + Q_UNUSED(len); + + return 0; +} + +qint64 Generator::bytesAvailable() const +{ + return m_buffer.size() + QIODevice::bytesAvailable(); +} + +AudioTest::AudioTest() : m_devices(new QMediaDevices(this)), m_pushTimer(new QTimer(this)) +{ + initializeWindow(); + initializeAudio(m_devices->defaultAudioOutput()); +} + +AudioTest::~AudioTest() +{ + m_pushTimer->stop(); +} + +void AudioTest::initializeWindow() +{ + QWidget *window = new QWidget; + QVBoxLayout *layout = new QVBoxLayout; + + m_deviceBox = new QComboBox(this); + const QAudioDevice &defaultDeviceInfo = m_devices->defaultAudioOutput(); + m_deviceBox->addItem(defaultDeviceInfo.description(), QVariant::fromValue(defaultDeviceInfo)); + for (auto &deviceInfo : m_devices->audioOutputs()) { + if (deviceInfo != defaultDeviceInfo) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + } + connect(m_deviceBox, &QComboBox::currentIndexChanged, this, &AudioTest::deviceChanged); + connect(m_devices, &QMediaDevices::audioOutputsChanged, this, &AudioTest::updateAudioDevices); + layout->addWidget(m_deviceBox); + + m_modeButton = new QPushButton(this); + connect(m_modeButton, &QPushButton::clicked, this, &AudioTest::toggleMode); + layout->addWidget(m_modeButton); + + m_suspendResumeButton = new QPushButton(this); + connect(m_suspendResumeButton, &QPushButton::clicked, this, &AudioTest::toggleSuspendResume); + layout->addWidget(m_suspendResumeButton); + + QHBoxLayout *volumeBox = new QHBoxLayout; + m_volumeLabel = new QLabel; + m_volumeLabel->setText(tr("Volume:")); + m_volumeSlider = new QSlider(Qt::Horizontal); + m_volumeSlider->setMinimum(0); + m_volumeSlider->setMaximum(100); + m_volumeSlider->setSingleStep(10); + connect(m_volumeSlider, &QSlider::valueChanged, this, &AudioTest::volumeChanged); + volumeBox->addWidget(m_volumeLabel); + volumeBox->addWidget(m_volumeSlider); + layout->addLayout(volumeBox); + + window->setLayout(layout); + + setCentralWidget(window); + window->show(); +} + +void AudioTest::initializeAudio(const QAudioDevice &deviceInfo) +{ + QAudioFormat format = deviceInfo.preferredFormat(); + + const int durationSeconds = 1; + const int toneSampleRateHz = 600; + m_generator.reset(new Generator(format, durationSeconds * 1000000, toneSampleRateHz)); + m_audioOutput.reset(new QAudioSink(deviceInfo, format)); + m_generator->start(); + + qreal initialVolume = QAudio::convertVolume(m_audioOutput->volume(), QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + m_volumeSlider->setValue(qRound(initialVolume * 100)); + toggleMode(); +} + +void AudioTest::deviceChanged(int index) +{ + m_generator->stop(); + m_audioOutput->stop(); + m_audioOutput->disconnect(this); + initializeAudio(m_deviceBox->itemData(index).value()); +} + +void AudioTest::volumeChanged(int value) +{ + qreal linearVolume = QAudio::convertVolume(value / qreal(100), QAudio::LogarithmicVolumeScale, + QAudio::LinearVolumeScale); + + m_audioOutput->setVolume(linearVolume); +} + +void AudioTest::updateAudioDevices() +{ + m_deviceBox->clear(); + const QList devices = m_devices->audioOutputs(); + for (const QAudioDevice &deviceInfo : devices) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); +} + +void AudioTest::toggleMode() +{ + m_pushTimer->stop(); + // Reset audiosink + m_audioOutput->reset(); + toggleSuspendResume(); + + if (m_pullMode) { + // switch to pull mode (QAudioSink pulls from Generator as needed) + m_modeButton->setText(tr("Enable push mode")); + m_audioOutput->start(m_generator.data()); + } else { + // switch to push mode (periodically push to QAudioSink using a timer) + m_modeButton->setText(tr("Enable pull mode")); + auto io = m_audioOutput->start(); + m_pushTimer->disconnect(); + + connect(m_pushTimer, &QTimer::timeout, [this, io]() { + if (m_audioOutput->state() == QAudio::StoppedState) + return; + + int len = m_audioOutput->bytesFree(); + QByteArray buffer(len, 0); + len = m_generator->read(buffer.data(), len); + if (len) + io->write(buffer.data(), len); + }); + + m_pushTimer->start(10); + } + + m_pullMode = !m_pullMode; +} + +void AudioTest::toggleSuspendResume() +{ + if (m_audioOutput->state() == QAudio::SuspendedState + || m_audioOutput->state() == QAudio::StoppedState) { + m_audioOutput->resume(); + m_suspendResumeButton->setText(tr("Suspend playback")); + } else if (m_audioOutput->state() == QAudio::ActiveState) { + m_audioOutput->suspend(); + m_suspendResumeButton->setText(tr("Resume playback")); + } else if (m_audioOutput->state() == QAudio::IdleState) { + // no-op + } +} + +#include "moc_audiooutput.cpp" diff --git a/examples/multimedia/audiooutput/audiooutput.h b/examples/multimedia/audiooutput/audiooutput.h new file mode 100644 index 0000000..3a82c57 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.h @@ -0,0 +1,81 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOOUTPUT_H +#define AUDIOOUTPUT_H + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +class Generator : public QIODevice +{ + Q_OBJECT + +public: + Generator(const QAudioFormat &format, qint64 durationUs, int sampleRate); + + void start(); + void stop(); + + qint64 readData(char *data, qint64 maxlen) override; + qint64 writeData(const char *data, qint64 len) override; + qint64 bytesAvailable() const override; + qint64 size() const override { return m_buffer.size(); } + +private: + void generateData(const QAudioFormat &format, qint64 durationUs, int sampleRate); + +private: + qint64 m_pos = 0; + QByteArray m_buffer; +}; + +class AudioTest : public QMainWindow +{ + Q_OBJECT + +public: + AudioTest(); + ~AudioTest(); + +private: + void initializeWindow(); + void initializeAudio(const QAudioDevice &deviceInfo); + +private: + QMediaDevices *m_devices = nullptr; + QTimer *m_pushTimer = nullptr; + + // Owned by layout + QPushButton *m_modeButton = nullptr; + QPushButton *m_suspendResumeButton = nullptr; + QComboBox *m_deviceBox = nullptr; + QLabel *m_volumeLabel = nullptr; + QSlider *m_volumeSlider = nullptr; + + QScopedPointer m_generator; + QScopedPointer m_audioOutput; + + bool m_pullMode = true; + +private slots: + void toggleMode(); + void toggleSuspendResume(); + void deviceChanged(int index); + void volumeChanged(int); + void updateAudioDevices(); +}; + +#endif // AUDIOOUTPUT_H diff --git a/examples/multimedia/audiooutput/audiooutput.pro b/examples/multimedia/audiooutput/audiooutput.pro new file mode 100644 index 0000000..c843f01 --- /dev/null +++ b/examples/multimedia/audiooutput/audiooutput.pro @@ -0,0 +1,12 @@ +TEMPLATE = app +TARGET = audiooutput + +QT += multimedia widgets + +HEADERS = audiooutput.h + +SOURCES = audiooutput.cpp \ + main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiooutput +INSTALLS += target diff --git a/examples/multimedia/audiooutput/doc/images/audiooutput-example.png b/examples/multimedia/audiooutput/doc/images/audiooutput-example.png new file mode 100644 index 0000000000000000000000000000000000000000..1abf5571f067f12b88992ad34d920d891f56b524 GIT binary patch literal 9249 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 + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + app.setApplicationName("Audio Output Test"); + + AudioTest audio; + audio.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiorecorder/CMakeLists.txt b/examples/multimedia/audiorecorder/CMakeLists.txt new file mode 100644 index 0000000..a54d174 --- /dev/null +++ b/examples/multimedia/audiorecorder/CMakeLists.txt @@ -0,0 +1,43 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiorecorder LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiorecorder") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiorecorder + audiolevel.cpp audiolevel.h + audiorecorder.cpp audiorecorder.h audiorecorder.ui + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiorecorder) + +set_target_properties(audiorecorder PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiorecorder PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiorecorder + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiorecorder/Info.plist.in b/examples/multimedia/audiorecorder/Info.plist.in new file mode 100644 index 0000000..43b9665 --- /dev/null +++ b/examples/multimedia/audiorecorder/Info.plist.in @@ -0,0 +1,44 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiorecorder/audiolevel.cpp b/examples/multimedia/audiorecorder/audiolevel.cpp new file mode 100644 index 0000000..444dca9 --- /dev/null +++ b/examples/multimedia/audiorecorder/audiolevel.cpp @@ -0,0 +1,33 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiolevel.h" + +#include + +AudioLevel::AudioLevel(QWidget *parent) : QWidget(parent) +{ + setMinimumHeight(15); + setMaximumHeight(50); +} + +void AudioLevel::setLevel(qreal level) +{ + if (m_level != level) { + m_level = level; + update(); + } +} + +void AudioLevel::paintEvent(QPaintEvent *event) +{ + Q_UNUSED(event); + + QPainter painter(this); + // draw level + qreal widthLevel = m_level * width(); + painter.fillRect(0, 0, widthLevel, height(), Qt::red); + // clear the rest of the control + painter.fillRect(widthLevel, 0, width(), height(), Qt::black); +} + diff --git a/examples/multimedia/audiorecorder/audiolevel.h b/examples/multimedia/audiorecorder/audiolevel.h new file mode 100644 index 0000000..7a42a8d --- /dev/null +++ b/examples/multimedia/audiorecorder/audiolevel.h @@ -0,0 +1,25 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOLEVEL_H +#define AUDIOLEVEL_H + +#include + +class AudioLevel : public QWidget +{ + Q_OBJECT +public: + explicit AudioLevel(QWidget *parent = nullptr); + + // Using [0; 1.0] range + void setLevel(qreal level); + +protected: + void paintEvent(QPaintEvent *event) override; + +private: + qreal m_level = 0.0; +}; + +#endif // QAUDIOLEVEL_H diff --git a/examples/multimedia/audiorecorder/audiorecorder.cpp b/examples/multimedia/audiorecorder/audiorecorder.cpp new file mode 100644 index 0000000..9f63e8c --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.cpp @@ -0,0 +1,329 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiorecorder.h" +#include "audiolevel.h" +#include "ui_audiorecorder.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +static QList getBufferLevels(const QAudioBuffer &buffer); + +AudioRecorder::AudioRecorder() : ui(new Ui::AudioRecorder) +{ + ui->setupUi(this); + + // channels + ui->channelsBox->addItem(tr("Default"), QVariant(-1)); + ui->channelsBox->addItem(QStringLiteral("1"), QVariant(1)); + ui->channelsBox->addItem(QStringLiteral("2"), QVariant(2)); + ui->channelsBox->addItem(QStringLiteral("4"), QVariant(4)); + + // quality + ui->qualitySlider->setRange(0, int(QImageCapture::VeryHighQuality)); + ui->qualitySlider->setValue(int(QImageCapture::NormalQuality)); + + // bit rates: + ui->bitrateBox->addItem(tr("Default"), QVariant(0)); + ui->bitrateBox->addItem(QStringLiteral("32000"), QVariant(32000)); + ui->bitrateBox->addItem(QStringLiteral("64000"), QVariant(64000)); + ui->bitrateBox->addItem(QStringLiteral("96000"), QVariant(96000)); + ui->bitrateBox->addItem(QStringLiteral("128000"), QVariant(128000)); + + // audio input initialization + init(); +} + +void AudioRecorder::init() +{ +#if QT_CONFIG(permissions) + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &AudioRecorder::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + + m_audioRecorder = new QMediaRecorder(this); + m_captureSession.setRecorder(m_audioRecorder); + m_captureSession.setAudioInput(new QAudioInput(this)); + // ### replace with a monitoring output once we have it. + // m_probe = new QAudioProbe(this); + // connect(m_probe, &QAudioProbe::audioBufferProbed, + // this, &AudioRecorder::processBuffer); + // m_probe->setSource(m_audioRecorder); + + // audio devices + m_mediaDevices = new QMediaDevices(this); + connect(m_mediaDevices, &QMediaDevices::audioInputsChanged, this, + &AudioRecorder::updateDevices); + updateDevices(); + + // audio codecs and container formats + updateFormats(); + connect(ui->audioCodecBox, &QComboBox::currentIndexChanged, this, + &AudioRecorder::updateFormats); + connect(ui->containerBox, &QComboBox::currentIndexChanged, this, &AudioRecorder::updateFormats); + + // sample rate + constexpr auto allSamplingRates = std::array{ + 8000, 11025, 12000, 16000, 22050, 24000, 32000, 44100, + 48000, 64000, 88200, 96000, 128000, 176400, 192000, + }; + + QAudioDevice device = m_captureSession.audioInput()->device(); + int minSamplingRate = device.minimumSampleRate(); + int maxSamplingRate = device.maximumSampleRate(); + + for (int rate : allSamplingRates) { + if (rate <= minSamplingRate || rate >= maxSamplingRate) + continue; + ui->sampleRateBox->addItem(QString::number(rate), rate); + } + int preferredRate = device.preferredFormat().sampleRate(); + if (preferredRate > 0) { + int index = ui->sampleRateBox->findData(device.preferredFormat().sampleRate()); + ui->sampleRateBox->setCurrentIndex(index); + } + + connect(m_audioRecorder, &QMediaRecorder::durationChanged, this, + &AudioRecorder::updateProgress); + connect(m_audioRecorder, &QMediaRecorder::recorderStateChanged, this, + &AudioRecorder::onStateChanged); + connect(m_audioRecorder, &QMediaRecorder::errorChanged, this, + &AudioRecorder::displayErrorMessage); +} + +void AudioRecorder::updateProgress(qint64 duration) +{ + if (m_audioRecorder->error() != QMediaRecorder::NoError || duration < 2000) + return; + + ui->statusbar->showMessage(tr("Recorded %1 sec").arg(duration / 1000)); +} + +void AudioRecorder::onStateChanged(QMediaRecorder::RecorderState state) +{ + QString statusMessage; + + switch (state) { + case QMediaRecorder::RecordingState: + statusMessage = tr("Recording to %1").arg(m_audioRecorder->actualLocation().toString()); + ui->recordButton->setText(tr("Stop")); + ui->pauseButton->setText(tr("Pause")); + break; + case QMediaRecorder::PausedState: + clearAudioLevels(); + statusMessage = tr("Paused"); + ui->recordButton->setText(tr("Stop")); + ui->pauseButton->setText(tr("Resume")); + break; + case QMediaRecorder::StoppedState: + clearAudioLevels(); + statusMessage = tr("Stopped"); + ui->recordButton->setText(tr("Record")); + ui->pauseButton->setText(tr("Pause")); + break; + } + + ui->pauseButton->setEnabled(m_audioRecorder->recorderState() != QMediaRecorder::StoppedState); + if (m_audioRecorder->error() == QMediaRecorder::NoError) + ui->statusbar->showMessage(statusMessage); +} + +static QVariant boxValue(const QComboBox *box) +{ + int idx = box->currentIndex(); + if (idx == -1) + return QVariant(); + + return box->itemData(idx); +} + +void AudioRecorder::toggleRecord() +{ + if (m_audioRecorder->recorderState() == QMediaRecorder::StoppedState) { + m_captureSession.audioInput()->setDevice( + boxValue(ui->audioDeviceBox).value()); + + m_audioRecorder->setMediaFormat(selectedMediaFormat()); + m_audioRecorder->setAudioSampleRate(boxValue(ui->sampleRateBox).toInt()); + m_audioRecorder->setAudioBitRate(boxValue(ui->bitrateBox).toInt()); + m_audioRecorder->setAudioChannelCount(boxValue(ui->channelsBox).toInt()); + m_audioRecorder->setQuality(QMediaRecorder::Quality(ui->qualitySlider->value())); + m_audioRecorder->setEncodingMode(ui->constantQualityRadioButton->isChecked() + ? QMediaRecorder::ConstantQualityEncoding + : QMediaRecorder::ConstantBitRateEncoding); + + m_audioRecorder->record(); + } else { + m_audioRecorder->stop(); + } +} + +void AudioRecorder::togglePause() +{ + if (m_audioRecorder->recorderState() != QMediaRecorder::PausedState) + m_audioRecorder->pause(); + else + m_audioRecorder->record(); +} + +void AudioRecorder::setOutputLocation() +{ +#ifdef Q_OS_ANDROID + QString fileName = QFileDialog::getSaveFileName( + this, tr("Save Recording"), + "output." + selectedMediaFormat().mimeType().preferredSuffix()); +#else + QString fileName = QFileDialog::getSaveFileName(); +#endif + m_audioRecorder->setOutputLocation(QUrl::fromLocalFile(fileName)); + m_outputLocationSet = true; +} + +void AudioRecorder::displayErrorMessage() +{ + ui->statusbar->showMessage(m_audioRecorder->errorString()); +} + +void AudioRecorder::updateDevices() +{ + const auto currentDevice = boxValue(ui->audioDeviceBox).value(); + int currentDeviceIndex = 0; + + ui->audioDeviceBox->clear(); + + ui->audioDeviceBox->addItem(tr("Default"), {}); + for (const auto &device : m_mediaDevices->audioInputs()) { + const auto name = device.description(); + ui->audioDeviceBox->addItem(name, QVariant::fromValue(device)); + + if (device.id() == currentDevice.id()) + currentDeviceIndex = ui->audioDeviceBox->count() - 1; + } + + ui->audioDeviceBox->setCurrentIndex(currentDeviceIndex); +} + +void AudioRecorder::updateFormats() +{ + if (m_updatingFormats) + return; + m_updatingFormats = true; + + QMediaFormat format; + if (ui->containerBox->count()) + format.setFileFormat(boxValue(ui->containerBox).value()); + if (ui->audioCodecBox->count()) + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + + int currentIndex = 0; + ui->audioCodecBox->clear(); + ui->audioCodecBox->addItem(tr("Default audio codec"), + QVariant::fromValue(QMediaFormat::AudioCodec::Unspecified)); + for (auto codec : format.supportedAudioCodecs(QMediaFormat::Encode)) { + if (codec == format.audioCodec()) + currentIndex = ui->audioCodecBox->count(); + ui->audioCodecBox->addItem(QMediaFormat::audioCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->audioCodecBox->setCurrentIndex(currentIndex); + + currentIndex = 0; + ui->containerBox->clear(); + ui->containerBox->addItem(tr("Default file format"), + QVariant::fromValue(QMediaFormat::UnspecifiedFormat)); + for (auto container : format.supportedFileFormats(QMediaFormat::Encode)) { + if (container < QMediaFormat::Mpeg4Audio) // Skip video formats + continue; + if (container == format.fileFormat()) + currentIndex = ui->containerBox->count(); + ui->containerBox->addItem(QMediaFormat::fileFormatDescription(container), + QVariant::fromValue(container)); + } + ui->containerBox->setCurrentIndex(currentIndex); + + m_updatingFormats = false; +} + +void AudioRecorder::clearAudioLevels() +{ + for (auto m_audioLevel : std::as_const(m_audioLevels)) + m_audioLevel->setLevel(0); +} + +QMediaFormat AudioRecorder::selectedMediaFormat() const +{ + QMediaFormat format; + format.setFileFormat(boxValue(ui->containerBox).value()); + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + return format; +} + +// returns the audio level for each channel +QList getBufferLevels(const QAudioBuffer &buffer) +{ + QList values; + + auto format = buffer.format(); + if (!format.isValid()) + return values; + + int channels = buffer.format().channelCount(); + values.fill(0, channels); + + int bytesPerSample = format.bytesPerSample(); + QList max_values; + max_values.fill(0, channels); + + const char *data = buffer.constData(); + for (int i = 0; i < buffer.frameCount(); ++i) { + for (int j = 0; j < channels; ++j) { + qreal value = qAbs(format.normalizedSampleValue(data)); + if (value > max_values.at(j)) + max_values[j] = value; + data += bytesPerSample; + } + } + + return max_values; +} + +void AudioRecorder::processBuffer(const QAudioBuffer &buffer) +{ + if (m_audioLevels.count() != buffer.format().channelCount()) { + qDeleteAll(m_audioLevels); + m_audioLevels.clear(); + for (int i = 0; i < buffer.format().channelCount(); ++i) { + AudioLevel *level = new AudioLevel(ui->centralwidget); + m_audioLevels.append(level); + ui->levelsLayout->addWidget(level); + } + } + + QList levels = getBufferLevels(buffer); + for (int i = 0; i < levels.count(); ++i) + m_audioLevels.at(i)->setLevel(levels.at(i)); +} + diff --git a/examples/multimedia/audiorecorder/audiorecorder.h b/examples/multimedia/audiorecorder/audiorecorder.h new file mode 100644 index 0000000..2ce71c1 --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.h @@ -0,0 +1,60 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIORECORDER_H +#define AUDIORECORDER_H + +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE +namespace Ui { +class AudioRecorder; +} +class QAudioBuffer; +class QMediaDevices; +QT_END_NAMESPACE + +class AudioLevel; + +class AudioRecorder : public QMainWindow +{ + Q_OBJECT + +public: + AudioRecorder(); + +public slots: + void processBuffer(const QAudioBuffer &); + +private slots: + void init(); + void setOutputLocation(); + void togglePause(); + void toggleRecord(); + + void onStateChanged(QMediaRecorder::RecorderState); + void updateProgress(qint64 pos); + void displayErrorMessage(); + + void updateDevices(); + void updateFormats(); + +private: + void clearAudioLevels(); + QMediaFormat selectedMediaFormat() const; + + Ui::AudioRecorder *ui = nullptr; + + QMediaCaptureSession m_captureSession; + QMediaRecorder *m_audioRecorder = nullptr; + QMediaDevices *m_mediaDevices = nullptr; + + QList m_audioLevels; + bool m_outputLocationSet = false; + bool m_updatingFormats = false; +}; + +#endif // AUDIORECORDER_H diff --git a/examples/multimedia/audiorecorder/audiorecorder.pro b/examples/multimedia/audiorecorder/audiorecorder.pro new file mode 100644 index 0000000..a0e05cc --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.pro @@ -0,0 +1,24 @@ +TEMPLATE = app +TARGET = audiorecorder + +QT += multimedia + +win32:INCLUDEPATH += $$PWD + +HEADERS = \ + audiorecorder.h \ + audiolevel.h + +SOURCES = \ + main.cpp \ + audiorecorder.cpp \ + audiolevel.cpp + +FORMS += audiorecorder.ui + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiorecorder +INSTALLS += target + +QT+=widgets +include(../shared/shared.pri) + diff --git a/examples/multimedia/audiorecorder/audiorecorder.ui b/examples/multimedia/audiorecorder/audiorecorder.ui new file mode 100644 index 0000000..b53a8ac --- /dev/null +++ b/examples/multimedia/audiorecorder/audiorecorder.ui @@ -0,0 +1,270 @@ + + + AudioRecorder + + + + 0 + 0 + 297 + 476 + + + + Qt Multimedia Audio Recorder + + + + + + + + + Sample rate: + + + + + + + + + + Audio Codec: + + + + + + + Input Device: + + + + + + + File Container: + + + + + + + + + + + + + Channels: + + + + + + + + + + + + + + + Encoding Mode: + + + + + + Constant Quality: + + + true + + + + + + + Qt::Orientation::Horizontal + + + QSizePolicy::Policy::Fixed + + + + 40 + 20 + + + + + + + + Qt::Orientation::Horizontal + + + + + + + Constant Bitrate: + + + + + + + Qt::Orientation::Horizontal + + + QSizePolicy::Policy::Fixed + + + + 40 + 20 + + + + + + + + false + + + + + + + + + + Output... + + + + + + + Record + + + + + + + false + + + Pause + + + + + + + Audio Level: + + + + + + + + + + + + + + constantQualityRadioButton + toggled(bool) + qualitySlider + setEnabled(bool) + + + 113 + 197 + + + 115 + 223 + + + + + constantBitrateRadioButton + toggled(bool) + bitrateBox + setEnabled(bool) + + + 173 + 259 + + + 190 + 291 + + + + + outputButton + clicked() + AudioRecorder + setOutputLocation() + + + 46 + 340 + + + 6 + 302 + + + + + recordButton + clicked() + AudioRecorder + toggleRecord() + + + 191 + 340 + + + 113 + 317 + + + + + pauseButton + clicked() + AudioRecorder + togglePause() + + + 252 + 334 + + + 258 + 346 + + + + + + setOutputLocation() + toggleRecord() + togglePause() + + diff --git a/examples/multimedia/audiorecorder/doc/images/audiorecorder.png b/examples/multimedia/audiorecorder/doc/images/audiorecorder.png new file mode 100644 index 0000000000000000000000000000000000000000..6643bf32057eb9b69a7d28403aaf612cb612368b GIT binary patch literal 28212 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.toString()); + audioRecorder->setMediaFormat(format); + audioRecorder->setSampleRate(boxValue(ui->sampleRateBox).toInt()); + audioRecorder->setBitRate(boxValue(ui->bitrateBox).toInt()); + audioRecorder->setQuality(QMediaRecorder::EncodingQuality(ui->qualitySlider->value())); + audioRecorder->setEncodingMode(ui->constantQualityRadioButton->isChecked() ? + QMediaRecorder::ConstantQualityEncoding : + QMediaRecorder::ConstantBitRateEncoding); + + QString container = boxValue(ui->containerBox).toString(); + + audioRecorder->record(); + \endcode + + While recording, the status bar of the application is updated with duration information + from the \l{QMediaRecorder::durationChanged()}{durationChanged} signal from the + \c audioRecorder object. + + \code + ui->statusbar->showMessage(tr("Recorded %1 sec").arg(duration / 1000)); + \endcode +*/ diff --git a/examples/multimedia/audiorecorder/main.cpp b/examples/multimedia/audiorecorder/main.cpp new file mode 100644 index 0000000..4077296 --- /dev/null +++ b/examples/multimedia/audiorecorder/main.cpp @@ -0,0 +1,16 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiorecorder.h" + +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + AudioRecorder recorder; + recorder.show(); + + return app.exec(); +} diff --git a/examples/multimedia/audiosource/CMakeLists.txt b/examples/multimedia/audiosource/CMakeLists.txt new file mode 100644 index 0000000..756205b --- /dev/null +++ b/examples/multimedia/audiosource/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiosource LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/audiosource") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Widgets) + +qt_add_executable(audiosource + audiosource.cpp audiosource.h + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiosource) + +set_target_properties(audiosource PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +target_link_libraries(audiosource PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Widgets +) + +install(TARGETS audiosource + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/audiosource/Info.plist.in b/examples/multimedia/audiosource/Info.plist.in new file mode 100644 index 0000000..43b9665 --- /dev/null +++ b/examples/multimedia/audiosource/Info.plist.in @@ -0,0 +1,44 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/audiosource/audiosource.cpp b/examples/multimedia/audiosource/audiosource.cpp new file mode 100644 index 0000000..5a1df53 --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.cpp @@ -0,0 +1,257 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiosource.h" + +#include +#include +#include +#include +#include +#include +#include +#include + +#if QT_CONFIG(permissions) + #include + #include +#endif + +#include +#include + +AudioInfo::AudioInfo(const QAudioFormat &format) : m_format(format) { } + +void AudioInfo::start() +{ + open(QIODevice::WriteOnly); +} + +void AudioInfo::stop() +{ + close(); +} + +qint64 AudioInfo::readData(char * /* data */, qint64 /* maxlen */) +{ + return 0; +} + +qreal AudioInfo::calculateLevel(const char *data, qint64 len) const +{ + const int channelBytes = m_format.bytesPerSample(); + const int sampleBytes = m_format.bytesPerFrame(); + const int numSamples = len / sampleBytes; + + float maxValue = 0; + auto *ptr = reinterpret_cast(data); + + for (int i = 0; i < numSamples; ++i) { + for (int j = 0; j < m_format.channelCount(); ++j) { + float value = m_format.normalizedSampleValue(ptr); + + maxValue = qMax(value, maxValue); + ptr += channelBytes; + } + } + return maxValue; +} + +qint64 AudioInfo::writeData(const char *data, qint64 len) +{ + m_level = calculateLevel(data, len); + + emit levelChanged(m_level); + + return len; +} + +RenderArea::RenderArea(QWidget *parent) : QWidget(parent) +{ + setBackgroundRole(QPalette::Base); + setAutoFillBackground(true); + + setMinimumHeight(30); + setMinimumWidth(200); +} + +void RenderArea::paintEvent(QPaintEvent * /* event */) +{ + QPainter painter(this); + + painter.setPen(Qt::black); + + const QRect frame = painter.viewport() - QMargins(10, 10, 10, 10); + painter.drawRect(frame); + if (m_level == 0.0) + return; + + const int pos = qRound(qreal(frame.width() - 1) * m_level); + painter.fillRect(frame.left() + 1, frame.top() + 1, pos, frame.height() - 1, Qt::red); +} + +void RenderArea::setLevel(qreal value) +{ + m_level = value; + update(); +} + +InputTest::InputTest() : m_devices(new QMediaDevices(this)) +{ + init(); +} + +void InputTest::initializeWindow() +{ + QVBoxLayout *layout = new QVBoxLayout(this); + + m_canvas = new RenderArea(this); + layout->addWidget(m_canvas); + + m_deviceBox = new QComboBox(this); + connect(m_deviceBox, &QComboBox::activated, this, &InputTest::deviceChanged); + connect(m_devices, &QMediaDevices::audioInputsChanged, this, &InputTest::updateAudioDevices); + updateAudioDevices(); + layout->addWidget(m_deviceBox); + + m_volumeSlider = new QSlider(Qt::Horizontal, this); + m_volumeSlider->setRange(0, 100); + m_volumeSlider->setValue(100); + connect(m_volumeSlider, &QSlider::valueChanged, this, &InputTest::sliderChanged); + layout->addWidget(m_volumeSlider); + + m_modeButton = new QPushButton(this); + connect(m_modeButton, &QPushButton::clicked, this, &InputTest::toggleMode); + layout->addWidget(m_modeButton); + + m_suspendResumeButton = new QPushButton(this); + connect(m_suspendResumeButton, &QPushButton::clicked, this, &InputTest::toggleSuspend); + layout->addWidget(m_suspendResumeButton); +} + +void InputTest::initializeAudio(const QAudioDevice &deviceInfo) +{ + QAudioFormat format; + format.setSampleRate(8000); + format.setChannelCount(1); + format.setSampleFormat(QAudioFormat::Int16); + + m_audioInfo.reset(new AudioInfo(format)); + connect(m_audioInfo.data(), &AudioInfo::levelChanged, m_canvas, &RenderArea::setLevel); + + m_audioInput.reset(new QAudioSource(deviceInfo, format)); + qreal initialVolume = QAudio::convertVolume(m_audioInput->volume(), QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + m_volumeSlider->setValue(qRound(initialVolume * 100)); + m_audioInfo->start(); + toggleMode(); +} + +void InputTest::initializeErrorWindow() +{ + QVBoxLayout *layout = new QVBoxLayout(this); + QLabel *errorLabel = new QLabel(tr("Microphone permission is not granted!")); + errorLabel->setWordWrap(true); + errorLabel->setAlignment(Qt::AlignCenter); + layout->addWidget(errorLabel); +} + +void InputTest::init() +{ +#if QT_CONFIG(permissions) + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &InputTest::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + initializeErrorWindow(); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + initializeWindow(); + initializeAudio(QMediaDevices::defaultAudioInput()); +} + +void InputTest::toggleMode() +{ + m_audioInput->stop(); + toggleSuspend(); + + // Change between pull and push modes + if (m_pullMode) { + m_modeButton->setText(tr("Enable push mode")); + m_audioInput->start(m_audioInfo.data()); + } else { + m_modeButton->setText(tr("Enable pull mode")); + auto *io = m_audioInput->start(); + if (!io) + return; + + connect(io, &QIODevice::readyRead, [this, io]() { + static const qint64 BufferSize = 4096; + const qint64 len = qMin(m_audioInput->bytesAvailable(), BufferSize); + + QByteArray buffer(len, 0); + qint64 l = io->read(buffer.data(), len); + if (l > 0) { + const qreal level = m_audioInfo->calculateLevel(buffer.constData(), l); + m_canvas->setLevel(level); + } + }); + } + + m_pullMode = !m_pullMode; +} + +void InputTest::toggleSuspend() +{ + // toggle suspend/resume + switch (m_audioInput->state()) { + case QAudio::SuspendedState: + case QAudio::StoppedState: + m_audioInput->resume(); + m_suspendResumeButton->setText(tr("Suspend recording")); + break; + case QAudio::ActiveState: + m_audioInput->suspend(); + m_suspendResumeButton->setText(tr("Resume recording")); + break; + case QAudio::IdleState: + // no-op + break; + } +} + +void InputTest::deviceChanged(int index) +{ + m_audioInput->stop(); + m_audioInput->disconnect(this); + m_audioInfo->stop(); + + initializeAudio(m_deviceBox->itemData(index).value()); +} + +void InputTest::sliderChanged(int value) +{ + qreal linearVolume = QAudio::convertVolume(value / qreal(100), QAudio::LogarithmicVolumeScale, + QAudio::LinearVolumeScale); + + m_audioInput->setVolume(linearVolume); +} + +void InputTest::updateAudioDevices() +{ + m_deviceBox->clear(); + const QAudioDevice &defaultDeviceInfo = QMediaDevices::defaultAudioInput(); + m_deviceBox->addItem(defaultDeviceInfo.description(), QVariant::fromValue(defaultDeviceInfo)); + for (auto &deviceInfo : m_devices->audioInputs()) { + if (deviceInfo != defaultDeviceInfo) + m_deviceBox->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); + } +} + +#include "moc_audiosource.cpp" diff --git a/examples/multimedia/audiosource/audiosource.h b/examples/multimedia/audiosource/audiosource.h new file mode 100644 index 0000000..4b2ca02 --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.h @@ -0,0 +1,95 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef AUDIOINPUT_H +#define AUDIOINPUT_H + +#include +#include + +#include +#include +#include +#include + +#include + +#include +#include + +class AudioInfo : public QIODevice +{ + Q_OBJECT + +public: + AudioInfo(const QAudioFormat &format); + + void start(); + void stop(); + + qreal level() const { return m_level; } + + qint64 readData(char *data, qint64 maxlen) override; + qint64 writeData(const char *data, qint64 len) override; + + qreal calculateLevel(const char *data, qint64 len) const; + +signals: + void levelChanged(qreal level); + +private: + const QAudioFormat m_format; + qreal m_level = 0.0; // 0.0 <= m_level <= 1.0 +}; + +class RenderArea : public QWidget +{ + Q_OBJECT + +public: + explicit RenderArea(QWidget *parent = nullptr); + + void setLevel(qreal value); + +protected: + void paintEvent(QPaintEvent *event) override; + +private: + qreal m_level = 0; +}; + +class InputTest : public QWidget +{ + Q_OBJECT + +public: + InputTest(); + +private: + void initializeWindow(); + void initializeAudio(const QAudioDevice &deviceInfo); + void initializeErrorWindow(); + +private slots: + void init(); + void toggleMode(); + void toggleSuspend(); + void deviceChanged(int index); + void sliderChanged(int value); + void updateAudioDevices(); + +private: + // Owned by layout + RenderArea *m_canvas = nullptr; + QPushButton *m_modeButton = nullptr; + QPushButton *m_suspendResumeButton = nullptr; + QComboBox *m_deviceBox = nullptr; + QSlider *m_volumeSlider = nullptr; + + QMediaDevices *m_devices = nullptr; + QScopedPointer m_audioInfo; + QScopedPointer m_audioInput; + bool m_pullMode = true; +}; + +#endif // AUDIOINPUT_H diff --git a/examples/multimedia/audiosource/audiosource.pro b/examples/multimedia/audiosource/audiosource.pro new file mode 100644 index 0000000..35105da --- /dev/null +++ b/examples/multimedia/audiosource/audiosource.pro @@ -0,0 +1,13 @@ +TEMPLATE = app +TARGET = audiosource + +QT += multimedia widgets + +HEADERS = audiosource.h + +SOURCES = audiosource.cpp \ + main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/audiosource +INSTALLS += target +include(../shared/shared.pri) diff --git a/examples/multimedia/audiosource/doc/images/audiosource-example.png b/examples/multimedia/audiosource/doc/images/audiosource-example.png new file mode 100644 index 0000000000000000000000000000000000000000..fb703e68c39ea2bafe8d58caf9f7d374f11e6076 GIT binary patch literal 10383 zcmYjXWmFtNmxTZWAwbaJL4yPf9-QD1+}&LR4DJ>jf;$8W1b26b;1=AO;6CUe+kD?S zyZfWNPghq}S9R69@80)1Tv1*U9hC?b4h{}oT1reAxNZSQDGCTUdr1mA1DDs|q_lu5 zM&HW;pTvMc3=~p>#WlfVX3i!~R^Px@4)$;wR`#Y2Zsel2M$XQ>fmPaP;Tys^#SIJvb>M>%7G^*CB0l^Vu|yYB)-E^% zwBEAz`DQ<`o1Dh!Dtj--x9s&w^OgyotL#Skc8B)e%#w=yjluTXzhU`Bc2C3D;RWF+ z!tfVtDz|=qBo(*+tPGw``3&9!O$|-7;2NpPQ4>=v;_6pnbFf-kNB*1xgAP>36$MVL zwHw}3h(-RnDGp;-PS|xHpH$jEnEfEW(0_uMfocV!UA{>%!3?x&)ceQ9^o`G`am$vC zt!6)&$}*+Ukj?#CJ+TS{{|Ej@fxt4Fc`TE3W&x4(pAe@7$!KC>^Tg!}l9Y3H$w zjsP9RRc4@IZ*T8k=8u5=Dr0s0JOVX>5B#&K=`(p}OH2C2h1135rL>&%Ya)uo0a9V5 zz`~GO_(1(n#^Dj0dFg&FG~9nKIy_p|0v!q)y*~w^NxtDT8nSljN8~C^G8v3fQq+`! zwebtF2BxPIHKOl8;{#gY2^`*HE`kal288Zu5!vnI~DB@4%{F=RsW zp)sWU3&kq_M>9nV&bN~kFQbr=$FNrL*hgiCmn_1v9tpQM#V25VHM9Mf-6;h)M*fEP~b_j0sG~ z@)H4AXDYIpQK*U}sM~*vR)8o|o;LI?S)q^{LRz>U7c1YD))dx!Nt<;(gGuRSNq1)bZt&@BHA0U`)2;nx z%%B%5bTtrHO^;dM^Sqz^BzWV5?Y*FP>Ko=g+$?nP$x#D*5xcvd;O8uP3{rlnlnTAP z_|~qv$LwmNqQW0tJB=IU4**jpDP*0q(y#j^K|~9GZ>`q!iqx{SmLIiwYFAw2IN2s3byAtmIrK z7595GPK1iL_P@B3TA$PAfQF`dGLhGvdfYDEILJb0z$lKoYc*FuhJIyFYc8Ib z8(n1$^?_X*)h-gDGodl3M3$6%yjZT!&&`Do?ZtAmv9u%?63Qu=DROMqZTWs9L@`yk zKP}4hoA&W!{W*rAvMt`I_xt$Kn#MuXP_;EK_eu0dI%z&oo~) zx_z>qmFie*BZSKslemeuf4HiA?k9UbLmqg(!1u1T!a?Z-iuqqz~uwn z1pgxkS4Q+}?$seZwddx4eD-dhlhuYjSe~H z2p)HLs%mP@77L=8+$kgCbNe$pkbj_s`L>(&-S5N|+x7GMZ|W)oUzL=UfUhA6pO&+D z?TD5e9d;{Ko+J8=H-~9+3?YA#_|Iom(vNz2df=9?XltlmwYnYWH8l}rtX8;)&&XNH zlJX>3dvOAQVY}X;H@}xF|GT7wLzB^v12GsJ+B@Fy2zxbsg93u0K{dmLV-IZPtxU=8qYzG_Inbdv5-a8-$$3y4`taJdB;}-JDpWqW0yA z-+d1=R?aI5>5Y)-_I$?PdF^}I3|^+6nQ#XO2Tk_}r5@X44s2JIDrr2Igk#+=g$E_2 zcd(5T%X)dh*x}WPKzsw2R5rz3=9T+Zq^5Z&5>6d0E+ClL!eO9V`lWNA;sW3o$!j? zHE_@Fobb(RT=Pt5b{KtKRSAkjO3`q|Bz7*g_CMlqCL&|f?iTfdHBhg#LM4;=ty2zStT5ZJwnoPb*)9lk&CS-VM>V zRK23dx*n;ZRre!CX#RN#c6m_0^506Gy+`Ot>$5SiLz~SX-2YZSN35E8y)wNWS*-J5 zr;>=GW?*>Jx;oC(xPo05BbUL&`f#zi1A%OQ`+PfB>DRAeQ2vJ3o+D#SS6e$`1d;~} z!FRenGh$+)rw<3LVbiIZj-I~T@YA=mjZT-rQWqbA7Eh|k8E1L#E1c@jKNWOt4f+D> z+h;aWssaX!6pHL5Kq`f@n|1+Ahb1Txznun8L7SU0qx_xmtrpWWLf1>B{GH_yE4Vq-4f(QQo2s zO9^omS3Fm*)pfy^i`VrCrKz$+tw9?oqAo>@>=%JuAH(zOp9&atLjq93JlE_l5{H{~ z$GiA5#sq@)4i9^nR4j<{s+sk4-{sEq{Bl@m3J{NcS8cc%>fPqfnn1G}bKpdQNeAku z6={tfUXG8*Gh`zaFwqX^ww$bYG7(t&=al07?7&ZTVr)MsB_kuErUrNhG>~fjRI}=w zUBTLfd{HaR_H1u22{MQE%=PA*V9w>c4gcJWhiR9=snnC`p^n|giiTvjwL4m^G%eZG zZ|w3#K}c`#rzaIFYvCL3ESY9Bi@3*d(7eqM+JsIKcwG*L6og30X=yXW$$Vs$YlbH} zylIQCTp7;BBMz?`mhB#ntF6lPT9bc`B%g1`n(<#u=2R_}QJBJD!Ng-&At)=D_N}L@ zt=y6^B;7~NJ{zumyukOW`_Gkc0vPM(^c-OnbwgW#=7 zN}LX6>6POXSm{8I1;OL*gPGCSIrOx085l$o@p@KCk0x^wBJw6DC%cMrd`hy4Mx$f_ z3;e977mZovd1YPBikzHWW7I2A#zidB6#-#@q8}GqO#b{*rqh^=Ln}{-*akcCdU)9F zy~1LZ0z(HOPUlmSk#GxDMgpLq0C`frxTG}5-|7-n3dB64xSbu-EcDsAIj6miP7hd?8v(B=-RVTe#1s`|c6N5pmYjzN zDQN2VBBAdUA?^p^YX=&+0+T@u!1x9?zbQH%5u|CQJv`mGArGnJipn;?mJTbc?=l>2 z_qO{1gQ>Qhk~~`N%tIE?`zJp2nrh;+d{Pua^+Zdbic9D-?Gl2UDgW8=Lr(nu623E3)1zZm&jQ*g|CSofP?W?IT&;qkutH&59_x(GCkhkxGighMP{3~uKSMs zpb-6CEI0;S-1l-Nt8~gq_>|?H1`dr1pGLw|Nu2o?m|P0#Rvn=%t;Rhe7%D1kL2UNx~5 z^l%jT^DiMgJ^kS6Bs>)*V3pnZz{mE_Atos3ODnkt+5CkB(t4X}En(>#YE#Y?r$=@v zp2!9i%nGlptWvF2{*w-1VwNz52oXSwxVDl4Y@qY&z4G<8z8%^rn77`(cFJ-VikaxeAeL?Fp;7_Yb<$*OgF$bJ)|z%uz2c7pt9V)k~A?S6h@-^zvKxtz=~K?3U4d85w%_!A{*s z_=a2=_1~w&IZ>iq*V+t~COg{H??j41 zZ?Kq8EreUkw_;}?)|nSK6V9K(Z)Jjy;6k0Nr0%|408}3d3F&B|gEX=qdky6KfCZ4A z6lOgz*9OaS#t8#oyiZb665#Ci7HetEPm$&ovK>hE7x~;y`i!d$KM}k#)yU=zS=}tK zt%Nn`$G#WfXh$&hx;nRG+~mgJLdT8B`%wzs3XvzSPg4?Cs?uZxkYvlL`Szh!fsn(! z3dZ_b4^PJ5Hep!m%NKY6FZa$U1fOnkK+r=;eP1uM2za&Msw6_=B}t`w%Z)6nttpC% zKTbV9H=dW2+|C6|Yt~}3t?n+$K7+?7L*IB@Z{24qG!cwgY%0O>XxU_nsyP;HMD&bw!fJXCuyy3SorHZ?RWY7mTmw3vIC?sii9)1 zt&P8ijh&cS+PxB^!{zle;)G-l*p6&-yWk#tGq|zeec|nl*B%Pmu}J~>`2FE#_*v%1 z{@q!%^uy$9QJA4+D5@-~0oO)Mb(rA9UVT6v*hzq^>KH~=rCF9bRt%sXyVI=Y#pMNn zgOksU%)vOGLVHIH^Ya~LsVXY;%*@7pQjI=l=B5&mVErf>oDd|Wf}&q>2^pexa_Bk@ zw*AKSKhmuWn|}WoVd=~S1`EJsosr~c*){8xRpQ5DW=2Ni{tL*`t)$Ax3`E7hu8so) zC7UGR2$Y|8pMDsRoU)`|p2=xgwgn$gNde`x>218mpL?s7|)YyVJg8%F=0B zSONqn17^LJ4P`Yn5W@ccegQSD2?votBfp57w9A$IMU({2;v!Go*bsQ+WJTP;fc}JV z!B8PMq+AjOc%-GZSZ8v}Wpv;^eaoBTwKD^?sXRN6K@~sJL_yqe@S+WZFBfhk!hs_0O>p{@RQkkcIT%mU zji5;4#e<*OW>y({(Jw0qmB7N*X)tD)4UwtShq}H=GZRONb^eFTyan3AHUbj1!Zz|d z;SB;-vF0!s2Nl+@Mq$$^E|vvZ*EadRoLv}Bk>NO|l784_-l8V1LUKq6xBG5AVHPX7 zwM2yZ7#@87=$qXi!e{)QkAeS?>GMB?I@h7dFWGX4s-kIg>F?U+C2(@GYzZ1=e$v&E z(BU$K5`+KAQO0pF6#F*HFPdcOi^N3W5QX1|*y$MH7r2omd$Cf4+5fX#)8jrNe zD6NgANQqFaZ_&h2le|n9QJ6PREFMluGEoW}ZvUl&jmts@o?iO6O!~Gbnsq2s95v?u ztJrr{5@o608Ye|PMMd?}GPUcnpxEM_q+kJ4TphntzacRDxc|)lKds1zM)G$Elqjt{ zpq*$Kw;{fD&YZ;D_NLG99>k)Q=hO9H@j>WBxN2I@v@+W*v3o8(p-<2vch?jt?Bts@ zzZ@MJ*)W^+vXAuHOG`}+(m1pO zt6x>^GpkisZZ9L7%DPUjWkpTbALd(6+3vEv_MD~t8f>3ibCI0OPM53_C7jx5q0UjDq=YiKM7&hfN=DIo`aaCS;Z{aMY?!CJt6Nmy z+S{BmPe?8z3<3GAS+9o8c7-mbG%lBSJr@?Gu{R5Wey4qOR9L)oAVu$YucJFzaWS98 zCWB^{V8fxR%`%_t(n~`|F*4U4rYru<{Dq(r7F{-#e+lW!hM75NzqZD)TwiU`!M-#n7c1 zvo{DJv`L>EmU-D2f(*wLWylamjZGyHZ8R5QhC(5-1pPObLC?fwcKL7Y%Sa!u zM4cw1FzQdQN~^Mx)+B>wZ>u9dz`6$hK)$ZVPzOqiv1D-Bp{9{VQgLx;E;Jl_iG>CT zRmUSgU$79oqA=aBK7Q16)Q_!5fzf_|9_+20u$m9$21paGu+-ShJb_65n?~l87xB z@wm}if50Cz!BNxFO5$!khCJb!42YdJV-IU}#eXnxnp4vls6U-H8_Dz4lK^Dza>w&~ zUbL-kIppobbWaBD7F#X;*00pBBfBlbmMcs=ETR`}3mtMgj!NF9az>XM@LNv)Y+4(m zh?9atGz0VkMPBC ze@e5&#!FG3V{bu}swp*s;-#Q{7pBoda@yzzo1yO`N|nQRba&Fy*aL3WgCcBd23mcf>@nooXKPJ$~?~FCBMf}0)ZIfrcX3g_X$`iw88RL+^mAi%iCFaCDZ5=uJf(k@d zEmQ;Ny#3!!{Su|dCAT~v9Vs-clQ*sk6E}9ZXPb#hNg<=1TM-Nk9X?*AhlJ%F7ET#= zqp~mI1NHg*<_34GX`PjH<@2V6eACoFVhetll25qL1jFv>ha;Bv2`MV3+IJqe5w3>$?+M(Nm$= z@>^E3u@z}rmo#Qes~fZYWO+v=8D%)0$@5^oP{ZDUh^ zVP<9~o5>LufPn0DHK%dD8A@jD!RLCkaZhY-xHp+Ao6Vn=zC@J8)ITj4-oObl#=bek zZ69}Uu$?483bgM!S@lZ2yeAR7x5R=#Al~=GwAxP-%qQJ#9+#S(z5u}%pw{U0udkv9 zbvEz(i%Iv=^nMl%KnBZdCONxnBfm@O{TtOl|tFT=zX+4%Ok z>81llz-3Bz__usJ&BFX*lwF|~06Y>5u9o?4-pkV9952;x z|I47Q0&9H}MQGYD%=korMi(2b760;ejjiBRxH^-+FV9>}KoR=b@32d?3iZ z(}OuK>5@$^MNQLxyAQ4 zI}y?wiNIdS&{v(qf+vTr@+g1f&V>)PlJ+Op3PTQNR+ zpEZ%C!3`~v&F%?{qpCl(TPiq=p02nBb;}#-1 z`jxh?K8*j^8AvwCXO+wjzkBuZV~kPba`X8BaXk13n?yy=CM<)x)x!vVH8HO!eN3q&Q4z3l8r&1wGNXaqLJt?FOm_b5 z{K(1}D^^i!@s!Wv760N3FVZ(J7%rv)o^2_l9AM4Ev{*Ndo;m5VuD8w@Grvqzgx?f8 zyCyNw(<7y)AI8PS{aNynn9Fu!BUe=0!@qIeHxfwq0eFxG8z7D%WTz2!ozNGs%82VO z)2am|?eCI53PO*4F{FHf2WV&4I;V8*V@AIq_~kw^3Dt48>8E>D5Z` zv3T7an*fnkAo~Q!@8aU(-z5xN)!(Ok0r5eunsXsSj`+JoX5zhoG-uJpzl`UueQ=HQ zuDsy$gL4IeGm?N8R7_3nZ@C_jo*@B}TJ<*b*1UsD008xGg*`pF>I*<0Z=w7Af<7(R z?Or!0Kx~+A$xV-Y!a}>#drWKWniOp?(g!=!F2-NOk1PJ|E| zI5_0}mwy4Ao-YHC)1GeEQ#%a>@9yqSik<{`=jP`xXH^s&p+i`J*m{IrZIAPjp%LiZ zliARLx0N5L@?f!;ukxpcoF@cFqKb0NPcoZdLM+dZH#0>J25{NF_g2}S7xe$y&OvE} zglMF^stI@su*~+oSjlF`0cFR>$rI>s3FxO>Mgx}k!{Msi-Kw6OlAhiwRKRox+cR@#O}h^wK-kmPc1DdrrS4+eH_`+q#C2Sm*Ose;6uvLh$u}T1;e@ zmuZbmTVtKuI`#nr-2|51Wd1~eI!!h)5xgCM{Jx;BuC87!lF0F0dD&s*;m)uM5E}c; z0CqrSqx_zmn;Sr{asqMdd?xjKhS>ru4R~FuVN+fP=zQ2#{jENb>!ndikhfC}E*n&s zKi~G-mlw=ff}uH&$6~z&(y)N}HLiLR0~sbbG?LGl!ZUtd{_x&+kd&Q&|6ZMqj#@~u z7qOcC!G!~ox*r5}>rjejzL=Z8V>f@`2KKo*^tY016XYG2?Lyc7j2iT4F~Mr)JrxfR zp?^dKYPR=BCvS%~fBRKA4ca;5Ls1!Sa3s~p%wpKKoiT44nw@D? zisZK4#Y5!(KHjXa>(WdabBtIko~vi>=>WeC3=fY39@*-BC=aRPz_X^YmIwE2LDeQ>)q-iF@T+g1XypJinkh zoahSPb}Et^gtz=%(cCLT>6|uA06N@lMY8mexd9ZGG zeiQ7Zm7ay=?S9x&NdV==pVnM;Xms5@Q?P#S=jlH!xoCzxOpV4IMDRU-J0C;IUV_9O zu#=ZBpFbs)BiLTwB3gb+T$cSCe04{1($r|T{Jo^)C37Q!au40_{gEr$``#_j?%YXV z_Af5J+eYWpAq$+Uy86X}N$mMT-C*kDl5Kg^lRHu6R-F18dVQV)N9p=^?f<^~Ob_X^ z?&F|BCb>{2T>caRIm=2!=h|tK=481n{x0t)=+!G(S*|J!i{X6dzrwiY*T$3@Q^fI#aij%}}sW{SnRST@xk&`mnuv1 z{VkdNseXG;#VxVysin)+D(#Bng!?^Vp@LtgR_&9J&pp%#nmR=Xf|OO&7j9^=HU;Yw z7Qq9YEvhL&mvtdpcd8NM0iEzG^m~S10bk0Mm&=G51Jw!#j`@~tYBXp+ztH<2!MborsRHkytOk9e{HW?1O*A z#r5ZqJ+h07_gjb)kFXjuP-sByd@Bh3(C4E%B~n})>KqbCmBK~47Qtjnlsq_n+ixRw z&#`d)r!aFwr2zqz{(X33JB;Q7S7`hT=mzxF8dt&JEO1wZ(P^M1OT7x;Z7-CLP!N+< zHqMFrPZhbrWlqkf&bkt2>|u{crE^CygbH;v2}&M=De=An0ze01OJ5pZ$o_3=Ep&{+ z`hYDx!%FB)!ny|dgm7wK#&?mfhm$y1zg~O;Hjq7dyWF^4rvo2LrA=C6^D!<{8u0!; zo;MN%E3sb0PSepOmDPb%>JDSO;i_eFa;3WWz-;W9&Pib=@lUyR2nxe&~Gd0WAGiBHyMOkG+h7?r&UF-H_75=eQo_E`& w4E^D}yJ_>vlspPUa@-d;UXuIXr+)BwFlSYpy3-Tj=Ri1Vae1){5yQa$0n<6Ou>b%7 literal 0 HcmV?d00001 diff --git a/examples/multimedia/audiosource/doc/src/audiosource.qdoc b/examples/multimedia/audiosource/doc/src/audiosource.qdoc new file mode 100644 index 0000000..2f120ce --- /dev/null +++ b/examples/multimedia/audiosource/doc/src/audiosource.qdoc @@ -0,0 +1,24 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example audiosource + \title Audio Source Example + \ingroup multimedia_examples + \ingroup audio_examples + \examplecategory {Multimedia} + \brief Recording audio using the QAudioSource class. + \meta {tag} {widgets} + + \e{Audio Source} demonstrates the basic use cases of QAudioSource. + + \image audiosource-example.png + + Qt provides the QAudioSource class to enable audio functionality within + a standard application user interface. + + This example calculates the maximum linear value of the input audio from the + microphone and displays the output. + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/audiosource/main.cpp b/examples/multimedia/audiosource/main.cpp new file mode 100644 index 0000000..49156d8 --- /dev/null +++ b/examples/multimedia/audiosource/main.cpp @@ -0,0 +1,17 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "audiosource.h" + +#include + +int main(int argv, char **args) +{ + QApplication app(argv, args); + QCoreApplication::setApplicationName("Audio Source Test"); + + InputTest input; + input.show(); + + return QCoreApplication::exec(); +} diff --git a/examples/multimedia/camera/CMakeLists.txt b/examples/multimedia/camera/CMakeLists.txt new file mode 100644 index 0000000..45ee646 --- /dev/null +++ b/examples/multimedia/camera/CMakeLists.txt @@ -0,0 +1,83 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(camera LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTOUIC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/camera") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +set(camera_form "") +set(videosettings_form "") +if(ANDROID OR IOS) + set(camera_form camera_mobile.ui) + set(videosettings_form videosettings_mobile.ui) +else() + set(camera_form camera.ui) + set(videosettings_form videosettings.ui) +endif() + +qt_add_executable(camera + MANUAL_FINALIZATION + camera.cpp camera.h ${camera_form} + imagesettings.cpp imagesettings.h imagesettings.ui + main.cpp + videosettings.cpp videosettings.h ${videosettings_form} + metadatadialog.cpp metadatadialog.h +) + +set_target_properties(camera PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +if(APPLE AND NOT IOS) + set_target_properties(camera PROPERTIES + MACOSX_BUNDLE_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/macos/Info.plist.in" + ) +elseif(IOS) + set_target_properties(camera PROPERTIES + MACOSX_BUNDLE_INFO_PLIST "${CMAKE_CURRENT_SOURCE_DIR}/ios/Info.plist.in" + ) +endif() + +set_property(TARGET camera APPEND PROPERTY QT_ANDROID_PACKAGE_SOURCE_DIR + ${CMAKE_CURRENT_SOURCE_DIR}/android) + +qt_add_ios_ffmpeg_libraries(camera) + +target_link_libraries(camera PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +# Resources: +set(camera_resource_files + "images/shutter.svg" +) + +qt_add_resources(camera "camera" + PREFIX + "/" + FILES + ${camera_resource_files} +) + +qt_finalize_executable(camera) + +install(TARGETS camera + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/camera/android/AndroidManifest.xml b/examples/multimedia/camera/android/AndroidManifest.xml new file mode 100644 index 0000000..9f77579 --- /dev/null +++ b/examples/multimedia/camera/android/AndroidManifest.xml @@ -0,0 +1,39 @@ + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/camera/camera.cpp b/examples/multimedia/camera/camera.cpp new file mode 100644 index 0000000..c5aa19e --- /dev/null +++ b/examples/multimedia/camera/camera.cpp @@ -0,0 +1,421 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "camera.h" +#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS) +# include "ui_camera_mobile.h" +#else +# include "ui_camera.h" +#endif + +#include "imagesettings.h" +#include "metadatadialog.h" +#include "videosettings.h" + +#include +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include +#include +#include +#include +#include + +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +Camera::Camera() : ui(new Ui::Camera) +{ + ui->setupUi(this); + // disable all buttons by default + updateCameraActive(false); + readyForCapture(false); + ui->recordButton->setEnabled(false); + ui->pauseButton->setEnabled(false); + ui->stopButton->setEnabled(false); + ui->metaDataButton->setEnabled(false); + + // try to actually initialize camera & mic + init(); +} + +void Camera::init() +{ +#if QT_CONFIG(permissions) + // camera + QCameraPermission cameraPermission; + switch (qApp->checkPermission(cameraPermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(cameraPermission, this, &Camera::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Camera permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } + // microphone + QMicrophonePermission microphonePermission; + switch (qApp->checkPermission(microphonePermission)) { + case Qt::PermissionStatus::Undetermined: + qApp->requestPermission(microphonePermission, this, &Camera::init); + return; + case Qt::PermissionStatus::Denied: + qWarning("Microphone permission is not granted!"); + return; + case Qt::PermissionStatus::Granted: + break; + } +#endif + + m_audioInput.reset(new QAudioInput); + m_captureSession.setAudioInput(m_audioInput.get()); + + // Camera devices: + + videoDevicesGroup = new QActionGroup(this); + videoDevicesGroup->setExclusive(true); + updateCameras(); + connect(&m_devices, &QMediaDevices::videoInputsChanged, this, &Camera::updateCameras); + + connect(videoDevicesGroup, &QActionGroup::triggered, this, &Camera::updateCameraDevice); + connect(ui->captureWidget, &QTabWidget::currentChanged, this, &Camera::updateCaptureMode); + + connect(ui->metaDataButton, &QPushButton::clicked, this, &Camera::showMetaDataDialog); + connect(ui->exposureCompensation, &QAbstractSlider::valueChanged, this, + &Camera::setExposureCompensation); + + setCamera(QMediaDevices::defaultVideoInput()); +} + +void Camera::setCamera(const QCameraDevice &cameraDevice) +{ + m_camera.reset(new QCamera(cameraDevice)); + m_captureSession.setCamera(m_camera.data()); + + connect(m_camera.data(), &QCamera::activeChanged, this, &Camera::updateCameraActive); + connect(m_camera.data(), &QCamera::errorOccurred, this, &Camera::displayCameraError); + + if (!m_mediaRecorder) { + m_mediaRecorder.reset(new QMediaRecorder); + m_captureSession.setRecorder(m_mediaRecorder.data()); + connect(m_mediaRecorder.data(), &QMediaRecorder::recorderStateChanged, this, + &Camera::updateRecorderState); + connect(m_mediaRecorder.data(), &QMediaRecorder::durationChanged, this, + &Camera::updateRecordTime); + connect(m_mediaRecorder.data(), &QMediaRecorder::errorChanged, this, + &Camera::displayRecorderError); + } + + if (!m_imageCapture) { + m_imageCapture.reset(new QImageCapture); + m_captureSession.setImageCapture(m_imageCapture.get()); + connect(m_imageCapture.get(), &QImageCapture::readyForCaptureChanged, this, + &Camera::readyForCapture); + connect(m_imageCapture.get(), &QImageCapture::imageCaptured, this, + &Camera::processCapturedImage); + connect(m_imageCapture.get(), &QImageCapture::imageSaved, this, &Camera::imageSaved); + connect(m_imageCapture.get(), &QImageCapture::errorOccurred, this, + &Camera::displayCaptureError); + } + + m_captureSession.setVideoOutput(ui->viewfinder); + + updateCameraActive(m_camera->isActive()); + updateRecorderState(m_mediaRecorder->recorderState()); + readyForCapture(m_imageCapture->isReadyForCapture()); + + updateCaptureMode(); + + m_camera->start(); +} + +void Camera::keyPressEvent(QKeyEvent *event) +{ + if (event->isAutoRepeat()) + return; + + switch (event->key()) { + case Qt::Key_CameraFocus: + displayViewfinder(); + event->accept(); + break; + case Qt::Key_Camera: + if (m_doImageCapture) { + takeImage(); + } else { + if (m_mediaRecorder->recorderState() == QMediaRecorder::RecordingState) + stop(); + else + record(); + } + event->accept(); + break; + default: + QMainWindow::keyPressEvent(event); + } +} + +void Camera::updateRecordTime() +{ + QString str = tr("Recorded %1 sec").arg(m_mediaRecorder->duration() / 1000); + ui->statusbar->showMessage(str); +} + +void Camera::processCapturedImage(int requestId, const QImage &img) +{ + Q_UNUSED(requestId); + QImage scaledImage = + img.scaled(ui->viewfinder->size(), Qt::KeepAspectRatio, Qt::SmoothTransformation); + + ui->lastImagePreviewLabel->setPixmap(QPixmap::fromImage(scaledImage)); + + // Display captured image for 4 seconds. + displayCapturedImage(); + QTimer::singleShot(4000, this, &Camera::displayViewfinder); +} + +void Camera::configureCaptureSettings() +{ + if (m_doImageCapture) + configureImageSettings(); + else + configureVideoSettings(); +} + +void Camera::configureVideoSettings() +{ + VideoSettings settingsDialog(m_mediaRecorder.data()); + + if (settingsDialog.exec()) + settingsDialog.applySettings(); +} + +void Camera::configureImageSettings() +{ + ImageSettings settingsDialog(m_imageCapture.get()); + + if (settingsDialog.exec() == QDialog::Accepted) + settingsDialog.applyImageSettings(); +} + +void Camera::record() +{ + m_mediaRecorder->record(); + updateRecordTime(); +} + +void Camera::pause() +{ + m_mediaRecorder->pause(); +} + +void Camera::stop() +{ + m_mediaRecorder->stop(); +} + +void Camera::setMuted(bool muted) +{ + m_captureSession.audioInput()->setMuted(muted); +} + +void Camera::takeImage() +{ + m_isCapturingImage = true; + m_imageCapture->captureToFile(); +} + +void Camera::displayCaptureError(int id, const QImageCapture::Error error, + const QString &errorString) +{ + Q_UNUSED(id); + Q_UNUSED(error); + QMessageBox::warning(this, tr("Image Capture Error"), errorString); + m_isCapturingImage = false; +} + +void Camera::startCamera() +{ + m_camera->start(); +} + +void Camera::stopCamera() +{ + m_camera->stop(); +} + +void Camera::updateCaptureMode() +{ + int tabIndex = ui->captureWidget->currentIndex(); + m_doImageCapture = (tabIndex == 0); +} + +void Camera::updateCameraActive(bool active) +{ + if (active) { + ui->actionStartCamera->setEnabled(false); + ui->actionStopCamera->setEnabled(true); + ui->captureWidget->setEnabled(true); + ui->actionSettings->setEnabled(true); + } else { + ui->actionStartCamera->setEnabled(true); + ui->actionStopCamera->setEnabled(false); + ui->captureWidget->setEnabled(false); + ui->actionSettings->setEnabled(false); + } +} + +void Camera::updateRecorderState(QMediaRecorder::RecorderState state) +{ + switch (state) { + case QMediaRecorder::StoppedState: + ui->recordButton->setEnabled(true); + ui->pauseButton->setEnabled(true); + ui->stopButton->setEnabled(false); + ui->metaDataButton->setEnabled(true); + break; + case QMediaRecorder::PausedState: + ui->recordButton->setEnabled(true); + ui->pauseButton->setEnabled(false); + ui->stopButton->setEnabled(true); + ui->metaDataButton->setEnabled(false); + break; + case QMediaRecorder::RecordingState: + ui->recordButton->setEnabled(false); + ui->pauseButton->setEnabled(true); + ui->stopButton->setEnabled(true); + ui->metaDataButton->setEnabled(false); + break; + } +} + +void Camera::setExposureCompensation(int index) +{ + m_camera->setExposureCompensation(index * 0.5); +} + +void Camera::displayRecorderError() +{ + if (m_mediaRecorder->error() != QMediaRecorder::NoError) + QMessageBox::warning(this, tr("Capture Error"), m_mediaRecorder->errorString()); +} + +void Camera::displayCameraError() +{ + if (m_camera->error() != QCamera::NoError) + QMessageBox::warning(this, tr("Camera Error"), m_camera->errorString()); +} + +void Camera::updateCameraDevice(QAction *action) +{ + setCamera(qvariant_cast(action->data())); +} + +void Camera::displayViewfinder() +{ + ui->stackedWidget->setCurrentIndex(0); +} + +void Camera::displayCapturedImage() +{ + ui->stackedWidget->setCurrentIndex(1); +} + +void Camera::readyForCapture(bool ready) +{ + ui->takeImageButton->setEnabled(ready); +} + +void Camera::imageSaved(int id, const QString &fileName) +{ + Q_UNUSED(id); + ui->statusbar->showMessage(tr("Captured \"%1\"").arg(QDir::toNativeSeparators(fileName))); + + m_isCapturingImage = false; + if (m_applicationExiting) + close(); +} + +void Camera::closeEvent(QCloseEvent *event) +{ + if (m_isCapturingImage) { + setEnabled(false); + m_applicationExiting = true; + event->ignore(); + } else { + event->accept(); + } +} + +void Camera::updateCameras() +{ + ui->menuDevices->clear(); + const QList availableCameras = QMediaDevices::videoInputs(); + for (const QCameraDevice &cameraDevice : availableCameras) { + QAction *videoDeviceAction = new QAction(cameraDevice.description(), videoDevicesGroup); + videoDeviceAction->setCheckable(true); + videoDeviceAction->setData(QVariant::fromValue(cameraDevice)); + if (cameraDevice == QMediaDevices::defaultVideoInput()) + videoDeviceAction->setChecked(true); + + ui->menuDevices->addAction(videoDeviceAction); + } +} + +void Camera::showMetaDataDialog() +{ + if (!m_metaDataDialog) + m_metaDataDialog = new MetaDataDialog(this); + m_metaDataDialog->setAttribute(Qt::WA_DeleteOnClose, false); + if (m_metaDataDialog->exec() == QDialog::Accepted) + saveMetaData(); +} + +void Camera::saveMetaData() +{ + QMediaMetaData data; + for (int i = 0; i < QMediaMetaData::NumMetaData; i++) { + QString val = m_metaDataDialog->m_metaDataFields[i]->text(); + if (!val.isEmpty()) { + const auto key = static_cast(i); + switch (key) { + case QMediaMetaData::CoverArtImage: { + QImage coverArt(val); + data.insert(key, coverArt); + break; + } + case QMediaMetaData::ThumbnailImage: { + QImage thumbnail(val); + data.insert(key, thumbnail); + break; + } + case QMediaMetaData::Date: { + QDateTime date = QDateTime::fromString(val); + data.insert(key, date); + break; + } + case QMediaMetaData::HasHdrContent: + break; + default: + data.insert(key, val); + } + } + } + m_mediaRecorder->setMetaData(data); +} + +#include "moc_camera.cpp" diff --git a/examples/multimedia/camera/camera.h b/examples/multimedia/camera/camera.h new file mode 100644 index 0000000..c92aa2d --- /dev/null +++ b/examples/multimedia/camera/camera.h @@ -0,0 +1,104 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef CAMERA_H +#define CAMERA_H + +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +QT_BEGIN_NAMESPACE +namespace Ui { +class Camera; +} +class QActionGroup; +QT_END_NAMESPACE + +class MetaDataDialog; + +class Camera : public QMainWindow +{ + Q_OBJECT + +public: + Camera(); + +public slots: + void saveMetaData(); + +private slots: + void init(); + + void setCamera(const QCameraDevice &cameraDevice); + + void startCamera(); + void stopCamera(); + + void record(); + void pause(); + void stop(); + void setMuted(bool); + + void takeImage(); + void displayCaptureError(int, QImageCapture::Error, const QString &errorString); + + void configureCaptureSettings(); + void configureVideoSettings(); + void configureImageSettings(); + + void displayRecorderError(); + void displayCameraError(); + + void updateCameraDevice(QAction *action); + + void updateCameraActive(bool active); + void updateCaptureMode(); + void updateRecorderState(QMediaRecorder::RecorderState state); + void setExposureCompensation(int index); + + void updateRecordTime(); + + void processCapturedImage(int requestId, const QImage &img); + + void displayViewfinder(); + void displayCapturedImage(); + + void readyForCapture(bool ready); + void imageSaved(int id, const QString &fileName); + + void updateCameras(); + + void showMetaDataDialog(); + +protected: + void keyPressEvent(QKeyEvent *event) override; + void closeEvent(QCloseEvent *event) override; + +private: + Ui::Camera *ui; + + QActionGroup *videoDevicesGroup = nullptr; + + QMediaDevices m_devices; + QScopedPointer m_imageCapture; + QMediaCaptureSession m_captureSession; + QScopedPointer m_camera; + QScopedPointer m_audioInput; + QScopedPointer m_mediaRecorder; + + bool m_isCapturingImage = false; + bool m_applicationExiting = false; + bool m_doImageCapture = true; + + MetaDataDialog *m_metaDataDialog = nullptr; +}; + +#endif diff --git a/examples/multimedia/camera/camera.pro b/examples/multimedia/camera/camera.pro new file mode 100644 index 0000000..283d846 --- /dev/null +++ b/examples/multimedia/camera/camera.pro @@ -0,0 +1,40 @@ +TEMPLATE = app +TARGET = camera + +QT += multimedia multimediawidgets + +HEADERS = \ + camera.h \ + imagesettings.h \ + videosettings.h \ + metadatadialog.h + +SOURCES = \ + main.cpp \ + camera.cpp \ + imagesettings.cpp \ + videosettings.cpp \ + metadatadialog.cpp + +FORMS += \ + imagesettings.ui + +android|ios { + FORMS += \ + camera_mobile.ui \ + videosettings_mobile.ui +} else { + FORMS += \ + camera.ui \ + videosettings.ui +} +RESOURCES += camera.qrc + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/camera +INSTALLS += target + +QT += widgets +include(../../multimedia/shared/shared.pri) + +ANDROID_PACKAGE_SOURCE_DIR = $$PWD/android +OTHER_FILES += android/AndroidManifest.xml diff --git a/examples/multimedia/camera/camera.qrc b/examples/multimedia/camera/camera.qrc new file mode 100644 index 0000000..a915eb5 --- /dev/null +++ b/examples/multimedia/camera/camera.qrc @@ -0,0 +1,5 @@ + + + images/shutter.svg + + diff --git a/examples/multimedia/camera/camera.ui b/examples/multimedia/camera/camera.ui new file mode 100644 index 0000000..560ee7f --- /dev/null +++ b/examples/multimedia/camera/camera.ui @@ -0,0 +1,488 @@ + + + Camera + + + + 0 + 0 + 668 + 429 + + + + Camera + + + + + + + 0 + + + + Image + + + + + + Qt::Vertical + + + + 20 + 161 + + + + + + + + false + + + Capture Photo + + + + :/images/shutter.svg:/images/shutter.svg + + + + + + + -4 + + + 4 + + + 2 + + + Qt::Horizontal + + + QSlider::TicksAbove + + + + + + + Exposure Compensation: + + + + + + + + Video + + + + + + Record + + + + + + + Pause + + + + + + + Stop + + + + + + + Qt::Vertical + + + + 20 + 76 + + + + + + + + Mute + + + true + + + + + + + Set metadata + + + true + + + + + + + + + + + + 1 + 0 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 145 + 145 + 145 + + + + + + + 145 + 145 + 145 + + + + + + + + 0 + + + + + + + + + + + + + + + 0 + 0 + + + + QFrame::Box + + + + + + + + + + + + + + + + 0 + 0 + 668 + 28 + + + + + File + + + + + + + + + + + Devices + + + + + + + + + Close + + + + + Start Camera + + + + + Stop Camera + + + + + Change Settings + + + + + + QVideoWidget + QWidget +
qvideowidget.h
+ 1 + + + + + + + + recordButton + clicked() + Camera + record() + + + 647 + 149 + + + 61 + 238 + + + + + stopButton + clicked() + Camera + stop() + + + 647 + 225 + + + 140 + 236 + + + + + pauseButton + clicked() + Camera + pause() + + + 647 + 187 + + + 234 + 237 + + + + + actionExit + triggered() + Camera + close() + + + -1 + -1 + + + 154 + 130 + + + + + takeImageButton + clicked() + Camera + takeImage() + + + 625 + 132 + + + 603 + 169 + + + + + muteButton + toggled(bool) + Camera + setMuted(bool) + + + 647 + 377 + + + 5 + 280 + + + + + exposureCompensation + valueChanged(int) + Camera + setExposureCompensation(int) + + + 559 + 367 + + + 665 + 365 + + + + + actionSettings + triggered() + Camera + configureCaptureSettings() + + + -1 + -1 + + + 333 + 210 + + + + + actionStartCamera + triggered() + Camera + startCamera() + + + -1 + -1 + + + 333 + 210 + + + + + actionStopCamera + triggered() + Camera + stopCamera() + + + -1 + -1 + + + 333 + 210 + + + + + + record() + pause() + stop() + enablePreview(bool) + configureCaptureSettings() + takeImage() + startCamera() + toggleLock() + setMuted(bool) + stopCamera() + setExposureCompensation(int) + + diff --git a/examples/multimedia/camera/camera_mobile.ui b/examples/multimedia/camera/camera_mobile.ui new file mode 100644 index 0000000..7f269b1 --- /dev/null +++ b/examples/multimedia/camera/camera_mobile.ui @@ -0,0 +1,504 @@ + + + Camera + + + + 0 + 0 + 668 + 429 + + + + Camera + + + + + + + + 0 + 0 + + + + 0 + + + + Image + + + + + + -4 + + + 4 + + + 2 + + + Qt::Horizontal + + + QSlider::TicksAbove + + + + + + + + 0 + 0 + + + + Exposure Compensation: + + + + + + + false + + + Capture Photo + + + + :/images/shutter.svg:/images/shutter.svg + + + + + + + + Video + + + + + + + + + + Record + + + + + + + Pause + + + + + + + Stop + + + + + + + + + + + Qt::Vertical + + + + 20 + 10 + + + + + + + + Mute + + + true + + + + + + + Set metadata + + + true + + + + + + + + + + + + + + + + 1 + 0 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 255 + 255 + 255 + + + + + + + 145 + 145 + 145 + + + + + + + + + 145 + 145 + 145 + + + + + + + 145 + 145 + 145 + + + + + + + + 0 + + + + + + + + 0 + 0 + + + + + + + + + + + + + 0 + 0 + + + + QFrame::Box + + + + + + + + + + + + + + + + 0 + 0 + 668 + 22 + + + + + File + + + + + + + + + + + Devices + + + + + + + + + Close + + + + + Start Camera + + + + + Stop Camera + + + + + Change Settings + + + + + + QVideoWidget + QWidget +
qvideowidget.h
+ 1 + + + + + + recordButton + clicked() + Camera + record() + + + 647 + 149 + + + 61 + 238 + + + + + stopButton + clicked() + Camera + stop() + + + 647 + 225 + + + 140 + 236 + + + + + pauseButton + clicked() + Camera + pause() + + + 647 + 187 + + + 234 + 237 + + + + + actionExit + triggered() + Camera + close() + + + -1 + -1 + + + 154 + 130 + + + + + takeImageButton + clicked() + Camera + takeImage() + + + 625 + 132 + + + 603 + 169 + + + + + muteButton + toggled(bool) + Camera + setMuted(bool) + + + 647 + 377 + + + 5 + 280 + + + + + exposureCompensation + valueChanged(int) + Camera + setExposureCompensation(int) + + + 559 + 367 + + + 665 + 365 + + + + + actionSettings + triggered() + Camera + configureCaptureSettings() + + + -1 + -1 + + + 333 + 210 + + + + + actionStartCamera + triggered() + Camera + startCamera() + + + -1 + -1 + + + 333 + 210 + + + + + actionStopCamera + triggered() + Camera + stopCamera() + + + -1 + -1 + + + 333 + 210 + + + + + + record() + pause() + stop() + enablePreview(bool) + configureCaptureSettings() + takeImage() + startCamera() + toggleLock() + setMuted(bool) + stopCamera() + setExposureCompensation(int) + + diff --git a/examples/multimedia/camera/doc/images/camera-example.png b/examples/multimedia/camera/doc/images/camera-example.png new file mode 100644 index 0000000000000000000000000000000000000000..f7d7e4f67d4d755246181be656eab3dc840e41a8 GIT binary patch literal 151290 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 z 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%0D^OihNVJ2$j#D7R)Z^C|I#pktc4mj4 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 + +It seeks permissions for input device access: + +\skipto #if QT_CONFIG(permissions) +\printuntil #endif + +Inputs are assigned: +\printuntil updateCameras() + + UI signals are connected to slots that react to the triggering event: +\printuntil setCamera(QMediaDevices::defaultVideoInput()); + +However, most of the work is done when the \e{setCamera()} function is called, +passing in a \l QCameraDevice. + +\section1 setCamera() + +\c{setCamera()} sets up various connections between the user interface and the +functionality of the Camera class using signals and slots. It also instantiates +and initializes the \l {QCamera}, \l {QImageCapture}, and \l {QMediaRecorder} +objects. + +\skipto void Camera::setCamera(const QCameraDevice &cameraDevice) +\printto m_captureSession.setVideoOutput(ui->viewfinder); + +The still and video recording visual tabs are enabled: + +\printuntil updateCaptureMode(); + +Finally the \l {QCamera::start}{start()} function of the \l{QCamera} +object is called. + +\printuntil m_camera->start(); + +\section1 Triggering capturing + +Now that the camera is ready for user commands it waits for a suitable event. +Such an event can be a key press of either the \l {Qt::Key_CameraFocus} or +\l {Qt::Key_Camera} buttons on the application window. + +Key_CameraFocus will simply display the preview and lock the camera settings. +\printto case Qt::Key_Camera: + +\c Key_Camera will either call \e{takeImage()} if doing an image capture, or call +\c record() or \c stop() (if already recording) on the QMediaRecorder instance +when recording video. + +\printuntil break; + +*/ diff --git a/examples/multimedia/camera/images/shutter.svg b/examples/multimedia/camera/images/shutter.svg new file mode 100644 index 0000000..1849336 --- /dev/null +++ b/examples/multimedia/camera/images/shutter.svg @@ -0,0 +1,21 @@ + + + + + + + + + + + + diff --git a/examples/multimedia/camera/imagesettings.cpp b/examples/multimedia/camera/imagesettings.cpp new file mode 100644 index 0000000..c2b022a --- /dev/null +++ b/examples/multimedia/camera/imagesettings.cpp @@ -0,0 +1,84 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "imagesettings.h" +#include "ui_imagesettings.h" + +#include +#include +#include + +#include + +#include + +using namespace Qt::StringLiterals; + +ImageSettings::ImageSettings(QImageCapture *imageCapture, QWidget *parent) + : QDialog(parent), ui(new Ui::ImageSettingsUi), imagecapture(imageCapture) +{ + ui->setupUi(this); + + // image codecs + ui->imageCodecBox->addItem(tr("Default image format"), QVariant(QString())); + const auto supportedImageFormats = QImageCapture::supportedFormats(); + for (const auto &f : supportedImageFormats) { + QString description = QImageCapture::fileFormatDescription(f); + ui->imageCodecBox->addItem(QImageCapture::fileFormatName(f) + ": " + description, + QVariant::fromValue(f)); + } + + ui->imageQualitySlider->setRange(0, int(QImageCapture::VeryHighQuality)); + + ui->imageResolutionBox->addItem(tr("Default Resolution")); + const QList supportedResolutions = + imagecapture->captureSession()->camera()->cameraDevice().photoResolutions(); + for (const QSize &resolution : supportedResolutions) { + ui->imageResolutionBox->addItem( + u"%1x%2"_s.arg(resolution.width()).arg(resolution.height()), + QVariant(resolution)); + } + + selectComboBoxItem(ui->imageCodecBox, QVariant::fromValue(imagecapture->fileFormat())); + selectComboBoxItem(ui->imageResolutionBox, QVariant(imagecapture->resolution())); + ui->imageQualitySlider->setValue(imagecapture->quality()); +} + +ImageSettings::~ImageSettings() +{ + delete ui; +} + +void ImageSettings::changeEvent(QEvent *e) +{ + QDialog::changeEvent(e); + switch (e->type()) { + case QEvent::LanguageChange: + ui->retranslateUi(this); + break; + default: + break; + } +} + +void ImageSettings::applyImageSettings() const +{ + imagecapture->setFileFormat(boxValue(ui->imageCodecBox).value()); + imagecapture->setQuality(QImageCapture::Quality(ui->imageQualitySlider->value())); + imagecapture->setResolution(boxValue(ui->imageResolutionBox).toSize()); +} + +QVariant ImageSettings::boxValue(const QComboBox *box) const +{ + const int idx = box->currentIndex(); + return idx != -1 ? box->itemData(idx) : QVariant{}; +} + +void ImageSettings::selectComboBoxItem(QComboBox *box, const QVariant &value) +{ + const int idx = box->findData(value); + if (idx != -1) + box->setCurrentIndex(idx); +} + +#include "moc_imagesettings.cpp" diff --git a/examples/multimedia/camera/imagesettings.h b/examples/multimedia/camera/imagesettings.h new file mode 100644 index 0000000..0e2ef8e --- /dev/null +++ b/examples/multimedia/camera/imagesettings.h @@ -0,0 +1,41 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef IMAGESETTINGS_H +#define IMAGESETTINGS_H + +#include + +QT_BEGIN_NAMESPACE +class QComboBox; +class QImageCapture; +namespace Ui { +class ImageSettingsUi; +} +QT_END_NAMESPACE + +class ImageSettings : public QDialog +{ + Q_OBJECT + +public: + explicit ImageSettings(QImageCapture *imageCapture, QWidget *parent = nullptr); + ~ImageSettings(); + + void applyImageSettings() const; + + QString format() const; + void setFormat(const QString &format); + +protected: + void changeEvent(QEvent *e) override; + +private: + QVariant boxValue(const QComboBox *box) const; + void selectComboBoxItem(QComboBox *box, const QVariant &value); + + Ui::ImageSettingsUi *ui; + QImageCapture *imagecapture; +}; + +#endif // IMAGESETTINGS_H diff --git a/examples/multimedia/camera/imagesettings.ui b/examples/multimedia/camera/imagesettings.ui new file mode 100644 index 0000000..8c59ca0 --- /dev/null +++ b/examples/multimedia/camera/imagesettings.ui @@ -0,0 +1,123 @@ + + + ImageSettingsUi + + + + 0 + 0 + 332 + 270 + + + + Image Settings + + + + + + Image + + + + + + Resolution: + + + + + + + + + + Image Format: + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Horizontal + + + + + + + + + + Qt::Vertical + + + + 20 + 14 + + + + + + + + Qt::Horizontal + + + QDialogButtonBox::Cancel|QDialogButtonBox::Ok + + + + + + + + + buttonBox + accepted() + ImageSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + ImageSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/camera/ios/Info.plist.in b/examples/multimedia/camera/ios/Info.plist.in new file mode 100644 index 0000000..6a6b8db --- /dev/null +++ b/examples/multimedia/camera/ios/Info.plist.in @@ -0,0 +1,50 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + LSRequiresIPhoneOS + + + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + + diff --git a/examples/multimedia/camera/macos/Info.plist.in b/examples/multimedia/camera/macos/Info.plist.in new file mode 100644 index 0000000..ae2d945 --- /dev/null +++ b/examples/multimedia/camera/macos/Info.plist.in @@ -0,0 +1,49 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSPrincipalClass + NSApplication + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/camera/main.cpp b/examples/multimedia/camera/main.cpp new file mode 100644 index 0000000..afe84a4 --- /dev/null +++ b/examples/multimedia/camera/main.cpp @@ -0,0 +1,20 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "camera.h" + +#include + +int main(int argc, char *argv[]) +{ +#ifdef Q_OS_ANDROID + // To be removed after QTBUG-132816 + QCoreApplication::setAttribute(Qt::AA_DontUseNativeMenuBar); +#endif + QApplication app(argc, argv); + + Camera camera; + camera.show(); + + return app.exec(); +}; diff --git a/examples/multimedia/camera/metadatadialog.cpp b/examples/multimedia/camera/metadatadialog.cpp new file mode 100644 index 0000000..8213baa --- /dev/null +++ b/examples/multimedia/camera/metadatadialog.cpp @@ -0,0 +1,107 @@ +// Copyright (C) 2020 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "metadatadialog.h" + +#include + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +#include + +static QString defaultValue(QMediaMetaData::Key key) +{ + switch (key) { + case QMediaMetaData::Title: + return MetaDataDialog::tr("Qt Camera Example"); + case QMediaMetaData::Author: + return MetaDataDialog::tr("The Qt Company"); + case QMediaMetaData::Date: + return QDateTime::currentDateTime().toString(); + default: + break; + } + return {}; +} + +MetaDataDialog::MetaDataDialog(QWidget *parent) : QDialog(parent) +{ + auto *viewport = new QWidget; + auto *metaDataLayout = new QFormLayout(viewport); + + for (int i = 0; i < QMediaMetaData::NumMetaData; ++i) { + const auto key = static_cast(i); + QString label = QMediaMetaData::metaDataKeyToString(key); + auto *lineEdit = new QLineEdit(defaultValue(key)); + lineEdit->setClearButtonEnabled(true); + m_metaDataFields[key] = lineEdit; + + switch (key) { + case QMediaMetaData::ThumbnailImage: { + QPushButton *openThumbnail = new QPushButton(tr("Open")); + connect(openThumbnail, &QPushButton::clicked, this, + &MetaDataDialog::openThumbnailImage); + QHBoxLayout *layout = new QHBoxLayout; + layout->addWidget(lineEdit); + layout->addWidget(openThumbnail); + metaDataLayout->addRow(label, layout); + } + break; + case QMediaMetaData::CoverArtImage: { + QPushButton *openCoverArt = new QPushButton(tr("Open")); + connect(openCoverArt, &QPushButton::clicked, this, &MetaDataDialog::openCoverArtImage); + QHBoxLayout *layout = new QHBoxLayout; + layout->addWidget(lineEdit); + layout->addWidget(openCoverArt); + metaDataLayout->addRow(label, layout); + } + break; + case QMediaMetaData::HasHdrContent: + break; // Read-only + default: + metaDataLayout->addRow(label, lineEdit); + break; + } + } + + QScrollArea *scrollArea = new QScrollArea; + scrollArea->setWidget(viewport); + auto *dialogLayout = new QVBoxLayout(this); + dialogLayout->addWidget(scrollArea); + + auto buttonBox = new QDialogButtonBox(QDialogButtonBox::Ok | QDialogButtonBox::Cancel); + dialogLayout->addWidget(buttonBox); + + setWindowTitle(tr("Set Metadata")); + resize(400, 300); + + connect(buttonBox, &QDialogButtonBox::accepted, this, &MetaDataDialog::accept); + connect(buttonBox, &QDialogButtonBox::rejected, this, &MetaDataDialog::reject); +} + +void MetaDataDialog::openThumbnailImage() +{ + QString fileName = QFileDialog::getOpenFileName(this, tr("Open Image"), QDir::currentPath(), + tr("Image Files (*.png *.jpg *.bmp)")); + if (!fileName.isEmpty()) + m_metaDataFields[QMediaMetaData::ThumbnailImage]->setText(fileName); +} + +void MetaDataDialog::openCoverArtImage() +{ + QString fileName = QFileDialog::getOpenFileName(this, tr("Open Image"), QDir::currentPath(), + tr("Image Files (*.png *.jpg *.bmp)")); + if (!fileName.isEmpty()) + m_metaDataFields[QMediaMetaData::CoverArtImage]->setText(fileName); +} + +#include "moc_metadatadialog.cpp" diff --git a/examples/multimedia/camera/metadatadialog.h b/examples/multimedia/camera/metadatadialog.h new file mode 100644 index 0000000..5bb5a4b --- /dev/null +++ b/examples/multimedia/camera/metadatadialog.h @@ -0,0 +1,31 @@ +// Copyright (C) 2020 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef DIALOG_H +#define DIALOG_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QLabel; +class QLineEdit; +QT_END_NAMESPACE + +//! [0] +class MetaDataDialog : public QDialog +{ + Q_OBJECT + +public: + explicit MetaDataDialog(QWidget *parent = nullptr); + + QLineEdit *m_metaDataFields[QMediaMetaData::NumMetaData] = {}; + +private slots: + void openThumbnailImage(); + void openCoverArtImage(); +}; +//! [0] + +#endif diff --git a/examples/multimedia/camera/videosettings.cpp b/examples/multimedia/camera/videosettings.cpp new file mode 100644 index 0000000..68177e0 --- /dev/null +++ b/examples/multimedia/camera/videosettings.cpp @@ -0,0 +1,196 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videosettings.h" +#if defined(Q_OS_ANDROID) || defined(Q_OS_IOS) +# include "ui_videosettings_mobile.h" +#else +# include "ui_videosettings.h" +#endif + +#include +#include +#include +#include +#include +#include +#include + +#include +#include + +#include +#include + +static QString toFormattedString(const QCameraFormat &cameraFormat) +{ + QString string; + QTextStream str(&string); + str << QVideoFrameFormat::pixelFormatToString(cameraFormat.pixelFormat()) + << ' ' << cameraFormat.resolution().width() + << 'x' << cameraFormat.resolution().height() + << ' ' << cameraFormat.minFrameRate() + << '-' << cameraFormat.maxFrameRate() << "FPS"; + return string; +} + +VideoSettings::VideoSettings(QMediaRecorder *mediaRecorder, QWidget *parent) + : QDialog(parent), ui(new Ui::VideoSettingsUi), mediaRecorder(mediaRecorder) +{ + ui->setupUi(this); + + // sample rate: + auto audioDevice = mediaRecorder->captureSession()->audioInput()->device(); + ui->audioSampleRateBox->setRange(audioDevice.minimumSampleRate(), + audioDevice.maximumSampleRate()); + + // camera format + ui->videoFormatBox->addItem(tr("Default camera format")); + + auto *camera = mediaRecorder->captureSession()->camera(); + const QList videoFormats = camera->cameraDevice().videoFormats(); + + for (const QCameraFormat &format : videoFormats) + ui->videoFormatBox->addItem(toFormattedString(format), QVariant::fromValue(format)); + + connect(ui->videoFormatBox, &QComboBox::currentIndexChanged, [this](int /*index*/) { + this->setFpsRange(boxValue(ui->videoFormatBox).value()); + }); + + setFpsRange(camera->cameraFormat()); + + connect(ui->fpsSlider, &QSlider::valueChanged, ui->fpsSpinBox, &QSpinBox::setValue); + connect(ui->fpsSpinBox, &QSpinBox::valueChanged, ui->fpsSlider, &QSlider::setValue); + + updateFormatsAndCodecs(); + connect(ui->audioCodecBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + connect(ui->videoCodecBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + connect(ui->containerFormatBox, &QComboBox::currentIndexChanged, this, + &VideoSettings::updateFormatsAndCodecs); + + ui->qualitySlider->setRange(0, int(QMediaRecorder::VeryHighQuality)); + + QMediaFormat format = mediaRecorder->mediaFormat(); + selectComboBoxItem(ui->containerFormatBox, QVariant::fromValue(format.fileFormat())); + selectComboBoxItem(ui->audioCodecBox, QVariant::fromValue(format.audioCodec())); + selectComboBoxItem(ui->videoCodecBox, QVariant::fromValue(format.videoCodec())); + + ui->qualitySlider->setValue(mediaRecorder->quality()); + ui->audioSampleRateBox->setValue(mediaRecorder->audioSampleRate()); + selectComboBoxItem(ui->videoFormatBox, + QVariant::fromValue(camera->cameraFormat())); + + ui->fpsSlider->setValue(mediaRecorder->videoFrameRate()); + ui->fpsSpinBox->setValue(mediaRecorder->videoFrameRate()); +} + +VideoSettings::~VideoSettings() +{ + delete ui; +} + +void VideoSettings::changeEvent(QEvent *e) +{ + QDialog::changeEvent(e); + switch (e->type()) { + case QEvent::LanguageChange: + ui->retranslateUi(this); + break; + default: + break; + } +} + +void VideoSettings::setFpsRange(const QCameraFormat &format) +{ + ui->fpsSlider->setRange(format.minFrameRate(), format.maxFrameRate()); + ui->fpsSpinBox->setRange(format.minFrameRate(), format.maxFrameRate()); +} + +void VideoSettings::applySettings() +{ + QMediaFormat format; + format.setFileFormat(boxValue(ui->containerFormatBox).value()); + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + format.setVideoCodec(boxValue(ui->videoCodecBox).value()); + + mediaRecorder->setMediaFormat(format); + mediaRecorder->setQuality(QMediaRecorder::Quality(ui->qualitySlider->value())); + mediaRecorder->setAudioSampleRate(ui->audioSampleRateBox->value()); + + const auto &cameraFormat = boxValue(ui->videoFormatBox).value(); + mediaRecorder->setVideoResolution(cameraFormat.resolution()); + mediaRecorder->setVideoFrameRate(ui->fpsSlider->value()); + + mediaRecorder->captureSession()->camera()->setCameraFormat(cameraFormat); +} + +void VideoSettings::updateFormatsAndCodecs() +{ + if (m_updatingFormats) + return; + m_updatingFormats = true; + + QMediaFormat format; + if (ui->containerFormatBox->count()) + format.setFileFormat(boxValue(ui->containerFormatBox).value()); + if (ui->audioCodecBox->count()) + format.setAudioCodec(boxValue(ui->audioCodecBox).value()); + if (ui->videoCodecBox->count()) + format.setVideoCodec(boxValue(ui->videoCodecBox).value()); + + int currentIndex = 0; + ui->audioCodecBox->clear(); + ui->audioCodecBox->addItem(tr("Default audio codec"), + QVariant::fromValue(QMediaFormat::AudioCodec::Unspecified)); + for (auto codec : format.supportedAudioCodecs(QMediaFormat::Encode)) { + if (codec == format.audioCodec()) + currentIndex = ui->audioCodecBox->count(); + ui->audioCodecBox->addItem(QMediaFormat::audioCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->audioCodecBox->setCurrentIndex(currentIndex); + + currentIndex = 0; + ui->videoCodecBox->clear(); + ui->videoCodecBox->addItem(tr("Default video codec"), + QVariant::fromValue(QMediaFormat::VideoCodec::Unspecified)); + for (auto codec : format.supportedVideoCodecs(QMediaFormat::Encode)) { + if (codec == format.videoCodec()) + currentIndex = ui->videoCodecBox->count(); + ui->videoCodecBox->addItem(QMediaFormat::videoCodecDescription(codec), + QVariant::fromValue(codec)); + } + ui->videoCodecBox->setCurrentIndex(currentIndex); + + currentIndex = 0; + ui->containerFormatBox->clear(); + ui->containerFormatBox->addItem(tr("Default file format"), + QVariant::fromValue(QMediaFormat::UnspecifiedFormat)); + for (auto container : format.supportedFileFormats(QMediaFormat::Encode)) { + if (container == format.fileFormat()) + currentIndex = ui->containerFormatBox->count(); + ui->containerFormatBox->addItem(QMediaFormat::fileFormatDescription(container), + QVariant::fromValue(container)); + } + ui->containerFormatBox->setCurrentIndex(currentIndex); + + m_updatingFormats = false; +} + +QVariant VideoSettings::boxValue(const QComboBox *box) const +{ + const int idx = box->currentIndex(); + return idx != -1 ? box->itemData(idx) : QVariant{}; +} + +void VideoSettings::selectComboBoxItem(QComboBox *box, const QVariant &value) +{ + const int idx = box->findData(value); + if (idx != -1) + box->setCurrentIndex(idx); +} + +#include "moc_videosettings.cpp" diff --git a/examples/multimedia/camera/videosettings.h b/examples/multimedia/camera/videosettings.h new file mode 100644 index 0000000..358b1fb --- /dev/null +++ b/examples/multimedia/camera/videosettings.h @@ -0,0 +1,42 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOSETTINGS_H +#define VIDEOSETTINGS_H + +#include + +QT_BEGIN_NAMESPACE +class QCameraFormat; +class QComboBox; +class QMediaRecorder; +namespace Ui { +class VideoSettingsUi; +} +QT_END_NAMESPACE + +class VideoSettings : public QDialog +{ + Q_OBJECT + +public: + explicit VideoSettings(QMediaRecorder *mediaRecorder, QWidget *parent = nullptr); + ~VideoSettings(); + + void applySettings(); + void updateFormatsAndCodecs(); + +protected: + void changeEvent(QEvent *e) override; + +private: + void setFpsRange(const QCameraFormat &format); + QVariant boxValue(const QComboBox *) const; + void selectComboBoxItem(QComboBox *box, const QVariant &value); + + Ui::VideoSettingsUi *ui; + QMediaRecorder *mediaRecorder; + bool m_updatingFormats = false; +}; + +#endif // VIDEOSETTINGS_H diff --git a/examples/multimedia/camera/videosettings.ui b/examples/multimedia/camera/videosettings.ui new file mode 100644 index 0000000..3c1f71f --- /dev/null +++ b/examples/multimedia/camera/videosettings.ui @@ -0,0 +1,213 @@ + + + VideoSettingsUi + + + + 0 + 0 + 686 + 499 + + + + Video Settings + + + + + + Qt::Horizontal + + + QDialogButtonBox::Cancel|QDialogButtonBox::Ok + + + + + + + Video + + + + + + Camera Format + + + + + + + + + + Framerate: + + + + + + + Video Codec: + + + + + + + + + + + + + + + Qt::Horizontal + + + + + + + + + + + + + 0 + 0 + + + + + 0 + + + 0 + + + 0 + + + 0 + + + + + Audio + + + + + + Audio Codec: + + + + + + + + + + Sample Rate: + + + + + + + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Horizontal + + + + + + + File Format: + + + + + + + + + + + + + + + + Qt::Vertical + + + + 20 + 40 + + + + + + + + + + buttonBox + accepted() + VideoSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + VideoSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/camera/videosettings_mobile.ui b/examples/multimedia/camera/videosettings_mobile.ui new file mode 100644 index 0000000..6584f07 --- /dev/null +++ b/examples/multimedia/camera/videosettings_mobile.ui @@ -0,0 +1,207 @@ + + + VideoSettingsUi + + + + 0 + 0 + 329 + 591 + + + + Video Settings + + + + + + + 0 + 0 + + + + + 0 + + + 0 + + + 0 + + + 0 + + + + + Audio + + + + + + Audio Codec: + + + + + + + + + + Sample Rate: + + + + + + + + + + + + + + + + Quality: + + + + + + + 4 + + + Qt::Horizontal + + + + + + + File Format: + + + + + + + + + + + + + + + + Video + + + + + + Frames per second: + + + + + + + + + + Camera Format: + + + + + + + Video Codec: + + + + + + + + + + Qt::Horizontal + + + QDialogButtonBox::Cancel|QDialogButtonBox::Ok + + + + + + + + + 8 + + + 30 + + + + + + + Qt::Horizontal + + + + + + + + + + + + + + buttonBox + accepted() + VideoSettingsUi + accept() + + + 322 + 272 + + + 44 + 230 + + + + + buttonBox + rejected() + VideoSettingsUi + reject() + + + 405 + 262 + + + 364 + 227 + + + + + diff --git a/examples/multimedia/declarative-camera/CMakeLists.txt b/examples/multimedia/declarative-camera/CMakeLists.txt new file mode 100644 index 0000000..cc6152c --- /dev/null +++ b/examples/multimedia/declarative-camera/CMakeLists.txt @@ -0,0 +1,77 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(declarative-camera LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/declarative-camera") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Qml Quick) + +qt_add_executable(declarative-camera + qmlcamera.cpp +) + +set_target_properties(declarative-camera PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in +) + +qt_add_ios_ffmpeg_libraries(declarative-camera) + +target_link_libraries(declarative-camera PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Qml + Qt::Quick +) + +# Resources: +set(declarative-camera_resource_files + "CameraButton.qml" + "CameraListButton.qml" + "CameraListPopup.qml" + "CameraPropertyButton.qml" + "CameraPropertyPopup.qml" + "FlashControl.qml" + "PhotoCaptureControls.qml" + "PhotoPreview.qml" + "Popup.qml" + "VideoCaptureControls.qml" + "VideoPreview.qml" + "ZoomControl.qml" + "declarative-camera.qml" + "images/camera_auto_mode.png" + "images/camera_camera_setting.png" + "images/camera_flash_auto.png" + "images/camera_flash_fill.png" + "images/camera_flash_off.png" + "images/camera_flash_redeye.png" + "images/camera_white_balance_cloudy.png" + "images/camera_white_balance_flourescent.png" + "images/camera_white_balance_incandescent.png" + "images/camera_white_balance_sunny.png" + "images/toolbutton.png" + "images/toolbutton.sci" +) + +qt_add_resources(declarative-camera "declarative-camera" + PREFIX + "/" + FILES + ${declarative-camera_resource_files} +) + +install(TARGETS declarative-camera + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/declarative-camera/CameraButton.qml b/examples/multimedia/declarative-camera/CameraButton.qml new file mode 100644 index 0000000..43837bc --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraButton.qml @@ -0,0 +1,41 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: button + + signal clicked + + property string text + property color color: "white" + + width : 144 + height: 70 + + BorderImage { + id: buttonImage + source: "images/toolbutton.sci" + width: button.width; height: button.height + } + MouseArea { + id: mouseRegion + anchors.fill: buttonImage + onClicked: { button.clicked(); } + } + Text { + id: btnText + anchors.fill: buttonImage + anchors.margins: 5 + text: button.text + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + elide: Text.ElideRight + color: button.color + font.bold: true + style: Text.Raised + styleColor: "black" + font.pixelSize: 14 + } +} diff --git a/examples/multimedia/declarative-camera/CameraListButton.qml b/examples/multimedia/declarative-camera/CameraListButton.qml new file mode 100644 index 0000000..b6361ea --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraListButton.qml @@ -0,0 +1,74 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Item { + id: cameraListButton + property alias value : popup.currentValue + property alias model : popup.model + + width : 144 + height: 70 + visible: model.length > 0 + + BorderImage { + id: buttonImage + source: "images/toolbutton.sci" + width: cameraListButton.width; height: cameraListButton.height + } + + CameraButton { + anchors.fill: parent + text: popup.currentItem !== null ? popup.currentItem.description : "" + + onClicked: popup.toggle() + } + + CameraListPopup { + id: popup + anchors.rightMargin: 16 + visible: opacity > 0 + model: mediaDevices.videoInputs + + MediaDevices { + id: mediaDevices + } + + onSelected: popup.toggle() + } + + states: [ + State { + name: "MobilePortrait" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.bottom: cameraListButton.top + anchors.left: cameraListButton.left + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.top: cameraListButton.top + anchors.right: cameraListButton.left + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.top: cameraListButton.top + anchors.right: cameraListButton.left + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/CameraListPopup.qml b/examples/multimedia/declarative-camera/CameraListPopup.qml new file mode 100644 index 0000000..83c9843 --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraListPopup.qml @@ -0,0 +1,66 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma ComponentBehavior: Bound +import QtQuick +import QtMultimedia + +Popup { + id: cameraListPopup + + property alias model : view.model + property cameraDevice currentValue + property cameraDevice currentItem : model[view.currentIndex] + + property int itemWidth : 200 + property int itemHeight : 50 + + width: itemWidth + view.anchors.margins*2 + height: view.count * itemHeight + view.anchors.margins*2 + + signal selected + + ListView { + id: view + anchors.fill: parent + anchors.margins: 5 + snapMode: ListView.SnapOneItem + highlightFollowsCurrentItem: true + highlight: Rectangle { color: "gray"; radius: 5 } + currentIndex: 0 + clip: true + + delegate: Item { + id: cameraListItem + + required property int index + required property cameraDevice modelData + + width: cameraListPopup.itemWidth + height: cameraListPopup.itemHeight + + Text { + text: cameraListItem.modelData.description + + anchors.fill: parent + anchors.margins: 5 + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + elide: Text.ElideRight + color: "white" + font.bold: true + style: Text.Raised + styleColor: "black" + font.pixelSize: 14 + } + MouseArea { + anchors.fill: parent + onClicked: { + view.currentIndex = cameraListItem.index + cameraListPopup.currentValue = cameraListItem.modelData + cameraListPopup.selected() + } + } + } + } +} diff --git a/examples/multimedia/declarative-camera/CameraPropertyButton.qml b/examples/multimedia/declarative-camera/CameraPropertyButton.qml new file mode 100644 index 0000000..3a9e60a --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraPropertyButton.qml @@ -0,0 +1,72 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: propertyButton + property alias value : popup.currentValue + property alias model : popup.model + + width : 144 + height: 70 + + BorderImage { + id: buttonImage + source: "images/toolbutton.sci" + width: propertyButton.width; height: propertyButton.height + } + + CameraButton { + anchors.fill: parent + Image { + anchors.centerIn: parent + source: popup.currentItem.icon + } + + onClicked: popup.toggle() + } + + CameraPropertyPopup { + id: popup + anchors.rightMargin: 16 + visible: opacity > 0 + + currentValue: propertyButton.value + + onSelected: popup.toggle() + } + + states: [ + State { + name: "MobilePortrait" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.bottom: propertyButton.top + anchors.left: propertyButton.left + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.verticalCenter: propertyButton.top + anchors.right: propertyButton.left + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + AnchorChanges { + target: popup + // qmllint disable incompatible-type + anchors.top: propertyButton.top + anchors.right: propertyButton.left + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/CameraPropertyPopup.qml b/examples/multimedia/declarative-camera/CameraPropertyPopup.qml new file mode 100644 index 0000000..774775a --- /dev/null +++ b/examples/multimedia/declarative-camera/CameraPropertyPopup.qml @@ -0,0 +1,81 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma ComponentBehavior: Bound +import QtQuick + +Popup { + id: propertyPopup + + property alias model : view.model + property var currentValue + property var currentItem : model.get(view.currentIndex) + + property int itemWidth : 100 + property int itemHeight : 70 + property int columns : 2 + + width: columns*itemWidth + view.anchors.margins*2 + height: Math.ceil(model.count/columns)*itemHeight + view.anchors.margins*2 + 25 + + signal selected + + function indexForValue(value) { + for (var i = 0; i < view.count; i++) { + if (model.get(i).value == value) { + return i; + } + } + + return 0; + } + + GridView { + id: view + anchors.fill: parent + anchors.margins: 5 + cellWidth: propertyPopup.itemWidth + cellHeight: propertyPopup.itemHeight + snapMode: ListView.SnapOneItem + highlightFollowsCurrentItem: true + highlight: Rectangle { color: "gray"; radius: 5 } + currentIndex: propertyPopup.indexForValue(propertyPopup.currentValue) + + delegate: Item { + id: propertyItem + + required property url icon + required property var value + + width: propertyPopup.itemWidth + height: 70 + + Image { + anchors.centerIn: parent + source: propertyItem.icon + } + MouseArea { + anchors.fill: parent + onClicked: { + propertyPopup.currentValue = propertyItem.value + propertyPopup.selected() + } + } + } + } + + Text { + anchors.bottom: parent.bottom + anchors.bottomMargin: 8 + anchors.left: parent.left + anchors.leftMargin: 16 + + color: "#ffffff" + font.bold: true + style: Text.Raised; + styleColor: "black" + font.pixelSize: 14 + + text: view.model.get(view.currentIndex).text + } +} diff --git a/examples/multimedia/declarative-camera/FlashControl.qml b/examples/multimedia/declarative-camera/FlashControl.qml new file mode 100644 index 0000000..61550f0 --- /dev/null +++ b/examples/multimedia/declarative-camera/FlashControl.qml @@ -0,0 +1,65 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Item { + id: flashControl + + height: column.height + + property Camera cameraDevice + property bool mIsFlashSupported: (cameraDevice && cameraDevice.active) ? cameraDevice.isFlashModeSupported(Camera.FlashOn) : false + property bool mIsTorchSupported: (cameraDevice && cameraDevice.active) ? cameraDevice.isTorchModeSupported(Camera.TorchOn) : false + + Column { + id: column + + Switch { + id: flashModeControl + visible: flashControl.mIsFlashSupported + opacity: checked ? 0.75 : 0.25 + text: "Flash" + contentItem: Text { + text: flashModeControl.text + color: "white" + leftPadding: flashModeControl.indicator.width + flashModeControl.spacing + } + + onPositionChanged: { + if (position) { + if (torchModeControl.checked) + torchModeControl.toggle(); + flashControl.cameraDevice.flashMode = Camera.FlashOn + + } else { + flashControl.cameraDevice.flashMode = Camera.FlashOff + } + } + } + + Switch { + id: torchModeControl + visible: flashControl.mIsTorchSupported + opacity: checked ? 0.75 : 0.25 + text: "Torch" + contentItem: Text { + text: torchModeControl.text + color: "white" + leftPadding: torchModeControl.indicator.width + torchModeControl.spacing + } + + onPositionChanged: { + if (position) { + if (flashModeControl.checked) + flashModeControl.toggle(); + flashControl.cameraDevice.torchMode = Camera.TorchOn + } else { + flashControl.cameraDevice.torchMode = Camera.TorchOff + } + } + } + } +} diff --git a/examples/multimedia/declarative-camera/Info.plist b/examples/multimedia/declarative-camera/Info.plist new file mode 100644 index 0000000..7a1b26e --- /dev/null +++ b/examples/multimedia/declarative-camera/Info.plist @@ -0,0 +1,43 @@ + + + + + CFBundleIconFile + + CFBundlePackageType + APPL + CFBundleGetInfoString + Created by Qt/QMake + CFBundleSignature + ???? + CFBundleExecutable + declarative-camera + CFBundleIdentifier + ${PRODUCT_BUNDLE_IDENTIFIER} + CFBundleDisplayName + declarative-camera + CFBundleName + declarative-camera + CFBundleShortVersionString + 1.0 + CFBundleVersion + 1.0 + LSRequiresIPhoneOS + + UILaunchStoryboardName + LaunchScreen + UISupportedInterfaceOrientations + + UIInterfaceOrientationPortrait + UIInterfaceOrientationPortraitUpsideDown + UIInterfaceOrientationLandscapeLeft + UIInterfaceOrientationLandscapeRight + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + NOTE + This file was generated by Qt/QMake. + + diff --git a/examples/multimedia/declarative-camera/Info.plist.in b/examples/multimedia/declarative-camera/Info.plist.in new file mode 100644 index 0000000..46a9ecf --- /dev/null +++ b/examples/multimedia/declarative-camera/Info.plist.in @@ -0,0 +1,46 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/declarative-camera/PhotoCaptureControls.qml b/examples/multimedia/declarative-camera/PhotoCaptureControls.qml new file mode 100644 index 0000000..8593a7c --- /dev/null +++ b/examples/multimedia/declarative-camera/PhotoCaptureControls.qml @@ -0,0 +1,231 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia +import QtQuick.Layouts + +FocusScope { + id : captureControls + property CaptureSession captureSession + property bool previewAvailable : false + + property int buttonsmargin: 8 + property int buttonsPanelWidth + property int buttonsPanelPortraitHeight + property int buttonsWidth + + signal previewSelected + signal videoModeSelected + + Rectangle { + id: buttonPaneShadow + color: Qt.rgba(0.08, 0.08, 0.08, 1) + + GridLayout { + id: buttonsColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + CameraButton { + text: "Capture" + implicitWidth: captureControls.buttonsWidth + visible: captureControls.captureSession.imageCapture.readyForCapture + onClicked: captureControls.captureSession.imageCapture.captureToFile("") + } + + CameraPropertyButton { + id : wbModesButton + implicitWidth: captureControls.buttonsWidth + state: captureControls.state + value: Camera.WhiteBalanceAuto + model: ListModel { + ListElement { + icon: "images/camera_auto_mode.png" + value: Camera.WhiteBalanceAuto + text: "Auto" + } + ListElement { + icon: "images/camera_white_balance_sunny.png" + value: Camera.WhiteBalanceSunlight + text: "Sunlight" + } + ListElement { + icon: "images/camera_white_balance_cloudy.png" + value: Camera.WhiteBalanceCloudy + text: "Cloudy" + } + ListElement { + icon: "images/camera_white_balance_incandescent.png" + value: Camera.WhiteBalanceTungsten + text: "Tungsten" + } + ListElement { + icon: "images/camera_white_balance_flourescent.png" + value: Camera.WhiteBalanceFluorescent + text: "Fluorescent" + } + } + onValueChanged: captureControls.captureSession.camera.whiteBalanceMode = wbModesButton.value + } + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "View" + anchors.fill: parent + onClicked: captureControls.previewSelected() + visible: captureControls.previewAvailable + } + } + } + + GridLayout { + id: bottomColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + + CameraListButton { + implicitWidth: captureControls.buttonsWidth + state: captureControls.state + onValueChanged: captureControls.captureSession.camera.cameraDevice = value + } + + CameraButton { + text: "Switch to Video" + implicitWidth: captureControls.buttonsWidth + onClicked: captureControls.videoModeSelected() + } + + CameraButton { + id: quitButton + implicitWidth: captureControls.buttonsWidth + text: "Quit" + onClicked: Qt.quit() + } + } + } + + ZoomControl { + id: zoomControl + x : 0 + y : 0 + width : 100 + height: parent.height - (flashControl.visible * flashControl.height) - + (captureControls.state === "MobilePortrait" ? buttonPaneShadow.height : 0) + + currentZoom: captureControls.captureSession.camera.zoomFactor + maximumZoom: captureControls.captureSession.camera.maximumZoomFactor + minimumZoom: captureControls.captureSession.camera.minimumZoomFactor + onZoomTo: (target) => captureControls.captureSession.camera.zoomFactor = target + } + + FlashControl { + id: flashControl + x : 10 + y : captureControls.state === "MobilePortrait" ? + parent.height - (buttonPaneShadow.height + height) : parent.height - height + + cameraDevice: captureControls.captureSession.camera + } + + states: [ + State { + name: "MobilePortrait" + PropertyChanges { + buttonPaneShadow.width: parent.width + buttonPaneShadow.height: captureControls.buttonsPanelPortraitHeight + buttonsColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + bottomColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.bottom: captureControls.bottom + anchors.left: captureControls.left + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + anchors.top: buttonPaneShadow.top + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + PropertyChanges { + buttonPaneShadow.width: buttonsPanelWidth + buttonPaneShadow.height: parent.height + buttonsColumn.height: parent.height + buttonsColumn.width: buttonPaneShadow.width / 2 + bottomColumn.height: parent.height + bottomColumn.width: buttonPaneShadow.width / 2 + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + PropertyChanges { + buttonPaneShadow.width: bottomColumn.width + 16 + buttonPaneShadow.height: parent.height + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/PhotoPreview.qml b/examples/multimedia/declarative-camera/PhotoPreview.qml new file mode 100644 index 0000000..98af8a1 --- /dev/null +++ b/examples/multimedia/declarative-camera/PhotoPreview.qml @@ -0,0 +1,24 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias source : preview.source + signal closed + + Image { + id: preview + anchors.fill : parent + fillMode: Image.PreserveAspectFit + smooth: true + } + + MouseArea { + anchors.fill: parent + onClicked: { + parent.closed(); + } + } +} + diff --git a/examples/multimedia/declarative-camera/Popup.qml b/examples/multimedia/declarative-camera/Popup.qml new file mode 100644 index 0000000..fc57f30 --- /dev/null +++ b/examples/multimedia/declarative-camera/Popup.qml @@ -0,0 +1,39 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + id: popup + + radius: 5 + border.color: "#000000" + border.width: 2 + smooth: true + color: "#5e5e5e" + + state: "invisible" + + states: [ + State { + name: "invisible" + PropertyChanges { popup.opacity: 0 } + }, + + State { + name: "visible" + PropertyChanges { popup.opacity: 1.0 } + } + ] + + transitions: Transition { + NumberAnimation { properties: "opacity"; duration: 100 } + } + + function toggle() { + if (state == "visible") + state = "invisible"; + else + state = "visible"; + } +} diff --git a/examples/multimedia/declarative-camera/VideoCaptureControls.qml b/examples/multimedia/declarative-camera/VideoCaptureControls.qml new file mode 100644 index 0000000..f30849d --- /dev/null +++ b/examples/multimedia/declarative-camera/VideoCaptureControls.qml @@ -0,0 +1,213 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia +import QtQuick.Layouts + +FocusScope { + id : captureControls + property CaptureSession captureSession + property bool previewAvailable : false + + property int buttonsmargin: 8 + property int buttonsPanelWidth + property int buttonsPanelPortraitHeight + property int buttonsWidth + + signal previewSelected + signal photoModeSelected + + Rectangle { + id: buttonPaneShadow + color: Qt.rgba(0.08, 0.08, 0.08, 1) + + GridLayout { + id: buttonsColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "Record" + anchors.fill: parent + visible: captureControls.captureSession.recorder.recorderState !== MediaRecorder.RecordingState + onClicked: captureControls.captureSession.recorder.record() + } + } + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + id: stopButton + text: "Stop" + anchors.fill: parent + visible: captureControls.captureSession.recorder.recorderState === MediaRecorder.RecordingState + onClicked: captureControls.captureSession.recorder.stop() + } + } + + Item { + implicitWidth: captureControls.buttonsWidth + implicitHeight: 70 + CameraButton { + text: "View" + anchors.fill: parent + onClicked: captureControls.previewSelected() + //don't show View button during recording + visible: captureControls.captureSession.recorder.actualLocation.toString() !== "" + && !stopButton.visible + } + } + } + + GridLayout { + id: bottomColumn + anchors.margins: captureControls.buttonsmargin + flow: captureControls.state === "MobilePortrait" + ? GridLayout.LeftToRight : GridLayout.TopToBottom + + CameraListButton { + implicitWidth: captureControls.buttonsWidth + onValueChanged: captureControls.captureSession.camera.cameraDevice = value + state: captureControls.state + } + + CameraButton { + text: "Switch to Photo" + implicitWidth: captureControls.buttonsWidth + onClicked: captureControls.photoModeSelected() + } + + CameraButton { + id: quitButton + text: "Quit" + implicitWidth: captureControls.buttonsWidth + onClicked: Qt.quit() + } + } + } + + ZoomControl { + x : 0 + y : 0 + width : 100 + height: parent.height - (flashControl.visible * flashControl.height) - + (captureControls.state === "MobilePortrait" ? buttonPaneShadow.height : 0) + + currentZoom: captureControls.captureSession.camera.zoomFactor + maximumZoom: captureControls.captureSession.camera.maximumZoomFactor + minimumZoom: captureControls.captureSession.camera.minimumZoomFactor + onZoomTo: (target) => captureControls.captureSession.camera.zoomFactor = target + } + + FlashControl { + id: flashControl + x : 10 + y : captureControls.state === "MobilePortrait" ? + parent.height - (buttonPaneShadow.height + height) : parent.height - height + + cameraDevice: captureControls.captureSession.camera + } + + states: [ + State { + name: "MobilePortrait" + PropertyChanges { + buttonPaneShadow.width: parent.width + buttonPaneShadow.height: buttonsPanelPortraitHeight + buttonsColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + bottomColumn.height: captureControls.buttonsPanelPortraitHeight / 2 - buttonsmargin + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.bottom: captureControls.bottom + anchors.left: captureControls.left + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + anchors.top: buttonPaneShadow.top + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "MobileLandscape" + PropertyChanges { + buttonPaneShadow.width: buttonsPanelWidth + buttonPaneShadow.height: parent.height + buttonsColumn.height: parent.height + buttonsColumn.width: buttonPaneShadow.width / 2 + bottomColumn.height: parent.height + bottomColumn.width: buttonPaneShadow.width / 2 + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.left: buttonPaneShadow.left + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + }, + State { + name: "Other" + PropertyChanges { + buttonPaneShadow.width: bottomColumn.width + 16 + buttonPaneShadow.height: parent.height + } + AnchorChanges { + target: buttonPaneShadow + // qmllint disable incompatible-type + anchors.top: captureControls.top + anchors.right: captureControls.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: buttonsColumn + // qmllint disable incompatible-type + anchors.top: buttonPaneShadow.top + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + AnchorChanges { + target: bottomColumn + // qmllint disable incompatible-type + anchors.bottom: buttonPaneShadow.bottom + anchors.right: buttonPaneShadow.right + // qmllint enable incompatible-type + } + } + ] +} diff --git a/examples/multimedia/declarative-camera/VideoPreview.qml b/examples/multimedia/declarative-camera/VideoPreview.qml new file mode 100644 index 0000000..f7b3067 --- /dev/null +++ b/examples/multimedia/declarative-camera/VideoPreview.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Item { + id: videoPreview + property alias source : player.source + signal closed + + MediaPlayer { + id: player + + //switch back to viewfinder after playback finished + onMediaStatusChanged: { + if (mediaStatus == MediaPlayer.EndOfMedia) + videoPreview.closed(); + } + onSourceChanged: { + if (videoPreview.visible && source !== "") + play(); + } + + videoOutput: output + audioOutput: AudioOutput { + } + } + + VideoOutput { + id: output + anchors.fill : parent + } + + MouseArea { + anchors.fill: parent + onClicked: { + videoPreview.closed(); + } + } +} + diff --git a/examples/multimedia/declarative-camera/ZoomControl.qml b/examples/multimedia/declarative-camera/ZoomControl.qml new file mode 100644 index 0000000..8f6353b --- /dev/null +++ b/examples/multimedia/declarative-camera/ZoomControl.qml @@ -0,0 +1,80 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id : zoomControl + property real currentZoom : 1 + property real maximumZoom : 1 + property real minimumZoom : 1 + signal zoomTo(real target) + + visible: zoomControl.maximumZoom > zoomControl.minimumZoom + + MouseArea { + id : mouseArea + anchors.fill: parent + + property real initialZoom : 0 + property real initialPos : 0 + + onPressed: { + initialPos = mouseY + initialZoom = zoomControl.currentZoom + } + + onPositionChanged: { + if (pressed) { + var target = initialZoom * Math.pow(5, (initialPos-mouseY)/zoomControl.height); + target = Math.max(zoomControl.minimumZoom, Math.min(target, zoomControl.maximumZoom)) + zoomControl.zoomTo(target) + } + } + } + + Item { + id : bar + x : 16 + y : parent.height/4 + width : 24 + height : parent.height/2 + + Rectangle { + anchors.fill: parent + + smooth: true + radius: 8 + border.color: "white" + border.width: 2 + color: "black" + opacity: 0.3 + } + + Rectangle { + id: groove + x : 0 + y : parent.height * (1.0 - (zoomControl.currentZoom-zoomControl.minimumZoom) / (zoomControl.maximumZoom-zoomControl.minimumZoom)) + width: parent.width + height: parent.height - y + smooth: true + radius: 8 + color: "white" + opacity: 0.5 + } + + Text { + id: zoomText + anchors { + left: bar.right; leftMargin: 16 + } + y: Math.min(parent.height - height, Math.max(0, groove.y - height / 2)) + text: "x" + Math.round(zoomControl.currentZoom * 100) / 100 + font.bold: true + color: "white" + style: Text.Raised; styleColor: "black" + opacity: 0.85 + font.pixelSize: 18 + } + } +} diff --git a/examples/multimedia/declarative-camera/declarative-camera.pro b/examples/multimedia/declarative-camera/declarative-camera.pro new file mode 100644 index 0000000..621342b --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.pro @@ -0,0 +1,12 @@ +TEMPLATE=app +TARGET=declarative-camera + +QT += quick qml multimedia + +SOURCES += qmlcamera.cpp +RESOURCES += declarative-camera.qrc + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/declarative-camera +INSTALLS += target +include(../shared/shared.pri) + diff --git a/examples/multimedia/declarative-camera/declarative-camera.qml b/examples/multimedia/declarative-camera/declarative-camera.qml new file mode 100644 index 0000000..2447715 --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qml @@ -0,0 +1,147 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Rectangle { + id : cameraUI + + width: 800 + height: 480 + + color: "black" + state: "PhotoCapture" + + property string platformScreen: "" + property int buttonsPanelLandscapeWidth: cameraUI.width/2 + property int buttonsPanelPortraitHeight: cameraUI.height/3 + + states: [ + State { + name: "PhotoCapture" + StateChangeScript { + script: { + camera.start() + } + } + }, + State { + name: "PhotoPreview" + }, + State { + name: "VideoCapture" + StateChangeScript { + script: { + camera.start() + } + } + }, + State { + name: "VideoPreview" + StateChangeScript { + script: { + camera.stop() + } + } + } + ] + + CaptureSession { + id: captureSession + camera: Camera { + id: camera + } + imageCapture: ImageCapture { + id: imageCapture + } + + recorder: MediaRecorder { + id: recorder +// resolution: "640x480" +// frameRate: 30 + } + videoOutput: viewfinder + } + + PhotoPreview { + id : photoPreview + anchors.fill : parent + onClosed: cameraUI.state = "PhotoCapture" + visible: (cameraUI.state === "PhotoPreview") + focus: visible + source: imageCapture.preview + } + + VideoPreview { + id : videoPreview + anchors.fill : parent + onClosed: cameraUI.state = "VideoCapture" + visible: (cameraUI.state === "VideoPreview") + focus: visible + + //don't load recorded video if preview is invisible + source: visible ? recorder.actualLocation : "" + } + + VideoOutput { + id: viewfinder + visible: ((cameraUI.state === "PhotoCapture") || (cameraUI.state === "VideoCapture")) + anchors.fill: parent + // autoOrientation: true + } + + Item { + id: controlLayout + + readonly property bool isMobile: Qt.platform.os === "android" || Qt.platform.os === "ios" + readonly property bool isLandscape: Screen.desktopAvailableWidth >= Screen.desktopAvailableHeight + property int buttonsWidth: state === "MobilePortrait" ? Screen.desktopAvailableWidth / 3.4 : 114 + + states: [ + State { + name: "MobileLandscape" + when: controlLayout.isMobile && controlLayout.isLandscape + }, + State { + name: "MobilePortrait" + when: controlLayout.isMobile && !controlLayout.isLandscape + }, + State { + name: "Other" + when: !controlLayout.isMobile + } + ] + + onStateChanged: { + console.log("State: " + controlLayout.state) + } + } + + PhotoCaptureControls { + id: stillControls + state: controlLayout.state + anchors.fill: parent + buttonsWidth: controlLayout.buttonsWidth + buttonsPanelPortraitHeight: cameraUI.buttonsPanelPortraitHeight + buttonsPanelWidth: cameraUI.buttonsPanelLandscapeWidth + captureSession: captureSession + visible: (cameraUI.state === "PhotoCapture") + onPreviewSelected: cameraUI.state = "PhotoPreview" + onVideoModeSelected: cameraUI.state = "VideoCapture" + previewAvailable: imageCapture.preview.length !== 0 + } + + VideoCaptureControls { + id: videoControls + state: controlLayout.state + anchors.fill: parent + buttonsWidth: controlLayout.buttonsWidth + buttonsPanelPortraitHeight: cameraUI.buttonsPanelPortraitHeight + buttonsPanelWidth: cameraUI.buttonsPanelLandscapeWidth + captureSession: captureSession + visible: (cameraUI.state === "VideoCapture") + onPreviewSelected: cameraUI.state = "VideoPreview" + onPhotoModeSelected: cameraUI.state = "PhotoCapture" + } +} diff --git a/examples/multimedia/declarative-camera/declarative-camera.qmlproject b/examples/multimedia/declarative-camera/declarative-camera.qmlproject new file mode 100644 index 0000000..53f5ecb --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qmlproject @@ -0,0 +1,18 @@ +/* File generated by QtCreator */ + +import QmlProject 1.0 + +Project { + /* Include .qml, .js, and image files from current directory and subdirectories */ + QmlFiles { + directory: "." + } + JavaScriptFiles { + directory: "." + } + ImageFiles { + directory: "." + } + /* List of plugin directories passed to QML runtime */ + // importPaths: [ "../exampleplugin" ] +} diff --git a/examples/multimedia/declarative-camera/declarative-camera.qrc b/examples/multimedia/declarative-camera/declarative-camera.qrc new file mode 100644 index 0000000..ddfcefa --- /dev/null +++ b/examples/multimedia/declarative-camera/declarative-camera.qrc @@ -0,0 +1,29 @@ + + + PhotoPreview.qml + ZoomControl.qml + VideoCaptureControls.qml + VideoPreview.qml + PhotoCaptureControls.qml + declarative-camera.qml + Popup.qml + CameraPropertyPopup.qml + CameraPropertyButton.qml + CameraButton.qml + CameraListPopup.qml + CameraListButton.qml + FlashControl.qml + images/camera_auto_mode.png + images/camera_camera_setting.png + images/camera_flash_auto.png + images/camera_flash_fill.png + images/camera_flash_off.png + images/camera_flash_redeye.png + images/camera_white_balance_cloudy.png + images/camera_white_balance_flourescent.png + images/camera_white_balance_incandescent.png + images/camera_white_balance_sunny.png + images/toolbutton.png + images/toolbutton.sci + + diff --git a/examples/multimedia/declarative-camera/doc/images/CaptureControls.png b/examples/multimedia/declarative-camera/doc/images/CaptureControls.png new file mode 100644 index 0000000000000000000000000000000000000000..8c24d80305e725b2cd9d6a89aa830e65cb82bd71 GIT binary patch literal 41278 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 elLc(xX7@SOHJdi@+Tolm%m-#?J@K!L&}oSP literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/FlashControls.png b/examples/multimedia/declarative-camera/doc/images/FlashControls.png new file mode 100644 index 0000000000000000000000000000000000000000..93eec867bfbc1800688703d51f5931c692ec38bb GIT binary patch literal 69725 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 XAO#$QvelUM00000NkvXXu0mjfNWUN` literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png b/examples/multimedia/declarative-camera/doc/images/VideoCaptureControls.png new file mode 100644 index 0000000000000000000000000000000000000000..c35be7beb5de451441e1701c802debdb8afda75b GIT binary patch literal 35913 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/ZoomControl.png b/examples/multimedia/declarative-camera/doc/images/ZoomControl.png new file mode 100644 index 0000000000000000000000000000000000000000..d628e60f1d29be481abc7ee3e90185baad249632 GIT binary patch literal 28291 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 N002ovPDHLkV1nTURu%vN literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png b/examples/multimedia/declarative-camera/doc/images/qml-declarative-portrait.png new file mode 100644 index 0000000000000000000000000000000000000000..7adfdb0210467aa60d62420a1d4205340f54b119 GIT binary patch literal 49057 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc b/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc new file mode 100644 index 0000000..c6701a6 --- /dev/null +++ b/examples/multimedia/declarative-camera/doc/src/declarative-camera.qdoc @@ -0,0 +1,158 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! +\example declarative-camera +\title QML Camera Application +\ingroup multimedia_examples +\ingroup camera_examples_qml +\examplecategory {Multimedia} +\examplecategory {Mobile} +\brief This Qt Quick based application shows how to use the API to capture a +still image or video. + +\image qml-camera.png + +This example demonstrates how to access camera functions via QML. +It shows how to change settings and capture images or video. + +\include examples-run.qdocinc + +\section1 Application structure + +Most of the QML code in this example supports the user interface. Custom types +that support the requirements have been implemented using existing Qt Quick +controls. + +\section1 Using screen orientation to select layout + +The orientation and control layout state logic is encapsulated in a separate +Item, \c controlLayout like so: + +\quotefromfile declarative-camera/declarative-camera.qml +\skipto Item { +\printuntil /^ }/ + +The \c stillControls and \c videoControls objects both bind to the \c state +and \c buttonsWidth properties of this Item, as shown in \c stillControls: + +\skipto PhotoCaptureControls +\printuntil /^ }/ + +To support debugging, a message about layout state change is logged. + +Here is the portrait layout: + +\image qml-declarative-portrait.png + +You can see the \c state property is initially set as \c PhotoCapture. + +Then the \c states themselves are defined like so: + +\quotefromfile declarative-camera/declarative-camera.qml +\skipto states: [ +\printuntil /^ ]/ + +\section1 Controls for capturing + +Controls for capturing are implemented in \c PhotoCaptureControls.qml and +VideoCaptureControls.qml. They each are based on a \l FocusScope that defines +common buttons dimensions and margins that are used by the control buttons and +then declares the buttons. + +This generates a column on the right hand side of the screen which includes, +listed top to bottom, the following controls: +\div {class="multi-column"} + \div {class="doc-column"} + \list + \li A \c Capture or \c Record button, which initiates capturing. + \li A \c{capture properties} button that displays the icon of the current + white balance mode selected and when pressed uses a pop-up to displays + the following option's icons: + \list + \li Flash mode (if available) + \li White balance modes + \li Exposure compensation + \endlist + \li A \c View button, once something has been captured. + \li A button which displays the currently selected capture device and + when pressed provides a list of available devices to switch to, using a + pop-up. + \li A \c{Switch To} button that displays the alternate capture mode + (video or photo) depending on the current active selection and switches + the mode when pressed. + \li A \c Quit button, that exits the application. + \endlist + \enddiv + \div {class="doc-column"} + \inlineimage CaptureControls.png + \enddiv + \div {class="doc-column"} + \inlineimage VideoCaptureControls.png + \enddiv +\enddiv + +\section1 Image capturing + +The button that triggers this is defined in CameraButton.qml: +but its interaction with the camera is in the controls types, lets look at +PhotoCaptureControls: + +\quotefromfile declarative-camera/PhotoCaptureControls.qml +\skipto CameraButton { +\printto CameraPropertyButton { + +\section1 Zoom control + +\div {class="multi-column"} + \div {class="doc-column"} + Implemented in \c ZoomControl.qml the ZoomControl type is based on an Item + and creates a bar that represents the zoom level, which can also be dragged. + It uses an exponential calculation method to determine the zoom factor given + the position of the \c grove. + + The bar is only visible if the initialZoom is greater than 1. This means + the currently active camera has a zoom function. + \enddiv + \div {class="doc-column"} + \inlineimage ZoomControl.png + \enddiv +\enddiv + +\quotefromfile declarative-camera/ZoomControl.qml +\skipto Item { +\printuntil font.pixelSize: 18 + +In PhotoCaptureControls.qml and VideoCaptureControls.qml the signal \c zoomTo +will set the selected camera's \l{Camera::}{zoomFactor} property to the +calculated \c target value, as well as updating the ZoomControl bar. + +\quotefromfile declarative-camera/VideoCaptureControls.qml +\skipto ZoomControl { +\printto FlashControl { + +\section1 Flash and torch control + +\image FlashControls.png + +Defined in \c FlashControl.qml this enables flash mode selection and torch +functionality to be toggled via a Switch. As with the zoom control, the switches +are only visible on top of the preview window if the active device supports +these functions. + +Here we check if the functions are supported: + +\quotefromfile declarative-camera/FlashControl.qml +\skipto property Camera cameraDevice +\printline Camera +\printline FlashOn +\printline TorchOn + +Here we implement the \c flashModeControl switch, which also directly controls +the Camera device. + +\skipto Switch { +\printuntil /^ }/ + +Torch control is implemented in a similar way. +*/ diff --git a/examples/multimedia/declarative-camera/images/camera_auto_mode.png b/examples/multimedia/declarative-camera/images/camera_auto_mode.png new file mode 100644 index 0000000000000000000000000000000000000000..f168296cf7df6b421cdb2e3abc88becd9e690fd4 GIT binary patch literal 778 zcmV+l1NHogP)u=_1Jh6@VZNL!}$G+pXa^j?KisI)G4x|CCvv0N}w&!iv5t0PgB%S!T3t zD+3U&4S>u4)9EyT;DzhDpaXd6uLZyo)qj|LQ51S ziPTo;v=Ya|;V?O|G)>{=T-M<3K-X$yT>dle!$U37foqF9uk$>I8>>;Kq~?z4zx`)~OjSme53lA%Ptyk-P?b^T!>a{nlxSO_0zmojY9WAtS_2K(WL`v3ggsX8cs7Jr zjwvW4J-lKi5>{;^xqf5~ZM4nwsVF4uzHoR|mP6UTAjZnD{Q#o_lY;*O|6|Ot6iPZk zXuy&=N%&=^|I9%_rZ>g225Vd_jqhD3XzLARNxB2{6;sfBH1NaqS0C@-H&$Q32k^lez07*qo IM6N<$g5oV@QUCw| literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_camera_setting.png b/examples/multimedia/declarative-camera/images/camera_camera_setting.png new file mode 100644 index 0000000000000000000000000000000000000000..7b993eee93662d696b25c3eb4b96d7ec5757261c GIT binary patch literal 717 zcmV;;0y6!HP)bH=IIl~g3AGrrD@vSL=yt%HaVbAzVGAOJ_kT9^>ZT)h!o!$ zlIMAR0GKH*H3GtiYYdIP_`Z?QaZjZfKpoSS0t8Bhx^=&yd_d&|OAtp0;#=y02vs`| zZMR!Nvm6V63pe;n9SFCbHoI=uC)ahgOA6IQR`!i1LBIu?_jO&1F~YSe4|rSv5k_gK zBpBQADIms_64j7Tn*iuSi~(q-MAJ@A4KcQuOOSB5H3mYb8ZA{a>s$~z0M42qbk_q7 z1PU;fGJ$h;GFi|#v_;a){g=}yUQqxd!y@nzH(U@?tjJsf$*CY~EvI%=m?akk_mc9; zB~_IHlo2e8c^oKB}>5CqoweAc?iX0yS|d3avslhKoC z*APp%kTC?gPqjo48$%%T(;kw)764@k9HZ@*WQjar1c99k^80j&Ol$;k@$*zX_wKY2 z1d2f#^_-&`<%USf{4om}`|)3i2f#lE_!3|MIHUNiiFANx00000NkvXXu0mjfca||B literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_auto.png b/examples/multimedia/declarative-camera/images/camera_flash_auto.png new file mode 100644 index 0000000000000000000000000000000000000000..fb5cc40eca5542c84909b6527d8be6d0eae93882 GIT binary patch literal 1119 zcmV-l1fctgP)bvAu(nqJ9C491T|o`3C(a)GoRXvV3icC%+(oc)48m27`h0;`w}brqd~Y z_Nbj~1ISJmThp`O?RHb01wnv^?o0*~ea-y+;s8RLeQf{;kovjz7(ln(Zl_6-D4k!g z*LYxTI^eAXSbCnPoqgAJ@j&k$187rA;y6}1e>@)Xu!Q^GT>u_tS7&%TcuO{e-ZFp~ z_*NP60{$RR?lAzjN$UKL0CsS&DeAm+0DwfJ)L9k4V+{v;ifd>~B<_4PFig6OfM(mhcWIZsbdxo|sM`Wlh1mr6CNu|8q9b2uEN7l*?k zgqhNL81AJBz|Xyn=Ma2vZ*O?;=$ZhAa8h$Idyvk2-_M$@;T{U$-6%11?4slLFbvav zzn?a3AOvVCAmCaS(n^E$<7O=b)iGwRP{l%~Neui)@9+QL;(ot(CX>mhPQX7}uh+A| zrK5u;#yXu&Gy1ueP4Ht~{I6E4QUK`l^74XYI~a@!HuJ?X#H1(ZF>71n;$VXRT+4`X z+3j}!UUw6MZ#*7jyr79noEGtqgvB`=6(a3w!H4JZSnX>AD2X!`W2sE@fQbxrPNm>m zEEX7NT_q(R>fj$0^#h`1sBwcDK+{D z|BTHNKr|-}+ZCBhoL*X85%)V)yUjU7FxyOrwG8*p=kpwn zTU#0pP)zC?%Yd|MZ?u9+lOh?|vXGQvObw3H7)Ll^I}UGpB_fmA%4uNu6NK5KkoHJ8iFHCo-P3ypb@al*X!Q>4n z_Kb>|i`kt#KR+L^hXmPhxm;%2C1Z`9xi0JQj%4d_s`;R?k=&Ch0l-J`>2+h{ywPXY lpJu=RYVaGtmG)PF0RV%Gi7~j*Q4jzC002ovPDHLkV1lGG4d?&> literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_fill.png b/examples/multimedia/declarative-camera/images/camera_flash_fill.png new file mode 100644 index 0000000000000000000000000000000000000000..7bc5949ace84ea99d6774b77645ba59848e01432 GIT binary patch literal 610 zcmV-o0-gPdP)t09LJmb zj2eKb>)NZn5CRv`IqNbPz+j9CQ6HnG2EZfKH@Q1w4uD=MwVC`hO_nhht^OGRH4;OD zTLHj5>Yo8%q?DoRb7}yX4%gxgP`^LQ9i#wg6s9jw;Ct0S65whZeCngMrl@};fC{k< zPJKZUz-!u^`Y8jJLmUARWZF`rZCiYyJOW_!*@o0un!elsL8dJ=mZmQ^KzEY*ciWL0 zKqnTa*LFOczB3mzzA(NU-z&>a1t7+Dm{Lp1B=y%UHwAzo+p%W)C;+Gk^*J?wpuHlk z^{VMB4G?4cI5hwkVfuzrOG>`A7aF1d+K`6>p!kMi$Z99>tGS|9XG|fH6T%hreIaz( z)?z9ITB-9v<2;%oyVH9i@R_D*ZmpD+>_Qq4zPs)+u%msO?^N2Tfto(sys!`GVl9R9 zfnW$c?+!YK<$R}hBYO#f`R;nZ2|4H}Z6zKc7F#Wn;t|v8_B$Y4i=2E@CIz7KC0SL~ wUPt=l9)Hi{Hx?i?D*O4b#0TJi1N;dv05OxGiQ*@g*#H0l07*qoM6N<$g5Vniv;Y7A literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_off.png b/examples/multimedia/declarative-camera/images/camera_flash_off.png new file mode 100644 index 0000000000000000000000000000000000000000..3c5db10ccf41484d22ac1867154fe3a980c43b37 GIT binary patch literal 717 zcmV;;0y6!HP)>jIJQCpI z{<17l@$`Pc{cQ0_08P#^-Pb7bNC2+;#)*cAM*$2R_m9V;?>@Jyw?jQuWK7tV5_gCrSRk9A;Ah`E!LJ;)Vwaj!Vtelm&cc)zX<0FZ7 z59`=@zg8B?J>{chip&9M-v2A{2KeUyKLQK@8$C30j-lcj00000NkvXXu0mjfY{f?I literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_flash_redeye.png b/examples/multimedia/declarative-camera/images/camera_flash_redeye.png new file mode 100644 index 0000000000000000000000000000000000000000..534a087df5c9a8418c7ccd2b7477e3a24dbdf629 GIT binary patch literal 945 zcmV;i15W&jP)D1AqvSNZ()ssXij>;2bY z2H-FPFf1HwoTd zuh-6UxdgrD&*;@=1^nS~m?7e7Bo~WCAwZQ8jpMjT)3mtX@0It^hCaL_=vI#5D~I2{ z@56ya21;uMbOA&#$_>JC7=$KCQgIfJ;(amhAT$Nl;5Z+TcL+2GivS@|Vw~3%fEY$d zU<}cN3sNP4;|DM1Mt~w zR#^=ejPO+eAtqI60T6Y9ei`|vsdq3K+|@lo^nr~U5S}Rj7fVPJk@Iy%NkD_9&8O}u zl}c)$$QJeu0L#>^4Im+Y>o|`-Y*vHw$mOg13q z{tglcXs!BNSIp(7(<#RRgQH(Z`hAo>&Zx^GEeL|rKKXz{Qr1#h2iXFMbtzQ*9he#T zH>3FU)yyc3a*7knWIzWooVFXVH!^NRhY~(0IBNY&M(g?RNWY zx}|k>BLl}%L`$Vm-R5rU!^%mzXdQ%YDD-GWVr(|L%rrR+{(~}bS{7-E$#t>|3Oxf8 z$gdG2u`w%OCC=wF=z)`TC%;VK`MdM4686KE1z-VK02Y7+U;$VF7Qp++9{~mc-o!=J TUU;|s00000NkvXXu0mjfFioSw literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_white_balance_cloudy.png b/examples/multimedia/declarative-camera/images/camera_white_balance_cloudy.png new file mode 100644 index 0000000000000000000000000000000000000000..243b699e7b1466263409222807e00eca55209971 GIT binary patch literal 625 zcmV-%0*?KOP)4+Rj)k)%K<2tG9V^TR`oSXPfo156LJj*Xn*$jAzHM7#S=Q)f&@>H+ zqUh2F0@sMs>D2RFd7UZ;e3r0uDj}bEu4JM!AX^8l{eC~$o{qLL6S}Sk?9$z2Au|kv zq-lzu>1Hc&5CnuRB_x^sXn-T8cn+a3^6D;UCH_j@t6jhp&$X1s6^8G^6xP@ouz#Z% z%_ZzeymF5&WEgdtBne$YaU4@#I2^7O+m{7Ewe3Vq+8oOW19=M} z0+7fWwJC*Fz#$w_fOZX|e=Fo6`XvfL*C>2@U@6_}g%+*OzZJI40PxRMLj<6~x9mzK z1W*-4u~vXy1fWaX)OU)Iv5-wht)4U1zqFUC>l{f}jgPq`>$d(1b z0aOQ5wE`RAk3Ckwi^0PAo3nTmJ{wiX>k2>tC;$bZ02IKC`V?RQzD}FX)F>om00000 LNkvXXu0mjf0G1Bc literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/camera_white_balance_flourescent.png b/examples/multimedia/declarative-camera/images/camera_white_balance_flourescent.png new file mode 100644 index 0000000000000000000000000000000000000000..032efe1d1f93b35993cd9135ac63c82f96e9f477 GIT binary patch literal 554 zcmV+_0@eMAP)VHO{8#Egb zCSU~EAnF9LK}K*kU<9v_4LkzffchaD8FLVV`H`siBr6d- zfB_hQ0T_S*7=Qr+^ywdn<5=jAuNRH?u3tWXRspn5Qp(dSMxW>T;|gf~p3i6A0}Q|b z48Q>Y7vQd+#t}8Dsv1pA(>(OtZnt4r;T$yw*Lvi^Ky0&U@w<>a7L@4GDW!U=BuQY- ze2;#LkDfG5hhc?t@EEUEhHF`24Z^b=??!;SD2j0rAq0%l^ORYZ`5uLV?^f`@>&=y} z2Ww%?BLQZaC4x|G+fso}z~C`p6ZnNn9RhGf03ito1~}pt2)PA=0E&Y);qE4Y7(xIh znJvqb+FWg2*S<#(l@vH=5F0W}WmT*^ID@ab72uF;5elyAR)9&@Sh!y=MAwiTUSA~9)h=uM%I#`f z0kHEGx&Rhi$n3ZET(4KMV=Sof<|uQmS*5VH<07Fz2Cg|VtCe^!BLxEx3uB7xVJzcGj- zfCwN0_!|H+MiHA?-t1B8036xXbxkb;2E34wfH?El1Ax!6EDe_+1KH33>MYAl*L7?F zkbx|8gaptkrHqsy3mu^V)bsh=xDs@5p2FDQ)S)fTm&>Jd5`m8GcKgv^zDe5fWW4MB z`@oLc7Uy|>ST3~R?+=UEhJW?`R@VTaEq;B(qSgC$24Jd?HFztdtj%WQ>=blR?b##b zt&r74Q8))NbhreuYZ~p^wiP=MS?CB^2Nb7;7}ILCGB)dld!?jikjb3bG(np=h4U+E zBZlpSjRAGpmLy5Im-hx_$<{p&ccEl+pklY(#sKsAiC z*be4E?L?{+fp7u9HK+-LEH(%!0LgA?;v|lxTLPej+%Y&A=T$RCi6&zb632 zjEtd~vrv)^rx>uiLe1G)FwDJb!!-+)l4&(_8eQJ9mH56x+t0EQCv%}Gy`k=A@OxWx mDa&x~9gyG4Xl3W>T0KbQ-gs#mNb(stTYH$FV&vz-TN6QBe+P+p_m?K^(4NQ)r6- z1m&H7+Jd?c$r!j@uUFc(Erm}>1*$P1rDJBV1Oa%Y{lEZ1h%5;e0=@AtHUM;i&Lwxk z5SS^DBq2*cX>2S33<((m$`hkQKvv;}Ny4NZ5or0fi{?|+CLmG_Lg0H@mV^C$oA)6@ zKaBCF2>eST%d%&%F9CjoK3L;T5}1*|K-GBD1fC?YP&M94E))a-`d;7nH_b+2MIo%pUJ5*9K zKCJ7#h=DJj2?}NWw#6dPb1JJ3YUX`Z@;)0|d)-TT0yXzY-^bgA;fN ZFaVlbkTstx{j2~0002ovPDHLkV1krE`IrCz literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/toolbutton.png b/examples/multimedia/declarative-camera/images/toolbutton.png new file mode 100644 index 0000000000000000000000000000000000000000..11310013eedc808ca278e3068d7779e708422726 GIT binary patch literal 2550 zcmVe zSad^gZEa<4bO1wgWnpw>WFU8GbZ8()Nlj2!fese{00~}6L_t(&-kn;@Ze&RjJrQ}U z%I)@yx>vMhM)Vd??@(_*@_Yb7zz49M58wmf14gXj57@F~Rl)u9qI_Ld^LrWu%xs>-#eH7mxJ+t3r+Iu8>W-a$yaW&t9&L`W+wBlS zfLl#pt~TpGtyZfqA$po-jn!)P$DjWACx19QJHykbPjPf~R4mp`GJ`_tnt(B$NSb8* zzQ_XH0$@3QS~Nt>JtdI!X60wP2}Fdu54Tva*SNgA#6MqugMWPW6^@UOzjlnD5dfT= zoc#X9ix;2&_Se6`#l;1#uCB2Ehi68#3$>GQ&EiUM!f+9^cl;4}c5EU-m|w1^6+#F& zK0e0jCqKliSFiB*FTTLXA3grv1OS`O=JT_&Gn}8F-8ETgyHgg=*R!L*lAJU z{d}G_7_K?rx!~xVyW<`}gnh^5si>^ZGTuyS(`M1OQK- zJi%tO!GCt&#n|)yL5pugLm^OmbDx@NlF)fEk><<7FboZW0t6@k(*1ymcxVtz(*#lg z>~M2)joaHB{OI{7`1arb`fLJ#^?IFS*aF2~Q>LCE71Q5IL$F-wUE-g~UqYuw-8W91xn+bx`P@ZMvZCNMK50N8G~P*pH9 zL^DqZ&ENt)LYaKi!;NQmGju%+0H$cKFZvjcX1 z3lfFb0OuH6e~;a63r9c*Ap$T>6TJ5j5$txmIfa;AP=S|S+yPBAj$oxZdvWW^Iga8uDf^wmPB@BB2s9<3e0NHtnC{zg|fO9SapsENVl)F#7d{_lx z-pvfaKzx?e2qF=uH4{adCkVLNp4_%?~t) zssKzS1E{~dcBd==y(}PTb9-<6EPnMkiUV1u74Wpq1j3YavSEM~xjDL{X3rBWDBq-> z<#R!#$?=6sL)*oQ4jItoebN65fQA9dSR|Tcb;siL5&)1=rR%hnCY8XlW7Txs2S9yq z0>A>#1BT^|;r6*U%nJZ|3@{&s&I^ZKU`=15OjQd~&kxk8G&4!G%Nngd3jkWw5uHpE zTE8-6K)Mh@i0G<9c`0x*wPo3Hi)5_megz#P>d zGxL=RL<$L!9Z94{MURcu-u1mZwpfV5?^^&0uOC9kjvofVUN1CY7d*fO<_XGa!O?dX zf~O3E191T9VoOx!Qh2aqDbFv(5YJLB(Cq5i_6u~3_ zwbCyDnC{Q~z#ImH9Be7Nq`|V2l%*Shs$cX-%JG%P28av*JeS*c9o7gn09Yqz84w3| zb2gJQ?adRETCugS_ytATwLZdBc$unVohIe{UT2{?1jH|FOJI8M;l1ytLGS$x0D06;<&KZf=^ zKY%!<#cH>~WXj~R2rdiYS@o08_Vcb{k)!l zS%IomIEvfYl$2q$^oEvSqYJt8Ub;xAvQZ7f=$f^{T^~S1nApJ)gE(4Rs=Ri5z0j3J zn$D49XHcjugx68ww7}X05jM&teE*hOT_2dK$1M0UOh0GN9i%v`kmmx6Dg0nD7!gpI3_$P_2Y zXj^4Hpb~@jABRyBv#xkv7@Q)ZX^GWhn9R`BTRahgC%42QakQgUs;|?9;zFSmM@zL% zV}$49@j^}607?MEnUtDLmgEhg>NvdsL1X{l?miLb6QL>F?fCeFO zsI4~A0h=mq2wEVgUjNPZ_SA?HcRhSr0ghPFZG_VDS?VlMl^)zw?WNM5^V=(e&bbVP zRz3Tk4%(EbBtv=*8={Q8u2YKVQik-7Z#x$-NEQ+htR;Wx&Yp9`fu<B652VFZWs1RLPz+Io`c{_x1PR z|MypJ{*KUJFE1~D@&5Yy`QyirvDs{LOy>%5{%%hECFmYHFNM)una#u=iB$nYl{xCd z>`+x%o@f%LY03<`ySu}iH*fIv?OUwZ>tEj9e)yIE;PmwL*>=1AaDTV`n{)0{=Nx!) z-Lt<3#d3W%kV<5&zUl_us};i&=sgCA%~?Pyr_&~;w%^s&Ri4EE09*nYhh&1)L;wH) M07*qoM6N<$g3{N*E&u=k literal 0 HcmV?d00001 diff --git a/examples/multimedia/declarative-camera/images/toolbutton.sci b/examples/multimedia/declarative-camera/images/toolbutton.sci new file mode 100644 index 0000000..9e4f965 --- /dev/null +++ b/examples/multimedia/declarative-camera/images/toolbutton.sci @@ -0,0 +1,5 @@ +border.left: 15 +border.top: 4 +border.bottom: 4 +border.right: 15 +source: toolbutton.png diff --git a/examples/multimedia/declarative-camera/permission-denied.qml b/examples/multimedia/declarative-camera/permission-denied.qml new file mode 100644 index 0000000..19eb58e --- /dev/null +++ b/examples/multimedia/declarative-camera/permission-denied.qml @@ -0,0 +1,20 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + + +Rectangle { + color: "black" + width: 800 + height: 600 + + Text { + anchors.fill: parent + text: qsTr("Grant the camera permission and restart the app") + color: "white" + font.pointSize: 20 + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + } +} diff --git a/examples/multimedia/declarative-camera/qmlcamera.cpp b/examples/multimedia/declarative-camera/qmlcamera.cpp new file mode 100644 index 0000000..9844fd5 --- /dev/null +++ b/examples/multimedia/declarative-camera/qmlcamera.cpp @@ -0,0 +1,39 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + QQuickView view; + view.setResizeMode(QQuickView::SizeRootObjectToView); + + auto setupView = [&view](const QUrl &viewSource) { + // Qt.quit() called in embedded .qml by default only emits + // quit() signal, so do this (optionally use Qt.exit()). + QObject::connect(view.engine(), &QQmlEngine::quit, qApp, &QGuiApplication::quit); + view.setSource(viewSource); + view.show(); + }; + +#if QT_CONFIG(permissions) + QCameraPermission cameraPermission; + qApp->requestPermission(cameraPermission, [&setupView](const QPermission &permission) { + if (permission.status() == Qt::PermissionStatus::Denied) + setupView(QUrl("qrc:///permission-denied.qml")); + else + setupView(QUrl("qrc:///declarative-camera.qml")); + }); +#else + setupView(); +#endif + + return app.exec(); +} diff --git a/examples/multimedia/multimedia.pro b/examples/multimedia/multimedia.pro new file mode 100644 index 0000000..2a9cfdc --- /dev/null +++ b/examples/multimedia/multimedia.pro @@ -0,0 +1,21 @@ +TEMPLATE = subdirs +QT_FOR_CONFIG += multimedia-private + +# These examples all need widgets for now (using creator templates that use widgets) +qtHaveModule(widgets) { + SUBDIRS += \ + audiodevices \ + audiooutput \ + audiorecorder \ + camera \ + player \ + videographicsitem \ + videowidget \ + screencapture +} + +qtHaveModule(quick) { + SUBDIRS += \ + declarative-camera \ + video +} diff --git a/examples/multimedia/player/CMakeLists.txt b/examples/multimedia/player/CMakeLists.txt new file mode 100644 index 0000000..9147d97 --- /dev/null +++ b/examples/multimedia/player/CMakeLists.txt @@ -0,0 +1,44 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(player LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/player") + +find_package(Qt6 REQUIRED COMPONENTS MultimediaWidgets Network) + +qt_add_executable(player + main.cpp + player.cpp player.h + playercontrols.cpp playercontrols.h + playlistmodel.cpp playlistmodel.h + videowidget.cpp videowidget.h + qmediaplaylist.cpp qmediaplaylist.h + qmediaplaylist_p.cpp qmediaplaylist_p.h + qplaylistfileparser.cpp qplaylistfileparser.h +) + +qt_add_ios_ffmpeg_libraries(player) + +set_target_properties(player PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(player PUBLIC + Qt::MultimediaWidgets + Qt::Network +) + +install(TARGETS player + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/player/doc/images/mediaplayerex.jpg b/examples/multimedia/player/doc/images/mediaplayerex.jpg new file mode 100644 index 0000000000000000000000000000000000000000..e875bd1340a90638dc86ea14abfaf0ef314aab09 GIT binary patch literal 28825 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 + \endcode + + and we can make widget 'volume' changes change the volume + + \code + connect(controls, SIGNAL(changeVolume(int)), player, SLOT(setVolume(int))); + \endcode + + The example also allows us to change video properties by means + of the QVideoWidget object. We can go to Full Screen mode with a single + button click, and back again. +*/ diff --git a/examples/multimedia/player/main.cpp b/examples/multimedia/player/main.cpp new file mode 100644 index 0000000..3f99935 --- /dev/null +++ b/examples/multimedia/player/main.cpp @@ -0,0 +1,37 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "player.h" + +#include +#include +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName("Player Example"); + QCoreApplication::setOrganizationName("QtProject"); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt MultiMedia Player Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL(s) to open."); + parser.process(app); + + Player player; + + if (!parser.positionalArguments().isEmpty() && player.isPlayerAvailable()) { + QList urls; + for (auto &a : parser.positionalArguments()) + urls.append(QUrl::fromUserInput(a, QDir::currentPath())); + player.addToPlaylist(urls); + } + + player.show(); + return app.exec(); +} diff --git a/examples/multimedia/player/player.cpp b/examples/multimedia/player/player.cpp new file mode 100644 index 0000000..3f2b9c9 --- /dev/null +++ b/examples/multimedia/player/player.cpp @@ -0,0 +1,555 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "player.h" +#include "playercontrols.h" +#include "playlistmodel.h" +#include "qmediaplaylist.h" +#include "videowidget.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +Player::Player(QWidget *parent) : QWidget(parent) +{ + //! [create-objs] + m_player = new QMediaPlayer(this); + m_audioOutput = new QAudioOutput(this); + m_player->setAudioOutput(m_audioOutput); + //! [create-objs] + connect(m_player, &QMediaPlayer::durationChanged, this, &Player::durationChanged); + connect(m_player, &QMediaPlayer::positionChanged, this, &Player::positionChanged); + connect(m_player, QOverload<>::of(&QMediaPlayer::metaDataChanged), this, + &Player::metaDataChanged); + connect(m_player, &QMediaPlayer::mediaStatusChanged, this, &Player::statusChanged); + connect(m_player, &QMediaPlayer::bufferProgressChanged, this, &Player::bufferingProgress); + connect(m_player, &QMediaPlayer::hasVideoChanged, this, &Player::videoAvailableChanged); + connect(m_player, &QMediaPlayer::errorChanged, this, &Player::displayErrorMessage); + connect(m_player, &QMediaPlayer::tracksChanged, this, &Player::tracksChanged); + + //! [2] + m_videoWidget = new VideoWidget(this); + m_videoWidget->resize(1280, 720); + m_player->setVideoOutput(m_videoWidget); + + m_playlistModel = new PlaylistModel(this); + m_playlist = m_playlistModel->playlist(); + //! [2] + connect(m_playlist, &QMediaPlaylist::currentIndexChanged, this, + &Player::playlistPositionChanged); + + // player layout + QBoxLayout *layout = new QVBoxLayout(this); + + // display + QBoxLayout *displayLayout = new QHBoxLayout; + displayLayout->addWidget(m_videoWidget, 2); +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + m_playlistView = new QListView(); + m_playlistView->setModel(m_playlistModel); + m_playlistView->setCurrentIndex(m_playlistModel->index(m_playlist->currentIndex(), 0)); + connect(m_playlistView, &QAbstractItemView::activated, this, &Player::jump); + displayLayout->addWidget(m_playlistView); +#endif + layout->addLayout(displayLayout); + + // duration slider and label + QHBoxLayout *hLayout = new QHBoxLayout; + + m_slider = new QSlider(Qt::Horizontal, this); + m_slider->setRange(0, m_player->duration()); + connect(m_slider, &QSlider::sliderMoved, this, &Player::seek); + hLayout->addWidget(m_slider); + + m_labelDuration = new QLabel(); + m_labelDuration->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Fixed); + hLayout->addWidget(m_labelDuration); + layout->addLayout(hLayout); + + // controls + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + + QPushButton *openButton = new QPushButton(tr("Open"), this); + connect(openButton, &QPushButton::clicked, this, &Player::open); + controlLayout->addWidget(openButton); + controlLayout->addStretch(1); + + PlayerControls *controls = new PlayerControls(); + controls->setState(m_player->playbackState()); + controls->setVolume(m_audioOutput->volume()); + controls->setMuted(controls->isMuted()); + + connect(controls, &PlayerControls::play, m_player, &QMediaPlayer::play); + connect(controls, &PlayerControls::pause, m_player, &QMediaPlayer::pause); + connect(controls, &PlayerControls::stop, m_player, &QMediaPlayer::stop); + connect(controls, &PlayerControls::next, m_playlist, &QMediaPlaylist::next); + connect(controls, &PlayerControls::previous, this, &Player::previousClicked); + connect(controls, &PlayerControls::changeVolume, m_audioOutput, &QAudioOutput::setVolume); + connect(controls, &PlayerControls::changeMuting, m_audioOutput, &QAudioOutput::setMuted); + connect(controls, &PlayerControls::changeRate, m_player, &QMediaPlayer::setPlaybackRate); + connect(controls, &PlayerControls::stop, m_videoWidget, QOverload<>::of(&QVideoWidget::update)); + + connect(m_player, &QMediaPlayer::playbackStateChanged, controls, + [controls](QMediaPlayer::PlaybackState arg) { + controls->setState(arg); + }); + connect(m_audioOutput, &QAudioOutput::volumeChanged, controls, &PlayerControls::setVolume); + connect(m_audioOutput, &QAudioOutput::mutedChanged, controls, &PlayerControls::setMuted); + + controlLayout->addWidget(controls); + controlLayout->addStretch(1); + + m_fullScreenButton = new QPushButton(tr("FullScreen"), this); + m_fullScreenButton->setCheckable(true); + controlLayout->addWidget(m_fullScreenButton); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + m_audioOutputCombo = new QComboBox(this); + controlLayout->addWidget(m_audioOutputCombo); + + updateAudioDevices(); + + connect(m_audioOutputCombo, QOverload::of(&QComboBox::activated), this, + &Player::audioOutputChanged); + + QObject::connect(&m_mediaDevices, &QMediaDevices::audioOutputsChanged, this, [this] { + updateAudioDevices(); + }); +#endif + + layout->addLayout(controlLayout); + + // tracks + QGridLayout *tracksLayout = new QGridLayout; + + m_audioTracks = new QComboBox(this); + connect(m_audioTracks, &QComboBox::activated, this, &Player::selectAudioStream); + tracksLayout->addWidget(new QLabel(tr("Audio Tracks:")), 0, 0); + tracksLayout->addWidget(m_audioTracks, 0, 1); + + m_videoTracks = new QComboBox(this); + connect(m_videoTracks, &QComboBox::activated, this, &Player::selectVideoStream); + tracksLayout->addWidget(new QLabel(tr("Video Tracks:")), 1, 0); + tracksLayout->addWidget(m_videoTracks, 1, 1); + + m_subtitleTracks = new QComboBox(this); + connect(m_subtitleTracks, &QComboBox::activated, this, &Player::selectSubtitleStream); + tracksLayout->addWidget(new QLabel(tr("Subtitle Tracks:")), 2, 0); + tracksLayout->addWidget(m_subtitleTracks, 2, 1); + + layout->addLayout(tracksLayout); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + // metadata + + QLabel *metaDataLabel = new QLabel(tr("Metadata for file:")); + layout->addWidget(metaDataLabel); + + QGridLayout *metaDataLayout = new QGridLayout; + int key = QMediaMetaData::Title; + for (int i = 0; i < (QMediaMetaData::NumMetaData + 2) / 3; i++) { + for (int j = 0; j < 6; j += 2) { + m_metaDataLabels[key] = new QLabel( + QMediaMetaData::metaDataKeyToString(static_cast(key))); + if (key == QMediaMetaData::ThumbnailImage || key == QMediaMetaData::CoverArtImage) + m_metaDataFields[key] = new QLabel; + else + m_metaDataFields[key] = new QLineEdit; + m_metaDataLabels[key]->setDisabled(true); + m_metaDataFields[key]->setDisabled(true); + metaDataLayout->addWidget(m_metaDataLabels[key], i, j); + metaDataLayout->addWidget(m_metaDataFields[key], i, j + 1); + key++; + if (key == QMediaMetaData::NumMetaData) + break; + } + } + + layout->addLayout(metaDataLayout); +#endif + +#if defined(Q_OS_QNX) + // On QNX, the main window doesn't have a title bar (or any other decorations). + // Create a status bar for the status information instead. + m_statusLabel = new QLabel; + m_statusBar = new QStatusBar; + m_statusBar->addPermanentWidget(m_statusLabel); + m_statusBar->setSizeGripEnabled(false); // Without mouse grabbing, it doesn't work very well. + layout->addWidget(m_statusBar); +#endif + + setLayout(layout); + + if (!isPlayerAvailable()) { + QMessageBox::warning(this, tr("Service not available"), + tr("The QMediaPlayer object does not have a valid service.\n" + "Please check the media service plugins are installed.")); + + controls->setEnabled(false); + if (m_playlistView) + m_playlistView->setEnabled(false); + openButton->setEnabled(false); + m_fullScreenButton->setEnabled(false); + } + + metaDataChanged(); +} + +bool Player::isPlayerAvailable() const +{ + return m_player->isAvailable(); +} + +void Player::open() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Files")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + addToPlaylist(fileDialog.selectedUrls()); +} + +static bool isPlaylist(const QUrl &url) // Check for ".m3u" playlists. +{ + if (!url.isLocalFile()) + return false; + const QFileInfo fileInfo(url.toLocalFile()); + return fileInfo.exists() + && !fileInfo.suffix().compare(QLatin1String("m3u"), Qt::CaseInsensitive); +} + +void Player::addToPlaylist(const QList &urls) +{ + const int previousMediaCount = m_playlist->mediaCount(); + for (auto &url : urls) { + if (isPlaylist(url)) + m_playlist->load(url); + else + m_playlist->addMedia(url); + } + if (m_playlist->mediaCount() > previousMediaCount) { + auto index = m_playlistModel->index(previousMediaCount, 0); + if (m_playlistView) + m_playlistView->setCurrentIndex(index); + jump(index); + } +} + +void Player::durationChanged(qint64 duration) +{ + m_duration = duration / 1000; + m_slider->setMaximum(duration); +} + +void Player::positionChanged(qint64 progress) +{ + if (!m_slider->isSliderDown()) + m_slider->setValue(progress); + + updateDurationInfo(progress / 1000); +} + +void Player::metaDataChanged() +{ + auto metaData = m_player->metaData(); + setTrackInfo(QStringLiteral("%1 - %2") + .arg(metaData.value(QMediaMetaData::AlbumArtist).toString()) + .arg(metaData.value(QMediaMetaData::Title).toString())); + +#if !defined(Q_OS_ANDROID) && !defined(Q_OS_IOS) + for (int i = 0; i < QMediaMetaData::NumMetaData; i++) { + if (QLineEdit *field = qobject_cast(m_metaDataFields[i])) + field->clear(); + else if (QLabel *label = qobject_cast(m_metaDataFields[i])) + label->clear(); + m_metaDataFields[i]->setDisabled(true); + m_metaDataLabels[i]->setDisabled(true); + } + + for (auto &&[key, value] : metaData.asKeyValueRange()) { + int i = int(key); + if (key == QMediaMetaData::CoverArtImage) { + if (QLabel *cover = qobject_cast(m_metaDataFields[key])) { + QImage coverImage = value.value(); + cover->setPixmap(QPixmap::fromImage(coverImage)); + } + } else if (key == QMediaMetaData::ThumbnailImage) { + if (QLabel *thumbnail = qobject_cast(m_metaDataFields[key])) { + QImage thumbnailImage = value.value(); + thumbnail->setPixmap(QPixmap::fromImage(thumbnailImage)); + } + } else if (QLineEdit *field = qobject_cast(m_metaDataFields[key])) { + QString stringValue = metaData.stringValue(key); + field->setText(stringValue); + } + m_metaDataFields[i]->setDisabled(false); + m_metaDataLabels[i]->setDisabled(false); + } + + const QList tracks = m_player->videoTracks(); + const int currentVideoTrack = m_player->activeVideoTrack(); + if (currentVideoTrack >= 0 && currentVideoTrack < tracks.size()) { + const QMediaMetaData track = tracks.value(currentVideoTrack); + for (const QMediaMetaData::Key &key : track.keys()) { + if (QLineEdit *field = qobject_cast(m_metaDataFields[key])) { + QString stringValue = track.stringValue(key); + field->setText(stringValue); + } + m_metaDataFields[key]->setDisabled(true); + m_metaDataLabels[key]->setDisabled(true); + } + } +#endif +} + +QString Player::trackName(const QMediaMetaData &metaData, int index) +{ + QString name; + QString title = metaData.stringValue(QMediaMetaData::Title); + QLocale::Language lang = metaData.value(QMediaMetaData::Language).value(); + + if (title.isEmpty()) { + if (lang == QLocale::Language::AnyLanguage) + name = tr("Track %1").arg(index + 1); + else + name = QLocale::languageToString(lang); + } else { + if (lang == QLocale::Language::AnyLanguage) + name = title; + else + name = QStringLiteral("%1 - [%2]").arg(title).arg(QLocale::languageToString(lang)); + } + return name; +} + +void Player::tracksChanged() +{ + m_audioTracks->clear(); + m_videoTracks->clear(); + m_subtitleTracks->clear(); + + const auto audioTracks = m_player->audioTracks(); + m_audioTracks->addItem(QStringLiteral("No audio"), -1); + for (int i = 0; i < audioTracks.size(); ++i) + m_audioTracks->addItem(trackName(audioTracks.at(i), i), i); + m_audioTracks->setCurrentIndex(m_player->activeAudioTrack() + 1); + + const auto videoTracks = m_player->videoTracks(); + m_videoTracks->addItem(QStringLiteral("No video"), -1); + for (int i = 0; i < videoTracks.size(); ++i) + m_videoTracks->addItem(trackName(videoTracks.at(i), i), i); + m_videoTracks->setCurrentIndex(m_player->activeVideoTrack() + 1); + + m_subtitleTracks->addItem(QStringLiteral("No subtitles"), -1); + const auto subtitleTracks = m_player->subtitleTracks(); + for (int i = 0; i < subtitleTracks.size(); ++i) + m_subtitleTracks->addItem(trackName(subtitleTracks.at(i), i), i); + m_subtitleTracks->setCurrentIndex(m_player->activeSubtitleTrack() + 1); +} + +void Player::previousClicked() +{ + // Go to previous track if we are within the first 5 seconds of playback + // Otherwise, seek to the beginning. + if (m_player->position() <= 5000) { + m_playlist->previous(); + } else { + m_player->setPosition(0); + } +} + +void Player::jump(const QModelIndex &index) +{ + if (index.isValid()) { + m_playlist->setCurrentIndex(index.row()); + } +} + +void Player::playlistPositionChanged(int currentItem) +{ + if (m_playlistView) + m_playlistView->setCurrentIndex(m_playlistModel->index(currentItem, 0)); + m_player->setSource(m_playlist->currentMedia()); +} + +void Player::seek(int mseconds) +{ + m_player->setPosition(mseconds); +} + +void Player::statusChanged(QMediaPlayer::MediaStatus status) +{ + handleCursor(status); + + // handle status message + switch (status) { + case QMediaPlayer::NoMedia: + case QMediaPlayer::LoadedMedia: + setStatusInfo(QString()); + break; + case QMediaPlayer::LoadingMedia: + setStatusInfo(tr("Loading...")); + break; + case QMediaPlayer::BufferingMedia: + case QMediaPlayer::BufferedMedia: + setStatusInfo(tr("Buffering %1%").arg(qRound(m_player->bufferProgress() * 100.))); + break; + case QMediaPlayer::StalledMedia: + setStatusInfo(tr("Stalled %1%").arg(qRound(m_player->bufferProgress() * 100.))); + break; + case QMediaPlayer::EndOfMedia: + QApplication::alert(this); + m_playlist->next(); + break; + case QMediaPlayer::InvalidMedia: + displayErrorMessage(); + break; + } +} + +void Player::handleCursor(QMediaPlayer::MediaStatus status) +{ +#ifndef QT_NO_CURSOR + if (status == QMediaPlayer::LoadingMedia || status == QMediaPlayer::BufferingMedia + || status == QMediaPlayer::StalledMedia) + setCursor(QCursor(Qt::BusyCursor)); + else + unsetCursor(); +#endif +} + +void Player::bufferingProgress(float progress) +{ + if (m_player->mediaStatus() == QMediaPlayer::StalledMedia) + setStatusInfo(tr("Stalled %1%").arg(qRound(progress * 100.))); + else + setStatusInfo(tr("Buffering %1%").arg(qRound(progress * 100.))); +} + +void Player::videoAvailableChanged(bool available) +{ + if (!available) { + disconnect(m_fullScreenButton, &QPushButton::clicked, m_videoWidget, + &QVideoWidget::setFullScreen); + disconnect(m_videoWidget, &QVideoWidget::fullScreenChanged, m_fullScreenButton, + &QPushButton::setChecked); + m_videoWidget->setFullScreen(false); + } else { + connect(m_fullScreenButton, &QPushButton::clicked, m_videoWidget, + &QVideoWidget::setFullScreen); + connect(m_videoWidget, &QVideoWidget::fullScreenChanged, m_fullScreenButton, + &QPushButton::setChecked); + + if (m_fullScreenButton->isChecked()) + m_videoWidget->setFullScreen(true); + } +} + +void Player::selectAudioStream() +{ + int stream = m_audioTracks->currentData().toInt(); + m_player->setActiveAudioTrack(stream); +} + +void Player::selectVideoStream() +{ + int stream = m_videoTracks->currentData().toInt(); + m_player->setActiveVideoTrack(stream); +} + +void Player::selectSubtitleStream() +{ + int stream = m_subtitleTracks->currentData().toInt(); + m_player->setActiveSubtitleTrack(stream); +} + +void Player::setTrackInfo(const QString &info) +{ + m_trackInfo = info; + + if (m_statusBar) { + m_statusBar->showMessage(m_trackInfo); + m_statusLabel->setText(m_statusInfo); + } else { + if (!m_statusInfo.isEmpty()) + setWindowTitle(QStringLiteral("%1 | %2").arg(m_trackInfo).arg(m_statusInfo)); + else + setWindowTitle(m_trackInfo); + } +} + +void Player::setStatusInfo(const QString &info) +{ + m_statusInfo = info; + + if (m_statusBar) { + m_statusBar->showMessage(m_trackInfo); + m_statusLabel->setText(m_statusInfo); + } else { + if (!m_statusInfo.isEmpty()) + setWindowTitle(QStringLiteral("%1 | %2").arg(m_trackInfo).arg(m_statusInfo)); + else + setWindowTitle(m_trackInfo); + } +} + +void Player::displayErrorMessage() +{ + if (m_player->error() == QMediaPlayer::NoError) + return; + setStatusInfo(m_player->errorString()); +} + +void Player::updateDurationInfo(qint64 currentInfo) +{ + QString tStr; + if (currentInfo || m_duration) { + QTime currentTime((currentInfo / 3600) % 60, (currentInfo / 60) % 60, currentInfo % 60, + (currentInfo * 1000) % 1000); + QTime totalTime((m_duration / 3600) % 60, (m_duration / 60) % 60, m_duration % 60, + (m_duration * 1000) % 1000); + QString format = "mm:ss"; + if (m_duration > 3600) + format = "hh:mm:ss"; + tStr = currentTime.toString(format) + " / " + totalTime.toString(format); + } + m_labelDuration->setText(tStr); +} + +void Player::updateAudioDevices() +{ + m_audioOutputCombo->clear(); + + m_audioOutputCombo->addItem(QStringLiteral("Default"), QVariant::fromValue(QAudioDevice())); + for (auto &deviceInfo : QMediaDevices::audioOutputs()) + m_audioOutputCombo->addItem(deviceInfo.description(), QVariant::fromValue(deviceInfo)); +} + +void Player::audioOutputChanged(int index) +{ + auto device = m_audioOutputCombo->itemData(index).value(); + m_player->audioOutput()->setDevice(device); +} + +#include "moc_player.cpp" diff --git a/examples/multimedia/player/player.h b/examples/multimedia/player/player.h new file mode 100644 index 0000000..f20995f --- /dev/null +++ b/examples/multimedia/player/player.h @@ -0,0 +1,105 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYER_H +#define PLAYER_H + +#include "qmediaplaylist.h" + +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractItemView; +class QLabel; +class QMediaPlayer; +class QModelIndex; +class QPushButton; +class QComboBox; +class QSlider; +class QStatusBar; +class QVideoWidget; +QT_END_NAMESPACE + +class PlaylistModel; + +class Player : public QWidget +{ + Q_OBJECT + +public: + explicit Player(QWidget *parent = nullptr); + ~Player() = default; + + bool isPlayerAvailable() const; + + void addToPlaylist(const QList &urls); + +signals: + void fullScreenChanged(bool fullScreen); + +private slots: + void open(); + void durationChanged(qint64 duration); + void positionChanged(qint64 progress); + void metaDataChanged(); + void tracksChanged(); + + void previousClicked(); + + void seek(int mseconds); + void jump(const QModelIndex &index); + void playlistPositionChanged(int); + + void statusChanged(QMediaPlayer::MediaStatus status); + void bufferingProgress(float progress); + void videoAvailableChanged(bool available); + + void selectAudioStream(); + void selectVideoStream(); + void selectSubtitleStream(); + + void displayErrorMessage(); + + void audioOutputChanged(int); + +private: + void setTrackInfo(const QString &info); + void setStatusInfo(const QString &info); + void handleCursor(QMediaPlayer::MediaStatus status); + void updateDurationInfo(qint64 currentInfo); + + void updateAudioDevices(); + + QString trackName(const QMediaMetaData &metaData, int index); + + QMediaPlayer *m_player = nullptr; + QAudioOutput *m_audioOutput = nullptr; + QMediaPlaylist *m_playlist = nullptr; + QVideoWidget *m_videoWidget = nullptr; + QSlider *m_slider = nullptr; + QLabel *m_labelDuration = nullptr; + QPushButton *m_fullScreenButton = nullptr; + QComboBox *m_audioOutputCombo = nullptr; + QLabel *m_statusLabel = nullptr; + QStatusBar *m_statusBar = nullptr; + + QComboBox *m_audioTracks = nullptr; + QComboBox *m_videoTracks = nullptr; + QComboBox *m_subtitleTracks = nullptr; + + PlaylistModel *m_playlistModel = nullptr; + QAbstractItemView *m_playlistView = nullptr; + QString m_trackInfo; + QString m_statusInfo; + qint64 m_duration; + + QMediaDevices m_mediaDevices; + + QWidget *m_metaDataFields[QMediaMetaData::NumMetaData] = {}; + QLabel *m_metaDataLabels[QMediaMetaData::NumMetaData] = {}; +}; + +#endif // PLAYER_H diff --git a/examples/multimedia/player/player.pro b/examples/multimedia/player/player.pro new file mode 100644 index 0000000..6d93836 --- /dev/null +++ b/examples/multimedia/player/player.pro @@ -0,0 +1,28 @@ +TEMPLATE = app +TARGET = player + +QT += network \ + multimedia \ + multimediawidgets \ + widgets + +HEADERS = \ + player.h \ + playercontrols.h \ + playlistmodel.h \ + videowidget.h \ + qmediaplaylist.h \ + qmediaplaylist_p.h \ + qplaylistfileparser.h + +SOURCES = main.cpp \ + player.cpp \ + playercontrols.cpp \ + playlistmodel.cpp \ + videowidget.cpp \ + qmediaplaylist.cpp \ + qmediaplaylist_p.cpp \ + qplaylistfileparser.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/player +INSTALLS += target diff --git a/examples/multimedia/player/playercontrols.cpp b/examples/multimedia/player/playercontrols.cpp new file mode 100644 index 0000000..9a6c81d --- /dev/null +++ b/examples/multimedia/player/playercontrols.cpp @@ -0,0 +1,185 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "playercontrols.h" + +#include +#include +#include +#include +#include +#include + +PlayerControls::PlayerControls(QWidget *parent) : QWidget(parent) +{ + m_playButton = new QToolButton(this); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &PlayerControls::playClicked); + + m_pauseButton = new QToolButton(this); + m_pauseButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + connect(m_pauseButton, &QAbstractButton::clicked, this, &PlayerControls::pauseClicked); + + m_stopButton = new QToolButton(this); + m_stopButton->setIcon(style()->standardIcon(QStyle::SP_MediaStop)); + connect(m_stopButton, &QAbstractButton::clicked, this, &PlayerControls::stop); + + m_nextButton = new QToolButton(this); + m_nextButton->setIcon(style()->standardIcon(QStyle::SP_MediaSkipForward)); + + connect(m_nextButton, &QAbstractButton::clicked, this, &PlayerControls::next); + + m_previousButton = new QToolButton(this); + m_previousButton->setIcon(style()->standardIcon(QStyle::SP_MediaSkipBackward)); + + connect(m_previousButton, &QAbstractButton::clicked, this, &PlayerControls::previous); + + m_muteButton = new QToolButton(this); + m_muteButton->setIcon(style()->standardIcon(QStyle::SP_MediaVolume)); + + connect(m_muteButton, &QAbstractButton::clicked, this, &PlayerControls::muteClicked); + + m_volumeSlider = new QSlider(Qt::Horizontal, this); + m_volumeSlider->setRange(0, 100); + QSizePolicy sp = m_volumeSlider->sizePolicy(); + sp.setHorizontalPolicy(QSizePolicy::MinimumExpanding); + m_volumeSlider->setSizePolicy(sp); + + connect(m_volumeSlider, &QSlider::valueChanged, this, + &PlayerControls::onVolumeSliderValueChanged); + + m_rateBox = new QComboBox(this); + m_rateBox->addItem("0.5x", QVariant(0.5)); + m_rateBox->addItem("1.0x", QVariant(1.0)); + m_rateBox->addItem("2.0x", QVariant(2.0)); + m_rateBox->setCurrentIndex(1); + + connect(m_rateBox, QOverload::of(&QComboBox::activated), this, + &PlayerControls::updateRate); + + setState(QMediaPlayer::StoppedState, /*force=*/true); + + QBoxLayout *layout = new QHBoxLayout; + layout->setContentsMargins(0, 0, 0, 0); + layout->addWidget(m_stopButton); + layout->addWidget(m_previousButton); + layout->addWidget(m_pauseButton); + layout->addWidget(m_playButton); + layout->addWidget(m_nextButton); + layout->addWidget(m_muteButton); + layout->addWidget(m_volumeSlider); + layout->addWidget(m_rateBox); + setLayout(layout); +} + +QMediaPlayer::PlaybackState PlayerControls::state() const +{ + return m_playerState; +} + +void PlayerControls::setState(QMediaPlayer::PlaybackState state, bool force) +{ + if (state != m_playerState || force) { + m_playerState = state; + + QColor baseColor = palette().color(QPalette::Base); + QString inactiveStyleSheet = QStringLiteral("background-color: %1").arg(baseColor.name()); + QString defaultStyleSheet = QStringLiteral(""); + + switch (state) { + case QMediaPlayer::StoppedState: + m_stopButton->setStyleSheet(inactiveStyleSheet); + m_playButton->setStyleSheet(defaultStyleSheet); + m_pauseButton->setStyleSheet(defaultStyleSheet); + break; + case QMediaPlayer::PlayingState: + m_stopButton->setStyleSheet(defaultStyleSheet); + m_playButton->setStyleSheet(inactiveStyleSheet); + m_pauseButton->setStyleSheet(defaultStyleSheet); + break; + case QMediaPlayer::PausedState: + m_stopButton->setStyleSheet(defaultStyleSheet); + m_playButton->setStyleSheet(defaultStyleSheet); + m_pauseButton->setStyleSheet(inactiveStyleSheet); + break; + } + } +} + +float PlayerControls::volume() const +{ + qreal linearVolume = + QAudio::convertVolume(m_volumeSlider->value() / qreal(100), + QAudio::LogarithmicVolumeScale, QAudio::LinearVolumeScale); + + return linearVolume; +} + +void PlayerControls::setVolume(float volume) +{ + qreal logarithmicVolume = QAudio::convertVolume(volume, QAudio::LinearVolumeScale, + QAudio::LogarithmicVolumeScale); + + m_volumeSlider->setValue(qRound(logarithmicVolume * 100)); +} + +bool PlayerControls::isMuted() const +{ + return m_playerMuted; +} + +void PlayerControls::setMuted(bool muted) +{ + if (muted != m_playerMuted) { + m_playerMuted = muted; + + m_muteButton->setIcon(style()->standardIcon(muted ? QStyle::SP_MediaVolumeMuted + : QStyle::SP_MediaVolume)); + } +} + +void PlayerControls::playClicked() +{ + emit play(); +} + +void PlayerControls::pauseClicked() +{ + emit pause(); +} + +void PlayerControls::muteClicked() +{ + emit changeMuting(!m_playerMuted); +} + +qreal PlayerControls::playbackRate() const +{ + return m_rateBox->itemData(m_rateBox->currentIndex()).toDouble(); +} + +void PlayerControls::setPlaybackRate(float rate) +{ + for (int i = 0; i < m_rateBox->count(); ++i) { + if (qFuzzyCompare(rate, float(m_rateBox->itemData(i).toDouble()))) { + m_rateBox->setCurrentIndex(i); + return; + } + } + + m_rateBox->addItem(QStringLiteral("%1x").arg(rate), QVariant(rate)); + m_rateBox->setCurrentIndex(m_rateBox->count() - 1); +} + +void PlayerControls::updateRate() +{ + emit changeRate(playbackRate()); +} + +void PlayerControls::onVolumeSliderValueChanged() +{ + emit changeVolume(volume()); +} + +#include "moc_playercontrols.cpp" diff --git a/examples/multimedia/player/playercontrols.h b/examples/multimedia/player/playercontrols.h new file mode 100644 index 0000000..322b4ca --- /dev/null +++ b/examples/multimedia/player/playercontrols.h @@ -0,0 +1,64 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYERCONTROLS_H +#define PLAYERCONTROLS_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QAbstractSlider; +class QComboBox; +QT_END_NAMESPACE + +class PlayerControls : public QWidget +{ + Q_OBJECT + +public: + explicit PlayerControls(QWidget *parent = nullptr); + + QMediaPlayer::PlaybackState state() const; + float volume() const; + bool isMuted() const; + qreal playbackRate() const; + +public slots: + void setState(QMediaPlayer::PlaybackState state, bool force = false); + void setVolume(float volume); + void setMuted(bool muted); + void setPlaybackRate(float rate); + +signals: + void play(); + void pause(); + void stop(); + void next(); + void previous(); + void changeVolume(float volume); + void changeMuting(bool muting); + void changeRate(qreal rate); + +private slots: + void playClicked(); + void pauseClicked(); + void muteClicked(); + void updateRate(); + void onVolumeSliderValueChanged(); + +private: + QMediaPlayer::PlaybackState m_playerState = QMediaPlayer::StoppedState; + bool m_playerMuted = false; + QAbstractButton *m_playButton = nullptr; + QAbstractButton *m_pauseButton = nullptr; + QAbstractButton *m_stopButton = nullptr; + QAbstractButton *m_nextButton = nullptr; + QAbstractButton *m_previousButton = nullptr; + QAbstractButton *m_muteButton = nullptr; + QAbstractSlider *m_volumeSlider = nullptr; + QComboBox *m_rateBox = nullptr; +}; + +#endif // PLAYERCONTROLS_H diff --git a/examples/multimedia/player/playlistmodel.cpp b/examples/multimedia/player/playlistmodel.cpp new file mode 100644 index 0000000..7ae76bc --- /dev/null +++ b/examples/multimedia/player/playlistmodel.cpp @@ -0,0 +1,105 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "playlistmodel.h" +#include "qmediaplaylist.h" + +#include +#include + +PlaylistModel::PlaylistModel(QObject *parent) : QAbstractItemModel(parent) +{ + m_playlist.reset(new QMediaPlaylist); + connect(m_playlist.data(), &QMediaPlaylist::mediaAboutToBeInserted, this, + &PlaylistModel::beginInsertItems); + connect(m_playlist.data(), &QMediaPlaylist::mediaInserted, this, + &PlaylistModel::endInsertItems); + connect(m_playlist.data(), &QMediaPlaylist::mediaAboutToBeRemoved, this, + &PlaylistModel::beginRemoveItems); + connect(m_playlist.data(), &QMediaPlaylist::mediaRemoved, this, &PlaylistModel::endRemoveItems); + connect(m_playlist.data(), &QMediaPlaylist::mediaChanged, this, &PlaylistModel::changeItems); +} + +PlaylistModel::~PlaylistModel() = default; + +int PlaylistModel::rowCount(const QModelIndex &parent) const +{ + return m_playlist && !parent.isValid() ? m_playlist->mediaCount() : 0; +} + +int PlaylistModel::columnCount(const QModelIndex &parent) const +{ + return !parent.isValid() ? ColumnCount : 0; +} + +QModelIndex PlaylistModel::index(int row, int column, const QModelIndex &parent) const +{ + return m_playlist && !parent.isValid() && row >= 0 && row < m_playlist->mediaCount() + && column >= 0 && column < ColumnCount + ? createIndex(row, column) + : QModelIndex(); +} + +QModelIndex PlaylistModel::parent(const QModelIndex &child) const +{ + Q_UNUSED(child); + + return QModelIndex(); +} + +QVariant PlaylistModel::data(const QModelIndex &index, int role) const +{ + if (index.isValid() && role == Qt::DisplayRole) { + QVariant value = m_data[index]; + if (!value.isValid() && index.column() == Title) { + QUrl location = m_playlist->media(index.row()); + return QFileInfo(location.path()).fileName(); + } + + return value; + } + return QVariant(); +} + +QMediaPlaylist *PlaylistModel::playlist() const +{ + return m_playlist.data(); +} + +bool PlaylistModel::setData(const QModelIndex &index, const QVariant &value, int role) +{ + Q_UNUSED(role); + m_data[index] = value; + emit dataChanged(index, index); + return true; +} + +void PlaylistModel::beginInsertItems(int start, int end) +{ + m_data.clear(); + beginInsertRows(QModelIndex(), start, end); +} + +void PlaylistModel::endInsertItems() +{ + endInsertRows(); +} + +void PlaylistModel::beginRemoveItems(int start, int end) +{ + m_data.clear(); + beginRemoveRows(QModelIndex(), start, end); +} + +void PlaylistModel::endRemoveItems() +{ + endInsertRows(); +} + +void PlaylistModel::changeItems(int start, int end) +{ + m_data.clear(); + emit dataChanged(index(start, 0), index(end, ColumnCount)); +} + +#include "moc_playlistmodel.cpp" diff --git a/examples/multimedia/player/playlistmodel.h b/examples/multimedia/player/playlistmodel.h new file mode 100644 index 0000000..0c510f6 --- /dev/null +++ b/examples/multimedia/player/playlistmodel.h @@ -0,0 +1,50 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYLISTMODEL_H +#define PLAYLISTMODEL_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QMediaPlaylist; +QT_END_NAMESPACE + +class PlaylistModel : public QAbstractItemModel +{ + Q_OBJECT + +public: + enum Column { Title = 0, ColumnCount }; + + explicit PlaylistModel(QObject *parent = nullptr); + ~PlaylistModel(); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + int columnCount(const QModelIndex &parent = QModelIndex()) const override; + + QModelIndex index(int row, int column, + const QModelIndex &parent = QModelIndex()) const override; + QModelIndex parent(const QModelIndex &child) const override; + + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + + QMediaPlaylist *playlist() const; + + bool setData(const QModelIndex &index, const QVariant &value, + int role = Qt::DisplayRole) override; + +private slots: + void beginInsertItems(int start, int end); + void endInsertItems(); + void beginRemoveItems(int start, int end); + void endRemoveItems(); + void changeItems(int start, int end); + +private: + QScopedPointer m_playlist; + QMap m_data; +}; + +#endif // PLAYLISTMODEL_H diff --git a/examples/multimedia/player/qmediaplaylist.cpp b/examples/multimedia/player/qmediaplaylist.cpp new file mode 100644 index 0000000..739dd1c --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist.cpp @@ -0,0 +1,643 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "qmediaplaylist.h" +#include "qmediaplaylist_p.h" +#include "qplaylistfileparser.h" + +#include +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE + +class QM3uPlaylistWriter +{ +public: + QM3uPlaylistWriter(QIODevice *device) + : m_device(device), m_textStream(new QTextStream(m_device)) + { + } + + ~QM3uPlaylistWriter() { delete m_textStream; } + + bool writeItem(const QUrl &item) + { + *m_textStream << item.toString() << Qt::endl; + return true; + } + +private: + QIODevice *m_device; + QTextStream *m_textStream; +}; + +int QMediaPlaylistPrivate::nextPosition(int steps) const +{ + if (playlist.count() == 0) + return -1; + + int next = currentPos + steps; + + switch (playbackMode) { + case QMediaPlaylist::CurrentItemOnce: + return steps != 0 ? -1 : currentPos; + case QMediaPlaylist::CurrentItemInLoop: + return currentPos; + case QMediaPlaylist::Sequential: + if (next >= playlist.size()) + next = 0; + break; + case QMediaPlaylist::Loop: + next %= playlist.count(); + break; + } + + return next; +} + +int QMediaPlaylistPrivate::prevPosition(int steps) const +{ + if (playlist.count() == 0) + return -1; + + int next = currentPos; + if (next < 0) + next = playlist.size(); + next -= steps; + + switch (playbackMode) { + case QMediaPlaylist::CurrentItemOnce: + return steps != 0 ? -1 : currentPos; + case QMediaPlaylist::CurrentItemInLoop: + return currentPos; + case QMediaPlaylist::Sequential: + if (next < 0) + next = playlist.size() - 1; + break; + case QMediaPlaylist::Loop: + next %= playlist.size(); + if (next < 0) + next += playlist.size(); + break; + } + + return next; +} + +/*! + \class QMediaPlaylist + \inmodule QtMultimedia + \ingroup multimedia + \ingroup multimedia_playback + + + \brief The QMediaPlaylist class provides a list of media content to play. + + QMediaPlaylist is intended to be used with other media objects, + like QMediaPlayer. + + QMediaPlaylist allows to access the service intrinsic playlist functionality + if available, otherwise it provides the local memory playlist implementation. + + \snippet multimedia-snippets/media.cpp Movie playlist + + Depending on playlist source implementation, most of the playlist mutating + operations can be asynchronous. + + QMediaPlayList currently supports M3U playlists (file extension .m3u and .m3u8). + + \sa QUrl +*/ + +/*! + \enum QMediaPlaylist::PlaybackMode + + The QMediaPlaylist::PlaybackMode describes the order items in playlist are played. + + \value CurrentItemOnce The current item is played only once. + + \value CurrentItemInLoop The current item is played repeatedly in a loop. + + \value Sequential Playback starts from the current and moves through each successive + item until the last is reached and then stops. The next item is a null item when the last one is + currently playing. + + \value Loop Playback restarts at the first item after the last has finished + playing. + + \value Random Play items in random order. +*/ + +/*! + Create a new playlist object with the given \a parent. +*/ + +QMediaPlaylist::QMediaPlaylist(QObject *parent) : QObject(parent), d_ptr(new QMediaPlaylistPrivate) +{ + Q_D(QMediaPlaylist); + + d->q_ptr = this; +} + +/*! + Destroys the playlist. + */ + +QMediaPlaylist::~QMediaPlaylist() +{ + delete d_ptr; +} + +/*! + \property QMediaPlaylist::playbackMode + + This property defines the order that items in the playlist are played. + + \sa QMediaPlaylist::PlaybackMode +*/ + +QMediaPlaylist::PlaybackMode QMediaPlaylist::playbackMode() const +{ + return d_func()->playbackMode; +} + +void QMediaPlaylist::setPlaybackMode(QMediaPlaylist::PlaybackMode mode) +{ + Q_D(QMediaPlaylist); + + if (mode == d->playbackMode) + return; + + d->playbackMode = mode; + + emit playbackModeChanged(mode); +} + +/*! + Returns position of the current media content in the playlist. +*/ +int QMediaPlaylist::currentIndex() const +{ + return d_func()->currentPos; +} + +/*! + Returns the current media content. +*/ + +QUrl QMediaPlaylist::currentMedia() const +{ + Q_D(const QMediaPlaylist); + if (d->currentPos < 0 || d->currentPos >= d->playlist.size()) + return QUrl(); + return d_func()->playlist.at(d_func()->currentPos); +} + +/*! + Returns the index of the item, which would be current after calling next() + \a steps times. + + Returned value depends on the size of playlist, current position + and playback mode. + + \sa QMediaPlaylist::playbackMode(), previousIndex() +*/ +int QMediaPlaylist::nextIndex(int steps) const +{ + return d_func()->nextPosition(steps); +} + +/*! + Returns the index of the item, which would be current after calling previous() + \a steps times. + + \sa QMediaPlaylist::playbackMode(), nextIndex() +*/ + +int QMediaPlaylist::previousIndex(int steps) const +{ + return d_func()->prevPosition(steps); +} + +/*! + Returns the number of items in the playlist. + + \sa isEmpty() + */ +int QMediaPlaylist::mediaCount() const +{ + return d_func()->playlist.count(); +} + +/*! + Returns true if the playlist contains no items, otherwise returns false. + + \sa mediaCount() + */ +bool QMediaPlaylist::isEmpty() const +{ + return mediaCount() == 0; +} + +/*! + Returns the media content at \a index in the playlist. +*/ + +QUrl QMediaPlaylist::media(int index) const +{ + Q_D(const QMediaPlaylist); + if (index < 0 || index >= d->playlist.size()) + return QUrl(); + return d->playlist.at(index); +} + +/*! + Append the media \a content to the playlist. + + Returns true if the operation is successful, otherwise returns false. + */ +void QMediaPlaylist::addMedia(const QUrl &content) +{ + Q_D(QMediaPlaylist); + int pos = d->playlist.size(); + emit mediaAboutToBeInserted(pos, pos); + d->playlist.append(content); + emit mediaInserted(pos, pos); +} + +/*! + Append multiple media content \a items to the playlist. + + Returns true if the operation is successful, otherwise returns false. + */ +void QMediaPlaylist::addMedia(const QList &items) +{ + if (!items.size()) + return; + + Q_D(QMediaPlaylist); + int first = d->playlist.size(); + int last = first + items.size() - 1; + emit mediaAboutToBeInserted(first, last); + d_func()->playlist.append(items); + emit mediaInserted(first, last); +} + +/*! + Insert the media \a content to the playlist at position \a pos. + + Returns true if the operation is successful, otherwise returns false. +*/ + +bool QMediaPlaylist::insertMedia(int pos, const QUrl &content) +{ + Q_D(QMediaPlaylist); + pos = qBound(0, pos, d->playlist.size()); + emit mediaAboutToBeInserted(pos, pos); + d->playlist.insert(pos, content); + emit mediaInserted(pos, pos); + return true; +} + +/*! + Insert multiple media content \a items to the playlist at position \a pos. + + Returns true if the operation is successful, otherwise returns false. +*/ + +bool QMediaPlaylist::insertMedia(int pos, const QList &items) +{ + if (!items.size()) + return true; + + Q_D(QMediaPlaylist); + pos = qBound(0, pos, d->playlist.size()); + int last = pos + items.size() - 1; + emit mediaAboutToBeInserted(pos, last); + auto newList = d->playlist.mid(0, pos); + newList += items; + newList += d->playlist.mid(pos); + d->playlist = newList; + emit mediaInserted(pos, last); + return true; +} + +/*! + Move the item from position \a from to position \a to. + + Returns true if the operation is successful, otherwise false. + + \since 5.7 +*/ +bool QMediaPlaylist::moveMedia(int from, int to) +{ + Q_D(QMediaPlaylist); + if (from < 0 || from > d->playlist.count() || to < 0 || to > d->playlist.count()) + return false; + + d->playlist.move(from, to); + emit mediaChanged(from, to); + return true; +} + +/*! + Remove the item from the playlist at position \a pos. + + Returns true if the operation is successful, otherwise return false. + */ +bool QMediaPlaylist::removeMedia(int pos) +{ + return removeMedia(pos, pos); +} + +/*! + Remove items in the playlist from \a start to \a end inclusive. + + Returns true if the operation is successful, otherwise return false. + */ +bool QMediaPlaylist::removeMedia(int start, int end) +{ + Q_D(QMediaPlaylist); + if (end < start || end < 0 || start >= d->playlist.count()) + return false; + start = qBound(0, start, d->playlist.size() - 1); + end = qBound(0, end, d->playlist.size() - 1); + + emit mediaAboutToBeRemoved(start, end); + d->playlist.remove(start, end - start + 1); + emit mediaRemoved(start, end); + return true; +} + +/*! + Remove all the items from the playlist. + + Returns true if the operation is successful, otherwise return false. + */ +void QMediaPlaylist::clear() +{ + Q_D(QMediaPlaylist); + int size = d->playlist.size(); + emit mediaAboutToBeRemoved(0, size - 1); + d->playlist.clear(); + emit mediaRemoved(0, size - 1); +} + +/*! + Load playlist from \a location. If \a format is specified, it is used, + otherwise format is guessed from location name and data. + + New items are appended to playlist. + + QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, + otherwise the playlist emits loadFailed(). +*/ + +void QMediaPlaylist::load(const QUrl &location, const char *format) +{ + Q_D(QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + d->ensureParser(); + d->parser->start(location, QString::fromUtf8(format)); +} + +/*! + Load playlist from QIODevice \a device. If \a format is specified, it is used, + otherwise format is guessed from device data. + + New items are appended to playlist. + + QMediaPlaylist::loaded() signal is emitted if playlist was loaded successfully, + otherwise the playlist emits loadFailed(). +*/ +void QMediaPlaylist::load(QIODevice *device, const char *format) +{ + Q_D(QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + d->ensureParser(); + d->parser->start(device, QString::fromUtf8(format)); +} + +/*! + Save playlist to \a location. If \a format is specified, it is used, + otherwise format is guessed from location name. + + Returns true if playlist was saved successfully, otherwise returns false. + */ +bool QMediaPlaylist::save(const QUrl &location, const char *format) const +{ + Q_D(const QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + if (!d->checkFormat(format)) + return false; + + QFile file(location.toLocalFile()); + + if (!file.open(QIODevice::WriteOnly | QIODevice::Truncate)) { + d->error = AccessDeniedError; + d->errorString = tr("The file could not be accessed."); + return false; + } + + return save(&file, format); +} + +/*! + Save playlist to QIODevice \a device using format \a format. + + Returns true if playlist was saved successfully, otherwise returns false. +*/ +bool QMediaPlaylist::save(QIODevice *device, const char *format) const +{ + Q_D(const QMediaPlaylist); + + d->error = NoError; + d->errorString.clear(); + + if (!d->checkFormat(format)) + return false; + + QM3uPlaylistWriter writer(device); + for (const auto &entry : d->playlist) + writer.writeItem(entry); + return true; +} + +/*! + Returns the last error condition. +*/ +QMediaPlaylist::Error QMediaPlaylist::error() const +{ + return d_func()->error; +} + +/*! + Returns the string describing the last error condition. +*/ +QString QMediaPlaylist::errorString() const +{ + return d_func()->errorString; +} + +/*! + Shuffle items in the playlist. +*/ +void QMediaPlaylist::shuffle() +{ + Q_D(QMediaPlaylist); + QList playlist; + + // keep the current item when shuffling + QUrl current; + if (d->currentPos != -1) + current = d->playlist.takeAt(d->currentPos); + + while (!d->playlist.isEmpty()) + playlist.append( + d->playlist.takeAt(QRandomGenerator::global()->bounded(int(d->playlist.size())))); + + if (d->currentPos != -1) + playlist.insert(d->currentPos, current); + d->playlist = playlist; + emit mediaChanged(0, d->playlist.count()); +} + +/*! + Advance to the next media content in playlist. +*/ +void QMediaPlaylist::next() +{ + Q_D(QMediaPlaylist); + d->currentPos = d->nextPosition(1); + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + Return to the previous media content in playlist. +*/ +void QMediaPlaylist::previous() +{ + Q_D(QMediaPlaylist); + d->currentPos = d->prevPosition(1); + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + Activate media content from playlist at position \a playlistPosition. +*/ + +void QMediaPlaylist::setCurrentIndex(int playlistPosition) +{ + Q_D(QMediaPlaylist); + if (playlistPosition < 0 || playlistPosition >= d->playlist.size()) + playlistPosition = -1; + d->currentPos = playlistPosition; + + emit currentIndexChanged(d->currentPos); + emit currentMediaChanged(currentMedia()); +} + +/*! + \fn void QMediaPlaylist::mediaInserted(int start, int end) + + This signal is emitted after media has been inserted into the playlist. + The new items are those between \a start and \a end inclusive. + */ + +/*! + \fn void QMediaPlaylist::mediaRemoved(int start, int end) + + This signal is emitted after media has been removed from the playlist. + The removed items are those between \a start and \a end inclusive. + */ + +/*! + \fn void QMediaPlaylist::mediaChanged(int start, int end) + + This signal is emitted after media has been changed in the playlist + between \a start and \a end positions inclusive. + */ + +/*! + \fn void QMediaPlaylist::currentIndexChanged(int position) + + Signal emitted when playlist position changed to \a position. +*/ + +/*! + \fn void QMediaPlaylist::playbackModeChanged(QMediaPlaylist::PlaybackMode mode) + + Signal emitted when playback mode changed to \a mode. +*/ + +/*! + \fn void QMediaPlaylist::mediaAboutToBeInserted(int start, int end) + + Signal emitted when items are to be inserted at \a start and ending at \a end. +*/ + +/*! + \fn void QMediaPlaylist::mediaAboutToBeRemoved(int start, int end) + + Signal emitted when item are to be deleted at \a start and ending at \a end. +*/ + +/*! + \fn void QMediaPlaylist::currentMediaChanged(const QUrl &content) + + Signal emitted when current media changes to \a content. +*/ + +/*! + \property QMediaPlaylist::currentIndex + \brief Current position. +*/ + +/*! + \property QMediaPlaylist::currentMedia + \brief Current media content. +*/ + +/*! + \fn QMediaPlaylist::loaded() + + Signal emitted when playlist finished loading. +*/ + +/*! + \fn QMediaPlaylist::loadFailed() + + Signal emitted if failed to load playlist. +*/ + +/*! + \enum QMediaPlaylist::Error + + This enum describes the QMediaPlaylist error codes. + + \value NoError No errors. + \value FormatError Format error. + \value FormatNotSupportedError Format not supported. + \value NetworkError Network error. + \value AccessDeniedError Access denied error. +*/ + +QT_END_NAMESPACE + +#include "moc_qmediaplaylist.cpp" diff --git a/examples/multimedia/player/qmediaplaylist.h b/examples/multimedia/player/qmediaplaylist.h new file mode 100644 index 0000000..d677753 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist.h @@ -0,0 +1,90 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMEDIAPLAYLIST_H +#define QMEDIAPLAYLIST_H + +#include + +QT_BEGIN_NAMESPACE + +class QMediaPlaylistPrivate; +class QMediaPlaylist : public QObject +{ + Q_OBJECT + Q_PROPERTY(QMediaPlaylist::PlaybackMode playbackMode READ playbackMode WRITE setPlaybackMode + NOTIFY playbackModeChanged) + Q_PROPERTY(QUrl currentMedia READ currentMedia NOTIFY currentMediaChanged) + Q_PROPERTY(int currentIndex READ currentIndex WRITE setCurrentIndex NOTIFY currentIndexChanged) + +public: + enum PlaybackMode { CurrentItemOnce, CurrentItemInLoop, Sequential, Loop }; + Q_ENUM(PlaybackMode) + enum Error { NoError, FormatError, FormatNotSupportedError, NetworkError, AccessDeniedError }; + Q_ENUM(Error) + + explicit QMediaPlaylist(QObject *parent = nullptr); + virtual ~QMediaPlaylist(); + + PlaybackMode playbackMode() const; + void setPlaybackMode(PlaybackMode mode); + + int currentIndex() const; + QUrl currentMedia() const; + + int nextIndex(int steps = 1) const; + int previousIndex(int steps = 1) const; + + QUrl media(int index) const; + + int mediaCount() const; + bool isEmpty() const; + + void addMedia(const QUrl &content); + void addMedia(const QList &items); + bool insertMedia(int index, const QUrl &content); + bool insertMedia(int index, const QList &items); + bool moveMedia(int from, int to); + bool removeMedia(int pos); + bool removeMedia(int start, int end); + void clear(); + + void load(const QUrl &location, const char *format = nullptr); + void load(QIODevice *device, const char *format = nullptr); + + bool save(const QUrl &location, const char *format = nullptr) const; + bool save(QIODevice *device, const char *format) const; + + Error error() const; + QString errorString() const; + +public slots: + void shuffle(); + + void next(); + void previous(); + + void setCurrentIndex(int index); + +signals: + void currentIndexChanged(int index); + void playbackModeChanged(QMediaPlaylist::PlaybackMode mode); + void currentMediaChanged(const QUrl &); + + void mediaAboutToBeInserted(int start, int end); + void mediaInserted(int start, int end); + void mediaAboutToBeRemoved(int start, int end); + void mediaRemoved(int start, int end); + void mediaChanged(int start, int end); + + void loaded(); + void loadFailed(); + +private: + QMediaPlaylistPrivate *d_ptr = nullptr; + Q_DECLARE_PRIVATE(QMediaPlaylist) +}; + +QT_END_NAMESPACE + +#endif // QMEDIAPLAYLIST_H diff --git a/examples/multimedia/player/qmediaplaylist_p.cpp b/examples/multimedia/player/qmediaplaylist_p.cpp new file mode 100644 index 0000000..13e1644 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist_p.cpp @@ -0,0 +1,65 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "qmediaplaylist_p.h" + +QT_BEGIN_NAMESPACE + +QMediaPlaylistPrivate::QMediaPlaylistPrivate() : error(QMediaPlaylist::NoError) { } + +QMediaPlaylistPrivate::~QMediaPlaylistPrivate() +{ + delete parser; +} + +void QMediaPlaylistPrivate::loadFailed(QMediaPlaylist::Error error, const QString &errorString) +{ + this->error = error; + this->errorString = errorString; + + emit q_ptr->loadFailed(); +} + +void QMediaPlaylistPrivate::loadFinished() +{ + q_ptr->addMedia(parser->playlist); + + emit q_ptr->loaded(); +} + +bool QMediaPlaylistPrivate::checkFormat(const char *format) const +{ + QLatin1String f(format); + QPlaylistFileParser::FileType type = + format ? QPlaylistFileParser::UNKNOWN : QPlaylistFileParser::M3U8; + if (format) { + if (f == QLatin1String("m3u") || f == QLatin1String("text/uri-list") + || f == QLatin1String("audio/x-mpegurl") || f == QLatin1String("audio/mpegurl")) + type = QPlaylistFileParser::M3U; + else if (f == QLatin1String("m3u8") || f == QLatin1String("application/x-mpegURL") + || f == QLatin1String("application/vnd.apple.mpegurl")) + type = QPlaylistFileParser::M3U8; + } + + if (type == QPlaylistFileParser::UNKNOWN || type == QPlaylistFileParser::PLS) { + error = QMediaPlaylist::FormatNotSupportedError; + errorString = QMediaPlaylist::tr("This file format is not supported."); + return false; + } + return true; +} + +void QMediaPlaylistPrivate::ensureParser() +{ + if (parser) + return; + + parser = new QPlaylistFileParser(q_ptr); + QObject::connect(parser, &QPlaylistFileParser::finished, q_ptr, [this]() { loadFinished(); }); + QObject::connect(parser, &QPlaylistFileParser::error, q_ptr, + [this](QMediaPlaylist::Error err, const QString &errorMsg) { + loadFailed(err, errorMsg); + }); +} + +QT_END_NAMESPACE diff --git a/examples/multimedia/player/qmediaplaylist_p.h b/examples/multimedia/player/qmediaplaylist_p.h new file mode 100644 index 0000000..9755526 --- /dev/null +++ b/examples/multimedia/player/qmediaplaylist_p.h @@ -0,0 +1,66 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMEDIAPLAYLIST_P_H +#define QMEDIAPLAYLIST_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include "qmediaplaylist.h" +#include "qplaylistfileparser.h" + +#include + +#include + +#ifdef Q_MOC_RUN +# pragma Q_MOC_EXPAND_MACROS +#endif + +QT_BEGIN_NAMESPACE + +class QMediaPlaylistControl; + +class QMediaPlaylistPrivate +{ + Q_DECLARE_PUBLIC(QMediaPlaylist) +public: + QMediaPlaylistPrivate(); + + virtual ~QMediaPlaylistPrivate(); + + void loadFailed(QMediaPlaylist::Error error, const QString &errorString); + + void loadFinished(); + + bool checkFormat(const char *format) const; + + void ensureParser(); + + int nextPosition(int steps) const; + int prevPosition(int steps) const; + + QList playlist; + + int currentPos = -1; + QMediaPlaylist::PlaybackMode playbackMode = QMediaPlaylist::Sequential; + + QPlaylistFileParser *parser = nullptr; + mutable QMediaPlaylist::Error error; + mutable QString errorString; + + QMediaPlaylist *q_ptr = nullptr; +}; + +QT_END_NAMESPACE + +#endif // QMEDIAPLAYLIST_P_H diff --git a/examples/multimedia/player/qplaylistfileparser.cpp b/examples/multimedia/player/qplaylistfileparser.cpp new file mode 100644 index 0000000..4e8f4dd --- /dev/null +++ b/examples/multimedia/player/qplaylistfileparser.cpp @@ -0,0 +1,621 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "qmediametadata.h" +#include "qmediaplayer.h" +#include "qplaylistfileparser.h" + +#include +#include +#include +#include +#include +#include + +QT_BEGIN_NAMESPACE + +namespace { + +class ParserBase +{ +public: + explicit ParserBase(QPlaylistFileParser *parent) : m_parent(parent), m_aborted(false) + { + Q_ASSERT(m_parent); + } + + bool parseLine(int lineIndex, const QString &line, const QUrl &root) + { + if (m_aborted) + return false; + + const bool ok = parseLineImpl(lineIndex, line, root); + return ok && !m_aborted; + } + + virtual void abort() { m_aborted = true; } + virtual ~ParserBase() = default; + +protected: + virtual bool parseLineImpl(int lineIndex, const QString &line, const QUrl &root) = 0; + + static QUrl expandToFullPath(const QUrl &root, const QString &line) + { + // On Linux, backslashes are not converted to forward slashes :/ + if (line.startsWith(QLatin1String("//")) || line.startsWith(QLatin1String("\\\\"))) { + // Network share paths are not resolved + return QUrl::fromLocalFile(line); + } + + QUrl url(line); + if (url.scheme().isEmpty()) { + // Resolve it relative to root + if (root.isLocalFile()) + return QUrl::fromUserInput(line, root.adjusted(QUrl::RemoveFilename).toLocalFile(), + QUrl::AssumeLocalFile); + return root.resolved(url); + } + if (url.scheme().length() == 1) + // Assume it's a drive letter for a Windows path + url = QUrl::fromLocalFile(line); + + return url; + } + + void newItemFound(const QVariant &content) { Q_EMIT m_parent->newItem(content); } + + QPlaylistFileParser *m_parent; + bool m_aborted; +}; + +class M3UParser : public ParserBase +{ +public: + explicit M3UParser(QPlaylistFileParser *q) : ParserBase(q), m_extendedFormat(false) { } + + /* + * + Extended M3U directives + + #EXTM3U - header - must be first line of file + #EXTINF - extra info - length (seconds), title + #EXTINF - extra info - length (seconds), artist '-' title + + Example + + #EXTM3U + #EXTINF:123, Sample artist - Sample title + C:\Documents and Settings\I\My Music\Sample.mp3 + #EXTINF:321,Example Artist - Example title + C:\Documents and Settings\I\My Music\Greatest Hits\Example.ogg + + */ + bool parseLineImpl(int lineIndex, const QString &line, const QUrl &root) override + { + if (line[0] == u'#') { + if (m_extendedFormat) { + if (line.startsWith(QLatin1String("#EXTINF:"))) { + m_extraInfo.clear(); + int artistStart = line.indexOf(QLatin1String(","), 8); + bool ok = false; + QStringView lineView{ line }; + int length = lineView.mid(8, artistStart < 8 ? -1 : artistStart - 8) + .trimmed() + .toInt(&ok); + if (ok && length > 0) { + // convert from second to milisecond + m_extraInfo[QMediaMetaData::Duration] = QVariant(length * 1000); + } + if (artistStart > 0) { + int titleStart = getSplitIndex(line, artistStart); + if (titleStart > artistStart) { + m_extraInfo[QMediaMetaData::Author] = + lineView.mid(artistStart + 1, titleStart - artistStart - 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + m_extraInfo[QMediaMetaData::Title] = + lineView.mid(titleStart + 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + } else { + m_extraInfo[QMediaMetaData::Title] = + lineView.mid(artistStart + 1) + .trimmed() + .toString() + .replace(QLatin1String("--"), QLatin1String("-")); + } + } + } + } else if (lineIndex == 0 && line.startsWith(QLatin1String("#EXTM3U"))) { + m_extendedFormat = true; + } + } else { + QUrl url = expandToFullPath(root, line); + m_extraInfo[QMediaMetaData::Url] = url; + m_parent->playlist.append(url); + newItemFound(QVariant::fromValue(m_extraInfo)); + m_extraInfo.clear(); + } + + return true; + } + + int getSplitIndex(const QString &line, int startPos) + { + if (startPos < 0) + startPos = 0; + const QChar *buf = line.data(); + for (int i = startPos; i < line.length(); ++i) { + if (buf[i] == u'-') { + if (i == line.length() - 1) + return i; + ++i; + if (buf[i] != u'-') + return i - 1; + } + } + return -1; + } + +private: + QMediaMetaData m_extraInfo; + bool m_extendedFormat; +}; + +class PLSParser : public ParserBase +{ +public: + explicit PLSParser(QPlaylistFileParser *q) : ParserBase(q) { } + + /* + * + The format is essentially that of an INI file structured as follows: + + Header + + * [playlist] : This tag indicates that it is a Playlist File + + Track Entry + Assuming track entry #X + + * FileX : Variable defining location of stream. + * TitleX : Defines track title. + * LengthX : Length in seconds of track. Value of -1 indicates indefinite. + + Footer + + * NumberOfEntries : This variable indicates the number of tracks. + * Version : Playlist version. Currently only a value of 2 is valid. + + [playlist] + + File1=Alternative\everclear - SMFTA.mp3 + + Title1=Everclear - So Much For The Afterglow + + Length1=233 + + File2=http://www.site.com:8000/listen.pls + + Title2=My Cool Stream + + Length5=-1 + + NumberOfEntries=2 + + Version=2 + */ + bool parseLineImpl(int, const QString &line, const QUrl &root) override + { + // We ignore everything but 'File' entries, since that's the only thing we care about. + if (!line.startsWith(QLatin1String("File"))) + return true; + + QString value = getValue(line); + if (value.isEmpty()) + return true; + + QUrl path = expandToFullPath(root, value); + m_parent->playlist.append(path); + newItemFound(path); + + return true; + } + + QString getValue(QStringView line) + { + int start = line.indexOf(u'='); + if (start < 0) + return QString(); + return line.mid(start + 1).trimmed().toString(); + } +}; +} + +///////////////////////////////////////////////////////////////////////////////////////////////// + +class QPlaylistFileParserPrivate +{ + Q_DECLARE_PUBLIC(QPlaylistFileParser) +public: + QPlaylistFileParserPrivate(QPlaylistFileParser *q) + : q_ptr(q), + m_stream(nullptr), + m_type(QPlaylistFileParser::UNKNOWN), + m_scanIndex(0), + m_lineIndex(-1), + m_utf8(false), + m_aborted(false) + { + } + + void handleData(); + void handleParserFinished(); + void abort(); + void reset(); + + QScopedPointer m_source; + QScopedPointer m_currentParser; + QByteArray m_buffer; + QUrl m_root; + QNetworkAccessManager m_mgr; + QString m_mimeType; + QPlaylistFileParser *q_ptr; + QPointer m_stream; + QPlaylistFileParser::FileType m_type; + struct ParserJob + { + QIODevice *m_stream = nullptr; + QUrl m_media; + QString m_mimeType; + [[nodiscard]] bool isValid() const { return m_stream || !m_media.isEmpty(); } + void reset() + { + m_stream = nullptr; + m_media = QUrl(); + m_mimeType = QString(); + } + } m_pendingJob; + int m_scanIndex; + int m_lineIndex; + bool m_utf8; + bool m_aborted; + +private: + bool processLine(int startIndex, int length); +}; + +#define LINE_LIMIT 4096 +#define READ_LIMIT 64 + +bool QPlaylistFileParserPrivate::processLine(int startIndex, int length) +{ + Q_Q(QPlaylistFileParser); + m_lineIndex++; + + if (!m_currentParser) { + const QString urlString = m_root.toString(); + const QString &suffix = !urlString.isEmpty() ? QFileInfo(urlString).suffix() : urlString; + QString mimeType; + if (m_source) + mimeType = m_source->header(QNetworkRequest::ContentTypeHeader).toString(); + m_type = QPlaylistFileParser::findPlaylistType( + suffix, !mimeType.isEmpty() ? mimeType : m_mimeType, m_buffer.constData(), + quint32(m_buffer.size())); + + switch (m_type) { + case QPlaylistFileParser::UNKNOWN: + emit q->error(QMediaPlaylist::FormatError, + QMediaPlaylist::tr("%1 playlist type is unknown").arg(m_root.toString())); + q->abort(); + return false; + case QPlaylistFileParser::M3U: + m_currentParser.reset(new M3UParser(q)); + break; + case QPlaylistFileParser::M3U8: + m_currentParser.reset(new M3UParser(q)); + m_utf8 = true; + break; + case QPlaylistFileParser::PLS: + m_currentParser.reset(new PLSParser(q)); + break; + } + + Q_ASSERT(!m_currentParser.isNull()); + } + + QString line; + + if (m_utf8) { + line = QString::fromUtf8(m_buffer.constData() + startIndex, length).trimmed(); + } else { + line = QString::fromLatin1(m_buffer.constData() + startIndex, length).trimmed(); + } + if (line.isEmpty()) + return true; + + Q_ASSERT(m_currentParser); + return m_currentParser->parseLine(m_lineIndex, line, m_root); +} + +void QPlaylistFileParserPrivate::handleData() +{ + Q_Q(QPlaylistFileParser); + + if (!m_stream) + return; + + while (m_stream->bytesAvailable() && !m_aborted) { + int expectedBytes = + qMin(READ_LIMIT, + int(qMin(m_stream->bytesAvailable(), qint64(LINE_LIMIT - m_buffer.size())))); + m_buffer.push_back(m_stream->read(expectedBytes)); + int processedBytes = 0; + while (m_scanIndex < m_buffer.length() && !m_aborted) { + char s = m_buffer[m_scanIndex]; + if (s == '\r' || s == '\n') { + int l = m_scanIndex - processedBytes; + if (l > 0) { + if (!processLine(processedBytes, l)) + break; + } + processedBytes = m_scanIndex + 1; + } + m_scanIndex++; + } + + if (m_aborted) + break; + + if (m_buffer.length() - processedBytes >= LINE_LIMIT) { + emit q->error(QMediaPlaylist::FormatError, + QMediaPlaylist::tr("invalid line in playlist file")); + q->abort(); + break; + } + + if (!m_stream->bytesAvailable() && (!m_source || !m_source->isFinished())) { + // last line + processLine(processedBytes, -1); + break; + } + + Q_ASSERT(m_buffer.length() == m_scanIndex); + if (processedBytes == 0) + continue; + + int copyLength = m_buffer.length() - processedBytes; + if (copyLength > 0) { + Q_ASSERT(copyLength <= READ_LIMIT); + m_buffer = m_buffer.right(copyLength); + } else { + m_buffer.clear(); + } + m_scanIndex = 0; + } + + handleParserFinished(); +} + +QPlaylistFileParser::QPlaylistFileParser(QObject *parent) + : QObject(parent), d_ptr(new QPlaylistFileParserPrivate(this)) +{ +} + +QPlaylistFileParser::~QPlaylistFileParser() = default; + +QPlaylistFileParser::FileType QPlaylistFileParser::findByMimeType(const QString &mime) +{ + if (mime == QLatin1String("text/uri-list") || mime == QLatin1String("audio/x-mpegurl") + || mime == QLatin1String("audio/mpegurl")) + return QPlaylistFileParser::M3U; + + if (mime == QLatin1String("application/x-mpegURL") + || mime == QLatin1String("application/vnd.apple.mpegurl")) + return QPlaylistFileParser::M3U8; + + if (mime == QLatin1String("audio/x-scpls")) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findBySuffixType(const QString &suffix) +{ + const QString &s = suffix.toLower(); + + if (s == QLatin1String("m3u")) + return QPlaylistFileParser::M3U; + + if (s == QLatin1String("m3u8")) + return QPlaylistFileParser::M3U8; + + if (s == QLatin1String("pls")) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findByDataHeader(const char *data, quint32 size) +{ + if (!data || size == 0) + return QPlaylistFileParser::UNKNOWN; + + if (size >= 7 && strncmp(data, "#EXTM3U", 7) == 0) + return QPlaylistFileParser::M3U; + + if (size >= 10 && strncmp(data, "[playlist]", 10) == 0) + return QPlaylistFileParser::PLS; + + return QPlaylistFileParser::UNKNOWN; +} + +QPlaylistFileParser::FileType QPlaylistFileParser::findPlaylistType(const QString &suffix, + const QString &mime, + const char *data, quint32 size) +{ + + FileType dataHeaderType = findByDataHeader(data, size); + if (dataHeaderType != UNKNOWN) + return dataHeaderType; + + FileType mimeType = findByMimeType(mime); + if (mimeType != UNKNOWN) + return mimeType; + + mimeType = findBySuffixType(mime); + if (mimeType != UNKNOWN) + return mimeType; + + FileType suffixType = findBySuffixType(suffix); + if (suffixType != UNKNOWN) + return suffixType; + + return UNKNOWN; +} + +/* + * Delegating + */ +void QPlaylistFileParser::start(const QUrl &media, QIODevice *stream, const QString &mimeType) +{ + if (stream) + start(stream, mimeType); + else + start(media, mimeType); +} + +void QPlaylistFileParser::start(QIODevice *stream, const QString &mimeType) +{ + Q_D(QPlaylistFileParser); + const bool validStream = stream ? (stream->isOpen() && stream->isReadable()) : false; + + if (!validStream) { + Q_EMIT error(QMediaPlaylist::AccessDeniedError, QMediaPlaylist::tr("Invalid stream")); + return; + } + + if (!d->m_currentParser.isNull()) { + abort(); + d->m_pendingJob = { stream, QUrl(), mimeType }; + return; + } + + playlist.clear(); + d->reset(); + d->m_mimeType = mimeType; + d->m_stream = stream; + connect(d->m_stream, SIGNAL(readyRead()), this, SLOT(handleData())); + d->handleData(); +} + +void QPlaylistFileParser::start(const QUrl &request, const QString &mimeType) +{ + Q_D(QPlaylistFileParser); + const QUrl &url = request.url(); + + if (url.isLocalFile() && !QFile::exists(url.toLocalFile())) { + emit error(QMediaPlaylist::AccessDeniedError, + QString(QMediaPlaylist::tr("%1 does not exist")).arg(url.toString())); + return; + } + + if (!d->m_currentParser.isNull()) { + abort(); + d->m_pendingJob = { nullptr, request, mimeType }; + return; + } + + d->reset(); + d->m_root = url; + d->m_mimeType = mimeType; + d->m_source.reset(d->m_mgr.get(QNetworkRequest(request))); + d->m_stream = d->m_source.get(); + connect(d->m_source.data(), SIGNAL(readyRead()), this, SLOT(handleData())); + connect(d->m_source.data(), SIGNAL(finished()), this, SLOT(handleData())); + connect(d->m_source.data(), SIGNAL(errorOccurred(QNetworkReply::NetworkError)), this, + SLOT(handleError())); + + if (url.isLocalFile()) + d->handleData(); +} + +void QPlaylistFileParser::abort() +{ + Q_D(QPlaylistFileParser); + d->abort(); + + if (d->m_source) + d->m_source->disconnect(); + + if (d->m_stream) + disconnect(d->m_stream, SIGNAL(readyRead()), this, SLOT(handleData())); + + playlist.clear(); +} + +void QPlaylistFileParser::handleData() +{ + Q_D(QPlaylistFileParser); + d->handleData(); +} + +void QPlaylistFileParserPrivate::handleParserFinished() +{ + Q_Q(QPlaylistFileParser); + const bool isParserValid = !m_currentParser.isNull(); + if (!isParserValid && !m_aborted) + emit q->error(QMediaPlaylist::FormatNotSupportedError, + QMediaPlaylist::tr("Empty file provided")); + + if (isParserValid && !m_aborted) { + m_currentParser.reset(); + emit q->finished(); + } + + if (!m_aborted) + q->abort(); + + if (!m_source.isNull()) + m_source.reset(); + + if (m_pendingJob.isValid()) + q->start(m_pendingJob.m_media, m_pendingJob.m_stream, m_pendingJob.m_mimeType); +} + +void QPlaylistFileParserPrivate::abort() +{ + m_aborted = true; + if (!m_currentParser.isNull()) + m_currentParser->abort(); +} + +void QPlaylistFileParserPrivate::reset() +{ + Q_ASSERT(m_currentParser.isNull()); + Q_ASSERT(m_source.isNull()); + m_buffer.clear(); + m_root.clear(); + m_mimeType.clear(); + m_stream = nullptr; + m_type = QPlaylistFileParser::UNKNOWN; + m_scanIndex = 0; + m_lineIndex = -1; + m_utf8 = false; + m_aborted = false; + m_pendingJob.reset(); +} + +void QPlaylistFileParser::handleError() +{ + Q_D(QPlaylistFileParser); + const QString &errorString = d->m_source->errorString(); + Q_EMIT error(QMediaPlaylist::NetworkError, errorString); + abort(); +} + +QT_END_NAMESPACE + +#include "moc_qplaylistfileparser.cpp" diff --git a/examples/multimedia/player/qplaylistfileparser.h b/examples/multimedia/player/qplaylistfileparser.h new file mode 100644 index 0000000..0d83289 --- /dev/null +++ b/examples/multimedia/player/qplaylistfileparser.h @@ -0,0 +1,76 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PLAYLISTFILEPARSER_P_H +#define PLAYLISTFILEPARSER_P_H + +// +// W A R N I N G +// ------------- +// +// This file is not part of the Qt API. It exists purely as an +// implementation detail. This header file may change from version to +// version without notice, or even be removed. +// +// We mean it. +// + +#include "qmediaplaylist.h" +#include "qtmultimediaglobal.h" + +#include + +QT_BEGIN_NAMESPACE + +class QIODevice; +class QUrl; +class QNetworkRequest; + +class QPlaylistFileParserPrivate; + +class QPlaylistFileParser : public QObject +{ + Q_OBJECT +public: + QPlaylistFileParser(QObject *parent = nullptr); + ~QPlaylistFileParser(); + + enum FileType { + UNKNOWN, + M3U, + M3U8, // UTF-8 version of M3U + PLS + }; + + void start(const QUrl &media, QIODevice *stream = nullptr, const QString &mimeType = QString()); + void start(const QUrl &request, const QString &mimeType = QString()); + void start(QIODevice *stream, const QString &mimeType = QString()); + void abort(); + + QList playlist; + +signals: + void newItem(const QVariant &content); + void finished(); + void error(QMediaPlaylist::Error err, const QString &errorMsg); + +private slots: + void handleData(); + void handleError(); + +private: + static FileType findByMimeType(const QString &mime); + static FileType findBySuffixType(const QString &suffix); + static FileType findByDataHeader(const char *data, quint32 size); + static FileType findPlaylistType(QIODevice *device, const QString &mime); + static FileType findPlaylistType(const QString &suffix, const QString &mime, + const char *data = nullptr, quint32 size = 0); + + Q_DISABLE_COPY(QPlaylistFileParser) + Q_DECLARE_PRIVATE(QPlaylistFileParser) + QScopedPointer d_ptr; +}; + +QT_END_NAMESPACE + +#endif // PLAYLISTFILEPARSER_P_H diff --git a/examples/multimedia/player/videowidget.cpp b/examples/multimedia/player/videowidget.cpp new file mode 100644 index 0000000..c09d90f --- /dev/null +++ b/examples/multimedia/player/videowidget.cpp @@ -0,0 +1,46 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videowidget.h" + +#include +#include + +VideoWidget::VideoWidget(QWidget *parent) : QVideoWidget(parent) +{ + setSizePolicy(QSizePolicy::Ignored, QSizePolicy::Ignored); + + QPalette p = palette(); + p.setColor(QPalette::Window, Qt::black); + setPalette(p); + +#ifndef Q_OS_ANDROID // QTBUG-95723 + setAttribute(Qt::WA_OpaquePaintEvent); +#endif +} + +void VideoWidget::keyPressEvent(QKeyEvent *event) +{ + if ((event->key() == Qt::Key_Escape || event->key() == Qt::Key_Back) && isFullScreen()) { + setFullScreen(false); + event->accept(); + } else if (event->key() == Qt::Key_Enter && event->modifiers() & Qt::Key_Alt) { + setFullScreen(!isFullScreen()); + event->accept(); + } else { + QVideoWidget::keyPressEvent(event); + } +} + +void VideoWidget::mouseDoubleClickEvent(QMouseEvent *event) +{ + setFullScreen(!isFullScreen()); + event->accept(); +} + +void VideoWidget::mousePressEvent(QMouseEvent *event) +{ + QVideoWidget::mousePressEvent(event); +} + +#include "moc_videowidget.cpp" diff --git a/examples/multimedia/player/videowidget.h b/examples/multimedia/player/videowidget.h new file mode 100644 index 0000000..3505a3f --- /dev/null +++ b/examples/multimedia/player/videowidget.h @@ -0,0 +1,22 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOWIDGET_H +#define VIDEOWIDGET_H + +#include + +class VideoWidget : public QVideoWidget +{ + Q_OBJECT + +public: + explicit VideoWidget(QWidget *parent = nullptr); + +protected: + void keyPressEvent(QKeyEvent *event) override; + void mouseDoubleClickEvent(QMouseEvent *event) override; + void mousePressEvent(QMouseEvent *event) override; +}; + +#endif // VIDEOWIDGET_H diff --git a/examples/multimedia/screencapture/CMakeLists.txt b/examples/multimedia/screencapture/CMakeLists.txt new file mode 100644 index 0000000..a8603d1 --- /dev/null +++ b/examples/multimedia/screencapture/CMakeLists.txt @@ -0,0 +1,61 @@ +cmake_minimum_required(VERSION 3.16) + +project(screencapture VERSION 0.1 LANGUAGES CXX) + +set(CMAKE_INCLUDE_CURRENT_DIR ON) + +set(CMAKE_AUTOUIC ON) +set(CMAKE_AUTOMOC ON) +set(CMAKE_AUTORCC ON) + +set(CMAKE_CXX_STANDARD 17) +set(CMAKE_CXX_STANDARD_REQUIRED ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/screencapture") + +find_package(QT NAMES Qt6 Qt5 REQUIRED COMPONENTS Widgets) +find_package(Qt${QT_VERSION_MAJOR} REQUIRED COMPONENTS MultimediaWidgets Widgets) + +set(PROJECT_SOURCES + screencapture.pro + main.cpp + screencapturepreview.cpp + screencapturepreview.h + screenlistmodel.h + screenlistmodel.cpp + windowlistmodel.h + windowlistmodel.cpp +) + +qt_add_executable(screencapture + MANUAL_FINALIZATION + ${PROJECT_SOURCES} + ) + +target_link_libraries(screencapture PRIVATE + Qt${QT_VERSION_MAJOR}::Core + Qt${QT_VERSION_MAJOR}::Gui + Qt${QT_VERSION_MAJOR}::Widgets + Qt${QT_VERSION_MAJOR}::Multimedia + Qt${QT_VERSION_MAJOR}::MultimediaWidgets) + +set_target_properties(screencapture PROPERTIES + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + MACOSX_BUNDLE TRUE + WIN32_EXECUTABLE TRUE + QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android +) + +qt_add_ios_ffmpeg_libraries(screencapture) + +install(TARGETS screencapture + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +qt_finalize_executable(screencapture) diff --git a/examples/multimedia/screencapture/Info.plist.in b/examples/multimedia/screencapture/Info.plist.in new file mode 100644 index 0000000..02c09f8 --- /dev/null +++ b/examples/multimedia/screencapture/Info.plist.in @@ -0,0 +1,41 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/screencapture/android/AndroidManifest.xml b/examples/multimedia/screencapture/android/AndroidManifest.xml new file mode 100644 index 0000000..6513577 --- /dev/null +++ b/examples/multimedia/screencapture/android/AndroidManifest.xml @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/screencapture/doc/images/screencapture.jpg b/examples/multimedia/screencapture/doc/images/screencapture.jpg new file mode 100644 index 0000000000000000000000000000000000000000..fb61fcd73d766c18f50a5fb73a41f4a267be0880 GIT binary patch literal 42725 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/screencapture/doc/src/screencapture.qdoc b/examples/multimedia/screencapture/doc/src/screencapture.qdoc new file mode 100644 index 0000000..405c59d --- /dev/null +++ b/examples/multimedia/screencapture/doc/src/screencapture.qdoc @@ -0,0 +1,48 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example screencapture + \title Screen Capture Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Capturing a screen or window. + \meta {tag} {widgets} + + \e{Screen Capture} demonstrates how to capture a screen or window using + QScreenCapture and QWindowCapture. The example shows a list of screens and + windows and displays a live preview of the selected item using a + QMediaCaptureSession and a QVideoWidget. Capturing can be started and stopped + with a \l{QPushButton}{button}. + + \image screencapture.jpg + + \include examples-run.qdocinc + + \section1 Application Structure + + The example consists of three custom classes. The UI and all screen capture + functionality is implemented in the class ScreenCapturePreview. The classes + ScreenListModel and WindowListModel only serve as models behind the two + QListView widgets. The main function creates a ScreenCapturePreview object, + which in turn creates instances of QScreenCapture and QWindowCapture, + and a QMediaCaptureSession and QVideoWidget, in addition to all the UI widgets. + + The screen and window models are populated with the return values of + \l QGuiApplication::screens() and \l QWindowCapture::capturableWindows(), + respectively. + + When a list item is selected, it is connected to the QScreenCapture object + with \l{QScreenCapture::}{setScreen()}, or to the QWindowCapture object + with \l{QWindowCapture::}{setWindow()}. The capture object is connected to + the QMediaCaptureSession object with \l{QMediaCaptureSession::}{setScreenCapture()} + and \l{QMediaCaptureSession::}{setWindowCapture()}, respectively. + The capture session in turn is connected to the QVideoWidget object with + \l{QMediaCaptureSession::}{setVideoOutput()}. Thus, the capture output is + previewed in the video widget on the right hand side of the UI. + + The start/stop button calls \l QScreenCapture::start() and \l QScreenCapture::stop(), + or \l QWindowCapture::start() and \l QWindowCapture::stop(). + + A QMessageBox pops up if the \l{QScreenCapture::}{errorOccurred} signal is emitted. +*/ diff --git a/examples/multimedia/screencapture/main.cpp b/examples/multimedia/screencapture/main.cpp new file mode 100644 index 0000000..6ed104f --- /dev/null +++ b/examples/multimedia/screencapture/main.cpp @@ -0,0 +1,14 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screencapturepreview.h" + +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + ScreenCapturePreview screenCapturePreview; + screenCapturePreview.show(); + return app.exec(); +} diff --git a/examples/multimedia/screencapture/screencapture.pro b/examples/multimedia/screencapture/screencapture.pro new file mode 100644 index 0000000..d18f556 --- /dev/null +++ b/examples/multimedia/screencapture/screencapture.pro @@ -0,0 +1,18 @@ +TEMPLATE = app +TARGET = screencapture + +QT += multimedia multimediawidgets + +HEADERS = \ + screencapturepreview.h \ + screenlistmodel.h \ + windowlistmodel.h + +SOURCES = \ + main.cpp \ + screencapturepreview.cpp \ + screenlistmodel.cpp \ + windowlistmodel.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/screencapture +INSTALLS += target diff --git a/examples/multimedia/screencapture/screencapturepreview.cpp b/examples/multimedia/screencapture/screencapturepreview.cpp new file mode 100644 index 0000000..6eda008 --- /dev/null +++ b/examples/multimedia/screencapture/screencapturepreview.cpp @@ -0,0 +1,179 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screencapturepreview.h" +#include "screenlistmodel.h" +#include "windowlistmodel.h" + +#include +#include +#include + +#include +#include +#include +#include +#include +#include +#include + +ScreenCapturePreview::ScreenCapturePreview(QWidget *parent) + : QWidget(parent), + screenListView(new QListView(this)), + windowListView(new QListView(this)), + screenCapture(new QScreenCapture(this)), + windowCapture(new QWindowCapture(this)), + mediaCaptureSession(new QMediaCaptureSession(this)), + videoWidget(new QVideoWidget(this)), + gridLayout(new QGridLayout(this)), + startStopButton(new QPushButton(this)), + screenLabel(new QLabel(tr("Select screen to capture:"), this)), + windowLabel(new QLabel(tr("Select window to capture:"), this)), + videoWidgetLabel(new QLabel(tr("Capture output:"), this)) +{ + // Get lists of screens and windows: + screenListModel = new ScreenListModel(this); + windowListModel = new WindowListModel(this); + + // Setup QScreenCapture with initial source: + + mediaCaptureSession->setScreenCapture(screenCapture); + mediaCaptureSession->setWindowCapture(windowCapture); + mediaCaptureSession->setVideoOutput(videoWidget); + + // Setup UI: + + screenListView->setModel(screenListModel); + windowListView->setModel(windowListModel); + + auto updateAction = new QAction(tr("Update Windows List"), this); + connect(updateAction, &QAction::triggered, windowListModel, &WindowListModel::populate); + windowListView->addAction(updateAction); + windowListView->setContextMenuPolicy(Qt::ActionsContextMenu); + + gridLayout->addWidget(screenLabel, 0, 0); + gridLayout->addWidget(screenListView, 1, 0); + gridLayout->addWidget(windowLabel, 2, 0); + gridLayout->addWidget(windowListView, 3, 0); + gridLayout->addWidget(startStopButton, 4, 0); + gridLayout->addWidget(videoWidgetLabel, 0, 1); + gridLayout->addWidget(videoWidget, 1, 1, 4, 1); + + gridLayout->setColumnStretch(1, 1); + gridLayout->setRowStretch(1, 1); + gridLayout->setColumnMinimumWidth(0, 400); + gridLayout->setColumnMinimumWidth(1, 400); + gridLayout->setRowMinimumHeight(3, 1); + + connect(screenListView->selectionModel(), &QItemSelectionModel::selectionChanged, this, + &ScreenCapturePreview::onCurrentScreenSelectionChanged); + connect(windowListView->selectionModel(), &QItemSelectionModel::selectionChanged, this, + &ScreenCapturePreview::onCurrentWindowSelectionChanged); + connect(startStopButton, &QPushButton::clicked, this, + &ScreenCapturePreview::onStartStopButtonClicked); + connect(screenCapture, &QScreenCapture::errorChanged, this, + &ScreenCapturePreview::onScreenCaptureErrorChanged, Qt::QueuedConnection); + connect(windowCapture, &QWindowCapture::errorChanged, this, + &ScreenCapturePreview::onWindowCaptureErrorChanged, Qt::QueuedConnection); + + updateActive(SourceType::Screen, true); +} + +ScreenCapturePreview::~ScreenCapturePreview() = default; + +void ScreenCapturePreview::onCurrentScreenSelectionChanged(QItemSelection selection) +{ + if (auto indexes = selection.indexes(); !indexes.empty()) { + screenCapture->setScreen(screenListModel->screen(indexes.front())); + updateActive(SourceType::Screen, isActive()); + + windowListView->clearSelection(); + } else { + screenCapture->setScreen(nullptr); + } +} + +void ScreenCapturePreview::onCurrentWindowSelectionChanged(QItemSelection selection) +{ + if (auto indexes = selection.indexes(); !indexes.empty()) { + auto window = windowListModel->window(indexes.front()); + if (!window.isValid()) { + const auto questionResult = QMessageBox::question( + this, tr("Invalid window"), + tr("The window is no longer valid. Update the list of windows?")); + if (questionResult == QMessageBox::Yes) { + updateActive(SourceType::Window, false); + + windowListView->clearSelection(); + windowListModel->populate(); + return; + } + } + + windowCapture->setWindow(window); + updateActive(SourceType::Window, isActive()); + + screenListView->clearSelection(); + } else { + windowCapture->setWindow({}); + } +} + +void ScreenCapturePreview::onWindowCaptureErrorChanged() +{ + if (windowCapture->error() == QWindowCapture::NoError) + return; + + QMessageBox::warning(this, tr("QWindowCapture: Error occurred"), windowCapture->errorString()); +} + +void ScreenCapturePreview::onScreenCaptureErrorChanged() +{ + if (screenCapture->error() == QScreenCapture::NoError) + return; + + QMessageBox::warning(this, tr("QScreenCapture: Error occurred"), screenCapture->errorString()); +} + +void ScreenCapturePreview::onStartStopButtonClicked() +{ + updateActive(sourceType, !isActive()); +} + +void ScreenCapturePreview::updateStartStopButtonText() +{ + switch (sourceType) { + case SourceType::Window: + startStopButton->setText(isActive() ? tr("Stop window capture") + : tr("Start window capture")); + break; + case SourceType::Screen: + startStopButton->setText(isActive() ? tr("Stop screen capture") + : tr("Start screen capture")); + break; + } +} + +void ScreenCapturePreview::updateActive(SourceType sourceType, bool active) +{ + this->sourceType = sourceType; + + screenCapture->setActive(active && sourceType == SourceType::Screen); + windowCapture->setActive(active && sourceType == SourceType::Window); + + updateStartStopButtonText(); +} + +bool ScreenCapturePreview::isActive() const +{ + switch (sourceType) { + case SourceType::Window: + return windowCapture->isActive(); + case SourceType::Screen: + return screenCapture->isActive(); + default: + return false; + } +} + +#include "moc_screencapturepreview.cpp" diff --git a/examples/multimedia/screencapture/screencapturepreview.h b/examples/multimedia/screencapture/screencapturepreview.h new file mode 100644 index 0000000..7f0e464 --- /dev/null +++ b/examples/multimedia/screencapture/screencapturepreview.h @@ -0,0 +1,67 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef SCREENCAPTUREPREVIEW_H +#define SCREENCAPTUREPREVIEW_H + +#include +#include +#include +#include + +class ScreenListModel; +class WindowListModel; + +QT_BEGIN_NAMESPACE +class QListView; +class QMediaCaptureSession; +class QVideoWidget; +class QGridLayout; +class QHBoxLayout; +class QLineEdit; +class QPushButton; +class QLabel; +QT_END_NAMESPACE + +QT_USE_NAMESPACE + +class ScreenCapturePreview : public QWidget +{ + Q_OBJECT + +public: + explicit ScreenCapturePreview(QWidget *parent = nullptr); + ~ScreenCapturePreview() override; + +private slots: + void onCurrentScreenSelectionChanged(QItemSelection index); + void onCurrentWindowSelectionChanged(QItemSelection index); + void onWindowCaptureErrorChanged(); + void onScreenCaptureErrorChanged(); + void onStartStopButtonClicked(); + +private: + enum class SourceType { Screen, Window }; + + void updateActive(SourceType sourceType, bool active); + void updateStartStopButtonText(); + bool isActive() const; + +private: + ScreenListModel *screenListModel = nullptr; + WindowListModel *windowListModel = nullptr; + QListView *screenListView = nullptr; + QListView *windowListView = nullptr; + QScreenCapture *screenCapture = nullptr; + QWindowCapture *windowCapture = nullptr; + QMediaCaptureSession *mediaCaptureSession = nullptr; + QVideoWidget *videoWidget = nullptr; + QGridLayout *gridLayout = nullptr; + QPushButton *startStopButton = nullptr; + QLabel *screenLabel = nullptr; + QLabel *windowLabel = nullptr; + QLabel *videoWidgetLabel = nullptr; + SourceType sourceType = SourceType::Screen; +}; + +#endif // SCREENCAPTUREPREVIEW_H diff --git a/examples/multimedia/screencapture/screenlistmodel.cpp b/examples/multimedia/screencapture/screenlistmodel.cpp new file mode 100644 index 0000000..0b46560 --- /dev/null +++ b/examples/multimedia/screencapture/screenlistmodel.cpp @@ -0,0 +1,54 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "screenlistmodel.h" + +#include +#include + +#include + +ScreenListModel::ScreenListModel(QObject *parent) : + QAbstractListModel(parent) +{ + auto *app = qApp; + connect(app, &QGuiApplication::screenAdded, this, &ScreenListModel::screensChanged); + connect(app, &QGuiApplication::screenRemoved, this, &ScreenListModel::screensChanged); + connect(app, &QGuiApplication::primaryScreenChanged, this, &ScreenListModel::screensChanged); +} + +int ScreenListModel::rowCount(const QModelIndex &) const +{ + return QGuiApplication::screens().size(); +} + +QVariant ScreenListModel::data(const QModelIndex &index, int role) const +{ + const auto screenList = QGuiApplication::screens(); + Q_ASSERT(index.isValid()); + Q_ASSERT(index.row() <= screenList.size()); + + if (role == Qt::DisplayRole) { + auto *screen = screenList.at(index.row()); + QString description; + QTextStream str(&description); + str << '"' << screen->name() << "\" " << screen->size().width() << 'x' + << screen->size().height() << ", " << screen->logicalDotsPerInch() << "DPI"; + return description; + } + + return {}; +} + +QScreen *ScreenListModel::screen(const QModelIndex &index) const +{ + return QGuiApplication::screens().value(index.row()); +} + +void ScreenListModel::screensChanged() +{ + beginResetModel(); + endResetModel(); +} + +#include "moc_screenlistmodel.cpp" diff --git a/examples/multimedia/screencapture/screenlistmodel.h b/examples/multimedia/screencapture/screenlistmodel.h new file mode 100644 index 0000000..3bfa30b --- /dev/null +++ b/examples/multimedia/screencapture/screenlistmodel.h @@ -0,0 +1,30 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef SCREENLISTMODEL_H +#define SCREENLISTMODEL_H + +#include + +QT_BEGIN_NAMESPACE +class QScreen; +QT_END_NAMESPACE + +QT_USE_NAMESPACE + +class ScreenListModel : public QAbstractListModel +{ + Q_OBJECT + +public: + explicit ScreenListModel(QObject *parent = nullptr); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + QScreen *screen(const QModelIndex &index) const; + +private Q_SLOTS: + void screensChanged(); +}; + +#endif // SCREENLISTMODEL_H diff --git a/examples/multimedia/screencapture/windowlistmodel.cpp b/examples/multimedia/screencapture/windowlistmodel.cpp new file mode 100644 index 0000000..45b8cea --- /dev/null +++ b/examples/multimedia/screencapture/windowlistmodel.cpp @@ -0,0 +1,42 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "windowlistmodel.h" +#include + +WindowListModel::WindowListModel(QObject *parent) + : QAbstractListModel(parent), windowList(QWindowCapture::capturableWindows()) +{ +} + +int WindowListModel::rowCount(const QModelIndex &) const +{ + return windowList.size(); +} + +QVariant WindowListModel::data(const QModelIndex &index, int role) const +{ + Q_ASSERT(index.isValid()); + Q_ASSERT(index.row() <= windowList.size()); + + if (role == Qt::DisplayRole) { + auto window = windowList.at(index.row()); + return window.description(); + } + + return {}; +} + +QCapturableWindow WindowListModel::window(const QModelIndex &index) const +{ + return windowList.at(index.row()); +} + +void WindowListModel::populate() +{ + beginResetModel(); + windowList = QWindowCapture::capturableWindows(); + endResetModel(); +} + +#include "moc_windowlistmodel.cpp" diff --git a/examples/multimedia/screencapture/windowlistmodel.h b/examples/multimedia/screencapture/windowlistmodel.h new file mode 100644 index 0000000..caccbb0 --- /dev/null +++ b/examples/multimedia/screencapture/windowlistmodel.h @@ -0,0 +1,31 @@ +// Copyright (C) 2022 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef WINDOWLISTMODEL_H +#define WINDOWLISTMODEL_H + +#include +#include + +QT_USE_NAMESPACE + +class WindowListModel : public QAbstractListModel +{ + Q_OBJECT + +public: + explicit WindowListModel(QObject *parent = nullptr); + + int rowCount(const QModelIndex &parent = QModelIndex()) const override; + QVariant data(const QModelIndex &index, int role = Qt::DisplayRole) const override; + + QCapturableWindow window(const QModelIndex &index) const; + +public Q_SLOTS: + void populate(); + +private: + QList windowList; +}; + +#endif // WINDOWLISTMODEL_H diff --git a/examples/multimedia/shared/shared.pri b/examples/multimedia/shared/shared.pri new file mode 100644 index 0000000..1623901 --- /dev/null +++ b/examples/multimedia/shared/shared.pri @@ -0,0 +1,92 @@ +ios { + PRODUCT_NAME = $$TARGET + macx-xcode: PRODUCT_NAME = $${LITERAL_DOLLAR}{PRODUCT_NAME} + INFOPLIST = \ + "" \ + "" \ + "" \ + "" \ + " CFBundleIconFile" \ + " " \ + " CFBundlePackageType" \ + " APPL" \ + " CFBundleGetInfoString" \ + " Created by Qt/QMake" \ + " CFBundleSignature" \ + " ????" \ + " CFBundleExecutable" \ + " $$TARGET" \ + " CFBundleIdentifier" \ + " ${PRODUCT_BUNDLE_IDENTIFIER}" \ + " CFBundleDisplayName" \ + " $$PRODUCT_NAME" \ + " CFBundleName" \ + " $$PRODUCT_NAME" \ + " CFBundleShortVersionString" \ + " 1.0" \ + " CFBundleVersion" \ + " 1.0" \ + " LSRequiresIPhoneOS" \ + " " \ + " UILaunchStoryboardName" \ + " LaunchScreen" \ + " UISupportedInterfaceOrientations" \ + " " \ + " UIInterfaceOrientationPortrait" \ + " UIInterfaceOrientationPortraitUpsideDown" \ + " UIInterfaceOrientationLandscapeLeft" \ + " UIInterfaceOrientationLandscapeRight" \ + " " \ + " NSCameraUsageDescription" \ + " Qt Multimedia Example" \ + " NSMicrophoneUsageDescription" \ + " Qt Multimedia Example" \ + " NOTE" \ + " This file was generated by Qt/QMake." \ + "" \ + "" + write_file($$OUT_PWD/Info.plist, INFOPLIST)|error() + QMAKE_INFO_PLIST = $$OUT_PWD/Info.plist +} + +macos { + PRODUCT_NAME = $$TARGET + macx-xcode: PRODUCT_NAME = $${LITERAL_DOLLAR}{PRODUCT_NAME} + INFOPLIST = \ + "" \ + "" \ + "" \ + "" \ + " CFBundleIconFile" \ + " " \ + " CFBundlePackageType" \ + " APPL" \ + " CFBundleGetInfoString" \ + " Created by Qt/QMake" \ + " CFBundleSignature" \ + " ????" \ + " CFBundleExecutable" \ + " $$TARGET" \ + " CFBundleIdentifier" \ + " ${PRODUCT_BUNDLE_IDENTIFIER}" \ + " CFBundleDisplayName" \ + " $$PRODUCT_NAME" \ + " CFBundleName" \ + " $$PRODUCT_NAME" \ + " CFBundleShortVersionString" \ + " 1.0" \ + " CFBundleVersion" \ + " 1.0" \ + " NSPrincipalClass" \ + " NSApplication" \ + " NSCameraUsageDescription" \ + " Qt Multimedia Example" \ + " NSMicrophoneUsageDescription" \ + " Qt Multimedia Example" \ + " NOTE" \ + " This file was generated by Qt/QMake." \ + "" \ + "" + write_file($$OUT_PWD/Info.plist, INFOPLIST)|error() + QMAKE_INFO_PLIST = $$OUT_PWD/Info.plist +} diff --git a/examples/multimedia/video/CMakeLists.txt b/examples/multimedia/video/CMakeLists.txt new file mode 100644 index 0000000..72e5d7e --- /dev/null +++ b/examples/multimedia/video/CMakeLists.txt @@ -0,0 +1,10 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_internal_add_example(qmlvideo) +if(TARGET Qt::QuickControls2) + if(TARGET Qt::Svg) + qt_internal_add_example(mediaplayer) + endif() + qt_internal_add_example(recorder) +endif() diff --git a/examples/multimedia/video/mediaplayer/CMakeLists.txt b/examples/multimedia/video/mediaplayer/CMakeLists.txt new file mode 100644 index 0000000..df8e988 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/CMakeLists.txt @@ -0,0 +1,71 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) + +project(mediaplayer LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/mediaplayer") + +find_package(Qt6 REQUIRED COMPONENTS Multimedia Core Quick QuickControls2 Svg) + +qt_standard_project_setup(REQUIRES 6.8) + +qt_add_executable(mediaplayerexample + main.cpp +) + +qt_add_ios_ffmpeg_libraries(mediaplayerexample) + +set_target_properties(mediaplayerexample PROPERTIES + MACOSX_BUNDLE TRUE +) + +qt_add_qml_module(mediaplayerexample + URI mediaplayer + QML_FILES + "Main.qml" + "controls/PlaybackControl.qml" + "controls/AudioControl.qml" + "controls/PlaybackSeekControl.qml" + "controls/SettingsPopup.qml" + "controls/UrlPopup.qml" + "controls/MetadataInfo.qml" + "controls/TracksInfo.qml" + RESOURCES + "images/backward10.svg" + "images/mute.svg" + "images/open_new.svg" + "images/pause_symbol.svg" + "images/play_symbol.svg" + "images/forward10.svg" + "images/more.svg" + "images/speaker.svg" + "images/stop_symbol.svg" + "images/volume.svg" + "images/volume_mute.svg" + "images/zoom_maximize.svg" + "images/zoom_minimize.svg" + "images/link.svg" + "images/loop.svg" +) + +target_link_libraries(mediaplayerexample PRIVATE + Qt6::Core + Qt6::Multimedia + Qt6::Svg + Qt6::Quick + Qt6::Multimedia +) + +install(TARGETS mediaplayerexample + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/mediaplayer/Main.qml b/examples/multimedia/video/mediaplayer/Main.qml new file mode 100644 index 0000000..ed27622 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/Main.qml @@ -0,0 +1,178 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Window +import QtQuick.Controls +import QtQuick.Dialogs +import QtMultimedia +import "controls" + +//! [0] +ApplicationWindow { + id: root + title: qsTr("Multimedia Player") + width: 1280 + height: 720 + //! [0] + minimumWidth: 960 + minimumHeight: 540 + visible: true + color: "black" + + property alias source: mediaPlayer.source + property alias playbackRate: mediaPlayer.playbackRate + property bool fullScreen: false + + MessageDialog { + id: mediaError + buttons: MessageDialog.Ok + } + + MouseArea { + // an activity listener to hide the playback contols when idle + id: activityListener + anchors.fill: parent + z: 1 + propagateComposedEvents: true + hoverEnabled: true + + property bool inactiveMouse: false + + Timer { + id: timer + interval: 1500 // milliseconds + onTriggered: activityListener.inactiveMouse = true + } + + function activityHandler(mouse) { + if (activityListener.inactiveMouse) + activityListener.inactiveMouse = false + timer.restart() + timer.start() + mouse.accepted = false + } + + onPositionChanged: mouse => activityHandler(mouse) + onPressed: mouse => activityHandler(mouse) + onDoubleClicked: mouse => mouse.accepted = false + } + + MetadataInfo { + id: metadataInfo + } + + TracksInfo { + id: audioTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeAudioTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + TracksInfo { + id: videoTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeVideoTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + TracksInfo { + id: subtitleTracksInfo + onSelectedTrackChanged: { + mediaPlayer.activeSubtitleTrack = selectedTrack + mediaPlayer.updateMetadata() + } + } + + //! [1] + MediaPlayer { + id: mediaPlayer + //! [1] + function updateMetadata() { + metadataInfo.clear() + metadataInfo.read(mediaPlayer.metaData) + metadataInfo.read(mediaPlayer.audioTracks[mediaPlayer.activeAudioTrack]) + metadataInfo.read(mediaPlayer.videoTracks[mediaPlayer.activeVideoTrack]) + metadataInfo.read(mediaPlayer.subtitleTracks[mediaPlayer.activeSubtitleTrack]) + } + //! [2] + videoOutput: videoOutput + audioOutput: AudioOutput { + id: audio + muted: playbackController.muted + volume: playbackController.volume + } + //! [2] + //! [4] + onErrorOccurred: { + mediaError.text = mediaPlayer.errorString + mediaError.open() + } + //! [4] + onMetaDataChanged: { updateMetadata() } + //! [6] + onTracksChanged: { + audioTracksInfo.read(mediaPlayer.audioTracks) + videoTracksInfo.read(mediaPlayer.videoTracks) + subtitleTracksInfo.read(mediaPlayer.subtitleTracks, 6) /* QMediaMetaData::Language = 6 */ + updateMetadata() + mediaPlayer.play() + } + //! [6] + source: new URL("https://download.qt.io/learning/videos/media-player-example/Qt_LogoMergeEffect.mp4") + } + + //! [3] + VideoOutput { + id: videoOutput + anchors.fill: parent + visible: mediaPlayer.mediaStatus > 0 + + TapHandler { + onDoubleTapped: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + } + //! [3] + + Rectangle { + anchors.fill: parent + visible: mediaPlayer.mediaStatus === 0 + color: "black" + + TapHandler { + onDoubleTapped: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + } + + //! [5] + PlaybackControl { + id: playbackController + //! [5] + + property bool showControls: !activityListener.inactiveMouse || busy + opacity: showControls + // onOpacityChanged can't be used as it is animated and therefore not immediate + onShowControlsChanged: activityListener.cursorShape = showControls ? + Qt.ArrowCursor : Qt.BlankCursor + + anchors.bottom: parent.bottom + anchors.left: parent.left + anchors.right: parent.right + + //! [6] + mediaPlayer: mediaPlayer + audioTracksInfo: audioTracksInfo + videoTracksInfo: videoTracksInfo + subtitleTracksInfo: subtitleTracksInfo + metadataInfo: metadataInfo + } + //! [6] +} diff --git a/examples/multimedia/video/mediaplayer/controls/AudioControl.qml b/examples/multimedia/video/mediaplayer/controls/AudioControl.qml new file mode 100644 index 0000000..81ebe7f --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/AudioControl.qml @@ -0,0 +1,50 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts + +Item { + id: audioController + + property alias busy: slider.pressed + //! [0] + property alias muted: muteButton.checked + property real volume: slider.value + //! [0] + property alias showSlider: slider.visible + property int iconDimension: 24 + + implicitHeight: 46 + implicitWidth: mainLayout.width + + RowLayout { + id: mainLayout + spacing: 10 + anchors.verticalCenter: parent.verticalCenter + + RoundButton { + id: muteButton + implicitHeight: 40 + implicitWidth: 40 + radius: 4 + icon.source: audioController.muted ? "../images/volume_mute.svg" : "../images/volume.svg" + icon.width: audioController.iconDimension + icon.height: audioController.iconDimension + flat: true + checkable: true + } + + Slider { + id: slider + visible: !audioController.showSlider + implicitWidth: 136 + Layout.fillWidth: true + Layout.alignment: Qt.AlignVCenter + + enabled: !audioController.muted + value: 1 + } + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml b/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml new file mode 100644 index 0000000..3e68faa --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/MetadataInfo.qml @@ -0,0 +1,30 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias metadata: listModel + property alias count: listModel.count + + function clear() { + listModel.clear() + } + + //! [0] + function read(metadata) { + if (!metadata) + return + for (const key of metadata.keys()) + if (metadata.stringValue(key)) + listModel.append({ + name: metadata.metaDataKeyToString(key), + value: metadata.stringValue(key) + }) + } + + ListModel { + id: listModel + } + //! [0] +} diff --git a/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml b/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml new file mode 100644 index 0000000..9cddb1a --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/PlaybackControl.qml @@ -0,0 +1,317 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia +import QtQuick.Dialogs + +//! [0] +Item { + id: playbackController + + required property MediaPlayer mediaPlayer + required property MetadataInfo metadataInfo + required property TracksInfo audioTracksInfo + required property TracksInfo videoTracksInfo + required property TracksInfo subtitleTracksInfo + //! [0] + + property alias muted: audioControl.muted + property alias volume: audioControl.volume + + property bool landscapePlaybackControls: root.width >= 668 + property bool busy: fileDialog.visible + || urlPopup.visible + || settingsPopup.visible + || audioControl.busy + || playbackSeekControl.busy + + implicitHeight: landscapePlaybackControls ? 168 : 208 + + Behavior on opacity { NumberAnimation { duration: 300 } } + + FileDialog { + id: fileDialog + title: "Please choose a file" + onAccepted: { + playbackController.mediaPlayer.stop() + playbackController.mediaPlayer.source = fileDialog.selectedFile + playbackController.mediaPlayer.play() + } + } + + UrlPopup { + id: urlPopup + anchors.centerIn: Overlay.overlay + mediaPlayer: playbackController.mediaPlayer + } + + SettingsPopup { + id: settingsPopup + anchors.centerIn: Overlay.overlay + + metadataInfo: playbackController.metadataInfo + mediaPlayer: playbackController.mediaPlayer + audioTracksInfo: playbackController.audioTracksInfo + videoTracksInfo: playbackController.videoTracksInfo + subtitleTracksInfo: playbackController.subtitleTracksInfo + } + + component CustomButton: RoundButton { + implicitWidth: 40 + implicitHeight: 40 + radius: 4 + icon.width: 24 + icon.height: 24 + flat: true + } + + component CustomRoundButton: RoundButton { + property int diameter: 40 + Layout.preferredWidth: diameter + Layout.preferredHeight: diameter + radius: diameter / 2 + icon.width: 24 + icon.height: 24 + } + + //! [1] + CustomButton { + id: fileDialogButton + icon.source: "../images/open_new.svg" + flat: false + onClicked: fileDialog.open() + } + + CustomButton { + id: openUrlButton + icon.source: "../images/link.svg" + flat: false + onClicked: urlPopup.open() + } + //! [1] + + CustomButton { + id: loopButton + icon.source: "../images/loop.svg" + icon.color: playbackController.mediaPlayer.loops === MediaPlayer.Once ? palette.buttonText : palette.accent + onClicked: playbackController.mediaPlayer.loops = playbackController.mediaPlayer.loops === MediaPlayer.Once + ? MediaPlayer.Infinite + : MediaPlayer.Once + } + + CustomButton { + id: settingsButton + icon.source: "../images/more.svg" + onClicked: settingsPopup.open() + } + + CustomButton { + id: fullScreenButton + icon.source: root.fullScreen ? "../images/zoom_minimize.svg" + : "../images/zoom_maximize.svg" + onClicked: { + root.fullScreen ? root.showNormal() : root.showFullScreen() + root.fullScreen = !root.fullScreen + } + } + + RowLayout { + id: controlButtons + spacing: 16 + + CustomRoundButton { + id: backward10Button + icon.source: "../images/backward10.svg" + onClicked: { + const pos = Math.max(0, playbackController.mediaPlayer.position - 10000) + playbackController.mediaPlayer.setPosition(pos) + } + } + + //! [2] + CustomRoundButton { + id: playButton + visible: playbackController.mediaPlayer.playbackState !== MediaPlayer.PlayingState + icon.source: "../images/play_symbol.svg" + onClicked: playbackController.mediaPlayer.play() + } + + CustomRoundButton { + id: pauseButton + visible: playbackController.mediaPlayer.playbackState === MediaPlayer.PlayingState + icon.source: "../images/pause_symbol.svg" + onClicked: playbackController.mediaPlayer.pause() + } + //! [2] + + //! [3] + CustomRoundButton { + id: forward10Button + icon.source: "../images/forward10.svg" + onClicked: { + const pos = Math.min(playbackController.mediaPlayer.duration, + playbackController.mediaPlayer.position + 10000) + playbackController.mediaPlayer.setPosition(pos) + } + } + //! [3] + } // RowLayout controlButtons + + AudioControl { + id: audioControl + showSlider: root.width >= 960 + } + + PlaybackSeekControl { + id: playbackSeekControl + Layout.fillWidth: true + mediaPlayer: playbackController.mediaPlayer + } + + Frame { + id: landscapeLayout + anchors.fill: parent + padding: 32 + topPadding: 28 + visible: landscapePlaybackControls + background: Rectangle { + color: "#F6F6F6" + } + + ColumnLayout { + anchors.fill: parent + spacing: 16 + + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + id: fdbProxy + target: fileDialogButton + anchors.left: parent.left + } + + LayoutItemProxy { + target: openUrlButton + anchors.left: fdbProxy.right + anchors.leftMargin: 12 + } + + LayoutItemProxy { + target: controlButtons + anchors.horizontalCenter: parent.horizontalCenter + } + + LayoutItemProxy { + target: loopButton + anchors.right: acProxy.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: acProxy + target: audioControl + anchors.right: sbProxy.left + anchors.rightMargin: 30 + anchors.verticalCenter: parent.verticalCenter + } + + LayoutItemProxy { + id: sbProxy + target: settingsButton + anchors.right: fbProxy.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: fbProxy + target: fullScreenButton + anchors.right: parent.right + } + } // Item + + LayoutItemProxy { + target: playbackSeekControl + Layout.topMargin: 16 + Layout.bottomMargin: 16 + } + } + } // Frame frame + + Frame { + id: portraitLayout + anchors.fill: parent + padding: 32 + topPadding: 28 + visible: !landscapePlaybackControls + background: Rectangle { + color: "#F6F6F6" + } + + ColumnLayout { + anchors.fill: parent + spacing: 16 + + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + target: loopButton + anchors.right: cbProxy.left + anchors.rightMargin: 16 + } + + LayoutItemProxy { + id: cbProxy + target: controlButtons + anchors.horizontalCenter: parent.horizontalCenter + } + + LayoutItemProxy { + target: audioControl + anchors.left: cbProxy.right + anchors.leftMargin: 16 + } + } + Item { + Layout.fillWidth: true + implicitHeight: 40 + + LayoutItemProxy { + id: fdbProxy_ + target: fileDialogButton + anchors.left: parent.left + } + + LayoutItemProxy { + target: openUrlButton + anchors.left: fdbProxy_.right + anchors.leftMargin: 12 + } + + LayoutItemProxy { + target: settingsButton + anchors.right: fbProxy_.left + anchors.rightMargin: 12 + } + + LayoutItemProxy { + id: fbProxy_ + target: fullScreenButton + anchors.right: parent.right + } + } + + LayoutItemProxy { + target: playbackSeekControl + Layout.topMargin: 8 + Layout.bottomMargin: 8 + } + } + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml b/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml new file mode 100644 index 0000000..c94d844 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/PlaybackSeekControl.qml @@ -0,0 +1,56 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Item { + id: seekController + required property MediaPlayer mediaPlayer + property alias busy: slider.pressed + + implicitHeight: 20 + + function formatToMinutes(milliseconds) { + const min = Math.floor(milliseconds / 60000) + const sec = ((milliseconds - min * 60000) / 1000).toFixed(1) + return `${min}:${sec.padStart(4, 0)}` + } + + RowLayout { + anchors.fill: parent + spacing: 22 + + //! [0] + Text { + id: currentTime + Layout.preferredWidth: 45 + text: seekController.formatToMinutes(seekController.mediaPlayer.position) + horizontalAlignment: Text.AlignLeft + font.pixelSize: 11 + } + //! [0] + + Slider { + id: slider + Layout.fillWidth: true + //! [2] + enabled: seekController.mediaPlayer.seekable + value: seekController.mediaPlayer.position / seekController.mediaPlayer.duration + //! [2] + onMoved: seekController.mediaPlayer.setPosition(value * seekController.mediaPlayer.duration) + } + + //! [1] + Text { + id: remainingTime + Layout.preferredWidth: 45 + text: seekController.formatToMinutes(seekController.mediaPlayer.duration - seekController.mediaPlayer.position) + horizontalAlignment: Text.AlignRight + font.pixelSize: 11 + } + //! [1] + } +} diff --git a/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml b/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml new file mode 100644 index 0000000..0f24c85 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/SettingsPopup.qml @@ -0,0 +1,204 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + +Popup { + id: settingsController + focus: true + closePolicy: Popup.CloseOnEscape | Popup.CloseOnPressOutside + + background: Rectangle { + color: "#F6F6F6" + } + + + required property MetadataInfo metadataInfo + required property MediaPlayer mediaPlayer + required property TracksInfo audioTracksInfo + required property TracksInfo videoTracksInfo + required property TracksInfo subtitleTracksInfo + + property int vPadding: 20 + property int hPadding: 26 + property bool landscapeSettingsPopup: root.width >= settingsLayout.width + metadataLayout.width + 2 * hPadding + 20 + 24 + + padding: { + top: vPadding + bottom: vPadding + left: hPadding + right: hPadding + } + + Flickable { + id: flickable + implicitWidth: mainLayout.width + implicitHeight: landscapeSettingsPopup ? 200 : 340 + contentWidth: mainLayout.width + contentHeight: mainLayout.height + flickableDirection: Flickable.VerticalFlick + clip: true + + GridLayout { + id: mainLayout + + columns: landscapeSettingsPopup ? 2 : 1 + columnSpacing: 24 + rowSpacing: 24 + + ColumnLayout { + id: settingsLayout + spacing: 16 + Layout.alignment: Qt.AlignTop + + Label { + id: settingsLabel + text: qsTr("Settings") + font.pixelSize: 16 + font.bold: true + } + + GridLayout { + id: gridLayout + columns: 2 + rowSpacing: 16 + columnSpacing: 16 + + component CustomComboBox: ComboBox { + required property TracksInfo tracksInfo + + model: tracksInfo.model + enabled: model.count > 0 + textRole: "data" + currentIndex: model.count > 0 ? 0 : -1 + + onActivated: { + //! [1] + settingsController.mediaPlayer.pause() + tracksInfo.selectedTrack = currentIndex + settingsController.mediaPlayer.play() + //! [1] + } + } + + Label { + text: qsTr("Playback Speed") + Layout.fillWidth: true + font.pixelSize: 14 + } + + ComboBox { + id: rateCb + model: ["0.25", "0.5", "0.75", "Normal", "1.25", "1.5", "1.75", "2"] + currentIndex: 3 + + onCurrentIndexChanged: { + //! [0] + settingsController.mediaPlayer.playbackRate = (currentIndex + 1) * 0.25 + //! [0] + } + } + + Label { + text: qsTr("Audio Tracks") + enabled: audioCb.enabled + Layout.fillWidth: true + font.pixelSize: 14 + } + + CustomComboBox { + id: audioCb + tracksInfo: settingsController.audioTracksInfo + + } + + Label { + text: qsTr("Video Tracks") + enabled: videoCb.enabled + Layout.fillWidth: true + font.pixelSize: 14 + } + + CustomComboBox { + id: videoCb + tracksInfo: settingsController.videoTracksInfo + } + + Label { + text: qsTr("Subtitle Tracks") + enabled: subtitlesCb.enabled + font.pixelSize: 14 + } + + CustomComboBox { + id: subtitlesCb + tracksInfo: settingsController.subtitleTracksInfo + } + } + } + + ColumnLayout { + id: metadataLayout + spacing: 16 + Layout.alignment: Qt.AlignTop + + Label { + id: metadataLabel + text: qsTr("Metadata") + font.pixelSize: 16 + font.bold: true + } + + Rectangle { + id: metadataRect + implicitWidth: 240 + implicitHeight: metadataList.height + border.color: "#8E8E93" + radius: 6 + + Column { + id: metadataList + visible: settingsController.metadataInfo.count > 0 + + padding: 10 + Repeater { + Row { + spacing: metadataList.padding + Text { + text: model.name + font.bold: true + width: (metadataRect.width - 3 * metadataList.padding) / 2 + horizontalAlignment: Text.AlignRight + wrapMode: Text.WordWrap + font.pixelSize: 12 + } + + Text { + text: model.value + width: (metadataRect.width - 3 * metadataList.padding) / 2 + horizontalAlignment: Text.AlignLeft + anchors.verticalCenter: parent.verticalCenter + wrapMode: Text.WrapAnywhere + font.pixelSize: 12 + } + } + model: settingsController.metadataInfo.metadata + } + } + + Text { + id: metadataNoList + visible: settingsController.metadataInfo.count === 0 + anchors.centerIn: parent + text: qsTr("No metadata present") + font.pixelSize: 14 + } + } + } + } + } + +} diff --git a/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml b/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml new file mode 100644 index 0000000..a2ae96f --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/TracksInfo.qml @@ -0,0 +1,25 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + property alias model: model + property int selectedTrack: 0 + + function read(tracks, key = 0) { + // language is the 6th index in the enum QMediaMetaData::Key + model.clear() + + if (!tracks) + return + + tracks.forEach((metadata, index) => { + const data = metadata.stringValue(key) + const label = data ? data : qsTr("track ") + (index + 1) + model.append({data: label, index: index}) + }) + } + + ListModel { id: model } +} diff --git a/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml b/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml new file mode 100644 index 0000000..5bc3041 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/controls/UrlPopup.qml @@ -0,0 +1,54 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + + +Popup { + id: popupController + width: Math.min(500, root.width - 40) + + required property MediaPlayer mediaPlayer + + function loadUrl(url) { + popupController.mediaPlayer.stop() + popupController.mediaPlayer.source = url + popupController.mediaPlayer.play() + } + + RowLayout { + id: rowOpenUrl + anchors.fill: parent + Label { + text: qsTr("URL:"); + } + + TextField { + id: urlText + Layout.fillWidth: true + focus: true + + placeholderText: qsTr("Enter text here...") + wrapMode: TextInput.WrapAnywhere + + Keys.onReturnPressed: { + popupController.loadUrl(text) + urlText.text = "" + popupController.close() + } + } + + Button { + text: qsTr("Load") + enabled: urlText.text !== "" + onClicked: { + popupController.loadUrl(urlText.text) + urlText.text = "" + popupController.close() + } + } + } + onOpened: { popupController.forceActiveFocus() } +} diff --git a/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png b/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player-settings.png new file mode 100644 index 0000000000000000000000000000000000000000..cd0c4f805a0a38e08a41c43ab2a8110ce0ae637e GIT binary patch literal 33956 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�vZA7VXktO~|$1c1m z(a$m7$&JW&W$c+84KVY$0YG<^PI7kj?QZIC#cksdZE6Due zgPcYSXcfE<1lRYcs|Q#%6qoWVAT#c9Td&Qt$!TlH2vg%IeS788N*1g*9{6-e5PY`%PP|TJlTDAu+tGOH<8*gc{7V zW(iz1lMT6Rg>|Qs@53PQ(8bD4A*kPjZy6JoYz=Z&<8qrAq7(6}}tyQzghldA!$)YlXo^O4wv$*^Fcxv4D-oqB8 zNHs?A-J1v)Kbs}u5k3RzwAbl3exk;#ldc_%jStU=3>Al^MD@PN&$|&DYi6cew`*ga zW~rS&Ob1U~*r#UL*j+9nv!^j}JL3I$lksuqKwdusnMhoPr|(iy0_y}qru@ryDfY|m zZ$#y^x`*4*q*go}|6aFMI)DZ9zZ$n20P5;lhhEjm2R4;6$5#9=9r1ZfGJs4W0eqnU zRj&G5SpkU84<))2RyM${Qi^|sgP=54BoXCWzmaWTG)_EA#U00V#BVFQ`Y_FZW)b8qmRe( z_4DP{Ek#u+wcU-kkdHnjkDse|GR^W?JUdpq5t3_QXDrb`nIO;#-9 z;Hl&Q)C2GapQtX&>pL4o`Wd1d4{-_6O+EE`>2L1aPclsw&>97HOOK`ucex-0-i!B+7s=0P0hQy2*O|9_>Zmtbnkz31$1)zx^yiP>U(3)gIp}< zDBB-@A&1>;wIBWH4oqK*b&G*bx2)*XBZ&H8z<&bw>?;7IB6))l!%V$z2uInBX7n!xVVu?d2%PL3}PKm0D>e%+HR_Cqm#z_M=)gd^V3R)D!!Gh~k+@rfO(w=8PWk}iM&Fghtw)%s z4s$hRQ%Sv>km>J6d^c?6_ozH7teyUe@Y%#bgS3B6R%d`mS|W zrB|1Qpe;)`=+@@$?tM{}z)?iHjiIG<;jJE5CE>3C(LV8H8q*b%hAJMTfqG-W!;*=~j26=wTylHIcr^CK%w%G%f zWKLLd-N?{bz6( znaJa>P`hHVztGCptflcAC%5pNZ@fFX;pIPPRZxaaeZ;Y;#ExbDBvyeqw7b;+*qliN zigtRkB(V!{dnc2I(rkU;d@e5};Wf(cje#@ScqnuJHK_k{gR_sns8`XNxhmh}_nbZq zSwbG`<+Dfg#K`iLs8IL;@sVLU{(%aRy~i4u|3iZ0LEtEntv-u_DaS`xbkzMh+gEwx zFpRfsp8u9#Q^AQfBc7=Jb(}K)b=Bdvy1A{nVDJPrzN~HR8W6bt`7WF^AVrcNJx~Y& zS!Z&L?*J|DQ@%IX9y0o|-&&tG*5dv4os$!gfk~{{=_lm0$w6;~!f8>Ek`5M%!y2>Kfqon51+$^b{e50+3v0 zJM9pPC`?Glr@RS(@2{14@N>+ZjbHy&7g_me8{g8D z_ZX_<{D`I=9I(NQO-vrN>+}Kxf$$l)RTPVeO#{DX3cW2ZtIHx2>M}4RPDX4ByvA&7 zh`OzLVfC*M9FOOrD_JBQ6Zj_quL!1#yvYYtb|aW)cx_&m8jPDc#w!mG58o>FHElXc zIfI{3rCIrb;LZD41!=)rL*Y--G}ghISg1J4-|PIT>2#&Y(`1mtOIG^7LE+*4FA1|s zO-`{YF+L_M*}+uX-9#;1&@mx;5yde7^?ys4o}3=@|0`|h(KpNbpwlM!wupXGQfleM z(-{6k%YW|>@b?4y?*Zf=uk)FB`|mvj+L+?nmfM&FZFy#A1pj^1gZl2Akdcm#F2fCD z_GTz0Cvj}*w`@)h;>tNPFs;gFlCrEWC&I`7P{Y^ocuNgUVwmSc2_wGVeeOFxyMt}0 zuai*&l9H2*$EwpG-E=9hDrNC+U6beEln{~qQYNJ9`+opwLyo@y literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png b/examples/multimedia/video/mediaplayer/doc/images/qtmultimedia-examples-qml-media-player.png new file mode 100644 index 0000000000000000000000000000000000000000..857e70abdd1e99d61926ed1ac46a4c2492ffb82b GIT binary patch literal 49506 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%0A9ig}iCB3D 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 V$X1^B9pK-gD5ol0E^QX{zX0PpC3pY; literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc b/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc new file mode 100644 index 0000000..5082f5d --- /dev/null +++ b/examples/multimedia/video/mediaplayer/doc/src/mediaplayer.qdoc @@ -0,0 +1,151 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example video/mediaplayer + \title QML Media Player Example + \ingroup multimedia_examples + \ingroup video_examples_qml + \examplecategory {Multimedia} + \brief Playing audio and video using the QML \c MediaPlayer type. + \meta {tag} {quick} + \meta {tag} {player} + \image qtmultimedia-examples-qml-media-player.png + + This example demonstrates a simple multimedia player that can play + audio and video files using various codecs. + + \include examples-run.qdocinc + + \section1 Instantiating the MediaPlayer + The entry point for the QML code in this example is \c Main.qml. Here + an \c ApplicationWindow is created and properties such as the \c id, \c title, + \c width and \c height are set. + + \snippet video/mediaplayer/Main.qml 0 + + Next the \c MediaPlayer is created and the two properties that are responsible for the video and + audio output are defined. + Firstly, \c videoOutput which renders the video viewfinder and secondly \c audioOutput which provides + the audio output for the player. + + \snippet video/mediaplayer/Main.qml 1 + \dots + \snippet video/mediaplayer/Main.qml 2 + \dots + \snippet video/mediaplayer/Main.qml 3 + + The \c visible property of the \c VideoOutput type is set to \c true when the \c mediaStatus + property of the \c MediaPlayer is greater than 0. \c mediaStatus is of enumeration type + and is equal to 0 when \e {No media has been set}, and greater than 0 otherwise. Therefore, + the \c VideoOutput is visible when media has been set. + + The \c MediaPlayer type has a signal property called \c onErrorOccurred that can be + overridden specifically to handle errors. In this case the signal opens a \c MessageDialog using + the method \c {open()} and sets its \c text property to a \c MediaPlayer property called + \c errorString. + + \snippet video/mediaplayer/Main.qml 4 + + \section1 Playback Controls + + In order to have a useable media player, there needs to be an interface to control the playback. + This is created in its own component file, \c PlaybackControl.qml, and instantiated in + \c Main.qml. + + \snippet video/mediaplayer/Main.qml 5 + \dots + \snippet video/mediaplayer/Main.qml 6 + + When created, objects are forwarded to this type such as track information, + metadata information and the \c MediaPlayer object itself. In \c PlaybackControl.qml, + each one of these objects have a \c {required property}, meaning that these properties must + be set when the \c PlaybackControl object is created. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 0 + + These playback controls can be broken down into sections. In the top left of the panel lies + a collection of buttons used to open a file, either by selecting a file from a file explorer or + entering a URL. The file is loaded into the \c MediaPlayer by setting the \c source property. + Both buttons are instantiated using a \c CustomButton \c {custom component}. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 1 + + Three buttons are created and centered on this panel, handling play, pause and seeking ten + seconds backwards or forwards. The media is played and paused using the methods \c {play()} + and \c {pause()}, respectively. To know when to draw a play or pause button, the \c playbackState + property is queried. For example, when it is equal to the enum value \c MediaPlayer.PlayingState + then the pause button is drawn. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 2 + + To navigate ten seconds forward or backwards, the \c position of the \c MediaPlayer type is + incremented by 10,000 milliseconds and set using the method \c {setPosition()}. + + \snippet video/mediaplayer/controls/PlaybackControl.qml 3 + + \section1 Playback Seeking and Audio + + In \c {PlaybackControl.qml}, an \c AudioControl and a \c PlaybackSeekControl type are instantiated. + These are both defined in their own component file and are responsible for volume control and + playback seeking, respectively. The \c AudioControl type defines a button to mute and a \c Slider, + from \c {QtQuick Controls}, to set the volume of the player. Both of these attributes are exposed by + defining a \c mute and \c volume property and are accessed from the \c AudioOutput definition in + \c {Main.qml}. + + \snippet video/mediaplayer/controls/AudioControl.qml 0 + + The \c PlaybackSeekControl uses a \c RowLayout containing a \c Slider with a \c Text item either side. + The two \c Text items display the current time and the remaining time of the media being played. These + are both calculated using two properties of the \c MediaPlayer type, \c {position}, which gives the + current playback position in milliseconds, and \c {duration}, which gives the duration of the media + in milliseconds. + + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 0 + \dots + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 1 + + The \c Slider is only enabled when the media player is seekable and not, for example, live media. + The \c MediaPlayer type has a property for this called \c seekable. The \c value of the \c Slider + is calculated using the \c position and \c duration properties of the \c MediaPlayer. + + \snippet video/mediaplayer/controls/PlaybackSeekControl.qml 2 + + \section1 Metadata and Track Information + + The \c PlaybackControl type instantiates a \c SettingsPopup, which contains information about the + metadata of the currently loaded media and track selection, as well as the ability to update the + playback rate. This \c Popup is defined in \c SettingsPopup.qml. + + \image qtmultimedia-examples-qml-media-player-settings.png + + The metadata is contained in its own component file, \c MetadataInfo.qml. It contains a \c ListModel, + a function to clear it, \c {clear()}, and a function to populate it, \c {read(MediaMetadata metadata)}. + The \c {read(MediaMetadata metadata)} function takes as a parameter an object of type \c MediaMetaData, + and navigates its key-value structure to extract its data into the \c model of the \c {ListView}. The + methods used to do this are \c {keys()}, which returns all the keys of the \c MediaMetaData, and + {stringValue(Key key)}, which returns the \c value for a given \c key. + + \snippet video/mediaplayer/controls/MetadataInfo.qml 0 + + The data is then displayed in \c {SettingsPopup.qml} in a \c ListView type. The \c delegate of this + \c ListView is a row of two \c Text items, corresponding to the key-value pairs abstracted from the + \c MediaMetaData item. + + On the other side of the \c Popup there is playback rate controls and track selection for audio, video and + subtitles. The playback rate is chosen from a \c ComboBox and set using the property \c playbackRate. + + \snippet video/mediaplayer/controls/SettingsPopup.qml 0 + + The type called \c TracksInfo, defined in \c {TracksInfo.qml}, contains the data about the tracks. + More specifically, a \c ListModel containing the titles of the tracks, or for subtitles specifically, the + langauges. This information is populated in \c Main.qml by calling the \c {read(MediaMetadata mediaMetadata)} + function defined in the \c TracksInfo type. + + \snippet video/mediaplayer/Main.qml 6 + + The \c model defined in \c TracksInfo is then queried in the \c {ComboBox}es in the + \c SettingsPopup to select the current track. + + \snippet video/mediaplayer/controls/SettingsPopup.qml 1 +*/ diff --git a/examples/multimedia/video/mediaplayer/images/backward10.svg b/examples/multimedia/video/mediaplayer/images/backward10.svg new file mode 100644 index 0000000..9166343 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/backward10.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/ff.svg b/examples/multimedia/video/mediaplayer/images/ff.svg new file mode 100644 index 0000000..7c907c4 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/ff.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/forward10.svg b/examples/multimedia/video/mediaplayer/images/forward10.svg new file mode 100644 index 0000000..190a5aa --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/forward10.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/link.svg b/examples/multimedia/video/mediaplayer/images/link.svg new file mode 100644 index 0000000..6ce1b98 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/link.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/loop.svg b/examples/multimedia/video/mediaplayer/images/loop.svg new file mode 100644 index 0000000..8161ca8 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/loop.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/more.svg b/examples/multimedia/video/mediaplayer/images/more.svg new file mode 100644 index 0000000..fa8bdde --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/more.svg @@ -0,0 +1,5 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/mute.svg b/examples/multimedia/video/mediaplayer/images/mute.svg new file mode 100644 index 0000000..b66b6d3 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/mute.svg @@ -0,0 +1,6 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/open_new.svg b/examples/multimedia/video/mediaplayer/images/open_new.svg new file mode 100644 index 0000000..6c62237 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/open_new.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/pause_symbol.svg b/examples/multimedia/video/mediaplayer/images/pause_symbol.svg new file mode 100644 index 0000000..bdf6a90 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/pause_symbol.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/play_symbol.svg b/examples/multimedia/video/mediaplayer/images/play_symbol.svg new file mode 100644 index 0000000..edb5672 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/play_symbol.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/rewind.svg b/examples/multimedia/video/mediaplayer/images/rewind.svg new file mode 100644 index 0000000..e9b3412 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/rewind.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/settings.svg b/examples/multimedia/video/mediaplayer/images/settings.svg new file mode 100644 index 0000000..3a13cca --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/settings.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/speaker.svg b/examples/multimedia/video/mediaplayer/images/speaker.svg new file mode 100644 index 0000000..723e48b --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/speaker.svg @@ -0,0 +1,7 @@ + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/stop_symbol.svg b/examples/multimedia/video/mediaplayer/images/stop_symbol.svg new file mode 100644 index 0000000..99f0016 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/stop_symbol.svg @@ -0,0 +1,3 @@ + + + diff --git a/examples/multimedia/video/mediaplayer/images/url.svg b/examples/multimedia/video/mediaplayer/images/url.svg new file mode 100644 index 0000000..4494291 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/url.svg @@ -0,0 +1,6 @@ + + + + + + diff --git a/examples/multimedia/video/mediaplayer/images/volume.svg b/examples/multimedia/video/mediaplayer/images/volume.svg new file mode 100644 index 0000000..2cdc4df --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/volume.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/volume_mute.svg b/examples/multimedia/video/mediaplayer/images/volume_mute.svg new file mode 100644 index 0000000..635c308 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/volume_mute.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg b/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg new file mode 100644 index 0000000..9c7fb8e --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/zoom_maximize.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg b/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg new file mode 100644 index 0000000..3d6ae65 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/images/zoom_minimize.svg @@ -0,0 +1,4 @@ + + + + diff --git a/examples/multimedia/video/mediaplayer/main.cpp b/examples/multimedia/video/mediaplayer/main.cpp new file mode 100644 index 0000000..3df4d60 --- /dev/null +++ b/examples/multimedia/video/mediaplayer/main.cpp @@ -0,0 +1,38 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + + QCoreApplication::setApplicationName("MediaPlayer Example"); + QCoreApplication::setOrganizationName("QtProject"); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt Quick MediaPlayer Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL(s) to open."); + parser.process(app); + + QQmlApplicationEngine engine; + const QUrl url(QStringLiteral("qrc:/Main.qml")); + + if (!parser.positionalArguments().isEmpty()) { + QUrl source = QUrl::fromUserInput(parser.positionalArguments().at(0), QDir::currentPath()); + QObject::connect(&engine, &QQmlApplicationEngine::objectCreated, + &engine, [source](QObject *object, const QUrl &) { + qDebug() << "setting source"; + object->setProperty("source", source); + }); + } + + engine.loadFromModule("mediaplayer", "Main"); + + return app.exec(); +} diff --git a/examples/multimedia/video/qmlvideo/CMakeLists.txt b/examples/multimedia/video/qmlvideo/CMakeLists.txt new file mode 100644 index 0000000..430f4d1 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/CMakeLists.txt @@ -0,0 +1,71 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(qmlvideoexample LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/qmlvideo") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia Qml Quick) + +qt_standard_project_setup(REQUIRES 6.8) + +qt_add_executable(qmlvideoexample + frequencymonitor.cpp frequencymonitor.h + frequencymonitordeclarative.cpp + performancemonitor.cpp performancemonitor.h + performancemonitordeclarative.cpp performancemonitordeclarative.h + main.cpp + trace.h +) + +qt_add_ios_ffmpeg_libraries(qmlvideoexample) + +set_target_properties(qmlvideoexample PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + MACOSX_BUNDLE_GUI_IDENTIFIER "io.qt.examples.qmlvideo" +) + +target_compile_definitions(qmlvideoexample PUBLIC + FREQUENCYMONITOR_SUPPORT + PERFORMANCEMONITOR_SUPPORT +) + +add_subdirectory(qmlvideo) +add_subdirectory(performancemonitor) +add_subdirectory(frequencymonitor) + +target_link_libraries(qmlvideoexample PRIVATE + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::Qml + Qt::Quick + qmlvideo + performancemonitor + frequencymonitor +) + +install(TARGETS qmlvideoexample + BUNDLE DESTINATION . + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +qt_generate_deploy_qml_app_script( + TARGET qmlvideoexample + OUTPUT_SCRIPT deploy_script + MACOS_BUNDLE_POST_BUILD + NO_UNSUPPORTED_PLATFORM_ERROR + DEPLOY_USER_QML_MODULES_ON_UNSUPPORTED_PLATFORM +) + +install(SCRIPT ${deploy_script}) diff --git a/examples/multimedia/video/qmlvideo/Info.plist.in b/examples/multimedia/video/qmlvideo/Info.plist.in new file mode 100644 index 0000000..85aa9c2 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/Info.plist.in @@ -0,0 +1,48 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSPrincipalClass + NSApplication + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg b/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-menu.jpg new file mode 100644 index 0000000000000000000000000000000000000000..54ab877a1881611b3331868d42864111b4b35087 GIT binary patch literal 21959 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg b/examples/multimedia/video/qmlvideo/doc/images/qmlvideo-overlay.jpg new file mode 100644 index 0000000000000000000000000000000000000000..6a0d48ae640bd2b59a1f28b09e537b145bfe4ea5 GIT binary patch literal 23787 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 +#include +#include +#include +#include + +//#define VERBOSE_TRACE + +inline QDebug qtTrace() +{ + return qDebug() << "[frequencymonitor]"; +} +#ifdef VERBOSE_TRACE +inline QDebug qtVerboseTrace() +{ + return qtTrace(); +} +#else +inline QNoDebug qtVerboseTrace() +{ + return QNoDebug(); +} +#endif + +static const int DefaultSamplingInterval = 100; +static const int DefaultTraceInterval = 0; + +class FrequencyMonitorPrivate : public QObject +{ + Q_OBJECT + +public: + FrequencyMonitorPrivate(FrequencyMonitor *parent); + void calculateInstantaneousFrequency(); + +private slots: + void calculateAverageFrequency(); + void stalled(); + +public: + FrequencyMonitor *const q_ptr; + QString m_label; + bool m_active; + qreal m_instantaneousFrequency; + QElapsedTimer m_instantaneousElapsed; + QTimer *m_averageTimer; + QElapsedTimer m_averageElapsed; + int m_count; + qreal m_averageFrequency; + QTimer *m_traceTimer; + QTimer *m_stalledTimer; +}; + +FrequencyMonitorPrivate::FrequencyMonitorPrivate(FrequencyMonitor *parent) + : QObject(parent), + q_ptr(parent), + m_active(false), + m_instantaneousFrequency(0), + m_averageTimer(new QTimer(this)), + m_count(0), + m_averageFrequency(0), + m_traceTimer(new QTimer(this)), + m_stalledTimer(new QTimer(this)) +{ + m_instantaneousElapsed.start(); + connect(m_averageTimer, &QTimer::timeout, this, + &FrequencyMonitorPrivate::calculateAverageFrequency); + if (DefaultSamplingInterval) + m_averageTimer->start(DefaultSamplingInterval); + m_averageElapsed.start(); + connect(m_traceTimer, &QTimer::timeout, q_ptr, &FrequencyMonitor::trace); + if (DefaultTraceInterval) + m_traceTimer->start(DefaultTraceInterval); + m_stalledTimer->setSingleShot(true); + connect(m_stalledTimer, &QTimer::timeout, this, &FrequencyMonitorPrivate::stalled); +} + +void FrequencyMonitorPrivate::calculateInstantaneousFrequency() +{ + const qint64 ms = m_instantaneousElapsed.restart(); + m_instantaneousFrequency = ms ? qreal(1000) / ms : 0; + m_stalledTimer->start(3 * ms); + if (m_instantaneousFrequency) + q_ptr->setActive(true); + emit q_ptr->instantaneousFrequencyChanged(m_instantaneousFrequency); + emit q_ptr->frequencyChanged(); +} + +void FrequencyMonitorPrivate::calculateAverageFrequency() +{ + const qint64 ms = m_averageElapsed.restart(); + m_averageFrequency = qreal(m_count * 1000) / ms; + emit q_ptr->averageFrequencyChanged(m_averageFrequency); + emit q_ptr->frequencyChanged(); + m_count = 0; +} + +void FrequencyMonitorPrivate::stalled() +{ + if (m_instantaneousFrequency) { + m_instantaneousFrequency = 0; + emit q_ptr->instantaneousFrequencyChanged(m_instantaneousFrequency); + emit q_ptr->frequencyChanged(); + } +} + +FrequencyMonitor::FrequencyMonitor(QObject *parent) : QObject(parent) +{ + d_ptr = new FrequencyMonitorPrivate(this); +} + +FrequencyMonitor::~FrequencyMonitor() = default; + +QString FrequencyMonitor::label() const +{ + return d_func()->m_label; +} + +bool FrequencyMonitor::active() const +{ + return d_func()->m_active; +} + +int FrequencyMonitor::samplingInterval() const +{ + return d_ptr->m_averageTimer->isActive() ? d_ptr->m_averageTimer->interval() : 0; +} + +int FrequencyMonitor::traceInterval() const +{ + return d_ptr->m_traceTimer->isActive() ? d_ptr->m_traceTimer->interval() : 0; +} + +qreal FrequencyMonitor::instantaneousFrequency() const +{ + return d_func()->m_instantaneousFrequency; +} + +qreal FrequencyMonitor::averageFrequency() const +{ + return d_func()->m_averageFrequency; +} + +void FrequencyMonitor::notify() +{ + Q_D(FrequencyMonitor); + ++(d->m_count); + d->calculateInstantaneousFrequency(); +} + +void FrequencyMonitor::trace() +{ + Q_D(FrequencyMonitor); + const QString value = QStringLiteral("instant %1 average %2") + .arg(d->m_instantaneousFrequency, 0, 'f', 2) + .arg(d->m_averageFrequency, 0, 'f', 2); + if (d->m_label.isEmpty()) + qtTrace() << "FrequencyMonitor::trace" << value; + else + qtTrace() << "FrequencyMonitor::trace" + << "label" << d->m_label << value; +} + +void FrequencyMonitor::setLabel(const QString &value) +{ + Q_D(FrequencyMonitor); + if (d->m_label != value) { + d->m_label = value; + emit labelChanged(d->m_label); + } +} + +void FrequencyMonitor::setActive(bool value) +{ + Q_D(FrequencyMonitor); + if (d->m_active != value) { + d->m_active = value; + emit activeChanged(d->m_active); + } +} + +void FrequencyMonitor::setSamplingInterval(int value) +{ + Q_D(FrequencyMonitor); + if (samplingInterval() != value) { + if (value) { + d->m_averageTimer->setInterval(value); + d->m_averageTimer->start(); + } else { + d->m_averageTimer->stop(); + } + emit samplingIntervalChanged(value); + } +} + +void FrequencyMonitor::setTraceInterval(int value) +{ + Q_D(FrequencyMonitor); + if (traceInterval() != value) { + if (value) { + d->m_traceTimer->setInterval(value); + d->m_traceTimer->start(); + } else { + d->m_traceTimer->stop(); + } + emit traceIntervalChanged(value); + } +} + +#include "frequencymonitor.moc" +#include "moc_frequencymonitor.cpp" diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor.h b/examples/multimedia/video/qmlvideo/frequencymonitor.h new file mode 100644 index 0000000..a1756dc --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor.h @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef FREQUENCYMONITOR_H +#define FREQUENCYMONITOR_H + +#include +#include + +class FrequencyMonitorPrivate; + +/** + * Class for measuring frequency of events + * + * Occurrence of the event is notified by the client via the notify() slot. + * On a regular interval, both an instantaneous and a rolling average + * event frequency are calculated. + */ +class FrequencyMonitor : public QObject +{ + Q_OBJECT + Q_DECLARE_PRIVATE(FrequencyMonitor) + Q_PROPERTY(QString label READ label WRITE setLabel NOTIFY labelChanged) + Q_PROPERTY(bool active READ active WRITE setActive NOTIFY activeChanged) + Q_PROPERTY(int samplingInterval READ samplingInterval WRITE setSamplingInterval NOTIFY + samplingIntervalChanged) + Q_PROPERTY( + int traceInterval READ traceInterval WRITE setTraceInterval NOTIFY traceIntervalChanged) + Q_PROPERTY(qreal instantaneousFrequency READ instantaneousFrequency NOTIFY + instantaneousFrequencyChanged) + Q_PROPERTY(qreal averageFrequency READ averageFrequency NOTIFY averageFrequencyChanged) + +public: + FrequencyMonitor(QObject *parent = nullptr); + ~FrequencyMonitor(); + + static void qmlRegisterType(); + + QString label() const; + bool active() const; + int samplingInterval() const; + int traceInterval() const; + qreal instantaneousFrequency() const; + qreal averageFrequency() const; + +signals: + void labelChanged(const QString &value); + void activeChanged(bool); + void samplingIntervalChanged(int value); + void traceIntervalChanged(int value); + void frequencyChanged(); + void instantaneousFrequencyChanged(qreal value); + void averageFrequencyChanged(qreal value); + +public slots: + Q_INVOKABLE void notify(); + Q_INVOKABLE void trace(); + void setActive(bool value); + void setLabel(const QString &value); + void setSamplingInterval(int value); + void setTraceInterval(int value); + +private: + FrequencyMonitorPrivate *d_ptr; +}; + +#endif // FREQUENCYMONITOR_H diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt b/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt new file mode 100644 index 0000000..4a205fa --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/CMakeLists.txt @@ -0,0 +1,30 @@ +# Copyright (C) 2023 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) + message(FATAL_ERROR "This module is part of the 'qmlvideo' example, and should not be built independently.") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/qmlvideo/frequencymonitor") + +qt_add_qml_module(frequencymonitor + URI frequencymonitor + QML_FILES + "FrequencyItem.qml" +) + +target_link_libraries(frequencymonitor PRIVATE + Qt6::Core + Qt6::Gui + Qt6::Quick +) + +install(TARGETS frequencymonitor + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +install(FILES ${CMAKE_CURRENT_BINARY_DIR}/qmldir + DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml b/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml new file mode 100644 index 0000000..49a7eea --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/FrequencyItem.qml @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import FrequencyMonitor 1.0 + +Rectangle { + id: root + property bool logging: true + property bool displayed: true + property bool enabled: logging || displayed + property alias active: monitor.active + property int samplingInterval: 500 + property color textColor: "yellow" + property int textSize: 20 + property alias label: monitor.label + + border.width: 1 + border.color: "yellow" + width: 5.5 * root.textSize + height: 3.0 * root.textSize + color: "black" + opacity: 0.5 + radius: 10 + visible: displayed && active + + // This should ensure that the monitor is on top of all other content + z: 999 + + function notify() { + monitor.notify() + } + + FrequencyMonitor { + id: monitor + samplingInterval: root.enabled ? root.samplingInterval : 0 + onAverageFrequencyChanged: { + if (root.logging) trace() + averageFrequencyText.text = monitor.averageFrequency.toFixed(2) + } + } + + Text { + id: labelText + anchors { + left: parent.left + top: parent.top + margins: 10 + } + color: root.textColor + font.pixelSize: 0.6 * root.textSize + text: root.label + width: root.width - 2*anchors.margins + elide: Text.ElideRight + } + + Text { + id: averageFrequencyText + anchors { + right: parent.right + bottom: parent.bottom + margins: 10 + } + color: root.textColor + font.pixelSize: root.textSize + } +} diff --git a/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir b/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir new file mode 100644 index 0000000..a935d2c --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitor/qmldir @@ -0,0 +1,3 @@ +module frequencymonitor + +FrequencyItem 1.0 FrequencyItem.qml diff --git a/examples/multimedia/video/qmlvideo/frequencymonitordeclarative.cpp b/examples/multimedia/video/qmlvideo/frequencymonitordeclarative.cpp new file mode 100644 index 0000000..6ed2019 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/frequencymonitordeclarative.cpp @@ -0,0 +1,10 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "frequencymonitor.h" +#include + +void FrequencyMonitor::qmlRegisterType() +{ + ::qmlRegisterType("FrequencyMonitor", 1, 0, "FrequencyMonitor"); +} diff --git a/examples/multimedia/video/qmlvideo/main.cpp b/examples/multimedia/video/qmlvideo/main.cpp new file mode 100644 index 0000000..94c5bfe --- /dev/null +++ b/examples/multimedia/video/qmlvideo/main.cpp @@ -0,0 +1,125 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "performancemonitor.h" +#include "trace.h" +#include "qmlvideo/videosingleton.h" +#ifdef PERFORMANCEMONITOR_SUPPORT +# include "performancemonitordeclarative.h" +#endif + +#include +#include +#include +#include +#include +#include +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +static const QString DefaultFileName1 = ""; +static const QString DefaultFileName2 = ""; + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + +#ifdef PERFORMANCEMONITOR_SUPPORT + PerformanceMonitor::qmlRegisterTypes(); +#endif + + QString source1, source2; + qreal volume = 0.5; + QStringList args = app.arguments(); +#ifdef PERFORMANCEMONITOR_SUPPORT + PerformanceMonitor::State performanceMonitorState; +#endif + bool sourceIsUrl = false; + for (int i = 1; i < args.size(); ++i) { + const QByteArray arg = args.at(i).toUtf8(); + if (arg.startsWith('-')) { + if ("-volume" == arg) { + if (i + 1 < args.count()) + volume = 0.01 * args.at(++i).toInt(); + else + qtTrace() << "Option \"-volume\" takes a value"; + } +#ifdef PERFORMANCEMONITOR_SUPPORT + else if (performanceMonitorState.parseArgument(arg)) { + // Do nothing + } +#endif + else if ("-url" == arg) { + sourceIsUrl = true; + } else { + qtTrace() << "Option" << arg << "ignored"; + } + } else { + if (source1.isEmpty()) + source1 = arg; + else if (source2.isEmpty()) + source2 = arg; + else + qtTrace() << "Argument" << arg << "ignored"; + } + } + + QUrl url1, url2; + if (sourceIsUrl) { + url1 = source1; + url2 = source2; + } else { + if (!source1.isEmpty()) + url1 = QUrl::fromLocalFile(source1); + if (!source2.isEmpty()) + url2 = QUrl::fromLocalFile(source2); + } + + const QStringList moviesLocation = QStandardPaths::standardLocations(QStandardPaths::MoviesLocation); + const QUrl videoPath = QUrl::fromLocalFile(moviesLocation.isEmpty() ? app.applicationDirPath() + : moviesLocation.front()); + + QQuickView viewer; + VideoSingleton* singleton = viewer.engine()->singletonInstance("qmlvideo", "VideoSingleton"); + singleton->setVideoPath(videoPath); + singleton->setSource1(source1); + singleton->setSource2(source2); + singleton->setVolume(volume); + viewer.loadFromModule("qmlvideo", "Main"); + QObject::connect(viewer.engine(), &QQmlEngine::quit, &viewer, &QQuickView::close); + +#ifdef PERFORMANCEMONITOR_SUPPORT + QQuickItem *rootObject = viewer.rootObject(); + if (performanceMonitorState.valid) { + rootObject->setProperty("perfMonitorsLogging", performanceMonitorState.logging); + rootObject->setProperty("perfMonitorsVisible", performanceMonitorState.visible); + } + QObject::connect(&viewer, SIGNAL(afterRendering()), rootObject, SLOT(qmlFramePainted())); +#endif + + QMetaObject::invokeMethod(rootObject, "init"); + + auto setupView = [&viewer]() { + viewer.setMinimumSize(QSize(640, 360)); + viewer.show(); + }; + +#if QT_CONFIG(permissions) + QCameraPermission cameraPermission; + qApp->requestPermission(cameraPermission, [&setupView](const QPermission &permission) { + // Show UI in any case. If there is no permission, the UI will just + // be disabled. + if (permission.status() != Qt::PermissionStatus::Granted) + qWarning("Camera permission is not granted! Camera will not be available."); + setupView(); + }); +#else + setupView(); +#endif + + return app.exec(); +} diff --git a/examples/multimedia/video/qmlvideo/performancemonitor.cpp b/examples/multimedia/video/qmlvideo/performancemonitor.cpp new file mode 100644 index 0000000..26f0fae --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitor.cpp @@ -0,0 +1,31 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "performancemonitor.h" + +namespace PerformanceMonitor { + +bool State::parseArgument(const QByteArray &arg) +{ + bool result = false; + if (arg == "-log-perf") { + logging = true; + valid = true; + result = true; + } else if (arg == "-no-log-perf") { + logging = false; + valid = true; + result = true; + } else if (arg == "-show-perf") { + visible = true; + valid = true; + result = true; + } else if (arg == "-hide-perf") { + visible = false; + valid = true; + result = true; + } + return result; +} + +} // namespace PerformanceMonitor diff --git a/examples/multimedia/video/qmlvideo/performancemonitor.h b/examples/multimedia/video/qmlvideo/performancemonitor.h new file mode 100644 index 0000000..6834686 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitor.h @@ -0,0 +1,33 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PERFORMANCEMONITOR_H +#define PERFORMANCEMONITOR_H + +#include + +namespace PerformanceMonitor { + +struct State +{ + State() : valid(true), logging(false), visible(true) { } + State(bool l, bool v) : valid(true), logging(l), visible(v) { } + bool operator==(const State &other) const + { + return logging == other.logging && visible == other.visible; + } + bool operator!=(const State &other) const + { + return logging != other.logging || visible != other.visible; + } + + bool parseArgument(const QByteArray &arg); + + bool valid; + bool logging; + bool visible; +}; + +} // namespace PerformanceMonitor + +#endif // PERFORMANCEMONITOR_H diff --git a/examples/multimedia/video/qmlvideo/performancemonitor/CMakeLists.txt b/examples/multimedia/video/qmlvideo/performancemonitor/CMakeLists.txt new file mode 100644 index 0000000..beb9e2e --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitor/CMakeLists.txt @@ -0,0 +1,31 @@ +# Copyright (C) 2023 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) + message(FATAL_ERROR "This module is part of the 'qmlvideo' example, and should not be built independently.") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/qmlvideo/performancemonitor") + +qt_add_qml_module(performancemonitor + URI performancemonitor + QML_FILES + "PerformanceItem.qml" +) + +target_link_libraries(performancemonitor PRIVATE + Qt6::Core + Qt6::Gui + Qt6::Quick +) + +install(TARGETS performancemonitor + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +install(FILES ${CMAKE_CURRENT_BINARY_DIR}/qmldir + DESTINATION "${INSTALL_EXAMPLEDIR}" +) + diff --git a/examples/multimedia/video/qmlvideo/performancemonitor/PerformanceItem.qml b/examples/multimedia/video/qmlvideo/performancemonitor/PerformanceItem.qml new file mode 100644 index 0000000..5b501b1 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitor/PerformanceItem.qml @@ -0,0 +1,100 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + id: root + property bool logging: true + property bool displayed: true + property bool videoActive + property int margins: 5 + property bool enabled: true + + color: "transparent" + + // This should ensure that the monitor is on top of all other content + z: 999 + + Column { + id: column + anchors { + fill: root + margins: 10 + } + spacing: 10 + } + + QtObject { + id: d + property Item qmlFrameRateItem: null + property Item videoFrameRateItem: null + } + + Connections { + id: videoFrameRateActiveConnections + ignoreUnknownSignals: true + function onActiveChanged() { root.videoActive = videoFrameRateActiveConnections.target.active } + } + + states: [ + State { + name: "hidden" + PropertyChanges { + root.opacity: 0 + } + } + ] + + transitions: [ + Transition { + from: "*" + to: "*" + NumberAnimation { + properties: "opacity" + easing.type: Easing.OutQuart + duration: 500 + } + } + ] + + state: enabled ? "baseState" : "hidden" + + function createQmlFrameRateItem() { + let component = Qt.createComponent("frequencymonitor", "FrequencyItem") + if (component.status === Component.Ready) + d.qmlFrameRateItem = component.createObject(column, { label: qsTr("QML frame rate"), + displayed: root.displayed, + logging: root.logging + }); + } + + function createVideoFrameRateItem() { + let component = Qt.createComponent("frequencymonitor", "FrequencyItem") + if (component.status === Component.Ready) + d.videoFrameRateItem = component.createObject(column, { label: qsTr("Video frame rate"), + displayed: root.displayed, + logging: root.logging + }); + videoFrameRateActiveConnections.target = d.videoFrameRateItem + } + + + function init() { + createQmlFrameRateItem() + createVideoFrameRateItem() + } + + function videoFramePainted() { + d.videoFrameRateItem?.notify() + } + + function qmlFramePainted() { + d.qmlFrameRateItem?.notify() + } + + onVideoActiveChanged: { + if (d.videoFrameRateItem) + d.videoFrameRateItem.active = root.videoActive + } +} diff --git a/examples/multimedia/video/qmlvideo/performancemonitor/qmldir b/examples/multimedia/video/qmlvideo/performancemonitor/qmldir new file mode 100644 index 0000000..636abaf --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitor/qmldir @@ -0,0 +1,3 @@ +module performancemonitor + +PerformanceItem 1.0 PerformanceItem.qml diff --git a/examples/multimedia/video/qmlvideo/performancemonitordeclarative.cpp b/examples/multimedia/video/qmlvideo/performancemonitordeclarative.cpp new file mode 100644 index 0000000..a2ad1ca --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitordeclarative.cpp @@ -0,0 +1,12 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "frequencymonitor.h" + +namespace PerformanceMonitor { + +void qmlRegisterTypes() +{ + FrequencyMonitor::qmlRegisterType(); +} +} diff --git a/examples/multimedia/video/qmlvideo/performancemonitordeclarative.h b/examples/multimedia/video/qmlvideo/performancemonitordeclarative.h new file mode 100644 index 0000000..4514d50 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/performancemonitordeclarative.h @@ -0,0 +1,11 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef PERFORMANCEMONITORDECLARATIVE_H +#define PERFORMANCEMONITORDECLARATIVE_H + +namespace PerformanceMonitor { +void qmlRegisterTypes(); +} + +#endif // PERFORMANCEMONITORDECLARATIVE_H diff --git a/examples/multimedia/video/qmlvideo/qmlvideo.png b/examples/multimedia/video/qmlvideo/qmlvideo.png new file mode 100644 index 0000000000000000000000000000000000000000..707d5c4e85d82959740b243a8a36d5071c277299 GIT binary patch literal 3400 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 eAW3auXJt}lVPtu6$z?nM0000 + + + + + image/svg+xml + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt b/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt new file mode 100644 index 0000000..84a6571 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CMakeLists.txt @@ -0,0 +1,81 @@ +# Copyright (C) 2023 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +if(CMAKE_SOURCE_DIR STREQUAL CMAKE_CURRENT_SOURCE_DIR) + message(FATAL_ERROR "This module is part of the 'qmlvideo' example, and should not be built independently.") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/qmlvideo/qmlvideo") + +qt_add_qml_module(qmlvideo + URI qmlvideo + SOURCES + videosingleton.cpp + videosingleton.h + qmlvideo_global.h + QML_FILES + "CameraBasic.qml" + "CameraDrag.qml" + "CameraDummy.qml" + "CameraFullScreen.qml" + "CameraFullScreenInverted.qml" + "CameraItem.qml" + "CameraMove.qml" + "CameraOverlay.qml" + "CameraResize.qml" + "CameraRotate.qml" + "CameraSpin.qml" + "Content.qml" + "ErrorDialog.qml" + "Main.qml" + "Scene.qml" + "SceneBasic.qml" + "SceneDrag.qml" + "SceneFullScreen.qml" + "SceneFullScreenInverted.qml" + "SceneMove.qml" + "SceneMulti.qml" + "SceneOverlay.qml" + "SceneResize.qml" + "SceneRotate.qml" + "SceneSelectionPanel.qml" + "SceneSpin.qml" + "SeekControl.qml" + "VideoBasic.qml" + "VideoDrag.qml" + "VideoDummy.qml" + "VideoFillMode.qml" + "VideoFullScreen.qml" + "VideoFullScreenInverted.qml" + "VideoItem.qml" + "VideoMetadata.qml" + "VideoMove.qml" + "VideoOverlay.qml" + "VideoPlaybackRate.qml" + "VideoResize.qml" + "VideoRotate.qml" + "VideoSeek.qml" + "VideoSpin.qml" + RESOURCES + "images/folder.png" + "images/leaves.jpg" + "images/up.png" +) + +target_compile_definitions(qmlvideo PRIVATE QMLVIDEO_LIB) + +target_link_libraries(qmlvideo PRIVATE + Qt6::Core + Qt6::Gui + Qt6::Quick +) + +install(TARGETS qmlvideo + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) + +install(FILES ${CMAKE_CURRENT_BINARY_DIR}/qmldir + DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml new file mode 100644 index 0000000..77072c6 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraBasic.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneBasic { + contentType: "camera" + started: true +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml new file mode 100644 index 0000000..2ea3672 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDrag.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneDrag { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml new file mode 100644 index 0000000..c9d14e5 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraDummy.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +// Item which is loaded by CameraItem if Qt Multimedia is not available +Rectangle { + id: root + color: "grey" + height: width + + signal fatalError + signal sizeChanged + signal framePainted + + Label { + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + text: qsTr("Failed to create Camera item\n\nCheck that Qt Multimedia is installed") + verticalAlignment: Text.AlignVCenter + wrapMode: Text.Wrap + } + + onWidthChanged: height = width + onHeightChanged: root.sizeChanged() + + function start() { } + function stop() { } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml new file mode 100644 index 0000000..b204e74 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreen.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreen { + contentType: "camera" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml new file mode 100644 index 0000000..ff7a402 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraFullScreenInverted.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreenInverted { + contentType: "camera" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml new file mode 100644 index 0000000..d6e4b85 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraItem.qml @@ -0,0 +1,47 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +Item { + id: root + height: width + + signal fatalError + signal sizeChanged + + onHeightChanged: root.sizeChanged() + + CaptureSession { + camera: Camera { + id: camera + + onErrorOccurred: function(error, errorString) { + if (Camera.NoError !== error) { + console.log("[qmlvideo] CameraItem.onError error " + error + " errorString " + errorString) + root.fatalError() + } + } + } + imageCapture: ImageCapture { + id: imageCapture + } + + recorder: MediaRecorder { + id: recorder +// resolution: "640x480" +// frameRate: 30 + } + videoOutput: videoOutput + } + + VideoOutput { + id: videoOutput + anchors.fill: parent + } + + + function start() { camera.start() } + function stop() { camera.stop() } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml new file mode 100644 index 0000000..c4c5da9 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraMove.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneMove { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml new file mode 100644 index 0000000..13136be --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraOverlay.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneOverlay { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml new file mode 100644 index 0000000..d89eef3 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraResize.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneResize { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml new file mode 100644 index 0000000..8394fb6 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraRotate.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneRotate { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml new file mode 100644 index 0000000..642a0ed --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/CameraSpin.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneSpin { + contentType: "camera" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml new file mode 100644 index 0000000..b08d193 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Content.qml @@ -0,0 +1,125 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import frequencymonitor + +Rectangle { + id: root + border.color: palette.window + border.width: showBorder ? 1 : 0 + color: "transparent" + property string contentType // "camera" or "video" + property string source + property real volume + property bool dummy: false + property bool autoStart: true + property bool started: false + property bool showFrameRate: false + property bool showBorder: false + property alias contentItem: contentLoader.item + + signal initialized + signal error + signal videoFramePainted + + Loader { + id: contentLoader + } + + Connections { + id: framePaintedConnection + function onFramePainted() { + (frameRateLoader.item as FrequencyItem)?.notify() + root.videoFramePainted() + } + ignoreUnknownSignals: true + } + + Connections { + id: errorConnection + function onFatalError() { + console.log("[qmlvideo] Content.onFatalError") + root.stop() + root.error() + } + ignoreUnknownSignals: true + } + + Component { + id: frequencyItem + FrequencyItem {} + } + + Loader { + id: frameRateLoader + sourceComponent: root.showFrameRate ? frequencyItem : undefined + onLoaded: { + item.parent = root + item.anchors.top = root.top + item.anchors.right = root.right + item.anchors.margins = 10 + } + } + + onWidthChanged: { + if (root.contentItem) + root.contentItem.width = width + } + + onHeightChanged: { + if (root.contentItem) + root.contentItem.height = height + } + + function initialize() { + if ("video" == contentType) { + contentLoader.source = "VideoItem.qml" + if (Loader.Error == contentLoader.status) { + contentLoader.source = "VideoDummy.qml" + dummy = true + } + contentLoader.item.volume = volume + } else if ("camera" == contentType) { + contentLoader.source = "CameraItem.qml" + if (Loader.Error == contentLoader.status) { + contentLoader.source = "CameraDummy.qml" + dummy = true + } + } else { + console.log("[qmlvideo] Content.initialize: error: invalid contentType") + } + if (contentLoader.item) { + contentLoader.item.sizeChanged.connect(updateRootSize) + contentLoader.item.parent = root + contentLoader.item.width = root.width + framePaintedConnection.target = contentLoader.item + errorConnection.target = contentLoader.item + if (root.autoStart) + root.start() + } + root.initialized() + } + + function start() { + if (contentLoader.item) { + if (root.contentType == "video") + contentLoader.item.mediaSource = root.source + contentLoader.item.start() + root.started = true + } + } + + // qmllint disable + function stop() { + if (contentLoader.item) { + contentLoader.item.stop() + if (root.contentType == "video") + contentLoader.item.mediaSource = "" + root.started = false + } + } + // qmllint enable + + function updateRootSize() { root.height = (root.contentItem as Item).height } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml b/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml new file mode 100644 index 0000000..f06079a --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/ErrorDialog.qml @@ -0,0 +1,70 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + id: root + color: "transparent" + opacity: 0.0 + property alias enabled: mouseArea.enabled + property int dialogWidth: 300 + property int dialogHeight: 200 + state: enabled ? "on" : "baseState" + + states: [ + State { + name: "on" + PropertyChanges { + root.opacity: 1.0 + } + } + ] + + transitions: [ + Transition { + from: "*" + to: "*" + NumberAnimation { + properties: "opacity" + easing.type: Easing.OutQuart + duration: 500 + } + } + ] + + Rectangle { + anchors.fill: parent + color: "black" + opacity: 0.75 + } + + Rectangle { + anchors.centerIn: parent + width: root.dialogWidth + height: root.dialogHeight + radius: 5 + color: "white" + + Text { + id: text + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + verticalAlignment: Text.AlignVCenter + color: "black" + wrapMode: Text.WordWrap + } + } + + MouseArea { + id: mouseArea + anchors.fill: parent + onClicked: root.enabled = false + } + + function show(msg) { + text.text = "Error

" + msg + root.enabled = true + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml new file mode 100644 index 0000000..49b9459 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Main.qml @@ -0,0 +1,188 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtQuick.Dialogs +import performancemonitor + +Rectangle { + id: root + anchors.fill: parent + color: palette.window + + property bool perfMonitorsLogging: false + property bool perfMonitorsVisible: false + + Loader { + id: performanceLoader + + Connections { + target: columnLayout + function onVisibleChanged() { + if (performanceLoader.item) + performanceLoader.item.enabled = !columnLayout.visible + } + ignoreUnknownSignals: true + } + + Component { + id: performanceItem + PerformanceItem {} + } + + function init() { + var enabled = root.perfMonitorsLogging || root.perfMonitorsVisible + sourceComponent = enabled ? performanceItem : undefined + } + + onLoaded: { + item.parent = root + item.anchors.fill = root + item.logging = root.perfMonitorsLogging + item.displayed = root.perfMonitorsVisible + item.enabled = false + item.init() + } + } + + ColumnLayout { + id: columnLayout + anchors.fill: parent + spacing: 5 + + Button { + id: openFile1Button + text: (VideoSingleton.source1 == '') ? qsTr("Select file 1") : VideoSingleton.source1 + Component.onCompleted: console.log("source1: " + VideoSingleton.source1) + onClicked: { + fileDialog.setFirstSource = true + fileDialog.open() + } + + Layout.fillWidth: true + } + + Button { + id: openFile2Button + text: (VideoSingleton.source2 == '') ? qsTr("Select file 2") : VideoSingleton.source2 + Component.onCompleted: console.log("source2: " + VideoSingleton.source2) + onClicked: { + fileDialog.setFirstSource = false + fileDialog.open() + } + + Layout.fillWidth: true + } + + RowLayout { + Layout.fillWidth: true + + Label { + text: qsTr("Video Modes") + + horizontalAlignment: Qt.AlignHCenter + Layout.preferredWidth: 50 + Layout.fillWidth: true + } + Label { + text: qsTr("Camera Modes") + + horizontalAlignment: Qt.AlignHCenter + Layout.preferredWidth: 50 + Layout.fillWidth: true + } + } + + SceneSelectionPanel { + id: sceneSelectionPanel + itemHeight: Math.min(width / 10, height / 10) + color: palette.dark + radius: 0 + onSceneSourceChanged: { + sceneLoader.source = sceneSource + var scene = null + var innerVisible = true + if (sceneSource == "") { + if (performanceLoader.item) + performanceLoader.item.videoActive = false + } else { + scene = sceneLoader.item + if (scene) { + if (scene.contentType === "video" && VideoSingleton.source1 === "") { + errorDialog.show(qsTr("You must first select a video file")) + sceneSource = "" + } else { + scene.parent = root + scene.color = root.palette.window + scene.source1 = VideoSingleton.source1 + scene.source2 = VideoSingleton.source2 + scene.volume = VideoSingleton.volume + scene.anchors.fill = root + scene.close.connect(closeScene) + scene.content.initialize() + innerVisible = false + } + } + } + videoFramePaintedConnection.target = scene + columnLayout.visible = innerVisible + } + + Layout.fillWidth: true + Layout.fillHeight: true + } + } + + Loader { + id: sceneLoader + } + + Connections { + id: videoFramePaintedConnection + // qmllint disable + function onVideoFramePainted() { + if (performanceLoader.item) + performanceLoader.item.videoFramePainted() + } + // qmllint enable + ignoreUnknownSignals: true + } + + FileDialog { + id: fileDialog + property bool setFirstSource + onAccepted: function() { + if (setFirstSource) + VideoSingleton.source1 = selectedFile + else + VideoSingleton.source2 = selectedFile + } + } + + ErrorDialog { + id: errorDialog + anchors.fill: root + dialogWidth: Math.min(root.width, root.height) * 0.5 + dialogHeight: Math.min(root.width, root.height) * 0.3 + enabled: false + } + + // Called from main() once root properties have been set + function init() { + performanceLoader.init() + fileDialog.currentFolder = VideoSingleton.videoPath + } + + // qmllint disable + function qmlFramePainted() { + if (performanceLoader.item) + performanceLoader.item.qmlFramePainted() + } + // qmllint enable + + function closeScene() { + sceneSelectionPanel.sceneSource = "" + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml b/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml new file mode 100644 index 0000000..e16478d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/Scene.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Rectangle { + id: root + color: palette.window + property string source1 + property string source2 + property int contentWidth: parent.width / 2 + property real volume: 0.25 + property int margins: 5 + property QtObject content + + signal close + signal videoFramePainted + + Button { + id: closeButton + anchors { + top: parent.top + right: parent.right + margins: root.margins + } + z: 2.0 + text: qsTr("Back") + onClicked: root.close() + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml new file mode 100644 index 0000000..8ad6c99 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneBasic.qml @@ -0,0 +1,47 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + property bool autoStart: false + property bool started: false + + Content { + id: content + autoStart: parent.autoStart + started: parent.started + anchors.fill: parent + width: parent.contentWidth + contentType: parent.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: content.started ? qsTr("Tap the screen to stop content") + : qsTr("Tap the screen to start content") + z: 2.0 + } + + MouseArea { + anchors.fill: parent + onClicked: { + if (content.started) + content.stop() + else + content.start() + } + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml new file mode 100644 index 0000000..99a7cb7 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneDrag.qml @@ -0,0 +1,34 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Image { + id: background + source: "images/leaves.jpg" + x: (parent.width - width) / 2 + y: (parent.height - height) / 2 + + Content { + id: content + anchors.centerIn: parent + width: root.contentWidth + contentType: root.contentType + source: root.source1 + volume: root.volume + onVideoFramePainted: root.videoFramePainted() + } + } + + MouseArea { + anchors.fill: parent + drag.target: background + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml new file mode 100644 index 0000000..ec85643 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreen.qml @@ -0,0 +1,67 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + state: "left" + + states: [ + State { + name: "fullScreen" + PropertyChanges { + content.width: content.parent.width + content.height: content.parent.height + } + } + ] + + transitions: [ + Transition { + ParallelAnimation { + PropertyAnimation { + property: "width" + easing.type: Easing.Linear + duration: 250 + } + PropertyAnimation { + property: "height" + easing.type: Easing.Linear + duration: 250 + } + } + } + ] + + MouseArea { + anchors.fill: parent + onClicked: content.state = (content.state == "fullScreen") ? "baseState" : "fullScreen" + } + + onVideoFramePainted: root.videoFramePainted() + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: qsTr("Tap on the content to toggle full-screen mode") + z: 2.0 + } + + Component.onCompleted: root.content = content +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml new file mode 100644 index 0000000..cb96ac1 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneFullScreenInverted.qml @@ -0,0 +1,70 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.width + height: parent.height + contentType: root.contentType + source: parent.source1 + volume: parent.volume + state: "left" + + states: [ + State { + name: "nonFullScreen" + PropertyChanges { content.width: root.contentWidth } + } + ] + + transitions: [ + Transition { + ParallelAnimation { + PropertyAnimation { + property: "width" + easing.type: Easing.Linear + duration: 250 + } + PropertyAnimation { + property: "height" + easing.type: Easing.Linear + duration: 250 + } + } + } + ] + + MouseArea { + anchors.fill: parent + onClicked: content.state = (content.state === "nonFullScreen") ? "baseState" : "nonFullScreen" + } + + onVideoFramePainted: root.videoFramePainted() + + onInitialized: { + width = parent.width + height = parent.height + } + } + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + text: qsTr("Tap on the content to toggle full-screen mode") + z: 2.0 + } + + Component.onCompleted: root.content = content +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml new file mode 100644 index 0000000..d151283 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMove.qml @@ -0,0 +1,49 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.verticalCenter: parent.verticalCenter + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + SequentialAnimation on x { + id: animation + loops: Animation.Infinite + property int from: root.margin + property int to: 100 + property int duration: 1500 + running: false + PropertyAnimation { + from: animation.from + to: animation.to + duration: animation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: animation.to + to: animation.from + duration: animation.duration + easing.type: Easing.InOutCubic + } + } + + onVideoFramePainted: root.videoFramePainted() + } + + onWidthChanged: { + animation.to = root.width - content.width - margin + animation.start() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml new file mode 100644 index 0000000..f93dabc --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneMulti.qml @@ -0,0 +1,186 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + + property real itemWidth: (width / 3) - 40 + property real itemTopMargin: 50 + + QtObject { + id: contentProxy + function initialize() { + video1.initialize() + video2.initialize() + } + } + + Component { + id: startStopComponent + + Rectangle { + id: root + color: "transparent" + + signal start + signal stop + + Label { + anchors { + horizontalCenter: parent.horizontalCenter + bottom: parent.bottom + margins: 20 + } + // qmllint disable + text: root.started ? qsTr("Tap to stop") : qsTr("Tap to start") + // qmllint enable + } + + MouseArea { + anchors.fill: parent + // qmllint disable + onClicked: { + if (root.started) + root.stop() + else + root.start() + } + // qmllint enable + } + } + } + + Content { + id: video1 + anchors { + left: parent.left + leftMargin: 10 + top: parent.top + topMargin: root.itemTopMargin + } + autoStart: false + contentType: "video" + showBorder: true + showFrameRate: started + source: parent.source1 + width: root.itemWidth + volume: parent.volume + + Loader { + id: video1StartStopLoader + + property bool started: parent.started + + onLoaded: { + item.parent = video1 + item.anchors.fill = video1 + item.start.connect(video1.start) + item.stop.connect(video1.stop) + } + } + + onInitialized: video1StartStopLoader.sourceComponent = startStopComponent + } + + Rectangle { + id: cameraHolder + + property bool started: false + + anchors { + horizontalCenter: parent.horizontalCenter + top: parent.top + topMargin: root.itemTopMargin + } + border.width: 1 + border.color: palette.base + color: "transparent" + width: root.itemWidth + height: width + + Loader { + id: cameraLoader + onLoaded: { + item.parent = cameraHolder + item.anchors.centerIn = cameraHolder + item.contentType = "camera" + item.showFrameRate = true + item.width = root.itemWidth + item.z = 1.0 + cameraErrorConnection.target = item + item.initialize() + } + } + + Loader { + id: cameraStartStopLoader + + property bool started: parent.started + + sourceComponent: startStopComponent + onLoaded: { + item.parent = cameraHolder + item.anchors.fill = cameraHolder + item.z = 2.0 + item.start.connect(cameraHolder.start) + item.stop.connect(cameraHolder.stop) + } + } + + Connections { + id: cameraErrorConnection + function onError() { + console.log("[qmlvideo] SceneMulti.camera.onError") + cameraHolder.stop() + } + ignoreUnknownSignals: true + } + + function start() { + cameraLoader.source = "Content.qml" + cameraHolder.started = true + } + + function stop() { + cameraLoader.source = "" + cameraHolder.started = false + } + } + + Content { + id: video2 + anchors { + right: parent.right + rightMargin: 10 + top: parent.top + topMargin: root.itemTopMargin + } + autoStart: false + contentType: "video" + showBorder: true + showFrameRate: started + source: parent.source2 + width: root.itemWidth + volume: parent.volume + + Loader { + id: video2StartStopLoader + + property bool started: parent.started + + onLoaded: { + item.parent = video2 + item.anchors.fill = video2 + item.start.connect(video2.start) + item.stop.connect(video2.stop) + } + } + + onInitialized: video2StartStopLoader.sourceComponent = startStopComponent + } + + Component.onCompleted: root.content = contentProxy +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml new file mode 100644 index 0000000..5863d61 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneOverlay.qml @@ -0,0 +1,83 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Rectangle { + id: overlay + y: 0.5 * parent.height + width: content.width + height: content.height + color: "#e0e0e0" + opacity: 0.5 + + SequentialAnimation on x { + id: xAnimation + loops: Animation.Infinite + property int from: root.margin + property int to: 100 + property int duration: 1500 + running: false + PropertyAnimation { + from: xAnimation.from + to: xAnimation.to + duration: xAnimation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: xAnimation.to + to: xAnimation.from + duration: xAnimation.duration + easing.type: Easing.InOutCubic + } + } + + SequentialAnimation on y { + id: yAnimation + loops: Animation.Infinite + property int from: root.margin + property int to: 180 + property int duration: 1500 + running: false + PropertyAnimation { + from: yAnimation.from + to: yAnimation.to + duration: yAnimation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: yAnimation.to + to: yAnimation.from + duration: yAnimation.duration + easing.type: Easing.InOutCubic + } + } + } + + onWidthChanged: { + xAnimation.to = root.width - content.width - margin + xAnimation.start() + } + + onHeightChanged: { + //yAnimation.to = root.height - content.height - margin + yAnimation.start() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml new file mode 100644 index 0000000..4e2f155 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneResize.qml @@ -0,0 +1,41 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + SequentialAnimation on scale { + id: animation + loops: Animation.Infinite + property int duration: 1500 + running: true + PropertyAnimation { + from: 1.5 + to: 0.5 + duration: animation.duration + easing.type: Easing.InOutCubic + } + PropertyAnimation { + from: 0.5 + to: 1.5 + duration: animation.duration + easing.type: Easing.InOutCubic + } + } + + onVideoFramePainted: root.videoFramePainted() + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml new file mode 100644 index 0000000..1362522 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneRotate.qml @@ -0,0 +1,57 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property int margin: 20 + property int delta: 30 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: rotatePositiveButton + anchors { + right: parent.right + bottom: rotateNegativeButton.top + margins: parent.margins + } + text: qsTr("Rotate +%1").arg(root.delta) + onClicked: content.rotation = content.rotation + root.delta + } + + Button { + id: rotateNegativeButton + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("Rotate -%1").arg(root.delta) + onClicked: content.rotation = content.rotation - root.delta + } + + Button { + id: rotateValueButton + anchors { + left: parent.left + verticalCenter: parent.verticalCenter + margins: parent.margins + } + enabled: false + text: content.rotation % 360 + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml new file mode 100644 index 0000000..91e7c6a --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSelectionPanel.qml @@ -0,0 +1,88 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +pragma ComponentBehavior: Bound + +Rectangle { + id: root + property int itemHeight: 25 + property string sceneSource: "" + + ListModel { + id: videolist + ListElement { name: qsTr("Multi"); source: "SceneMulti.qml" } + ListElement { name: qsTr("Video"); source: "VideoBasic.qml" } + ListElement { name: qsTr("Drag"); source: "VideoDrag.qml" } + ListElement { name: qsTr("Fillmode"); source: "VideoFillMode.qml" } + ListElement { name: qsTr("Fullscreen"); source: "VideoFullScreen.qml" } + ListElement { name: qsTr("Fullscreen-inverted"); source: "VideoFullScreenInverted.qml" } + ListElement { name: qsTr("Metadata"); source: "VideoMetadata.qml" } + ListElement { name: qsTr("Move"); source: "VideoMove.qml" } + ListElement { name: qsTr("Overlay"); source: "VideoOverlay.qml" } + ListElement { name: qsTr("Playback Rate"); source: "VideoPlaybackRate.qml" } + ListElement { name: qsTr("Resize"); source: "VideoResize.qml" } + ListElement { name: qsTr("Rotate"); source: "VideoRotate.qml" } + ListElement { name: qsTr("Spin"); source: "VideoSpin.qml" } + ListElement { name: qsTr("Seek"); source: "VideoSeek.qml" } + } + + ListModel { + id: cameralist + ListElement { name: qsTr("Camera"); source: "CameraBasic.qml" } + ListElement { name: qsTr("Drag"); source: "CameraDrag.qml" } + ListElement { name: qsTr("Fullscreen"); source: "CameraFullScreen.qml" } + ListElement { name: qsTr("Fullscreen-inverted"); source: "CameraFullScreenInverted.qml" } + ListElement { name: qsTr("Move"); source: "CameraMove.qml" } + ListElement { name: qsTr("Overlay"); source: "CameraOverlay.qml" } + ListElement { name: qsTr("Resize"); source: "CameraResize.qml" } + ListElement { name: qsTr("Rotate"); source: "CameraRotate.qml" } + ListElement { name: qsTr("Spin"); source: "CameraSpin.qml" } + } + + Component { + id: buttonDelegate + Button { + required property string name + required property string source + + width: root.width / 2 + height: root.itemHeight + + text: name + padding: 3 + onClicked: root.sceneSource = source + } + } + + Flickable { + anchors.fill: parent + contentHeight: (root.itemHeight * videolist.count) + 10 + clip: true + + Row { + id: layout + anchors { + fill: parent + topMargin: 5 + bottomMargin: 5 + } + + Column { + Repeater { + model: videolist + delegate: buttonDelegate + } + } + + Column { + Repeater { + model: cameralist + delegate: buttonDelegate + } + } + } + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml new file mode 100644 index 0000000..3e280d3 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SceneSpin.qml @@ -0,0 +1,34 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property int margin: 20 + property string contentType + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: root.contentType + source: parent.source1 + volume: parent.volume + + PropertyAnimation on rotation { + id: animation + loops: Animation.Infinite + running: true + from: 0 + to: 360 + duration: 3000 + easing.type: Easing.Linear + } + + onVideoFramePainted: root.videoFramePainted() + } + + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml b/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml new file mode 100644 index 0000000..646e5e8 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/SeekControl.qml @@ -0,0 +1,105 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Item { + id: seekControl + height: Math.min(parent.width, parent.height) / 20 + property int duration: 0 + property int playPosition: 0 + property int seekPosition: 0 + property bool enabled: true + property bool seeking: false + + Rectangle { + id: background + anchors.fill: parent + color: palette.base + opacity: 0.3 + radius: parent.height / 15 + } + + Rectangle { + id: progressBar + anchors { left: parent.left; top: parent.top; bottom: parent.bottom } + width: seekControl.duration == 0 ? 0 : background.width * seekControl.playPosition / seekControl.duration + color: palette.highlight + opacity: 0.7 + } + + Text { + width: 90 + anchors { left: parent.left; top: parent.top; bottom: parent.bottom; leftMargin: 10 } + horizontalAlignment: Text.AlignLeft + verticalAlignment: Text.AlignVCenter + color: palette.windowText + smooth: true + text: seekControl.formatTime(seekControl.playPosition) + } + + Text { + width: 90 + anchors { right: parent.right; top: parent.top; bottom: parent.bottom; rightMargin: 10 } + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + color: palette.windowText + smooth: true + text: seekControl.formatTime(seekControl.duration) + } + + Rectangle { + id: progressHandle + height: parent.height + width: parent.height / 2 + color: palette.accent + opacity: 0.5 + anchors.verticalCenter: progressBar.verticalCenter + x: seekControl.duration == 0 ? 0 : seekControl.playPosition / seekControl.duration * background.width + + MouseArea { + id: mouseArea + anchors { horizontalCenter: parent.horizontalCenter; bottom: parent.bottom } + height: parent.height + width: parent.height * 2 + enabled: seekControl.enabled + drag { + target: progressHandle + axis: Drag.XAxis + minimumX: 0 + maximumX: background.width + } + onPressed: { + seekControl.seeking = true; + } + onCanceled: { + seekControl.seekPosition = progressHandle.x * seekControl.duration / background.width + seekControl.seeking = false + } + onReleased: (mouse) => { + seekControl.seekPosition = progressHandle.x * seekControl.duration / background.width + seekControl.seeking = false + mouse.accepted = true + } + } + } + + Timer { // Update position also while user is dragging the progress handle + id: seekTimer + repeat: true + interval: 300 + running: seekControl.seeking + onTriggered: { + seekControl.seekPosition = progressHandle.x*seekControl.duration / background.width + } + } + + function formatTime(timeInMs) { + if (!timeInMs || timeInMs <= 0) return "0:00" + let seconds = timeInMs / 1000; + let minutes = Math.floor(seconds / 60) + seconds = Math.floor(seconds % 60) + if (seconds < 10) seconds = "0" + seconds; + return minutes + ":" + seconds + } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml new file mode 100644 index 0000000..15c25c9 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoBasic.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneBasic { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml new file mode 100644 index 0000000..4a5c5d4 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDrag.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneDrag { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml new file mode 100644 index 0000000..a30b9eb --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoDummy.qml @@ -0,0 +1,37 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +// Item which is loaded by VideoItem if Qt Multimedia is not available +Rectangle { + id: root + color: "grey" + height: width + property int duration: 0 + property int position: 0 + property string source + property real volume: 1.0 + property real playbackRate: 1.0 + + signal fatalError + signal sizeChanged + signal framePainted + + Label { + anchors.fill: parent + anchors.margins: 10 + horizontalAlignment: Text.AlignHCenter + text: qsTr("Failed to create Video item\n\nCheck that Qt Multimedia is installed") + verticalAlignment: Text.AlignVCenter + wrapMode: Text.Wrap + } + + onWidthChanged: height = width + onHeightChanged: root.sizeChanged() + + function start() { } + function stop() { } + function seek() { } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml new file mode 100644 index 0000000..af950c7 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFillMode.qml @@ -0,0 +1,49 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Scene { + id: root + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: button + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("PreserveAspectFit") + // qmllint disable + onClicked: { + if (!content.dummy) { + let video = content.contentItem + if (video.fillMode === VideoOutput.Stretch) { + video.fillMode = VideoOutput.PreserveAspectFit + text = qsTr("PreserveAspectFit") + } else if (video.fillMode === VideoOutput.PreserveAspectFit) { + video.fillMode = VideoOutput.PreserveAspectCrop + text = qsTr("PreserveAspectCrop") + } else { + video.fillMode = VideoOutput.Stretch + text = qsTr("Stretch") + } + } + } + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml new file mode 100644 index 0000000..e49faad --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreen.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreen { + contentType: "video" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml new file mode 100644 index 0000000..0bf8294 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoFullScreenInverted.qml @@ -0,0 +1,7 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneFullScreenInverted { + contentType: "video" +} + diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml new file mode 100644 index 0000000..2ea796d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoItem.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia + +VideoOutput { + id: root + height: width + + property alias duration: mediaPlayer.duration + property alias mediaSource: mediaPlayer.source + property alias metaData: mediaPlayer.metaData + property alias playbackRate: mediaPlayer.playbackRate + property alias position: mediaPlayer.position + property alias seekable: mediaPlayer.seekable + property alias volume: audioOutput.volume + + signal sizeChanged + signal fatalError + + onHeightChanged: root.sizeChanged() + + MediaPlayer { + id: mediaPlayer + videoOutput: root; + audioOutput: AudioOutput { + id: audioOutput + } + + onErrorOccurred: function(error, errorString) { + if (MediaPlayer.NoError !== error) { + console.log("[qmlvideo] VideoItem.onError error " + error + " errorString " + errorString) + root.fatalError() + } + } + } + + function start() { mediaPlayer.play() } + function stop() { mediaPlayer.stop() } + function seek(position) { mediaPlayer.setPosition(position); } +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml new file mode 100644 index 0000000..f83cbff --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMetadata.qml @@ -0,0 +1,80 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +pragma ComponentBehavior: Bound + +Scene { + id: root + property string contentType: "video" + + Content { + id: videoContent + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onInitialized: { + if (!dummy) + metadata.createObject(root) + } + onVideoFramePainted: root.videoFramePainted() + } + + Component { + id: metadata + Column { + anchors.fill: parent + // qmllint disable + property var videoMetaData: videoContent.contentItem?.metaData + // qmllint enable + Label { + text: qsTr("Title: %1").arg(parent.videoMetaData?.value(MediaMetaData.Title) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Resolution: %1").arg(parent.videoMetaData?.value(MediaMetaData.Resolution) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Media type: %1").arg(parent.videoMetaData?.value(MediaMetaData.MediaType) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video codec: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoCodec) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video bit rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoBitRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Video frame rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.VideoFrameRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Audio codec: %1").arg(parent.videoMetaData?.value(MediaMetaData.AudioCodec) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Audio bit rate: %1").arg(parent.videoMetaData?.value(MediaMetaData.AudioBitRate) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Date: %1").arg(parent.videoMetaData?.value(MediaMetaData.Date) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Description: %1").arg(parent.videoMetaData?.value(MediaMetaData.Description) ?? qsTr("Unknown")) + } + Label { + text: qsTr("Copyright: %1").arg(parent.videoMetaData?.value(MediaMetaData.Copyright) ?? qsTr("Unknown")) + } + Label { + // qmllint disable + text: qsTr("Seekable: %1").arg(videoContent.contentItem?.seekable ?? qsTr("Unknown")) + // qmllint enable + } + Label { + text: qsTr("Orientation: %1").arg(parent.videoMetaData?.value(MediaMetaData.Orientation) ?? qsTr("Unknown")) + } + } + } + + Component.onCompleted: root.content = videoContent +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml new file mode 100644 index 0000000..2b9230f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoMove.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneMove { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml new file mode 100644 index 0000000..576b33f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoOverlay.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneOverlay { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml new file mode 100644 index 0000000..55e38ef --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoPlaybackRate.qml @@ -0,0 +1,65 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Scene { + id: root + property int margin: 20 + property real delta: 0.1 + property string contentType: "video" + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + Button { + id: increaseButton + anchors { + right: parent.right + bottom: decreaseButton.top + margins: parent.margins + } + text: qsTr("Increase") + onClicked: { + let video = (content.contentItem as VideoItem) + video.playbackRate += root.delta + } + } + + Button { + id: decreaseButton + anchors { + right: parent.right + verticalCenter: parent.verticalCenter + margins: parent.margins + } + text: qsTr("Decrease") + onClicked: { + let video = (content.contentItem as VideoItem) + video.playbackRate -= root.delta + } + } + + Button { + id: valueButton + anchors { + left: parent.left + verticalCenter: parent.verticalCenter + margins: parent.margins + } + enabled: false + // qmllint disable + text: Math.round(10 * content.contentItem?.playbackRate ?? 1) / 10 + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml new file mode 100644 index 0000000..88fe7a2 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoResize.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneResize { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml new file mode 100644 index 0000000..d429ec4 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoRotate.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneRotate { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml new file mode 100644 index 0000000..5e2584f --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSeek.qml @@ -0,0 +1,36 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Scene { + id: root + property string contentType: "video" + contentWidth: parent.width + + Content { + id: content + anchors.centerIn: parent + width: parent.contentWidth + contentType: "video" + source: parent.source1 + volume: parent.volume + onVideoFramePainted: root.videoFramePainted() + } + + SeekControl { + anchors { + left: parent.left + right: parent.right + margins: 10 + bottom: parent.bottom + } + // qmllint disable + duration: content.contentItem?.duration ?? 0 + playPosition: content.contentItem?.position ?? 0 + onSeekPositionChanged: content.contentItem?.seek(seekPosition); + // qmllint enable + } + + Component.onCompleted: root.content = content +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml new file mode 100644 index 0000000..7c365dd --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/VideoSpin.qml @@ -0,0 +1,6 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +SceneSpin { + contentType: "video" +} diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png b/examples/multimedia/video/qmlvideo/qmlvideo/images/folder.png new file mode 100644 index 0000000000000000000000000000000000000000..62d97004fb01e085c3060619ac68dbec2fa7e8aa GIT binary patch literal 1829 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�?f$Tbjv=WLN#gQmQ? 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 z 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/images/up.png b/examples/multimedia/video/qmlvideo/qmlvideo/images/up.png new file mode 100644 index 0000000000000000000000000000000000000000..6823de0040faa2b40088178f9de0aaa2a33f4ee9 GIT binary patch literal 1268 zcmeAS@N?(olHy`uVBq!ia0vp^LO?9T!3HFAj=Wa~Qj#UE5hcO-X(i=}MX3yqDfvmM z3ZA)%>8U}fi7AzZCsS=07?@QuLn2Bde0{8v^Kf6`()~Xj@TAnpKdC8`Lf!&sHg;q@=(~U%$M( zT(8_%FTW^V-_X+15@d#vkuFe$ZgFK^Nn(X=Ua>OF1ees}+T7#d8#0MoBXEYLU9GXQxBrqI_HztY@Xxa#7Ppj3o=u^L<)Qdy9y zACy|0Us{w5jJPyqkW~d%&PAz-CHX}m`T04pPz=b(FUc>?$S+WE4mMNJ@J&q4%mWE% zf_3=%T6yLbmn7yTr+T{BDgn*V%gju%aP^Az77Ltu^?{Dj2SqJXRKtXT=?BDwCtM&0p7c}mfa$#mn6UdBzjZM%Fs6CBIEGZ* zS~GROm$RWr`(DGQ1?R4rZ+N65vSvm8gZW?fGn%#QS}+KIuEBnAvb~;U`Nsi%k*|0eOlwSa_!rIo8bZ;=T@q0$a;AATeJNhA+d{% zOSE3}v5GZmo%#~&yYAQulP7Xn8)tAcajww`UlQ}9>qOXm4&xU-LEbN>u`X-YIu-JK z{={qbdzaNIF8#fC_2Ww2OWT*5asFNR_36j+m78n2dwz&%{)tVt&Mn;f_^!F3xaf_= e2hP>ANHDZN+w`o>Y1uwdIppc;=d#Wzp$P!%^~9C{ literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/qmldir b/examples/multimedia/video/qmlvideo/qmlvideo/qmldir new file mode 100644 index 0000000..1cba13d --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/qmldir @@ -0,0 +1,44 @@ +module qmlvideo + +CameraBasic 1.0 CameraBasic.qml +CameraDrag 1.0 CameraDrag.qml +CameraDummy 1.0 CameraDummy.qml +CameraFullScreen 1.0 CameraFullScreen.qml +CameraFullScreenInverted 1.0 CameraFullScreenInverted.qml +CameraItem 1.0 CameraItem.qml +CameraMove 1.0 CameraMove.qml +CameraOverlay 1.0 CameraOverlay.qml +CameraResize 1.0 CameraResize.qml +CameraRotate 1.0 CameraRotate.qml +CameraSpin 1.0 CameraSpin.qml +CameraContent 1.0 Content.qml +ErrorDialog 1.0 ErrorDialog.qml +Scene 1.0 Scene.qml +SceneBasic 1.0 SceneBasic.qml +SceneDrag 1.0 SceneDrag.qml +SceneFullScreen 1.0 SceneFullScreen.qml +SceneFullScreeninverted 1.0 SceneFullScreenInverted.qml +SceneMoved 1.0 SceneMove.qml +SceneMulti 1.0 SceneMulti.qml +SceneOverlay 1.0 SceneOverlay.qml +SceneResize 1.0 SceneResize.qml +SceneRotate 1.0 SceneRotate.qml +SceneSelectionPanel 1.0 SceneSelectionPanel.qml +SceneSpin 1.0 SceneSpin.qml +SeekControl 1.0 SeekControl.qml +VideoBasic 1.0 VideoBasic.qml +VideoDrag 1.0 VideoDrag.qml +VideoDummy 1.0 VideoDummy.qml +VideoFillMode 1.0 VideoFillMode.qml +VideoFullScreen 1.0 VideoFullScreen.qml +VideoFullScreenInverted 1.0 VideoFullScreenInverted.qml +VideoItem 1.0 VideoItem.qml +VideoMetadata 1.0 VideoMetadata.qml +VideoMove 1.0 VideoMove.qml +VideoOverlay 1.0 VideoOverlay.qml +VideoPlaybackRate 1.0 VideoPlaybackRate.qml +VideoResize 1.0 VideoResize.qml +VideoRotate 1.0 VideoRotate.qml +VideoSeek 1.0 VideoSeek.qml +VideoSpin 1.0 VideoSpin.qml +Main 1.0 Main.qml diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h b/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h new file mode 100644 index 0000000..8df5b5b --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/qmlvideo_global.h @@ -0,0 +1,10 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include + +#if defined(QMLVIDEO_LIB) +#define QMLVIDEO_LIB_EXPORT Q_DECL_EXPORT +#else +#define QMLVIDEO_LIB_EXPORT Q_DECL_IMPORT +#endif diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp new file mode 100644 index 0000000..2b02fa5 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.cpp @@ -0,0 +1,54 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videosingleton.h" + +VideoSingleton::VideoSingleton(QObject * parent) : QObject(parent) +{ } + +QUrl VideoSingleton::source1() const +{ + return m_source1; +} +void VideoSingleton::setSource1(const QUrl &source1) +{ + if (source1 == m_source1) + return; + m_source1 = source1; + emit source1Changed(); +} +QUrl VideoSingleton::source2() const +{ + return m_source2; +} +void VideoSingleton::setSource2(const QUrl &source2) +{ + if (source2 == m_source2) + return; + m_source2 = source2; + emit source2Changed(); +} +qreal VideoSingleton::volume() const +{ + return m_volume; +} +void VideoSingleton::setVolume(qreal volume) +{ + if (volume == m_volume) + return; + m_volume = volume; + emit volumeChanged(); +} +QUrl VideoSingleton::videoPath() const +{ + return m_videoPath; +} +void VideoSingleton::setVideoPath(const QUrl &videoPath) +{ + if (m_videoPath == videoPath) + return; + m_videoPath = videoPath; + emit videoPathChanged(); +} + +#include "moc_videosingleton.cpp" diff --git a/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h new file mode 100644 index 0000000..3e0d562 --- /dev/null +++ b/examples/multimedia/video/qmlvideo/qmlvideo/videosingleton.h @@ -0,0 +1,48 @@ +// Copyright (C) 2024 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef QMLVIDEOSINGLETON_H +#define QMLVIDEOSINGLETON_H + +#include "qmlvideo_global.h" + +#include + +class QMLVIDEO_LIB_EXPORT VideoSingleton : public QObject +{ + Q_OBJECT + Q_PROPERTY(QUrl source1 READ source1 WRITE setSource1 NOTIFY source1Changed FINAL) + Q_PROPERTY(QUrl source2 READ source2 WRITE setSource2 NOTIFY source2Changed FINAL) + Q_PROPERTY(QUrl videoPath READ videoPath WRITE setVideoPath NOTIFY videoPathChanged FINAL) + Q_PROPERTY(qreal volume READ volume WRITE setVolume NOTIFY volumeChanged FINAL) + QML_SINGLETON + QML_ELEMENT + +public: + explicit VideoSingleton(QObject *parent = nullptr); + + QUrl source1() const; + void setSource1(const QUrl &source1); + QUrl source2() const; + void setSource2(const QUrl &source2); + QUrl videoPath() const; + void setVideoPath(const QUrl &videoPath); + qreal volume() const; + void setVolume(qreal volume); + +Q_SIGNALS: + void source1Changed(); + void source2Changed(); + void volumeChanged(); + void videoPathChanged(); + +private: + QUrl m_source1; + QUrl m_source2; + QUrl m_videoPath; + qreal m_volume = 0.5; +}; + +QML_DECLARE_TYPE(VideoSingleton); + +#endif // QMLVIDEOSINGLETON_H diff --git a/examples/multimedia/video/qmlvideo/trace.h b/examples/multimedia/video/qmlvideo/trace.h new file mode 100644 index 0000000..bd7f63b --- /dev/null +++ b/examples/multimedia/video/qmlvideo/trace.h @@ -0,0 +1,81 @@ +// Copyright (C) 2016 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef TRACE_H +#define TRACE_H + +#include + +#define ENABLE_TRACE +//#define VERBOSE_TRACE + +namespace Trace { + +class NullDebug +{ +public: + template + NullDebug &operator<<(const T &) + { + return *this; + } +}; + +inline NullDebug nullDebug() +{ + return NullDebug(); +} + +template +struct PtrWrapper +{ + PtrWrapper(const T *ptr) : m_ptr(ptr) { } + const T *const m_ptr; +}; + +} // namespace Trace + +template +inline QDebug &operator<<(QDebug &debug, const Trace::PtrWrapper &wrapper) +{ + QDebugStateSaver saver(debug); + debug.nospace() << '[' << static_cast(wrapper.m_ptr) << ']'; + return debug; +} + +template +inline const void *qtVoidPtr(const T *ptr) +{ + return static_cast(ptr); +} + +#define qtThisPtr() qtVoidPtr(this) + +#ifdef ENABLE_TRACE +inline QDebug qtTrace() +{ + return qDebug() << "[qmlvideo]"; +} +# ifdef VERBOSE_TRACE +inline QDebug qtVerboseTrace() +{ + return qtTrace(); +} +# else +inline Trace::NullDebug qtVerboseTrace() +{ + return Trace::nullDebug(); +} +# endif +#else +inline Trace::NullDebug qtTrace() +{ + return Trace::nullDebug(); +} +inline Trace::NullDebug qtVerboseTrace() +{ + return Trace::nullDebug(); +} +#endif + +#endif // TRACE_H diff --git a/examples/multimedia/video/recorder/AudioInputSelect.qml b/examples/multimedia/video/recorder/AudioInputSelect.qml new file mode 100644 index 0000000..d1e30f0 --- /dev/null +++ b/examples/multimedia/video/recorder/AudioInputSelect.qml @@ -0,0 +1,53 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Row { + id: root + height: Style.height + property AudioInput selected: available ? audioInput : null + property bool available: (typeof comboBox.currentValue !== 'undefined') && audioSwitch.checked + + Component.onCompleted: { + audioInputModel.populate() + comboBox.currentIndex = 0 + } + + MediaDevices { id: mediaDevices } + + AudioInput { id: audioInput; muted: !audioSwitch.checked } + + Switch { + id: audioSwitch; + height: Style.height; + checked: true + } + + ListModel { + id: audioInputModel + property var audioInputs: mediaDevices.audioInputs + + function populate() { + audioInputModel.clear() + + for (var audioDevice of audioInputs) + audioInputModel.append({ text: audioDevice.description, value: + { type: 'audioDevice', audioDevice: audioDevice } }) + } + } + ComboBox { + id: comboBox + width: Style.widthLong + height: Style.height + background: StyleRectangle { anchors.fill: parent } + model: audioInputModel + textRole: "text" + font.pointSize: Style.fontSize + displayText: typeof currentValue === 'undefined' ? "unavailable" : currentText + valueRole: "value" + onCurrentValueChanged: if (typeof comboBox.currentValue !== 'undefined') audioInput.device = currentValue.audioDevice + } +} diff --git a/examples/multimedia/video/recorder/CMakeLists.txt b/examples/multimedia/video/recorder/CMakeLists.txt new file mode 100644 index 0000000..dcda643 --- /dev/null +++ b/examples/multimedia/video/recorder/CMakeLists.txt @@ -0,0 +1,65 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) + +project(recorder LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/video/recorder") + +find_package(Qt6 REQUIRED COMPONENTS Core Multimedia Quick) + +qt_add_executable(recorder + main.cpp +) + +qt_add_ios_ffmpeg_libraries(recorder) + +set(resource_files + "main.qml" + "main_no_permissions.qml" + "qmldir" + "MediaList.qml" + "AudioInputSelect.qml" + "VideoSourceSelect.qml" + "RecordButton.qml" + "Controls.qml" + "StyleParameter.qml" + "StyleRectangle.qml" + "SettingsMetaData.qml" + "SettingsEncoder.qml" + "StyleSlider.qml" + "Style.qml" + "Playback.qml" +) + +qt_add_resources(recorder "recorder" + PREFIX + "/" + FILES + ${resource_files} +) + +target_link_libraries(recorder PRIVATE + Qt6::Core + Qt6::Multimedia + Qt6::Quick +) + +set_target_properties(recorder PROPERTIES + MACOSX_BUNDLE TRUE + MACOSX_BUNDLE_INFO_PLIST ${CMAKE_CURRENT_SOURCE_DIR}/Info.plist.in + QT_ANDROID_PACKAGE_SOURCE_DIR ${CMAKE_CURRENT_SOURCE_DIR}/android +) + +install(TARGETS recorder + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/video/recorder/Controls.qml b/examples/multimedia/video/recorder/Controls.qml new file mode 100644 index 0000000..627c2fe --- /dev/null +++ b/examples/multimedia/video/recorder/Controls.qml @@ -0,0 +1,83 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Row { + id: root + required property MediaRecorder recorder + + property bool settingsVisible: false + property bool capturesVisible: false + + property alias audioInput: audioInputSelect.selected + property alias camera: videoSourceSelect.selectedCamera + property alias screenCapture: videoSourceSelect.selectedScreenCapture + property alias windowCapture: videoSourceSelect.selectedWindowCapture + + spacing: Style.interSpacing * Style.ratio + + Column { + id: inputControls + spacing: Style.intraSpacing + + VideoSourceSelect { id: videoSourceSelect } + AudioInputSelect { id: audioInputSelect } + } + + Column { + width: recordButton.width + RecordButton { + id: recordButton + recording: recorder.recorderState === MediaRecorder.RecordingState + onClicked: recording ? recorder.stop() : recorder.record() + } + Text { + id: recordingTime + anchors.horizontalCenter: parent.horizontalCenter + font.pointSize: Style.fontSize + color: palette.text + } + } + + Column { + id: optionButtons + spacing: Style.intraSpacing + Button { + leftPadding: 0 + rightPadding: 0 + topPadding: 0 + bottomPadding: 0 + height: Style.height + width: Style.widthMedium + background: StyleRectangle { anchors.fill: parent } + onClicked: root.capturesVisible = !root.capturesVisible + text: "Captures" + font.pointSize: Style.fontSize + } + Button { + leftPadding: 0 + rightPadding: 0 + topPadding: 0 + bottomPadding: 0 + height: Style.height + width: Style.widthMedium + background: StyleRectangle { anchors.fill: parent } + onClicked: settingsVisible = !settingsVisible + text: "Settings" + font.pointSize: Style.fontSize + } + } + + Timer { + running: true; interval: 100; repeat: true + onTriggered: { + var m = Math.floor(recorder.duration / 60000) + var ms = (recorder.duration / 1000 - m * 60).toFixed(1) + recordingTime.text = `${m}:${ms.padStart(4, 0)}` + } + } +} diff --git a/examples/multimedia/video/recorder/Info.plist.in b/examples/multimedia/video/recorder/Info.plist.in new file mode 100644 index 0000000..46a9ecf --- /dev/null +++ b/examples/multimedia/video/recorder/Info.plist.in @@ -0,0 +1,46 @@ + + + + + CFBundleInfoDictionaryVersion + 6.0 + CFBundlePackageType + APPL + + CFBundleName + ${MACOSX_BUNDLE_BUNDLE_NAME} + CFBundleIdentifier + ${MACOSX_BUNDLE_GUI_IDENTIFIER} + CFBundleExecutable + ${MACOSX_BUNDLE_EXECUTABLE_NAME} + + CFBundleVersion + ${MACOSX_BUNDLE_BUNDLE_VERSION} + CFBundleShortVersionString + ${MACOSX_BUNDLE_SHORT_VERSION_STRING} + CFBundleLongVersionString + ${MACOSX_BUNDLE_LONG_VERSION_STRING} + + LSMinimumSystemVersion + ${CMAKE_OSX_DEPLOYMENT_TARGET} + + CFBundleGetInfoString + ${MACOSX_BUNDLE_INFO_STRING} + NSHumanReadableCopyright + ${MACOSX_BUNDLE_COPYRIGHT} + + CFBundleIconFile + ${MACOSX_BUNDLE_ICON_FILE} + + CFBundleDevelopmentRegion + English + + NSCameraUsageDescription + Qt Multimedia Example + NSMicrophoneUsageDescription + Qt Multimedia Example + + NSSupportsAutomaticGraphicsSwitching + + + diff --git a/examples/multimedia/video/recorder/MediaList.qml b/examples/multimedia/video/recorder/MediaList.qml new file mode 100644 index 0000000..5fa6539 --- /dev/null +++ b/examples/multimedia/video/recorder/MediaList.qml @@ -0,0 +1,67 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia +import QtQuick.Layouts + +Item { + id: root + + required property Playback playback + + property string mediaThumbnail + property string mediaUrl + + function append() { + if (mediaUrl !== "") + mediaList.append({"thumbnail": root.mediaThumbnail, "url": root.mediaUrl}) + mediaThumbnail = "" + mediaUrl = "" + } + + ListModel { id: mediaList } + + ListView { + id: listView + anchors.fill: parent + model: mediaList + orientation: ListView.Horizontal + spacing: Style.intraSpacing + + delegate: Frame { + padding: Style.intraSpacing + width: root.height + height: root.height + background: StyleRectangle { anchors.fill: parent } + + required property string url + required property string thumbnail + + ColumnLayout { + anchors.fill: parent + Image { + id: image + Layout.fillWidth: true + Layout.fillHeight: true + source: thumbnail + fillMode: Image.PreserveAspectFit + } + + Text { + Layout.fillWidth: true + elide: Text.ElideLeft + text: url + } + } + RoundButton { + anchors.centerIn: parent + width: 30 + height: 30 + text: "\u25B6"; + onClicked: { playback.playUrl(url) } + } + } + } +} diff --git a/examples/multimedia/video/recorder/Playback.qml b/examples/multimedia/video/recorder/Playback.qml new file mode 100644 index 0000000..78575ae --- /dev/null +++ b/examples/multimedia/video/recorder/Playback.qml @@ -0,0 +1,55 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtMultimedia +import QtQuick.Controls + +Item { + id: root + + property bool active: false + property bool playing: false + visible: active && playing + + function playUrl(url) { + playing = true + mediaPlayer.source = url + mediaPlayer.play() + } + + function stop() { + playing = false + mediaPlayer.stop() + } + + onActiveChanged: function() { + if (!active) + stop(); + } + + VideoOutput { + anchors.fill: parent + id: videoOutput + } + + MediaPlayer { + id: mediaPlayer + videoOutput: videoOutput + audioOutput: AudioOutput {} + } + + HoverHandler { id: hover } + + RoundButton { + width: 50 + height: 50 + opacity: hover.hovered && active ? 1.0 : 0.0 + anchors.centerIn: root + radius: 25 + text: "\u25A0"; + onClicked: root.stop() + + Behavior on opacity { NumberAnimation { duration: 200 } } + } +} diff --git a/examples/multimedia/video/recorder/RecordButton.qml b/examples/multimedia/video/recorder/RecordButton.qml new file mode 100644 index 0000000..5296a30 --- /dev/null +++ b/examples/multimedia/video/recorder/RecordButton.qml @@ -0,0 +1,45 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Item { + id: root + width: outerRadius * 2 + height: outerRadius * 2 + + required property bool recording + + property int outerRadius: Style.height + property int innerRadius: mouse.pressedButtons === Qt.LeftButton ? outerRadius - 6 : outerRadius - 5 + + signal clicked + + Rectangle { + anchors.fill: parent + radius: outerRadius + opacity: 0.5 + border.color: "black" + border.width: 1 + } + + Rectangle { + anchors.centerIn: parent + width: recording ? innerRadius * 2 - 15 : innerRadius * 2 + height: recording ? innerRadius * 2 - 15 : innerRadius * 2 + radius: recording ? 2 : innerRadius + color: "red" + + Behavior on width { NumberAnimation { duration: 100 }} + Behavior on height { NumberAnimation { duration: 100 }} + Behavior on radius { NumberAnimation { duration: 100 }} + + MouseArea { + id: mouse + anchors.fill: parent + onClicked: root.clicked() + } + } +} diff --git a/examples/multimedia/video/recorder/SettingsEncoder.qml b/examples/multimedia/video/recorder/SettingsEncoder.qml new file mode 100644 index 0000000..16a9590 --- /dev/null +++ b/examples/multimedia/video/recorder/SettingsEncoder.qml @@ -0,0 +1,102 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + +Column { + id: root + spacing: Style.intraSpacing + Component.onCompleted: root.populateModels() + + required property MediaRecorder recorder + + function populateModels() { + audioCodecModel.populate() + videoCodecModel.populate() + fileFormatModel.populate() + } + + Connections { + target: recorder + function onMediaFormatChanged() { root.populateModels() } + } + + Text { + text: "Encoder settings" + color: palette.text + } + + StyleParameter { + label: "Quality" + model: ListModel { + ListElement { text: "very low"; value: MediaRecorder.VeryLowQuality } + ListElement { text: "low"; value: MediaRecorder.LowQuality } + ListElement { text: "normal"; value: MediaRecorder.NormalQuality } + ListElement { text: "high"; value: MediaRecorder.HighQuality } + ListElement { text: "very high"; value: MediaRecorder.VeryHighQuality } + } + onActivated: (v) => { recorder.quality = v } + } + + StyleParameter { + id: audioCodecSelect + label: "Audio codec" + model: audioCodecModel + onActivated: (v) => { recorder.mediaFormat.audioCodec = v } + + ListModel { + id: audioCodecModel + function populate() { + audioCodecModel.clear() + audioCodecModel.append({"text": "Unspecifed", "value": MediaFormat.AudioCodec.Unspecified}) + var cs = recorder.mediaFormat.supportedAudioCodecs(MediaFormat.Encode) + for (var c of cs) + audioCodecModel.append({"text": recorder.mediaFormat.audioCodecName(c), "value": c}) + audioCodecSelect.currentIndex = cs.indexOf(recorder.mediaFormat.audioCodec) + 1 + } + } + } + + function buildModel() {} + + StyleParameter { + id: videoCodecSelect + label: "Video codec" + model: videoCodecModel + onActivated: (v) => { recorder.mediaFormat.videoCodec = v } + + ListModel { + id: videoCodecModel + function populate() { + videoCodecModel.clear() + videoCodecModel.append({"text": "Unspecifed", "value": MediaFormat.VideoCodec.Unspecified}) + var cs = recorder.mediaFormat.supportedVideoCodecs(MediaFormat.Encode) + for (var c of cs) + videoCodecModel.append({"text": recorder.mediaFormat.videoCodecName(c), "value": c}) + videoCodecSelect.currentIndex = cs.indexOf(recorder.mediaFormat.videoCodec) + 1 + } + } + } + + StyleParameter { + id: fileFormatSelect + label: "File format" + model: fileFormatModel + onActivated: (v) => { recorder.mediaFormat.fileFormat = v } + + ListModel { + id: fileFormatModel + function populate() { + fileFormatModel.clear() + fileFormatModel.append({"text": "Unspecifed", "value": MediaFormat.AudioCodec.Unspecified}) + var cs = recorder.mediaFormat.supportedFileFormats(MediaFormat.Encode) + for (var c of cs) + fileFormatModel.append({"text": recorder.mediaFormat.fileFormatName(c), "value": c}) + fileFormatSelect.currentIndex = cs.indexOf(recorder.mediaFormat.fileFormat) + 1 + } + } + } +} diff --git a/examples/multimedia/video/recorder/SettingsMetaData.qml b/examples/multimedia/video/recorder/SettingsMetaData.qml new file mode 100644 index 0000000..7bfc225 --- /dev/null +++ b/examples/multimedia/video/recorder/SettingsMetaData.qml @@ -0,0 +1,145 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Layouts +import QtQuick.Controls +import QtMultimedia + +pragma ComponentBehavior: Bound + +ColumnLayout { + id: root + required property MediaRecorder recorder + + Text { + text: "Metadata settings" + color: palette.text + } + + ListModel { id: metaDataModel } + + Connections { + target: root.recorder + function onMetaDataChanged() { + metaDataModel.clear() + for (var key of root.recorder.metaData.keys()) { + if (recorder.metaData.stringValue(key)) + metaDataModel.append( + { text: recorder.metaData.metaDataKeyToString(key) + , value: key }) + } + } + } + + Row { + id: metaDataAdd + spacing: Style.intraSpacing + ComboBox { + id: metaDataType + width: Style.widthMedium + height: Style.height + font.pointSize: Style.fontSize + model: ListModel { + ListElement { text: "Title"; value: MediaMetaData.Title } + ListElement { text: "Author"; value: MediaMetaData.Author } + ListElement { text: "Comment"; value: MediaMetaData.Comment } + ListElement { text: "Description"; value: MediaMetaData.Description } + ListElement { text: "Genre"; value: MediaMetaData.Genre } + ListElement { text: "Publisher"; value: MediaMetaData.Publisher } + ListElement { text: "Copyright"; value: MediaMetaData.Copyright } + ListElement { text: "Date"; value: MediaMetaData.Date } + ListElement { text: "Url"; value: MediaMetaData.Url } + ListElement { text: "MediaType"; value: MediaMetaData.MediaType } + ListElement { text: "AlbumTitle"; value: MediaMetaData.AlbumTitle } + ListElement { text: "AlbumArtist"; value: MediaMetaData.AlbumArtist } + ListElement { text: "ContributingArtist"; value: MediaMetaData.ContributingArtist } + ListElement { text: "Composer"; value: MediaMetaData.Composer } + ListElement { text: "LeadPerformer"; value: MediaMetaData.LeadPerformer } + } + textRole: "text" + valueRole: "value" + background: StyleRectangle { anchors.fill: parent; width: metaDataType.width } + } + Item { + width: Style.widthMedium + height: Style.height + StyleRectangle { anchors.fill: parent } + TextInput { + id: textInput + anchors.fill: parent + anchors.bottom: parent.bottom + anchors.margins: 4 + font.pointSize: Style.fontSize + clip: true + onAccepted: { + root.recorder.metaData.insert(metaDataType.currentValue, text) + recorder.metaDataChanged() + text = "" + textInput.deselect() + } + } + } + Button { + width: Style.widthShort + height: Style.height + text: "add" + font.pointSize: Style.fontSize + + background: StyleRectangle { anchors.fill: parent } + onClicked: textInput.accepted() + } + } + + ListView { + id: listView + Layout.fillHeight: true + Layout.minimumWidth: metaDataAdd.width + spacing: Style.intraSpacing + clip: true + model: metaDataModel + + delegate: Row { + id: r + height: Style.height + spacing: Style.intraSpacing + + required property string text + required property string value + + Text { + width: Style.widthShort + height: Style.height + text: r.text + font.pointSize: Style.fontSize + + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + } + Item { + width: Style.widthMedium + height: Style.height + + StyleRectangle { anchors.fill: parent } + TextInput { + anchors.fill: parent + anchors.margins: 4 + anchors.bottom: parent.bottom + font.pointSize: Style.fontSize + clip: true + text: root.recorder.metaData.stringValue(r.value) + onAccepted: root.recorder.metaData.insert(r.value, text) + + } + } + Button { + width: Style.widthShort + height: Style.height + text: "del" + font.pointSize: Style.fontSize + background: StyleRectangle { anchors.fill: parent } + onClicked: { root.recorder.metaData.remove(r.value); recorder.metaDataChanged() } + } + } + } +} diff --git a/examples/multimedia/video/recorder/Style.qml b/examples/multimedia/video/recorder/Style.qml new file mode 100644 index 0000000..d30c3b8 --- /dev/null +++ b/examples/multimedia/video/recorder/Style.qml @@ -0,0 +1,31 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +pragma Singleton +import QtQuick + +QtObject { + + function isMobile() { + return Qt.platform.os === "android" || Qt.platform.os === "ios"; + } + + function calculateRatio(windowWidth, windowHeight) { + var refWidth = 800.; + Style.ratio = windowWidth/refWidth; + } + + property real ratio : 1 + + property real screenWidth: isMobile()? 400 : 800 + property real screenHeigth: isMobile()? 900 : 600 + + property real height: 25 + property real widthTiny: 40*ratio + property real widthShort: 80*ratio + property real widthMedium: 160*ratio + property real widthLong: 220*ratio + property real intraSpacing: 5 + property real interSpacing: 15 + property real fontSize: 11 +} diff --git a/examples/multimedia/video/recorder/StyleParameter.qml b/examples/multimedia/video/recorder/StyleParameter.qml new file mode 100644 index 0000000..3a7573b --- /dev/null +++ b/examples/multimedia/video/recorder/StyleParameter.qml @@ -0,0 +1,42 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Row { + id: root + spacing: Style.intraSpacing + + property alias label: label.text + property alias model: comboBox.model + property alias currentIndex: comboBox.currentIndex + property alias currentValue: comboBox.currentValue + property bool enabled: true + signal activated(var currentValue) + + Text { + id: label + height: Style.height + width: Style.widthShort + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + color: root.enabled ? palette.text : palette.mid + font.pointSize: Style.fontSize + } + + ComboBox { + id: comboBox + height: Style.height + width: Style.widthLong + enabled: root.enabled + + displayText: currentText + textRole: "text" + valueRole: "value" + font.pointSize: Style.fontSize + + background: StyleRectangle { anchors.fill: parent } + onActivated: root.activated(currentValue) + } +} diff --git a/examples/multimedia/video/recorder/StyleRectangle.qml b/examples/multimedia/video/recorder/StyleRectangle.qml new file mode 100644 index 0000000..e28cf4a --- /dev/null +++ b/examples/multimedia/video/recorder/StyleRectangle.qml @@ -0,0 +1,11 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick + +Rectangle { + opacity: 0.5 + border.color: "black" + border.width: 1 + radius: 3 +} diff --git a/examples/multimedia/video/recorder/StyleSlider.qml b/examples/multimedia/video/recorder/StyleSlider.qml new file mode 100644 index 0000000..a15304a --- /dev/null +++ b/examples/multimedia/video/recorder/StyleSlider.qml @@ -0,0 +1,35 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls + +Row { + id: root + spacing: Style.intraSpacing + + property alias label: label.text + property alias from: slider.from + property alias to: slider.to + property alias value: slider.value + property bool enabled: true + + signal moved(real currentValue) + + Text { + id: label + width: Style.valueWidth + height: Style.height + horizontalAlignment: Text.AlignRight + verticalAlignment: Text.AlignVCenter + color: root.enabled ? palette.text : palette.mid + } + + Slider { + id: slider + anchors.verticalCenter: label.verticalCenter + width: Style.widthMedium + enabled: root.enabled + onMoved: root.moved(value) + } +} diff --git a/examples/multimedia/video/recorder/VideoSourceSelect.qml b/examples/multimedia/video/recorder/VideoSourceSelect.qml new file mode 100644 index 0000000..7eeed99 --- /dev/null +++ b/examples/multimedia/video/recorder/VideoSourceSelect.qml @@ -0,0 +1,165 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Controls +import QtMultimedia + +Row { + id: root + height: Style.height + property Camera selectedCamera: cameraAvailable ? camera : null + property ScreenCapture selectedScreenCapture: screenAvailable ? screenCapture : null + property WindowCapture selectedWindowCapture: windowAvailable ? windowCapture : null + + property bool sourceAvailable: typeof comboBox.currentValue !== 'undefined' && + comboBox.currentValue.type !== 'toggler' && + videoSourceSwitch.checked + + property bool cameraAvailable: sourceAvailable && comboBox.currentValue.type === 'camera' + property bool screenAvailable: sourceAvailable && comboBox.currentValue.type === 'screen' + property bool windowAvailable: sourceAvailable && comboBox.currentValue.type === 'window' + + Component.onCompleted: { + videoSourceModel.populate() + + for (var i = 0; i < videoSourceModel.count; i++) { + if (videoSourceModel.get(i).value.type !== 'toggler') { + comboBox.currentIndex = i + break + } + } + } + + Camera { + id: camera + active: cameraAvailable + } + + ScreenCapture { + id: screenCapture + active: screenAvailable + } + + WindowCapture { + id: windowCapture + active: windowAvailable + } + + MediaDevices { id: mediaDevices + onVideoInputsChanged: { + + videoSourceModel.populate() + + for (var i = 0; i < videoSourceModel.count; i++) { + if (videoSourceModel.get(i).value.type !== 'toggler') { + comboBox.currentIndex = i + break + } + } + } + } + + Switch { + id: videoSourceSwitch + anchors.verticalCenter: parent.verticalCenter + checked: true + } + + ListModel { + id: videoSourceModel + property var enabledSources: { + 'camera': true, + 'screen': true, + 'window': false + } + + function toggleEnabledSource(type) { + enabledSources[type] = !enabledSources[type] + populate() + } + + function appendItem(text, value) { + append({ text: text, value: value}) + } + + function appendToggler(name, sourceType) { + appendItem((enabledSources[sourceType] ? "- Hide " : "+ Show ") + name, + { type: 'toggler', 'sourceType': sourceType }) + } + + function populate() { + clear() + + appendToggler('Cameras', 'camera') + if (enabledSources['camera']) + for (var camera of mediaDevices.videoInputs) + appendItem(camera.description, { type: 'camera', camera: camera }) + + appendToggler('Screens', 'screen') + if (enabledSources['screen']) + for (var screen of Application.screens) + appendItem(screen.name, { type: 'screen', screen: screen }) + + appendToggler('Windows', 'window') + if (enabledSources['window']) + for (var window of windowCapture.capturableWindows()) + appendItem(window.description, { type: 'window', window: window }) + } + } + + ComboBox { + id: comboBox + width: Style.widthLong + height: Style.height + background: StyleRectangle { anchors.fill: parent } + model: videoSourceModel + displayText: typeof currentValue === 'undefined' || + currentValue.type === 'toggler' ? "Unavailable" : currentText + font.pointSize: Style.fontSize + textRole: "text" + valueRole: "value" + onCurrentValueChanged: { + if (typeof currentValue === 'undefined') + return + if (currentValue.type === 'screen') + screenCapture.screen = currentValue.screen + else if (currentValue.type === 'camera') + camera.cameraDevice = currentValue.camera + else if (currentValue.type === 'window') + windowCapture.window = currentValue.window + else if (currentValue.type === 'toggler') + model.toggleEnabledSource(currentValue.sourceType) + } + + delegate: ItemDelegate { + property bool isToggler: value.type === 'toggler' + text: model[comboBox.textRole] + width: comboBox.width + height: comboBox.height + highlighted: comboBox.highlightedIndex === index && !isToggler + font.italic: isToggler + font.underline: isToggler + font.bold: comboBox.currentIndex === index && !isToggler || + isToggler && comboBox.highlightedIndex === index + palette.text: isToggler ? comboBox.palette.link : comboBox.palette.text + + MouseArea { + anchors.fill: parent + onClicked: { + if (isToggler) + videoSourceModel.toggleEnabledSource(value.sourceType) + else { + comboBox.currentIndex = index + comboBox.popup.close() + } + } + } + + required property var value + required property int index + required property var model + } + + } +} diff --git a/examples/multimedia/video/recorder/android/AndroidManifest.xml b/examples/multimedia/video/recorder/android/AndroidManifest.xml new file mode 100644 index 0000000..ef95fdf --- /dev/null +++ b/examples/multimedia/video/recorder/android/AndroidManifest.xml @@ -0,0 +1,53 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif b/examples/multimedia/video/recorder/doc/images/qml-recorder-control-bar-overview.gif new file mode 100644 index 0000000000000000000000000000000000000000..b02053ea530cc0744ea83663dcbd0487ba109216 GIT binary patch literal 111693 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ët-C_wP>DfFd_4 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

mm8 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 P|Hw)yN`8K1@cMrNbJu`v literal 0 HcmV?d00001 diff --git a/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc b/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc new file mode 100644 index 0000000..74196df --- /dev/null +++ b/examples/multimedia/videographicsitem/doc/src/videographicsitem.qdoc @@ -0,0 +1,20 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example videographicsitem + \title Video Graphics Item Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Streaming video on a graphics scene. + \meta {tag} {widgets} + + \e{Video Graphics Item} demonstrates how to implement a QGraphicsItem that + displays video on a graphics scene using QVideoSink. + + \image video-videographicsitem.png + + \sa {Video Widget Example} + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/videographicsitem/main.cpp b/examples/multimedia/videographicsitem/main.cpp new file mode 100644 index 0000000..725243e --- /dev/null +++ b/examples/multimedia/videographicsitem/main.cpp @@ -0,0 +1,37 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include + +int main(int argc, char **argv) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName("Player Example"); + QCoreApplication::setOrganizationName("QtProject"); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt MultiMedia Player QGraphicsView Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL to open."); + parser.process(app); + + VideoPlayer player; + + if (!parser.positionalArguments().isEmpty() && player.isPlayerAvailable()) { + const QUrl url = QUrl::fromUserInput(parser.positionalArguments().constFirst(), + QDir::currentPath(), QUrl::AssumeLocalFile); + player.load(url); + } + + player.show(); + + return app.exec(); +} diff --git a/examples/multimedia/videographicsitem/videographicsitem.pro b/examples/multimedia/videographicsitem/videographicsitem.pro new file mode 100644 index 0000000..3415ef6 --- /dev/null +++ b/examples/multimedia/videographicsitem/videographicsitem.pro @@ -0,0 +1,14 @@ +TEMPLATE = app +TARGET = videographicsitem + +QT += multimedia multimediawidgets + +HEADERS += videoplayer.h + +SOURCES += main.cpp \ + videoplayer.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/videographicsitem +INSTALLS += target + +QT+=widgets diff --git a/examples/multimedia/videographicsitem/videoplayer.cpp b/examples/multimedia/videographicsitem/videoplayer.cpp new file mode 100644 index 0000000..744a354 --- /dev/null +++ b/examples/multimedia/videographicsitem/videoplayer.cpp @@ -0,0 +1,148 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +VideoPlayer::VideoPlayer(QWidget *parent) : QWidget(parent) +{ + m_mediaPlayer = new QMediaPlayer(this); + const QSize screenGeometry = screen()->availableSize(); + m_videoItem = new QGraphicsVideoItem; + m_videoItem->setSize(QSizeF(screenGeometry.width() / 3, screenGeometry.height() / 2)); + + QGraphicsScene *scene = new QGraphicsScene(this); + QGraphicsView *graphicsView = new QGraphicsView(scene); + + scene->addItem(m_videoItem); + + QSlider *rotateSlider = new QSlider(Qt::Horizontal); + rotateSlider->setToolTip(tr("Rotate Video")); + rotateSlider->setRange(-180, 180); + rotateSlider->setValue(0); + + connect(rotateSlider, &QAbstractSlider::valueChanged, this, &VideoPlayer::rotateVideo); + + QAbstractButton *openButton = new QPushButton(tr("Open...")); + connect(openButton, &QAbstractButton::clicked, this, &VideoPlayer::openFile); + + m_playButton = new QPushButton; + m_playButton->setEnabled(false); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &VideoPlayer::play); + + m_positionSlider = new QSlider(Qt::Horizontal); + m_positionSlider->setRange(0, 0); + + connect(m_positionSlider, &QAbstractSlider::sliderMoved, this, &VideoPlayer::setPosition); + + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + controlLayout->addWidget(openButton); + controlLayout->addWidget(m_playButton); + controlLayout->addWidget(m_positionSlider); + + QBoxLayout *layout = new QVBoxLayout(this); + layout->addWidget(graphicsView); + layout->addWidget(rotateSlider); + layout->addLayout(controlLayout); + + m_mediaPlayer->setVideoOutput(m_videoItem); + connect(m_mediaPlayer, &QMediaPlayer::playbackStateChanged, this, + &VideoPlayer::mediaStateChanged); + connect(m_mediaPlayer, &QMediaPlayer::positionChanged, this, &VideoPlayer::positionChanged); + connect(m_mediaPlayer, &QMediaPlayer::durationChanged, this, &VideoPlayer::durationChanged); +} + +VideoPlayer::~VideoPlayer() { } + +QSize VideoPlayer::sizeHint() const +{ + return (m_videoItem->size() * qreal(3) / qreal(2)).toSize(); +} + +bool VideoPlayer::isPlayerAvailable() const +{ + return m_mediaPlayer->isAvailable(); +} + +void VideoPlayer::openFile() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Movie")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + load(fileDialog.selectedUrls().constFirst()); +} + +void VideoPlayer::load(const QUrl &url) +{ + m_mediaPlayer->setSource(url); + m_playButton->setEnabled(true); +} + +void VideoPlayer::play() +{ + switch (m_mediaPlayer->playbackState()) { + case QMediaPlayer::PlayingState: + m_mediaPlayer->pause(); + break; + default: + m_mediaPlayer->play(); + break; + } +} + +void VideoPlayer::mediaStateChanged(QMediaPlayer::PlaybackState state) +{ + switch (state) { + case QMediaPlayer::PlayingState: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + break; + default: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + break; + } +} + +void VideoPlayer::positionChanged(qint64 position) +{ + m_positionSlider->setValue(position); +} + +void VideoPlayer::durationChanged(qint64 duration) +{ + m_positionSlider->setRange(0, duration); +} + +void VideoPlayer::setPosition(int position) +{ + m_mediaPlayer->setPosition(position); +} + +void VideoPlayer::rotateVideo(int angle) +{ + // rotate around the center of video element + qreal x = m_videoItem->boundingRect().width() / 2.0; + qreal y = m_videoItem->boundingRect().height() / 2.0; + m_videoItem->setTransform(QTransform().translate(x, y).rotate(angle).translate(-x, -y)); +} + +#include "moc_videoplayer.cpp" diff --git a/examples/multimedia/videographicsitem/videoplayer.h b/examples/multimedia/videographicsitem/videoplayer.h new file mode 100644 index 0000000..5cd4d74 --- /dev/null +++ b/examples/multimedia/videographicsitem/videoplayer.h @@ -0,0 +1,47 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOPLAYER_H +#define VIDEOPLAYER_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QSlider; +class QGraphicsVideoItem; +QT_END_NAMESPACE + +class VideoPlayer : public QWidget +{ + Q_OBJECT + +public: + VideoPlayer(QWidget *parent = nullptr); + ~VideoPlayer(); + + void load(const QUrl &url); + bool isPlayerAvailable() const; + + QSize sizeHint() const override; + +public slots: + void openFile(); + void play(); + +private slots: + void mediaStateChanged(QMediaPlayer::PlaybackState state); + void positionChanged(qint64 position); + void durationChanged(qint64 duration); + void setPosition(int position); + void rotateVideo(int angle); + +private: + QMediaPlayer *m_mediaPlayer = nullptr; + QGraphicsVideoItem *m_videoItem = nullptr; + QAbstractButton *m_playButton = nullptr; + QSlider *m_positionSlider = nullptr; +}; + +#endif diff --git a/examples/multimedia/videowidget/CMakeLists.txt b/examples/multimedia/videowidget/CMakeLists.txt new file mode 100644 index 0000000..0bb6196 --- /dev/null +++ b/examples/multimedia/videowidget/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(videowidget LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/videowidget") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +qt_add_executable(videowidget + main.cpp + videoplayer.cpp videoplayer.h +) + +set_target_properties(videowidget PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +qt_add_ios_ffmpeg_libraries(videowidget) + +target_link_libraries(videowidget PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +install(TARGETS videowidget + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/videowidget/doc/images/video-videowidget.png b/examples/multimedia/videowidget/doc/images/video-videowidget.png new file mode 100644 index 0000000000000000000000000000000000000000..a3c7bcb4423c2c68cfe420817186cf15f36a8630 GIT binary patch literal 54199 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 v_6yi53i*y`8i|0Rj=KcQxk()JI literal 0 HcmV?d00001 diff --git a/examples/multimedia/videowidget/doc/src/videowidget.qdoc b/examples/multimedia/videowidget/doc/src/videowidget.qdoc new file mode 100644 index 0000000..65be142 --- /dev/null +++ b/examples/multimedia/videowidget/doc/src/videowidget.qdoc @@ -0,0 +1,18 @@ +// Copyright (C) 2015 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example videowidget + \title Video Widget Example + \ingroup multimedia_examples + \examplecategory {Multimedia} + \brief Implementing a video player widget. + \meta {tag} {widgets,QVideoWidget} + + \e{Video Widget} demonstrates how to implement a simple video player using + QVideoWidget. + + \image video-videowidget.png + + \include examples-run.qdocinc +*/ diff --git a/examples/multimedia/videowidget/main.cpp b/examples/multimedia/videowidget/main.cpp new file mode 100644 index 0000000..a4e2dc4 --- /dev/null +++ b/examples/multimedia/videowidget/main.cpp @@ -0,0 +1,40 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include + +int main(int argc, char *argv[]) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationName("Video Widget Example"); + QCoreApplication::setOrganizationName("QtProject"); + QGuiApplication::setApplicationDisplayName(QCoreApplication::applicationName()); + QCoreApplication::setApplicationVersion(QT_VERSION_STR); + QCommandLineParser parser; + parser.setApplicationDescription("Qt Video Widget Example"); + parser.addHelpOption(); + parser.addVersionOption(); + parser.addPositionalArgument("url", "The URL to open."); + parser.process(app); + + VideoPlayer player; + if (!parser.positionalArguments().isEmpty()) { + const QUrl url = QUrl::fromUserInput(parser.positionalArguments().constFirst(), + QDir::currentPath(), QUrl::AssumeLocalFile); + player.setUrl(url); + } + + const QSize availableGeometry = player.screen()->availableSize(); + player.resize(availableGeometry.width() / 6, availableGeometry.height() / 4); + player.show(); + + return app.exec(); +} diff --git a/examples/multimedia/videowidget/videoplayer.cpp b/examples/multimedia/videowidget/videoplayer.cpp new file mode 100644 index 0000000..1a778d2 --- /dev/null +++ b/examples/multimedia/videowidget/videoplayer.cpp @@ -0,0 +1,137 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include "videoplayer.h" + +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +VideoPlayer::VideoPlayer(QWidget *parent) : QWidget(parent) +{ + m_mediaPlayer = new QMediaPlayer(this); + QVideoWidget *videoWidget = new QVideoWidget; + + QAbstractButton *openButton = new QPushButton(tr("Open...")); + connect(openButton, &QAbstractButton::clicked, this, &VideoPlayer::openFile); + + m_playButton = new QPushButton; + m_playButton->setEnabled(false); + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + + connect(m_playButton, &QAbstractButton::clicked, this, &VideoPlayer::play); + + m_positionSlider = new QSlider(Qt::Horizontal); + m_positionSlider->setRange(0, 0); + + connect(m_positionSlider, &QAbstractSlider::sliderMoved, this, &VideoPlayer::setPosition); + + m_errorLabel = new QLabel; + m_errorLabel->setSizePolicy(QSizePolicy::Preferred, QSizePolicy::Maximum); + + QBoxLayout *controlLayout = new QHBoxLayout; + controlLayout->setContentsMargins(0, 0, 0, 0); + controlLayout->addWidget(openButton); + controlLayout->addWidget(m_playButton); + controlLayout->addWidget(m_positionSlider); + + QBoxLayout *layout = new QVBoxLayout; + layout->addWidget(videoWidget); + layout->addLayout(controlLayout); + layout->addWidget(m_errorLabel); + + setLayout(layout); + + m_mediaPlayer->setVideoOutput(videoWidget); + connect(m_mediaPlayer, &QMediaPlayer::playbackStateChanged, this, + &VideoPlayer::mediaStateChanged); + connect(m_mediaPlayer, &QMediaPlayer::positionChanged, this, &VideoPlayer::positionChanged); + connect(m_mediaPlayer, &QMediaPlayer::durationChanged, this, &VideoPlayer::durationChanged); + connect(m_mediaPlayer, &QMediaPlayer::errorChanged, this, &VideoPlayer::handleError); +} + +VideoPlayer::~VideoPlayer() { } + +void VideoPlayer::openFile() +{ + QFileDialog fileDialog(this); + fileDialog.setAcceptMode(QFileDialog::AcceptOpen); + fileDialog.setWindowTitle(tr("Open Movie")); + fileDialog.setDirectory(QStandardPaths::standardLocations(QStandardPaths::MoviesLocation) + .value(0, QDir::homePath())); + if (fileDialog.exec() == QDialog::Accepted) + setUrl(fileDialog.selectedUrls().constFirst()); +} + +void VideoPlayer::setUrl(const QUrl &url) +{ + m_errorLabel->setText(QString()); + setWindowFilePath(url.isLocalFile() ? url.toLocalFile() : QString()); + m_mediaPlayer->setSource(url); + m_playButton->setEnabled(true); +} + +void VideoPlayer::play() +{ + switch (m_mediaPlayer->playbackState()) { + case QMediaPlayer::PlayingState: + m_mediaPlayer->pause(); + break; + default: + m_mediaPlayer->play(); + break; + } +} + +void VideoPlayer::mediaStateChanged(QMediaPlayer::PlaybackState state) +{ + switch (state) { + case QMediaPlayer::PlayingState: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPause)); + break; + default: + m_playButton->setIcon(style()->standardIcon(QStyle::SP_MediaPlay)); + break; + } +} + +void VideoPlayer::positionChanged(qint64 position) +{ + m_positionSlider->setValue(position); +} + +void VideoPlayer::durationChanged(qint64 duration) +{ + m_positionSlider->setRange(0, duration); +} + +void VideoPlayer::setPosition(int position) +{ + m_mediaPlayer->setPosition(position); +} + +void VideoPlayer::handleError() +{ + if (m_mediaPlayer->error() == QMediaPlayer::NoError) + return; + + m_playButton->setEnabled(false); + const QString errorString = m_mediaPlayer->errorString(); + QString message = "Error: "; + if (errorString.isEmpty()) + message += " #" + QString::number(int(m_mediaPlayer->error())); + else + message += errorString; + m_errorLabel->setText(message); +} + +#include "moc_videoplayer.cpp" diff --git a/examples/multimedia/videowidget/videoplayer.h b/examples/multimedia/videowidget/videoplayer.h new file mode 100644 index 0000000..3657a04 --- /dev/null +++ b/examples/multimedia/videowidget/videoplayer.h @@ -0,0 +1,44 @@ +// Copyright (C) 2017 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#ifndef VIDEOPLAYER_H +#define VIDEOPLAYER_H + +#include +#include + +QT_BEGIN_NAMESPACE +class QAbstractButton; +class QSlider; +class QLabel; +class QUrl; +QT_END_NAMESPACE + +class VideoPlayer : public QWidget +{ + Q_OBJECT +public: + VideoPlayer(QWidget *parent = nullptr); + ~VideoPlayer(); + + void setUrl(const QUrl &url); + +public slots: + void openFile(); + void play(); + +private slots: + void mediaStateChanged(QMediaPlayer::PlaybackState state); + void positionChanged(qint64 position); + void durationChanged(qint64 duration); + void setPosition(int position); + void handleError(); + +private: + QMediaPlayer *m_mediaPlayer; + QAbstractButton *m_playButton; + QSlider *m_positionSlider; + QLabel *m_errorLabel; +}; + +#endif diff --git a/examples/multimedia/videowidget/videowidget.pro b/examples/multimedia/videowidget/videowidget.pro new file mode 100644 index 0000000..56312a0 --- /dev/null +++ b/examples/multimedia/videowidget/videowidget.pro @@ -0,0 +1,16 @@ +TEMPLATE = app +TARGET = videowidget + +QT += multimedia multimediawidgets + +HEADERS = \ + videoplayer.h + +SOURCES = \ + main.cpp \ + videoplayer.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/multimedia/videowidget +INSTALLS += target + +QT+=widgets diff --git a/examples/spatialaudio/CMakeLists.txt b/examples/spatialaudio/CMakeLists.txt new file mode 100644 index 0000000..26b836a --- /dev/null +++ b/examples/spatialaudio/CMakeLists.txt @@ -0,0 +1,4 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +qt_internal_add_example(audiopanning) diff --git a/examples/spatialaudio/audiopanning/CMakeLists.txt b/examples/spatialaudio/audiopanning/CMakeLists.txt new file mode 100644 index 0000000..302292a --- /dev/null +++ b/examples/spatialaudio/audiopanning/CMakeLists.txt @@ -0,0 +1,38 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(audiodecoder LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/spatialaudio/audiopanning") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui SpatialAudio Widgets) + +qt_add_executable(audiopanning + main.cpp +) + +qt_add_ios_ffmpeg_libraries(audiopanning) + +set_target_properties(audiopanning PROPERTIES + WIN32_EXECUTABLE FALSE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(audiopanning PUBLIC + Qt::Core + Qt::SpatialAudio + Qt::Widgets +) + +install(TARGETS audiopanning + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/spatialaudio/audiopanning/audiopanning.pro b/examples/spatialaudio/audiopanning/audiopanning.pro new file mode 100644 index 0000000..3b1cce6 --- /dev/null +++ b/examples/spatialaudio/audiopanning/audiopanning.pro @@ -0,0 +1,9 @@ +TEMPLATE = app +TARGET = audiopanning + +QT += multimedia widgets spatialaudio + +SOURCES = main.cpp + +target.path = $$[QT_INSTALL_EXAMPLES]/spatialaudio/audiopanning +INSTALLS += target diff --git a/examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png b/examples/spatialaudio/audiopanning/doc/images/audiopanning-example.png new file mode 100644 index 0000000000000000000000000000000000000000..45c53975d0525a12db285ba0674d53040dd86b8a GIT binary patch literal 171760 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�>eABoX-HT;Ku)fbr zFZ?m2{fc|X!R!5xm3@%6sWP-Ag39xu z!$1gqRsg-B=R?WNV|;1M$DAoR>SNq(He>S1@JpFyqP2ahrUJ=bsSq^&l%@$yHm1;p z^OHU=M0cfn27~iLix#A`E%+!ke(Usl8dY4zxqnSNj&e7r?EMb`L4n|A`1!Wb1#Mc&wgqu4n!6r1&aF1!)S-P#LGPFcj)&If z1gEH^HAy3BQtE$7`11wQ^b#3#L#T;o41c-HO$n}5mfolDjp)~A5!p{_Pdk)-#JnTR zR7;L$439kph~XLSIxOsXc5W@Mlxbw$OofZ}p^A{B{Eyi=Ba1V(vmgy#Ddpm@XA->9 zqk^c!B%J45+%A*X;Bi*T-IO$gTUx=m79TuU^0Vu-noV$%Y4hnW0#;$ZXjRwIe#bf4 zSMjI2YW;h)Y6i)%9#h?hsgH+Y=8dBmp zAzaDz@cn{^o>8je6YL(^UZQSVy@-M-v0Dv@oXv?2F%TBpJ2NM=>5?UBhddu(6gfFo?B6Tj$1}MQzU9Hy6)t)T`ZgA*iS=3 zU5foPB(#kt*`-xYit~Uv0e9H3L8)||gp4Eb2U)ADL4ri2%_rJKCvGtf0=vd#5Q@mu zc1N|Ug2cEjq3B{)HLToN!k1@`86Agjn>v9m0P~|c1^}@Ag1NG8HHnx1pW2QEmuyOj zwfDppO8PB5q6C=~0?zb&TstbkIokc%?Y4(+!$1Y8fnAp)jZH3wLHNY#a4?ekD2!r_W~vOXRm;k8`9d|4Qh z^R$i}_17?Mw+6Xb0)z}`P~7|jm8gnK4RF#QCc~E>nyze-lN}OgCc_-uinrwNp_iGM zvQHSAGSR&P)Lug8NrG>a5!{U0ARGPqf&nToU+^&}BqDkz91=(=ZceE6RG{rMr9t+- zJke+Abji)0|%JS-32DSKhtGP&xSybd&ZC{F4bIpd)j$+8g5paFgFmjZZNPp${m zT6Vu))qBvDu`!dt^f{ue1gcCp&d$%YFn``{v$!fXY>E`n7#?IFX?S zZ}f%jjlJn=9=>K%_)N9gWp^R`lJ0@z%-5s)AE=dLqz-?wWf!2zRoX{s<);M#-+V67 z9CFG$e(sTPU)nrDC-xg=kJ_aXck36T_6ZgNx8R?AcjdqH-Q5)SXF<|@F{C}*v5XvineH1D-l?HLS_k$kIrq#kxJ08`+@80i*`!$9f!DYZuscVAFbx1w3UvN{#1XpoiAn>80Jb=gK;cr#~QW)sTw>)WF#dpmOopAYnYl|@e< zdpk|x;oO|I{?K9ap=4p*fyu?1HRrCK%JuC}dtht1ex~^9ndPc^zSiP9VhQ|1@PRbg zT|dk;WPOq#-yT=#XantAMMYhrBQyzwiP@0BGGV4qzH)-}`-|SkBwu#P+b$0m+aP#< zEh+WDTts*}#C+$AEz9J^<^4=eMLJl^V;bj`W=)o$m=$RwgOgD!|WKX#;tgvp05a`3V2y2v5*(FCbPu)50Tr{ z4Rz1#NITMapD8oWkZArTpM2FM>oYVr3?w%_EABM)E+=rGO$~=f6h=_<4N(J)5w$K) z{9h*psztS&2mE`ZT(!9uwkx96m^wYqXlL~WcqH!*WeARrJt|DHsT8cJ8p>bZO_I27 zZuZQxr~v;8iOwK65O;=7+zA@KIpn(Jj>a_WIu}-Wg~Jc(O2-#Uh13w2zdq4Sbt=52 zk1vm^X|ILY&>LhEcSB4F?ftlE_6>ed{BQo1_&<+1aFgHFzsKePbeyKaeEigDK70|e z0joDP>0OD)8_inL5|IiSWAiB~6dD?PEKhkxBX_peOnfM`sY2&vBgoFj_tS4UBZ{oz2e#xMHR`<@#DE> zo>NqgnqyN#L;{!tNH(%RB5Xm@_-#uBWi{0<<=n3#j_cY>Y`^haN^!Rf>@Q}bQR1%S zpFAJ<5FD$P7&H(nqBbrEC^eMHWQT7+I$dL^y1wVu)wG)P+vKGGL9x|oTsNx4!s*2W z5isb`Sel$Ar}Sqz)$&vlf>TMt^ReYBB1vpWIhCgl*S{;0c#n?Q3!hHdo8PX|ju-JB zyG`tJPkY?Lv&2N<*DWU#oFlwb)>OSBStmthALO|X&lP_gKxYre)Rhqev|8fod+tNI zTtteHapGjw@fRm^D>)h?Sa$m(%wa4x*SdNw(9dk^otw+Xe62t4N(9B{-nIbv*YSWr zr&+id^lFk}v%KNWchNUPxUKxcQ@i}U=SATFe^k?8B25A7%!IAiH>p0)P{n9)Jm7g# z?f3G^UqtJ+)iD^YviAnCoY%P$gN``9+uGvK=uzu|R&FVYYvxlag}hniRaZM84NmJJS8AqQ_>{zx18*+llw`8 zp$9g~vBS#Ae(z>e)`N4WXKHmDe6{g{sBI>~NahvB2wy8S9M=geQ3F)hRtDcMPHPE@ z8P@ZvPpsn6zH8_xo=H*)t9Na1_kxG|1om9N(*pqGl;Bj^w&h-EKX6PneE+&wK9}FC z=bE!hNYpheblT#3*w1ot8*27e&VquV73H(0U5(MXM-Msj?Fp4>&RD!QO5kdC(tFgo zhNq*HmG?$tIc9!bcCU%R5=Y;CqyxK~H>v?kw9SO+sF!ckL|^8*OS&0*aEsvQ@3uf1 z4F$J4Vw#n$DPQ+licha6Y?NPYslQJ7P3HDEmVi?K=|zKtG2=?Ar)PSNeoSbgveb1Q zhHwR+T6U%)_WP3DH$<`KtNja94Fp0=^Ze4yLZ|r*6E0Rq^$*=pKh|mn0NrC|chV

c7g^Y_SdymHDKubd(^#w({TMB1?C>NIlJV!ozP%=U@ezRCC5 zQ#8{&&&JIKk9{Bmfq58o&8g{8)u`|LV<3sL!3&%Pn$<~7X1!Dgsi}bWAo+Yp;`vF_ZLm}yE z6D?flLr}>F6ja*iI_K~g<>3L8z4X|35B|w>2VcPTQ&btthC0l2AI#^;5=9#N>PqE+ zQ|ffqNcxqJ$I8v(Cui0|89++xpwJaz()D;trdjPeyBWi-;PVRgmgduI9p0BlJGr56 z*4RM^pZ)9)feJy7a7e0|?=ee&tm$vz)Q?Mz!9lCY4|`?pp<7Kf$1s7VTrLBhV6#_> z{}}nek9GG9;ts#h40d)JBhg8P@hiFAU5AZ>a{p4eThN`{PdideU3>4LuCL(D?as+f zl}G~l!X!t}P^Rj`uovOy8*m=WQ68b7+qis;u>><|=)-r6GAA|0YeEL6ucTw|>HOsf zFqSmUQTqQ)EamxLnd|q@5L_kvz*XYuUIDZO%}ceK-Bye{vTpVDkhH^$gIDk!Ui9v? zHEJ2%44in4OFS_%(KCHN0y@WH?8l`javQD|w4TX@N=|NLU+1`4C^(Nf;5(>q05jmz zt#R6QGXA0S`Uw;@O~JM}ZYDuUel}^xs%X#u|G+j=?`=PrjEq>_C=vi5z41 zm^Q@|t-Rl5{zv@+aM}of>;#OUvt9+2p$_?IK)sv__z@nITi@G)mpcDRwS+M`}yD_M;*6^H_HKF#-U+!{=j^x z;s?^2M?H3n_KY=u6LkLbf4_Xn&i}-sFXa+oge{yo3{elf1Oom0??|~!$^|pLh0wjq zx_AtHB>r#Sxw8KTd_3~bNun_fo_p5SC(m(i8K@m?=6@>vK_yuHHCYH%c|xzEi;hU0Raqbfj(jj|X49$N17s%nhJNHh|89 zF=dPHKz`cx4TX<3nr&l?DUoEGb-b~V5m&eU0WRiH(?{5!?%_O`_@YP40xc4FTal_h z75g8Kxvoq>XvPC!IqU_7f*F5nH^Tk|&x36gNPH~(MsHaDhdvsVgU4PIpt3j=2fz(q z$<3ic$y|1p2LUTe5_!R0clg!r`tppYS6Xzg#M+x%%dT@MO%%S!6kgw4F%G9PeA6nKl^xsf6i$x@`^2@J55!xSBYDui^@p|H=tK zGw!eYToJk_a?|6GK$ZOt4y=uGzhSe+Z~M`&PaI$R?J>PXc+49zm?>p~!88WFFZHyD z8jn}}N#twQ$*$DbwA6HmCxQaj;p=$buFg>eqCGjS=84TSMzHI8^FI|{X`X$~Lia0k z{f}{X%}A^2EH+5ovb0Heu@m<{+(aIv)j#q4#UsX@D+0w}Bme3gnFGs2G+pOg_~+xP zu64_FT=)v>fvV5wvWBxeltIBvBc3lkq(eW!>>f2c{fz$-80wnI&x6FIt*MrLLQ<92 z{SYwKy}R5c@3(zst_%HBeW7G1`$I6aZic9Uqo zXv@QnQAv>TZ66Q*JF%OER#?c5lLSk7-?lHjOWnooK8aSKT49wUUx2} zbAEg&!LAjEq$K(eM$QWFrm>muW zN|4c;2IlPeXzBI;zUCbXemLT1HiMbnetbc`5k8K_wt@+~PaV8c_3r);%;ExxA(0O0 zS-Y2k8hBWXzyX(j=bUCE9k&I>lmQL4vP@NawE(dx(B zswO(*7$oPByNj<;C8?yn^2c$wq?$uOA_EO=JD0deqB}D|XvhEqII-}E_f18*^u4KM zXEgjO&|ZpZuI|(*S&7NM&N~dSPR82#ItBYi(|dc@>N*mEUkZR#oPKy+n0z$$r&9Q+ z^aCG3jQAOAsIQgo`X>!K^_)lFOX;Bg6z2)Y-x9|up!XvblD-)AjsEHuIf3T zx?0NSir7A4$p8B6{{1CJ|4fLUD`IoNEKkTV0W{?)g;{E>70(F0;s_%dzz2T%NpCo> zZ87Wav0Wsj=)4ogWByN1-Y7ZG4UKzn*&yLw|HOqfT^XuNx4iw)I37CfooSKG&BW6gUks2(gaa>d3jVkrb z!4jWAoDIVD)P>Xg=^oLE_n^8W@1YNp?5$GtljiNx6!vO)2G?5lFv8kK6Bx%;(_kCg z``4?f#^g_y1HQKI+Kt<`@r8WBDzOop=fdAYniQHKjj0|s&a;jG!}P{^@}%K~&R{u& zs03q5paz<+g=lbzx7BjKJ!<(#&YF;dSP8U)_Z@7M{Jiut(Q{?D#vc7V>_1(2kAU7_w_)^tGDdSPvL;|3Scar8l^ofX2B7Y4zPxu1(0ssFN7u zx%1YHVpA#(`ye^@$%m3#GyEnWU7d_dTS#UZm>rEG)Ko9p;fyb^^ zq}*8Nk8_-p%nKpxO_g`8{7^E;MqStVyY(9m9giFnliW7Ju)R5bFmSh96h$3Mf0ARe zaGPkas50(K^(6;2dw?|w)L^&cYJ7l@x1C7MYKr}zrA3X#8hyPsvKn1=P;@~vJB z8X~q7OD~h9f0$6nx+_23e_r>7d^t~WbNcO?KHO^&GlE2XXE*UDB{=w3USkB0CnCR= zVgBVa2rj>NBR8-1a_*8Y6%@Bd#dwW~5xa-0wg+5t;mcUIK%4o*K(-&B+F5;bfvdAk z4=a9MnqESe$dk8Z#N9YDRDCbZGIt4gy;-hd(s`f*Smig4fsw^5Zh}TwxV&{&cbopK z)kMQVH-PdtP?v{Y{KqsU-)!MifjZ<={Uy@N~wImAhyv zG{xa|@?rnkJ9z6|d}NHeWtkWjcnifc0|PkeZU!~H3u?PK6g5}Xcx2zrFS_=USuFCA ze!L`l=a$CK9d|ppeU}M{hWpo}H+!uyqcxpUU$yGc8?YtC-2zlkc19TL_;r6e^634` zmK4RaC6^2^dU~mwJUnfDNYI4sF*p3Re0~)-b5hr^m#`FAQh0fv>CZ%8j)l)n#l zN7yrx#1fp*R0}NXr%Nx^@b?V-INx~ts4lV#IzbdGiHv*tVI(aG&@D77#6 z`O{&Kry?Yo{O?X2sUn6UQN%yFJNZjKsIRg_&Pq{9?bN3Hj7ZuFzwZq93CHL$-^}i1 zhbY7Q)=Vem8@I`K0Rd+uN)-ba_;n}xbtW2Ld)yqdaz}oJo0)OMnFSp$jYcW^s>!`F zCwzkUH#r^qo4ijDnX<3byUz1@Q<^a>`ZhQA%K3g_d-__x(GVLJO(J*EM#W?Ae0YZ2 zUag~B`oZ$U$+$dFBHDc^^P5(^R>sakcPi_|Oc!I`jXCTMg+~&BQyOA{_bA@O6YX*S zwxCD^^jB%g+|1jmzpbf!`ZN5wyh*&d%iaNhTb-Pbtxjj(oHd{tqWb&J8AjUPM(4iP z0RXa!Ir^<+(?}i}J=A{fe-C`n>A8ss?7rbF25s) zW!?V)u~c+-8@S*Nx=Tu+3-p^iT8rRmb_ky@&3wG!_FDGFQ?2z+53>fgFiyUdhrh1E zs-*3hBhPqkUn5m&cbXN^(!75bl5hV*epLI4$r29KRGw}kTwx=s&wZ^HN=7}nh7rFTvCez36Fi-NqBE92 zHiL%`zMY&>qXVU04*zRu!)!#3kp6{F=|_i=5YIm@I%D_8JGX(0PUim~7hOAJ2p?j_ zo6m=}8xUdP+P1y178@Vq_v;HLz5A`QNzu^bQFgY>8Ed5sRef+WTbOXkn>c9b9QwYS zEveH5*-~G_h*N%LOHCbKgL>okV6~ukL~+zRl9h0kqN!AzRugf^r1~ zMpqvD{iU4jA4AqEttuL+avkQauCtxGihf9@zXD1Zq?*wBh3~gnT3 zFd}%&&xxBPa3ME}as`Da)OJ0VQ4B;`Xx2A^W)hR9IUj;OBm4T9Wr++`pl@G%EpW9{ z?$}GWP|qW&YwRTuJCG3>Kv#X-4_d0aMZ0wQ23GNyFsT&Dvvw}b=cplM7xT(rsY#9d zN=HLRxEz^mGOm%N7}(mNGdDX`p9h;sA=J|U!y-<>98%zCJC1zy?An77_cgQE!WXqJ=FAB;nHu*`M#3og~DA+t8`0Fa#@>r z48b5wIExetuUZ-1A0ACK`g~^%??xGHDWMsjmPNH#Iuvqs`h5BVb_pR`FN8SaK3eX6 zab?}0RnQt3N_Q7aySz=jj^OLTPm=*lefO5h+js>`uLVnFj19`DX{5eJCb)6yslE7!r6fdmTV@*9+r{!ZtZ3(!?A1AI;TiyQ8z_k2b- zic2n8xpc+*;Gg6INN-PaC9>?1m}G~Wwq03R5N0``@LZv2IoxskxC`(ty{}^9@4(&0 z$$hhQCU2m6!TNB}uwyJ_0w-_&!)qZ0{srD#nm>aLea%{DTDpNF%C&^SiiG+)wR9*V zxcGd2R_M_g&3WqNep~@)^kk@FJ?kNaeBT{2815!{46!JdGQ)Bs#?HZ5|H;kTP9_1% z!mY@KGp*H2lUnNX^o6d5x%Km1HZf@GGXdm<-{u7ql4{Sm~LOnfr02T^J z>4ybJa@`3%0n=l^o`7Lo<1^bSN91baVB?8L!bC&2`gF#9B6o(K#i|SMgVgYwK=7|0 zJHWE54Dv6DFRJsHfBe|w=*rhQdfgx|Z$;e3a1L0+23e|_>b_)|<40oK1W(-z5}piM zH`v@O>UAQwq@Vl=gL%+W>}zO0F`PHN8&c3EQC#vXq}!IHJPW?sF{av($tB20 z`Dl+77?6QxA^!?1JdIj9`s}8Qks2U>wJ{sd62ZhP| z=7F&~N7g9?*Fzet`?mpIsu#mxq0>WwDY2NiYEu$k+c!Vtb&kF-ZgZd)SseNinFBop zI!;g8AP^cb77F-o)&NXh*_ONISG`$vxbI;14Y7dt-?hB;U&>qB%dvcsHHLQz^?U-p zR=_SBU2_d?BXI|sYe^kT3C0a@Nz#egcU+xXO+MVqpUeH4`_O~^ynF4^{>V}hQweaf z^pvIU9$5g(y(UX=c!JW4RImb~&n|GWpHU|}1ruK-LtUs^6Gu@5Gqf$1{`e5zi5S)i3eJAt_|xO$JhW-JNcV!dQ2G!I~^G7y$+3GWWV@Sdu4sLRkR6%TnEyPL=_ zVu^}eYNrYevhUG$`iDQbPG3W#{hMPn)x5DQ&0}M&F+mbKP>uVMGq#+QL|Fxboar`( z9Y;3~cBApODimJLIYv>nbw`c)vR@sV#MOq>00+Dqd8DBVRodiyN#?F;KhK>M<~VXk zo~;By=#R`iS4)uVIb*~JKZqY8)4J-@UsEutD*@qGo@qk^)leTN>)xj4;bt+vR4iV9 zuEaJFrKe{mQQ32s{M8;FeWjF%G{4|gCi^3UnH`A{=MhbK;dOgRB!==(`whoi3Rhvj zl|w|<_f~N`kr^s+;^?X&qbZ!7&Bu=(v!A0Y=WCi3V92;8S&fwQUKX?`huA2tFJB&H zlAbEIaY{$J@5f;T7li0vJwsFW)^0N4#?CeU-U@Ct>DV>MGM^3ch2#Dtkkg*xd` zhBbw#)|WZmn2dmGa7YY}9zjZ-A9ra0oC%LS1QNQUffQW1 zgklx1q;aJW_Buw!h#a5w<81~vhk#2=zsa7jmU1yl zG#Rkl@y5PRWIOV10IAXNr9)uG>K`zZwT{ZRLOZFKDY)xH+$!W;OQM(vLTN6@50wv8 zXeJ{|ET{X}9;drzF7R3Nr#v2=ixe6c5Fve3RpP$UpE10mGrt@A#TBd)Nr~0iHgme5 zrC}Ch09o@CDisBoH@8tN=9`Fc)pm>T3VP^=HErK!t*Ar5r9y_`&2C4>g3;a)Pmm_M z46Ip&ZJ(UL?#ygmA6g|&yB;2TS>K?dnC2WS#i3)cCkKaIMXZn^V6%-TK@(P9>H5%3 z&Hu=GY4I>R-k0bH|1*JBe%T{`{`Q?}kp%CoA5i0<9B+=;pqCz(_(p(O=xXZ&g1n22 zN%Mz@(Z`&y{SRN9I?c%_&?Yq#rdMFw&8pl7E9Z&}tU%HnR7dJICE1M5d4C98j77LS zB7>s0dMjP2uF}dzDAR;LF#j4Q9{&7_M`-nW04sVVi?ywailKiQZ?3%1q`bR10bl)# z$LTh6N9BP-$yeRM)BVZU_W_qE7(x8VcKq^=rVlx|vd zzgj7AxZTEZaIkcU3~j`BavA3`;qJ4`KmuG4I*aE}m$-jzTWsm1S%R>&Veme`^7=0Z^;;#t0rt|CKynyWl>HC;4CA=L$PG8>R!Jm#0Oc@!-L+>+CC1oNCqW{D2s|Jhj9&Hql z6bpJvHgmJ*Tpll3%DVt=yxli8A{wrWWaU=LFrU3w9KB^|!oIEmN$fU8xW+ppc%mrH zzEX)VwVco{(`!!ZS6e7h>Z%>iObHTuUJCZO{?7ug!Yxrm&ipj8J$Dd^v%BdlYd^FM z;OtCd%0~g=ATeG$-AIt`)x7=q98ipMxz&&-@pfIcv8RltIcMD9->+~kYQ5%Ma$#*V zLqaY%@p)pdwKGZp7TvxNo?mLgu>0yZ#cfrFwRh)U#J!MfIdu&IZ0W-3)HNeN7pmC> z293S{Kfb;@p6b5;-wH)WDr6;PT(TmYqZCO|6v=jsWbb*-A(a`4jEvJT5}9#qGLAj6 zIXL#_IK~-{!|!vtuIs+9`}_UgzkfU)9uIZS=kp$~^&CRD0ij*SgR4~&!-XUE)^$aU zXJV~B`0T4hK6$kb2+&orJ1Q93XROo()?!0uBp2E5+6Pg183=R*q{mfyZw_DZX1iEn zvSWC##c_hA?vg9lBtU`4w674&NGKVekJojjs_dB23VqL1@0Fl%Hb-d_aj7zIE^E!g z8Rj0=)T3NBRd0IbRpUrV7-lWqX-T8yIpuGz?%dfPbw~qKJh+pWg zMHzzbBg2l*yKboh!VdgLJ5tAcPh_L`c0pvN5^f<<55_(;^ou~^swA7hAQht z`~rRWFl(Kyk+O2jbbabO0947YxX`{C{w3Btjmr<#v3qoW1g-9tvnf;m3`vM-_RCn$ z9y;(94}XsICkwck0J=IM8hzF=oMwcc>I%hP%^HL)&&+(|HRo$W5G5B}}n z4!h3|{tPTNqs-@m=VR84liD5D4cyi?=6i%?k*9>r9BnV$&{mA{lArU)>>MA!6HDfW zT8xxDPT%1^eUIEJf-d-`h7`9GE5A}|Z?U^EPO(E~qC2m}JrmskaISc_0Ge&Iwr)ap65wV|T5R%3XE+wH{hF*U*i0@I-br}abH-vahOxv~w(07^ zLCekr1V4pHHD6X9Y2@O0aszMVg#-GAYacrN)iWCsHcanViURecc2h z3VJs?Eq+twG>W4ey0fVjvxtg5SGJ)6r_b1tCQ&S*llHh@-V$kGotlxMjjpVr zE;I9xMLMj~M=bW1-7-!0p7yJ+ldy3?q6K}Y9i;5x)~^-yO;>-RjB43ZMCfAG=Fc>% zq3fFc2}vpo^Un*hpp=<+;@W{W!3XYhvXUS(>)dG9h+b6C9(?V1Vy);Bau>JyDCkt^ zD&tFmlU_ui=X+(4U3#l~{=>}}k4DPGbFk)4ySp3ej#D!H0aBVh51aJ6Gxd7SDhemMCVlmCs}oCa#M`OjB$> zbGAAj6d?-6&ur_IT%O!{hCUr0)_Uw2>A~{UAdcHYwjhDV?ImYw6#$%H`1IcUskuPu`*}0vsGDD*wS|f1`AJ#N&7g9#j-ZFr zr!UCP1(SMBvbX&JvjQgF(Vq0Q)lA{cw9`c8GJzk%S5X?v z0EqKitn^Xw^94U-J>mKMNJKy)xD8P9K=P0edVym^IQck@Qmcb6hG4i7Hi6de=A*T3 zZ8HDAG-rq5e{!N7eJ@uhaaqm*XpGaa_oK_Z@jraaxxuHn$*ooN+3|DiSULMYHD>{( zSGQ^AG`3l}6v*68{Ow!Ko_&A0cb7Cr9?-&gV{9Mj*|V1(Nq=swM^N0#nc{X$BxU5o z?9cm_*nr&Hi?5U=^(uD+h%MYT@4A9aN;Xw@v1g0?a0Q2$kh*tsA_y?SBGx!h(G|O; zUQOaM{p^I<1bV3qxf*@%uD*wB#rW{E43y$0@X(~IueeYmY5@m6ht)rAPVO6kY8npm z8=mWy5lfgseENsDu1<)4uw_nUngxs9ZknHBIs}_#8Kw4}Hv`h8j&6^G?tQ5cnR=6L z5{K9!eC55lJmj8#O}KS_u;9#grsoTM*8OY>y8no+{YguYUw*0cui_JS6z*B@i^ua& z6@_Kym3CW@a@=O2{GYRsLtnV)P_KfR<~Uu(3=mE*i&pbsz7^Mgv< zsA#+Hk_FcW0{RUC(8R6jzgOm))XYdmyzVFm7a%$ z%qI`6aJyariugs1#QhjjSYNF%s|%*}<4`GggI!mb*ViX*LPr$0X=@Wm!>ONtFe+Rg zxpENJdes91sZ@GTo-1?JTl7jl3=RaHlL9hoB7jj%;8`;oQ{48L=zJ?N9!UO@_TKgB z+A@l{RZ;kFH8sHyhB+-G*9+pWIoC){wEL(%#m`65XVg>F4U~y8o|`V0S9Y(c1d z!_&rhj=3KCQ4%cnTN!#831cEIf0$Dg10zFZUdX(xACf-{3B3}$d$|IBvCY;0Li*~m zY|e*VUnA4s1G=#XbbD?_S<3G($c%t;(HsDo7g-}%*0lHLCMSu_3IcKdQ6kl*1q~Lq zO;9E&nmd1xYDu9rei{1H{{M&2;2jW(wl@W2Ui?-W4iaRM6VM6A+|vp*<2@636?zUN zK*_3peU=f4mv+J2$ zraLk1xNGZ=){YvBOoE<#zx4z?Ys!K3!tQV9d$MwZx( zAmdkub5H{k_=Bf= z999o$U|Q<(*zfnem7-TyR0h3wQ29{I#f(b_tqoU&DBk$6pSmgpDD(#RcR6sT{S83j zSPZPI-Q21CZOFWE{q=uQRF=Wc>q{t?IYwZC-ecv1!gHAbquojm;ID1;i+0)TG#Deq zkes^u@prBPJ-TA-SKh7%5?3mWua%nF1n&T9a4e)tcbtwV(S!<&tga2;DSP3!7fE_g zaona8Z$!sQDBWWMfKU@W&Jsx&EKa!{!>$=8aVcrzIcnjPWpseqAo4P@zKdeChWhz* z!e?0p9iT{<2^$4ABQX3BHUUWSlQ6e}GsRCoCR4nA!?Y!d8y!i)NWB2x0R@>F2!&_R zN=iOT+;WTyThm$lp)Isuf1U&JW8zJYNgT7R1|VC-4tYC1<0z}cg4qeSqpLcu9iU&F z>i76!vr}SQl2=TLWV|%oZk0;P(*!r!vILQ3x4aRPcspU#@ne9}W&poAY)Vn$W1^my z$lu=k$->jJxvfL~@%CaNvfuvQqIiO;BgBqiv*)~xBqRunbv0DJEq>L=2CKbs1mQRLmQAp5Iwi!wI|qQkqmKJ zEY=<&ky7PtsAn}&IAFk3hNSK3!7W|9tousfXgeGc_9p#s{g(ozL;b-rs|GEere<|* z6X9vt7*lFjkYomY`UYvRxQ8*TE-5d7#VZM;cZLjA+62~W!nScfXwB<`FukVzrP*-~ zFlj|18&~6LmBzywaUJF=mvYDKm3@Ye4+vWCpp36zALHe04 zJ*?wz?S^`O5(cE~{2T^Oi=r+0KJqZtOC>=##Ca#ZKb$4s<9D)43)^I=8{_mxp{6VH zCf|CrUpS^rT%|#bE6HXDhR1@g-X_D>0&?1xTuX-CSiTOmjXGnOv>MhZ4HSt`D*iB@ zMF7fQcl(8h<|Xe{1WD#x?5&snHUgy%;_2OAmZKs6f+|h+8a(Ib^?DtgW1afxUEh<; zsGBhyf20L}`VlSqg_^$evYVMQkiQ$>K_8a@jhKMlt3c&4fo7c}wGA!Q5qIT;>?(qj zM8gmFyL=R0ay9dG08UQRviY4_&(m$vxzW@8)>@gCD!SbZskgfw`$~4lGAMjCoeJr) zx9gXX%u{migt4n0vOljaLg|AH&ww{I=rUAY&hzB3zdWV1JGpAya4_t|29^h$SO-xX zP8+2D9S#xE<%Mk^HkS8XEgmczy^dPa)AiEVWS4)UKoKNg&{r{{XPy?X$~wPFFaoJ z#LStTE6;wql*e(2_afzHapzScJ6GC!z{@Hm;I>|Ehj}z^Z<`}1b2`F?JUIS`PI78D_HT04^!m;n0owSQ( zQFdm;5M@?(J$S4U3YZ$Oum;c2j$Uky;f2~E-`5g*++4f*Og{%<7jG$^-i8yq9ekBE zNxTxf&~;OE^>()zeZ6#2Y1*gE3gg5#eN#G3?H=|tt9(eirTz_Py}q0{|M~*$v*Y3$ zz3KtvbxU+6ex0QTzaBLA@iK$(K8mdfwb zYhCD@VjM2-7p(u-zUtveD_E8%)=&6^q!0!@681aKpCJ8xMtJazb$xn!!?i>4lIv_j!gHI z@{Nn8FTL?;9)cx~+dy)TMaf;Z0%f-^7{C8>i6hyhr<*(uni2O_R!L2yM|?JaxTddP za$Yz|yxWi$7nkWW*LkPx&GBAY-k|e!9cb_(>O6vIBh@)Rk*VT98p*CJN?4%!pUBt4w zHKH_vhbAg%mskMh*7T2=8@KAT~GJ{@KsP### zTuIDy&k1$rrKN`l4(HNB%NqjCo2Jirk&e9I@~16ORo}nDvTzd#fjghx&UlhcI5Oei z3R+(pslHQ$Sb`O}Jv@dOSE7_M?>AkR`&U7}fzDcW=~ zdFj^y)!OvCe3D;5EhI*B#v<>^XFHy<@fp_y>pEB?lk}U6vs?cGmh;d6z2;=MKEb8S zvC8(y5qqaSA1PRwK5)f0U*_;+wz)ImTm`+^q3~k%(SnW;a;rl5ZPa}oLFpn!MY*mG zF_}TvoHHgBYqJ0=bU0B6uF-VpQ4?yBL_#{ zrT{ths1WSSk}!{`VSfAAsUMR;93b?V(S`in?z5)WHZw`o6BP$0LnMkXs0$M{@2}7@ zqcz*s7@04+FwvG1L7$^Z9bfcSc^`ggU+<6x4ek&G|AnTD7()B!sUZ_jz0Iku{B-Ag zl;VPhD12|>y`*~LtoZ8H+*p9gYseZD5I@~e3(%1_61{&vO-j5!t_(hfQ(X>H9XIOo z;k#+CguTm_tDr*HJ8MP$(p-^)&l!XQ{&zzxx5^Ocdcto#9d5>z=r=NENTG_li*59e zGe29M2ZN(T92LK4nBOT`3|qUFF0+2s@;3~iTL{o)2e_~2d9btO(_h@z!w$vDCWAGCD?NZX>K3DEf8S;>ZkSeQXCKSA;?t%w?NNq-O(#l^ zC#=g@LW_VIi{Yq$%xF%5ANaucOOwV(sK0CDZ>nbJ&Bn2xV@-CoHfGkiu_!rNZhrP> zS4#z(5ZY%a3^z(%(}&(cQ1hTA=kxxgHdLIW+Y2zdql^}884DT}SmRk-hYueA1=hPO z@Q2*ef1>rE5Wk(j(0as%>(fVa1`#(H3!*5j)if>P!gmXixxaR@2P3+HM%~!24v~SQ z%8I16>*ZSiG>!nMJKV`!4z{>4uI5fT2hD|$lx(?4<{w@Uct5PPIA$r9wQ&1$r~IYO z@m(;aO$l*ArXumeXxEu%lQM@71h}_EB&BMl$+>cn9jnxF+iJisS@$IcuSez-<){Hv zT>w@Y{8r)xpfZ(~MpEAZzVEDR@+|%MU9eJdFBR1onTrdIL<9fcXHg$b9Py_bqkvKK*TjM?p5H0Rrz%gspiUyw8Q?Ti1#K zU$Tzh=@)QmaZ{6lO9+V1uHw!G1)l~j-?5EZorN42lD~_uj@^b!FA|t6?Zjif2Ie!? zat&kqo%FManlWEiWZ4Zrm%e?ZmkluCItq4lmf!qO2gu5t-*&9fvHzet6w9znA4zMO z#Bep+hLm%WO8J+xDwlOQPFPPW!(`@O4$iTnB+Ox8uJcmu zhDXoa#kW?AXN)E7&d<#oEHZ88&$gdyy09aj0Xj*H^tv3UcSZ6N2%0ticEwN~=RB-$ zAgTQ3N8-f%2e$b{N8~>@{_mUaHvvc*;Cy)D0F3Nr$V~u=_bUCh*XysRu(y8OGB#5i z`d*t(*0)duuPx}SCSRK^5$l8fhT>KFiS~xRzAe@J&^vt}Xx>U~okAJwGb%I)w(MPo z9w-BrE)(EjcCCGi#QMKK?l<7PQB^49n1Y*eiEHwDAUNl!Bz-GrQfN>fjhCZ$_Ne`*Ohc5YW#!kh{xG{DbjfEWp0JMC|LJfwsM@)HSorx=Z8|46j~VP5~qviuiJc!}k= z-aNpn)K!?)4(FK*Az0f7HJ@C>Co8^EQNI5|pp&NJlKYkqxqWfv_ z(>L-|6kibLNpZ-z(=VvSKHp)xA{=#ww&R}gTRQ7A?Qgq5^GB)<^%xTeIJrKzPIk9< zp}uH+-06Ewp%2CZ&7H!0k6xJeuV39~uTdQfAnX1vDe){p zSDG}jiHsn3KK;m|mtxVmr=8~F8KM-lNpTW6xdt51sY*hJc<1uI(0pU?r)}~N5ub9# zvZ{jk~iNlDF?&SzbFGVt825 z<6jhZDur1JbT_e~QEKXN{*(W>XkB3k_dEc1YE26^Opp7&K3gCN zMW6by<{ZM+o5gt|uw%YCe65_e(s{e-+xyjchDz(s4TAX5nqM?67i|S2?TLHkD6VfJ zgDeZkE`CdMhTS&^U%7_4?;lCUoBUvh7z%l^!tJ$<)r+1!_1jLlx%c#S5Cq#~K=lgY;t;dW{NQdV zTb!oqS-0WEx3zkrt1i8GAN|}BVx~cz(gbWfzW3D2-R!L0LccmEJkXqk*0gcCJ^P;< z@6Ycd=}JG-K#`@ZSq6kRQR^RQJ_RycHU&8GNv++J;jd*(E37WxHBsS9c^F&~kzROz za;|9qey%JsCZp$jf)5R=N1~VVnv#^F`QhVCegSGz-!SCayZ? zftQ0H>ra=TH2HUxes{eR8?3dG@|)MT9!>Ij5yg5}YurXJ=a9obEk7%L!{P>g57Yu-RK70v&vO z&cwMYJJS?&oOnV8VCcam(fY}jS!VlYcL8WKd8$UAJfuIhuq*RlwwVI$_GAOe@7NVU z?5erdv?(4kYF<)g`=uFb8K@zysuQj{)mY&BM0R?~_Bg)5nQ*${-FHv*=j)@sNUkue zDaFxG%6a_X8}a>GR(v{e-tUcwpZzBpN39QrJ181Gn=x2ji=B5I0{h_3|8l^daEC~# zfP+WP{amQzy7O|Sg^vP;?#qtZ zQ+f*PWCl&E>$$y0OFznxN(|4|rQr*W=hJj!2p*BrB^<&jUa4gps?{+rRH2I7LTYndV&84HE!5)4AHK2LR zBke2Z<01bu_#ap7zfWC9v{biSBe^SUR=oV9&O`n zH`v#^J>l_=SbYj`3iwXe(s6lNMT=5>Q!;XBXE$iepVBPbet6C9maz)AIwVbTd~WbW z3>Gj2@pCP5@)Xn&=HPv6!A^N{(qjmdwJFrK)ZSQQ7R|}X9oSIS9j?uo5Ff8H$$D@Io50_ z*K)yGChx@Nz9~H&{s+5xpmov)3*!TQv*6UF}Fu~@njX74+&yAPL%`I+}s zGZ^W19~R8z=1u_y=iqMie|rIw%v5z-GW7svy+Rh5QFr2nwPqHxAx$xRK?KbYCmnd< znb&4^gl!=Us5tHH-CEHq&zi&!A>iJSKIIWe{X${~-6<~P())!&6@v20RE$CyiZYg`Msm}Ft)+xmI?qREqM8PeiafIFaf zqI2`ty%ttCdrgbr68#Vv1|KaxkEV;oAG|zy>Mv?+Ejbs(X-fsoBr#+9_0o9bIYH*w znna4X%W5RL$4dQQ0sWu5&32~Aj!J8SMWg1=)6hl3)Avg8uAE&;zHza@nz({vpVW=T__y^;jKE%!O+P0wDwk^o?GQ_vf zA1PZw`sv!*wxah}9#UgW-+g^OD8~9Oo#yLv%?XVX&+At+!NIk*t0i4YQp$(nrnFtH z*7^di`7c$Xy*kv88sg#dTAftR*Ia%kGQtZ7kO7;TK?e(>LD?rwwa1(|E!EU8GW7tR z%Fkj{?w`@O$Ij|_B+})G&R&f`SA1PxK>(eeEY5V!s}%IDrvui<(T-lcju4MhiwEa9>Aua!%W7#hjk+~C}2Q4>;n=9@v z+;YMa!EMV%Xnl9m&M7u~4HF(mhQRV+A-;hn#>U07Mepu8Bp$w9RLS^G8^?T2O?lnw zev@19JdYoUoO`_IG&dS2Ch~WR1_Ud4S`91(R=9aa{$pipD3SBAg_92?e_vyr&Z|6t z2#ljq=Jmk=3NwU*^wSQ1h1x>1OPhH^erO2ZS8V^3dymeNpjX!^Z)@a4kLj%LwHEsm z&4;`RCE808%H`OoK0hpBYD-4)V(S~?9qrIZp+N6PC)Q~DoB0Fz7t3YxHU6D*1sW;v zLviY@Y4D*eY^g6@H}A@`fA4t*+s4`hJ~WmORU?!kf$OVOs=a-KDMHrFOz3&NLLUk+ zHumWwT>b!Z(1Ng z{sPn3H?;q)ctn4=I7;`)&`N_9}OVpLRzcw%j%iXl}d{@qW!vdWA2-Y4R z+|F%eeCwD5{NWUcIxx?FV>Z(!sp&paO(! z*RYYi3Eg!&>WMQ2^@jj-6=)pFw}HTUJh$sv7gV~qHhE^3&Uf!VdhdQs zAE~wvrL`?1uqy*#N`NKci(3*n41*Pux?n^pH)#FQdIJ;>IE&cjAAhsl&-XoEK0bth zKQcb*v>YeSFMS^1$SaDoXX#O*1iXs*x?BUHUG{VahIgo$JE~b0X?lU<&%z}}yYliA zu8)efMz{ZH{Oh(i%In~?a z0Xj4>?L%wX?L8AZZ+w4G-(h#(B&2saxYuMYE^VWO9!Jjwas{LsnGXTerNsqSiH0_T z{V&iVz@Ah8conp%j`srj%~OA)TF)48Y#bAKeq^Po;Kf`u2u-)cOw|_J@5j8d+|h-0 z_SVv9Ka-GrKhlhvb`Oyz7c0gPmCYg=f z{{FkZn$D5?XOYR<6VgQh#%}C3>gCsA0@o`~u1rfi5QHPpzqQctWu zZH&~k-;O_S1$G#B?6H$O#0j0{%se!C4CiGqJ2|&0(=fw%_`(Y)YvimB&C&bjrdN%> z1|uDUwaop^I?+3((5|ibfNcsrq56#dX8Y~6^@*akYS*n*pZk*8TDVlI=Ul}~-^!{8 z{^AiXEX{~d{%iRXN3%&qbDV}X${Cw#NF~dkj;d7hrzSnml*~TJ<9P4=qpZWP!j_nm z;Bs)7f85VX?#G4gK3a2*R$Kf>IWcPAm>LsDh=@}(d6Hu30<8G2C2y}CU^5=?=A3V) zjp-92#ns1ABjcd4@H_0TbTI;NO48|ppHC3$yIPF|U$Xl6#*C(Zc6}`@EL3-nwq+^y zT+D0Q9z%k>GS36Gl$ug7EwhlS%N3jO?FYd}9RybkGn6+X*Fg58ZC7Mqa8!B6VC!ga zPPLWz%JtBlR~P~Nj61!YQ1$m;cPOIb0dXE4@~?>hsQG8AnH7WP4W4_scohZURKEsH z^SZeDiR}YYI$oNial+CRKEY9juKNCbA)wJ_Z7KT1w08Br+r)?z#bXG;&^(zq8#+*; zo2OPzs%aqAAaY;$B`q{=RObW(93i(U2pSJTZvh(q2V1nDZCd^FexqUn($$MGr%`Fy z$N1wT^cE#Q*y081FJPyByP(I^rlzV_(0Nfhjc?=?*>Y9NiRAm z2J`$@kt}Hj;2)(y7smoNWu0IJul8x5`2(IdKDscgsk>XFDY)yTdQ(A)_nWJ6Qo&9+ z)S{7KWTQ^`3DsUc5wjVNCe@*9)N&g!{n_J)zyjY|zpGGyBk4tRb`-OXEkJ2cfe$Gq z5~{CO@Mpc1#m%L!?^%f9o8F6GT{7l}fSahXOwltd(+nL|6e|xW`SGb2yl~9#y>TO- zM9uV6M=$BSfkvA0)ZVIn8&WIh7V&GQC2P6#&+cYKglAw)0O zR^Jo^AO+z%<|I-F0;8rHhziH{w1^I>`M86xaTDY%G`U9qM4lzy#}cvF`2Ga@gH3f; zRwb`j{K~XI2 zyYPteADTKhDwd8dl19nZmVQ(9qPZ6MNa!-=Fargrf~~uezi$faeFwcEBaTMU)ucpy zVxpOaVJ2R^nFu2n9sAVikL*%yh%+iCA<+9Z&`}@O+?v73U8xZ`Q5I&80+FF_Q4*>F zlbRz1WnYR8JBudC@t_@Ty^$3x?HS4ZBq=C#LZ9TAMo>6HqAN++4SUHs)$b8!WSa*= zN=V5Kd%6wYU4x_0&C#6t-G%3{casskJV!*(@$%@`sWnXdU@`SLj<2^f60~$E-0ujP zdP!o1i5|Uaz$#SCvmJ5}y;}TcxqR=et6TB@ej!sZqSUe7a@>t90ja=W(G@}UWGyM0 zp8@NJdHWsyWc%jG*aZ3NP6F~vVWOLzMzW+yMQ3pS;JNvJ$>3_51!v-|WSl-^n!mpM zIDL0|)ra9~sJxuOi+lVUi7AuDh9$J-+^ZsLl3DW|i zg&iz0p_ep}g9xGM461j;0R5Tdw|{G zmn>zeF09_kv{Co0;i8Z4_uFfqt`&Q2)VKfs=UbMC(J+s%(1D7TW3`55eEN^aA?z0` zMD{F%g0rmSS+Zzp#fh3TeuuGWkDeyzd(*_@1lW$g{D`3R5eIBe-}&Q^i3E|1IL4t1 zb3}af;baxqGRDj=lAN)$7I*XuR85L1B19!9hMxnU2vi~6ceNz`&?o)4Kdih1It)K9 zUc~epk?=>;=o->Eh~!`?6ex#Fl_Hf&p^keKBG_@G3s{9Q7GS4 zb?tpe;#dF9@*bp{G-%u<*&uh4RZAs2oz9gz-)o325xlwJjN0Z=wP-Ysp~8*~lEVq! zQGFwEEYg`lFWpB)`-ryu9CM!s&47yM8T+=ytr>02xdkrN=3jS|Mg2Kbb6wGlmb4 zZimPz%Dn@jwHeXw{ZNz~Xj)5C)ShbO5UIY=tnQ4@Koc`mW>zUih{C%UM2o_rs768f z<)g_FIeOn@Jd?hIeCu`;&q7^k17!nz-)auK2LnvYhEW2vBX%0nAx!Nw-G_yZM{-u_ znlq-(RK3|%y|);W%s-3At!FRzy%R_0WB95rGzriPkbeo(z0t|63*rvASuIWzc)j~n zOh@Rck6&^>)4CmR3mi3X)-Vw2oW}7H{BI!iT)W;5PNt*@3<=WUrqWylKgNQN+BRbf z%Zp05wa*l?lT4(>NNMmyG#d(ekHsNqu~+2sfkMi5|$fjS6Z?p_ig z(88>ky0&h|g;+U^6O~VMq4m0vzWI$~n^fWcmn?DG#zq&($CO*r4cJ(_Du0Y{2LI%A zX62`=2s(r4dRhL$-6ItBn&qbdOIEspkOZ4?d zt>YX0Ek=K2+x@$f;BHT!xzSkZ_tIiI>}RiQ5?kX|bp1-So+Q?LRmhXuMnA5+9|owR zedsWvxg~l37JT0XUT)r0d);-LeXOj)1Bc&+bODcZOip;Udl1D<_KqwnkImhnfr>x# zEl=EOGPKXSO;17{EePk(wMZ_RfIptS zN$&UK;V#Glz6S1$9Kmoq@%cZxh3>W zUy_W;ObQ=WtFS&dnvSSGnSc*U+VRKf=I4|GteHDKlN+Q#Wcp^F)XvO}S} zK7zIN$HOLe_!9yHr#`1k>}!;#eWJ>^o)lDU>ZGJ{;sNdJ-X(q^hw+RXw;ia#4$9Qq znx&au@|@epS^5WAQ@_iiTZ_J4cFb^m031Q|Fe;EGi^Ss3t>1IFow4X$q!1EoWVO*f z2`87qeCLY4!AY(6mBEYB{%8dL%xqM@?fTIA(OUYU7xTNUQI>pdY=w2{#NGfiz<9+pPS` zTV;5LQO7nR<+v+9p+HlIRStG|;;FS}+m%Xos@HgBy^_2_GY=7Nl>298_{7~Ey&nfc z@y83n@j||9t*i-AK8~>MK*cXKGKJ6-4eAcI-1KLtQlT%1q_w?Wo(PsF%iw*@CA4Tl ztt^r_$=mnu)bH=etil7H>CH3&lw;vLh811$H7|YdpXwh7(4^J-CG*tH;sg@#cVY^z6R1 zHX=?~qmsMp=eO}uMPCYic+YQRM9 zH!~k5r&YKYxxE(`tcr3V%8pOn7TwAL*42b zbbe|BBPxKPjUhWOIM;!jW?fi_j}K`3;MbnjRcAw}-g=+t2-Na1gx*3o1JQfzJx>RJ z+`v%*C>amaQ$)Vv;7gd%rt--yzmJfp?XX|8OEV92(y^>9sc2kuU92U^CDT=sznuO4=l0V;+0Z zX?Qh{UJeWX}7#@t}_UeEV_3fnR*aQ~rIpIYPAx{6k>hAF1jnHt#}qRbIk zMt7Fs$#`Yah+5}XzN?E*w{c@irfy4ocz{xVP)x{1=10f{=_F$&FQU5ER@#WdLgw<8 zZ2goOwbC&WbiBOz>FHE+@YTYutQzl0o5{LTap{UaZydCoVIpwFsFCn%(ji!6&fCro zf(?%W1*AvfvsT{I+(x7YIXM#Jwdd8|j6f25GpOcKZvt`~$IfvzO4AU`tK2UDiL59H zc<1I8N2zdPYFcy|5PaMy>8X5o*-_-M`po%L7Kf^4~e#)kvyfvVGx#!R_Q8Iyv$l(|A9|waApqdnWZzH zO9iZokx7dGcY8fOBQ%;ZMop}mB-W=~Gtq9=xiNcf<%cX}^(m+pdi++8H2}+Yg*Ef0 zdEv89t7o*<*^)&AJ@*2BZPI}Cd5_+a!!ipJRC}rzoTk27j@**0D?g%{TWsg}KH6$t zPdvp{q$DcUW}_5F|K#Ifh|IW2@^0y_Lu;UpY#OR(_~6!>3ebc3L0%c-p1*FnT-Vp$ zdRNi`Clc4yKr(E`pH#%ZEzw}FG3_BAgold6lfqiZ_uA{dH#}iGC^c}fh>RO2m&z8g zaA7cEV9Hv9?k321YlxVm!6#{9D;x0D0)mj8R+_~l%U z&f&reMdv}Mi-c$Uiw4ZcR{ZK!n5d=TzsC+hIbIA%>P^~wtO^>gnyL<{shXVJgeqb% zwd_@Xi16!GeVn30MT09$4ckomlAJ#p$tOXxBI!ASr_rh4&(^iEqutr#zoRiK0Chom~+i|&^w8AS_tqv)T zK$Ky*LhB+JLKun0C5Pd%-2OnM<@v8E)(}?O(ilwrSS=f>IidCh?zK&_6(-JsQ<+W zUOkLvhf{+wy<3q>P6e4^Ggns+dKY&*N8GlxSkZx>slhP&fVvbjs$3qzqyUNb+frVI zyPy@52)+C2fOS5L$h%L@?ePPXFN*YFF5$YY`{juGO_BJ`m=bz>dfuh8tiP1r=x3_e z^$_d9A?149R<*%HO9HI3kH4w3ABc>pA@{+CDgVS@6n2H=7u2qox4x_*Uu6r-2$SVn zdhS)$lg`X#x;M%EJ!F$oZXrll!!h!(i@A%dET2qZw?K zu#vF*5x<{-kC{Nv)R@X-a01A=9jz*_j>1=)J^h<6>VPJygo=_zIA&U+u&glDzly`@ z#87WA{%xi+U=(TW!piAX_k#u;;AOa0kwszk#sSk#>U5l-MukxFi|!)CI1g>H&dw1E@$eQY}Dkh!`E>; z^IYxPmG4w}0w+2~xI`Rc#N3;#d0P3`8ckT{$Mz^bAiiM+d6{@pL7NA}$UT#INwOtZ>mdb)_oxc)p3MzsUA7wXxcrQx9;D zY%WHlEs5f=#VtUU|`ylh48Sy~=R zM|!GZ2~p|`tR;Z}5VyqquFKTIHBVU?_$RqL7Bq}#Tsq@lZK`IUkKu3-vxpVS7Ya+c&(`nT%JZE@BJ5)zuD$znuj%O@0C3qxRPJ!?fZmbe)o5kB!cH!cJfmE z_jUk)1IeKZb*uMLG~Zv{VTxK>TxWKDXPsG*n&xsoIizFOq`7Povg`+4_7xtOJHG0< z)W&^1x>s{2(GWlKRQA?+wGrX?)|yufr@E=A9W16S{V!0LY!uvfeZ57u(Q#$w__5{w z1O0=XCJz`ASVRenI76ne$`f^4UWMF(HnTt%vii&*RA^%tEP2TZ+HBm`r+qD(C=J?R3(k{D>p2oUhmw+ExU1E< z#{5k@zL9#N^TlvZa=qRPTk3bcBsM!9Q0rb_F6TfI10yv2A9Manb=uyYCuS-tHih!J zAH351iV&4bdR{*Qrc}2I!j&d&ZW^_J9?ve46mxk~JW-=CmO68exzN)Ge+G&LI=Q&& z&%JLivBHqHuIj+_za(o_5r|kUaJd*sazu^@$y}1pG=}W*Sq!4Nk{x z6chw2nUa*?yGo;#B_mjOvE%@Jzx1hkh58J0WxA9Fi|~besk)^?4hH6Pj?Vmzc88Mj zi%wVc8AUMNXH#`YGV1o8^Jtu;?yo}|2brg+$QH0_#DMNxg1D#R+Jd{=T9m~wa>kyF z1Z9<48o_x|i~eED=|(<_y5dZ%>ZW=BIvLZp^+gSEO;R)ioXXep6U^9W&NHHCXZ@hL zRem^>zM>aCAhs0FB{|UckUgvQSQ!=MSPn_>N z+6XFx6Y3_0I_Aarg3>rbM%MPy8dmym-#w&qoxh8Cm+pFS_&ss@yaUWV;7RsO%#au{ z{%xz_rJZtq{YbcrOYQ&T>&wHEPTRIED`(nlS977pDJ?6vaYKcgnw-p}vLtgMHMJ5m zcTqm710z06#+L?^vC}Foag!8r{_D~`Tp$a$mHg} zujRbX^SmM&9rmumJZLG5j1bCi4bF4a?!&*QIPkPgqH5o5|2@39TPM)#`W(@2u(5K> zyxBE9D~+W~PV3$`{?=UCTUdR--+t4{*N8(Ks%pZsxE-k^>!Z_rvjFq~()D{eC1p1p zc03Yfjb)d?gLPS2Dl2tVf49m;X0B~xndb?U+$DEEMeWnO^`psK@>guxorJ*~Vh?MZ;x9>JVaq%0h99@dgRtw^cp1I|)BFkMlX4uxma|7(=jydXOGihQ z`?K-LrL8L|Vx7|%BR33Nu+chJMrv%4b26n5FjB2sqHl~rm)9M8KA6Djt5^D-X+IU7 z9{v|m<$}af7M{vDIu(wLo%0#j$BCiB6`Fykhd1r3blLdg`X{*>OwV5QsCWgyRAaO5+Z3bFEjjQ&VQJuAlURI3=}L@2Zz0mnU^qK8IIWl2Yu`gQ~anq zG>*=AX=&bA1maj}QmXONR`H^_N>Z)HfS+_cf#dH-X-< zw#;hI8YfM!KbAIOeq^nvncbCrxt|Jze|j~!*{e$Y(RgnI5ba~wSj|S)gewtqdAQYI zLN@^(H~DuS@qQS7lZ;Q#u5bwdeA+I^^7lgEhgB66mvIAoOhA(T$1boI4hs9PS^0Nt z!DT{r`0{m3TMf(b{;gocnm^PZMMkLX(DP_JpO>4uu`ZgA=H+i+rD3k6EjoFqz;y-G z#%@)GK|-wVuw@~7WgYKw(N@bpGB?;aRmDe?#H@L!9uppe7pnMbY5nz|@8~~Fa1C44 zSr!sIhPH5TzMDi} zGP@CCu7WHj2Hw%Nb=R4uOAiyF2RbY!Fn~S2gzmqr6cBrJVc8NbLTUApN4c25aY;FRN&6{suS^TH}QD~;JE@pq_ z5*=h+H~b;`lrRFjwf!SDx}R@!rNNgW zCUv#!Zun5v<$5@xYC-t!jP4Jcj8+8bKFjwE=%LSFyARUbqw*XZ{6hW%qJK}vqjaiF za$k23`A+KjUfTXKZfMW?rQItb^|S(-|a6n zZkP%R9*Ftvf$1)f0PBeZhxDPFb%Q`=)&byI62vZMO}cZ0pQ-r3#=5_munofG;BP~| zI%L@YhX`x({N(FpC+gg#p~kEqNP%~iu1^zDwx`z_u+?rs zltQk64{p4-&&ZWAZn&xK2a{7+_NCyvpC@*BxCi8JZw}A^&R^ru+bmhKuOmf;XX~gJ zV*kSn`>(Hlnecr$^DLZeLt}a|UKB=qJ6eC)@%tY7y%n6*sr2(dg-YJ$L$#+akDQk9 z(4QR8jn64Bs(Y3KE-y)tsOn>zN0^3eCVxHb;*qzJM<#d=Q}$PEP~qYsP{(r2xvu$h z*FcJ|FcDSH3v&F9;Pf3qaj&X|ndmMkyke-b!RJ@m;nLf$8TYhD z5R2mHjm`H`OJEi82YYx=G3Tylo(*i;1Fp=`}&}n$a|r)A>E_``tNsyjuSu6eX=h)vfT&Jga|eTj$+%jenW! z{`M-FnCl#K<9TiJ`Uo3~I{wIsP?^eG%dDykvRzOLs~@EAWTDpFJ}a_Jh`4iiLA&Xi z18wgvtc1VN621%Tr+UyC1_6C5)8d0iHvA9v|DUJ6{3}p8RFakwko7)w>HUq>w-|?m z$JTmyAF(_$d|u1hZdGr%_|E1akPG}L5~&5VyXc02x??_E@Ll~PJ-36x{nmUlx1g@K zLVcl&5=g%)y6>d`cGFM1DD`F2!|-M1&C7fQOfnvG>Yr%X2CB0;u}StBwdT#&JhyO6rpO>k=FPShML?kjaWZ zpfcmF&kHZxEX%sX#-3%jxIpgt&K)SoqtN-)n!z~^Ptt$1ajibD=C4(9q=(17V1VvN z(~+pD`De$(PpL4{$=A!9$!W1k)d&7-@c%#8Y+2&4Vg)C_Uf@<&2)ck8Tp+6X1sx8@ zOFtz#MsI?D*_pDwd%y5gE*gD?H1RQ2w(4PHp_r}aSJAVSxgY+G{_IE1eYY=krblb- zWo)c}LnS)B)SW0m#_66GBH_`{$=BUpjM1}v^u#}2wKf$y-iSL$x)zkyIjb0A0@j(Y zxr5xK?bXC_u&v_*KS0I|;_M>k!UH)U-}EzsVmuu?G=Dg*rFJaBjuhjr%c+58)t1!W z;&uOMy0R&}l0wXrOZ0pd_r7a`zDp>>Y>9b70oL=jtF`AqiEHV=+TH@A81^q za}Bi1*;JR6otBwrajk`z)|SKb7T=Ex{^zj4KDl`P2MlW70##85s;OFBUJJaRf+8ls z_0z4xLB}$Uv!ORHUC7nddEFkLdLSEMKLh$P&2`-c-8Q?14d0X&J2!jZs@X_<3OtL~ z>-U(54!DQBRUi3BDInV&@;S&J6SzE{_5a^9%b%Sp#o!onS-=ERUEk{6+2HL^vq{Cv zbob4}=TF=N%F8wwyopEg`k`N2iBLWHsBAj~HdSn9!z_RRw;|Eig_>GOqPaV95psK^ zBbs%jX|JuH9rU)RovNeWeJ|U%iFlC0G!2@V4T98Lb|5C`$bXS(zq{~<&aD}S1tbxw zar;Fsd2{JoAFhr1bYF$ZQYvy`Gp|azBx2H>~~g+)rk;{o)O%RNd4XpC0^4X(0^maicY7n^Q~K z!MAI3`nz6tMy@U$EpjptzZGV#hkr=YAd~6^o-_S_C)bAAKaIcnlZu(|<=R=^1M&7ZJGotWb$$nIs&n+a*wN9lBc0AnjlFt28 zZ|@)-v)L>Cc|XSdrT4ULuZa`kkWVIJk7HzCuQ5mwR4SxVG@N2SYS{|KYM|rF|9%-R z5C7_?GPFFxAPp{?o}|Sljr@wqj;RR_D)co0KA>YR_s@FA6p?T2`;wiUdR-#!8IQMz zUL`Nr83P^-*RxHYI=-jVR{KuOUGpie~5HOla?ujakFZ;*~N!NhYvdSG2NrPb~rn&S-0i} zeZ(BnGW?rm_!s`kT$qh}5H|6nW!#?JlhW8|h^yO%EoQ?eCMVU59gN7tr^DIvaSke% zVCllX{C-)n2=hf>x=h#~q~|TZ8;pIb@tB_^hSgM$qYsg=Y7CqK4co&*Yb+Z>X#*FHv6po)~Xz28>;p5h25*w zWpj_>EW=weEOk5Ky22J_=^_ZF!fj&d@>h6?;j{0dn(t%O9sl70vV6cwwg{VXmWKfTDEwxkR6ODa9&|@P{mLCtl1Ck zYrpKRi7B6)?Gb~)MDHg9Uw7G%!EftP1g5_`*%UJ=Cl?t z9;_IjN|OWj-uByPSIxZUsClVYdmjVRb@o+mZhw{MiGd0GEyv^zig)xe&d*@Z zS#5aXu*Hp?xAt&zbV8ieN@_>L=|xSP#Osk_{fgZZo?jgl&tLumtSiTFP*8B6@UF#oAQ0QyUHQwcqP|ibc{i$AYzBE#N{!^N4 zkGe0r5Gh*#^*dU(=&$YoJJEW>Bxb$FJMO^OkGy3fDh0{yec__`DU&D`L+ZUH@bP zYOMB82i10-Fk)qrYQA>Z%&z=He|Fx_tKD*A1Ep^LPTqR)QFZ%wJ;JW@_&)yWnEv0t z$%+z#!{)0rAxj~U>Xw#&%2z^~O1l~>P5{D3uC+-L2ibi{nfI@nk36)i);+nWt6DX3 zSY{dN-Rbi%VoQdTE!pqRby$}M1wE4S_P8i3wMfhoq|R&D=l`d21c zC0PCtq53MnU+fVitgqrN>v|(WynS6{)L;bTgooun^hUFQpUQOX>_@dIkZQ^*uLDcj zsAVNg+)5{J+e^QEd%x1xexv#RpoMf5qk#{>*5(Zn@4`PbfAR~8HiL*(8+%H$OgahF>e}wa@(vqx*TsKSnWA znhJW6r5L~s+~{9+A^%&Sd_CIP;q#~K-t`$|pBDbY$_jqv$Zr=m9cow8Qf2@jtQx{U z)oODdsn<)Y8mQK4D?I!*s<>{9a6FNzy63FFgB4acrSQNFaKWfPhjle*j}07p!k|HZ z_fu6xGejwbki+z&%BoV@|DkTT8`rwUtN(3cnQcA|?nN1&ZWt0YIID1Dm}asyGtXwn zB&SP2FxrJ1FaZ)A_D;ELY11L%_42>-O>|4)cL2-x6+P8b^~TOw@v?AY zz|AKhaj>m!%ciy570+gOuQj-*&iR;d*|Gdq(6IH*ND4~CLN+ri~)2wscg)8)clrORt5 z2Chm#KEAsBgR<4R{}A7zyUkVBfeur|K~Pj4SEnv{s^0JHwKhS$?U{*JK%zI)Zrj9p zYQ@J`OIUg|hRJSB9IblmyVwF81AG$jp9Suw%VMaZUlt(|sfTlqr0nOF#uOc_TUoX` zrb7Q{#)iWKRs6IExBIwT5rb~N>YSK1_o4DSP+AxXncEEseNNW;-)r(G>+SYy{qT@9 z9YGvu7}*e9vu2y>(-GT`jp_WixslrFOqh1)C9Uaozt9T`8zfI5Wpsnc+n(iYLq-)e zJCI#Ny|BxD?VT$wYpz!cuIL&X-mHok|B}aoW|VdneBJUfGt#s>C{Wh#IEwWh?(^%J zS;Ed#ODDj^CTSmo*8WpJ%zeB9Sg&_?z)Q|Y2Gg)HN|4+=s*ZcWcStXmV&we?Vu?%tvf^&}0w^%MNf*qSq1mgo96u_&()VlO}8r}BPp z1gWn}1D^CAyyjV)gKT}s3NL5=6X@CToP+U!S+pL9dbHSE15VB;DgpW_0cjAG_l4(G zn<2u@kh0iTm%PwZI6&tgO1$j04+%?HARZUJw5)fl1N9O!tcb^bbqQw_N z%e$Tt>leDem$X0jRC#j9ruBGsN-7+iNO4fGgPNu4F{6ekezrnSI3ps$G*9a83tGRb z;x)0`C^K|u7w;A0D_Za((lY$?6y{v&YhsYy&#>4%v8cy|&u+#)Uec*k_Qk&2`AaS- zsX3BD|DMqBAG|4wwqA!_U#@Z&9Nq=@58{+^?aq~do1?jZ4C&Ln)UsD!i#N<;CvY#f+NtlloGzNf(2tZ*vb z62FNIW)&+b+eowz!mku0K1tqfD`dFL#;xF49FjE`96*S(fHdV|^&+poLg{ILc(INj zWlkpBDB6Wf{5_YdxaleV(D}Y5oho3wyt{I<(h_X&(=b~{ezsk z6N0zX#-4_WuFeZUgzoL(RbO{Lh1y>_-%{FHo>+KjcE_a^)eH1Cb*bztxX9xj&k%`Y z8dc;Q+}j{5nszF$XjQ2&ixZ(Y%D0i9i1f+LRIAuyooag7%_um1cjHN`o03tZo>Gsg zrmo}Sg9za~dHi&->=%Uv*0+_o=#7yCPz)Tb5>W8HiVRkw9YR6$$~p`4SJs7kT)-L6 zOKs(V6_sG4=#-hy&lJN;iy0;RE^0$9E%E0%C4yE-n<>Y?7bVv+!hMz;YtT_!B^-X( z`(>e3nV|I-@#4&ER!2X<=Zlpxz=4nyXWI8Dp4dw&S(L3Z6z`^2y^cCw15T(DtD9S# z*EdxGB`&U7}8!-A&h4CsdB2rr@Mgnlw*jli2w)RY3t+G=;Vf6Qg z6{Qh&?z*qH3am{KFVDiQ%TXA!6DNCjp2f{=EoXX0=`73fo4uXSY#pF`2kVv$ApF@d5 z4?|=SH*i&ekWj}77F>R1A}a=ID_uxH*=F}snyM8iQfQB7!qX|I5qX~Fy=Q#Bye_%k zRt2@yKD%Sk-YutoQgm@F@g)iAy9|i zpH%14@3+6)8qJ?N&D>MuL{2HJmNe7Hjc&&Ma9OXJ*fI0hlhjniTopQbo}LBd-)ZKc37@CKbQwO7~(MSwD!#nQoz1Ge+Dc5?5k3Pnx1WpK$JgI@PuoX}q$5h$Rg z9CUo2m{I~y%LtsBBX;_C;8-VPO5%Cj5xSN4kj9IAM1vgHvsqp9=eB?lql)wX?sj$q z-r2_P^Te2{4DohIiLg?9Ok@iI5mybkeGs%NynIk+8vc%_n?g`088Lu`Gs3y#>J%LP zrWEw8e7kGqjhB~Sc?~;zV zk3D7mf$M80PTz}i#oT;92*{pGUc-b$h3lB=DFuS1{P)q6DvG8r^oNi**Qnh<;DB(C zz36i5l@xfG%qB=~N@dw7V7*inwWya|U8^jiT2n3F=_z}CNB4fi4ZDR!q0d?Q%h<%w zIQKYz4YIG1^m5>Vs>}C5#1n~8G(|yfJV~mz=D&&-&X+VaBN5f4tMovOjECZAATgnq zmlu%GQ4P)oOynqq@v=IFD5UQrnUR6tQJWN?%gDALx-)VLx_9ld;M(Zt6I`aE!@Iaq zm4#{Ob?=m)STq^sNF0{F}v*m@_Saq0L4G0Jya1uXTo z1~@$tRv>qfQ?Hlx0;2eie%53H!c}MSKH^-bfU}d3H06zn96KyG!A4qbC1X#?jHI7O zm3##Y`-_xSNmh#G9m0SVGLrEV7;M|gQpN76xw5ZTxAObV19L*M;O1sUR7Rt6QBFrXm_v1 zryuw1(R*`B9fShoVt~mrx~{I&!U1^`(`agyctn-<7^Hg&g@7}0&cr`b>_MfGYXUKn z@UItX#%>rtc?vltDy&@jijYjW9+?rjR^Aez0A7`P2xR3bsS75?=qlZ!m!FK<2ZP58 zdHo5`hN4p_;IuE}ojOM&@cS1wkaNSD+b#?9^E6wI#^Bo$y%-viR9kS%M1>a3wTh_= zVQBe#iM`#92VZAQ8d@zB{c0i$tRQ#tTJ_5mT4}8rAtPF#csnOJ8R?^Gq$~1iIr=np zL!9>Wy5{@j$KuzJ$6)%b~{5$`WVtOad9mpqzg$@$h`#Y+!syVX>q+aKyDS zM{pQpr}}{Uz!IBVP;|;+-!9#AC#s{fhc|1*<(_k;sgq)~#bp3s*g(335uQAIE81lU z*9{2`*CY!qKo<8tR}s2Jn20BO$}IG}u#^@x82l9!BILWoJs_gD5;mMIFSEd66A^^~ zpOQr5?j)OXUTY8($!u+0*~~Ab3;&A18NQU|AZ$)$8HEjBooBVf&6S-J&i>PGjPY^x z@CpH$8Y?d#aw`=a189(}g;%BLHTBt65y><05?l^MQz3rR;e=BY&0L3u2ph=P7<8a4 z9Qiy=y-N1QlQS}wc>qH3;8-21$8cWjW3=`7+nuAqj3fi?oodTt;({^aG3f;i=o55Z zOf@1!3xKpTX7fzMshxX@M{j(7xMiqcOQIv9yi7!ygvu7uUs<}riqf{D-ZwM$((V}x z1rX2hix{&-it$E;w@h*dGj|@23Y3jfW)i2@ecsDTKB|RyUnS-z2Ft`}^cL}PtOqri z?S$fFBAcsjoGmG9hIbc+9e{yyduS3du1*M6CI3DcP6f-K8vpMnWv*b$-t}LLQ(ZFZZsdZ&z+S(Ed_)b3xL_7kcTm4vvUPb z&G(X6hA8$}QAoKvr?4(XUwd&B!=WH8v7tfO&G4W=OiVweFk896d#Dkgb3o6=5%1Ih z@VLfxY1W>Oxhn$x&@#J(z9D4XYN4O`NhO)2>!6Ez(9Pt%l7K))c!$d8zUQ(;2mxG3 z*(2V+v2Nf2xp_3dscy?o6qdS(TngH1zQ&H-Qfq9_#*o z2g=^2j-B}W5NYNC5u}<)b`mz?z<-)X*g+`Pw9+Ohn#hvuhxiudByL_>r}$S@1BG>h zkEtZWTG^J|QRX|&%63$^G_wpP#cIcw)$YrqWXyEa^P~Qo*d)3I>*FihJ8ang$9t+tkD%OTh28y5AB@ zy%zDVxg_o)Xr@FX17dEPF$W2T>3ouCT+9b)Dze-XUulqx!EoSjGCi zILe&!-6Y67ejEaqqBAC$djfCuGsjTcqSaq3{St{K2d*;pnvI%O^Tj#T`*&1fUM-i6%R~V+1E1NL+|2KigDgvzG7bLOKo zQK-ZUi4lxh(!{_wgR;55PshJ=CU`k{H$*D3#R20iH=KuCHdqZyL^H{~gaMzM%CC~8 z;{rtBS$Dy7BL|`A6&dSd-El?vy?j1JZTh0p|7afB5z5a9pJV8h@y7{Hp6~e_;d$8t zKa7-K)w_VXLQF47JwV1>O{_dC0p*Pnr_9_S(Q7ch8#p9CN+IoJc+1#d3=jzTp=Apw zb>Cy@KUx?6oS&9|KA?n-e}n8jg59|(YsG{K+X%PjcV~^VHpZKy_YiPtbOx|TY=V_P z&yEW*YS{_bO+S#G{9gIROA3;)&>$RC48&Vjw)8OjPY0E=i-_shg~@OT?^>n?>?@zB z*lvvCjj6$<9WDCUE*HH-+H^gep;2}^t|SLw;FM`frgD5KYD~Q)1%=&eNlk0bwo!Bl zx&2~?>0ZvP4vq`N)+pZM+rc~!?`?{TkyS!U!VRbpY$sG92nc+nt9psGuIW!ZCze1J*BNJc5(hpOnsi~dx{dXzi9EMk_)x+e2^%bhVHVYkJX#>6+;;!*V|D5=k{xM^1Yzl>HoCkdqH(`Y;q>z2$C|EX1 z+>v4aK1+roE89*=v!QS7rK}RUf_OO?i(3Sbt6fN)@lGKJ5aFY*I3?g;FBgdYkn53h zrs8=$okM&gwl%^A?w2Pe5ErBYta}WJt+KTTA(Nf=N3sA*=RK{Z5jI|zPRCW!U$P#r zCp3T+e454M@Lqu8>W?4-fY?KtP11Z7S=(PoG46au_7NIj-**IX_IsJWJA*a;d)9Kx zboC35sNzO7U(@xQR4+mIUa`ddqUopGhKp%EA6)61=2T2t1?78giPMB<`*dkIpyhjs z9j?-!H@9WJZ8pAV2Io(vey#pZln;a_qF8fOgSZ#hjU19IVdDnwG2wlX=E7{^Bp)GT z_ptiK`$=1j3CYR}7#MIevvVg|$kCW_WzSm(i9-Y&Apfq(h{b@9j@t_PN5 z?GbJQrADlaVV+98Qn)Hk_PiH`?q-OHi#y4_3s4jhO1Zc~kBo6G6@s^#M9B|4+J9MO z1*=0}#0Msx#{`Ki4445f7>uY9NEVsESod{v`N*)L4v z7KXe)onVY7?tdUsB?C;Z1_2+QM9$rp*T=7%Z;OXQE?-GTvC@k=U)Cr;qe#ph1Qf>f z`GWXpvY#mK05-DqXzSz23z#`WxK#o%RO92E%Y>qyO0p6;Y?(Uro(Ay*_r2WIz!t{NBk4>3q^D|G`lK;BV`MTD72s4h@`Mkpj)-15-&(E5O^r@ zk+Fn7W-J|z7gnl=O-p?tCGtjhPGA}r6|1X!=20&xtnUGsOSupU0Yq|`%2FMr?2tMR zBF91%?K3mIDY!8(WFyDFHOd21$YHWv&WsL@b`j_Ghls#gnkt1)u>y3J?r`F~vG&wB zejF7yY(xluL!Sb6zWn4q*3UEyG6Dv5CgDv-n29vRIYOmSybn}6i}zv0Mz999Hl43e zU}}&R^RzVuvF1XnyOiUxq72zPp$6Hs2PZ!|3YzbQU8D*QsCHjUGZIexSh{i8!dk{( z-KLQRwKWS8_5}6Nk^SM1?QHAWMrj48vkOM8$8B-ZqDov8U*9cVv6JB8{yqg2dvaPo z&XuOYx}RGc)PakDGGCyQDsiGgps2#d0f>yRsdupf9+EEnfD-X>n>5 z_5x{eijAeR3bC(fJ_wRlcl1*mV#cJm)R{m)>ke#Wa7RTAq(3eCwyVy}YW6|T>X?ez zWC`EF9uJQ=t<~IVow69+uXZJ)| zw$MfL#Kg`7S}Ar^a2ie+i({i!UBDX8VZ91%ABZ>U_i5IoTI?sRy}FF9l+33uBHW z9_(z}iLz&_ejVu4)G#Snv-aoh#iQou5K9;Ksko2rCw8hmZ$zs8?p16-ih0+|OGw)Q zi5JcnIh9`awcP=S2!MH)1M&yek7Ya#Q~?ec;ggb2J5i+16o=%jAYqZw8L(q!u2O^W zh{D9z@5YJ%F-T+!&!ChX=sW^+SPg+KocLz~fFvnflo@xy>Y1TXNK4w6DLlU*9L0k{qFE!zxXg3?PEx%Whz!Y1^BJtr>T{Vk%3WRdJm_fQn#6gG>ha< zyaPr>g)?Ev;2g}5xlLb5fv#v?qqnC!vg(}nz7_AFg{52X>s|YD=%lLyMs1r_v*M`x zuU#ig?^4cyvA@f92d+UQ%M;7gX{OD9NhXnole=*kM38&9HL)0oJAxUD zVyh~H*U|C2q!MKXTJ(|6~EOC~yx8iErd=|brZR1VO zPe+sS8}-~XPZct1Cdv(rhn62YJ)o%Fc)*vFi4?{mK+K`6Dn7VG_si~Wy8;hKcpR48 zpWct8dEGh+Y3Vh##kK6`6~Ai^RsqWcbR}oZ2;PrQbn`S51j1b1W2o%H?D{_5cm*H| zly^-Oi)jvV9j+&g~Ghq+!Z>j-$~V%a50zAW5FOV=jf4a5Fc)fm0}Su0<63^FXhVXyaG67>~D5yvfF= z6`o~0$}u?}ft~szM%7!RruAxV>+jTwf(l7N+V#60oT2~+q%QH}oHn0^RM4%WV?+l@ zmZ0Ab7Gv7fdWc*p-pz$WE;GM6RMI~hUmttZM!l9vn*>Yia$g}RN$xy;z)t(7+)XU` zYwAsA?i0b2L_Gc-5)w^iTV0=ffD^^Kg;|NowFEGqk3|WV%*f;->NgvOhmB&u`0w*^ z<8G2RwUZe{u-^)a7_=1-iv-5x?bOrVGgmtB5-9f^)u9!0q2ehP$1m~iqPl1#7C#A$ z%b?F_BB&QXFj3HcUT<>|yk+(@R7k113i=5Y)mv(HX#nfClcSSgM?!)7M9K3eM75>v zyDDJ<3!v`~Trcj0$MAk;X-e_vgfeij?XO~`mbBqww(p!y#RITeo6Ce?+>daK5}&oJ zV_^vdJs6w;fA+%Rp0T1oo2Gf7K8 zSpKUGlgnxUZo}l_;Bi70E2ULvx?{a;?hJYP$0@z- zA*3eJ$q%$lfC_Rt$__R|NtMApl-4S13Nk?(*Hfe(ZJ1RvW=#t1(9T`R=$E848Id3# z%K$XHC|{PlgP=TLSR49p)R4gW{BLBwN8~VH9GYv+;XJ!+uGB*<=Xjwfu0%?V3m-%k z4d8iVxjQkhN)bc|CKDHQA=AqKiM}P{-u}!}A<8m69J>cM<|t+q%6g(=fMk3rb{0aE z@HO!2f*INVGxF0^cdK%A#uZ&cOq^YDCd5*#QiX(0u5(kQUA1Z+ZIyV+df~0yK|U5q@c=YE`^C<6Z)jk z5(d|Yr*X+6RlBYK5UEDQeT(n^%J&5Uk8R4+nWt=?A(wmpB4g-S0!jjAhaQ6NGg4QZ z6(kTNZ%^rbc1lQh;|PvoU`R5RU13iHlHr7{O8&0_b2z!;??DdKHGHxrje~;C*(^uy zcZhajR0=sh@O2ihGfENi&67ds$*7)}a%N_2If1$Ql8p>e6jgbC$plNHpD&g8SVzth z(dLEQP&W-}YWD65ia`+p?QJmjrn*Xy-^Ul3qAD|f&mtz5DK8~vo{9;?)E~7Et(UZ0 z$62-Bx_acQz$s{tp6{{dtX;r{dwQQvHjjf&yy`EU z2~*b)*Y%4$&c)P-Cc?#+g zDntCGjO;^Cd~MCHd~YFX)n@$`DIog#b9}>}n@# z6or#`$C&r=1Oj^-uJT8hiRzfRfV+jk_ldF*;hC)Zs?XSIa*~pw<*BL zS-wAyv@5i{ITL1I@5@0+L1&Gee3h--Bpc4F+nn8gy3g-U^o3j2iSj(5m(PeCF~a#a zjcdEWp`rZD4iv#v3;XmPmRPn?Pz2M`uD5tEKGTbUTG~Zg2FVX%efRAZ_b&xKmEvVx zAhpkR`zjg9l+e4Z#K}MyqhdS)M0xJ{9-1{$L9UnbodOA9LHt>Qi6=Od>Ten z-aK>}(P;e!V$L>-p(}DzaO?%=+AC)nkzP^=+^RxR5Y;clt7A6^%w4<-Ks3#Oy=n3Fi}?6A`ZK zBe3FU_|%aS@i))`P7;Wk<$P7^6W1<)M)v~m^&8LR_WD0`vUQWKA(U9gb$|G|@Iz~a z%B`@%X7L4Ibgu0ln3Ap2Y>Nwxo%>98$YyE@fiD(CEn-Rq z!O&Nl{OFPZS1lAsRC=F6@RSG1X~CxZDNBb~7RPTP>)E5mU*2>auM=vZzP*w?tbC-~ z9N^m+a2H%0UVT{vI#$U7F{UD7pW|F>ge*{2GSpbTYSaBtN1NWw?k8UP_M_Pv>Be>s zIK&mN^s(9|sQXyq=h;f8A^l9MZu9-j88AWj!dz)f-myp8>P|j9h9a2~wqQE4! zYpI#whVM0b9$B=6Af*tTgCex+%Q_)G;XdndA|z%H-0%PeY2zAfM`^=bN-eMwbgyQ- zP;52rD-_!&ktIKE<@$5l*2P7NVM)Y;Ya9z}%K`7EG={}yOY4YpKM5ute1+|c7V<*d zNyd1my4>Bms;}aPxkVu)rk4+}&lOi#Gq>1~)Tsw%*H%E+wnHPYG8?A#S zhM;Bt8cB$i3hsAZRnKn{kWhfa!9ZBOHb(eu_d`c@2&Iz#uNj$n(XWpD zGQr-@h!G0X=1j1#&wY0fON&-b|-r7QF7TxS#tH_kHN{r27bcU z850=R)-wdD3(na>=8*)U@S2A53ldW+5)=cnO7n_?q_cI=-0kF$p6Um1F+o1ldKoP7 z{w9~SvakNTav62UiRxf8A{2JYy!Q!+tkaEP@?KW-XzvT&7$Tc?zV~8Pbhr{1yHuq^ zO+I$!mj$*`=^ig<^Lh$OoIefz?03?9bAJ2%pKjIXq#Yh{O}`wkO|F?{d7mE-o2y9F zA0!Vx0vIXW>2T>IT-n%*9LTef1fw-%Ys7oQ6Y?>^YhBtPZ}Dz&%J2{Fua$#BXRImH z89N2E#&5j0WigWlQh5e6Ozw7$Z?lOz5~k84UYYsxRTar>2V@5daboPK1DoEA%nq7k z9AdOU5PgJ^_;_>q5WGYf#4X8~^GmhdDLF?h zpAQ%$@0@|yD~BV&`Ef^8%n}QzQ!=Ix9VGf>RCK7R<%Wefw@Y!ph2d6s)c`IL?)DNN z=+i=YyInQj$;lM-y3!_x=2kH^BIc6F9?psdZ-ooCUIbb5qq`SB*;~$7eAuF-kWDRL zMU)Qzc)+j$irbZeW=8b8{3MgL912y)ChTD2`weiI)-@MSeA=vrkm@U7JK=4Ry`(hU zxVu7JCS00Oe^#WVyDGL4vENk5iYp!!+ttWI?%M2AEm3oAE(FjtZv>*ox;#ghyDLK1 z70$8d8s$#POl29*0*7sqvcOFX)q)w0JZky#=S1YjX2dGwby8{`oV+Ne4=&_OXO^bP zH@Hh5Jcxq?;31L=Ay2c?$hNUd#+sA!ic=co&^ZlSd=v3HyoEfoO~LGIBY0)MOX=qP znVokCwD`!5eWH%|bqSpH&H~hYz3Z}m(dO$yalze?Ic{S!Eo_l+a7cSHC2dZbPYwkEaF)U6Ac8wmz9k=mbH&42sc@$~=JLJh1R*vXNqqCpvVFk!Kyy z0JDnpZaIj8MtF#j+3LD^n7*Rg*IL7V38U3jTNI}TWGKZZ~U1ct=PBAouD}FG&Y0w-N ztL&3=8U46^WXWzC9;+Ppi5egODbI~yQ_toih9i{2vC~S~xC}|mJ*e>E1t>=h(DuUl zN)kIjLlxg0&-S;4RHc#o0P*k^gufF8J+={#!1zqq$pSDWpNe@6ZE}?+B7!7BHGFH0 zhYZRQNd`4ByIMEikf8UxF7Yzk@)`bN$9k|PtJ z0v+W0B*N~sDk>ZQIC1RAxr$TMT7`PmspKuR3PlCaMQ-fBh@0bTtII;qy(BtC%>_0l zpqTpOqv`>3oTp2l%b+<(8CtfN9QloDB>Z#3e88;L#+zgiK|miDq?ec zdRK-VkM7rp+V(*kyKQmwj`?63L7-R8orzEj+_-N^A*9VfdUH*GhR4c3QhVwenHLE% zKE|s=IZ3Hv_2MgZxh*I?%0~ew<$8*m)2H}tCuhp4$IQvzKvz7n;adiULMSy`zejgp zz}P7Lo|SyUP6W3d96gQe!AVRq%y$e;;((=NV|RXy{GNSnAG1BHW3v~?p|*lKeDT{)k&?g1G}Zcz_h#3|&9EnBb0 zJqRA(s>VWY!C4FG(!jwqh_f9(kKILEG{VAKVrBDk#J3uywoEBd7%N4=K8td=r8rj^ zjJq9R2eN!B1i=i#{LSU(G!CQdVLB6;ip|S^f>kRQyywX}xEZOrtn2|pm2HJW!j$dDDK*w?hW#Xal1LF2B$Ab% zA{V2Z=Ilik9q~>0YR#A+g$Unq_pX;$GOorkb*8}>mZTa`toOF6_R`&*HD=m}x0v8Q z8Q@48cGT5g&IlR0OH%v}QHu~}c$a6WPR>1%@#pi4VHts%CM_+-SOxNJW!u5)A;O{x z2DOD2Fh||D*Sk;y88@zOg*6>J&EhpVE1C~ttKN#!LQlZOl=!GQ)K|RCQ+X2H8R+3` zbBO~pvSK;9PD$!IlLm1^)5=BXxvvUVUY&F%58m--r^kGuB##`c_-h?mA}3n-=nU22 zs;_%Zk#E$J-Q1_hvcw?yRhozzFsIRmKlobLe<@hO2jaF}o6m~N{w7Qm{(;2!VJMFs z6h6`)N|fMddwX9qm86r=jAILfa+=Z+Wof8}dP;QbZyvH9@;BI`;@2m?syy6#+ww5D zYU>o-_AJJ7Y~L2drA0{L9V4%Ohe+W*2^|hLq79Cw!a`%xVyvve>B1kuqR;{)p@wd( z1OUXy08m83QX!Fctw6@l7(bb~sZe)E?qZ8E3p_(iBC)et5+H8#0~1R}ZZ0mEp)4g2 z;v$s|ogeLSrETE>f;=)qUSLZdf-fq1Jgy`gP7yjb_SaeuY7kbYVMAlu6F%%lr z{I>x;s~M%qz|#K4Vw7W8&LY5L_0C;WsQRT{T+69Mq_8ac}T;$+v6*nQB zy{k=#scH#B4q=Nq_HLg+c?u!@f{A=7PtGB zfk)LJUh97(W54p;L-;^y=!BL20>*nT=*TrH4O|8>za1yW+#}4)%>Xm90a3M-#?k1i zQ^FKtdLBHOrnJWqZ99hGrBcudJj#N5WvT%ehf&Ihqyb^2v1OHg(O_GcH+a#{Whq=) zMNRyZ7oq?a?1~xty$dGkV=MJ}x${{eAp3tyne3A2;HJo_P&VzcQ)%d5wGxz54sT?e zgOwCMpC#juIF*JcADo;NQmw=R$~s)r(o3Zx>eQ_mZ^xjfm8z%kNwX`?u_rIzvHBtW zn3D&3YekH1o(#=vJmaj0=3YwNhuHJT7_!A5hBn7bAaJrt4>MLvnCU_?;r-yLvo#Gn zx5KDZ0}^bF=@TX%gkkM`*j$ziY^ymdycOu7gIk=W2XNvKSx@+5m_@!_EKpjNk6k=|*x{2fP>QkRybJgr@ zPeT&+3?q&{xP6Ma&7sK|b$1K)L1yAvEozR-e!-&@H&MaS;sCSfw=+1;4daq4>3S91nLP6Nr{!C-R3Sxj zXN%@Dhlc11`d=}T%8g179A;2iVaphYb`VII*++mdQW=n_tY%^B7`#vM4*sS5pGz_6 zJb$m*ciye`m;yC&4GHIu^`;9glt2c{{?UNCrH*4&i!r$56qx-p_`na}nhVMmpWPe8 z5Jkg+L37%Z@;|yC4D0FU#Y6_3IB`15+3gOS^DI8U17>R@_I{wBArm{1kuqLl{1FFs zu*v*+5}#a?Mkwu*Je&F$wFuXasbTK&hO>fF*D`8D*L&o5kfl_!_jVpI& zB{+KtuqJBH`?@;&p^wii>|fPy-}1MeCl&g8$#GqX={wa8*31+ywzvV++3K_u#@#ky z((5$Xa&Y89^9yZMUPqa7NuU@ETb=*LFTJsr$=3jQ)$U3*ryh>BNsPx0UekVT@qyE9 z4gNF-<(Xn=wYFfOrE7OLL3)JPAhGs6i(f1Q?U9xaXyoMSgk)1IdFJdMGQOZXtV~1A z|ALg{-GaSqc$Y`0u2OIJg@rWct;k(dmySwWfO|uXX^=l5L0eA3(gr<0c<6Kg0%Vc- znfHYVjRbplo**Jy_ZNgmbubp>?A4i^SI@06JJQQrty5k~;MzO#qCl(ab}Tz*e-7@= zBP<-EGmUahmiF$2U0bP_>ZsDZ3wYL%?`xG0MYE2u(DiR=vq$6H56?(ZULCLg7Cx62 ziCV{)krALJ&&TFnW__-!mZBGTQ5d)S;XBGR2|a;s-W>{nR3lf|DX{UciV=2A#vNz` zFhrs25b27i(uGqNHS_?i@8#UgKQ~#1CE~f);t%VIQlgyu4;|*|75~oR{j#?Le)v-P7VKPO2#k~FDPN4&3wLV$gpL%!4^>Hlyj3SijFx0 zBKhHLSR`F?03p!2?3XJtfz&KZT(qRC@H>R}w4mCgF7}<6fP#{T;unTWBW}+WzUDm+ z!%393OAU0teR_V7OG~4!*?)0_I+@<;6P2#*V6%5(G0Eh&czvDDzpDHw$EnS?27kmy zOL#TyFc{DYQ>Y7c@CUMDG4AQ~+HPOzBs5+r5<}F2#a~(t*;ue>gFYL!kjbQCTcPk3 z$}N>RkYenhQUVDf{sd;#@pL{i!8*Fk{a}V(vqH88Nb&{LhB3~%^;$uDkAv}*3}ePy z%qw_iZFhOHca%4gh&Z!l(H(IttQn=V3aGL`5-1KMp#)jFn#_VFUu6HiIn^=Mq@Gsz zF^3XJ6o80H2%KA&yMDF#*B5a?+vex)gBe-#O|O5j>$7!xWE@yp_1>|gJE4Y$ukIt- zHs$XmA^!a4d(OrRTRmDGEnR<09E+>_Ee%T z?`NRTR94tCyB<;ALyRg1YOkCCrn6N2L>tgYxW86aviBOi#*#eqp@gFohKpfFqBsZf1b!i9=3hu4)89hV>qf?`8}G{)%3 zfXhs@L?l$iK}G*e7g)m;c5vT$q|VNH{y0<9dY5WL!pW|9okY?5Gy`vL{8A9gg2ggk z>)XMzDviY4OP-LJ=F& z{8=FXA(j?*_N{bG%8%^mq3|zG6CJbxq4RpK;FuhRSrx16EF~|g1HEJk- zbB&4=0-(fuphwU+B1>)Md!&o#OU$!EW>3-|jc@sU}aOW zkq2pJ0ckn$snpjQ)L_NwuoVHFOrBdoy$Ndl>9q1MM+#HZrCswTipeNXnW%nDoxCqM zamm;5%(tar{7&h-Z9*iH7N+s`iKvws)`sI1L4;pZ#OiOa*?gSW$Z_OPsfRoMnEB0r E0mO +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include +#include + +class AudioWidget : public QWidget +{ +public: + AudioWidget(); + void setFile(const QString &file); + +private slots: + void updatePosition(); + void newOcclusion(); + void modeChanged(); + void fileChanged(const QString &file); + void openFileDialog(); + void updateRoom(); + void animateChanged(); + +private: + QLineEdit *fileEdit = nullptr; + QPushButton *fileDialogButton = nullptr; + QSlider *azimuth = nullptr; + QSlider *elevation = nullptr; + QSlider *distance = nullptr; + QSlider *occlusion = nullptr; + QSlider *roomDimension = nullptr; + QSlider *reverbGain = nullptr; + QSlider *reflectionGain = nullptr; + QComboBox *mode = nullptr; + QCheckBox *animateButton = nullptr; + QPropertyAnimation *animation = nullptr; + + QAudioEngine engine; + QAudioListener *listener = nullptr; + QSpatialSound *sound = nullptr; + QAudioRoom *room = nullptr; + QFileDialog *fileDialog = nullptr; +}; + +AudioWidget::AudioWidget() + : QWidget() +{ + setMinimumSize(400, 300); + auto *form = new QFormLayout(this); + + auto *fileLayout = new QHBoxLayout; + fileEdit = new QLineEdit; + fileEdit->setPlaceholderText(tr("Audio File")); + fileLayout->addWidget(fileEdit); + fileDialogButton = new QPushButton(tr("Choose...")); + fileLayout->addWidget(fileDialogButton); + form->addRow(fileLayout); + + azimuth = new QSlider(Qt::Horizontal); + azimuth->setRange(-180, 180); + form->addRow(tr("Azimuth (-180 - 180 degree):"), azimuth); + + elevation = new QSlider(Qt::Horizontal); + elevation->setRange(-90, 90); + form->addRow(tr("Elevation (-90 - 90 degree)"), elevation); + + distance = new QSlider(Qt::Horizontal); + distance->setRange(0, 1000); + distance->setValue(100); + form->addRow(tr("Distance (0 - 10 meter):"), distance); + + occlusion = new QSlider(Qt::Horizontal); + occlusion->setRange(0, 400); + form->addRow(tr("Occlusion (0 - 4):"), occlusion); + + roomDimension = new QSlider(Qt::Horizontal); + roomDimension->setRange(0, 10000); + roomDimension->setValue(1000); + form->addRow(tr("Room dimension (0 - 100 meter):"), roomDimension); + + reverbGain = new QSlider(Qt::Horizontal); + reverbGain->setRange(0, 500); + reverbGain->setValue(0); + form->addRow(tr("Reverb gain (0-5):"), reverbGain); + + reflectionGain = new QSlider(Qt::Horizontal); + reflectionGain->setRange(0, 500); + reflectionGain->setValue(0); + form->addRow(tr("Reflection gain (0-5):"), reflectionGain); + + mode = new QComboBox; + mode->addItem(tr("Surround"), QVariant::fromValue(QAudioEngine::Surround)); + mode->addItem(tr("Stereo"), QVariant::fromValue(QAudioEngine::Stereo)); + mode->addItem(tr("Headphone"), QVariant::fromValue(QAudioEngine::Headphone)); + + form->addRow(tr("Output mode:"), mode); + + animateButton = new QCheckBox(tr("Animate sound position")); + form->addRow(animateButton); + + connect(fileEdit, &QLineEdit::textChanged, this, &AudioWidget::fileChanged); + connect(fileDialogButton, &QPushButton::clicked, this, &AudioWidget::openFileDialog); + + connect(azimuth, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(elevation, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(distance, &QSlider::valueChanged, this, &AudioWidget::updatePosition); + connect(occlusion, &QSlider::valueChanged, this, &AudioWidget::newOcclusion); + + connect(roomDimension, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + connect(reverbGain, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + connect(reflectionGain, &QSlider::valueChanged, this, &AudioWidget::updateRoom); + + connect(mode, &QComboBox::currentIndexChanged, this, &AudioWidget::modeChanged); + + room = new QAudioRoom(&engine); + room->setWallMaterial(QAudioRoom::BackWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::FrontWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::LeftWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::RightWall, QAudioRoom::BrickBare); + room->setWallMaterial(QAudioRoom::Floor, QAudioRoom::Marble); + room->setWallMaterial(QAudioRoom::Ceiling, QAudioRoom::WoodCeiling); + updateRoom(); + + listener = new QAudioListener(&engine); + listener->setPosition({}); + listener->setRotation({}); + engine.start(); + + sound = new QSpatialSound(&engine); + updatePosition(); + + animation = new QPropertyAnimation(azimuth, "value"); + animation->setDuration(10000); + animation->setStartValue(-180); + animation->setEndValue(180); + animation->setLoopCount(-1); + connect(animateButton, &QCheckBox::toggled, this, &AudioWidget::animateChanged); +} + +void AudioWidget::setFile(const QString &file) +{ + fileEdit->setText(file); +} + +void AudioWidget::updatePosition() +{ + const float az = azimuth->value() / 180. * M_PI; + const float el = elevation->value() / 180. * M_PI; + const float d = distance->value(); + + const float x = d * sin(az) * cos(el); + const float y = d * sin(el); + const float z = -d * cos(az) * cos(el); + sound->setPosition({x, y, z}); +} + +void AudioWidget::newOcclusion() +{ + sound->setOcclusionIntensity(occlusion->value() / 100.); +} + +void AudioWidget::modeChanged() +{ + engine.setOutputMode(mode->currentData().value()); +} + +void AudioWidget::fileChanged(const QString &file) +{ + sound->setSource(QUrl::fromLocalFile(file)); + sound->setSize(5); + sound->setLoops(QSpatialSound::Infinite); +} + +void AudioWidget::openFileDialog() +{ + if (fileDialog == nullptr) { + const QString dir = QStandardPaths::writableLocation(QStandardPaths::MusicLocation); + fileDialog = new QFileDialog(this, tr("Open Audio File"), dir); + fileDialog->setAcceptMode(QFileDialog::AcceptOpen); + const QStringList mimeTypes{"audio/mpeg", "audio/aac", "audio/x-ms-wma", + "audio/x-flac+ogg", "audio/x-wav"}; + fileDialog->setMimeTypeFilters(mimeTypes); + fileDialog->selectMimeTypeFilter(mimeTypes.constFirst()); + } + + if (fileDialog->exec() == QDialog::Accepted) + fileEdit->setText(fileDialog->selectedFiles().constFirst()); +} + +void AudioWidget::updateRoom() +{ + const float d = roomDimension->value(); + room->setDimensions(QVector3D(d, d, 400)); + room->setReflectionGain(float(reflectionGain->value()) / 100); + room->setReverbGain(float(reverbGain->value()) / 100); +} + +void AudioWidget::animateChanged() +{ + if (animateButton->isChecked()) + animation->start(); + else + animation->stop(); +} + +int main(int argc, char **argv) +{ + QApplication app(argc, argv); + + QCoreApplication::setApplicationVersion(qVersion()); + QGuiApplication::setApplicationDisplayName(AudioWidget::tr("Spatial Audio test application")); + + QCommandLineParser commandLineParser; + commandLineParser.addVersionOption(); + commandLineParser.addHelpOption(); + commandLineParser.addPositionalArgument("Audio File", + "Audio File to play"); + + commandLineParser.process(app); + + AudioWidget w; + w.show(); + + if (!commandLineParser.positionalArguments().isEmpty()) + w.setFile(commandLineParser.positionalArguments().constFirst()); + + return app.exec(); +} diff --git a/examples/spatialaudio/spatialaudio.pro b/examples/spatialaudio/spatialaudio.pro new file mode 100644 index 0000000..80039c1 --- /dev/null +++ b/examples/spatialaudio/spatialaudio.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs +SUBDIRS += audiopanning + diff --git a/licenseRule.json b/licenseRule.json new file mode 100644 index 0000000..2f922da --- /dev/null +++ b/licenseRule.json @@ -0,0 +1,114 @@ +[ + { + "comment" : ["file_pattern_ending: strings matched against the end of a file name.", + "location keys: regular expression matched against the beginning of", + "the file path (relative to the git submodule root).", + "spdx: list of SPDX-License-Expression's allowed in the matching files.", + "-------------------------------------------------------", + "Files with the following endings are Build System licensed,", + "unless they are examples", + "Files with other endings can also be build system files" + ], + "file_pattern_ending" : ["CMakeLists.txt", ".cmake", ".pro", ".pri", ".prf", + "configure", "configure.bat", "cmake.in", "plist.in", "CMakeLists.txt.in", ".ver"], + "location" : { + "" : { + "comment" : "Default", + "file type" : "build system", + "spdx" : ["BSD-3-Clause"] + }, + "(.*)(examples/|snippets/)" : { + "comment" : "Example takes precedence", + "file type" : "examples and snippets", + "spdx" : ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + } + } + }, + { + "comments" : ["Files with the following endings are Tool licensed,", + "unless they are examples.", + "Files with other endings can also be tool files."], + "file_pattern_ending" : [".sh", ".py", ".pl", ".bat", ".ps1"], + "location" :{ + "" : { + "comment" : "Default", + "file type" : "tools and utils", + "spdx" : ["LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0"] + }, + "(.*)(examples/|snippets/)" : { + "comment" : "Example takes precedence", + "file type" : "examples and snippets", + "spdx" : ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + } + } + }, + { + "comment" : "Files with the following endings are Documentation licensed.", + "file_pattern_ending" : [".qdoc", ".qdocinc" , ".qdocconf", ".txt", "README", "qt_attribution.json"], + "location" :{ + "" : { + "comment" : "", + "file type" : "documentation", + "spdx" : ["LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only"] + } + } + }, + { + "comment" : ["All other files", + "The licensing is defined only by the file location in the Qt module repository.", + "NO key for this case!", + "This needs to be the last entry of the file."], + "location" : { + "" : { + "comment" : "Default", + "file type" : "module and plugin", + "spdx" : ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only"] + }, + "src/" : { + "comment" : "Default", + "file type" : "module and plugin", + "spdx" : ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-2.0-only OR GPL-3.0-only"] + }, + "src/spatialaudioquick3d/" : { + "comment" : "Special case", + "file type" : "module and plugin", + "spdx" : ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "src/spatialaudio/" : { + "comment" : "Special case", + "file type" : "module and plugin", + "spdx" : ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "src/resonance-audio/" : { + "comment" : "Special case", + "file type" : "module and plugin", + "spdx" : ["LicenseRef-Qt-Commercial OR LGPL-3.0-only OR GPL-3.0-only"] + }, + "tests/" : { + "comment" : "Default", + "file type" : "test", + "spdx" : ["LicenseRef-Qt-Commercial OR GPL-3.0-only"] + }, + "(.*)(examples/|snippets/)" : { + "comment" : "Default", + "file type" : "examples and snippets", + "spdx" : ["LicenseRef-Qt-Commercial OR BSD-3-Clause"] + }, + "config\\.tests/" : { + "comment" : "Default", + "file type" : "build system", + "spdx" : ["BSD-3-Clause"] + }, + "util/" : { + "comment" : "Default", + "file type" : "util", + "spdx" : ["LicenseRef-Qt-Commercial OR GPL-3.0-only WITH Qt-GPL-exception-1.0"] + }, + "src/multimediatestlib/" : { + "comment" : "Library only for Qt tests", + "file type" : "util", + "spdx" : ["LicenseRef-Qt-Commercial OR GPL-3.0-only"] + } + } + } +] diff --git a/qt_cmdline.cmake b/qt_cmdline.cmake new file mode 100644 index 0000000..42d2da5 --- /dev/null +++ b/qt_cmdline.cmake @@ -0,0 +1,4 @@ +# Copyright (C) 2024 The Qt Company Ltd. +# SPDX-License-Identifier: BSD-3-Clause + +qt_commandline_subconfig(src/multimedia) diff --git a/src/3rdparty/eigen/COPYING.BSD b/src/3rdparty/eigen/COPYING.BSD new file mode 100644 index 0000000..25a08de --- /dev/null +++ b/src/3rdparty/eigen/COPYING.BSD @@ -0,0 +1,24 @@ + Copyright (c) 2011, Intel Corporation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. diff --git a/src/3rdparty/eigen/COPYING.MPL2 b/src/3rdparty/eigen/COPYING.MPL2 new file mode 100644 index 0000000..14e2f77 --- /dev/null +++ b/src/3rdparty/eigen/COPYING.MPL2 @@ -0,0 +1,373 @@ +Mozilla Public License Version 2.0 +================================== + +1. Definitions +-------------- + +1.1. "Contributor" + means each individual or legal entity that creates, contributes to + the creation of, or owns Covered Software. + +1.2. "Contributor Version" + means the combination of the Contributions of others (if any) used + by a Contributor and that particular Contributor's Contribution. + +1.3. "Contribution" + means Covered Software of a particular Contributor. + +1.4. "Covered Software" + means Source Code Form to which the initial Contributor has attached + the notice in Exhibit A, the Executable Form of such Source Code + Form, and Modifications of such Source Code Form, in each case + including portions thereof. + +1.5. "Incompatible With Secondary Licenses" + means + + (a) that the initial Contributor has attached the notice described + in Exhibit B to the Covered Software; or + + (b) that the Covered Software was made available under the terms of + version 1.1 or earlier of the License, but not also under the + terms of a Secondary License. + +1.6. "Executable Form" + means any form of the work other than Source Code Form. + +1.7. "Larger Work" + means a work that combines Covered Software with other material, in + a separate file or files, that is not Covered Software. + +1.8. "License" + means this document. + +1.9. "Licensable" + means having the right to grant, to the maximum extent possible, + whether at the time of the initial grant or subsequently, any and + all of the rights conveyed by this License. + +1.10. "Modifications" + means any of the following: + + (a) any file in Source Code Form that results from an addition to, + deletion from, or modification of the contents of Covered + Software; or + + (b) any new file in Source Code Form that contains any Covered + Software. + +1.11. "Patent Claims" of a Contributor + means any patent claim(s), including without limitation, method, + process, and apparatus claims, in any patent Licensable by such + Contributor that would be infringed, but for the grant of the + License, by the making, using, selling, offering for sale, having + made, import, or transfer of either its Contributions or its + Contributor Version. + +1.12. "Secondary License" + means either the GNU General Public License, Version 2.0, the GNU + Lesser General Public License, Version 2.1, the GNU Affero General + Public License, Version 3.0, or any later versions of those + licenses. + +1.13. "Source Code Form" + means the form of the work preferred for making modifications. + +1.14. "You" (or "Your") + means an individual or a legal entity exercising rights under this + License. For legal entities, "You" includes any entity that + controls, is controlled by, or is under common control with You. For + purposes of this definition, "control" means (a) the power, direct + or indirect, to cause the direction or management of such entity, + whether by contract or otherwise, or (b) ownership of more than + fifty percent (50%) of the outstanding shares or beneficial + ownership of such entity. + +2. License Grants and Conditions +-------------------------------- + +2.1. Grants + +Each Contributor hereby grants You a world-wide, royalty-free, +non-exclusive license: + +(a) under intellectual property rights (other than patent or trademark) + Licensable by such Contributor to use, reproduce, make available, + modify, display, perform, distribute, and otherwise exploit its + Contributions, either on an unmodified basis, with Modifications, or + as part of a Larger Work; and + +(b) under Patent Claims of such Contributor to make, use, sell, offer + for sale, have made, import, and otherwise transfer either its + Contributions or its Contributor Version. + +2.2. Effective Date + +The licenses granted in Section 2.1 with respect to any Contribution +become effective for each Contribution on the date the Contributor first +distributes such Contribution. + +2.3. Limitations on Grant Scope + +The licenses granted in this Section 2 are the only rights granted under +this License. No additional rights or licenses will be implied from the +distribution or licensing of Covered Software under this License. +Notwithstanding Section 2.1(b) above, no patent license is granted by a +Contributor: + +(a) for any code that a Contributor has removed from Covered Software; + or + +(b) for infringements caused by: (i) Your and any other third party's + modifications of Covered Software, or (ii) the combination of its + Contributions with other software (except as part of its Contributor + Version); or + +(c) under Patent Claims infringed by Covered Software in the absence of + its Contributions. + +This License does not grant any rights in the trademarks, service marks, +or logos of any Contributor (except as may be necessary to comply with +the notice requirements in Section 3.4). + +2.4. Subsequent Licenses + +No Contributor makes additional grants as a result of Your choice to +distribute the Covered Software under a subsequent version of this +License (see Section 10.2) or under the terms of a Secondary License (if +permitted under the terms of Section 3.3). + +2.5. Representation + +Each Contributor represents that the Contributor believes its +Contributions are its original creation(s) or it has sufficient rights +to grant the rights to its Contributions conveyed by this License. + +2.6. Fair Use + +This License is not intended to limit any rights You have under +applicable copyright doctrines of fair use, fair dealing, or other +equivalents. + +2.7. Conditions + +Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted +in Section 2.1. + +3. Responsibilities +------------------- + +3.1. Distribution of Source Form + +All distribution of Covered Software in Source Code Form, including any +Modifications that You create or to which You contribute, must be under +the terms of this License. You must inform recipients that the Source +Code Form of the Covered Software is governed by the terms of this +License, and how they can obtain a copy of this License. You may not +attempt to alter or restrict the recipients' rights in the Source Code +Form. + +3.2. Distribution of Executable Form + +If You distribute Covered Software in Executable Form then: + +(a) such Covered Software must also be made available in Source Code + Form, as described in Section 3.1, and You must inform recipients of + the Executable Form how they can obtain a copy of such Source Code + Form by reasonable means in a timely manner, at a charge no more + than the cost of distribution to the recipient; and + +(b) You may distribute such Executable Form under the terms of this + License, or sublicense it under different terms, provided that the + license for the Executable Form does not attempt to limit or alter + the recipients' rights in the Source Code Form under this License. + +3.3. Distribution of a Larger Work + +You may create and distribute a Larger Work under terms of Your choice, +provided that You also comply with the requirements of this License for +the Covered Software. If the Larger Work is a combination of Covered +Software with a work governed by one or more Secondary Licenses, and the +Covered Software is not Incompatible With Secondary Licenses, this +License permits You to additionally distribute such Covered Software +under the terms of such Secondary License(s), so that the recipient of +the Larger Work may, at their option, further distribute the Covered +Software under the terms of either this License or such Secondary +License(s). + +3.4. Notices + +You may not remove or alter the substance of any license notices +(including copyright notices, patent notices, disclaimers of warranty, +or limitations of liability) contained within the Source Code Form of +the Covered Software, except that You may alter any license notices to +the extent required to remedy known factual inaccuracies. + +3.5. Application of Additional Terms + +You may choose to offer, and to charge a fee for, warranty, support, +indemnity or liability obligations to one or more recipients of Covered +Software. However, You may do so only on Your own behalf, and not on +behalf of any Contributor. You must make it absolutely clear that any +such warranty, support, indemnity, or liability obligation is offered by +You alone, and You hereby agree to indemnify every Contributor for any +liability incurred by such Contributor as a result of warranty, support, +indemnity or liability terms You offer. You may include additional +disclaimers of warranty and limitations of liability specific to any +jurisdiction. + +4. Inability to Comply Due to Statute or Regulation +--------------------------------------------------- + +If it is impossible for You to comply with any of the terms of this +License with respect to some or all of the Covered Software due to +statute, judicial order, or regulation then You must: (a) comply with +the terms of this License to the maximum extent possible; and (b) +describe the limitations and the code they affect. Such description must +be placed in a text file included with all distributions of the Covered +Software under this License. Except to the extent prohibited by statute +or regulation, such description must be sufficiently detailed for a +recipient of ordinary skill to be able to understand it. + +5. Termination +-------------- + +5.1. The rights granted under this License will terminate automatically +if You fail to comply with any of its terms. However, if You become +compliant, then the rights granted under this License from a particular +Contributor are reinstated (a) provisionally, unless and until such +Contributor explicitly and finally terminates Your grants, and (b) on an +ongoing basis, if such Contributor fails to notify You of the +non-compliance by some reasonable means prior to 60 days after You have +come back into compliance. Moreover, Your grants from a particular +Contributor are reinstated on an ongoing basis if such Contributor +notifies You of the non-compliance by some reasonable means, this is the +first time You have received notice of non-compliance with this License +from such Contributor, and You become compliant prior to 30 days after +Your receipt of the notice. + +5.2. If You initiate litigation against any entity by asserting a patent +infringement claim (excluding declaratory judgment actions, +counter-claims, and cross-claims) alleging that a Contributor Version +directly or indirectly infringes any patent, then the rights granted to +You by any and all Contributors for the Covered Software under Section +2.1 of this License shall terminate. + +5.3. In the event of termination under Sections 5.1 or 5.2 above, all +end user license agreements (excluding distributors and resellers) which +have been validly granted by You or Your distributors under this License +prior to termination shall survive termination. + +************************************************************************ +* * +* 6. Disclaimer of Warranty * +* ------------------------- * +* * +* Covered Software is provided under this License on an "as is" * +* basis, without warranty of any kind, either expressed, implied, or * +* statutory, including, without limitation, warranties that the * +* Covered Software is free of defects, merchantable, fit for a * +* particular purpose or non-infringing. The entire risk as to the * +* quality and performance of the Covered Software is with You. * +* Should any Covered Software prove defective in any respect, You * +* (not any Contributor) assume the cost of any necessary servicing, * +* repair, or correction. This disclaimer of warranty constitutes an * +* essential part of this License. No use of any Covered Software is * +* authorized under this License except under this disclaimer. * +* * +************************************************************************ + +************************************************************************ +* * +* 7. Limitation of Liability * +* -------------------------- * +* * +* Under no circumstances and under no legal theory, whether tort * +* (including negligence), contract, or otherwise, shall any * +* Contributor, or anyone who distributes Covered Software as * +* permitted above, be liable to You for any direct, indirect, * +* special, incidental, or consequential damages of any character * +* including, without limitation, damages for lost profits, loss of * +* goodwill, work stoppage, computer failure or malfunction, or any * +* and all other commercial damages or losses, even if such party * +* shall have been informed of the possibility of such damages. This * +* limitation of liability shall not apply to liability for death or * +* personal injury resulting from such party's negligence to the * +* extent applicable law prohibits such limitation. Some * +* jurisdictions do not allow the exclusion or limitation of * +* incidental or consequential damages, so this exclusion and * +* limitation may not apply to You. * +* * +************************************************************************ + +8. Litigation +------------- + +Any litigation relating to this License may be brought only in the +courts of a jurisdiction where the defendant maintains its principal +place of business and such litigation shall be governed by laws of that +jurisdiction, without reference to its conflict-of-law provisions. +Nothing in this Section shall prevent a party's ability to bring +cross-claims or counter-claims. + +9. Miscellaneous +---------------- + +This License represents the complete agreement concerning the subject +matter hereof. If any provision of this License is held to be +unenforceable, such provision shall be reformed only to the extent +necessary to make it enforceable. Any law or regulation which provides +that the language of a contract shall be construed against the drafter +shall not be used to construe this License against a Contributor. + +10. Versions of the License +--------------------------- + +10.1. New Versions + +Mozilla Foundation is the license steward. Except as provided in Section +10.3, no one other than the license steward has the right to modify or +publish new versions of this License. Each version will be given a +distinguishing version number. + +10.2. Effect of New Versions + +You may distribute the Covered Software under the terms of the version +of the License under which You originally received the Covered Software, +or under the terms of any subsequent version published by the license +steward. + +10.3. Modified Versions + +If you create software not governed by this License, and you want to +create a new license for such software, you may create and use a +modified version of this License if you rename the license and remove +any references to the name of the license steward (except to note that +such modified license differs from this License). + +10.4. Distributing Source Code Form that is Incompatible With Secondary +Licenses + +If You choose to distribute Source Code Form that is Incompatible With +Secondary Licenses under the terms of this version of the License, the +notice described in Exhibit B of this License must be attached. + +Exhibit A - Source Code Form License Notice +------------------------------------------- + + This Source Code Form is subject to the terms of the Mozilla Public + License, v. 2.0. If a copy of the MPL was not distributed with this + file, You can obtain one at http://mozilla.org/MPL/2.0/. + +If it is not possible or desirable to put the notice in a particular +file, then You may include the notice in a location (such as a LICENSE +file in a relevant directory) where a recipient would be likely to look +for such a notice. + +You may add additional accurate notices of copyright ownership. + +Exhibit B - "Incompatible With Secondary Licenses" Notice +--------------------------------------------------------- + + This Source Code Form is "Incompatible With Secondary Licenses", as + defined by the Mozilla Public License, v. 2.0. diff --git a/src/3rdparty/eigen/COPYING.README b/src/3rdparty/eigen/COPYING.README new file mode 100644 index 0000000..de5b632 --- /dev/null +++ b/src/3rdparty/eigen/COPYING.README @@ -0,0 +1,18 @@ +Eigen is primarily MPL2 licensed. See COPYING.MPL2 and these links: + http://www.mozilla.org/MPL/2.0/ + http://www.mozilla.org/MPL/2.0/FAQ.html + +Some files contain third-party code under BSD or LGPL licenses, whence the other +COPYING.* files here. + +All the LGPL code is either LGPL 2.1-only, or LGPL 2.1-or-later. +For this reason, the COPYING.LGPL file contains the LGPL 2.1 text. + +If you want to guarantee that the Eigen code that you are #including is licensed +under the MPL2 and possibly more permissive licenses (like BSD), #define this +preprocessor symbol: + EIGEN_MPL2_ONLY +For example, with most compilers, you could add this to your project CXXFLAGS: + -DEIGEN_MPL2_ONLY +This will cause a compilation error to be generated if you #include any code that is +LGPL licensed. diff --git a/src/3rdparty/eigen/COPYRIGHTS b/src/3rdparty/eigen/COPYRIGHTS new file mode 100644 index 0000000..d5884f2 --- /dev/null +++ b/src/3rdparty/eigen/COPYRIGHTS @@ -0,0 +1,45 @@ +Copyright (c) 2012 Alexey Korepanov +Copyright (c) 2020 Antonio Sanchez +Copyright (c) 2020 Arm Limited and Contributors +Copyright (c) 2006-2011 Benoit Jacob +Copyright (c) 2014-2016 Benoit Steiner (benoit.steiner.goog@gmail.com) +Copyright (c) 16 BfToF32Even (c) Packet4f +Copyright (c) 16 BfToF32Odd (c) Packet4f +Copyright (c) 2021 C. Antonio Sanchez +Copyright (c) 2021 Chip Kerchner (chip.kerchner@ibm.com) +Copyright (c) 2009 Claire Maurice +Copyright (c) 2017 Codeplay Software Limited +Copyright (c) 2016 Eugene Brevdo +Copyright (c) 2020 Everton Constantino (everton.constantino@ibm.com) +Copyright (c) 2016 Fabian Giesen +Copyright (c) 2008-2019 Gael Guennebaud +Copyright (c) 2013 Gauthier Brun +Copyright (c) 2010-2013 Hauke Heibel +Copyright (c) 2009 Hauke Heibel +Copyright (c) 2001, 2010, 2011 Intel Corporation +Copyright (c) 2013 Jean Ceccato +Copyright (c) 2010-2012 Jitse Niesen +Copyright (c) 2013 Jitse Niesen +Copyright (c) 2007 Julien Pommier +Copyright (c) 2009 Keir Mierle +Copyright (c) 2009 Kenneth Riddile +Copyright (c) 2008-2016 Konstantinos Margaritis +Copyright (c) 2009 Mathieu Gautier +Copyright (c) 2007 Michael Olbrich +Copyright (c) 2021 NVIDIA CORPORATION. +Copyright (c) 2013 Nicolas Carre +Copyright (c) 2014-2015 Open Source Robotics Foundation +Copyright (c) 2013 Pavel Holoborodko +Copyright (c) 2014, 2016 Pedro Gonnet (pedro.gonnet@gmail.com) +Copyright (c) 2013 Pierre Zoppitelli +Copyright (c) 2016, 2018, 2019 Rasmus Munk Larsen (rmlarsen@google.com) +Copyright (c) 2009 Ricard Marxer +Copyright (c) 2009 Rohit Garg +Copyright (c) 2017 The TensorFlow Authors +Copyright (c) 2010 Thomas Capricelli +Copyright (c) 2011 Timothy E. Holy tim.holy@gmail.com +Copyright (c) 2016 Tobias Wood +Copyright (c) 2010 Vincent Lejeune +Copyright (c) 2018 Wave Computing, Inc. +Copyright (c) 2011-2014 Willow Garage, Inc. +Copyright (c) 2014 yoco diff --git a/src/3rdparty/eigen/Eigen/Cholesky b/src/3rdparty/eigen/Eigen/Cholesky new file mode 100644 index 0000000..a318ceb --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Cholesky @@ -0,0 +1,45 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CHOLESKY_MODULE_H +#define EIGEN_CHOLESKY_MODULE_H + +#include "Core" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Cholesky_Module Cholesky module + * + * + * + * This module provides two variants of the Cholesky decomposition for selfadjoint (hermitian) matrices. + * Those decompositions are also accessible via the following methods: + * - MatrixBase::llt() + * - MatrixBase::ldlt() + * - SelfAdjointView::llt() + * - SelfAdjointView::ldlt() + * + * \code + * #include + * \endcode + */ + +#include "src/Cholesky/LLT.h" +#include "src/Cholesky/LDLT.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/Cholesky/LLT_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CHOLESKY_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Core b/src/3rdparty/eigen/Eigen/Core new file mode 100644 index 0000000..5921e15 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Core @@ -0,0 +1,384 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2011 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CORE_H +#define EIGEN_CORE_H + +// first thing Eigen does: stop the compiler from reporting useless warnings. +#include "src/Core/util/DisableStupidWarnings.h" + +// then include this file where all our macros are defined. It's really important to do it first because +// it's where we do all the compiler/OS/arch detections and define most defaults. +#include "src/Core/util/Macros.h" + +// This detects SSE/AVX/NEON/etc. and configure alignment settings +#include "src/Core/util/ConfigureVectorization.h" + +// We need cuda_runtime.h/hip_runtime.h to ensure that +// the EIGEN_USING_STD macro works properly on the device side +#if defined(EIGEN_CUDACC) + #include +#elif defined(EIGEN_HIPCC) + #include +#endif + + +#ifdef EIGEN_EXCEPTIONS + #include +#endif + +// Disable the ipa-cp-clone optimization flag with MinGW 6.x or newer (enabled by default with -O3) +// See http://eigen.tuxfamily.org/bz/show_bug.cgi?id=556 for details. +#if EIGEN_COMP_MINGW && EIGEN_GNUC_AT_LEAST(4,6) && EIGEN_GNUC_AT_MOST(5,5) + #pragma GCC optimize ("-fno-ipa-cp-clone") +#endif + +// Prevent ICC from specializing std::complex operators that silently fail +// on device. This allows us to use our own device-compatible specializations +// instead. +#if defined(EIGEN_COMP_ICC) && defined(EIGEN_GPU_COMPILE_PHASE) \ + && !defined(_OVERRIDE_COMPLEX_SPECIALIZATION_) +#define _OVERRIDE_COMPLEX_SPECIALIZATION_ 1 +#endif +#include + +// this include file manages BLAS and MKL related macros +// and inclusion of their respective header files +#include "src/Core/util/MKL_support.h" + + +#if defined(EIGEN_HAS_CUDA_FP16) || defined(EIGEN_HAS_HIP_FP16) + #define EIGEN_HAS_GPU_FP16 +#endif + +#if defined(EIGEN_HAS_CUDA_BF16) || defined(EIGEN_HAS_HIP_BF16) + #define EIGEN_HAS_GPU_BF16 +#endif + +#if (defined _OPENMP) && (!defined EIGEN_DONT_PARALLELIZE) + #define EIGEN_HAS_OPENMP +#endif + +#ifdef EIGEN_HAS_OPENMP +#include +#endif + +// MSVC for windows mobile does not have the errno.h file +#if !(EIGEN_COMP_MSVC && EIGEN_OS_WINCE) && !EIGEN_COMP_ARM +#define EIGEN_HAS_ERRNO +#endif + +#ifdef EIGEN_HAS_ERRNO +#include +#endif +#include +#include +#include +#include +#include +#include +#ifndef EIGEN_NO_IO + #include +#endif +#include +#include +#include +#include // for CHAR_BIT +// for min/max: +#include + +#if EIGEN_HAS_CXX11 +#include +#endif + +// for std::is_nothrow_move_assignable +#ifdef EIGEN_INCLUDE_TYPE_TRAITS +#include +#endif + +// for outputting debug info +#ifdef EIGEN_DEBUG_ASSIGN +#include +#endif + +// required for __cpuid, needs to be included after cmath +#if EIGEN_COMP_MSVC && EIGEN_ARCH_i386_OR_x86_64 && !EIGEN_OS_WINCE + #include +#endif + +#if defined(EIGEN_USE_SYCL) + #undef min + #undef max + #undef isnan + #undef isinf + #undef isfinite + #include + #include + #include + #include + #include + #ifndef EIGEN_SYCL_LOCAL_THREAD_DIM0 + #define EIGEN_SYCL_LOCAL_THREAD_DIM0 16 + #endif + #ifndef EIGEN_SYCL_LOCAL_THREAD_DIM1 + #define EIGEN_SYCL_LOCAL_THREAD_DIM1 16 + #endif +#endif + + +#if defined EIGEN2_SUPPORT_STAGE40_FULL_EIGEN3_STRICTNESS || defined EIGEN2_SUPPORT_STAGE30_FULL_EIGEN3_API || defined EIGEN2_SUPPORT_STAGE20_RESOLVE_API_CONFLICTS || defined EIGEN2_SUPPORT_STAGE10_FULL_EIGEN2_API || defined EIGEN2_SUPPORT +// This will generate an error message: +#error Eigen2-support is only available up to version 3.2. Please go to "http://eigen.tuxfamily.org/index.php?title=Eigen2" for further information +#endif + +namespace Eigen { + +// we use size_t frequently and we'll never remember to prepend it with std:: every time just to +// ensure QNX/QCC support +using std::size_t; +// gcc 4.6.0 wants std:: for ptrdiff_t +using std::ptrdiff_t; + +} + +/** \defgroup Core_Module Core module + * This is the main module of Eigen providing dense matrix and vector support + * (both fixed and dynamic size) with all the features corresponding to a BLAS library + * and much more... + * + * \code + * #include + * \endcode + */ + +#include "src/Core/util/Constants.h" +#include "src/Core/util/Meta.h" +#include "src/Core/util/ForwardDeclarations.h" +#include "src/Core/util/StaticAssert.h" +#include "src/Core/util/XprHelper.h" +#include "src/Core/util/Memory.h" +#include "src/Core/util/IntegralConstant.h" +#include "src/Core/util/SymbolicIndex.h" + +#include "src/Core/NumTraits.h" +#include "src/Core/MathFunctions.h" +#include "src/Core/GenericPacketMath.h" +#include "src/Core/MathFunctionsImpl.h" +#include "src/Core/arch/Default/ConjHelper.h" +// Generic half float support +#include "src/Core/arch/Default/Half.h" +#include "src/Core/arch/Default/BFloat16.h" +#include "src/Core/arch/Default/TypeCasting.h" +#include "src/Core/arch/Default/GenericPacketMathFunctionsFwd.h" + +#if defined EIGEN_VECTORIZE_AVX512 + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/Complex.h" + #include "src/Core/arch/AVX/PacketMath.h" + #include "src/Core/arch/AVX/TypeCasting.h" + #include "src/Core/arch/AVX/Complex.h" + #include "src/Core/arch/AVX512/PacketMath.h" + #include "src/Core/arch/AVX512/TypeCasting.h" + #include "src/Core/arch/AVX512/Complex.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/AVX/MathFunctions.h" + #include "src/Core/arch/AVX512/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_AVX + // Use AVX for floats and doubles, SSE for integers + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/Complex.h" + #include "src/Core/arch/AVX/PacketMath.h" + #include "src/Core/arch/AVX/TypeCasting.h" + #include "src/Core/arch/AVX/Complex.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/AVX/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_SSE + #include "src/Core/arch/SSE/PacketMath.h" + #include "src/Core/arch/SSE/TypeCasting.h" + #include "src/Core/arch/SSE/MathFunctions.h" + #include "src/Core/arch/SSE/Complex.h" +#elif defined(EIGEN_VECTORIZE_ALTIVEC) || defined(EIGEN_VECTORIZE_VSX) + #include "src/Core/arch/AltiVec/PacketMath.h" + #include "src/Core/arch/AltiVec/MathFunctions.h" + #include "src/Core/arch/AltiVec/Complex.h" +#elif defined EIGEN_VECTORIZE_NEON + #include "src/Core/arch/NEON/PacketMath.h" + #include "src/Core/arch/NEON/TypeCasting.h" + #include "src/Core/arch/NEON/MathFunctions.h" + #include "src/Core/arch/NEON/Complex.h" +#elif defined EIGEN_VECTORIZE_SVE + #include "src/Core/arch/SVE/PacketMath.h" + #include "src/Core/arch/SVE/TypeCasting.h" + #include "src/Core/arch/SVE/MathFunctions.h" +#elif defined EIGEN_VECTORIZE_ZVECTOR + #include "src/Core/arch/ZVector/PacketMath.h" + #include "src/Core/arch/ZVector/MathFunctions.h" + #include "src/Core/arch/ZVector/Complex.h" +#elif defined EIGEN_VECTORIZE_MSA + #include "src/Core/arch/MSA/PacketMath.h" + #include "src/Core/arch/MSA/MathFunctions.h" + #include "src/Core/arch/MSA/Complex.h" +#endif + +#if defined EIGEN_VECTORIZE_GPU + #include "src/Core/arch/GPU/PacketMath.h" + #include "src/Core/arch/GPU/MathFunctions.h" + #include "src/Core/arch/GPU/TypeCasting.h" +#endif + +#if defined(EIGEN_USE_SYCL) + #include "src/Core/arch/SYCL/SyclMemoryModel.h" + #include "src/Core/arch/SYCL/InteropHeaders.h" +#if !defined(EIGEN_DONT_VECTORIZE_SYCL) + #include "src/Core/arch/SYCL/PacketMath.h" + #include "src/Core/arch/SYCL/MathFunctions.h" + #include "src/Core/arch/SYCL/TypeCasting.h" +#endif +#endif + +#include "src/Core/arch/Default/Settings.h" +// This file provides generic implementations valid for scalar as well +#include "src/Core/arch/Default/GenericPacketMathFunctions.h" + +#include "src/Core/functors/TernaryFunctors.h" +#include "src/Core/functors/BinaryFunctors.h" +#include "src/Core/functors/UnaryFunctors.h" +#include "src/Core/functors/NullaryFunctors.h" +#include "src/Core/functors/StlFunctors.h" +#include "src/Core/functors/AssignmentFunctors.h" + +// Specialized functors to enable the processing of complex numbers +// on CUDA devices +#ifdef EIGEN_CUDACC +#include "src/Core/arch/CUDA/Complex.h" +#endif + +#include "src/Core/util/IndexedViewHelper.h" +#include "src/Core/util/ReshapedHelper.h" +#include "src/Core/ArithmeticSequence.h" +#ifndef EIGEN_NO_IO + #include "src/Core/IO.h" +#endif +#include "src/Core/DenseCoeffsBase.h" +#include "src/Core/DenseBase.h" +#include "src/Core/MatrixBase.h" +#include "src/Core/EigenBase.h" + +#include "src/Core/Product.h" +#include "src/Core/CoreEvaluators.h" +#include "src/Core/AssignEvaluator.h" + +#ifndef EIGEN_PARSED_BY_DOXYGEN // work around Doxygen bug triggered by Assign.h r814874 + // at least confirmed with Doxygen 1.5.5 and 1.5.6 + #include "src/Core/Assign.h" +#endif + +#include "src/Core/ArrayBase.h" +#include "src/Core/util/BlasUtil.h" +#include "src/Core/DenseStorage.h" +#include "src/Core/NestByValue.h" + +// #include "src/Core/ForceAlignedAccess.h" + +#include "src/Core/ReturnByValue.h" +#include "src/Core/NoAlias.h" +#include "src/Core/PlainObjectBase.h" +#include "src/Core/Matrix.h" +#include "src/Core/Array.h" +#include "src/Core/CwiseTernaryOp.h" +#include "src/Core/CwiseBinaryOp.h" +#include "src/Core/CwiseUnaryOp.h" +#include "src/Core/CwiseNullaryOp.h" +#include "src/Core/CwiseUnaryView.h" +#include "src/Core/SelfCwiseBinaryOp.h" +#include "src/Core/Dot.h" +#include "src/Core/StableNorm.h" +#include "src/Core/Stride.h" +#include "src/Core/MapBase.h" +#include "src/Core/Map.h" +#include "src/Core/Ref.h" +#include "src/Core/Block.h" +#include "src/Core/VectorBlock.h" +#include "src/Core/IndexedView.h" +#include "src/Core/Reshaped.h" +#include "src/Core/Transpose.h" +#include "src/Core/DiagonalMatrix.h" +#include "src/Core/Diagonal.h" +#include "src/Core/DiagonalProduct.h" +#include "src/Core/Redux.h" +#include "src/Core/Visitor.h" +#include "src/Core/Fuzzy.h" +#include "src/Core/Swap.h" +#include "src/Core/CommaInitializer.h" +#include "src/Core/GeneralProduct.h" +#include "src/Core/Solve.h" +#include "src/Core/Inverse.h" +#include "src/Core/SolverBase.h" +#include "src/Core/PermutationMatrix.h" +#include "src/Core/Transpositions.h" +#include "src/Core/TriangularMatrix.h" +#include "src/Core/SelfAdjointView.h" +#include "src/Core/products/GeneralBlockPanelKernel.h" +#include "src/Core/products/Parallelizer.h" +#include "src/Core/ProductEvaluators.h" +#include "src/Core/products/GeneralMatrixVector.h" +#include "src/Core/products/GeneralMatrixMatrix.h" +#include "src/Core/SolveTriangular.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular.h" +#include "src/Core/products/SelfadjointMatrixVector.h" +#include "src/Core/products/SelfadjointMatrixMatrix.h" +#include "src/Core/products/SelfadjointProduct.h" +#include "src/Core/products/SelfadjointRank2Update.h" +#include "src/Core/products/TriangularMatrixVector.h" +#include "src/Core/products/TriangularMatrixMatrix.h" +#include "src/Core/products/TriangularSolverMatrix.h" +#include "src/Core/products/TriangularSolverVector.h" +#include "src/Core/BandMatrix.h" +#include "src/Core/CoreIterators.h" +#include "src/Core/ConditionEstimator.h" + +#if defined(EIGEN_VECTORIZE_ALTIVEC) || defined(EIGEN_VECTORIZE_VSX) + #include "src/Core/arch/AltiVec/MatrixProduct.h" +#elif defined EIGEN_VECTORIZE_NEON + #include "src/Core/arch/NEON/GeneralBlockPanelKernel.h" +#endif + +#include "src/Core/BooleanRedux.h" +#include "src/Core/Select.h" +#include "src/Core/VectorwiseOp.h" +#include "src/Core/PartialReduxEvaluator.h" +#include "src/Core/Random.h" +#include "src/Core/Replicate.h" +#include "src/Core/Reverse.h" +#include "src/Core/ArrayWrapper.h" +#include "src/Core/StlIterators.h" + +#ifdef EIGEN_USE_BLAS +#include "src/Core/products/GeneralMatrixMatrix_BLAS.h" +#include "src/Core/products/GeneralMatrixVector_BLAS.h" +#include "src/Core/products/GeneralMatrixMatrixTriangular_BLAS.h" +#include "src/Core/products/SelfadjointMatrixMatrix_BLAS.h" +#include "src/Core/products/SelfadjointMatrixVector_BLAS.h" +#include "src/Core/products/TriangularMatrixMatrix_BLAS.h" +#include "src/Core/products/TriangularMatrixVector_BLAS.h" +#include "src/Core/products/TriangularSolverMatrix_BLAS.h" +#endif // EIGEN_USE_BLAS + +#ifdef EIGEN_USE_MKL_VML +#include "src/Core/Assign_MKL.h" +#endif + +#include "src/Core/GlobalFunctions.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_CORE_H diff --git a/src/3rdparty/eigen/Eigen/Dense b/src/3rdparty/eigen/Eigen/Dense new file mode 100644 index 0000000..5768910 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Dense @@ -0,0 +1,7 @@ +#include "Core" +#include "LU" +#include "Cholesky" +#include "QR" +#include "SVD" +#include "Geometry" +#include "Eigenvalues" diff --git a/src/3rdparty/eigen/Eigen/Eigenvalues b/src/3rdparty/eigen/Eigen/Eigenvalues new file mode 100644 index 0000000..5467a2e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Eigenvalues @@ -0,0 +1,60 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENVALUES_MODULE_H +#define EIGEN_EIGENVALUES_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" +#include "LU" +#include "Geometry" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Eigenvalues_Module Eigenvalues module + * + * + * + * This module mainly provides various eigenvalue solvers. + * This module also provides some MatrixBase methods, including: + * - MatrixBase::eigenvalues(), + * - MatrixBase::operatorNorm() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/RealSvd2x2.h" +#include "src/Eigenvalues/Tridiagonalization.h" +#include "src/Eigenvalues/RealSchur.h" +#include "src/Eigenvalues/EigenSolver.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver.h" +#include "src/Eigenvalues/GeneralizedSelfAdjointEigenSolver.h" +#include "src/Eigenvalues/HessenbergDecomposition.h" +#include "src/Eigenvalues/ComplexSchur.h" +#include "src/Eigenvalues/ComplexEigenSolver.h" +#include "src/Eigenvalues/RealQZ.h" +#include "src/Eigenvalues/GeneralizedEigenSolver.h" +#include "src/Eigenvalues/MatrixBaseEigenvalues.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/Eigenvalues/RealSchur_LAPACKE.h" +#include "src/Eigenvalues/ComplexSchur_LAPACKE.h" +#include "src/Eigenvalues/SelfAdjointEigenSolver_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_EIGENVALUES_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Geometry b/src/3rdparty/eigen/Eigen/Geometry new file mode 100644 index 0000000..bc78110 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Geometry @@ -0,0 +1,59 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GEOMETRY_MODULE_H +#define EIGEN_GEOMETRY_MODULE_H + +#include "Core" + +#include "SVD" +#include "LU" +#include + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Geometry_Module Geometry module + * + * This module provides support for: + * - fixed-size homogeneous transformations + * - translation, scaling, 2D and 3D rotations + * - \link Quaternion quaternions \endlink + * - cross products (\ref MatrixBase::cross, \ref MatrixBase::cross3) + * - orthognal vector generation (\ref MatrixBase::unitOrthogonal) + * - some linear components: \link ParametrizedLine parametrized-lines \endlink and \link Hyperplane hyperplanes \endlink + * - \link AlignedBox axis aligned bounding boxes \endlink + * - \link umeyama least-square transformation fitting \endlink + * + * \code + * #include + * \endcode + */ + +#include "src/Geometry/OrthoMethods.h" +#include "src/Geometry/EulerAngles.h" + +#include "src/Geometry/Homogeneous.h" +#include "src/Geometry/RotationBase.h" +#include "src/Geometry/Rotation2D.h" +#include "src/Geometry/Quaternion.h" +#include "src/Geometry/AngleAxis.h" +#include "src/Geometry/Transform.h" +#include "src/Geometry/Translation.h" +#include "src/Geometry/Scaling.h" +#include "src/Geometry/Hyperplane.h" +#include "src/Geometry/ParametrizedLine.h" +#include "src/Geometry/AlignedBox.h" +#include "src/Geometry/Umeyama.h" + +// Use the SSE optimized version whenever possible. +#if (defined EIGEN_VECTORIZE_SSE) || (defined EIGEN_VECTORIZE_NEON) +#include "src/Geometry/arch/Geometry_SIMD.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_GEOMETRY_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Householder b/src/3rdparty/eigen/Eigen/Householder new file mode 100644 index 0000000..f2fa799 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Householder @@ -0,0 +1,29 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_HOUSEHOLDER_MODULE_H +#define EIGEN_HOUSEHOLDER_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Householder_Module Householder module + * This module provides Householder transformations. + * + * \code + * #include + * \endcode + */ + +#include "src/Householder/Householder.h" +#include "src/Householder/HouseholderSequence.h" +#include "src/Householder/BlockHouseholder.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_HOUSEHOLDER_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/Jacobi b/src/3rdparty/eigen/Eigen/Jacobi new file mode 100644 index 0000000..43edc7a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/Jacobi @@ -0,0 +1,32 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_JACOBI_MODULE_H +#define EIGEN_JACOBI_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup Jacobi_Module Jacobi module + * This module provides Jacobi and Givens rotations. + * + * \code + * #include + * \endcode + * + * In addition to listed classes, it defines the two following MatrixBase methods to apply a Jacobi or Givens rotation: + * - MatrixBase::applyOnTheLeft() + * - MatrixBase::applyOnTheRight(). + */ + +#include "src/Jacobi/Jacobi.h" + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_JACOBI_MODULE_H + diff --git a/src/3rdparty/eigen/Eigen/LU b/src/3rdparty/eigen/Eigen/LU new file mode 100644 index 0000000..1236ceb --- /dev/null +++ b/src/3rdparty/eigen/Eigen/LU @@ -0,0 +1,47 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LU_MODULE_H +#define EIGEN_LU_MODULE_H + +#include "Core" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup LU_Module LU module + * This module includes %LU decomposition and related notions such as matrix inversion and determinant. + * This module defines the following MatrixBase methods: + * - MatrixBase::inverse() + * - MatrixBase::determinant() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/Kernel.h" +#include "src/misc/Image.h" +#include "src/LU/FullPivLU.h" +#include "src/LU/PartialPivLU.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/LU/PartialPivLU_LAPACKE.h" +#endif +#include "src/LU/Determinant.h" +#include "src/LU/InverseImpl.h" + +#if defined EIGEN_VECTORIZE_SSE || defined EIGEN_VECTORIZE_NEON + #include "src/LU/arch/InverseSize4.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_LU_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/QR b/src/3rdparty/eigen/Eigen/QR new file mode 100644 index 0000000..8465b62 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/QR @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_QR_MODULE_H +#define EIGEN_QR_MODULE_H + +#include "Core" + +#include "Cholesky" +#include "Jacobi" +#include "Householder" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup QR_Module QR module + * + * + * + * This module provides various QR decompositions + * This module also provides some MatrixBase methods, including: + * - MatrixBase::householderQr() + * - MatrixBase::colPivHouseholderQr() + * - MatrixBase::fullPivHouseholderQr() + * + * \code + * #include + * \endcode + */ + +#include "src/QR/HouseholderQR.h" +#include "src/QR/FullPivHouseholderQR.h" +#include "src/QR/ColPivHouseholderQR.h" +#include "src/QR/CompleteOrthogonalDecomposition.h" +#ifdef EIGEN_USE_LAPACKE +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/QR/HouseholderQR_LAPACKE.h" +#include "src/QR/ColPivHouseholderQR_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_QR_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/SVD b/src/3rdparty/eigen/Eigen/SVD new file mode 100644 index 0000000..3451794 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/SVD @@ -0,0 +1,50 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SVD_MODULE_H +#define EIGEN_SVD_MODULE_H + +#include "QR" +#include "Householder" +#include "Jacobi" + +#include "src/Core/util/DisableStupidWarnings.h" + +/** \defgroup SVD_Module SVD module + * + * + * + * This module provides SVD decomposition for matrices (both real and complex). + * Two decomposition algorithms are provided: + * - JacobiSVD implementing two-sided Jacobi iterations is numerically very accurate, fast for small matrices, but very slow for larger ones. + * - BDCSVD implementing a recursive divide & conquer strategy on top of an upper-bidiagonalization which remains fast for large problems. + * These decompositions are accessible via the respective classes and following MatrixBase methods: + * - MatrixBase::jacobiSvd() + * - MatrixBase::bdcSvd() + * + * \code + * #include + * \endcode + */ + +#include "src/misc/RealSvd2x2.h" +#include "src/SVD/UpperBidiagonalization.h" +#include "src/SVD/SVDBase.h" +#include "src/SVD/JacobiSVD.h" +#include "src/SVD/BDCSVD.h" +#if defined(EIGEN_USE_LAPACKE) && !defined(EIGEN_USE_LAPACKE_STRICT) +#ifdef EIGEN_USE_MKL +#include "mkl_lapacke.h" +#else +#include "src/misc/lapacke.h" +#endif +#include "src/SVD/JacobiSVD_LAPACKE.h" +#endif + +#include "src/Core/util/ReenableStupidWarnings.h" + +#endif // EIGEN_SVD_MODULE_H diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h new file mode 100644 index 0000000..1013ca0 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LDLT.h @@ -0,0 +1,688 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// Copyright (C) 2009 Keir Mierle +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2011 Timothy E. Holy +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LDLT_H +#define EIGEN_LDLT_H + +namespace Eigen { + +namespace internal { + template struct traits > + : traits<_MatrixType> + { + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; + }; + + template struct LDLT_Traits; + + // PositiveSemiDef means positive semi-definite and non-zero; same for NegativeSemiDef + enum SignMatrix { PositiveSemiDef, NegativeSemiDef, ZeroSign, Indefinite }; +} + +/** \ingroup Cholesky_Module + * + * \class LDLT + * + * \brief Robust Cholesky decomposition of a matrix with pivoting + * + * \tparam _MatrixType the type of the matrix of which to compute the LDL^T Cholesky decomposition + * \tparam _UpLo the triangular part that will be used for the decompositon: Lower (default) or Upper. + * The other triangular part won't be read. + * + * Perform a robust Cholesky decomposition of a positive semidefinite or negative semidefinite + * matrix \f$ A \f$ such that \f$ A = P^TLDL^*P \f$, where P is a permutation matrix, L + * is lower triangular with a unit diagonal and D is a diagonal matrix. + * + * The decomposition uses pivoting to ensure stability, so that D will have + * zeros in the bottom right rank(A) - n submatrix. Avoiding the square root + * on D also stabilizes the computation. + * + * Remember that Cholesky decompositions are not rank-revealing. Also, do not use a Cholesky + * decomposition to determine whether a system of equations has a solution. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt(), class LLT + */ +template class LDLT + : public SolverBase > +{ + public: + typedef _MatrixType MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LDLT) + enum { + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + UpLo = _UpLo + }; + typedef Matrix TmpMatrixType; + + typedef Transpositions TranspositionType; + typedef PermutationMatrix PermutationType; + + typedef internal::LDLT_Traits Traits; + + /** \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LDLT::compute(const MatrixType&). + */ + LDLT() + : m_matrix(), + m_transpositions(), + m_sign(internal::ZeroSign), + m_isInitialized(false) + {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LDLT() + */ + explicit LDLT(Index size) + : m_matrix(size, size), + m_transpositions(size), + m_temporary(size), + m_sign(internal::ZeroSign), + m_isInitialized(false) + {} + + /** \brief Constructor with decomposition + * + * This calculates the decomposition for the input \a matrix. + * + * \sa LDLT(Index size) + */ + template + explicit LDLT(const EigenBase& matrix) + : m_matrix(matrix.rows(), matrix.cols()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \brief Constructs a LDLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when \c MatrixType is a Eigen::Ref. + * + * \sa LDLT(const EigenBase&) + */ + template + explicit LDLT(EigenBase& matrix) + : m_matrix(matrix.derived()), + m_transpositions(matrix.rows()), + m_temporary(matrix.rows()), + m_sign(internal::ZeroSign), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** Clear any existing decomposition + * \sa rankUpdate(w,sigma) + */ + void setZero() + { + m_isInitialized = false; + } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return Traits::getL(m_matrix); + } + + /** \returns the permutation matrix P as a transposition sequence. + */ + inline const TranspositionType& transpositionsP() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_transpositions; + } + + /** \returns the coefficients of the diagonal matrix D */ + inline Diagonal vectorD() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix.diagonal(); + } + + /** \returns true if the matrix is positive (semidefinite) */ + inline bool isPositive() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::PositiveSemiDef || m_sign == internal::ZeroSign; + } + + /** \returns true if the matrix is negative (semidefinite) */ + inline bool isNegative(void) const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_sign == internal::NegativeSemiDef || m_sign == internal::ZeroSign; + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns a solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * This function also supports in-place solves using the syntax x = decompositionObject.solve(x) . + * + * \note_about_checking_solutions + * + * More precisely, this method solves \f$ A x = b \f$ using the decomposition \f$ A = P^T L D L^* P \f$ + * by solving the systems \f$ P^T y_1 = b \f$, \f$ L y_2 = y_1 \f$, \f$ D y_3 = y_2 \f$, + * \f$ L^* y_4 = y_3 \f$ and \f$ P x = y_4 \f$ in succession. If the matrix \f$ A \f$ is singular, then + * \f$ D \f$ will also be singular (all the other matrices are invertible). In that case, the + * least-square solution of \f$ D y_3 = y_2 \f$ is computed. This does not mean that this function + * computes the least-square solution of \f$ A x = b \f$ if \f$ A \f$ is singular. + * + * \sa MatrixBase::ldlt(), SelfAdjointView::ldlt() + */ + template + inline const Solve + solve(const MatrixBase& b) const; + #endif + + template + bool solveInPlace(MatrixBase &bAndX) const; + + template + LDLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the LDLT decomposition. + */ + RealScalar rcond() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + template + LDLT& rankUpdate(const MatrixBase& w, const RealScalar& alpha=1); + + /** \returns the internal LDLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLDLT() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LDLT& adjoint() const { return *this; }; + + EIGEN_DEVICE_FUNC inline EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC inline EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the factorization failed because of a zero pivot. + */ + ComputationInfo info() const + { + eigen_assert(m_isInitialized && "LDLT is not initialized."); + return m_info; + } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType &rhs, DstType &dst) const; + + template + void _solve_impl_transposed(const RhsType &rhs, DstType &dst) const; + #endif + + protected: + + static void check_template_parameters() + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar); + } + + /** \internal + * Used to compute and store the Cholesky decomposition A = L D L^* = U^* D U. + * The strict upper part is used during the decomposition, the strict lower + * part correspond to the coefficients of L (its diagonal is equal to 1 and + * is not stored), and the diagonal entries correspond to D. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + TranspositionType m_transpositions; + TmpMatrixType m_temporary; + internal::SignMatrix m_sign; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template struct ldlt_inplace; + +template<> struct ldlt_inplace +{ + template + static bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, SignMatrix& sign) + { + using std::abs; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename TranspositionType::StorageIndex IndexType; + eigen_assert(mat.rows()==mat.cols()); + const Index size = mat.rows(); + bool found_zero_pivot = false; + bool ret = true; + + if (size <= 1) + { + transpositions.setIdentity(); + if(size==0) sign = ZeroSign; + else if (numext::real(mat.coeff(0,0)) > static_cast(0) ) sign = PositiveSemiDef; + else if (numext::real(mat.coeff(0,0)) < static_cast(0)) sign = NegativeSemiDef; + else sign = ZeroSign; + return true; + } + + for (Index k = 0; k < size; ++k) + { + // Find largest diagonal element + Index index_of_biggest_in_corner; + mat.diagonal().tail(size-k).cwiseAbs().maxCoeff(&index_of_biggest_in_corner); + index_of_biggest_in_corner += k; + + transpositions.coeffRef(k) = IndexType(index_of_biggest_in_corner); + if(k != index_of_biggest_in_corner) + { + // apply the transposition while taking care to consider only + // the lower triangular part + Index s = size-index_of_biggest_in_corner-1; // trailing size after the biggest element + mat.row(k).head(k).swap(mat.row(index_of_biggest_in_corner).head(k)); + mat.col(k).tail(s).swap(mat.col(index_of_biggest_in_corner).tail(s)); + std::swap(mat.coeffRef(k,k),mat.coeffRef(index_of_biggest_in_corner,index_of_biggest_in_corner)); + for(Index i=k+1;i::IsComplex) + mat.coeffRef(index_of_biggest_in_corner,k) = numext::conj(mat.coeff(index_of_biggest_in_corner,k)); + } + + // partition the matrix: + // A00 | - | - + // lu = A10 | A11 | - + // A20 | A21 | A22 + Index rs = size - k - 1; + Block A21(mat,k+1,k,rs,1); + Block A10(mat,k,0,1,k); + Block A20(mat,k+1,0,rs,k); + + if(k>0) + { + temp.head(k) = mat.diagonal().real().head(k).asDiagonal() * A10.adjoint(); + mat.coeffRef(k,k) -= (A10 * temp.head(k)).value(); + if(rs>0) + A21.noalias() -= A20 * temp.head(k); + } + + // In some previous versions of Eigen (e.g., 3.2.1), the scaling was omitted if the pivot + // was smaller than the cutoff value. However, since LDLT is not rank-revealing + // we should only make sure that we do not introduce INF or NaN values. + // Remark that LAPACK also uses 0 as the cutoff value. + RealScalar realAkk = numext::real(mat.coeffRef(k,k)); + bool pivot_is_valid = (abs(realAkk) > RealScalar(0)); + + if(k==0 && !pivot_is_valid) + { + // The entire diagonal is zero, there is nothing more to do + // except filling the transpositions, and checking whether the matrix is zero. + sign = ZeroSign; + for(Index j = 0; j0) && pivot_is_valid) + A21 /= realAkk; + else if(rs>0) + ret = ret && (A21.array()==Scalar(0)).all(); + + if(found_zero_pivot && pivot_is_valid) ret = false; // factorization failed + else if(!pivot_is_valid) found_zero_pivot = true; + + if (sign == PositiveSemiDef) { + if (realAkk < static_cast(0)) sign = Indefinite; + } else if (sign == NegativeSemiDef) { + if (realAkk > static_cast(0)) sign = Indefinite; + } else if (sign == ZeroSign) { + if (realAkk > static_cast(0)) sign = PositiveSemiDef; + else if (realAkk < static_cast(0)) sign = NegativeSemiDef; + } + } + + return ret; + } + + // Reference for the algorithm: Davis and Hager, "Multiple Rank + // Modifications of a Sparse Cholesky Factorization" (Algorithm 1) + // Trivial rearrangements of their computations (Timothy E. Holy) + // allow their algorithm to work for rank-1 updates even if the + // original matrix is not of full rank. + // Here only rank-1 updates are implemented, to reduce the + // requirement for intermediate storage and improve accuracy + template + static bool updateInPlace(MatrixType& mat, MatrixBase& w, const typename MatrixType::RealScalar& sigma=1) + { + using numext::isfinite; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + + const Index size = mat.rows(); + eigen_assert(mat.cols() == size && w.size()==size); + + RealScalar alpha = 1; + + // Apply the update + for (Index j = 0; j < size; j++) + { + // Check for termination due to an original decomposition of low-rank + if (!(isfinite)(alpha)) + break; + + // Update the diagonal terms + RealScalar dj = numext::real(mat.coeff(j,j)); + Scalar wj = w.coeff(j); + RealScalar swj2 = sigma*numext::abs2(wj); + RealScalar gamma = dj*alpha + swj2; + + mat.coeffRef(j,j) += swj2/alpha; + alpha += swj2/dj; + + + // Update the terms of L + Index rs = size-j-1; + w.tail(rs) -= wj * mat.col(j).tail(rs); + if(gamma != 0) + mat.col(j).tail(rs) += (sigma*numext::conj(wj)/gamma)*w.tail(rs); + } + return true; + } + + template + static bool update(MatrixType& mat, const TranspositionType& transpositions, Workspace& tmp, const WType& w, const typename MatrixType::RealScalar& sigma=1) + { + // Apply the permutation to the input w + tmp = transpositions * w; + + return ldlt_inplace::updateInPlace(mat,tmp,sigma); + } +}; + +template<> struct ldlt_inplace +{ + template + static EIGEN_STRONG_INLINE bool unblocked(MatrixType& mat, TranspositionType& transpositions, Workspace& temp, SignMatrix& sign) + { + Transpose matt(mat); + return ldlt_inplace::unblocked(matt, transpositions, temp, sign); + } + + template + static EIGEN_STRONG_INLINE bool update(MatrixType& mat, TranspositionType& transpositions, Workspace& tmp, WType& w, const typename MatrixType::RealScalar& sigma=1) + { + Transpose matt(mat); + return ldlt_inplace::update(matt, transpositions, tmp, w.conjugate(), sigma); + } +}; + +template struct LDLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } +}; + +template struct LDLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } +}; + +} // end namespace internal + +/** Compute / recompute the LDLT decomposition A = L D L^* = U^* D U of \a matrix + */ +template +template +LDLT& LDLT::compute(const EigenBase& a) +{ + check_template_parameters(); + + eigen_assert(a.rows()==a.cols()); + const Index size = a.rows(); + + m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (_UpLo == Lower) + abs_col_sum = m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) + m_l1_norm = abs_col_sum; + } + + m_transpositions.resize(size); + m_isInitialized = false; + m_temporary.resize(size); + m_sign = internal::ZeroSign; + + m_info = internal::ldlt_inplace::unblocked(m_matrix, m_transpositions, m_temporary, m_sign) ? Success : NumericalIssue; + + m_isInitialized = true; + return *this; +} + +/** Update the LDLT decomposition: given A = L D L^T, efficiently compute the decomposition of A + sigma w w^T. + * \param w a vector to be incorporated into the decomposition. + * \param sigma a scalar, +1 for updates and -1 for "downdates," which correspond to removing previously-added column vectors. Optional; default value is +1. + * \sa setZero() + */ +template +template +LDLT& LDLT::rankUpdate(const MatrixBase& w, const typename LDLT::RealScalar& sigma) +{ + typedef typename TranspositionType::StorageIndex IndexType; + const Index size = w.rows(); + if (m_isInitialized) + { + eigen_assert(m_matrix.rows()==size); + } + else + { + m_matrix.resize(size,size); + m_matrix.setZero(); + m_transpositions.resize(size); + for (Index i = 0; i < size; i++) + m_transpositions.coeffRef(i) = IndexType(i); + m_temporary.resize(size); + m_sign = sigma>=0 ? internal::PositiveSemiDef : internal::NegativeSemiDef; + m_isInitialized = true; + } + + internal::ldlt_inplace::update(m_matrix, m_transpositions, m_temporary, w, sigma); + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LDLT<_MatrixType,_UpLo>::_solve_impl(const RhsType &rhs, DstType &dst) const +{ + _solve_impl_transposed(rhs, dst); +} + +template +template +void LDLT<_MatrixType,_UpLo>::_solve_impl_transposed(const RhsType &rhs, DstType &dst) const +{ + // dst = P b + dst = m_transpositions * rhs; + + // dst = L^-1 (P b) + // dst = L^-*T (P b) + matrixL().template conjugateIf().solveInPlace(dst); + + // dst = D^-* (L^-1 P b) + // dst = D^-1 (L^-*T P b) + // more precisely, use pseudo-inverse of D (see bug 241) + using std::abs; + const typename Diagonal::RealReturnType vecD(vectorD()); + // In some previous versions, tolerance was set to the max of 1/highest (or rather numeric_limits::min()) + // and the maximal diagonal entry * epsilon as motivated by LAPACK's xGELSS: + // RealScalar tolerance = numext::maxi(vecD.array().abs().maxCoeff() * NumTraits::epsilon(),RealScalar(1) / NumTraits::highest()); + // However, LDLT is not rank revealing, and so adjusting the tolerance wrt to the highest + // diagonal element is not well justified and leads to numerical issues in some cases. + // Moreover, Lapack's xSYTRS routines use 0 for the tolerance. + // Using numeric_limits::min() gives us more robustness to denormals. + RealScalar tolerance = (std::numeric_limits::min)(); + for (Index i = 0; i < vecD.size(); ++i) + { + if(abs(vecD(i)) > tolerance) + dst.row(i) /= vecD(i); + else + dst.row(i).setZero(); + } + + // dst = L^-* (D^-* L^-1 P b) + // dst = L^-T (D^-1 L^-*T P b) + matrixL().transpose().template conjugateIf().solveInPlace(dst); + + // dst = P^T (L^-* D^-* L^-1 P b) = A^-1 b + // dst = P^-T (L^-T D^-1 L^-*T P b) = A^-1 b + dst = m_transpositions.transpose() * dst; +} +#endif + +/** \internal use x = ldlt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * \returns true always! If you need to check for existence of solutions, use another decomposition like LU, QR, or SVD. + * + * This version avoids a copy when the right hand side matrix b is not + * needed anymore. + * + * \sa LDLT::solve(), MatrixBase::ldlt() + */ +template +template +bool LDLT::solveInPlace(MatrixBase &bAndX) const +{ + eigen_assert(m_isInitialized && "LDLT is not initialized."); + eigen_assert(m_matrix.rows() == bAndX.rows()); + + bAndX = this->solve(bAndX); + + return true; +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: P^T L D L^* P. + * This function is provided for debug purpose. */ +template +MatrixType LDLT::reconstructedMatrix() const +{ + eigen_assert(m_isInitialized && "LDLT is not initialized."); + const Index size = m_matrix.rows(); + MatrixType res(size,size); + + // P + res.setIdentity(); + res = transpositionsP() * res; + // L^* P + res = matrixU() * res; + // D(L^*P) + res = vectorD().real().asDiagonal() * res; + // L(DL^*P) + res = matrixL() * res; + // P^T (LDL^*P) + res = transpositionsP().transpose() * res; + + return res; +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa MatrixBase::ldlt() + */ +template +inline const LDLT::PlainObject, UpLo> +SelfAdjointView::ldlt() const +{ + return LDLT(m_matrix); +} + +/** \cholesky_module + * \returns the Cholesky decomposition with full pivoting without square root of \c *this + * \sa SelfAdjointView::ldlt() + */ +template +inline const LDLT::PlainObject> +MatrixBase::ldlt() const +{ + return LDLT(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_LDLT_H diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h new file mode 100644 index 0000000..8c9b2b3 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT.h @@ -0,0 +1,558 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_LLT_H +#define EIGEN_LLT_H + +namespace Eigen { + +namespace internal{ + +template struct traits > + : traits<_MatrixType> +{ + typedef MatrixXpr XprKind; + typedef SolverStorage StorageKind; + typedef int StorageIndex; + enum { Flags = 0 }; +}; + +template struct LLT_Traits; +} + +/** \ingroup Cholesky_Module + * + * \class LLT + * + * \brief Standard Cholesky decomposition (LL^T) of a matrix and associated features + * + * \tparam _MatrixType the type of the matrix of which we are computing the LL^T Cholesky decomposition + * \tparam _UpLo the triangular part that will be used for the decompositon: Lower (default) or Upper. + * The other triangular part won't be read. + * + * This class performs a LL^T Cholesky decomposition of a symmetric, positive definite + * matrix A such that A = LL^* = U^*U, where L is lower triangular. + * + * While the Cholesky decomposition is particularly useful to solve selfadjoint problems like D^*D x = b, + * for that purpose, we recommend the Cholesky decomposition without square root which is more stable + * and even faster. Nevertheless, this standard Cholesky decomposition remains useful in many other + * situations like generalised eigen problems with hermitian matrices. + * + * Remember that Cholesky decompositions are not rank-revealing. This LLT decomposition is only stable on positive definite matrices, + * use LDLT instead for the semidefinite case. Also, do not use a Cholesky decomposition to determine whether a system of equations + * has a solution. + * + * Example: \include LLT_example.cpp + * Output: \verbinclude LLT_example.out + * + * \b Performance: for best performance, it is recommended to use a column-major storage format + * with the Lower triangular part (the default), or, equivalently, a row-major storage format + * with the Upper triangular part. Otherwise, you might get a 20% slowdown for the full factorization + * step, and rank-updates can be up to 3 times slower. + * + * This class supports the \link InplaceDecomposition inplace decomposition \endlink mechanism. + * + * Note that during the decomposition, only the lower (or upper, as defined by _UpLo) triangular part of A is considered. + * Therefore, the strict lower part does not have to store correct values. + * + * \sa MatrixBase::llt(), SelfAdjointView::llt(), class LDLT + */ +template class LLT + : public SolverBase > +{ + public: + typedef _MatrixType MatrixType; + typedef SolverBase Base; + friend class SolverBase; + + EIGEN_GENERIC_PUBLIC_INTERFACE(LLT) + enum { + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime + }; + + enum { + PacketSize = internal::packet_traits::size, + AlignmentMask = int(PacketSize)-1, + UpLo = _UpLo + }; + + typedef internal::LLT_Traits Traits; + + /** + * \brief Default Constructor. + * + * The default constructor is useful in cases in which the user intends to + * perform decompositions via LLT::compute(const MatrixType&). + */ + LLT() : m_matrix(), m_isInitialized(false) {} + + /** \brief Default Constructor with memory preallocation + * + * Like the default constructor but with preallocation of the internal data + * according to the specified problem \a size. + * \sa LLT() + */ + explicit LLT(Index size) : m_matrix(size, size), + m_isInitialized(false) {} + + template + explicit LLT(const EigenBase& matrix) + : m_matrix(matrix.rows(), matrix.cols()), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \brief Constructs a LLT factorization from a given matrix + * + * This overloaded constructor is provided for \link InplaceDecomposition inplace decomposition \endlink when + * \c MatrixType is a Eigen::Ref. + * + * \sa LLT(const EigenBase&) + */ + template + explicit LLT(EigenBase& matrix) + : m_matrix(matrix.derived()), + m_isInitialized(false) + { + compute(matrix.derived()); + } + + /** \returns a view of the upper triangular matrix U */ + inline typename Traits::MatrixU matrixU() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getU(m_matrix); + } + + /** \returns a view of the lower triangular matrix L */ + inline typename Traits::MatrixL matrixL() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return Traits::getL(m_matrix); + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \returns the solution x of \f$ A x = b \f$ using the current decomposition of A. + * + * Since this LLT class assumes anyway that the matrix A is invertible, the solution + * theoretically exists and is unique regardless of b. + * + * Example: \include LLT_solve.cpp + * Output: \verbinclude LLT_solve.out + * + * \sa solveInPlace(), MatrixBase::llt(), SelfAdjointView::llt() + */ + template + inline const Solve + solve(const MatrixBase& b) const; + #endif + + template + void solveInPlace(const MatrixBase &bAndX) const; + + template + LLT& compute(const EigenBase& matrix); + + /** \returns an estimate of the reciprocal condition number of the matrix of + * which \c *this is the Cholesky decomposition. + */ + RealScalar rcond() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_info == Success && "LLT failed because matrix appears to be negative"); + return internal::rcond_estimate_helper(m_l1_norm, *this); + } + + /** \returns the LLT decomposition matrix + * + * TODO: document the storage layout + */ + inline const MatrixType& matrixLLT() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_matrix; + } + + MatrixType reconstructedMatrix() const; + + + /** \brief Reports whether previous computation was successful. + * + * \returns \c Success if computation was successful, + * \c NumericalIssue if the matrix.appears not to be positive definite. + */ + ComputationInfo info() const + { + eigen_assert(m_isInitialized && "LLT is not initialized."); + return m_info; + } + + /** \returns the adjoint of \c *this, that is, a const reference to the decomposition itself as the underlying matrix is self-adjoint. + * + * This method is provided for compatibility with other matrix decompositions, thus enabling generic code such as: + * \code x = decomposition.adjoint().solve(b) \endcode + */ + const LLT& adjoint() const EIGEN_NOEXCEPT { return *this; }; + + inline EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + inline EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + template + LLT & rankUpdate(const VectorType& vec, const RealScalar& sigma = 1); + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void _solve_impl(const RhsType &rhs, DstType &dst) const; + + template + void _solve_impl_transposed(const RhsType &rhs, DstType &dst) const; + #endif + + protected: + + static void check_template_parameters() + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar); + } + + /** \internal + * Used to compute and store L + * The strict upper part is not used and even not initialized. + */ + MatrixType m_matrix; + RealScalar m_l1_norm; + bool m_isInitialized; + ComputationInfo m_info; +}; + +namespace internal { + +template struct llt_inplace; + +template +static Index llt_rank_update_lower(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) +{ + using std::sqrt; + typedef typename MatrixType::Scalar Scalar; + typedef typename MatrixType::RealScalar RealScalar; + typedef typename MatrixType::ColXpr ColXpr; + typedef typename internal::remove_all::type ColXprCleaned; + typedef typename ColXprCleaned::SegmentReturnType ColXprSegment; + typedef Matrix TempVectorType; + typedef typename TempVectorType::SegmentReturnType TempVecSegment; + + Index n = mat.cols(); + eigen_assert(mat.rows()==n && vec.size()==n); + + TempVectorType temp; + + if(sigma>0) + { + // This version is based on Givens rotations. + // It is faster than the other one below, but only works for updates, + // i.e., for sigma > 0 + temp = sqrt(sigma) * vec; + + for(Index i=0; i g; + g.makeGivens(mat(i,i), -temp(i), &mat(i,i)); + + Index rs = n-i-1; + if(rs>0) + { + ColXprSegment x(mat.col(i).tail(rs)); + TempVecSegment y(temp.tail(rs)); + apply_rotation_in_the_plane(x, y, g); + } + } + } + else + { + temp = vec; + RealScalar beta = 1; + for(Index j=0; j struct llt_inplace +{ + typedef typename NumTraits::Real RealScalar; + template + static Index unblocked(MatrixType& mat) + { + using std::sqrt; + + eigen_assert(mat.rows()==mat.cols()); + const Index size = mat.rows(); + for(Index k = 0; k < size; ++k) + { + Index rs = size-k-1; // remaining size + + Block A21(mat,k+1,k,rs,1); + Block A10(mat,k,0,1,k); + Block A20(mat,k+1,0,rs,k); + + RealScalar x = numext::real(mat.coeff(k,k)); + if (k>0) x -= A10.squaredNorm(); + if (x<=RealScalar(0)) + return k; + mat.coeffRef(k,k) = x = sqrt(x); + if (k>0 && rs>0) A21.noalias() -= A20 * A10.adjoint(); + if (rs>0) A21 /= x; + } + return -1; + } + + template + static Index blocked(MatrixType& m) + { + eigen_assert(m.rows()==m.cols()); + Index size = m.rows(); + if(size<32) + return unblocked(m); + + Index blockSize = size/8; + blockSize = (blockSize/16)*16; + blockSize = (std::min)((std::max)(blockSize,Index(8)), Index(128)); + + for (Index k=0; k A11(m,k, k, bs,bs); + Block A21(m,k+bs,k, rs,bs); + Block A22(m,k+bs,k+bs,rs,rs); + + Index ret; + if((ret=unblocked(A11))>=0) return k+ret; + if(rs>0) A11.adjoint().template triangularView().template solveInPlace(A21); + if(rs>0) A22.template selfadjointView().rankUpdate(A21,typename NumTraits::Literal(-1)); // bottleneck + } + return -1; + } + + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) + { + return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); + } +}; + +template struct llt_inplace +{ + typedef typename NumTraits::Real RealScalar; + + template + static EIGEN_STRONG_INLINE Index unblocked(MatrixType& mat) + { + Transpose matt(mat); + return llt_inplace::unblocked(matt); + } + template + static EIGEN_STRONG_INLINE Index blocked(MatrixType& mat) + { + Transpose matt(mat); + return llt_inplace::blocked(matt); + } + template + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const RealScalar& sigma) + { + Transpose matt(mat); + return llt_inplace::rankUpdate(matt, vec.conjugate(), sigma); + } +}; + +template struct LLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m.adjoint()); } + static bool inplace_decomposition(MatrixType& m) + { return llt_inplace::blocked(m)==-1; } +}; + +template struct LLT_Traits +{ + typedef const TriangularView MatrixL; + typedef const TriangularView MatrixU; + static inline MatrixL getL(const MatrixType& m) { return MatrixL(m.adjoint()); } + static inline MatrixU getU(const MatrixType& m) { return MatrixU(m); } + static bool inplace_decomposition(MatrixType& m) + { return llt_inplace::blocked(m)==-1; } +}; + +} // end namespace internal + +/** Computes / recomputes the Cholesky decomposition A = LL^* = U^*U of \a matrix + * + * \returns a reference to *this + * + * Example: \include TutorialLinAlgComputeTwice.cpp + * Output: \verbinclude TutorialLinAlgComputeTwice.out + */ +template +template +LLT& LLT::compute(const EigenBase& a) +{ + check_template_parameters(); + + eigen_assert(a.rows()==a.cols()); + const Index size = a.rows(); + m_matrix.resize(size, size); + if (!internal::is_same_dense(m_matrix, a.derived())) + m_matrix = a.derived(); + + // Compute matrix L1 norm = max abs column sum. + m_l1_norm = RealScalar(0); + // TODO move this code to SelfAdjointView + for (Index col = 0; col < size; ++col) { + RealScalar abs_col_sum; + if (_UpLo == Lower) + abs_col_sum = m_matrix.col(col).tail(size - col).template lpNorm<1>() + m_matrix.row(col).head(col).template lpNorm<1>(); + else + abs_col_sum = m_matrix.col(col).head(col).template lpNorm<1>() + m_matrix.row(col).tail(size - col).template lpNorm<1>(); + if (abs_col_sum > m_l1_norm) + m_l1_norm = abs_col_sum; + } + + m_isInitialized = true; + bool ok = Traits::inplace_decomposition(m_matrix); + m_info = ok ? Success : NumericalIssue; + + return *this; +} + +/** Performs a rank one update (or dowdate) of the current decomposition. + * If A = LL^* before the rank one update, + * then after it we have LL^* = A + sigma * v v^* where \a v must be a vector + * of same dimension. + */ +template +template +LLT<_MatrixType,_UpLo> & LLT<_MatrixType,_UpLo>::rankUpdate(const VectorType& v, const RealScalar& sigma) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(VectorType); + eigen_assert(v.size()==m_matrix.cols()); + eigen_assert(m_isInitialized); + if(internal::llt_inplace::rankUpdate(m_matrix,v,sigma)>=0) + m_info = NumericalIssue; + else + m_info = Success; + + return *this; +} + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +template +void LLT<_MatrixType,_UpLo>::_solve_impl(const RhsType &rhs, DstType &dst) const +{ + _solve_impl_transposed(rhs, dst); +} + +template +template +void LLT<_MatrixType,_UpLo>::_solve_impl_transposed(const RhsType &rhs, DstType &dst) const +{ + dst = rhs; + + matrixL().template conjugateIf().solveInPlace(dst); + matrixU().template conjugateIf().solveInPlace(dst); +} +#endif + +/** \internal use x = llt_object.solve(x); + * + * This is the \em in-place version of solve(). + * + * \param bAndX represents both the right-hand side matrix b and result x. + * + * This version avoids a copy when the right hand side matrix b is not needed anymore. + * + * \warning The parameter is only marked 'const' to make the C++ compiler accept a temporary expression here. + * This function will const_cast it, so constness isn't honored here. + * + * \sa LLT::solve(), MatrixBase::llt() + */ +template +template +void LLT::solveInPlace(const MatrixBase &bAndX) const +{ + eigen_assert(m_isInitialized && "LLT is not initialized."); + eigen_assert(m_matrix.rows()==bAndX.rows()); + matrixL().solveInPlace(bAndX); + matrixU().solveInPlace(bAndX); +} + +/** \returns the matrix represented by the decomposition, + * i.e., it returns the product: L L^*. + * This function is provided for debug purpose. */ +template +MatrixType LLT::reconstructedMatrix() const +{ + eigen_assert(m_isInitialized && "LLT is not initialized."); + return matrixL() * matrixL().adjoint().toDenseMatrix(); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject> +MatrixBase::llt() const +{ + return LLT(derived()); +} + +/** \cholesky_module + * \returns the LLT decomposition of \c *this + * \sa SelfAdjointView::llt() + */ +template +inline const LLT::PlainObject, UpLo> +SelfAdjointView::llt() const +{ + return LLT(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_LLT_H diff --git a/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h new file mode 100644 index 0000000..bc6489e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Cholesky/LLT_LAPACKE.h @@ -0,0 +1,99 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to LAPACKe + * LLt decomposition based on LAPACKE_?potrf function. + ******************************************************************************** +*/ + +#ifndef EIGEN_LLT_LAPACKE_H +#define EIGEN_LLT_LAPACKE_H + +namespace Eigen { + +namespace internal { + +template struct lapacke_llt; + +#define EIGEN_LAPACKE_LLT(EIGTYPE, BLASTYPE, LAPACKE_PREFIX) \ +template<> struct lapacke_llt \ +{ \ + template \ + static inline Index potrf(MatrixType& m, char uplo) \ + { \ + lapack_int matrix_order; \ + lapack_int size, lda, info, StorageOrder; \ + EIGTYPE* a; \ + eigen_assert(m.rows()==m.cols()); \ + /* Set up parameters for ?potrf */ \ + size = convert_index(m.rows()); \ + StorageOrder = MatrixType::Flags&RowMajorBit?RowMajor:ColMajor; \ + matrix_order = StorageOrder==RowMajor ? LAPACK_ROW_MAJOR : LAPACK_COL_MAJOR; \ + a = &(m.coeffRef(0,0)); \ + lda = convert_index(m.outerStride()); \ +\ + info = LAPACKE_##LAPACKE_PREFIX##potrf( matrix_order, uplo, size, (BLASTYPE*)a, lda ); \ + info = (info==0) ? -1 : info>0 ? info-1 : size; \ + return info; \ + } \ +}; \ +template<> struct llt_inplace \ +{ \ + template \ + static Index blocked(MatrixType& m) \ + { \ + return lapacke_llt::potrf(m, 'L'); \ + } \ + template \ + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) \ + { return Eigen::internal::llt_rank_update_lower(mat, vec, sigma); } \ +}; \ +template<> struct llt_inplace \ +{ \ + template \ + static Index blocked(MatrixType& m) \ + { \ + return lapacke_llt::potrf(m, 'U'); \ + } \ + template \ + static Index rankUpdate(MatrixType& mat, const VectorType& vec, const typename MatrixType::RealScalar& sigma) \ + { \ + Transpose matt(mat); \ + return llt_inplace::rankUpdate(matt, vec.conjugate(), sigma); \ + } \ +}; + +EIGEN_LAPACKE_LLT(double, double, d) +EIGEN_LAPACKE_LLT(float, float, s) +EIGEN_LAPACKE_LLT(dcomplex, lapack_complex_double, z) +EIGEN_LAPACKE_LLT(scomplex, lapack_complex_float, c) + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_LLT_LAPACKE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h b/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h new file mode 100644 index 0000000..b6200fa --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArithmeticSequence.h @@ -0,0 +1,413 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARITHMETIC_SEQUENCE_H +#define EIGEN_ARITHMETIC_SEQUENCE_H + +namespace Eigen { + +namespace internal { + +#if (!EIGEN_HAS_CXX11) || !((!EIGEN_COMP_GNUC) || EIGEN_COMP_GNUC>=48) +template struct aseq_negate {}; + +template<> struct aseq_negate { + typedef Index type; +}; + +template struct aseq_negate > { + typedef FixedInt<-N> type; +}; + +// Compilation error in the following case: +template<> struct aseq_negate > {}; + +template::value, + bool SizeIsSymbolic =symbolic::is_symbolic::value> +struct aseq_reverse_first_type { + typedef Index type; +}; + +template +struct aseq_reverse_first_type { + typedef symbolic::AddExpr > >, + symbolic::ValueExpr > + > type; +}; + +template +struct aseq_reverse_first_type_aux { + typedef Index type; +}; + +template +struct aseq_reverse_first_type_aux::type> { + typedef FixedInt<(SizeType::value-1)*IncrType::value> type; +}; + +template +struct aseq_reverse_first_type { + typedef typename aseq_reverse_first_type_aux::type Aux; + typedef symbolic::AddExpr > type; +}; + +template +struct aseq_reverse_first_type { + typedef symbolic::AddExpr > >, + symbolic::ValueExpr >, + symbolic::ValueExpr<> > type; +}; +#endif + +// Helper to cleanup the type of the increment: +template struct cleanup_seq_incr { + typedef typename cleanup_index_type::type type; +}; + +} + +//-------------------------------------------------------------------------------- +// seq(first,last,incr) and seqN(first,size,incr) +//-------------------------------------------------------------------------------- + +template > +class ArithmeticSequence; + +template +ArithmeticSequence::type, + typename internal::cleanup_index_type::type, + typename internal::cleanup_seq_incr::type > +seqN(FirstType first, SizeType size, IncrType incr); + +/** \class ArithmeticSequence + * \ingroup Core_Module + * + * This class represents an arithmetic progression \f$ a_0, a_1, a_2, ..., a_{n-1}\f$ defined by + * its \em first value \f$ a_0 \f$, its \em size (aka length) \em n, and the \em increment (aka stride) + * that is equal to \f$ a_{i+1}-a_{i}\f$ for any \em i. + * + * It is internally used as the return type of the Eigen::seq and Eigen::seqN functions, and as the input arguments + * of DenseBase::operator()(const RowIndices&, const ColIndices&), and most of the time this is the + * only way it is used. + * + * \tparam FirstType type of the first element, usually an Index, + * but internally it can be a symbolic expression + * \tparam SizeType type representing the size of the sequence, usually an Index + * or a compile time integral constant. Internally, it can also be a symbolic expression + * \tparam IncrType type of the increment, can be a runtime Index, or a compile time integral constant (default is compile-time 1) + * + * \sa Eigen::seq, Eigen::seqN, DenseBase::operator()(const RowIndices&, const ColIndices&), class IndexedView + */ +template +class ArithmeticSequence +{ +public: + ArithmeticSequence(FirstType first, SizeType size) : m_first(first), m_size(size) {} + ArithmeticSequence(FirstType first, SizeType size, IncrType incr) : m_first(first), m_size(size), m_incr(incr) {} + + enum { + SizeAtCompileTime = internal::get_fixed_value::value, + IncrAtCompileTime = internal::get_fixed_value::value + }; + + /** \returns the size, i.e., number of elements, of the sequence */ + Index size() const { return m_size; } + + /** \returns the first element \f$ a_0 \f$ in the sequence */ + Index first() const { return m_first; } + + /** \returns the value \f$ a_i \f$ at index \a i in the sequence. */ + Index operator[](Index i) const { return m_first + i * m_incr; } + + const FirstType& firstObject() const { return m_first; } + const SizeType& sizeObject() const { return m_size; } + const IncrType& incrObject() const { return m_incr; } + +protected: + FirstType m_first; + SizeType m_size; + IncrType m_incr; + +public: + +#if EIGEN_HAS_CXX11 && ((!EIGEN_COMP_GNUC) || EIGEN_COMP_GNUC>=48) + auto reverse() const -> decltype(Eigen::seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr)) { + return seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr); + } +#else +protected: + typedef typename internal::aseq_negate::type ReverseIncrType; + typedef typename internal::aseq_reverse_first_type::type ReverseFirstType; +public: + ArithmeticSequence + reverse() const { + return seqN(m_first+(m_size+fix<-1>())*m_incr,m_size,-m_incr); + } +#endif +}; + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and increment \a incr + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +ArithmeticSequence::type,typename internal::cleanup_index_type::type,typename internal::cleanup_seq_incr::type > +seqN(FirstType first, SizeType size, IncrType incr) { + return ArithmeticSequence::type,typename internal::cleanup_index_type::type,typename internal::cleanup_seq_incr::type>(first,size,incr); +} + +/** \returns an ArithmeticSequence starting at \a first, of length \a size, and unit increment + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) */ +template +ArithmeticSequence::type,typename internal::cleanup_index_type::type > +seqN(FirstType first, SizeType size) { + return ArithmeticSequence::type,typename internal::cleanup_index_type::type>(first,size); +} + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and with positive (or negative) increment \a incr + * + * It is essentially an alias to: + * \code + * seqN(f, (l-f+incr)/incr, incr); + * \endcode + * + * \sa seqN(FirstType,SizeType,IncrType), seq(FirstType,LastType) + */ +template +auto seq(FirstType f, LastType l, IncrType incr); + +/** \returns an ArithmeticSequence starting at \a f, up (or down) to \a l, and unit increment + * + * It is essentially an alias to: + * \code + * seqN(f,l-f+1); + * \endcode + * + * \sa seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) + */ +template +auto seq(FirstType f, LastType l); + +#else // EIGEN_PARSED_BY_DOXYGEN + +#if EIGEN_HAS_CXX11 +template +auto seq(FirstType f, LastType l) -> decltype(seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + - typename internal::cleanup_index_type::type(f)+fix<1>()))) +{ + return seqN(typename internal::cleanup_index_type::type(f), + (typename internal::cleanup_index_type::type(l) + -typename internal::cleanup_index_type::type(f)+fix<1>())); +} + +template +auto seq(FirstType f, LastType l, IncrType incr) + -> decltype(seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + - typename internal::cleanup_index_type::type(f)+typename internal::cleanup_seq_incr::type(incr) + ) / typename internal::cleanup_seq_incr::type(incr), + typename internal::cleanup_seq_incr::type(incr))) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + ( typename internal::cleanup_index_type::type(l) + -typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr)) / CleanedIncrType(incr), + CleanedIncrType(incr)); +} + +#else // EIGEN_HAS_CXX11 + +template +typename internal::enable_if::value || symbolic::is_symbolic::value), + ArithmeticSequence::type,Index> >::type +seq(FirstType f, LastType l) +{ + return seqN(typename internal::cleanup_index_type::type(f), + Index((typename internal::cleanup_index_type::type(l)-typename internal::cleanup_index_type::type(f)+fix<1>()))); +} + +template +typename internal::enable_if::value, + ArithmeticSequence,symbolic::ValueExpr<> >, + symbolic::ValueExpr > > > >::type +seq(const symbolic::BaseExpr &f, LastType l) +{ + return seqN(f.derived(),(typename internal::cleanup_index_type::type(l)-f.derived()+fix<1>())); +} + +template +typename internal::enable_if::value, + ArithmeticSequence::type, + symbolic::AddExpr >, + symbolic::ValueExpr > > > >::type +seq(FirstType f, const symbolic::BaseExpr &l) +{ + return seqN(typename internal::cleanup_index_type::type(f),(l.derived()-typename internal::cleanup_index_type::type(f)+fix<1>())); +} + +template +ArithmeticSequence >,symbolic::ValueExpr > > > +seq(const symbolic::BaseExpr &f, const symbolic::BaseExpr &l) +{ + return seqN(f.derived(),(l.derived()-f.derived()+fix<1>())); +} + + +template +typename internal::enable_if::value || symbolic::is_symbolic::value), + ArithmeticSequence::type,Index,typename internal::cleanup_seq_incr::type> >::type +seq(FirstType f, LastType l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + Index((typename internal::cleanup_index_type::type(l)-typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr))/CleanedIncrType(incr)), incr); +} + +template +typename internal::enable_if::value, + ArithmeticSequence, + symbolic::ValueExpr<> >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> >::type +seq(const symbolic::BaseExpr &f, LastType l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(f.derived(),(typename internal::cleanup_index_type::type(l)-f.derived()+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} + +template +typename internal::enable_if::value, + ArithmeticSequence::type, + symbolic::QuotientExpr >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> >::type +seq(FirstType f, const symbolic::BaseExpr &l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(typename internal::cleanup_index_type::type(f), + (l.derived()-typename internal::cleanup_index_type::type(f)+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} + +template +ArithmeticSequence >, + symbolic::ValueExpr::type> >, + symbolic::ValueExpr::type> >, + typename internal::cleanup_seq_incr::type> +seq(const symbolic::BaseExpr &f, const symbolic::BaseExpr &l, IncrType incr) +{ + typedef typename internal::cleanup_seq_incr::type CleanedIncrType; + return seqN(f.derived(),(l.derived()-f.derived()+CleanedIncrType(incr))/CleanedIncrType(incr), incr); +} +#endif // EIGEN_HAS_CXX11 + +#endif // EIGEN_PARSED_BY_DOXYGEN + + +#if EIGEN_HAS_CXX11 || defined(EIGEN_PARSED_BY_DOXYGEN) +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with increment \a incr. + * + * It is a shortcut for: \code seqN(last-(size-fix<1>)*incr, size, incr) \endcode + * + * \sa lastN(SizeType), seqN(FirstType,SizeType), seq(FirstType,LastType,IncrType) */ +template +auto lastN(SizeType size, IncrType incr) +-> decltype(seqN(Eigen::last-(size-fix<1>())*incr, size, incr)) +{ + return seqN(Eigen::last-(size-fix<1>())*incr, size, incr); +} + +/** \cpp11 + * \returns a symbolic ArithmeticSequence representing the last \a size elements with a unit increment. + * + * It is a shortcut for: \code seq(last+fix<1>-size, last) \endcode + * + * \sa lastN(SizeType,IncrType, seqN(FirstType,SizeType), seq(FirstType,LastType) */ +template +auto lastN(SizeType size) +-> decltype(seqN(Eigen::last+fix<1>()-size, size)) +{ + return seqN(Eigen::last+fix<1>()-size, size); +} +#endif + +namespace internal { + +// Convert a symbolic span into a usable one (i.e., remove last/end "keywords") +template +struct make_size_type { + typedef typename internal::conditional::value, Index, T>::type type; +}; + +template +struct IndexedViewCompatibleType, XprSize> { + typedef ArithmeticSequence::type,IncrType> type; +}; + +template +ArithmeticSequence::type,IncrType> +makeIndexedViewCompatible(const ArithmeticSequence& ids, Index size,SpecializedType) { + return ArithmeticSequence::type,IncrType>( + eval_expr_given_size(ids.firstObject(),size),eval_expr_given_size(ids.sizeObject(),size),ids.incrObject()); +} + +template +struct get_compile_time_incr > { + enum { value = get_fixed_value::value }; +}; + +} // end namespace internal + +/** \namespace Eigen::indexing + * \ingroup Core_Module + * + * The sole purpose of this namespace is to be able to import all functions + * and symbols that are expected to be used within operator() for indexing + * and slicing. If you already imported the whole Eigen namespace: + * \code using namespace Eigen; \endcode + * then you are already all set. Otherwise, if you don't want/cannot import + * the whole Eigen namespace, the following line: + * \code using namespace Eigen::indexing; \endcode + * is equivalent to: + * \code + using Eigen::all; + using Eigen::seq; + using Eigen::seqN; + using Eigen::lastN; // c++11 only + using Eigen::last; + using Eigen::lastp1; + using Eigen::fix; + \endcode + */ +namespace indexing { + using Eigen::all; + using Eigen::seq; + using Eigen::seqN; + #if EIGEN_HAS_CXX11 + using Eigen::lastN; + #endif + using Eigen::last; + using Eigen::lastp1; + using Eigen::fix; +} + +} // end namespace Eigen + +#endif // EIGEN_ARITHMETIC_SEQUENCE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Array.h b/src/3rdparty/eigen/Eigen/src/Core/Array.h new file mode 100644 index 0000000..20c789b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Array.h @@ -0,0 +1,417 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAY_H +#define EIGEN_ARRAY_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits > +{ + typedef ArrayXpr XprKind; + typedef ArrayBase > XprBase; +}; +} + +/** \class Array + * \ingroup Core_Module + * + * \brief General-purpose arrays with easy API for coefficient-wise operations + * + * The %Array class is very similar to the Matrix class. It provides + * general-purpose one- and two-dimensional arrays. The difference between the + * %Array and the %Matrix class is primarily in the API: the API for the + * %Array class provides easy access to coefficient-wise operations, while the + * API for the %Matrix class provides easy access to linear-algebra + * operations. + * + * See documentation of class Matrix for detailed information on the template parameters + * storage layout. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAY_PLUGIN. + * + * \sa \blank \ref TutorialArrayClass, \ref TopicClassHierarchy + */ +template +class Array + : public PlainObjectBase > +{ + public: + + typedef PlainObjectBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Array) + + enum { Options = _Options }; + typedef typename Base::PlainObject PlainObject; + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; + + public: + + using Base::base; + using Base::coeff; + using Base::coeffRef; + + /** + * The usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const EigenBase &other) + { + return Base::operator=(other); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() + */ + /* This overload is needed because the usage of + * using Base::operator=; + * fails on MSVC. Since the code below is working with GCC and MSVC, we skipped + * the usage of 'using'. This should be done only for operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const Scalar &value) + { + Base::setConstant(value); + return *this; + } + + /** Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const DenseBase& other) + { + return Base::_set(other); + } + + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array& operator=(const Array& other) + { + return Base::_set(other); + } + + /** Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array() : Base() + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + // FIXME is it still needed ?? + /** \internal */ + EIGEN_DEVICE_FUNC + Array(internal::constructor_without_unaligned_array_assert) + : Base(internal::constructor_without_unaligned_array_assert()) + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } +#endif + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + Array(Array&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_constructible::value) + : Base(std::move(other)) + { + Base::_check_template_params(); + } + EIGEN_DEVICE_FUNC + Array& operator=(Array&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_assignable::value) + { + Base::operator=(std::move(other)); + return *this; + } +#endif + + #if EIGEN_HAS_CXX11 + /** \copydoc PlainObjectBase(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + * + * Example: \include Array_variadic_ctor_cxx11.cpp + * Output: \verbinclude Array_variadic_ctor_cxx11.out + * + * \sa Array(const std::initializer_list>&) + * \sa Array(const Scalar&), Array(const Scalar&,const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs an array and initializes it from the coefficients given as initializer-lists grouped by row. \cpp11 + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Array_initializer_list_23_cxx11.cpp + * Output: \verbinclude Array_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is triggered. + * + * In the case of a compile-time column 1D array, implicit transposition from a single row is allowed. + * Therefore Array{{1,2,3,4,5}} is legal and the more verbose syntax + * Array{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Array_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Array_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized arrays, the initializer list sizes must exactly match the array sizes, + * and implicit transposition is allowed for compile-time 1D arrays only. + * + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const std::initializer_list>& list) : Base(list) {} + #endif // end EIGEN_HAS_CXX11 + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE explicit Array(const T& x) + { + Base::_check_template_params(); + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const T0& val0, const T1& val1) + { + Base::_check_template_params(); + this->template _init2(val0, val1); + } + + #else + /** \brief Constructs a fixed-sized array initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC explicit Array(const Scalar *data); + /** Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * Note that this is only useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass the dimension here, so it makes more sense to use the default + * constructor Array() instead. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE explicit Array(Index dim); + /** constructs an initialized 1x1 Array with the given coefficient + * \sa const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args */ + Array(const Scalar& value); + /** constructs an uninitialized array with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size arrays. For fixed-size arrays, + * it is redundant to pass these parameters, so one should use the default constructor + * Array() instead. */ + Array(Index rows, Index cols); + /** constructs an initialized 2D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) */ + Array(const Scalar& val0, const Scalar& val1); + #endif // end EIGEN_PARSED_BY_DOXYGEN + + /** constructs an initialized 3D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 3) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + } + /** constructs an initialized 4D vector with given coefficients + * \sa Array(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Scalar& val0, const Scalar& val1, const Scalar& val2, const Scalar& val3) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Array, 4) + m_storage.data()[0] = val0; + m_storage.data()[1] = val1; + m_storage.data()[2] = val2; + m_storage.data()[3] = val3; + } + + /** Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const Array& other) + : Base(other) + { } + + private: + struct PrivateType {}; + public: + + /** \sa MatrixBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Array(const EigenBase &other, + typename internal::enable_if::value, + PrivateType>::type = PrivateType()) + : Base(other.derived()) + { } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT{ return 1; } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return this->innerSize(); } + + #ifdef EIGEN_ARRAY_PLUGIN + #include EIGEN_ARRAY_PLUGIN + #endif + + private: + + template + friend struct internal::matrix_swap_impl; +}; + +/** \defgroup arraytypedefs Global array typedefs + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common 1D and 2D array types. + * + * The general patterns are the following: + * + * \c ArrayRowsColsType where \c Rows and \c Cols can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size, + * and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c cd + * for complex double. + * + * For example, \c Array33d is a fixed-size 3x3 array type of doubles, and \c ArrayXXf is a dynamic-size matrix of floats. + * + * There are also \c ArraySizeType which are self-explanatory. For example, \c Array4cf is + * a fixed-size 1D array of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `ArrayRowsCols` where `Rows` and `Cols` can be \c 2,\c 3,\c 4, or \c X for fixed or dynamic size. + * - `ArraySize` where `Size` can be \c 2,\c 3,\c 4 or \c X for fixed or dynamic size 1D arrays. + * + * \sa class Array + */ + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##SizeSuffix##SizeSuffix##TypeSuffix; \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##Size##X##TypeSuffix; \ +/** \ingroup arraytypedefs */ \ +typedef Array Array##X##Size##TypeSuffix; + +#define EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 2, 2) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 3, 3) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, 4, 4) \ +EIGEN_MAKE_ARRAY_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#if EIGEN_HAS_CXX11 + +#define EIGEN_MAKE_ARRAY_TYPEDEFS(Size, SizeSuffix) \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##SizeSuffix##SizeSuffix = Array; \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##SizeSuffix = Array; + +#define EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(Size) \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##Size##X = Array; \ +/** \ingroup arraytypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Array##X##Size = Array; + +EIGEN_MAKE_ARRAY_TYPEDEFS(2, 2) +EIGEN_MAKE_ARRAY_TYPEDEFS(3, 3) +EIGEN_MAKE_ARRAY_TYPEDEFS(4, 4) +EIGEN_MAKE_ARRAY_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(2) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(3) +EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS(4) + +#undef EIGEN_MAKE_ARRAY_TYPEDEFS +#undef EIGEN_MAKE_ARRAY_FIXED_TYPEDEFS + +#endif // EIGEN_HAS_CXX11 + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, SizeSuffix) \ +using Eigen::Matrix##SizeSuffix##TypeSuffix; \ +using Eigen::Vector##SizeSuffix##TypeSuffix; \ +using Eigen::RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(TypeSuffix) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 2) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 3) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, 4) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE_AND_SIZE(TypeSuffix, X) \ + +#define EIGEN_USING_ARRAY_TYPEDEFS \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(i) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(f) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(d) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cf) \ +EIGEN_USING_ARRAY_TYPEDEFS_FOR_TYPE(cd) + +} // end namespace Eigen + +#endif // EIGEN_ARRAY_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h b/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h new file mode 100644 index 0000000..ea3dd1c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArrayBase.h @@ -0,0 +1,226 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYBASE_H +#define EIGEN_ARRAYBASE_H + +namespace Eigen { + +template class MatrixWrapper; + +/** \class ArrayBase + * \ingroup Core_Module + * + * \brief Base class for all 1D and 2D array, and related expressions + * + * An array is similar to a dense vector or matrix. While matrices are mathematical + * objects with well defined linear algebra operators, an array is just a collection + * of scalar values arranged in a one or two dimensionnal fashion. As the main consequence, + * all operations applied to an array are performed coefficient wise. Furthermore, + * arrays support scalar math functions of the c++ standard library (e.g., std::sin(x)), and convenient + * constructors allowing to easily write generic code working for both scalar values + * and arrays. + * + * This class is the base that is inherited by all array expression types. + * + * \tparam Derived is the derived type, e.g., an array or an expression type. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_ARRAYBASE_PLUGIN. + * + * \sa class MatrixBase, \ref TopicClassHierarchy + */ +template class ArrayBase + : public DenseBase +{ + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** The base class for a given storage type. */ + typedef ArrayBase StorageBaseType; + + typedef ArrayBase Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::operator-; + using Base::operator=; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Base::PlainObject PlainObject; + + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::ArrayBase +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/MatrixCwiseUnaryOps.h" +# include "../plugins/ArrayCwiseUnaryOps.h" +# include "../plugins/CommonCwiseBinaryOps.h" +# include "../plugins/MatrixCwiseBinaryOps.h" +# include "../plugins/ArrayCwiseBinaryOps.h" +# ifdef EIGEN_ARRAYBASE_PLUGIN +# include EIGEN_ARRAYBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const ArrayBase& other) + { + internal::call_assignment(derived(), other.derived()); + return derived(); + } + + /** Set all the entries to \a value. + * \sa DenseBase::setConstant(), DenseBase::fill() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const Scalar &value) + { Base::setConstant(value); return derived(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const Scalar& scalar); + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const Scalar& scalar); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const ArrayBase& other); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const ArrayBase& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator*=(const ArrayBase& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator/=(const ArrayBase& other); + + public: + EIGEN_DEVICE_FUNC + ArrayBase& array() { return *this; } + EIGEN_DEVICE_FUNC + const ArrayBase& array() const { return *this; } + + /** \returns an \link Eigen::MatrixBase Matrix \endlink expression of this array + * \sa MatrixBase::array() */ + EIGEN_DEVICE_FUNC + MatrixWrapper matrix() { return MatrixWrapper(derived()); } + EIGEN_DEVICE_FUNC + const MatrixWrapper matrix() const { return MatrixWrapper(derived()); } + +// template +// inline void evalTo(Dest& dst) const { dst = matrix(); } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(ArrayBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(ArrayBase) + + private: + explicit ArrayBase(Index); + ArrayBase(Index,Index); + template explicit ArrayBase(const ArrayBase&); + protected: + // mixing arrays and matrices is not legal + template Derived& operator+=(const MatrixBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} + // mixing arrays and matrices is not legal + template Derived& operator-=(const MatrixBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} +}; + +/** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator-=(const ArrayBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator+=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this * \a other coefficient wise. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator*=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::mul_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this / \a other coefficient wise. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +ArrayBase::operator/=(const ArrayBase& other) +{ + call_assignment(derived(), other.derived(), internal::div_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_ARRAYBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h b/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h new file mode 100644 index 0000000..2e9555b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ArrayWrapper.h @@ -0,0 +1,209 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ARRAYWRAPPER_H +#define EIGEN_ARRAYWRAPPER_H + +namespace Eigen { + +/** \class ArrayWrapper + * \ingroup Core_Module + * + * \brief Expression of a mathematical vector or matrix as an array object + * + * This class is the return type of MatrixBase::array(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::array(), class MatrixWrapper + */ + +namespace internal { +template +struct traits > + : public traits::type > +{ + typedef ArrayXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits::type >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} + +template +class ArrayWrapper : public ArrayBase > +{ + public: + typedef ArrayBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ArrayWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ArrayWrapper) + typedef typename internal::remove_all::type NestedExpression; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE ArrayWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_expression.coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_expression.coeffRef(index); + } + + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const { dst = m_expression; } + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const + { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) { m_expression.resize(rows,cols); } + + protected: + NestedExpressionType m_expression; +}; + +/** \class MatrixWrapper + * \ingroup Core_Module + * + * \brief Expression of an array as a mathematical vector or matrix + * + * This class is the return type of ArrayBase::matrix(), and most of the time + * this is the only way it is use. + * + * \sa MatrixBase::matrix(), class ArrayWrapper + */ + +namespace internal { +template +struct traits > + : public traits::type > +{ + typedef MatrixXpr XprKind; + // Let's remove NestByRefBit + enum { + Flags0 = traits::type >::Flags, + LvalueBitFlag = is_lvalue::value ? LvalueBit : 0, + Flags = (Flags0 & ~(NestByRefBit | LvalueBit)) | LvalueBitFlag + }; +}; +} + +template +class MatrixWrapper : public MatrixBase > +{ + public: + typedef MatrixBase > Base; + EIGEN_DENSE_PUBLIC_INTERFACE(MatrixWrapper) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(MatrixWrapper) + typedef typename internal::remove_all::type NestedExpression; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + typedef typename internal::ref_selector::non_const_type NestedExpressionType; + + using Base::coeffRef; + + EIGEN_DEVICE_FUNC + explicit inline MatrixWrapper(ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return m_expression.data(); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return m_expression.data(); } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_expression.derived().coeffRef(rowId, colId); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_expression.coeffRef(index); + } + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const + { + return m_expression; + } + + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index) */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) { m_expression.resize(newSize); } + /** Forwards the resizing request to the nested expression + * \sa DenseBase::resize(Index,Index)*/ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) { m_expression.resize(rows,cols); } + + protected: + NestedExpressionType m_expression; +}; + +} // end namespace Eigen + +#endif // EIGEN_ARRAYWRAPPER_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Assign.h b/src/3rdparty/eigen/Eigen/src/Core/Assign.h new file mode 100644 index 0000000..655412e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Assign.h @@ -0,0 +1,90 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007 Michael Olbrich +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_H +#define EIGEN_ASSIGN_H + +namespace Eigen { + +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase + ::lazyAssign(const DenseBase& other) +{ + enum{ + SameType = internal::is_same::value + }; + + EIGEN_STATIC_ASSERT_LVALUE(Derived) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Derived,OtherDerived) + EIGEN_STATIC_ASSERT(SameType,YOU_MIXED_DIFFERENT_NUMERIC_TYPES__YOU_NEED_TO_USE_THE_CAST_METHOD_OF_MATRIXBASE_TO_CAST_NUMERIC_TYPES_EXPLICITLY) + + eigen_assert(rows() == other.rows() && cols() == other.cols()); + internal::call_assignment_no_alias(derived(),other.derived()); + + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& DenseBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const MatrixBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const DenseBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const EigenBase& other) +{ + internal::call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE Derived& MatrixBase::operator=(const ReturnByValue& other) +{ + other.derived().evalTo(derived()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h b/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h new file mode 100644 index 0000000..7d76f0c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/AssignEvaluator.h @@ -0,0 +1,1010 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ASSIGN_EVALUATOR_H +#define EIGEN_ASSIGN_EVALUATOR_H + +namespace Eigen { + +// This implementation is based on Assign.h + +namespace internal { + +/*************************************************************************** +* Part 1 : the logic deciding a strategy for traversal and unrolling * +***************************************************************************/ + +// copy_using_evaluator_traits is based on assign_traits + +template +struct copy_using_evaluator_traits +{ + typedef typename DstEvaluator::XprType Dst; + typedef typename Dst::Scalar DstScalar; + + enum { + DstFlags = DstEvaluator::Flags, + SrcFlags = SrcEvaluator::Flags + }; + +public: + enum { + DstAlignment = DstEvaluator::Alignment, + SrcAlignment = SrcEvaluator::Alignment, + DstHasDirectAccess = (DstFlags & DirectAccessBit) == DirectAccessBit, + JointAlignment = EIGEN_PLAIN_ENUM_MIN(DstAlignment,SrcAlignment) + }; + +private: + enum { + InnerSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::SizeAtCompileTime) + : int(DstFlags)&RowMajorBit ? int(Dst::ColsAtCompileTime) + : int(Dst::RowsAtCompileTime), + InnerMaxSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::MaxSizeAtCompileTime) + : int(DstFlags)&RowMajorBit ? int(Dst::MaxColsAtCompileTime) + : int(Dst::MaxRowsAtCompileTime), + RestrictedInnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(InnerSize,MaxPacketSize), + RestrictedLinearSize = EIGEN_SIZE_MIN_PREFER_FIXED(Dst::SizeAtCompileTime,MaxPacketSize), + OuterStride = int(outer_stride_at_compile_time::ret), + MaxSizeAtCompileTime = Dst::SizeAtCompileTime + }; + + // TODO distinguish between linear traversal and inner-traversals + typedef typename find_best_packet::type LinearPacketType; + typedef typename find_best_packet::type InnerPacketType; + + enum { + LinearPacketSize = unpacket_traits::size, + InnerPacketSize = unpacket_traits::size + }; + +public: + enum { + LinearRequiredAlignment = unpacket_traits::alignment, + InnerRequiredAlignment = unpacket_traits::alignment + }; + +private: + enum { + DstIsRowMajor = DstFlags&RowMajorBit, + SrcIsRowMajor = SrcFlags&RowMajorBit, + StorageOrdersAgree = (int(DstIsRowMajor) == int(SrcIsRowMajor)), + MightVectorize = bool(StorageOrdersAgree) + && (int(DstFlags) & int(SrcFlags) & ActualPacketAccessBit) + && bool(functor_traits::PacketAccess), + MayInnerVectorize = MightVectorize + && int(InnerSize)!=Dynamic && int(InnerSize)%int(InnerPacketSize)==0 + && int(OuterStride)!=Dynamic && int(OuterStride)%int(InnerPacketSize)==0 + && (EIGEN_UNALIGNED_VECTORIZE || int(JointAlignment)>=int(InnerRequiredAlignment)), + MayLinearize = bool(StorageOrdersAgree) && (int(DstFlags) & int(SrcFlags) & LinearAccessBit), + MayLinearVectorize = bool(MightVectorize) && bool(MayLinearize) && bool(DstHasDirectAccess) + && (EIGEN_UNALIGNED_VECTORIZE || (int(DstAlignment)>=int(LinearRequiredAlignment)) || MaxSizeAtCompileTime == Dynamic), + /* If the destination isn't aligned, we have to do runtime checks and we don't unroll, + so it's only good for large enough sizes. */ + MaySliceVectorize = bool(MightVectorize) && bool(DstHasDirectAccess) + && (int(InnerMaxSize)==Dynamic || int(InnerMaxSize)>=(EIGEN_UNALIGNED_VECTORIZE?InnerPacketSize:(3*InnerPacketSize))) + /* slice vectorization can be slow, so we only want it if the slices are big, which is + indicated by InnerMaxSize rather than InnerSize, think of the case of a dynamic block + in a fixed-size matrix + However, with EIGEN_UNALIGNED_VECTORIZE and unrolling, slice vectorization is still worth it */ + }; + +public: + enum { + Traversal = int(Dst::SizeAtCompileTime) == 0 ? int(AllAtOnceTraversal) // If compile-size is zero, traversing will fail at compile-time. + : (int(MayLinearVectorize) && (LinearPacketSize>InnerPacketSize)) ? int(LinearVectorizedTraversal) + : int(MayInnerVectorize) ? int(InnerVectorizedTraversal) + : int(MayLinearVectorize) ? int(LinearVectorizedTraversal) + : int(MaySliceVectorize) ? int(SliceVectorizedTraversal) + : int(MayLinearize) ? int(LinearTraversal) + : int(DefaultTraversal), + Vectorized = int(Traversal) == InnerVectorizedTraversal + || int(Traversal) == LinearVectorizedTraversal + || int(Traversal) == SliceVectorizedTraversal + }; + + typedef typename conditional::type PacketType; + +private: + enum { + ActualPacketSize = int(Traversal)==LinearVectorizedTraversal ? LinearPacketSize + : Vectorized ? InnerPacketSize + : 1, + UnrollingLimit = EIGEN_UNROLLING_LIMIT * ActualPacketSize, + MayUnrollCompletely = int(Dst::SizeAtCompileTime) != Dynamic + && int(Dst::SizeAtCompileTime) * (int(DstEvaluator::CoeffReadCost)+int(SrcEvaluator::CoeffReadCost)) <= int(UnrollingLimit), + MayUnrollInner = int(InnerSize) != Dynamic + && int(InnerSize) * (int(DstEvaluator::CoeffReadCost)+int(SrcEvaluator::CoeffReadCost)) <= int(UnrollingLimit) + }; + +public: + enum { + Unrolling = (int(Traversal) == int(InnerVectorizedTraversal) || int(Traversal) == int(DefaultTraversal)) + ? ( + int(MayUnrollCompletely) ? int(CompleteUnrolling) + : int(MayUnrollInner) ? int(InnerUnrolling) + : int(NoUnrolling) + ) + : int(Traversal) == int(LinearVectorizedTraversal) + ? ( bool(MayUnrollCompletely) && ( EIGEN_UNALIGNED_VECTORIZE || (int(DstAlignment)>=int(LinearRequiredAlignment))) + ? int(CompleteUnrolling) + : int(NoUnrolling) ) + : int(Traversal) == int(LinearTraversal) + ? ( bool(MayUnrollCompletely) ? int(CompleteUnrolling) + : int(NoUnrolling) ) +#if EIGEN_UNALIGNED_VECTORIZE + : int(Traversal) == int(SliceVectorizedTraversal) + ? ( bool(MayUnrollInner) ? int(InnerUnrolling) + : int(NoUnrolling) ) +#endif + : int(NoUnrolling) + }; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() + { + std::cerr << "DstXpr: " << typeid(typename DstEvaluator::XprType).name() << std::endl; + std::cerr << "SrcXpr: " << typeid(typename SrcEvaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + std::cerr << "DstFlags" << " = " << DstFlags << " (" << demangle_flags(DstFlags) << " )" << std::endl; + std::cerr << "SrcFlags" << " = " << SrcFlags << " (" << demangle_flags(SrcFlags) << " )" << std::endl; + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(DstAlignment) + EIGEN_DEBUG_VAR(SrcAlignment) + EIGEN_DEBUG_VAR(LinearRequiredAlignment) + EIGEN_DEBUG_VAR(InnerRequiredAlignment) + EIGEN_DEBUG_VAR(JointAlignment) + EIGEN_DEBUG_VAR(InnerSize) + EIGEN_DEBUG_VAR(InnerMaxSize) + EIGEN_DEBUG_VAR(LinearPacketSize) + EIGEN_DEBUG_VAR(InnerPacketSize) + EIGEN_DEBUG_VAR(ActualPacketSize) + EIGEN_DEBUG_VAR(StorageOrdersAgree) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearize) + EIGEN_DEBUG_VAR(MayInnerVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(SrcEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(DstEvaluator::CoeffReadCost) + EIGEN_DEBUG_VAR(Dst::SizeAtCompileTime) + EIGEN_DEBUG_VAR(UnrollingLimit) + EIGEN_DEBUG_VAR(MayUnrollCompletely) + EIGEN_DEBUG_VAR(MayUnrollInner) + std::cerr << "Unrolling" << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** +* Part 2 : meta-unrollers +***************************************************************************/ + +/************************ +*** Default traversal *** +************************/ + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling +{ + // FIXME: this is not very clean, perhaps this information should be provided by the kernel? + typedef typename Kernel::DstEvaluatorType DstEvaluatorType; + typedef typename DstEvaluatorType::XprType DstXprType; + + enum { + outer = Index / DstXprType::InnerSizeAtCompileTime, + inner = Index % DstXprType::InnerSizeAtCompileTime + }; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + kernel.assignCoeffByOuterInner(outer, inner); + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, Index outer) + { + kernel.assignCoeffByOuterInner(outer, Index_); + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +template +struct copy_using_evaluator_DefaultTraversal_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&, Index) { } +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel& kernel) + { + kernel.assignCoeff(Index); + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_LinearTraversal_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct copy_using_evaluator_innervec_CompleteUnrolling +{ + // FIXME: this is not very clean, perhaps this information should be provided by the kernel? + typedef typename Kernel::DstEvaluatorType DstEvaluatorType; + typedef typename DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { + outer = Index / DstXprType::InnerSizeAtCompileTime, + inner = Index % DstXprType::InnerSizeAtCompileTime, + SrcAlignment = Kernel::AssignmentTraits::SrcAlignment, + DstAlignment = Kernel::AssignmentTraits::DstAlignment + }; + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + kernel.template assignPacketByOuterInner(outer, inner); + enum { NextIndex = Index + unpacket_traits::size }; + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct copy_using_evaluator_innervec_CompleteUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&) { } +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling +{ + typedef typename Kernel::PacketType PacketType; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, Index outer) + { + kernel.template assignPacketByOuterInner(outer, Index_); + enum { NextIndex = Index_ + unpacket_traits::size }; + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + } +}; + +template +struct copy_using_evaluator_innervec_InnerUnrolling +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &, Index) { } +}; + +/*************************************************************************** +* Part 3 : implementation of all cases +***************************************************************************/ + +// dense_assignment_loop is based on assign_impl + +template +struct dense_assignment_loop; + +/************************ +***** Special Cases ***** +************************/ + +// Zero-sized assignment is a no-op. +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE run(Kernel& /*kernel*/) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + EIGEN_STATIC_ASSERT(int(DstXprType::SizeAtCompileTime) == 0, + EIGEN_INTERNAL_ERROR_PLEASE_FILE_A_BUG_REPORT) + } +}; + +/************************ +*** Default traversal *** +************************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static void EIGEN_STRONG_INLINE run(Kernel &kernel) + { + for(Index outer = 0; outer < kernel.outerSize(); ++outer) { + for(Index inner = 0; inner < kernel.innerSize(); ++inner) { + kernel.assignCoeffByOuterInner(outer, inner); + } + } + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + + const Index outerSize = kernel.outerSize(); + for(Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } +}; + +/*************************** +*** Linear vectorization *** +***************************/ + + +// The goal of unaligned_dense_assignment_loop is simply to factorize the handling +// of the non vectorizable beginning and ending parts + +template +struct unaligned_dense_assignment_loop +{ + // if IsAligned = true, then do nothing + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel&, Index, Index) {} +}; + +template <> +struct unaligned_dense_assignment_loop +{ + // MSVC must not inline this functions. If it does, it fails to optimize the + // packet access path. + // FIXME check which version exhibits this issue +#if EIGEN_COMP_MSVC + template + static EIGEN_DONT_INLINE void run(Kernel &kernel, + Index start, + Index end) +#else + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel, + Index start, + Index end) +#endif + { + for (Index index = start; index < end; ++index) + kernel.assignCoeff(index); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index size = kernel.size(); + typedef typename Kernel::Scalar Scalar; + typedef typename Kernel::PacketType PacketType; + enum { + requestedAlignment = Kernel::AssignmentTraits::LinearRequiredAlignment, + packetSize = unpacket_traits::size, + dstIsAligned = int(Kernel::AssignmentTraits::DstAlignment)>=int(requestedAlignment), + dstAlignment = packet_traits::AlignedOnScalar ? int(requestedAlignment) + : int(Kernel::AssignmentTraits::DstAlignment), + srcAlignment = Kernel::AssignmentTraits::JointAlignment + }; + const Index alignedStart = dstIsAligned ? 0 : internal::first_aligned(kernel.dstDataPtr(), size); + const Index alignedEnd = alignedStart + ((size-alignedStart)/packetSize)*packetSize; + + unaligned_dense_assignment_loop::run(kernel, 0, alignedStart); + + for(Index index = alignedStart; index < alignedEnd; index += packetSize) + kernel.template assignPacket(index); + + unaligned_dense_assignment_loop<>::run(kernel, alignedEnd, size); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { size = DstXprType::SizeAtCompileTime, + packetSize =unpacket_traits::size, + alignedSize = (int(size)/packetSize)*packetSize }; + + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + copy_using_evaluator_DefaultTraversal_CompleteUnrolling::run(kernel); + } +}; + +/************************** +*** Inner vectorization *** +**************************/ + +template +struct dense_assignment_loop +{ + typedef typename Kernel::PacketType PacketType; + enum { + SrcAlignment = Kernel::AssignmentTraits::SrcAlignment, + DstAlignment = Kernel::AssignmentTraits::DstAlignment + }; + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + const Index packetSize = unpacket_traits::size; + for(Index outer = 0; outer < outerSize; ++outer) + for(Index inner = 0; inner < innerSize; inner+=packetSize) + kernel.template assignPacketByOuterInner(outer, inner); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_innervec_CompleteUnrolling::run(kernel); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::AssignmentTraits Traits; + const Index outerSize = kernel.outerSize(); + for(Index outer = 0; outer < outerSize; ++outer) + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + } +}; + +/*********************** +*** Linear traversal *** +***********************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + const Index size = kernel.size(); + for(Index i = 0; i < size; ++i) + kernel.assignCoeff(i); + } +}; + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + copy_using_evaluator_LinearTraversal_CompleteUnrolling::run(kernel); + } +}; + +/************************** +*** Slice vectorization *** +***************************/ + +template +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::Scalar Scalar; + typedef typename Kernel::PacketType PacketType; + enum { + packetSize = unpacket_traits::size, + requestedAlignment = int(Kernel::AssignmentTraits::InnerRequiredAlignment), + alignable = packet_traits::AlignedOnScalar || int(Kernel::AssignmentTraits::DstAlignment)>=sizeof(Scalar), + dstIsAligned = int(Kernel::AssignmentTraits::DstAlignment)>=int(requestedAlignment), + dstAlignment = alignable ? int(requestedAlignment) + : int(Kernel::AssignmentTraits::DstAlignment) + }; + const Scalar *dst_ptr = kernel.dstDataPtr(); + if((!bool(dstIsAligned)) && (UIntPtr(dst_ptr) % sizeof(Scalar))>0) + { + // the pointer is not aligned-on scalar, so alignment is not possible + return dense_assignment_loop::run(kernel); + } + const Index packetAlignedMask = packetSize - 1; + const Index innerSize = kernel.innerSize(); + const Index outerSize = kernel.outerSize(); + const Index alignedStep = alignable ? (packetSize - kernel.outerStride() % packetSize) & packetAlignedMask : 0; + Index alignedStart = ((!alignable) || bool(dstIsAligned)) ? 0 : internal::first_aligned(dst_ptr, innerSize); + + for(Index outer = 0; outer < outerSize; ++outer) + { + const Index alignedEnd = alignedStart + ((innerSize-alignedStart) & ~packetAlignedMask); + // do the non-vectorizable part of the assignment + for(Index inner = 0; inner(outer, inner); + + // do the non-vectorizable part of the assignment + for(Index inner = alignedEnd; inner +struct dense_assignment_loop +{ + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE void run(Kernel &kernel) + { + typedef typename Kernel::DstEvaluatorType::XprType DstXprType; + typedef typename Kernel::PacketType PacketType; + + enum { innerSize = DstXprType::InnerSizeAtCompileTime, + packetSize =unpacket_traits::size, + vectorizableSize = (int(innerSize) / int(packetSize)) * int(packetSize), + size = DstXprType::SizeAtCompileTime }; + + for(Index outer = 0; outer < kernel.outerSize(); ++outer) + { + copy_using_evaluator_innervec_InnerUnrolling::run(kernel, outer); + copy_using_evaluator_DefaultTraversal_InnerUnrolling::run(kernel, outer); + } + } +}; +#endif + + +/*************************************************************************** +* Part 4 : Generic dense assignment kernel +***************************************************************************/ + +// This class generalize the assignment of a coefficient (or packet) from one dense evaluator +// to another dense writable evaluator. +// It is parametrized by the two evaluators, and the actual assignment functor. +// This abstraction level permits to keep the evaluation loops as simple and as generic as possible. +// One can customize the assignment using this generic dense_assignment_kernel with different +// functors, or by completely overloading it, by-passing a functor. +template +class generic_dense_assignment_kernel +{ +protected: + typedef typename DstEvaluatorTypeT::XprType DstXprType; + typedef typename SrcEvaluatorTypeT::XprType SrcXprType; +public: + + typedef DstEvaluatorTypeT DstEvaluatorType; + typedef SrcEvaluatorTypeT SrcEvaluatorType; + typedef typename DstEvaluatorType::Scalar Scalar; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + generic_dense_assignment_kernel(DstEvaluatorType &dst, const SrcEvaluatorType &src, const Functor &func, DstXprType& dstExpr) + : m_dst(dst), m_src(src), m_functor(func), m_dstExpr(dstExpr) + { + #ifdef EIGEN_DEBUG_ASSIGN + AssignmentTraits::debug(); + #endif + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index size() const EIGEN_NOEXCEPT { return m_dstExpr.size(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index innerSize() const EIGEN_NOEXCEPT { return m_dstExpr.innerSize(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index outerSize() const EIGEN_NOEXCEPT { return m_dstExpr.outerSize(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_dstExpr.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_dstExpr.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index outerStride() const EIGEN_NOEXCEPT { return m_dstExpr.outerStride(); } + + EIGEN_DEVICE_FUNC DstEvaluatorType& dstEvaluator() EIGEN_NOEXCEPT { return m_dst; } + EIGEN_DEVICE_FUNC const SrcEvaluatorType& srcEvaluator() const EIGEN_NOEXCEPT { return m_src; } + + /// Assign src(row,col) to dst(row,col) through the assignment functor. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeff(Index row, Index col) + { + m_functor.assignCoeff(m_dst.coeffRef(row,col), m_src.coeff(row,col)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeff(Index index) + { + m_functor.assignCoeff(m_dst.coeffRef(index), m_src.coeff(index)); + } + + /// \sa assignCoeff(Index,Index) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignCoeffByOuterInner(Index outer, Index inner) + { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignCoeff(row, col); + } + + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index row, Index col) + { + m_functor.template assignPacket(&m_dst.coeffRef(row,col), m_src.template packet(row,col)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacket(Index index) + { + m_functor.template assignPacket(&m_dst.coeffRef(index), m_src.template packet(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void assignPacketByOuterInner(Index outer, Index inner) + { + Index row = rowIndexByOuterInner(outer, inner); + Index col = colIndexByOuterInner(outer, inner); + assignPacket(row, col); + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Index rowIndexByOuterInner(Index outer, Index inner) + { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::RowsAtCompileTime) == 1 ? 0 + : int(Traits::ColsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags)&RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE Index colIndexByOuterInner(Index outer, Index inner) + { + typedef typename DstEvaluatorType::ExpressionTraits Traits; + return int(Traits::ColsAtCompileTime) == 1 ? 0 + : int(Traits::RowsAtCompileTime) == 1 ? inner + : int(DstEvaluatorType::Flags)&RowMajorBit ? inner + : outer; + } + + EIGEN_DEVICE_FUNC const Scalar* dstDataPtr() const + { + return m_dstExpr.data(); + } + +protected: + DstEvaluatorType& m_dst; + const SrcEvaluatorType& m_src; + const Functor &m_functor; + // TODO find a way to avoid the needs of the original expression + DstXprType& m_dstExpr; +}; + +// Special kernel used when computing small products whose operands have dynamic dimensions. It ensures that the +// PacketSize used is no larger than 4, thereby increasing the chance that vectorized instructions will be used +// when computing the product. + +template +class restricted_packet_dense_assignment_kernel : public generic_dense_assignment_kernel +{ +protected: + typedef generic_dense_assignment_kernel Base; + public: + typedef typename Base::Scalar Scalar; + typedef typename Base::DstXprType DstXprType; + typedef copy_using_evaluator_traits AssignmentTraits; + typedef typename AssignmentTraits::PacketType PacketType; + + EIGEN_DEVICE_FUNC restricted_packet_dense_assignment_kernel(DstEvaluatorTypeT &dst, const SrcEvaluatorTypeT &src, const Functor &func, DstXprType& dstExpr) + : Base(dst, src, func, dstExpr) + { + } + }; + +/*************************************************************************** +* Part 5 : Entry point for dense rectangular assignment +***************************************************************************/ + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void resize_if_allowed(DstXprType &dst, const SrcXprType& src, const Functor &/*func*/) +{ + EIGEN_ONLY_USED_FOR_DEBUG(dst); + EIGEN_ONLY_USED_FOR_DEBUG(src); + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void resize_if_allowed(DstXprType &dst, const SrcXprType& src, const internal::assign_op &/*func*/) +{ + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if(((dst.rows()!=dstRows) || (dst.cols()!=dstCols))) + dst.resize(dstRows, dstCols); + eigen_assert(dst.rows() == dstRows && dst.cols() == dstCols); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src, const Functor &func) +{ + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + + SrcEvaluatorType srcEvaluator(src); + + // NOTE To properly handle A = (A*A.transpose())/s with A rectangular, + // we need to resize the destination after the source evaluator has been created. + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + + typedef generic_dense_assignment_kernel Kernel; + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +// Specialization for filling the destination with a constant value. +#ifndef EIGEN_GPU_COMPILE_PHASE +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const Eigen::CwiseNullaryOp, DstXprType>& src, const internal::assign_op& func) +{ + resize_if_allowed(dst, src, func); + std::fill_n(dst.data(), dst.size(), src.functor()()); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void call_dense_assignment_loop(DstXprType& dst, const SrcXprType& src) +{ + call_dense_assignment_loop(dst, src, internal::assign_op()); +} + +/*************************************************************************** +* Part 6 : Generic assignment +***************************************************************************/ + +// Based on the respective shapes of the destination and source, +// the class AssignmentKind determine the kind of assignment mechanism. +// AssignmentKind must define a Kind typedef. +template struct AssignmentKind; + +// Assignment kind defined in this file: +struct Dense2Dense {}; +struct EigenBase2EigenBase {}; + +template struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; +template<> struct AssignmentKind { typedef Dense2Dense Kind; }; + +// This is the main assignment class +template< typename DstXprType, typename SrcXprType, typename Functor, + typename Kind = typename AssignmentKind< typename evaluator_traits::Shape , typename evaluator_traits::Shape >::Kind, + typename EnableIf = void> +struct Assignment; + + +// The only purpose of this call_assignment() function is to deal with noalias() / "assume-aliasing" and automatic transposition. +// Indeed, I (Gael) think that this concept of "assume-aliasing" was a mistake, and it makes thing quite complicated. +// So this intermediate function removes everything related to "assume-aliasing" such that Assignment +// does not has to bother about these annoying details. + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src) +{ + call_assignment(dst, src, internal::assign_op()); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(const Dst& dst, const Src& src) +{ + call_assignment(dst, src, internal::assign_op()); +} + +// Deal with "assume-aliasing" +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src, const Func& func, typename enable_if< evaluator_assume_aliasing::value, void*>::type = 0) +{ + typename plain_matrix_type::type tmp(src); + call_assignment_no_alias(dst, tmp, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(Dst& dst, const Src& src, const Func& func, typename enable_if::value, void*>::type = 0) +{ + call_assignment_no_alias(dst, src, func); +} + +// by-pass "assume-aliasing" +// When there is no aliasing, we require that 'dst' has been properly resized +template class StorageBase, typename Src, typename Func> +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment(NoAlias& dst, const Src& src, const Func& func) +{ + call_assignment_no_alias(dst.expression(), src, func); +} + + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias(Dst& dst, const Src& src, const Func& func) +{ + enum { + NeedToTranspose = ( (int(Dst::RowsAtCompileTime) == 1 && int(Src::ColsAtCompileTime) == 1) + || (int(Dst::ColsAtCompileTime) == 1 && int(Src::RowsAtCompileTime) == 1) + ) && int(Dst::SizeAtCompileTime) != 1 + }; + + typedef typename internal::conditional, Dst>::type ActualDstTypeCleaned; + typedef typename internal::conditional, Dst&>::type ActualDstType; + ActualDstType actualDst(dst); + + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(ActualDstTypeCleaned,Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename ActualDstTypeCleaned::Scalar,typename Src::Scalar); + + Assignment::run(actualDst, src, func); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_restricted_packet_assignment_no_alias(Dst& dst, const Src& src, const Func& func) +{ + typedef evaluator DstEvaluatorType; + typedef evaluator SrcEvaluatorType; + typedef restricted_packet_dense_assignment_kernel Kernel; + + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename Dst::Scalar,typename Src::Scalar); + + SrcEvaluatorType srcEvaluator(src); + resize_if_allowed(dst, src, func); + + DstEvaluatorType dstEvaluator(dst); + Kernel kernel(dstEvaluator, srcEvaluator, func, dst.const_cast_derived()); + + dense_assignment_loop::run(kernel); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias(Dst& dst, const Src& src) +{ + call_assignment_no_alias(dst, src, internal::assign_op()); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src, const Func& func) +{ + // TODO check whether this is the right place to perform these checks: + EIGEN_STATIC_ASSERT_LVALUE(Dst) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Dst,Src) + EIGEN_CHECK_BINARY_COMPATIBILIY(Func,typename Dst::Scalar,typename Src::Scalar); + + Assignment::run(dst, src, func); +} +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +void call_assignment_no_alias_no_transpose(Dst& dst, const Src& src) +{ + call_assignment_no_alias_no_transpose(dst, src, internal::assign_op()); +} + +// forward declaration +template void check_for_aliasing(const Dst &dst, const Src &src); + +// Generic Dense to Dense assignment +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template< typename DstXprType, typename SrcXprType, typename Functor, typename Weak> +struct Assignment +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const Functor &func) + { +#ifndef EIGEN_NO_DEBUG + internal::check_for_aliasing(dst, src); +#endif + + call_dense_assignment_loop(dst, src, func); + } +}; + +// Generic assignment through evalTo. +// TODO: not sure we have to keep that one, but it helps porting current code to new evaluator mechanism. +// Note that the last template argument "Weak" is needed to make it possible to perform +// both partial specialization+SFINAE without ambiguous specialization +template< typename DstXprType, typename SrcXprType, typename Functor, typename Weak> +struct Assignment +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.evalTo(dst); + } + + // NOTE The following two functions are templated to avoid their instantiation if not needed + // This is needed because some expressions supports evalTo only and/or have 'void' as scalar type. + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.addTo(dst); + } + + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + src.subTo(dst); + } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_EVALUATOR_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h b/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h new file mode 100644 index 0000000..c6140d1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Assign_MKL.h @@ -0,0 +1,178 @@ +/* + Copyright (c) 2011, Intel Corporation. All rights reserved. + Copyright (C) 2015 Gael Guennebaud + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this + list of conditions and the following disclaimer. + * Redistributions in binary form must reproduce the above copyright notice, + this list of conditions and the following disclaimer in the documentation + and/or other materials provided with the distribution. + * Neither the name of Intel Corporation nor the names of its contributors may + be used to endorse or promote products derived from this software without + specific prior written permission. + + THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND + ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED + WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE + DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR + ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES + (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; + LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON + ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT + (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS + SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. + + ******************************************************************************** + * Content : Eigen bindings to Intel(R) MKL + * MKL VML support for coefficient-wise unary Eigen expressions like a=b.sin() + ******************************************************************************** +*/ + +#ifndef EIGEN_ASSIGN_VML_H +#define EIGEN_ASSIGN_VML_H + +namespace Eigen { + +namespace internal { + +template +class vml_assign_traits +{ + private: + enum { + DstHasDirectAccess = Dst::Flags & DirectAccessBit, + SrcHasDirectAccess = Src::Flags & DirectAccessBit, + StorageOrdersAgree = (int(Dst::IsRowMajor) == int(Src::IsRowMajor)), + InnerSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::SizeAtCompileTime) + : int(Dst::Flags)&RowMajorBit ? int(Dst::ColsAtCompileTime) + : int(Dst::RowsAtCompileTime), + InnerMaxSize = int(Dst::IsVectorAtCompileTime) ? int(Dst::MaxSizeAtCompileTime) + : int(Dst::Flags)&RowMajorBit ? int(Dst::MaxColsAtCompileTime) + : int(Dst::MaxRowsAtCompileTime), + MaxSizeAtCompileTime = Dst::SizeAtCompileTime, + + MightEnableVml = StorageOrdersAgree && DstHasDirectAccess && SrcHasDirectAccess && Src::InnerStrideAtCompileTime==1 && Dst::InnerStrideAtCompileTime==1, + MightLinearize = MightEnableVml && (int(Dst::Flags) & int(Src::Flags) & LinearAccessBit), + VmlSize = MightLinearize ? MaxSizeAtCompileTime : InnerMaxSize, + LargeEnough = VmlSize==Dynamic || VmlSize>=EIGEN_MKL_VML_THRESHOLD + }; + public: + enum { + EnableVml = MightEnableVml && LargeEnough, + Traversal = MightLinearize ? LinearTraversal : DefaultTraversal + }; +}; + +#define EIGEN_PP_EXPAND(ARG) ARG +#if !defined (EIGEN_FAST_MATH) || (EIGEN_FAST_MATH != 1) +#define EIGEN_VMLMODE_EXPAND_xLA , VML_HA +#else +#define EIGEN_VMLMODE_EXPAND_xLA , VML_LA +#endif + +#define EIGEN_VMLMODE_EXPAND_x_ + +#define EIGEN_VMLMODE_PREFIX_xLA vm +#define EIGEN_VMLMODE_PREFIX_x_ v +#define EIGEN_VMLMODE_PREFIX(VMLMODE) EIGEN_CAT(EIGEN_VMLMODE_PREFIX_x,VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template< typename DstXprType, typename SrcXprNested> \ + struct Assignment, SrcXprNested>, assign_op, \ + Dense2Dense, typename enable_if::EnableVml>::type> { \ + typedef CwiseUnaryOp, SrcXprNested> SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + if(vml_assign_traits::Traversal==LinearTraversal) { \ + VMLOP(dst.size(), (const VMLTYPE*)src.nestedExpression().data(), \ + (VMLTYPE*)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE) ); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for(Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = src.IsRowMajor ? &(src.nestedExpression().coeffRef(outer,0)) : \ + &(src.nestedExpression().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer,0)) : &(dst.coeffRef(0, outer)); \ + VMLOP( dst.innerSize(), (const VMLTYPE*)src_ptr, \ + (VMLTYPE*)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; \ + + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),s##VMLOP), float, float, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),d##VMLOP), double, double, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),c##VMLOP), scomplex, MKL_Complex8, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALL(EIGENOP, EIGEN_CAT(EIGEN_VMLMODE_PREFIX(VMLMODE),z##VMLOP), dcomplex, MKL_Complex16, VMLMODE) + +#define EIGEN_MKL_VML_DECLARE_UNARY_CALLS(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(EIGENOP, VMLOP, VMLMODE) \ + EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(EIGENOP, VMLOP, VMLMODE) + + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sin, Sin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(asin, Asin, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sinh, Sinh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cos, Cos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(acos, Acos, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(cosh, Cosh, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tan, Tan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(atan, Atan, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(tanh, Tanh, LA) +// EIGEN_MKL_VML_DECLARE_UNARY_CALLS(abs, Abs, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(exp, Exp, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log, Ln, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(log10, Log10, LA) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS(sqrt, Sqrt, _) + +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(square, Sqr, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_CPLX(arg, Arg, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(round, Round, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(floor, Floor, _) +EIGEN_MKL_VML_DECLARE_UNARY_CALLS_REAL(ceil, Ceil, _) + +#define EIGEN_MKL_VML_DECLARE_POW_CALL(EIGENOP, VMLOP, EIGENTYPE, VMLTYPE, VMLMODE) \ + template< typename DstXprType, typename SrcXprNested, typename Plain> \ + struct Assignment, SrcXprNested, \ + const CwiseNullaryOp,Plain> >, assign_op, \ + Dense2Dense, typename enable_if::EnableVml>::type> { \ + typedef CwiseBinaryOp, SrcXprNested, \ + const CwiseNullaryOp,Plain> > SrcXprType; \ + static void run(DstXprType &dst, const SrcXprType &src, const assign_op &func) { \ + resize_if_allowed(dst, src, func); \ + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); \ + VMLTYPE exponent = reinterpret_cast(src.rhs().functor().m_other); \ + if(vml_assign_traits::Traversal==LinearTraversal) \ + { \ + VMLOP( dst.size(), (const VMLTYPE*)src.lhs().data(), exponent, \ + (VMLTYPE*)dst.data() EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE) ); \ + } else { \ + const Index outerSize = dst.outerSize(); \ + for(Index outer = 0; outer < outerSize; ++outer) { \ + const EIGENTYPE *src_ptr = src.IsRowMajor ? &(src.lhs().coeffRef(outer,0)) : \ + &(src.lhs().coeffRef(0, outer)); \ + EIGENTYPE *dst_ptr = dst.IsRowMajor ? &(dst.coeffRef(outer,0)) : &(dst.coeffRef(0, outer)); \ + VMLOP( dst.innerSize(), (const VMLTYPE*)src_ptr, exponent, \ + (VMLTYPE*)dst_ptr EIGEN_PP_EXPAND(EIGEN_VMLMODE_EXPAND_x##VMLMODE)); \ + } \ + } \ + } \ + }; + +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmsPowx, float, float, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmdPowx, double, double, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmcPowx, scomplex, MKL_Complex8, LA) +EIGEN_MKL_VML_DECLARE_POW_CALL(pow, vmzPowx, dcomplex, MKL_Complex16, LA) + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_ASSIGN_VML_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h new file mode 100644 index 0000000..878c024 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/BandMatrix.h @@ -0,0 +1,353 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BANDMATRIX_H +#define EIGEN_BANDMATRIX_H + +namespace Eigen { + +namespace internal { + +template +class BandMatrixBase : public EigenBase +{ + public: + + enum { + Flags = internal::traits::Flags, + CoeffReadCost = internal::traits::CoeffReadCost, + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + Supers = internal::traits::Supers, + Subs = internal::traits::Subs, + Options = internal::traits::Options + }; + typedef typename internal::traits::Scalar Scalar; + typedef Matrix DenseMatrixType; + typedef typename DenseMatrixType::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef EigenBase Base; + + protected: + enum { + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) + ? 1 + Supers + Subs + : Dynamic, + SizeAtCompileTime = EIGEN_SIZE_MIN_PREFER_DYNAMIC(RowsAtCompileTime,ColsAtCompileTime) + }; + + public: + + using Base::derived; + using Base::rows; + using Base::cols; + + /** \returns the number of super diagonals */ + inline Index supers() const { return derived().supers(); } + + /** \returns the number of sub diagonals */ + inline Index subs() const { return derived().subs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline const CoefficientsType& coeffs() const { return derived().coeffs(); } + + /** \returns an expression of the underlying coefficient matrix */ + inline CoefficientsType& coeffs() { return derived().coeffs(); } + + /** \returns a vector expression of the \a i -th column, + * only the meaningful part is returned. + * \warning the internal storage must be column major. */ + inline Block col(Index i) + { + EIGEN_STATIC_ASSERT((int(Options) & int(RowMajor)) == 0, THIS_METHOD_IS_ONLY_FOR_COLUMN_MAJOR_MATRICES); + Index start = 0; + Index len = coeffs().rows(); + if (i<=supers()) + { + start = supers()-i; + len = (std::min)(rows(),std::max(0,coeffs().rows() - (supers()-i))); + } + else if (i>=rows()-subs()) + len = std::max(0,coeffs().rows() - (i + 1 - rows() + subs())); + return Block(coeffs(), start, i, len, 1); + } + + /** \returns a vector expression of the main diagonal */ + inline Block diagonal() + { return Block(coeffs(),supers(),0,1,(std::min)(rows(),cols())); } + + /** \returns a vector expression of the main diagonal (const version) */ + inline const Block diagonal() const + { return Block(coeffs(),supers(),0,1,(std::min)(rows(),cols())); } + + template struct DiagonalIntReturnType { + enum { + ReturnOpposite = (int(Options) & int(SelfAdjoint)) && (((Index) > 0 && Supers == 0) || ((Index) < 0 && Subs == 0)), + Conjugate = ReturnOpposite && NumTraits::IsComplex, + ActualIndex = ReturnOpposite ? -Index : Index, + DiagonalSize = (RowsAtCompileTime==Dynamic || ColsAtCompileTime==Dynamic) + ? Dynamic + : (ActualIndex<0 + ? EIGEN_SIZE_MIN_PREFER_DYNAMIC(ColsAtCompileTime, RowsAtCompileTime + ActualIndex) + : EIGEN_SIZE_MIN_PREFER_DYNAMIC(RowsAtCompileTime, ColsAtCompileTime - ActualIndex)) + }; + typedef Block BuildType; + typedef typename internal::conditional,BuildType >, + BuildType>::type Type; + }; + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template inline typename DiagonalIntReturnType::Type diagonal() + { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers()-N, (std::max)(0,N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a N -th sub or super diagonal */ + template inline const typename DiagonalIntReturnType::Type diagonal() const + { + return typename DiagonalIntReturnType::BuildType(coeffs(), supers()-N, (std::max)(0,N), 1, diagonalLength(N)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline Block diagonal(Index i) + { + eigen_assert((i<0 && -i<=subs()) || (i>=0 && i<=supers())); + return Block(coeffs(), supers()-i, std::max(0,i), 1, diagonalLength(i)); + } + + /** \returns a vector expression of the \a i -th sub or super diagonal */ + inline const Block diagonal(Index i) const + { + eigen_assert((i<0 && -i<=subs()) || (i>=0 && i<=supers())); + return Block(coeffs(), supers()-i, std::max(0,i), 1, diagonalLength(i)); + } + + template inline void evalTo(Dest& dst) const + { + dst.resize(rows(),cols()); + dst.setZero(); + dst.diagonal() = diagonal(); + for (Index i=1; i<=supers();++i) + dst.diagonal(i) = diagonal(i); + for (Index i=1; i<=subs();++i) + dst.diagonal(-i) = diagonal(-i); + } + + DenseMatrixType toDenseMatrix() const + { + DenseMatrixType res(rows(),cols()); + evalTo(res); + return res; + } + + protected: + + inline Index diagonalLength(Index i) const + { return i<0 ? (std::min)(cols(),rows()+i) : (std::min)(rows(),cols()-i); } +}; + +/** + * \class BandMatrix + * \ingroup Core_Module + * + * \brief Represents a rectangular matrix with a banded storage + * + * \tparam _Scalar Numeric type, i.e. float, double, int + * \tparam _Rows Number of rows, or \b Dynamic + * \tparam _Cols Number of columns, or \b Dynamic + * \tparam _Supers Number of super diagonal + * \tparam _Subs Number of sub diagonal + * \tparam _Options A combination of either \b #RowMajor or \b #ColMajor, and of \b #SelfAdjoint + * The former controls \ref TopicStorageOrders "storage order", and defaults to + * column-major. The latter controls whether the matrix represents a selfadjoint + * matrix in which case either Supers of Subs have to be null. + * + * \sa class TridiagonalMatrix + */ + +template +struct traits > +{ + typedef _Scalar Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + enum { + CoeffReadCost = NumTraits::ReadCost, + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _Rows, + MaxColsAtCompileTime = _Cols, + Flags = LvalueBit, + Supers = _Supers, + Subs = _Subs, + Options = _Options, + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef Matrix CoefficientsType; +}; + +template +class BandMatrix : public BandMatrixBase > +{ + public: + + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::CoefficientsType CoefficientsType; + + explicit inline BandMatrix(Index rows=Rows, Index cols=Cols, Index supers=Supers, Index subs=Subs) + : m_coeffs(1+supers+subs,cols), + m_rows(rows), m_supers(supers), m_subs(subs) + { + } + + /** \returns the number of columns */ + inline EIGEN_CONSTEXPR Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + inline EIGEN_CONSTEXPR Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + inline EIGEN_CONSTEXPR Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + inline EIGEN_CONSTEXPR Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + inline CoefficientsType& coeffs() { return m_coeffs; } + + protected: + + CoefficientsType m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +template +class BandMatrixWrapper; + +template +struct traits > +{ + typedef typename _CoefficientsType::Scalar Scalar; + typedef typename _CoefficientsType::StorageKind StorageKind; + typedef typename _CoefficientsType::StorageIndex StorageIndex; + enum { + CoeffReadCost = internal::traits<_CoefficientsType>::CoeffReadCost, + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _Rows, + MaxColsAtCompileTime = _Cols, + Flags = LvalueBit, + Supers = _Supers, + Subs = _Subs, + Options = _Options, + DataRowsAtCompileTime = ((Supers!=Dynamic) && (Subs!=Dynamic)) ? 1 + Supers + Subs : Dynamic + }; + typedef _CoefficientsType CoefficientsType; +}; + +template +class BandMatrixWrapper : public BandMatrixBase > +{ + public: + + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::traits::CoefficientsType CoefficientsType; + typedef typename internal::traits::StorageIndex StorageIndex; + + explicit inline BandMatrixWrapper(const CoefficientsType& coeffs, Index rows=_Rows, Index cols=_Cols, Index supers=_Supers, Index subs=_Subs) + : m_coeffs(coeffs), + m_rows(rows), m_supers(supers), m_subs(subs) + { + EIGEN_UNUSED_VARIABLE(cols); + //internal::assert(coeffs.cols()==cols() && (supers()+subs()+1)==coeffs.rows()); + } + + /** \returns the number of columns */ + inline EIGEN_CONSTEXPR Index rows() const { return m_rows.value(); } + + /** \returns the number of rows */ + inline EIGEN_CONSTEXPR Index cols() const { return m_coeffs.cols(); } + + /** \returns the number of super diagonals */ + inline EIGEN_CONSTEXPR Index supers() const { return m_supers.value(); } + + /** \returns the number of sub diagonals */ + inline EIGEN_CONSTEXPR Index subs() const { return m_subs.value(); } + + inline const CoefficientsType& coeffs() const { return m_coeffs; } + + protected: + + const CoefficientsType& m_coeffs; + internal::variable_if_dynamic m_rows; + internal::variable_if_dynamic m_supers; + internal::variable_if_dynamic m_subs; +}; + +/** + * \class TridiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a tridiagonal matrix with a compact banded storage + * + * \tparam Scalar Numeric type, i.e. float, double, int + * \tparam Size Number of rows and cols, or \b Dynamic + * \tparam Options Can be 0 or \b SelfAdjoint + * + * \sa class BandMatrix + */ +template +class TridiagonalMatrix : public BandMatrix +{ + typedef BandMatrix Base; + typedef typename Base::StorageIndex StorageIndex; + public: + explicit TridiagonalMatrix(Index size = Size) : Base(size,size,Options&SelfAdjoint?0:1,1) {} + + inline typename Base::template DiagonalIntReturnType<1>::Type super() + { return Base::template diagonal<1>(); } + inline const typename Base::template DiagonalIntReturnType<1>::Type super() const + { return Base::template diagonal<1>(); } + inline typename Base::template DiagonalIntReturnType<-1>::Type sub() + { return Base::template diagonal<-1>(); } + inline const typename Base::template DiagonalIntReturnType<-1>::Type sub() const + { return Base::template diagonal<-1>(); } + protected: +}; + + +struct BandShape {}; + +template +struct evaluator_traits > + : public evaluator_traits_base > +{ + typedef BandShape Shape; +}; + +template +struct evaluator_traits > + : public evaluator_traits_base > +{ + typedef BandShape Shape; +}; + +template<> struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BANDMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Block.h b/src/3rdparty/eigen/Eigen/src/Core/Block.h new file mode 100644 index 0000000..3206d66 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Block.h @@ -0,0 +1,448 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_BLOCK_H +#define EIGEN_BLOCK_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits +{ + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type XprTypeNested; + typedef typename remove_reference::type _XprTypeNested; + enum{ + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = MatrixRows == 0 ? 0 : BlockRows, + ColsAtCompileTime = MatrixCols == 0 ? 0 : BlockCols, + MaxRowsAtCompileTime = BlockRows==0 ? 0 + : RowsAtCompileTime != Dynamic ? int(RowsAtCompileTime) + : int(traits::MaxRowsAtCompileTime), + MaxColsAtCompileTime = BlockCols==0 ? 0 + : ColsAtCompileTime != Dynamic ? int(ColsAtCompileTime) + : int(traits::MaxColsAtCompileTime), + + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : XprTypeIsRowMajor, + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + + // FIXME, this traits is rather specialized for dense object and it needs to be cleaned further + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + Flags = (traits::Flags & (DirectAccessBit | (InnerPanel?CompressedAccessBit:0))) | FlagsLvalueBit | FlagsRowMajorBit, + // FIXME DirectAccessBit should not be handled by expressions + // + // Alignment is needed by MapBase's assertions + // We can sefely set it to false here. Internal alignment errors will be detected by an eigen_internal_assert in the respective evaluator + Alignment = 0 + }; +}; + +template::ret> class BlockImpl_dense; + +} // end namespace internal + +template class BlockImpl; + +/** \class Block + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size block + * + * \tparam XprType the type of the expression in which we are taking a block + * \tparam BlockRows the number of rows of the block we are taking at compile time (optional) + * \tparam BlockCols the number of columns of the block we are taking at compile time (optional) + * \tparam InnerPanel is true, if the block maps to a set of rows of a row major matrix or + * to set of columns of a column major matrix (optional). The parameter allows to determine + * at compile time whether aligned access is possible on the block expression. + * + * This class represents an expression of either a fixed-size or dynamic-size block. It is the return + * type of DenseBase::block(Index,Index,Index,Index) and DenseBase::block(Index,Index) and + * most of the time this is the only way it is used. + * + * However, if you want to directly maniputate block expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. + * + * Here is an example illustrating the dynamic case: + * \include class_Block.cpp + * Output: \verbinclude class_Block.out + * + * \note Even though this expression has dynamic size, in the case where \a XprType + * has fixed size, this expression inherits a fixed maximal size which means that evaluating + * it does not cause a dynamic memory allocation. + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedBlock.cpp + * Output: \verbinclude class_FixedBlock.out + * + * \sa DenseBase::block(Index,Index,Index,Index), DenseBase::block(Index,Index), class VectorBlock + */ +template class Block + : public BlockImpl::StorageKind> +{ + typedef BlockImpl::StorageKind> Impl; + public: + //typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Block) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Block) + + typedef typename internal::remove_all::type NestedExpression; + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Block(XprType& xpr, Index i) : Impl(xpr,i) + { + eigen_assert( (i>=0) && ( + ((BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) && i= 0 && BlockRows >= 0 && startRow + BlockRows <= xpr.rows() + && startCol >= 0 && BlockCols >= 0 && startCol + BlockCols <= xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Block(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) + { + eigen_assert((RowsAtCompileTime==Dynamic || RowsAtCompileTime==blockRows) + && (ColsAtCompileTime==Dynamic || ColsAtCompileTime==blockCols)); + eigen_assert(startRow >= 0 && blockRows >= 0 && startRow <= xpr.rows() - blockRows + && startCol >= 0 && blockCols >= 0 && startCol <= xpr.cols() - blockCols); + } +}; + +// The generic default implementation for dense block simplu forward to the internal::BlockImpl_dense +// that must be specialized for direct and non-direct access... +template +class BlockImpl + : public internal::BlockImpl_dense +{ + typedef internal::BlockImpl_dense Impl; + typedef typename XprType::StorageIndex StorageIndex; + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl) + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index i) : Impl(xpr,i) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol) : Impl(xpr, startRow, startCol) {} + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE BlockImpl(XprType& xpr, Index startRow, Index startCol, Index blockRows, Index blockCols) + : Impl(xpr, startRow, startCol, blockRows, blockCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Blocks in the general case. */ +template class BlockImpl_dense + : public internal::dense_xpr_base >::type +{ + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + // class InnerIterator; // FIXME apparently never used + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, Index i) + : m_xpr(xpr), + // It is a row if and only if BlockRows==1 and BlockCols==XprType::ColsAtCompileTime, + // and it is a column if and only if BlockRows==XprType::RowsAtCompileTime and BlockCols==1, + // all other cases are invalid. + // The case a 1x1 matrix seems ambiguous, but the result is the same anyway. + m_startRow( (BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) ? i : 0), + m_startCol( (BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) ? i : 0), + m_blockRows(BlockRows==1 ? 1 : xpr.rows()), + m_blockCols(BlockCols==1 ? 1 : xpr.cols()) + {} + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), + m_blockRows(BlockRows), m_blockCols(BlockCols) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline BlockImpl_dense(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : m_xpr(xpr), m_startRow(startRow), m_startCol(startCol), + m_blockRows(blockRows), m_blockCols(blockCols) + {} + + EIGEN_DEVICE_FUNC inline Index rows() const { return m_blockRows.value(); } + EIGEN_DEVICE_FUNC inline Index cols() const { return m_blockCols.value(); } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index rowId, Index colId) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return m_xpr.derived().coeffRef(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const + { + return m_xpr.coeff(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + return m_xpr.coeffRef(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + EIGEN_DEVICE_FUNC + inline const CoeffReturnType coeff(Index index) const + { + return m_xpr.coeff(m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + inline PacketScalar packet(Index rowId, Index colId) const + { + return m_xpr.template packet(rowId + m_startRow.value(), colId + m_startCol.value()); + } + + template + inline void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + m_xpr.template writePacket(rowId + m_startRow.value(), colId + m_startCol.value(), val); + } + + template + inline PacketScalar packet(Index index) const + { + return m_xpr.template packet + (m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0)); + } + + template + inline void writePacket(Index index, const PacketScalar& val) + { + m_xpr.template writePacket + (m_startRow.value() + (RowsAtCompileTime == 1 ? 0 : index), + m_startCol.value() + (RowsAtCompileTime == 1 ? index : 0), val); + } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; + #endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& nestedExpression() const + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + XprType& nestedExpression() { return m_xpr; } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startRow() const EIGEN_NOEXCEPT + { + return m_startRow.value(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startCol() const EIGEN_NOEXCEPT + { + return m_startCol.value(); + } + + protected: + + XprTypeNested m_xpr; + const internal::variable_if_dynamic m_startRow; + const internal::variable_if_dynamic m_startCol; + const internal::variable_if_dynamic m_blockRows; + const internal::variable_if_dynamic m_blockCols; +}; + +/** \internal Internal implementation of dense Blocks in the direct access case.*/ +template +class BlockImpl_dense + : public MapBase > +{ + typedef Block BlockType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + enum { + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0 + }; + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(BlockType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(BlockImpl_dense) + + /** Column or Row constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, Index i) + : Base(xpr.data() + i * ( ((BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) && (!XprTypeIsRowMajor)) + || ((BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) && ( XprTypeIsRowMajor)) ? xpr.innerStride() : xpr.outerStride()), + BlockRows==1 ? 1 : xpr.rows(), + BlockCols==1 ? 1 : xpr.cols()), + m_xpr(xpr), + m_startRow( (BlockRows==1) && (BlockCols==XprType::ColsAtCompileTime) ? i : 0), + m_startCol( (BlockRows==XprType::RowsAtCompileTime) && (BlockCols==1) ? i : 0) + { + init(); + } + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, Index startRow, Index startCol) + : Base(xpr.data()+xpr.innerStride()*(XprTypeIsRowMajor?startCol:startRow) + xpr.outerStride()*(XprTypeIsRowMajor?startRow:startCol)), + m_xpr(xpr), m_startRow(startRow), m_startCol(startCol) + { + init(); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, + Index startRow, Index startCol, + Index blockRows, Index blockCols) + : Base(xpr.data()+xpr.innerStride()*(XprTypeIsRowMajor?startCol:startRow) + xpr.outerStride()*(XprTypeIsRowMajor?startRow:startCol), blockRows, blockCols), + m_xpr(xpr), m_startRow(startRow), m_startCol(startCol) + { + init(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& nestedExpression() const EIGEN_NOEXCEPT + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index innerStride() const EIGEN_NOEXCEPT + { + return internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.innerStride() + : m_xpr.outerStride(); + } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index outerStride() const EIGEN_NOEXCEPT + { + return internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.outerStride() + : m_xpr.innerStride(); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startRow() const EIGEN_NOEXCEPT { return m_startRow.value(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + StorageIndex startCol() const EIGEN_NOEXCEPT { return m_startCol.value(); } + + #ifndef __SUNPRO_CC + // FIXME sunstudio is not friendly with the above friend... + // META-FIXME there is no 'friend' keyword around here. Is this obsolete? + protected: + #endif + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal used by allowAligned() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + BlockImpl_dense(XprType& xpr, const Scalar* data, Index blockRows, Index blockCols) + : Base(data, blockRows, blockCols), m_xpr(xpr) + { + init(); + } + #endif + + protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void init() + { + m_outerStride = internal::traits::HasSameStorageOrderAsXprType + ? m_xpr.outerStride() + : m_xpr.innerStride(); + } + + XprTypeNested m_xpr; + const internal::variable_if_dynamic m_startRow; + const internal::variable_if_dynamic m_startCol; + Index m_outerStride; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_BLOCK_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/BooleanRedux.h b/src/3rdparty/eigen/Eigen/src/Core/BooleanRedux.h new file mode 100644 index 0000000..852de8b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/BooleanRedux.h @@ -0,0 +1,162 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_ALLANDANY_H +#define EIGEN_ALLANDANY_H + +namespace Eigen { + +namespace internal { + +template +struct all_unroller +{ + enum { + col = (UnrollCount-1) / Rows, + row = (UnrollCount-1) % Rows + }; + + EIGEN_DEVICE_FUNC static inline bool run(const Derived &mat) + { + return all_unroller::run(mat) && mat.coeff(row, col); + } +}; + +template +struct all_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &/*mat*/) { return true; } +}; + +template +struct all_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &) { return false; } +}; + +template +struct any_unroller +{ + enum { + col = (UnrollCount-1) / Rows, + row = (UnrollCount-1) % Rows + }; + + EIGEN_DEVICE_FUNC static inline bool run(const Derived &mat) + { + return any_unroller::run(mat) || mat.coeff(row, col); + } +}; + +template +struct any_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived & /*mat*/) { return false; } +}; + +template +struct any_unroller +{ + EIGEN_DEVICE_FUNC static inline bool run(const Derived &) { return false; } +}; + +} // end namespace internal + +/** \returns true if all coefficients are true + * + * Example: \include MatrixBase_all.cpp + * Output: \verbinclude MatrixBase_all.out + * + * \sa any(), Cwise::operator<() + */ +template +EIGEN_DEVICE_FUNC inline bool DenseBase::all() const +{ + typedef internal::evaluator Evaluator; + enum { + unroll = SizeAtCompileTime != Dynamic + && SizeAtCompileTime * (int(Evaluator::CoeffReadCost) + int(NumTraits::AddCost)) <= EIGEN_UNROLLING_LIMIT + }; + Evaluator evaluator(derived()); + if(unroll) + return internal::all_unroller::RowsAtCompileTime>::run(evaluator); + else + { + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if (!evaluator.coeff(i, j)) return false; + return true; + } +} + +/** \returns true if at least one coefficient is true + * + * \sa all() + */ +template +EIGEN_DEVICE_FUNC inline bool DenseBase::any() const +{ + typedef internal::evaluator Evaluator; + enum { + unroll = SizeAtCompileTime != Dynamic + && SizeAtCompileTime * (int(Evaluator::CoeffReadCost) + int(NumTraits::AddCost)) <= EIGEN_UNROLLING_LIMIT + }; + Evaluator evaluator(derived()); + if(unroll) + return internal::any_unroller::RowsAtCompileTime>::run(evaluator); + else + { + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if (evaluator.coeff(i, j)) return true; + return false; + } +} + +/** \returns the number of coefficients which evaluate to true + * + * \sa all(), any() + */ +template +EIGEN_DEVICE_FUNC inline Eigen::Index DenseBase::count() const +{ + return derived().template cast().template cast().sum(); +} + +/** \returns true is \c *this contains at least one Not A Number (NaN). + * + * \sa allFinite() + */ +template +inline bool DenseBase::hasNaN() const +{ +#if EIGEN_COMP_MSVC || (defined __FAST_MATH__) + return derived().array().isNaN().any(); +#else + return !((derived().array()==derived().array()).all()); +#endif +} + +/** \returns true if \c *this contains only finite numbers, i.e., no NaN and no +/-INF values. + * + * \sa hasNaN() + */ +template +inline bool DenseBase::allFinite() const +{ +#if EIGEN_COMP_MSVC || (defined __FAST_MATH__) + return derived().array().isFinite().all(); +#else + return !((derived()-derived()).hasNaN()); +#endif +} + +} // end namespace Eigen + +#endif // EIGEN_ALLANDANY_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h b/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h new file mode 100644 index 0000000..c0e29c7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CommaInitializer.h @@ -0,0 +1,164 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COMMAINITIALIZER_H +#define EIGEN_COMMAINITIALIZER_H + +namespace Eigen { + +/** \class CommaInitializer + * \ingroup Core_Module + * + * \brief Helper class used by the comma initializer operator + * + * This class is internally used to implement the comma initializer feature. It is + * the return type of MatrixBase::operator<<, and most of the time this is the only + * way it is used. + * + * \sa \blank \ref MatrixBaseCommaInitRef "MatrixBase::operator<<", CommaInitializer::finished() + */ +template +struct CommaInitializer +{ + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC + inline CommaInitializer(XprType& xpr, const Scalar& s) + : m_xpr(xpr), m_row(0), m_col(1), m_currentBlockRows(1) + { + eigen_assert(m_xpr.rows() > 0 && m_xpr.cols() > 0 + && "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.coeffRef(0,0) = s; + } + + template + EIGEN_DEVICE_FUNC + inline CommaInitializer(XprType& xpr, const DenseBase& other) + : m_xpr(xpr), m_row(0), m_col(other.cols()), m_currentBlockRows(other.rows()) + { + eigen_assert(m_xpr.rows() >= other.rows() && m_xpr.cols() >= other.cols() + && "Cannot comma-initialize a 0x0 matrix (operator<<)"); + m_xpr.block(0, 0, other.rows(), other.cols()) = other; + } + + /* Copy/Move constructor which transfers ownership. This is crucial in + * absence of return value optimization to avoid assertions during destruction. */ + // FIXME in C++11 mode this could be replaced by a proper RValue constructor + EIGEN_DEVICE_FUNC + inline CommaInitializer(const CommaInitializer& o) + : m_xpr(o.m_xpr), m_row(o.m_row), m_col(o.m_col), m_currentBlockRows(o.m_currentBlockRows) { + // Mark original object as finished. In absence of R-value references we need to const_cast: + const_cast(o).m_row = m_xpr.rows(); + const_cast(o).m_col = m_xpr.cols(); + const_cast(o).m_currentBlockRows = 0; + } + + /* inserts a scalar value in the target matrix */ + EIGEN_DEVICE_FUNC + CommaInitializer& operator,(const Scalar& s) + { + if (m_col==m_xpr.cols()) + { + m_row+=m_currentBlockRows; + m_col = 0; + m_currentBlockRows = 1; + eigen_assert(m_row + EIGEN_DEVICE_FUNC + CommaInitializer& operator,(const DenseBase& other) + { + if (m_col==m_xpr.cols() && (other.cols()!=0 || other.rows()!=m_currentBlockRows)) + { + m_row+=m_currentBlockRows; + m_col = 0; + m_currentBlockRows = other.rows(); + eigen_assert(m_row+m_currentBlockRows<=m_xpr.rows() + && "Too many rows passed to comma initializer (operator<<)"); + } + eigen_assert((m_col + other.cols() <= m_xpr.cols()) + && "Too many coefficients passed to comma initializer (operator<<)"); + eigen_assert(m_currentBlockRows==other.rows()); + m_xpr.template block + (m_row, m_col, other.rows(), other.cols()) = other; + m_col += other.cols(); + return *this; + } + + EIGEN_DEVICE_FUNC + inline ~CommaInitializer() +#if defined VERIFY_RAISES_ASSERT && (!defined EIGEN_NO_ASSERTION_CHECKING) && defined EIGEN_EXCEPTIONS + EIGEN_EXCEPTION_SPEC(Eigen::eigen_assert_exception) +#endif + { + finished(); + } + + /** \returns the built matrix once all its coefficients have been set. + * Calling finished is 100% optional. Its purpose is to write expressions + * like this: + * \code + * quaternion.fromRotationMatrix((Matrix3f() << axis0, axis1, axis2).finished()); + * \endcode + */ + EIGEN_DEVICE_FUNC + inline XprType& finished() { + eigen_assert(((m_row+m_currentBlockRows) == m_xpr.rows() || m_xpr.cols() == 0) + && m_col == m_xpr.cols() + && "Too few coefficients passed to comma initializer (operator<<)"); + return m_xpr; + } + + XprType& m_xpr; // target expression + Index m_row; // current row id + Index m_col; // current col id + Index m_currentBlockRows; // current block height +}; + +/** \anchor MatrixBaseCommaInitRef + * Convenient operator to set the coefficients of a matrix. + * + * The coefficients must be provided in a row major order and exactly match + * the size of the matrix. Otherwise an assertion is raised. + * + * Example: \include MatrixBase_set.cpp + * Output: \verbinclude MatrixBase_set.out + * + * \note According the c++ standard, the argument expressions of this comma initializer are evaluated in arbitrary order. + * + * \sa CommaInitializer::finished(), class CommaInitializer + */ +template +EIGEN_DEVICE_FUNC inline CommaInitializer DenseBase::operator<< (const Scalar& s) +{ + return CommaInitializer(*static_cast(this), s); +} + +/** \sa operator<<(const Scalar&) */ +template +template +EIGEN_DEVICE_FUNC inline CommaInitializer +DenseBase::operator<<(const DenseBase& other) +{ + return CommaInitializer(*static_cast(this), other); +} + +} // end namespace Eigen + +#endif // EIGEN_COMMAINITIALIZER_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h b/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h new file mode 100644 index 0000000..51a2e5f --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ConditionEstimator.h @@ -0,0 +1,175 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2016 Rasmus Munk Larsen (rmlarsen@google.com) +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CONDITIONESTIMATOR_H +#define EIGEN_CONDITIONESTIMATOR_H + +namespace Eigen { + +namespace internal { + +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + const RealVector v_abs = v.cwiseAbs(); + return (v_abs.array() == static_cast(0)) + .select(Vector::Ones(v.size()), v.cwiseQuotient(v_abs)); + } +}; + +// Partial specialization to avoid elementwise division for real vectors. +template +struct rcond_compute_sign { + static inline Vector run(const Vector& v) { + return (v.array() < static_cast(0)) + .select(-Vector::Ones(v.size()), Vector::Ones(v.size())); + } +}; + +/** + * \returns an estimate of ||inv(matrix)||_1 given a decomposition of + * \a matrix that implements .solve() and .adjoint().solve() methods. + * + * This function implements Algorithms 4.1 and 5.1 from + * http://www.maths.manchester.ac.uk/~higham/narep/narep135.pdf + * which also forms the basis for the condition number estimators in + * LAPACK. Since at most 10 calls to the solve method of dec are + * performed, the total cost is O(dims^2), as opposed to O(dims^3) + * needed to compute the inverse matrix explicitly. + * + * The most common usage is in estimating the condition number + * ||matrix||_1 * ||inv(matrix)||_1. The first term ||matrix||_1 can be + * computed directly in O(n^2) operations. + * + * Supports the following decompositions: FullPivLU, PartialPivLU, LDLT, and + * LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar rcond_invmatrix_L1_norm_estimate(const Decomposition& dec) +{ + typedef typename Decomposition::MatrixType MatrixType; + typedef typename Decomposition::Scalar Scalar; + typedef typename Decomposition::RealScalar RealScalar; + typedef typename internal::plain_col_type::type Vector; + typedef typename internal::plain_col_type::type RealVector; + const bool is_complex = (NumTraits::IsComplex != 0); + + eigen_assert(dec.rows() == dec.cols()); + const Index n = dec.rows(); + if (n == 0) + return 0; + + // Disable Index to float conversion warning +#ifdef __INTEL_COMPILER + #pragma warning push + #pragma warning ( disable : 2259 ) +#endif + Vector v = dec.solve(Vector::Ones(n) / Scalar(n)); +#ifdef __INTEL_COMPILER + #pragma warning pop +#endif + + // lower_bound is a lower bound on + // ||inv(matrix)||_1 = sup_v ||inv(matrix) v||_1 / ||v||_1 + // and is the objective maximized by the ("super-") gradient ascent + // algorithm below. + RealScalar lower_bound = v.template lpNorm<1>(); + if (n == 1) + return lower_bound; + + // Gradient ascent algorithm follows: We know that the optimum is achieved at + // one of the simplices v = e_i, so in each iteration we follow a + // super-gradient to move towards the optimal one. + RealScalar old_lower_bound = lower_bound; + Vector sign_vector(n); + Vector old_sign_vector; + Index v_max_abs_index = -1; + Index old_v_max_abs_index = v_max_abs_index; + for (int k = 0; k < 4; ++k) + { + sign_vector = internal::rcond_compute_sign::run(v); + if (k > 0 && !is_complex && sign_vector == old_sign_vector) { + // Break if the solution stagnated. + break; + } + // v_max_abs_index = argmax |real( inv(matrix)^T * sign_vector )| + v = dec.adjoint().solve(sign_vector); + v.real().cwiseAbs().maxCoeff(&v_max_abs_index); + if (v_max_abs_index == old_v_max_abs_index) { + // Break if the solution stagnated. + break; + } + // Move to the new simplex e_j, where j = v_max_abs_index. + v = dec.solve(Vector::Unit(n, v_max_abs_index)); // v = inv(matrix) * e_j. + lower_bound = v.template lpNorm<1>(); + if (lower_bound <= old_lower_bound) { + // Break if the gradient step did not increase the lower_bound. + break; + } + if (!is_complex) { + old_sign_vector = sign_vector; + } + old_v_max_abs_index = v_max_abs_index; + old_lower_bound = lower_bound; + } + // The following calculates an independent estimate of ||matrix||_1 by + // multiplying matrix by a vector with entries of slowly increasing + // magnitude and alternating sign: + // v_i = (-1)^{i} (1 + (i / (dim-1))), i = 0,...,dim-1. + // This improvement to Hager's algorithm above is due to Higham. It was + // added to make the algorithm more robust in certain corner cases where + // large elements in the matrix might otherwise escape detection due to + // exact cancellation (especially when op and op_adjoint correspond to a + // sequence of backsubstitutions and permutations), which could cause + // Hager's algorithm to vastly underestimate ||matrix||_1. + Scalar alternating_sign(RealScalar(1)); + for (Index i = 0; i < n; ++i) { + // The static_cast is needed when Scalar is a complex and RealScalar implements expression templates + v[i] = alternating_sign * static_cast(RealScalar(1) + (RealScalar(i) / (RealScalar(n - 1)))); + alternating_sign = -alternating_sign; + } + v = dec.solve(v); + const RealScalar alternate_lower_bound = (2 * v.template lpNorm<1>()) / (3 * RealScalar(n)); + return numext::maxi(lower_bound, alternate_lower_bound); +} + +/** \brief Reciprocal condition number estimator. + * + * Computing a decomposition of a dense matrix takes O(n^3) operations, while + * this method estimates the condition number quickly and reliably in O(n^2) + * operations. + * + * \returns an estimate of the reciprocal condition number + * (1 / (||matrix||_1 * ||inv(matrix)||_1)) of matrix, given ||matrix||_1 and + * its decomposition. Supports the following decompositions: FullPivLU, + * PartialPivLU, LDLT, and LLT. + * + * \sa FullPivLU, PartialPivLU, LDLT, LLT. + */ +template +typename Decomposition::RealScalar +rcond_estimate_helper(typename Decomposition::RealScalar matrix_norm, const Decomposition& dec) +{ + typedef typename Decomposition::RealScalar RealScalar; + eigen_assert(dec.rows() == dec.cols()); + if (dec.rows() == 0) return NumTraits::infinity(); + if (matrix_norm == RealScalar(0)) return RealScalar(0); + if (dec.rows() == 1) return RealScalar(1); + const RealScalar inverse_matrix_norm = rcond_invmatrix_L1_norm_estimate(dec); + return (inverse_matrix_norm == RealScalar(0) ? RealScalar(0) + : (RealScalar(1) / inverse_matrix_norm) / matrix_norm); +} + +} // namespace internal + +} // namespace Eigen + +#endif diff --git a/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h b/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h new file mode 100644 index 0000000..0ff8c8d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CoreEvaluators.h @@ -0,0 +1,1741 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011 Benoit Jacob +// Copyright (C) 2011-2014 Gael Guennebaud +// Copyright (C) 2011-2012 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +#ifndef EIGEN_COREEVALUATORS_H +#define EIGEN_COREEVALUATORS_H + +namespace Eigen { + +namespace internal { + +// This class returns the evaluator kind from the expression storage kind. +// Default assumes index based accessors +template +struct storage_kind_to_evaluator_kind { + typedef IndexBased Kind; +}; + +// This class returns the evaluator shape from the expression storage kind. +// It can be Dense, Sparse, Triangular, Diagonal, SelfAdjoint, Band, etc. +template struct storage_kind_to_shape; + +template<> struct storage_kind_to_shape { typedef DenseShape Shape; }; +template<> struct storage_kind_to_shape { typedef SolverShape Shape; }; +template<> struct storage_kind_to_shape { typedef PermutationShape Shape; }; +template<> struct storage_kind_to_shape { typedef TranspositionsShape Shape; }; + +// Evaluators have to be specialized with respect to various criteria such as: +// - storage/structure/shape +// - scalar type +// - etc. +// Therefore, we need specialization of evaluator providing additional template arguments for each kind of evaluators. +// We currently distinguish the following kind of evaluators: +// - unary_evaluator for expressions taking only one arguments (CwiseUnaryOp, CwiseUnaryView, Transpose, MatrixWrapper, ArrayWrapper, Reverse, Replicate) +// - binary_evaluator for expression taking two arguments (CwiseBinaryOp) +// - ternary_evaluator for expression taking three arguments (CwiseTernaryOp) +// - product_evaluator for linear algebra products (Product); special case of binary_evaluator because it requires additional tags for dispatching. +// - mapbase_evaluator for Map, Block, Ref +// - block_evaluator for Block (special dispatching to a mapbase_evaluator or unary_evaluator) + +template< typename T, + typename Arg1Kind = typename evaluator_traits::Kind, + typename Arg2Kind = typename evaluator_traits::Kind, + typename Arg3Kind = typename evaluator_traits::Kind, + typename Arg1Scalar = typename traits::Scalar, + typename Arg2Scalar = typename traits::Scalar, + typename Arg3Scalar = typename traits::Scalar> struct ternary_evaluator; + +template< typename T, + typename LhsKind = typename evaluator_traits::Kind, + typename RhsKind = typename evaluator_traits::Kind, + typename LhsScalar = typename traits::Scalar, + typename RhsScalar = typename traits::Scalar> struct binary_evaluator; + +template< typename T, + typename Kind = typename evaluator_traits::Kind, + typename Scalar = typename T::Scalar> struct unary_evaluator; + +// evaluator_traits contains traits for evaluator + +template +struct evaluator_traits_base +{ + // by default, get evaluator kind and shape from storage + typedef typename storage_kind_to_evaluator_kind::StorageKind>::Kind Kind; + typedef typename storage_kind_to_shape::StorageKind>::Shape Shape; +}; + +// Default evaluator traits +template +struct evaluator_traits : public evaluator_traits_base +{ +}; + +template::Shape > +struct evaluator_assume_aliasing { + static const bool value = false; +}; + +// By default, we assume a unary expression: +template +struct evaluator : public unary_evaluator +{ + typedef unary_evaluator Base; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const T& xpr) : Base(xpr) {} +}; + + +// TODO: Think about const-correctness +template +struct evaluator + : evaluator +{ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const T& xpr) : evaluator(xpr) {} +}; + +// ---------- base class for all evaluators ---------- + +template +struct evaluator_base +{ + // TODO that's not very nice to have to propagate all these traits. They are currently only needed to handle outer,inner indices. + typedef traits ExpressionTraits; + + enum { + Alignment = 0 + }; + // noncopyable: + // Don't make this class inherit noncopyable as this kills EBO (Empty Base Optimization) + // and make complex evaluator much larger than then should do. + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE evaluator_base() {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ~evaluator_base() {} +private: + EIGEN_DEVICE_FUNC evaluator_base(const evaluator_base&); + EIGEN_DEVICE_FUNC const evaluator_base& operator=(const evaluator_base&); +}; + +// -------------------- Matrix and Array -------------------- +// +// evaluator is a common base class for the +// Matrix and Array evaluators. +// Here we directly specialize evaluator. This is not really a unary expression, and it is, by definition, dense, +// so no need for more sophisticated dispatching. + +// this helper permits to completely eliminate m_outerStride if it is known at compiletime. +template class plainobjectbase_evaluator_data { +public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) : data(ptr) + { +#ifndef EIGEN_INTERNAL_DEBUGGING + EIGEN_UNUSED_VARIABLE(outerStride); +#endif + eigen_internal_assert(outerStride==OuterStride); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index outerStride() const EIGEN_NOEXCEPT { return OuterStride; } + const Scalar *data; +}; + +template class plainobjectbase_evaluator_data { +public: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + plainobjectbase_evaluator_data(const Scalar* ptr, Index outerStride) : data(ptr), m_outerStride(outerStride) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Index outerStride() const { return m_outerStride; } + const Scalar *data; +protected: + Index m_outerStride; +}; + +template +struct evaluator > + : evaluator_base +{ + typedef PlainObjectBase PlainObjectType; + typedef typename PlainObjectType::Scalar Scalar; + typedef typename PlainObjectType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = PlainObjectType::IsRowMajor, + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime, + RowsAtCompileTime = PlainObjectType::RowsAtCompileTime, + ColsAtCompileTime = PlainObjectType::ColsAtCompileTime, + + CoeffReadCost = NumTraits::ReadCost, + Flags = traits::EvaluatorFlags, + Alignment = traits::Alignment + }; + enum { + // We do not need to know the outer stride for vectors + OuterStrideAtCompileTime = IsVectorAtCompileTime ? 0 + : int(IsRowMajor) ? ColsAtCompileTime + : RowsAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() + : m_d(0,OuterStrideAtCompileTime) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const PlainObjectType& m) + : m_d(m.data(),IsVectorAtCompileTime ? 0 : m.outerStride()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + if (IsRowMajor) + return m_d.data[row * m_d.outerStride() + col]; + else + return m_d.data[row + col * m_d.outerStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.data[index]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + if (IsRowMajor) + return const_cast(m_d.data)[row * m_d.outerStride() + col]; + else + return const_cast(m_d.data)[row + col * m_d.outerStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return const_cast(m_d.data)[index]; + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + if (IsRowMajor) + return ploadt(m_d.data + row * m_d.outerStride() + col); + else + return ploadt(m_d.data + row + col * m_d.outerStride()); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return ploadt(m_d.data + index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + if (IsRowMajor) + return pstoret + (const_cast(m_d.data) + row * m_d.outerStride() + col, x); + else + return pstoret + (const_cast(m_d.data) + row + col * m_d.outerStride(), x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + return pstoret(const_cast(m_d.data) + index, x); + } + +protected: + + plainobjectbase_evaluator_data m_d; +}; + +template +struct evaluator > + : evaluator > > +{ + typedef Matrix XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& m) + : evaluator >(m) + { } +}; + +template +struct evaluator > + : evaluator > > +{ + typedef Array XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + evaluator() {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& m) + : evaluator >(m) + { } +}; + +// -------------------- Transpose -------------------- + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef Transpose XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags ^ RowMajorBit, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& t) : m_argImpl(t.nestedExpression()) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(col, row); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(col, row); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + typename XprType::Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(col, row); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_argImpl.template packet(index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + m_argImpl.template writePacket(col, row, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + m_argImpl.template writePacket(index, x); + } + +protected: + evaluator m_argImpl; +}; + +// -------------------- CwiseNullaryOp -------------------- +// Like Matrix and Array, this is not really a unary expression, so we directly specialize evaluator. +// Likewise, there is not need to more sophisticated dispatching here. + +template::value, + bool has_unary = has_unary_operator::value, + bool has_binary = has_binary_operator::value> +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { return op(i,j); } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { return op(i); } + + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { return op.template packetOp(i,j); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { return op.template packetOp(i); } +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType=0, IndexType=0) const { return op(); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType=0, IndexType=0) const { return op.template packetOp(); } +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j=0) const { return op(i,j); } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j=0) const { return op.template packetOp(i,j); } +}; + +// We need the following specialization for vector-only functors assigned to a runtime vector, +// for instance, using linspace and assigning a RowVectorXd to a MatrixXd or even a row of a MatrixXd. +// In this case, i==0 and j is used for the actual iteration. +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i==0 || j==0); + return op(i+j); + } + template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + eigen_assert(i==0 || j==0); + return op.template packetOp(i+j); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { return op(i); } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { return op.template packetOp(i); } +}; + +template +struct nullary_wrapper {}; + +#if 0 && EIGEN_COMP_MSVC>0 +// Disable this ugly workaround. This is now handled in traits::match, +// but this piece of code might still become handly if some other weird compilation +// erros pop up again. + +// MSVC exhibits a weird compilation error when +// compiling: +// Eigen::MatrixXf A = MatrixXf::Random(3,3); +// Ref R = 2.f*A; +// and that has_*ary_operator> have not been instantiated yet. +// The "problem" is that evaluator<2.f*A> is instantiated by traits::match<2.f*A> +// and at that time has_*ary_operator returns true regardless of T. +// Then nullary_wrapper is badly instantiated as nullary_wrapper<.,.,true,true,true>. +// The trick is thus to defer the proper instantiation of nullary_wrapper when coeff(), +// and packet() are really instantiated as implemented below: + +// This is a simple wrapper around Index to enforce the re-instantiation of +// has_*ary_operator when needed. +template struct nullary_wrapper_workaround_msvc { + nullary_wrapper_workaround_msvc(const T&); + operator T()const; +}; + +template +struct nullary_wrapper +{ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar operator()(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().operator()(op,i); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i, IndexType j) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i,j); + } + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE T packetOp(const NullaryOp& op, IndexType i) const { + return nullary_wrapper >::value, + has_unary_operator >::value, + has_binary_operator >::value>().template packetOp(op,i); + } +}; +#endif // MSVC workaround + +template +struct evaluator > + : evaluator_base > +{ + typedef CwiseNullaryOp XprType; + typedef typename internal::remove_all::type PlainObjectTypeCleaned; + + enum { + CoeffReadCost = internal::functor_traits::Cost, + + Flags = (evaluator::Flags + & ( HereditaryBits + | (functor_has_linear_access::ret ? LinearAccessBit : 0) + | (functor_traits::PacketAccess ? PacketAccessBit : 0))) + | (functor_traits::IsRepeatable ? 0 : EvalBeforeNestingBit), + Alignment = AlignedMax + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& n) + : m_functor(n.functor()), m_wrapper() + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(IndexType row, IndexType col) const + { + return m_wrapper(m_functor, row, col); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(IndexType index) const + { + return m_wrapper(m_functor,index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(IndexType row, IndexType col) const + { + return m_wrapper.template packetOp(m_functor, row, col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(IndexType index) const + { + return m_wrapper.template packetOp(m_functor, index); + } + +protected: + const NullaryOp m_functor; + const internal::nullary_wrapper m_wrapper; +}; + +// -------------------- CwiseUnaryOp -------------------- + +template +struct unary_evaluator, IndexBased > + : evaluator_base > +{ + typedef CwiseUnaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = evaluator::Flags + & (HereditaryBits | LinearAccessBit | (functor_traits::PacketAccess ? PacketAccessBit : 0)), + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& op) : m_d(op) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.argImpl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.argImpl.template packet(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// -------------------- CwiseTernaryOp -------------------- + +// this is a ternary expression +template +struct evaluator > + : public ternary_evaluator > +{ + typedef CwiseTernaryOp XprType; + typedef ternary_evaluator > Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct ternary_evaluator, IndexBased, IndexBased> + : evaluator_base > +{ + typedef CwiseTernaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Arg1Flags = evaluator::Flags, + Arg2Flags = evaluator::Flags, + Arg3Flags = evaluator::Flags, + SameType = is_same::value && is_same::value, + StorageOrdersAgree = (int(Arg1Flags)&RowMajorBit)==(int(Arg2Flags)&RowMajorBit) && (int(Arg1Flags)&RowMajorBit)==(int(Arg3Flags)&RowMajorBit), + Flags0 = (int(Arg1Flags) | int(Arg2Flags) | int(Arg3Flags)) & ( + HereditaryBits + | (int(Arg1Flags) & int(Arg2Flags) & int(Arg3Flags) & + ( (StorageOrdersAgree ? LinearAccessBit : 0) + | (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0) + ) + ) + ), + Flags = (Flags0 & ~RowMajorBit) | (Arg1Flags & RowMajorBit), + Alignment = EIGEN_PLAIN_ENUM_MIN( + EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, evaluator::Alignment), + evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC explicit ternary_evaluator(const XprType& xpr) : m_d(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.arg1Impl.coeff(row, col), m_d.arg2Impl.coeff(row, col), m_d.arg3Impl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.arg1Impl.coeff(index), m_d.arg2Impl.coeff(index), m_d.arg3Impl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.arg1Impl.template packet(row, col), + m_d.arg2Impl.template packet(row, col), + m_d.arg3Impl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.arg1Impl.template packet(index), + m_d.arg2Impl.template packet(index), + m_d.arg3Impl.template packet(index)); + } + +protected: + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), arg1Impl(xpr.arg1()), arg2Impl(xpr.arg2()), arg3Impl(xpr.arg3()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const TernaryOp& func() const { return op; } + TernaryOp op; + evaluator arg1Impl; + evaluator arg2Impl; + evaluator arg3Impl; + }; + + Data m_d; +}; + +// -------------------- CwiseBinaryOp -------------------- + +// this is a binary expression +template +struct evaluator > + : public binary_evaluator > +{ + typedef CwiseBinaryOp XprType; + typedef binary_evaluator > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +template +struct binary_evaluator, IndexBased, IndexBased> + : evaluator_base > +{ + typedef CwiseBinaryOp XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + LhsFlags = evaluator::Flags, + RhsFlags = evaluator::Flags, + SameType = is_same::value, + StorageOrdersAgree = (int(LhsFlags)&RowMajorBit)==(int(RhsFlags)&RowMajorBit), + Flags0 = (int(LhsFlags) | int(RhsFlags)) & ( + HereditaryBits + | (int(LhsFlags) & int(RhsFlags) & + ( (StorageOrdersAgree ? LinearAccessBit : 0) + | (functor_traits::PacketAccess && StorageOrdersAgree && SameType ? PacketAccessBit : 0) + ) + ) + ), + Flags = (Flags0 & ~RowMajorBit) | (LhsFlags & RowMajorBit), + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment,evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit binary_evaluator(const XprType& xpr) : m_d(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.lhsImpl.coeff(row, col), m_d.rhsImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.lhsImpl.coeff(index), m_d.rhsImpl.coeff(index)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_d.func().packetOp(m_d.lhsImpl.template packet(row, col), + m_d.rhsImpl.template packet(row, col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_d.func().packetOp(m_d.lhsImpl.template packet(index), + m_d.rhsImpl.template packet(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), lhsImpl(xpr.lhs()), rhsImpl(xpr.rhs()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const BinaryOp& func() const { return op; } + BinaryOp op; + evaluator lhsImpl; + evaluator rhsImpl; + }; + + Data m_d; +}; + +// -------------------- CwiseUnaryView -------------------- + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef CwiseUnaryView XprType; + + enum { + CoeffReadCost = int(evaluator::CoeffReadCost) + int(functor_traits::Cost), + + Flags = (evaluator::Flags & (HereditaryBits | LinearAccessBit | DirectAccessBit)), + + Alignment = 0 // FIXME it is not very clear why alignment is necessarily lost... + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& op) : m_d(op) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(functor_traits::Cost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_d.func()(m_d.argImpl.coeff(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_d.func()(m_d.argImpl.coeff(index)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_d.func()(m_d.argImpl.coeffRef(row, col)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_d.func()(m_d.argImpl.coeffRef(index)); + } + +protected: + + // this helper permits to completely eliminate the functor if it is empty + struct Data + { + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Data(const XprType& xpr) : op(xpr.functor()), argImpl(xpr.nestedExpression()) {} + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& func() const { return op; } + UnaryOp op; + evaluator argImpl; + }; + + Data m_d; +}; + +// -------------------- Map -------------------- + +// FIXME perhaps the PlainObjectType could be provided by Derived::PlainObject ? +// but that might complicate template specialization +template +struct mapbase_evaluator; + +template +struct mapbase_evaluator : evaluator_base +{ + typedef Derived XprType; + typedef typename XprType::PointerType PointerType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::RowsAtCompileTime, + ColsAtCompileTime = XprType::ColsAtCompileTime, + CoeffReadCost = NumTraits::ReadCost + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit mapbase_evaluator(const XprType& map) + : m_data(const_cast(map.data())), + m_innerStride(map.innerStride()), + m_outerStride(map.outerStride()) + { + EIGEN_STATIC_ASSERT(EIGEN_IMPLIES(evaluator::Flags&PacketAccessBit, internal::inner_stride_at_compile_time::ret==1), + PACKET_ACCESS_REQUIRES_TO_HAVE_INNER_STRIDE_FIXED_TO_1); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_data[index * m_innerStride.value()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_data[index * m_innerStride.value()]; + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return internal::ploadt(ptr); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return internal::ploadt(m_data + index * m_innerStride.value()); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + PointerType ptr = m_data + row * rowStride() + col * colStride(); + return internal::pstoret(ptr, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + internal::pstoret(m_data + index * m_innerStride.value(), x); + } +protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowStride() const EIGEN_NOEXCEPT { + return XprType::IsRowMajor ? m_outerStride.value() : m_innerStride.value(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colStride() const EIGEN_NOEXCEPT { + return XprType::IsRowMajor ? m_innerStride.value() : m_outerStride.value(); + } + + PointerType m_data; + const internal::variable_if_dynamic m_innerStride; + const internal::variable_if_dynamic m_outerStride; +}; + +template +struct evaluator > + : public mapbase_evaluator, PlainObjectType> +{ + typedef Map XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? int(PlainObjectType::OuterStrideAtCompileTime) + : int(StrideType::OuterStrideAtCompileTime), + HasNoInnerStride = InnerStrideAtCompileTime == 1, + HasNoOuterStride = StrideType::OuterStrideAtCompileTime == 0, + HasNoStride = HasNoInnerStride && HasNoOuterStride, + IsDynamicSize = PlainObjectType::SizeAtCompileTime==Dynamic, + + PacketAccessMask = bool(HasNoInnerStride) ? ~int(0) : ~int(PacketAccessBit), + LinearAccessMask = bool(HasNoStride) || bool(PlainObjectType::IsVectorAtCompileTime) ? ~int(0) : ~int(LinearAccessBit), + Flags = int( evaluator::Flags) & (LinearAccessMask&PacketAccessMask), + + Alignment = int(MapOptions)&int(AlignedMask) + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& map) + : mapbase_evaluator(map) + { } +}; + +// -------------------- Ref -------------------- + +template +struct evaluator > + : public mapbase_evaluator, PlainObjectType> +{ + typedef Ref XprType; + + enum { + Flags = evaluator >::Flags, + Alignment = evaluator >::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& ref) + : mapbase_evaluator(ref) + { } +}; + +// -------------------- Block -------------------- + +template::ret> struct block_evaluator; + +template +struct evaluator > + : block_evaluator +{ + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types once we can handle multi-sized packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime, + + ArgTypeIsRowMajor = (int(evaluator::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1) ? 0 + : ArgTypeIsRowMajor, + HasSameStorageOrderAsArgType = (IsRowMajor == ArgTypeIsRowMajor), + InnerSize = IsRowMajor ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsArgType + ? int(inner_stride_at_compile_time::ret) + : int(outer_stride_at_compile_time::ret), + OuterStrideAtCompileTime = HasSameStorageOrderAsArgType + ? int(outer_stride_at_compile_time::ret) + : int(inner_stride_at_compile_time::ret), + MaskPacketAccessBit = (InnerStrideAtCompileTime == 1 || HasSameStorageOrderAsArgType) ? PacketAccessBit : 0, + + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1 || (InnerPanel && (evaluator::Flags&LinearAccessBit))) ? LinearAccessBit : 0, + FlagsRowMajorBit = XprType::Flags&RowMajorBit, + Flags0 = evaluator::Flags & ( (HereditaryBits & ~RowMajorBit) | + DirectAccessBit | + MaskPacketAccessBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment0 = (InnerPanel && (OuterStrideAtCompileTime!=Dynamic) + && (OuterStrideAtCompileTime!=0) + && (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % int(PacketAlignment)) == 0)) ? int(PacketAlignment) : 0, + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, Alignment0) + }; + typedef block_evaluator block_evaluator_type; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& block) : block_evaluator_type(block) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +// no direct-access => dispatch to a unary evaluator +template +struct block_evaluator + : unary_evaluator > +{ + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit block_evaluator(const XprType& block) + : unary_evaluator(block) + {} +}; + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef Block XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& block) + : m_argImpl(block.nestedExpression()), + m_startRow(block.startRow()), + m_startCol(block.startCol()), + m_linear_offset(ForwardLinearAccess?(ArgType::IsRowMajor ? block.startRow()*block.nestedExpression().cols() + block.startCol() : block.startCol()*block.nestedExpression().rows() + block.startRow()):0) + { } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + RowsAtCompileTime = XprType::RowsAtCompileTime, + ForwardLinearAccess = (InnerPanel || int(XprType::IsRowMajor)==int(ArgType::IsRowMajor)) && bool(evaluator::Flags&LinearAccessBit) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return linear_coeff_impl(index, bool_constant()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(m_startRow.value() + row, m_startCol.value() + col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return linear_coeffRef_impl(index, bool_constant()); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(m_startRow.value() + row, m_startCol.value() + col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + if (ForwardLinearAccess) + return m_argImpl.template packet(m_linear_offset.value() + index); + else + return packet(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + return m_argImpl.template writePacket(m_startRow.value() + row, m_startCol.value() + col, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + if (ForwardLinearAccess) + return m_argImpl.template writePacket(m_linear_offset.value() + index, x); + else + return writePacket(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0, + x); + } + +protected: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType linear_coeff_impl(Index index, internal::true_type /* ForwardLinearAccess */) const + { + return m_argImpl.coeff(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType linear_coeff_impl(Index index, internal::false_type /* not ForwardLinearAccess */) const + { + return coeff(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& linear_coeffRef_impl(Index index, internal::true_type /* ForwardLinearAccess */) + { + return m_argImpl.coeffRef(m_linear_offset.value() + index); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& linear_coeffRef_impl(Index index, internal::false_type /* not ForwardLinearAccess */) + { + return coeffRef(RowsAtCompileTime == 1 ? 0 : index, RowsAtCompileTime == 1 ? index : 0); + } + + evaluator m_argImpl; + const variable_if_dynamic m_startRow; + const variable_if_dynamic m_startCol; + const variable_if_dynamic m_linear_offset; +}; + +// TODO: This evaluator does not actually use the child evaluator; +// all action is via the data() as returned by the Block expression. + +template +struct block_evaluator + : mapbase_evaluator, + typename Block::PlainObject> +{ + typedef Block XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit block_evaluator(const XprType& block) + : mapbase_evaluator(block) + { + // TODO: for the 3.3 release, this should be turned to an internal assertion, but let's keep it as is for the beta lifetime + eigen_assert(((internal::UIntPtr(block.data()) % EIGEN_PLAIN_ENUM_MAX(1,evaluator::Alignment)) == 0) && "data is not aligned"); + } +}; + + +// -------------------- Select -------------------- +// NOTE shall we introduce a ternary_evaluator? + +// TODO enable vectorization for Select +template +struct evaluator > + : evaluator_base > +{ + typedef Select XprType; + enum { + CoeffReadCost = evaluator::CoeffReadCost + + EIGEN_PLAIN_ENUM_MAX(evaluator::CoeffReadCost, + evaluator::CoeffReadCost), + + Flags = (unsigned int)evaluator::Flags & evaluator::Flags & HereditaryBits, + + Alignment = EIGEN_PLAIN_ENUM_MIN(evaluator::Alignment, evaluator::Alignment) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& select) + : m_conditionImpl(select.conditionMatrix()), + m_thenImpl(select.thenMatrix()), + m_elseImpl(select.elseMatrix()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + if (m_conditionImpl.coeff(row, col)) + return m_thenImpl.coeff(row, col); + else + return m_elseImpl.coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + if (m_conditionImpl.coeff(index)) + return m_thenImpl.coeff(index); + else + return m_elseImpl.coeff(index); + } + +protected: + evaluator m_conditionImpl; + evaluator m_thenImpl; + evaluator m_elseImpl; +}; + + +// -------------------- Replicate -------------------- + +template +struct unary_evaluator > + : evaluator_base > +{ + typedef Replicate XprType; + typedef typename XprType::CoeffReturnType CoeffReturnType; + enum { + Factor = (RowFactor==Dynamic || ColFactor==Dynamic) ? Dynamic : RowFactor*ColFactor + }; + typedef typename internal::nested_eval::type ArgTypeNested; + typedef typename internal::remove_all::type ArgTypeNestedCleaned; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + LinearAccessMask = XprType::IsVectorAtCompileTime ? LinearAccessBit : 0, + Flags = (evaluator::Flags & (HereditaryBits|LinearAccessMask) & ~RowMajorBit) | (traits::Flags & RowMajorBit), + + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& replicate) + : m_arg(replicate.nestedExpression()), + m_argImpl(m_arg), + m_rows(replicate.nestedExpression().rows()), + m_cols(replicate.nestedExpression().cols()) + {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_row = internal::traits::RowsAtCompileTime==1 ? 0 + : RowFactor==1 ? row + : row % m_rows.value(); + const Index actual_col = internal::traits::ColsAtCompileTime==1 ? 0 + : ColFactor==1 ? col + : col % m_cols.value(); + + return m_argImpl.coeff(actual_row, actual_col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + // try to avoid using modulo; this is a pure optimization strategy + const Index actual_index = internal::traits::RowsAtCompileTime==1 + ? (ColFactor==1 ? index : index%m_cols.value()) + : (RowFactor==1 ? index : index%m_rows.value()); + + return m_argImpl.coeff(actual_index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + const Index actual_row = internal::traits::RowsAtCompileTime==1 ? 0 + : RowFactor==1 ? row + : row % m_rows.value(); + const Index actual_col = internal::traits::ColsAtCompileTime==1 ? 0 + : ColFactor==1 ? col + : col % m_cols.value(); + + return m_argImpl.template packet(actual_row, actual_col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + const Index actual_index = internal::traits::RowsAtCompileTime==1 + ? (ColFactor==1 ? index : index%m_cols.value()) + : (RowFactor==1 ? index : index%m_rows.value()); + + return m_argImpl.template packet(actual_index); + } + +protected: + const ArgTypeNested m_arg; + evaluator m_argImpl; + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + +// -------------------- MatrixWrapper and ArrayWrapper -------------------- +// +// evaluator_wrapper_base is a common base class for the +// MatrixWrapper and ArrayWrapper evaluators. + +template +struct evaluator_wrapper_base + : evaluator_base +{ + typedef typename remove_all::type ArgType; + enum { + CoeffReadCost = evaluator::CoeffReadCost, + Flags = evaluator::Flags, + Alignment = evaluator::Alignment + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator_wrapper_base(const ArgType& arg) : m_argImpl(arg) {} + + typedef typename ArgType::Scalar Scalar; + typedef typename ArgType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + return m_argImpl.template packet(row, col); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + return m_argImpl.template packet(index); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + m_argImpl.template writePacket(row, col, x); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + m_argImpl.template writePacket(index, x); + } + +protected: + evaluator m_argImpl; +}; + +template +struct unary_evaluator > + : evaluator_wrapper_base > +{ + typedef MatrixWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base >(wrapper.nestedExpression()) + { } +}; + +template +struct unary_evaluator > + : evaluator_wrapper_base > +{ + typedef ArrayWrapper XprType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& wrapper) + : evaluator_wrapper_base >(wrapper.nestedExpression()) + { } +}; + + +// -------------------- Reverse -------------------- + +// defined in Reverse.h: +template struct reverse_packet_cond; + +template +struct unary_evaluator > + : evaluator_base > +{ + typedef Reverse XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + enum { + IsRowMajor = XprType::IsRowMajor, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + ReversePacket = (Direction == BothDirections) + || ((Direction == Vertical) && IsColMajor) + || ((Direction == Horizontal) && IsRowMajor), + + CoeffReadCost = evaluator::CoeffReadCost, + + // let's enable LinearAccess only with vectorization because of the product overhead + // FIXME enable DirectAccess with negative strides? + Flags0 = evaluator::Flags, + LinearAccess = ( (Direction==BothDirections) && (int(Flags0)&PacketAccessBit) ) + || ((ReverseRow && XprType::ColsAtCompileTime==1) || (ReverseCol && XprType::RowsAtCompileTime==1)) + ? LinearAccessBit : 0, + + Flags = int(Flags0) & (HereditaryBits | PacketAccessBit | LinearAccess), + + Alignment = 0 // FIXME in some rare cases, Alignment could be preserved, like a Vector4f. + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit unary_evaluator(const XprType& reverse) + : m_argImpl(reverse.nestedExpression()), + m_rows(ReverseRow ? reverse.nestedExpression().rows() : 1), + m_cols(ReverseCol ? reverse.nestedExpression().cols() : 1) + { } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(ReverseRow ? m_rows.value() - row - 1 : row, + ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(m_rows.value() * m_cols.value() - index - 1); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(ReverseRow ? m_rows.value() - row - 1 : row, + ReverseCol ? m_cols.value() - col - 1 : col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(m_rows.value() * m_cols.value() - index - 1); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index row, Index col) const + { + enum { + PacketSize = unpacket_traits::size, + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1 + }; + typedef internal::reverse_packet_cond reverse_packet; + return reverse_packet::run(m_argImpl.template packet( + ReverseRow ? m_rows.value() - row - OffsetRow : row, + ReverseCol ? m_cols.value() - col - OffsetCol : col)); + } + + template + EIGEN_STRONG_INLINE + PacketType packet(Index index) const + { + enum { PacketSize = unpacket_traits::size }; + return preverse(m_argImpl.template packet(m_rows.value() * m_cols.value() - index - PacketSize)); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index row, Index col, const PacketType& x) + { + // FIXME we could factorize some code with packet(i,j) + enum { + PacketSize = unpacket_traits::size, + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1 + }; + typedef internal::reverse_packet_cond reverse_packet; + m_argImpl.template writePacket( + ReverseRow ? m_rows.value() - row - OffsetRow : row, + ReverseCol ? m_cols.value() - col - OffsetCol : col, + reverse_packet::run(x)); + } + + template + EIGEN_STRONG_INLINE + void writePacket(Index index, const PacketType& x) + { + enum { PacketSize = unpacket_traits::size }; + m_argImpl.template writePacket + (m_rows.value() * m_cols.value() - index - PacketSize, preverse(x)); + } + +protected: + evaluator m_argImpl; + + // If we do not reverse rows, then we do not need to know the number of rows; same for columns + // Nonetheless, in this case it is important to set to 1 such that the coeff(index) method works fine for vectors. + const variable_if_dynamic m_rows; + const variable_if_dynamic m_cols; +}; + + +// -------------------- Diagonal -------------------- + +template +struct evaluator > + : evaluator_base > +{ + typedef Diagonal XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + + Flags = (unsigned int)(evaluator::Flags & (HereditaryBits | DirectAccessBit) & ~RowMajorBit) | LinearAccessBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit evaluator(const XprType& diagonal) + : m_argImpl(diagonal.nestedExpression()), + m_index(diagonal.index()) + { } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index) const + { + return m_argImpl.coeff(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index index) const + { + return m_argImpl.coeff(index + rowOffset(), index + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index) + { + return m_argImpl.coeffRef(row + rowOffset(), row + colOffset()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + return m_argImpl.coeffRef(index + rowOffset(), index + colOffset()); + } + +protected: + evaluator m_argImpl; + const internal::variable_if_dynamicindex m_index; + +private: + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowOffset() const { return m_index.value() > 0 ? 0 : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colOffset() const { return m_index.value() > 0 ? m_index.value() : 0; } +}; + + +//---------------------------------------------------------------------- +// deprecated code +//---------------------------------------------------------------------- + +// -------------------- EvalToTemp -------------------- + +// expression class for evaluating nested expression to a temporary + +template class EvalToTemp; + +template +struct traits > + : public traits +{ }; + +template +class EvalToTemp + : public dense_xpr_base >::type +{ + public: + + typedef typename dense_xpr_base::type Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(EvalToTemp) + + explicit EvalToTemp(const ArgType& arg) + : m_arg(arg) + { } + + const ArgType& arg() const + { + return m_arg; + } + + EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT + { + return m_arg.rows(); + } + + EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT + { + return m_arg.cols(); + } + + private: + const ArgType& m_arg; +}; + +template +struct evaluator > + : public evaluator +{ + typedef EvalToTemp XprType; + typedef typename ArgType::PlainObject PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) + : m_result(xpr.arg()) + { + ::new (static_cast(this)) Base(m_result); + } + + // This constructor is used when nesting an EvalTo evaluator in another evaluator + EIGEN_DEVICE_FUNC evaluator(const ArgType& arg) + : m_result(arg) + { + ::new (static_cast(this)) Base(m_result); + } + +protected: + PlainObject m_result; +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREEVALUATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h b/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h new file mode 100644 index 0000000..b967196 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CoreIterators.h @@ -0,0 +1,132 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_COREITERATORS_H +#define EIGEN_COREITERATORS_H + +namespace Eigen { + +/* This file contains the respective InnerIterator definition of the expressions defined in Eigen/Core + */ + +namespace internal { + +template +class inner_iterator_selector; + +} + +/** \class InnerIterator + * \brief An InnerIterator allows to loop over the element of any matrix expression. + * + * \warning To be used with care because an evaluator is constructed every time an InnerIterator iterator is constructed. + * + * TODO: add a usage example + */ +template +class InnerIterator +{ +protected: + typedef internal::inner_iterator_selector::Kind> IteratorType; + typedef internal::evaluator EvaluatorType; + typedef typename internal::traits::Scalar Scalar; +public: + /** Construct an iterator over the \a outerId -th row or column of \a xpr */ + InnerIterator(const XprType &xpr, const Index &outerId) + : m_eval(xpr), m_iter(m_eval, outerId, xpr.innerSize()) + {} + + /// \returns the value of the current coefficient. + EIGEN_STRONG_INLINE Scalar value() const { return m_iter.value(); } + /** Increment the iterator \c *this to the next non-zero coefficient. + * Explicit zeros are not skipped over. To skip explicit zeros, see class SparseView + */ + EIGEN_STRONG_INLINE InnerIterator& operator++() { m_iter.operator++(); return *this; } + EIGEN_STRONG_INLINE InnerIterator& operator+=(Index i) { m_iter.operator+=(i); return *this; } + EIGEN_STRONG_INLINE InnerIterator operator+(Index i) + { InnerIterator result(*this); result+=i; return result; } + + + /// \returns the column or row index of the current coefficient. + EIGEN_STRONG_INLINE Index index() const { return m_iter.index(); } + /// \returns the row index of the current coefficient. + EIGEN_STRONG_INLINE Index row() const { return m_iter.row(); } + /// \returns the column index of the current coefficient. + EIGEN_STRONG_INLINE Index col() const { return m_iter.col(); } + /// \returns \c true if the iterator \c *this still references a valid coefficient. + EIGEN_STRONG_INLINE operator bool() const { return m_iter; } + +protected: + EvaluatorType m_eval; + IteratorType m_iter; +private: + // If you get here, then you're not using the right InnerIterator type, e.g.: + // SparseMatrix A; + // SparseMatrix::InnerIterator it(A,0); + template InnerIterator(const EigenBase&,Index outer); +}; + +namespace internal { + +// Generic inner iterator implementation for dense objects +template +class inner_iterator_selector +{ +protected: + typedef evaluator EvaluatorType; + typedef typename traits::Scalar Scalar; + enum { IsRowMajor = (XprType::Flags&RowMajorBit)==RowMajorBit }; + +public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, const Index &innerSize) + : m_eval(eval), m_inner(0), m_outer(outerId), m_end(innerSize) + {} + + EIGEN_STRONG_INLINE Scalar value() const + { + return (IsRowMajor) ? m_eval.coeff(m_outer, m_inner) + : m_eval.coeff(m_inner, m_outer); + } + + EIGEN_STRONG_INLINE inner_iterator_selector& operator++() { m_inner++; return *this; } + + EIGEN_STRONG_INLINE Index index() const { return m_inner; } + inline Index row() const { return IsRowMajor ? m_outer : index(); } + inline Index col() const { return IsRowMajor ? index() : m_outer; } + + EIGEN_STRONG_INLINE operator bool() const { return m_inner < m_end && m_inner>=0; } + +protected: + const EvaluatorType& m_eval; + Index m_inner; + const Index m_outer; + const Index m_end; +}; + +// For iterator-based evaluator, inner-iterator is already implemented as +// evaluator<>::InnerIterator +template +class inner_iterator_selector + : public evaluator::InnerIterator +{ +protected: + typedef typename evaluator::InnerIterator Base; + typedef evaluator EvaluatorType; + +public: + EIGEN_STRONG_INLINE inner_iterator_selector(const EvaluatorType &eval, const Index &outerId, const Index &/*innerSize*/) + : Base(eval, outerId) + {} +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_COREITERATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h new file mode 100644 index 0000000..2202b1c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseBinaryOp.h @@ -0,0 +1,183 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_BINARY_OP_H +#define EIGEN_CWISE_BINARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > +{ + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef typename remove_all::type Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Lhs and Rhs to have the same scalar type (see CwiseBinaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of< + BinaryOp( + const typename Lhs::Scalar&, + const typename Rhs::Scalar& + ) + >::type Scalar; + typedef typename cwise_promote_storage_type::StorageKind, + typename traits::StorageKind, + BinaryOp>::ret StorageKind; + typedef typename promote_index_type::StorageIndex, + typename traits::StorageIndex>::type StorageIndex; + typedef typename Lhs::Nested LhsNested; + typedef typename Rhs::Nested RhsNested; + typedef typename remove_reference::type _LhsNested; + typedef typename remove_reference::type _RhsNested; + enum { + Flags = cwise_promote_storage_order::StorageKind,typename traits::StorageKind,_LhsNested::Flags & RowMajorBit,_RhsNested::Flags & RowMajorBit>::value + }; +}; +} // end namespace internal + +template +class CwiseBinaryOpImpl; + +/** \class CwiseBinaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise binary operator is applied to two expressions + * + * \tparam BinaryOp template functor implementing the operator + * \tparam LhsType the type of the left-hand side + * \tparam RhsType the type of the right-hand side + * + * This class represents an expression where a coefficient-wise binary operator is applied to two expressions. + * It is the return type of binary operators, by which we mean only those binary operators where + * both the left-hand side and the right-hand side are Eigen expressions. + * For example, the return type of matrix1+matrix2 is a CwiseBinaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseBinaryOp types explicitly. + * + * \sa MatrixBase::binaryExpr(const MatrixBase &,const CustomBinaryOp &) const, class CwiseUnaryOp, class CwiseNullaryOp + */ +template +class CwiseBinaryOp : + public CwiseBinaryOpImpl< + BinaryOp, LhsType, RhsType, + typename internal::cwise_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + BinaryOp>::ret>, + internal::no_assignment_operator +{ + public: + + typedef typename internal::remove_all::type Functor; + typedef typename internal::remove_all::type Lhs; + typedef typename internal::remove_all::type Rhs; + + typedef typename CwiseBinaryOpImpl< + BinaryOp, LhsType, RhsType, + typename internal::cwise_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + BinaryOp>::ret>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseBinaryOp) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef typename internal::remove_reference::type _LhsNested; + typedef typename internal::remove_reference::type _RhsNested; + +#if EIGEN_COMP_MSVC && EIGEN_HAS_CXX11 + //Required for Visual Studio or the Copy constructor will probably not get inlined! + EIGEN_STRONG_INLINE + CwiseBinaryOp(const CwiseBinaryOp&) = default; +#endif + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CwiseBinaryOp(const Lhs& aLhs, const Rhs& aRhs, const BinaryOp& func = BinaryOp()) + : m_lhs(aLhs), m_rhs(aRhs), m_functor(func) + { + EIGEN_CHECK_BINARY_COMPATIBILIY(BinaryOp,typename Lhs::Scalar,typename Rhs::Scalar); + // require the sizes to match + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Lhs, Rhs) + eigen_assert(aLhs.rows() == aRhs.rows() && aLhs.cols() == aRhs.cols()); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { + // return the fixed size type if available to enable compile time optimizations + return internal::traits::type>::RowsAtCompileTime==Dynamic ? m_rhs.rows() : m_lhs.rows(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { + // return the fixed size type if available to enable compile time optimizations + return internal::traits::type>::ColsAtCompileTime==Dynamic ? m_rhs.cols() : m_lhs.cols(); + } + + /** \returns the left hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const _LhsNested& lhs() const { return m_lhs; } + /** \returns the right hand side nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const _RhsNested& rhs() const { return m_rhs; } + /** \returns the functor representing the binary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const BinaryOp& functor() const { return m_functor; } + + protected: + LhsNested m_lhs; + RhsNested m_rhs; + const BinaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseBinaryOpImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +/** replaces \c *this by \c *this - \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +MatrixBase::operator-=(const MatrixBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +/** replaces \c *this by \c *this + \a other. + * + * \returns a reference to \c *this + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived & +MatrixBase::operator+=(const MatrixBase& other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_CWISE_BINARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h new file mode 100644 index 0000000..289ec51 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseNullaryOp.h @@ -0,0 +1,1001 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_NULLARY_OP_H +#define EIGEN_CWISE_NULLARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > : traits +{ + enum { + Flags = traits::Flags & RowMajorBit + }; +}; + +} // namespace internal + +/** \class CwiseNullaryOp + * \ingroup Core_Module + * + * \brief Generic expression of a matrix where all coefficients are defined by a functor + * + * \tparam NullaryOp template functor implementing the operator + * \tparam PlainObjectType the underlying plain matrix/array type + * + * This class represents an expression of a generic nullary operator. + * It is the return type of the Ones(), Zero(), Constant(), Identity() and Random() methods, + * and most of the time this is the only way it is used. + * + * However, if you want to write a function returning such an expression, you + * will need to use this class. + * + * The functor NullaryOp must expose one of the following method: + + + + +
\c operator()() if the procedural generation does not depend on the coefficient entries (e.g., random numbers)
\c operator()(Index i)if the procedural generation makes sense for vectors only and that it depends on the coefficient index \c i (e.g., linspace)
\c operator()(Index i,Index j)if the procedural generation depends on the matrix coordinates \c i, \c j (e.g., to generate a checkerboard with 0 and 1)
+ * It is also possible to expose the last two operators if the generation makes sense for matrices but can be optimized for vectors. + * + * See DenseBase::NullaryExpr(Index,const CustomNullaryOp&) for an example binding + * C++11 random number generators. + * + * A nullary expression can also be used to implement custom sophisticated matrix manipulations + * that cannot be covered by the existing set of natively supported matrix manipulations. + * See this \ref TopicCustomizing_NullaryExpr "page" for some examples and additional explanations + * on the behavior of CwiseNullaryOp. + * + * \sa class CwiseUnaryOp, class CwiseBinaryOp, DenseBase::NullaryExpr + */ +template +class CwiseNullaryOp : public internal::dense_xpr_base< CwiseNullaryOp >::type, internal::no_assignment_operator +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(CwiseNullaryOp) + + EIGEN_DEVICE_FUNC + CwiseNullaryOp(Index rows, Index cols, const NullaryOp& func = NullaryOp()) + : m_rows(rows), m_cols(cols), m_functor(func) + { + eigen_assert(rows >= 0 + && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) + && cols >= 0 + && (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols)); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const { return m_rows.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const { return m_cols.value(); } + + /** \returns the functor representing the nullary operation */ + EIGEN_DEVICE_FUNC + const NullaryOp& functor() const { return m_functor; } + + protected: + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; + const NullaryOp m_functor; +}; + + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(Index rows, Index cols, const CustomNullaryOp& func) +{ + return CwiseNullaryOp(rows, cols, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * Here is an example with C++11 random generators: \include random_cpp11.cpp + * Output: \verbinclude random_cpp11.out + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(Index size, const CustomNullaryOp& func) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + if(RowsAtCompileTime == 1) return CwiseNullaryOp(1, size, func); + else return CwiseNullaryOp(size, 1, func); +} + +/** \returns an expression of a matrix defined by a custom functor \a func + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +#ifndef EIGEN_PARSED_BY_DOXYGEN +const CwiseNullaryOp::PlainObject> +#else +const CwiseNullaryOp +#endif +DenseBase::NullaryExpr(const CustomNullaryOp& func) +{ + return CwiseNullaryOp(RowsAtCompileTime, ColsAtCompileTime, func); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this DenseBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index rows, Index cols, const Scalar& value) +{ + return DenseBase::NullaryExpr(rows, cols, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this DenseBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(Index size, const Scalar& value) +{ + return DenseBase::NullaryExpr(size, internal::scalar_constant_op(value)); +} + +/** \returns an expression of a constant matrix of value \a value + * + * This variant is only for fixed-size DenseBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * The template parameter \a CustomNullaryOp is the type of the functor. + * + * \sa class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Constant(const Scalar& value) +{ + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_constant_op(value)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(Index,const Scalar&,const Scalar&) + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced_seq_deprecated.cpp + * Output: \verbinclude DenseBase_LinSpaced_seq_deprecated.out + * + * \sa LinSpaced(Index,const Scalar&, const Scalar&), setLinSpaced(Index,const Scalar&,const Scalar&) + */ +template +EIGEN_DEPRECATED EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, Index size, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low,high,size)); +} + +/** \deprecated because of accuracy loss. In Eigen 3.3, it is an alias for LinSpaced(const Scalar&,const Scalar&) + * + * \sa LinSpaced(const Scalar&, const Scalar&) + */ +template +EIGEN_DEPRECATED EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Sequential_t, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, internal::linspaced_op(low,high,Derived::SizeAtCompileTime)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_LinSpaced.cpp + * Output: \verbinclude DenseBase_LinSpaced.out + * + * For integer scalar types, an even spacing is possible if and only if the length of the range, + * i.e., \c high-low is a scalar multiple of \c size-1, or if \c size is a scalar multiple of the + * number of values \c high-low+1 (meaning each value can be repeated the same number of time). + * If one of these two considions is not satisfied, then \c high is lowered to the largest value + * satisfying one of this constraint. + * Here are some examples: + * + * Example: \include DenseBase_LinSpacedInt.cpp + * Output: \verbinclude DenseBase_LinSpacedInt.out + * + * \sa setLinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(Index size, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return DenseBase::NullaryExpr(size, internal::linspaced_op(low,high,size)); +} + +/** + * \copydoc DenseBase::LinSpaced(Index, const Scalar&, const Scalar&) + * Special version for fixed size types which does not require the size parameter. + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::RandomAccessLinSpacedReturnType +DenseBase::LinSpaced(const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return DenseBase::NullaryExpr(Derived::SizeAtCompileTime, internal::linspaced_op(low,high,Derived::SizeAtCompileTime)); +} + +/** \returns true if all coefficients in this matrix are approximately equal to \a val, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isApproxToConstant +(const Scalar& val, const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if(!internal::isApprox(self.coeff(i, j), val, prec)) + return false; + return true; +} + +/** This is just an alias for isApproxToConstant(). + * + * \returns true if all coefficients in this matrix are approximately equal to \a value, to within precision \a prec */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isConstant +(const Scalar& val, const RealScalar& prec) const +{ + return isApproxToConstant(val, prec); +} + +/** Alias for setConstant(): sets all coefficients in this expression to \a val. + * + * \sa setConstant(), Constant(), class CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void DenseBase::fill(const Scalar& val) +{ + setConstant(val); +} + +/** Sets all coefficients in this expression to value \a val. + * + * \sa fill(), setConstant(Index,const Scalar&), setConstant(Index,Index,const Scalar&), setZero(), setOnes(), Constant(), class CwiseNullaryOp, setZero(), setOnes() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setConstant(const Scalar& val) +{ + return derived() = Constant(rows(), cols(), val); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to the given value \a val. + * + * \only_for_vectors + * + * Example: \include Matrix_setConstant_int.cpp + * Output: \verbinclude Matrix_setConstant_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index size, const Scalar& val) +{ + resize(size); + return setConstant(val); +} + +/** Resizes to the given size, and sets all coefficients in this expression to the given value \a val. + * + * \param rows the new number of rows + * \param cols the new number of columns + * \param val the value to which all coefficients are set + * + * Example: \include Matrix_setConstant_int_int.cpp + * Output: \verbinclude Matrix_setConstant_int_int.out + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index rows, Index cols, const Scalar& val) +{ + resize(rows, cols); + return setConstant(val); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(NoChange_t, Index cols, const Scalar& val) +{ + return setConstant(rows(), cols, val); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to the given value \a val. For the parameter + * of type NoChange_t, just pass the special value \c NoChange. + * + * \sa MatrixBase::setConstant(const Scalar&), setConstant(Index,const Scalar&), class CwiseNullaryOp, MatrixBase::Constant(const Scalar&) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setConstant(Index rows, NoChange_t, const Scalar& val) +{ + return setConstant(rows, cols(), val); +} + + +/** + * \brief Sets a linearly spaced vector. + * + * The function generates 'size' equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * Example: \include DenseBase_setLinSpaced.cpp + * Output: \verbinclude DenseBase_setLinSpaced.out + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(Index newSize, const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return derived() = Derived::NullaryExpr(newSize, internal::linspaced_op(low,high,newSize)); +} + +/** + * \brief Sets a linearly spaced vector. + * + * The function fills \c *this with equally spaced values in the closed interval [low,high]. + * When size is set to 1, a vector of length 1 containing 'high' is returned. + * + * \only_for_vectors + * + * For integer scalar types, do not miss the explanations on the definition + * of \link LinSpaced(Index,const Scalar&,const Scalar&) even spacing \endlink. + * + * \sa LinSpaced(Index,const Scalar&,const Scalar&), setLinSpaced(Index, const Scalar&, const Scalar&), CwiseNullaryOp + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setLinSpaced(const Scalar& low, const Scalar& high) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return setLinSpaced(size(), low, high); +} + +// zero: + +/** \returns an expression of a zero matrix. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int_int.cpp + * Output: \verbinclude MatrixBase_zero_int_int.out + * + * \sa Zero(), Zero(Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero(Index rows, Index cols) +{ + return Constant(rows, cols, Scalar(0)); +} + +/** \returns an expression of a zero vector. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Zero() should be used + * instead. + * + * Example: \include MatrixBase_zero_int.cpp + * Output: \verbinclude MatrixBase_zero_int.out + * + * \sa Zero(), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero(Index size) +{ + return Constant(size, Scalar(0)); +} + +/** \returns an expression of a fixed-size zero matrix or vector. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_zero.cpp + * Output: \verbinclude MatrixBase_zero.out + * + * \sa Zero(Index), Zero(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Zero() +{ + return Constant(Scalar(0)); +} + +/** \returns true if *this is approximately equal to the zero matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isZero.cpp + * Output: \verbinclude MatrixBase_isZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isZero(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < rows(); ++i) + if(!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) + return false; + return true; +} + +/** Sets all coefficients in this expression to zero. + * + * Example: \include MatrixBase_setZero.cpp + * Output: \verbinclude MatrixBase_setZero.out + * + * \sa class CwiseNullaryOp, Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setZero() +{ + return setConstant(Scalar(0)); +} + +/** Resizes to the given \a size, and sets all coefficients in this expression to zero. + * + * \only_for_vectors + * + * Example: \include Matrix_setZero_int.cpp + * Output: \verbinclude Matrix_setZero_int.out + * + * \sa DenseBase::setZero(), setZero(Index,Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index newSize) +{ + resize(newSize); + return setConstant(Scalar(0)); +} + +/** Resizes to the given size, and sets all coefficients in this expression to zero. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setZero_int_int.cpp + * Output: \verbinclude Matrix_setZero_int_int.out + * + * \sa DenseBase::setZero(), setZero(Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index rows, Index cols) +{ + resize(rows, cols); + return setConstant(Scalar(0)); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(Index, NoChange_t), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(NoChange_t, Index cols) +{ + return setZero(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to zero. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa DenseBase::setZero(), setZero(Index), setZero(Index, Index), setZero(NoChange_t, Index), class CwiseNullaryOp, DenseBase::Zero() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setZero(Index rows, NoChange_t) +{ + return setZero(rows, cols()); +} + +// ones: + +/** \returns an expression of a matrix where all coefficients equal one. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int_int.cpp + * Output: \verbinclude MatrixBase_ones_int_int.out + * + * \sa Ones(), Ones(Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones(Index rows, Index cols) +{ + return Constant(rows, cols, Scalar(1)); +} + +/** \returns an expression of a vector where all coefficients equal one. + * + * The parameter \a newSize is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Ones() should be used + * instead. + * + * Example: \include MatrixBase_ones_int.cpp + * Output: \verbinclude MatrixBase_ones_int.out + * + * \sa Ones(), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones(Index newSize) +{ + return Constant(newSize, Scalar(1)); +} + +/** \returns an expression of a fixed-size matrix or vector where all coefficients equal one. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_ones.cpp + * Output: \verbinclude MatrixBase_ones.out + * + * \sa Ones(Index), Ones(Index,Index), isOnes(), class Ones + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename DenseBase::ConstantReturnType +DenseBase::Ones() +{ + return Constant(Scalar(1)); +} + +/** \returns true if *this is approximately equal to the matrix where all coefficients + * are equal to 1, within the precision given by \a prec. + * + * Example: \include MatrixBase_isOnes.cpp + * Output: \verbinclude MatrixBase_isOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isOnes +(const RealScalar& prec) const +{ + return isApproxToConstant(Scalar(1), prec); +} + +/** Sets all coefficients in this expression to one. + * + * Example: \include MatrixBase_setOnes.cpp + * Output: \verbinclude MatrixBase_setOnes.out + * + * \sa class CwiseNullaryOp, Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& DenseBase::setOnes() +{ + return setConstant(Scalar(1)); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to one. + * + * \only_for_vectors + * + * Example: \include Matrix_setOnes_int.cpp + * Output: \verbinclude Matrix_setOnes_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index,Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index newSize) +{ + resize(newSize); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, and sets all coefficients in this expression to one. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setOnes_int_int.cpp + * Output: \verbinclude Matrix_setOnes_int_int.out + * + * \sa MatrixBase::setOnes(), setOnes(Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index rows, Index cols) +{ + resize(rows, cols); + return setConstant(Scalar(1)); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(NoChange_t, Index), class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(Index rows, NoChange_t) +{ + return setOnes(rows, cols()); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to one. For the parameter of type NoChange_t, + * just pass the special value \c NoChange. + * + * \sa MatrixBase::setOnes(), setOnes(Index), setOnes(Index, Index), setOnes(Index, NoChange_t) class CwiseNullaryOp, MatrixBase::Ones() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setOnes(NoChange_t, Index cols) +{ + return setOnes(rows(), cols); +} + +// Identity: + +/** \returns an expression of the identity matrix (not necessarily square). + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Identity() should be used + * instead. + * + * Example: \include MatrixBase_identity_int_int.cpp + * Output: \verbinclude MatrixBase_identity_int_int.out + * + * \sa Identity(), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity(Index rows, Index cols) +{ + return DenseBase::NullaryExpr(rows, cols, internal::scalar_identity_op()); +} + +/** \returns an expression of the identity matrix (not necessarily square). + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variant taking size arguments. + * + * Example: \include MatrixBase_identity.cpp + * Output: \verbinclude MatrixBase_identity.out + * + * \sa Identity(Index,Index), setIdentity(), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::IdentityReturnType +MatrixBase::Identity() +{ + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + return MatrixBase::NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_identity_op()); +} + +/** \returns true if *this is approximately equal to the identity matrix + * (not necessarily square), + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isIdentity.cpp + * Output: \verbinclude MatrixBase_isIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), setIdentity() + */ +template +bool MatrixBase::isIdentity +(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index j = 0; j < cols(); ++j) + { + for(Index i = 0; i < rows(); ++i) + { + if(i == j) + { + if(!internal::isApprox(self.coeff(i, j), static_cast(1), prec)) + return false; + } + else + { + if(!internal::isMuchSmallerThan(self.coeff(i, j), static_cast(1), prec)) + return false; + } + } + } + return true; +} + +namespace internal { + +template=16)> +struct setIdentity_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Derived& run(Derived& m) + { + return m = Derived::Identity(m.rows(), m.cols()); + } +}; + +template +struct setIdentity_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Derived& run(Derived& m) + { + m.setZero(); + const Index size = numext::mini(m.rows(), m.cols()); + for(Index i = 0; i < size; ++i) m.coeffRef(i,i) = typename Derived::Scalar(1); + return m; + } +}; + +} // end namespace internal + +/** Writes the identity expression (not necessarily square) into *this. + * + * Example: \include MatrixBase_setIdentity.cpp + * Output: \verbinclude MatrixBase_setIdentity.out + * + * \sa class CwiseNullaryOp, Identity(), Identity(Index,Index), isIdentity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity() +{ + return internal::setIdentity_impl::run(derived()); +} + +/** \brief Resizes to the given size, and writes the identity expression (not necessarily square) into *this. + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setIdentity_int_int.cpp + * Output: \verbinclude Matrix_setIdentity_int_int.out + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Identity() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setIdentity(Index rows, Index cols) +{ + derived().resize(rows, cols); + return setIdentity(); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit(Index newSize, Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(newSize,newSize), i); +} + +/** \returns an expression of the i-th unit (basis) vector. + * + * \only_for_vectors + * + * This variant is for fixed-size vector only. + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::UnitX(), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::Unit(Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + return BasisReturnType(SquareMatrixType::Identity(),i); +} + +/** \returns an expression of the X axis unit vector (1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitX() +{ return Derived::Unit(0); } + +/** \returns an expression of the Y axis unit vector (0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitY() +{ return Derived::Unit(1); } + +/** \returns an expression of the Z axis unit vector (0,0,1{,0}^*) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitZ() +{ return Derived::Unit(2); } + +/** \returns an expression of the W axis unit vector (0,0,0,1) + * + * \only_for_vectors + * + * \sa MatrixBase::Unit(Index,Index), MatrixBase::Unit(Index), MatrixBase::UnitY(), MatrixBase::UnitZ(), MatrixBase::UnitW() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::BasisReturnType MatrixBase::UnitW() +{ return Derived::Unit(3); } + +/** \brief Set the coefficients of \c *this to the i-th unit (basis) vector + * + * \param i index of the unique coefficient to be set to 1 + * + * \only_for_vectors + * + * \sa MatrixBase::setIdentity(), class CwiseNullaryOp, MatrixBase::Unit(Index,Index) + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Derived& MatrixBase::setUnit(Index newSize, Index i) +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived); + eigen_assert(i +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2016 Eugene Brevdo +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_TERNARY_OP_H +#define EIGEN_CWISE_TERNARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > { + // we must not inherit from traits since it has + // the potential to cause problems with MSVC + typedef typename remove_all::type Ancestor; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = traits::RowsAtCompileTime, + ColsAtCompileTime = traits::ColsAtCompileTime, + MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = traits::MaxColsAtCompileTime + }; + + // even though we require Arg1, Arg2, and Arg3 to have the same scalar type + // (see CwiseTernaryOp constructor), + // we still want to handle the case when the result type is different. + typedef typename result_of::type Scalar; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + typedef typename Arg1::Nested Arg1Nested; + typedef typename Arg2::Nested Arg2Nested; + typedef typename Arg3::Nested Arg3Nested; + typedef typename remove_reference::type _Arg1Nested; + typedef typename remove_reference::type _Arg2Nested; + typedef typename remove_reference::type _Arg3Nested; + enum { Flags = _Arg1Nested::Flags & RowMajorBit }; +}; +} // end namespace internal + +template +class CwiseTernaryOpImpl; + +/** \class CwiseTernaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise ternary operator is + * applied to two expressions + * + * \tparam TernaryOp template functor implementing the operator + * \tparam Arg1Type the type of the first argument + * \tparam Arg2Type the type of the second argument + * \tparam Arg3Type the type of the third argument + * + * This class represents an expression where a coefficient-wise ternary + * operator is applied to three expressions. + * It is the return type of ternary operators, by which we mean only those + * ternary operators where + * all three arguments are Eigen expressions. + * For example, the return type of betainc(matrix1, matrix2, matrix3) is a + * CwiseTernaryOp. + * + * Most of the time, this is the only way that it is used, so you typically + * don't have to name + * CwiseTernaryOp types explicitly. + * + * \sa MatrixBase::ternaryExpr(const MatrixBase &, const + * MatrixBase &, const CustomTernaryOp &) const, class CwiseBinaryOp, + * class CwiseUnaryOp, class CwiseNullaryOp + */ +template +class CwiseTernaryOp : public CwiseTernaryOpImpl< + TernaryOp, Arg1Type, Arg2Type, Arg3Type, + typename internal::traits::StorageKind>, + internal::no_assignment_operator +{ + public: + typedef typename internal::remove_all::type Arg1; + typedef typename internal::remove_all::type Arg2; + typedef typename internal::remove_all::type Arg3; + + typedef typename CwiseTernaryOpImpl< + TernaryOp, Arg1Type, Arg2Type, Arg3Type, + typename internal::traits::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseTernaryOp) + + typedef typename internal::ref_selector::type Arg1Nested; + typedef typename internal::ref_selector::type Arg2Nested; + typedef typename internal::ref_selector::type Arg3Nested; + typedef typename internal::remove_reference::type _Arg1Nested; + typedef typename internal::remove_reference::type _Arg2Nested; + typedef typename internal::remove_reference::type _Arg3Nested; + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CwiseTernaryOp(const Arg1& a1, const Arg2& a2, + const Arg3& a3, + const TernaryOp& func = TernaryOp()) + : m_arg1(a1), m_arg2(a2), m_arg3(a3), m_functor(func) { + // require the sizes to match + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg2) + EIGEN_STATIC_ASSERT_SAME_MATRIX_SIZE(Arg1, Arg3) + + // The index types should match + EIGEN_STATIC_ASSERT((internal::is_same< + typename internal::traits::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + EIGEN_STATIC_ASSERT((internal::is_same< + typename internal::traits::StorageKind, + typename internal::traits::StorageKind>::value), + STORAGE_KIND_MUST_MATCH) + + eigen_assert(a1.rows() == a2.rows() && a1.cols() == a2.cols() && + a1.rows() == a3.rows() && a1.cols() == a3.cols()); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index rows() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits::type>:: + RowsAtCompileTime == Dynamic && + internal::traits::type>:: + RowsAtCompileTime == Dynamic) + return m_arg3.rows(); + else if (internal::traits::type>:: + RowsAtCompileTime == Dynamic && + internal::traits::type>:: + RowsAtCompileTime == Dynamic) + return m_arg2.rows(); + else + return m_arg1.rows(); + } + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index cols() const { + // return the fixed size type if available to enable compile time + // optimizations + if (internal::traits::type>:: + ColsAtCompileTime == Dynamic && + internal::traits::type>:: + ColsAtCompileTime == Dynamic) + return m_arg3.cols(); + else if (internal::traits::type>:: + ColsAtCompileTime == Dynamic && + internal::traits::type>:: + ColsAtCompileTime == Dynamic) + return m_arg2.cols(); + else + return m_arg1.cols(); + } + + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg1Nested& arg1() const { return m_arg1; } + /** \returns the first argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg2Nested& arg2() const { return m_arg2; } + /** \returns the third argument nested expression */ + EIGEN_DEVICE_FUNC + const _Arg3Nested& arg3() const { return m_arg3; } + /** \returns the functor representing the ternary operation */ + EIGEN_DEVICE_FUNC + const TernaryOp& functor() const { return m_functor; } + + protected: + Arg1Nested m_arg1; + Arg2Nested m_arg2; + Arg3Nested m_arg3; + const TernaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseTernaryOpImpl + : public internal::generic_xpr_base< + CwiseTernaryOp >::type { + public: + typedef typename internal::generic_xpr_base< + CwiseTernaryOp >::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_TERNARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h new file mode 100644 index 0000000..e68c4f7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryOp.h @@ -0,0 +1,103 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2014 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_OP_H +#define EIGEN_CWISE_UNARY_OP_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename result_of< + UnaryOp(const typename XprType::Scalar&) + >::type Scalar; + typedef typename XprType::Nested XprTypeNested; + typedef typename remove_reference::type _XprTypeNested; + enum { + Flags = _XprTypeNested::Flags & RowMajorBit + }; +}; +} + +template +class CwiseUnaryOpImpl; + +/** \class CwiseUnaryOp + * \ingroup Core_Module + * + * \brief Generic expression where a coefficient-wise unary operator is applied to an expression + * + * \tparam UnaryOp template functor implementing the operator + * \tparam XprType the type of the expression to which we are applying the unary operator + * + * This class represents an expression where a unary operator is applied to an expression. + * It is the return type of all operations taking exactly 1 input expression, regardless of the + * presence of other inputs such as scalars. For example, the operator* in the expression 3*matrix + * is considered unary, because only the right-hand side is an expression, and its + * return type is a specialization of CwiseUnaryOp. + * + * Most of the time, this is the only way that it is used, so you typically don't have to name + * CwiseUnaryOp types explicitly. + * + * \sa MatrixBase::unaryExpr(const CustomUnaryOp &) const, class CwiseBinaryOp, class CwiseNullaryOp + */ +template +class CwiseUnaryOp : public CwiseUnaryOpImpl::StorageKind>, internal::no_assignment_operator +{ + public: + + typedef typename CwiseUnaryOpImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryOp) + typedef typename internal::ref_selector::type XprTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit CwiseUnaryOp(const XprType& xpr, const UnaryOp& func = UnaryOp()) + : m_xpr(xpr), m_functor(func) {} + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_xpr.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_xpr.cols(); } + + /** \returns the functor representing the unary operation */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const UnaryOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + typename internal::remove_all::type& + nestedExpression() { return m_xpr; } + + protected: + XprTypeNested m_xpr; + const UnaryOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseUnaryOpImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_UNARY_OP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h new file mode 100644 index 0000000..a06d762 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/CwiseUnaryView.h @@ -0,0 +1,132 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_CWISE_UNARY_VIEW_H +#define EIGEN_CWISE_UNARY_VIEW_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename result_of< + ViewOp(const typename traits::Scalar&) + >::type Scalar; + typedef typename MatrixType::Nested MatrixTypeNested; + typedef typename remove_all::type _MatrixTypeNested; + enum { + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = traits<_MatrixTypeNested>::Flags & (RowMajorBit | FlagsLvalueBit | DirectAccessBit), // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeInnerStride = inner_stride_at_compile_time::ret, + // need to cast the sizeof's from size_t to int explicitly, otherwise: + // "error: no integral type can represent all of the enumerator values + InnerStrideAtCompileTime = MatrixTypeInnerStride == Dynamic + ? int(Dynamic) + : int(MatrixTypeInnerStride) * int(sizeof(typename traits::Scalar) / sizeof(Scalar)), + OuterStrideAtCompileTime = outer_stride_at_compile_time::ret == Dynamic + ? int(Dynamic) + : outer_stride_at_compile_time::ret * int(sizeof(typename traits::Scalar) / sizeof(Scalar)) + }; +}; +} + +template +class CwiseUnaryViewImpl; + +/** \class CwiseUnaryView + * \ingroup Core_Module + * + * \brief Generic lvalue expression of a coefficient-wise unary operator of a matrix or a vector + * + * \tparam ViewOp template functor implementing the view + * \tparam MatrixType the type of the matrix we are applying the unary operator + * + * This class represents a lvalue expression of a generic unary view operator of a matrix or a vector. + * It is the return type of real() and imag(), and most of the time this is the only way it is used. + * + * \sa MatrixBase::unaryViewExpr(const CustomUnaryOp &) const, class CwiseUnaryOp + */ +template +class CwiseUnaryView : public CwiseUnaryViewImpl::StorageKind> +{ + public: + + typedef typename CwiseUnaryViewImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(CwiseUnaryView) + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + explicit EIGEN_DEVICE_FUNC inline CwiseUnaryView(MatrixType& mat, const ViewOp& func = ViewOp()) + : m_matrix(mat), m_functor(func) {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryView) + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + /** \returns the functor representing unary operation */ + EIGEN_DEVICE_FUNC const ViewOp& functor() const { return m_functor; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC const typename internal::remove_all::type& + nestedExpression() const { return m_matrix; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC typename internal::remove_reference::type& + nestedExpression() { return m_matrix; } + + protected: + MatrixTypeNested m_matrix; + ViewOp m_functor; +}; + +// Generic API dispatcher +template +class CwiseUnaryViewImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +template +class CwiseUnaryViewImpl + : public internal::dense_xpr_base< CwiseUnaryView >::type +{ + public: + + typedef CwiseUnaryView Derived; + typedef typename internal::dense_xpr_base< CwiseUnaryView >::type Base; + + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(CwiseUnaryViewImpl) + + EIGEN_DEVICE_FUNC inline Scalar* data() { return &(this->coeffRef(0)); } + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return &(this->coeff(0)); } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index innerStride() const + { + return derived().nestedExpression().innerStride() * sizeof(typename internal::traits::Scalar) / sizeof(Scalar); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index outerStride() const + { + return derived().nestedExpression().outerStride() * sizeof(typename internal::traits::Scalar) / sizeof(Scalar); + } + protected: + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(CwiseUnaryViewImpl) +}; + +} // end namespace Eigen + +#endif // EIGEN_CWISE_UNARY_VIEW_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h b/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h new file mode 100644 index 0000000..9b16db6 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseBase.h @@ -0,0 +1,701 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSEBASE_H +#define EIGEN_DENSEBASE_H + +namespace Eigen { + +namespace internal { + +// The index type defined by EIGEN_DEFAULT_DENSE_INDEX_TYPE must be a signed type. +// This dummy function simply aims at checking that at compile time. +static inline void check_DenseIndex_is_signed() { + EIGEN_STATIC_ASSERT(NumTraits::IsSigned,THE_INDEX_TYPE_MUST_BE_A_SIGNED_TYPE) +} + +} // end namespace internal + +/** \class DenseBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and arrays + * + * This class is the base that is inherited by all dense objects (matrix, vector, arrays, + * and related expression types). The common Eigen API for dense objects is contained in this class. + * + * \tparam Derived is the derived type, e.g., a matrix type or an expression. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_DENSEBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template class DenseBase +#ifndef EIGEN_PARSED_BY_DOXYGEN + : public DenseCoeffsBase::value> +#else + : public DenseCoeffsBase +#endif // not EIGEN_PARSED_BY_DOXYGEN +{ + public: + + /** Inner iterator type to iterate over the coefficients of a row or column. + * \sa class InnerIterator + */ + typedef Eigen::InnerIterator InnerIterator; + + typedef typename internal::traits::StorageKind StorageKind; + + /** + * \brief The type used to store indices + * \details This typedef is relevant for types that store multiple indices such as + * PermutationMatrix or Transpositions, otherwise it defaults to Eigen::Index + * \sa \blank \ref TopicPreprocessorDirectives, Eigen::Index, SparseMatrixBase. + */ + typedef typename internal::traits::StorageIndex StorageIndex; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. */ + typedef typename internal::traits::Scalar Scalar; + + /** The numeric type of the expression' coefficients, e.g. float, double, int or std::complex, etc. + * + * It is an alias for the Scalar type */ + typedef Scalar value_type; + + typedef typename NumTraits::Real RealScalar; + typedef DenseCoeffsBase::value> Base; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::rowIndexByOuterInner; + using Base::colIndexByOuterInner; + using Base::coeff; + using Base::coeffByOuterInner; + using Base::operator(); + using Base::operator[]; + using Base::x; + using Base::y; + using Base::z; + using Base::w; + using Base::stride; + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + typedef typename Base::CoeffReturnType CoeffReturnType; + + enum { + + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + /**< The number of rows at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), ColsAtCompileTime, SizeAtCompileTime */ + + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + /**< The number of columns at compile-time. This is just a copy of the value provided + * by the \a Derived type. If a value is not known at compile-time, + * it is set to the \a Dynamic constant. + * \sa MatrixBase::rows(), MatrixBase::cols(), RowsAtCompileTime, SizeAtCompileTime */ + + + SizeAtCompileTime = (internal::size_at_compile_time::RowsAtCompileTime, + internal::traits::ColsAtCompileTime>::ret), + /**< This is equal to the number of coefficients, i.e. the number of + * rows times the number of columns, or to \a Dynamic if this is not + * known at compile-time. \sa RowsAtCompileTime, ColsAtCompileTime */ + + MaxRowsAtCompileTime = internal::traits::MaxRowsAtCompileTime, + /**< This value is equal to the maximum possible number of rows that this expression + * might have. If this expression might have an arbitrarily high number of rows, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa RowsAtCompileTime, MaxColsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxColsAtCompileTime = internal::traits::MaxColsAtCompileTime, + /**< This value is equal to the maximum possible number of columns that this expression + * might have. If this expression might have an arbitrarily high number of columns, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa ColsAtCompileTime, MaxRowsAtCompileTime, MaxSizeAtCompileTime + */ + + MaxSizeAtCompileTime = (internal::size_at_compile_time::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime>::ret), + /**< This value is equal to the maximum possible number of coefficients that this expression + * might have. If this expression might have an arbitrarily high number of coefficients, + * this value is set to \a Dynamic. + * + * This value is useful to know when evaluating an expression, in order to determine + * whether it is possible to avoid doing a dynamic memory allocation. + * + * \sa SizeAtCompileTime, MaxRowsAtCompileTime, MaxColsAtCompileTime + */ + + IsVectorAtCompileTime = internal::traits::RowsAtCompileTime == 1 + || internal::traits::ColsAtCompileTime == 1, + /**< This is set to true if either the number of rows or the number of + * columns is known at compile-time to be equal to 1. Indeed, in that case, + * we are dealing with a column-vector (if there is only one column) or with + * a row-vector (if there is only one row). */ + + NumDimensions = int(MaxSizeAtCompileTime) == 1 ? 0 : bool(IsVectorAtCompileTime) ? 1 : 2, + /**< This value is equal to Tensor::NumDimensions, i.e. 0 for scalars, 1 for vectors, + * and 2 for matrices. + */ + + Flags = internal::traits::Flags, + /**< This stores expression \ref flags flags which may or may not be inherited by new expressions + * constructed from this one. See the \ref flags "list of flags". + */ + + IsRowMajor = int(Flags) & RowMajorBit, /**< True if this expression has row-major storage order. */ + + InnerSizeAtCompileTime = int(IsVectorAtCompileTime) ? int(SizeAtCompileTime) + : int(IsRowMajor) ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + + InnerStrideAtCompileTime = internal::inner_stride_at_compile_time::ret, + OuterStrideAtCompileTime = internal::outer_stride_at_compile_time::ret + }; + + typedef typename internal::find_best_packet::type PacketScalar; + + enum { IsPlainObjectBase = 0 }; + + /** The plain matrix type corresponding to this expression. + * \sa PlainObject */ + typedef Matrix::Scalar, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags&RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime + > PlainMatrix; + + /** The plain array type corresponding to this expression. + * \sa PlainObject */ + typedef Array::Scalar, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime, + AutoAlign | (internal::traits::Flags&RowMajorBit ? RowMajor : ColMajor), + internal::traits::MaxRowsAtCompileTime, + internal::traits::MaxColsAtCompileTime + > PlainArray; + + /** \brief The plain matrix or array type corresponding to this expression. + * + * This is not necessarily exactly the return type of eval(). In the case of plain matrices, + * the return type of eval() is a const reference to a matrix, not a matrix! It is however guaranteed + * that the return type of eval() is either PlainObject or const PlainObject&. + */ + typedef typename internal::conditional::XprKind,MatrixXpr >::value, + PlainMatrix, PlainArray>::type PlainObject; + + /** \returns the number of nonzero coefficients which is in practice the number + * of stored coefficients. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index nonZeros() const { return size(); } + + /** \returns the outer size. + * + * \note For a vector, this returns just 1. For a matrix (non-vector), this is the major dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of columns for a + * column-major matrix, and the number of rows for a row-major matrix. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + Index outerSize() const + { + return IsVectorAtCompileTime ? 1 + : int(IsRowMajor) ? this->rows() : this->cols(); + } + + /** \returns the inner size. + * + * \note For a vector, this is just the size. For a matrix (non-vector), this is the minor dimension + * with respect to the \ref TopicStorageOrders "storage order", i.e., the number of rows for a + * column-major matrix, and the number of columns for a row-major matrix. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + Index innerSize() const + { + return IsVectorAtCompileTime ? this->size() + : int(IsRowMajor) ? this->cols() : this->rows(); + } + + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and does + * nothing else. + */ + EIGEN_DEVICE_FUNC + void resize(Index newSize) + { + EIGEN_ONLY_USED_FOR_DEBUG(newSize); + eigen_assert(newSize == this->size() + && "DenseBase::resize() does not actually allow to resize."); + } + /** Only plain matrices/arrays, not expressions, may be resized; therefore the only useful resize methods are + * Matrix::resize() and Array::resize(). The present method only asserts that the new size equals the old size, and does + * nothing else. + */ + EIGEN_DEVICE_FUNC + void resize(Index rows, Index cols) + { + EIGEN_ONLY_USED_FOR_DEBUG(rows); + EIGEN_ONLY_USED_FOR_DEBUG(cols); + eigen_assert(rows == this->rows() && cols == this->cols() + && "DenseBase::resize() does not actually allow to resize."); + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; + /** \internal \deprecated Represents a vector with linearly spaced coefficients that allows sequential access only. */ + EIGEN_DEPRECATED typedef CwiseNullaryOp,PlainObject> SequentialLinSpacedReturnType; + /** \internal Represents a vector with linearly spaced coefficients that allows random access. */ + typedef CwiseNullaryOp,PlainObject> RandomAccessLinSpacedReturnType; + /** \internal the return type of MatrixBase::eigenvalues() */ + typedef Matrix::Scalar>::Real, internal::traits::ColsAtCompileTime, 1> EigenvaluesReturnType; + +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** Copies \a other into *this. \returns a reference to *this. */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator+=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator-=(const EigenBase &other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const ReturnByValue& func); + + /** \internal + * Copies \a other into *this without evaluating other. \returns a reference to *this. */ + template + /** \deprecated */ + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC + Derived& lazyAssign(const DenseBase& other); + + EIGEN_DEVICE_FUNC + CommaInitializer operator<< (const Scalar& s); + + template + /** \deprecated it now returns \c *this */ + EIGEN_DEPRECATED + const Derived& flagged() const + { return derived(); } + + template + EIGEN_DEVICE_FUNC + CommaInitializer operator<< (const DenseBase& other); + + typedef Transpose TransposeReturnType; + EIGEN_DEVICE_FUNC + TransposeReturnType transpose(); + typedef typename internal::add_const >::type ConstTransposeReturnType; + EIGEN_DEVICE_FUNC + ConstTransposeReturnType transpose() const; + EIGEN_DEVICE_FUNC + void transposeInPlace(); + + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(Index rows, Index cols, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(Index size, const Scalar& value); + EIGEN_DEVICE_FUNC static const ConstantReturnType + Constant(const Scalar& value); + + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Sequential_t, Index size, const Scalar& low, const Scalar& high); + EIGEN_DEPRECATED EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Sequential_t, const Scalar& low, const Scalar& high); + + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(Index size, const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC static const RandomAccessLinSpacedReturnType + LinSpaced(const Scalar& low, const Scalar& high); + + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(Index rows, Index cols, const CustomNullaryOp& func); + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(Index size, const CustomNullaryOp& func); + template EIGEN_DEVICE_FUNC + static const CwiseNullaryOp + NullaryExpr(const CustomNullaryOp& func); + + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(Index size); + EIGEN_DEVICE_FUNC static const ConstantReturnType Zero(); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(Index size); + EIGEN_DEVICE_FUNC static const ConstantReturnType Ones(); + + EIGEN_DEVICE_FUNC void fill(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setConstant(const Scalar& value); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(Index size, const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setLinSpaced(const Scalar& low, const Scalar& high); + EIGEN_DEVICE_FUNC Derived& setZero(); + EIGEN_DEVICE_FUNC Derived& setOnes(); + EIGEN_DEVICE_FUNC Derived& setRandom(); + + template EIGEN_DEVICE_FUNC + bool isApprox(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC + bool isMuchSmallerThan(const RealScalar& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + template EIGEN_DEVICE_FUNC + bool isMuchSmallerThan(const DenseBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + + EIGEN_DEVICE_FUNC bool isApproxToConstant(const Scalar& value, const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isConstant(const Scalar& value, const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isZero(const RealScalar& prec = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC bool isOnes(const RealScalar& prec = NumTraits::dummy_precision()) const; + + inline bool hasNaN() const; + inline bool allFinite() const; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator*=(const Scalar& other); + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator/=(const Scalar& other); + + typedef typename internal::add_const_on_value_type::type>::type EvalReturnType; + /** \returns the matrix or vector obtained by evaluating this expression. + * + * Notice that in the case of a plain matrix or vector (not an expression) this function just returns + * a const reference, in order to avoid a useless copy. + * + * \warning Be careful with eval() and the auto C++ keyword, as detailed in this \link TopicPitfalls_auto_keyword page \endlink. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE EvalReturnType eval() const + { + // Even though MSVC does not honor strong inlining when the return type + // is a dynamic matrix, we desperately need strong inlining for fixed + // size types on MSVC. + return typename internal::eval::type(derived()); + } + + /** swaps *this with the expression \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(const DenseBase& other) + { + EIGEN_STATIC_ASSERT(!OtherDerived::IsPlainObjectBase,THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + eigen_assert(rows()==other.rows() && cols()==other.cols()); + call_assignment(derived(), other.const_cast_derived(), internal::swap_assign_op()); + } + + /** swaps *this with the matrix or array \a other. + * + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(PlainObjectBase& other) + { + eigen_assert(rows()==other.rows() && cols()==other.cols()); + call_assignment(derived(), other.derived(), internal::swap_assign_op()); + } + + EIGEN_DEVICE_FUNC inline const NestByValue nestByValue() const; + EIGEN_DEVICE_FUNC inline const ForceAlignedAccess forceAlignedAccess() const; + EIGEN_DEVICE_FUNC inline ForceAlignedAccess forceAlignedAccess(); + template EIGEN_DEVICE_FUNC + inline const typename internal::conditional,Derived&>::type forceAlignedAccessIf() const; + template EIGEN_DEVICE_FUNC + inline typename internal::conditional,Derived&>::type forceAlignedAccessIf(); + + EIGEN_DEVICE_FUNC Scalar sum() const; + EIGEN_DEVICE_FUNC Scalar mean() const; + EIGEN_DEVICE_FUNC Scalar trace() const; + + EIGEN_DEVICE_FUNC Scalar prod() const; + + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar minCoeff() const; + template + EIGEN_DEVICE_FUNC typename internal::traits::Scalar maxCoeff() const; + + + // By default, the fastest version with undefined NaN propagation semantics is + // used. + // TODO(rmlarsen): Replace with default template argument when we move to + // c++11 or beyond. + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar minCoeff() const { + return minCoeff(); + } + EIGEN_DEVICE_FUNC inline typename internal::traits::Scalar maxCoeff() const { + return maxCoeff(); + } + + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar minCoeff(IndexType* index) const; + template + EIGEN_DEVICE_FUNC + typename internal::traits::Scalar maxCoeff(IndexType* index) const; + + // TODO(rmlarsen): Replace these methods with a default template argument. + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar minCoeff(IndexType* row, IndexType* col) const { + return minCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar maxCoeff(IndexType* row, IndexType* col) const { + return maxCoeff(row, col); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar minCoeff(IndexType* index) const { + return minCoeff(index); + } + template + EIGEN_DEVICE_FUNC inline + typename internal::traits::Scalar maxCoeff(IndexType* index) const { + return maxCoeff(index); + } + + template + EIGEN_DEVICE_FUNC + Scalar redux(const BinaryOp& func) const; + + template + EIGEN_DEVICE_FUNC + void visit(Visitor& func) const; + + /** \returns a WithFormat proxy object allowing to print a matrix the with given + * format \a fmt. + * + * See class IOFormat for some examples. + * + * \sa class IOFormat, class WithFormat + */ + inline const WithFormat format(const IOFormat& fmt) const + { + return WithFormat(derived(), fmt); + } + + /** \returns the unique coefficient of a 1x1 expression */ + EIGEN_DEVICE_FUNC + CoeffReturnType value() const + { + EIGEN_STATIC_ASSERT_SIZE_1x1(Derived) + eigen_assert(this->rows() == 1 && this->cols() == 1); + return derived().coeff(0,0); + } + + EIGEN_DEVICE_FUNC bool all() const; + EIGEN_DEVICE_FUNC bool any() const; + EIGEN_DEVICE_FUNC Index count() const; + + typedef VectorwiseOp RowwiseReturnType; + typedef const VectorwiseOp ConstRowwiseReturnType; + typedef VectorwiseOp ColwiseReturnType; + typedef const VectorwiseOp ConstColwiseReturnType; + + /** \returns a VectorwiseOp wrapper of *this for broadcasting and partial reductions + * + * Example: \include MatrixBase_rowwise.cpp + * Output: \verbinclude MatrixBase_rowwise.out + * + * \sa colwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC inline ConstRowwiseReturnType rowwise() const { + return ConstRowwiseReturnType(derived()); + } + EIGEN_DEVICE_FUNC RowwiseReturnType rowwise(); + + /** \returns a VectorwiseOp wrapper of *this broadcasting and partial reductions + * + * Example: \include MatrixBase_colwise.cpp + * Output: \verbinclude MatrixBase_colwise.out + * + * \sa rowwise(), class VectorwiseOp, \ref TutorialReductionsVisitorsBroadcasting + */ + EIGEN_DEVICE_FUNC inline ConstColwiseReturnType colwise() const { + return ConstColwiseReturnType(derived()); + } + EIGEN_DEVICE_FUNC ColwiseReturnType colwise(); + + typedef CwiseNullaryOp,PlainObject> RandomReturnType; + static const RandomReturnType Random(Index rows, Index cols); + static const RandomReturnType Random(Index size); + static const RandomReturnType Random(); + + template + inline EIGEN_DEVICE_FUNC const Select + select(const DenseBase& thenMatrix, + const DenseBase& elseMatrix) const; + + template + inline EIGEN_DEVICE_FUNC const Select + select(const DenseBase& thenMatrix, const typename ThenDerived::Scalar& elseScalar) const; + + template + inline EIGEN_DEVICE_FUNC const Select + select(const typename ElseDerived::Scalar& thenScalar, const DenseBase& elseMatrix) const; + + template RealScalar lpNorm() const; + + template + EIGEN_DEVICE_FUNC + const Replicate replicate() const; + /** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate_int_int.cpp + * Output: \verbinclude MatrixBase_replicate_int_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC + const Replicate replicate(Index rowFactor, Index colFactor) const + { + return Replicate(derived(), rowFactor, colFactor); + } + + typedef Reverse ReverseReturnType; + typedef const Reverse ConstReverseReturnType; + EIGEN_DEVICE_FUNC ReverseReturnType reverse(); + /** This is the const version of reverse(). */ + //Code moved here due to a CUDA compiler bug + EIGEN_DEVICE_FUNC ConstReverseReturnType reverse() const + { + return ConstReverseReturnType(derived()); + } + EIGEN_DEVICE_FUNC void reverseInPlace(); + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** STL-like RandomAccessIterator + * iterator type as returned by the begin() and end() methods. + */ + typedef random_access_iterator_type iterator; + /** This is the const version of iterator (aka read-only) */ + typedef random_access_iterator_type const_iterator; + #else + typedef typename internal::conditional< (Flags&DirectAccessBit)==DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator + >::type iterator_type; + + typedef typename internal::conditional< (Flags&DirectAccessBit)==DirectAccessBit, + internal::pointer_based_stl_iterator, + internal::generic_randaccess_stl_iterator + >::type const_iterator_type; + + // Stl-style iterators are supported only for vectors. + + typedef typename internal::conditional< IsVectorAtCompileTime, + iterator_type, + void + >::type iterator; + + typedef typename internal::conditional< IsVectorAtCompileTime, + const_iterator_type, + void + >::type const_iterator; + #endif + + inline iterator begin(); + inline const_iterator begin() const; + inline const_iterator cbegin() const; + inline iterator end(); + inline const_iterator end() const; + inline const_iterator cend() const; + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::DenseBase +#define EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#define EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF(COND) +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/CommonCwiseUnaryOps.h" +# include "../plugins/BlockMethods.h" +# include "../plugins/IndexedViewMethods.h" +# include "../plugins/ReshapedMethods.h" +# ifdef EIGEN_DENSEBASE_PLUGIN +# include EIGEN_DENSEBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_BLOCK_ADDONS_NOT_INNER_PANEL +#undef EIGEN_DOC_BLOCK_ADDONS_INNER_PANEL_IF +#undef EIGEN_DOC_UNARY_ADDONS + + // disable the use of evalTo for dense objects with a nice compilation error + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& ) const + { + EIGEN_STATIC_ASSERT((internal::is_same::value),THE_EVAL_EVALTO_FUNCTION_SHOULD_NEVER_BE_CALLED_FOR_DENSE_OBJECTS); + } + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(DenseBase) + /** Default constructor. Do nothing. */ + EIGEN_DEVICE_FUNC DenseBase() + { + /* Just checks for self-consistency of the flags. + * Only do it when debugging Eigen, as this borders on paranoia and could slow compilation down + */ +#ifdef EIGEN_INTERNAL_DEBUGGING + EIGEN_STATIC_ASSERT((EIGEN_IMPLIES(MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1, int(IsRowMajor)) + && EIGEN_IMPLIES(MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1, int(!IsRowMajor))), + INVALID_STORAGE_ORDER_FOR_THIS_VECTOR_EXPRESSION) +#endif + } + + private: + EIGEN_DEVICE_FUNC explicit DenseBase(int); + EIGEN_DEVICE_FUNC DenseBase(int,int); + template EIGEN_DEVICE_FUNC explicit DenseBase(const DenseBase&); +}; + +} // end namespace Eigen + +#endif // EIGEN_DENSEBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h b/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h new file mode 100644 index 0000000..37fcdb5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseCoeffsBase.h @@ -0,0 +1,685 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSECOEFFSBASE_H +#define EIGEN_DENSECOEFFSBASE_H + +namespace Eigen { + +namespace internal { +template struct add_const_on_value_type_if_arithmetic +{ + typedef typename conditional::value, T, typename add_const_on_value_type::type>::type type; +}; +} + +/** \brief Base class providing read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #ReadOnlyAccessors Constant indicating read-only access + * + * This class defines the \c operator() \c const function and friends, which can be used to read specific + * entries of a matrix or array. + * + * \sa DenseCoeffsBase, DenseCoeffsBase, + * \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public EigenBase +{ + public: + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + + // Explanation for this CoeffReturnType typedef. + // - This is the return type of the coeff() method. + // - The LvalueBit means exactly that we can offer a coeffRef() method, which means exactly that we can get references + // to coeffs, which means exactly that we can have coeff() return a const reference (as opposed to returning a value). + // - The is_artihmetic check is required since "const int", "const double", etc. will cause warnings on some systems + // while the declaration of "const T", where T is a non arithmetic type does not. Always returning "const Scalar&" is + // not possible, since the underlying expressions might not offer a valid address the reference could be referring to. + typedef typename internal::conditional::Flags&LvalueBit), + const Scalar&, + typename internal::conditional::value, Scalar, const Scalar>::type + >::type CoeffReturnType; + + typedef typename internal::add_const_on_value_type_if_arithmetic< + typename internal::packet_traits::type + >::type PacketReturnType; + + typedef EigenBase Base; + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index rowIndexByOuterInner(Index outer, Index inner) const + { + return int(Derived::RowsAtCompileTime) == 1 ? 0 + : int(Derived::ColsAtCompileTime) == 1 ? inner + : int(Derived::Flags)&RowMajorBit ? outer + : inner; + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Index colIndexByOuterInner(Index outer, Index inner) const + { + return int(Derived::ColsAtCompileTime) == 1 ? 0 + : int(Derived::RowsAtCompileTime) == 1 ? inner + : int(Derived::Flags)&RowMajorBit ? inner + : outer; + } + + /** Short version: don't use this function, use + * \link operator()(Index,Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) const \endlink. + * + * \sa operator()(Index,Index) const, coeffRef(Index,Index), coeff(Index) const + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType coeff(Index row, Index col) const + { + eigen_internal_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeff(row,col); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType coeffByOuterInner(Index outer, Index inner) const + { + return coeff(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \returns the coefficient at given the given row and column. + * + * \sa operator()(Index,Index), operator[](Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType operator()(Index row, Index col) const + { + eigen_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return coeff(row, col); + } + + /** Short version: don't use this function, use + * \link operator[](Index) const \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) const \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameter \a index is in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) const \endlink. + * + * \sa operator[](Index) const, coeffRef(Index), coeff(Index,Index) const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + coeff(Index index) const + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeff(index); + } + + + /** \returns the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + operator[](Index index) const + { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** \returns the coefficient at given index. + * + * This is synonymous to operator[](Index) const. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index), operator()(Index,Index) const, x() const, y() const, + * z() const, w() const + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + operator()(Index index) const + { + eigen_assert(index >= 0 && index < size()); + return coeff(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + x() const { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + y() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + z() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE CoeffReturnType + w() const + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } + + /** \internal + * \returns the packet of coefficients starting at the given row and column. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index row, Index col) const + { + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(row >= 0 && row < rows() && col >= 0 && col < cols()); + return internal::evaluator(derived()).template packet(row,col); + } + + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketReturnType packetByOuterInner(Index outer, Index inner) const + { + return packet(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \internal + * \returns the packet of coefficients starting at the given index. It is your responsibility + * to ensure that a packet really starts there. This method is only available on expressions having the + * PacketAccessBit and the LinearAccessBit. + * + * The \a LoadMode parameter may have the value \a #Aligned or \a #Unaligned. Its effect is to select + * the appropriate vectorization instruction. Aligned access is faster, but is only possible for packets + * starting at an address which is a multiple of the packet size. + */ + + template + EIGEN_STRONG_INLINE PacketReturnType packet(Index index) const + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + typedef typename internal::packet_traits::type DefaultPacketType; + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).template packet(index); + } + + protected: + // explanation: DenseBase is doing "using ..." on the methods from DenseCoeffsBase. + // But some methods are only available in the DirectAccess case. + // So we add dummy methods here with these names, so that "using... " doesn't fail. + // It's not private so that the child class DenseBase can access them, and it's not public + // either since it's an implementation detail, so has to be protected. + void coeffRef(); + void coeffRefByOuterInner(); + void writePacket(); + void writePacketByOuterInner(); + void copyCoeff(); + void copyCoeffByOuterInner(); + void copyPacket(); + void copyPacketByOuterInner(); + void stride(); + void innerStride(); + void outerStride(); + void rowStride(); + void colStride(); +}; + +/** \brief Base class providing read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #WriteAccessors Constant indicating read/write access + * + * This class defines the non-const \c operator() function and friends, which can be used to write specific + * entries of a matrix or array. This class inherits DenseCoeffsBase which + * defines the const variant for reading specific entries. + * + * \sa DenseCoeffsBase, \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + using Base::coeff; + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + using Base::rowIndexByOuterInner; + using Base::colIndexByOuterInner; + using Base::operator[]; + using Base::operator(); + using Base::x; + using Base::y; + using Base::z; + using Base::w; + + /** Short version: don't use this function, use + * \link operator()(Index,Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator()(Index,Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator()(Index,Index) \endlink. + * + * \sa operator()(Index,Index), coeff(Index, Index) const, coeffRef(Index) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index row, Index col) + { + eigen_internal_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return internal::evaluator(derived()).coeffRef(row,col); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + coeffRefByOuterInner(Index outer, Index inner) + { + return coeffRef(rowIndexByOuterInner(outer, inner), + colIndexByOuterInner(outer, inner)); + } + + /** \returns a reference to the coefficient at given the given row and column. + * + * \sa operator[](Index) + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator()(Index row, Index col) + { + eigen_assert(row >= 0 && row < rows() + && col >= 0 && col < cols()); + return coeffRef(row, col); + } + + + /** Short version: don't use this function, use + * \link operator[](Index) \endlink instead. + * + * Long version: this function is similar to + * \link operator[](Index) \endlink, but without the assertion. + * Use this for limiting the performance cost of debugging code when doing + * repeated coefficient access. Only use this when it is guaranteed that the + * parameters \a row and \a col are in range. + * + * If EIGEN_INTERNAL_DEBUGGING is defined, an assertion will be made, making this + * function equivalent to \link operator[](Index) \endlink. + * + * \sa operator[](Index), coeff(Index) const, coeffRef(Index,Index) + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + coeffRef(Index index) + { + EIGEN_STATIC_ASSERT(internal::evaluator::Flags & LinearAccessBit, + THIS_COEFFICIENT_ACCESSOR_TAKING_ONE_ACCESS_IS_ONLY_FOR_EXPRESSIONS_ALLOWING_LINEAR_ACCESS) + eigen_internal_assert(index >= 0 && index < size()); + return internal::evaluator(derived()).coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator[](Index index) + { + EIGEN_STATIC_ASSERT(Derived::IsVectorAtCompileTime, + THE_BRACKET_OPERATOR_IS_ONLY_FOR_VECTORS__USE_THE_PARENTHESIS_OPERATOR_INSTEAD) + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** \returns a reference to the coefficient at given index. + * + * This is synonymous to operator[](Index). + * + * This method is allowed only for vector expressions, and for matrix expressions having the LinearAccessBit. + * + * \sa operator[](Index) const, operator()(Index,Index), x(), y(), z(), w() + */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + operator()(Index index) + { + eigen_assert(index >= 0 && index < size()); + return coeffRef(index); + } + + /** equivalent to operator[](0). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + x() { return (*this)[0]; } + + /** equivalent to operator[](1). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + y() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=2, OUT_OF_RANGE_ACCESS); + return (*this)[1]; + } + + /** equivalent to operator[](2). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + z() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=3, OUT_OF_RANGE_ACCESS); + return (*this)[2]; + } + + /** equivalent to operator[](3). */ + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& + w() + { + EIGEN_STATIC_ASSERT(Derived::SizeAtCompileTime==-1 || Derived::SizeAtCompileTime>=4, OUT_OF_RANGE_ACCESS); + return (*this)[3]; + } +}; + +/** \brief Base class providing direct read-only coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read-only using + * \c operator() . + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return derived().innerStride(); + } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return derived().outerStride(); + } + + // FIXME shall we remove it ? + EIGEN_CONSTEXPR inline Index stride() const + { + return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); + } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rowStride() const + { + return Derived::IsRowMajor ? outerStride() : innerStride(); + } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index colStride() const + { + return Derived::IsRowMajor ? innerStride() : outerStride(); + } +}; + +/** \brief Base class providing direct read/write coefficient access to matrices and arrays. + * \ingroup Core_Module + * \tparam Derived Type of the derived class + * + * \note #DirectWriteAccessors Constant indicating direct access + * + * This class defines functions to work with strides which can be used to access entries directly. This class + * inherits DenseCoeffsBase which defines functions to access entries read/write using + * \c operator(). + * + * \sa \blank \ref TopicClassHierarchy + */ +template +class DenseCoeffsBase + : public DenseCoeffsBase +{ + public: + + typedef DenseCoeffsBase Base; + typedef typename internal::traits::Scalar Scalar; + typedef typename NumTraits::Real RealScalar; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::derived; + + /** \returns the pointer increment between two consecutive elements within a slice in the inner direction. + * + * \sa outerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT + { + return derived().innerStride(); + } + + /** \returns the pointer increment between two consecutive inner slices (for example, between two consecutive columns + * in a column-major matrix). + * + * \sa innerStride(), rowStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT + { + return derived().outerStride(); + } + + // FIXME shall we remove it ? + EIGEN_CONSTEXPR inline Index stride() const EIGEN_NOEXCEPT + { + return Derived::IsVectorAtCompileTime ? innerStride() : outerStride(); + } + + /** \returns the pointer increment between two consecutive rows. + * + * \sa innerStride(), outerStride(), colStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rowStride() const EIGEN_NOEXCEPT + { + return Derived::IsRowMajor ? outerStride() : innerStride(); + } + + /** \returns the pointer increment between two consecutive columns. + * + * \sa innerStride(), outerStride(), rowStride() + */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index colStride() const EIGEN_NOEXCEPT + { + return Derived::IsRowMajor ? innerStride() : outerStride(); + } +}; + +namespace internal { + +template +struct first_aligned_impl +{ + static EIGEN_CONSTEXPR inline Index run(const Derived&) EIGEN_NOEXCEPT + { return 0; } +}; + +template +struct first_aligned_impl +{ + static inline Index run(const Derived& m) + { + return internal::first_aligned(m.data(), m.size()); + } +}; + +/** \internal \returns the index of the first element of the array stored by \a m that is properly aligned with respect to \a Alignment for vectorization. + * + * \tparam Alignment requested alignment in Bytes. + * + * There is also the variant first_aligned(const Scalar*, Integer) defined in Memory.h. See it for more + * documentation. + */ +template +static inline Index first_aligned(const DenseBase& m) +{ + enum { ReturnZero = (int(evaluator::Alignment) >= Alignment) || !(Derived::Flags & DirectAccessBit) }; + return first_aligned_impl::run(m.derived()); +} + +template +static inline Index first_default_aligned(const DenseBase& m) +{ + typedef typename Derived::Scalar Scalar; + typedef typename packet_traits::type DefaultPacketType; + return internal::first_aligned::alignment),Derived>(m); +} + +template::ret> +struct inner_stride_at_compile_time +{ + enum { ret = traits::InnerStrideAtCompileTime }; +}; + +template +struct inner_stride_at_compile_time +{ + enum { ret = 0 }; +}; + +template::ret> +struct outer_stride_at_compile_time +{ + enum { ret = traits::OuterStrideAtCompileTime }; +}; + +template +struct outer_stride_at_compile_time +{ + enum { ret = 0 }; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSECOEFFSBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h b/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h new file mode 100644 index 0000000..08ef6c5 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DenseStorage.h @@ -0,0 +1,652 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2010-2013 Hauke Heibel +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXSTORAGE_H +#define EIGEN_MATRIXSTORAGE_H + +#ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) X; EIGEN_DENSE_STORAGE_CTOR_PLUGIN; +#else + #define EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(X) +#endif + +namespace Eigen { + +namespace internal { + +struct constructor_without_unaligned_array_assert {}; + +template +EIGEN_DEVICE_FUNC +void check_static_allocation_size() +{ + // if EIGEN_STACK_ALLOCATION_LIMIT is defined to 0, then no limit + #if EIGEN_STACK_ALLOCATION_LIMIT + EIGEN_STATIC_ASSERT(Size * sizeof(T) <= EIGEN_STACK_ALLOCATION_LIMIT, OBJECT_ALLOCATED_ON_STACK_IS_TOO_BIG); + #endif +} + +/** \internal + * Static array. If the MatrixOrArrayOptions require auto-alignment, the array will be automatically aligned: + * to 16 bytes boundary if the total size is a multiple of 16 bytes. + */ +template ::value > +struct plain_array +{ + T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +#if defined(EIGEN_DISABLE_UNALIGNED_ARRAY_ASSERT) + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) +#elif EIGEN_GNUC_AT_LEAST(4,7) + // GCC 4.7 is too aggressive in its optimizations and remove the alignment test based on the fact the array is declared to be aligned. + // See this bug report: http://gcc.gnu.org/bugzilla/show_bug.cgi?id=53900 + // Hiding the origin of the array pointer behind a function argument seems to do the trick even if the function is inlined: + template + EIGEN_ALWAYS_INLINE PtrType eigen_unaligned_array_assert_workaround_gcc47(PtrType array) { return array; } + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) \ + eigen_assert((internal::UIntPtr(eigen_unaligned_array_assert_workaround_gcc47(array)) & (sizemask)) == 0 \ + && "this assertion is explained here: " \ + "http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html" \ + " **** READ THIS WEB PAGE !!! ****"); +#else + #define EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(sizemask) \ + eigen_assert((internal::UIntPtr(array) & (sizemask)) == 0 \ + && "this assertion is explained here: " \ + "http://eigen.tuxfamily.org/dox-devel/group__TopicUnalignedArrayAssert.html" \ + " **** READ THIS WEB PAGE !!! ****"); +#endif + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(8) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(7); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(16) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(15); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(32) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(31); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + EIGEN_ALIGN_TO_BOUNDARY(64) T array[Size]; + + EIGEN_DEVICE_FUNC + plain_array() + { + EIGEN_MAKE_UNALIGNED_ARRAY_ASSERT(63); + check_static_allocation_size(); + } + + EIGEN_DEVICE_FUNC + plain_array(constructor_without_unaligned_array_assert) + { + check_static_allocation_size(); + } +}; + +template +struct plain_array +{ + T array[1]; + EIGEN_DEVICE_FUNC plain_array() {} + EIGEN_DEVICE_FUNC plain_array(constructor_without_unaligned_array_assert) {} +}; + +struct plain_array_helper { + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + static void copy(const plain_array& src, const Eigen::Index size, + plain_array& dst) { + smart_copy(src.array, src.array + size, dst.array); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + static void swap(plain_array& a, const Eigen::Index a_size, + plain_array& b, const Eigen::Index b_size) { + if (a_size < b_size) { + std::swap_ranges(b.array, b.array + a_size, a.array); + smart_move(b.array + a_size, b.array + b_size, a.array + a_size); + } else if (a_size > b_size) { + std::swap_ranges(a.array, a.array + b_size, b.array); + smart_move(a.array + b_size, a.array + a_size, b.array + b_size); + } else { + std::swap_ranges(a.array, a.array + a_size, b.array); + } + } +}; + +} // end namespace internal + +/** \internal + * + * \class DenseStorage + * \ingroup Core_Module + * + * \brief Stores the data of a matrix + * + * This class stores the data of fixed-size, dynamic-size or mixed matrices + * in a way as compact as possible. + * + * \sa Matrix + */ +template class DenseStorage; + +// purely fixed-size matrix +template class DenseStorage +{ + internal::plain_array m_data; + public: + EIGEN_DEVICE_FUNC DenseStorage() { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + } + EIGEN_DEVICE_FUNC + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()) {} +#if !EIGEN_HAS_CXX11 || defined(EIGEN_DENSE_STORAGE_CTOR_PLUGIN) + EIGEN_DEVICE_FUNC + DenseStorage(const DenseStorage& other) : m_data(other.m_data) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = Size) + } +#else + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage&) = default; +#endif +#if !EIGEN_HAS_CXX11 + EIGEN_DEVICE_FUNC + DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) m_data = other.m_data; + return *this; + } +#else + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage&) = default; +#endif +#if EIGEN_HAS_RVALUE_REFERENCES +#if !EIGEN_HAS_CXX11 + EIGEN_DEVICE_FUNC DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + { + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + if (this != &other) + m_data = std::move(other.m_data); + return *this; + } +#else + EIGEN_DEVICE_FUNC DenseStorage(DenseStorage&&) = default; + EIGEN_DEVICE_FUNC DenseStorage& operator=(DenseStorage&&) = default; +#endif +#endif + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows==_Rows && cols==_Cols); + EIGEN_UNUSED_VARIABLE(size); + EIGEN_UNUSED_VARIABLE(rows); + EIGEN_UNUSED_VARIABLE(cols); + } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data, other.m_data); + } + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void resize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// null matrix +template class DenseStorage +{ + public: + EIGEN_DEVICE_FUNC DenseStorage() {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage&) {} + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage&) { return *this; } + EIGEN_DEVICE_FUNC DenseStorage(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& ) {} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC void resize(Index,Index,Index) {} + EIGEN_DEVICE_FUNC const T *data() const { return 0; } + EIGEN_DEVICE_FUNC T *data() { return 0; } +}; + +// more specializations for null matrices; these are necessary to resolve ambiguities +template class DenseStorage +: public DenseStorage { }; + +template class DenseStorage +: public DenseStorage { }; + +template class DenseStorage +: public DenseStorage { }; + +// dynamic-size matrix with fixed-size storage +template class DenseStorage +{ + internal::plain_array m_data; + Index m_rows; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(other.m_rows), m_cols(other.m_cols) + { + internal::plain_array_helper::copy(other.m_data, m_rows * m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_rows = other.m_rows; + m_cols = other.m_cols; + internal::plain_array_helper::copy(other.m_data, m_rows * m_cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index rows, Index cols) : m_rows(rows), m_cols(cols) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + internal::plain_array_helper::swap(m_data, m_rows * m_cols, other.m_data, other.m_rows * other.m_cols); + numext::swap(m_rows,other.m_rows); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC Index rows() const {return m_rows;} + EIGEN_DEVICE_FUNC Index cols() const {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index rows, Index cols) { m_rows = rows; m_cols = cols; } + EIGEN_DEVICE_FUNC void resize(Index, Index rows, Index cols) { m_rows = rows; m_cols = cols; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// dynamic-size matrix with fixed-size storage and fixed width +template class DenseStorage +{ + internal::plain_array m_data; + Index m_rows; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_rows(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_rows(other.m_rows) + { + internal::plain_array_helper::copy(other.m_data, m_rows * _Cols, m_data); + } + + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_rows = other.m_rows; + internal::plain_array_helper::copy(other.m_data, m_rows * _Cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index rows, Index) : m_rows(rows) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + internal::plain_array_helper::swap(m_data, m_rows * _Cols, other.m_data, other.m_rows * _Cols); + numext::swap(m_rows, other.m_rows); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols(void) const EIGEN_NOEXCEPT {return _Cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index rows, Index) { m_rows = rows; } + EIGEN_DEVICE_FUNC void resize(Index, Index rows, Index) { m_rows = rows; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// dynamic-size matrix with fixed-size storage and fixed height +template class DenseStorage +{ + internal::plain_array m_data; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(internal::constructor_without_unaligned_array_assert()), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::constructor_without_unaligned_array_assert()), m_cols(other.m_cols) + { + internal::plain_array_helper::copy(other.m_data, _Rows * m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + m_cols = other.m_cols; + internal::plain_array_helper::copy(other.m_data, _Rows * m_cols, m_data); + } + return *this; + } + EIGEN_DEVICE_FUNC DenseStorage(Index, Index, Index cols) : m_cols(cols) {} + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + internal::plain_array_helper::swap(m_data, _Rows * m_cols, other.m_data, _Rows * other.m_cols); + numext::swap(m_cols, other.m_cols); + } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows(void) const EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index, Index, Index cols) { m_cols = cols; } + EIGEN_DEVICE_FUNC void resize(Index, Index, Index cols) { m_cols = cols; } + EIGEN_DEVICE_FUNC const T *data() const { return m_data.array; } + EIGEN_DEVICE_FUNC T *data() { return m_data.array; } +}; + +// purely dynamic matrix. +template class DenseStorage +{ + T *m_data; + Index m_rows; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC explicit DenseStorage(internal::constructor_without_unaligned_array_assert) + : m_data(0), m_rows(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) + : m_data(internal::conditional_aligned_new_auto(size)), m_rows(rows), m_cols(cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows>=0 && cols >=0); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(other.m_rows*other.m_cols)) + , m_rows(other.m_rows) + , m_cols(other.m_cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_rows*m_cols) + internal::smart_copy(other.m_data, other.m_data+other.m_rows*other.m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_rows(std::move(other.m_rows)) + , m_cols(std::move(other.m_cols)) + { + other.m_data = nullptr; + other.m_rows = 0; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + numext::swap(m_cols, other.m_cols); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, m_rows*m_cols); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) + { + numext::swap(m_data,other.m_data); + numext::swap(m_rows,other.m_rows); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + void conservativeResize(Index size, Index rows, Index cols) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, m_rows*m_cols); + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC void resize(Index size, Index rows, Index cols) + { + if(size != m_rows*m_cols) + { + internal::conditional_aligned_delete_auto(m_data, m_rows*m_cols); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + m_cols = cols; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +// matrix with dynamic width and fixed height (so that matrix has dynamic size). +template class DenseStorage +{ + T *m_data; + Index m_cols; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_cols(0) {} + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) : m_data(0), m_cols(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) : m_data(internal::conditional_aligned_new_auto(size)), m_cols(cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows==_Rows && cols >=0); + EIGEN_UNUSED_VARIABLE(rows); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(_Rows*other.m_cols)) + , m_cols(other.m_cols) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_cols*_Rows) + internal::smart_copy(other.m_data, other.m_data+_Rows*m_cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_cols(std::move(other.m_cols)) + { + other.m_data = nullptr; + other.m_cols = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_cols, other.m_cols); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, _Rows*m_cols); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data,other.m_data); + numext::swap(m_cols,other.m_cols); + } + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index rows(void) EIGEN_NOEXCEPT {return _Rows;} + EIGEN_DEVICE_FUNC Index cols(void) const EIGEN_NOEXCEPT {return m_cols;} + EIGEN_DEVICE_FUNC void conservativeResize(Index size, Index, Index cols) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, _Rows*m_cols); + m_cols = cols; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resize(Index size, Index, Index cols) + { + if(size != _Rows*m_cols) + { + internal::conditional_aligned_delete_auto(m_data, _Rows*m_cols); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_cols = cols; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +// matrix with dynamic height and fixed width (so that matrix has dynamic size). +template class DenseStorage +{ + T *m_data; + Index m_rows; + public: + EIGEN_DEVICE_FUNC DenseStorage() : m_data(0), m_rows(0) {} + explicit DenseStorage(internal::constructor_without_unaligned_array_assert) : m_data(0), m_rows(0) {} + EIGEN_DEVICE_FUNC DenseStorage(Index size, Index rows, Index cols) : m_data(internal::conditional_aligned_new_auto(size)), m_rows(rows) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + eigen_internal_assert(size==rows*cols && rows>=0 && cols == _Cols); + EIGEN_UNUSED_VARIABLE(cols); + } + EIGEN_DEVICE_FUNC DenseStorage(const DenseStorage& other) + : m_data(internal::conditional_aligned_new_auto(other.m_rows*_Cols)) + , m_rows(other.m_rows) + { + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN(Index size = m_rows*_Cols) + internal::smart_copy(other.m_data, other.m_data+other.m_rows*_Cols, m_data); + } + EIGEN_DEVICE_FUNC DenseStorage& operator=(const DenseStorage& other) + { + if (this != &other) + { + DenseStorage tmp(other); + this->swap(tmp); + } + return *this; + } +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + DenseStorage(DenseStorage&& other) EIGEN_NOEXCEPT + : m_data(std::move(other.m_data)) + , m_rows(std::move(other.m_rows)) + { + other.m_data = nullptr; + other.m_rows = 0; + } + EIGEN_DEVICE_FUNC + DenseStorage& operator=(DenseStorage&& other) EIGEN_NOEXCEPT + { + numext::swap(m_data, other.m_data); + numext::swap(m_rows, other.m_rows); + return *this; + } +#endif + EIGEN_DEVICE_FUNC ~DenseStorage() { internal::conditional_aligned_delete_auto(m_data, _Cols*m_rows); } + EIGEN_DEVICE_FUNC void swap(DenseStorage& other) { + numext::swap(m_data,other.m_data); + numext::swap(m_rows,other.m_rows); + } + EIGEN_DEVICE_FUNC Index rows(void) const EIGEN_NOEXCEPT {return m_rows;} + EIGEN_DEVICE_FUNC static EIGEN_CONSTEXPR Index cols(void) {return _Cols;} + void conservativeResize(Index size, Index rows, Index) + { + m_data = internal::conditional_aligned_realloc_new_auto(m_data, size, m_rows*_Cols); + m_rows = rows; + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void resize(Index size, Index rows, Index) + { + if(size != m_rows*_Cols) + { + internal::conditional_aligned_delete_auto(m_data, _Cols*m_rows); + if (size>0) // >0 and not simply !=0 to let the compiler knows that size cannot be negative + m_data = internal::conditional_aligned_new_auto(size); + else + m_data = 0; + EIGEN_INTERNAL_DENSE_STORAGE_CTOR_PLUGIN({}) + } + m_rows = rows; + } + EIGEN_DEVICE_FUNC const T *data() const { return m_data; } + EIGEN_DEVICE_FUNC T *data() { return m_data; } +}; + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h b/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h new file mode 100644 index 0000000..3112d2c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Diagonal.h @@ -0,0 +1,258 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2009 Benoit Jacob +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONAL_H +#define EIGEN_DIAGONAL_H + +namespace Eigen { + +/** \class Diagonal + * \ingroup Core_Module + * + * \brief Expression of a diagonal/subdiagonal/superdiagonal in a matrix + * + * \param MatrixType the type of the object in which we are taking a sub/main/super diagonal + * \param DiagIndex the index of the sub/super diagonal. The default is 0 and it means the main diagonal. + * A positive value means a superdiagonal, a negative value means a subdiagonal. + * You can also use DynamicIndex so the index can be set at runtime. + * + * The matrix is not required to be square. + * + * This class represents an expression of the main diagonal, or any sub/super diagonal + * of a square matrix. It is the return type of MatrixBase::diagonal() and MatrixBase::diagonal(Index) and most of the + * time this is the only way it is used. + * + * \sa MatrixBase::diagonal(), MatrixBase::diagonal(Index) + */ + +namespace internal { +template +struct traits > + : traits +{ + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + typedef typename MatrixType::StorageKind StorageKind; + enum { + RowsAtCompileTime = (int(DiagIndex) == DynamicIndex || int(MatrixType::SizeAtCompileTime) == Dynamic) ? Dynamic + : (EIGEN_PLAIN_ENUM_MIN(MatrixType::RowsAtCompileTime - EIGEN_PLAIN_ENUM_MAX(-DiagIndex, 0), + MatrixType::ColsAtCompileTime - EIGEN_PLAIN_ENUM_MAX( DiagIndex, 0))), + ColsAtCompileTime = 1, + MaxRowsAtCompileTime = int(MatrixType::MaxSizeAtCompileTime) == Dynamic ? Dynamic + : DiagIndex == DynamicIndex ? EIGEN_SIZE_MIN_PREFER_FIXED(MatrixType::MaxRowsAtCompileTime, + MatrixType::MaxColsAtCompileTime) + : (EIGEN_PLAIN_ENUM_MIN(MatrixType::MaxRowsAtCompileTime - EIGEN_PLAIN_ENUM_MAX(-DiagIndex, 0), + MatrixType::MaxColsAtCompileTime - EIGEN_PLAIN_ENUM_MAX( DiagIndex, 0))), + MaxColsAtCompileTime = 1, + MaskLvalueBit = is_lvalue::value ? LvalueBit : 0, + Flags = (unsigned int)_MatrixTypeNested::Flags & (RowMajorBit | MaskLvalueBit | DirectAccessBit) & ~RowMajorBit, // FIXME DirectAccessBit should not be handled by expressions + MatrixTypeOuterStride = outer_stride_at_compile_time::ret, + InnerStrideAtCompileTime = MatrixTypeOuterStride == Dynamic ? Dynamic : MatrixTypeOuterStride+1, + OuterStrideAtCompileTime = 0 + }; +}; +} + +template class Diagonal + : public internal::dense_xpr_base< Diagonal >::type +{ + public: + + enum { DiagIndex = _DiagIndex }; + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Diagonal) + + EIGEN_DEVICE_FUNC + explicit inline Diagonal(MatrixType& matrix, Index a_index = DiagIndex) : m_matrix(matrix), m_index(a_index) + { + eigen_assert( a_index <= m_matrix.cols() && -a_index <= m_matrix.rows() ); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Diagonal) + + EIGEN_DEVICE_FUNC + inline Index rows() const + { + return m_index.value()<0 ? numext::mini(m_matrix.cols(),m_matrix.rows()+m_index.value()) + : numext::mini(m_matrix.rows(),m_matrix.cols()-m_index.value()); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return 1; } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { + return m_matrix.outerStride() + 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return 0; } + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return &(m_matrix.coeffRef(rowOffset(), colOffset())); } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index row, Index) + { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index row, Index) const + { + return m_matrix.coeffRef(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline CoeffReturnType coeff(Index row, Index) const + { + return m_matrix.coeff(row+rowOffset(), row+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index idx) + { + EIGEN_STATIC_ASSERT_LVALUE(MatrixType) + return m_matrix.coeffRef(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index idx) const + { + return m_matrix.coeffRef(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline CoeffReturnType coeff(Index idx) const + { + return m_matrix.coeff(idx+rowOffset(), idx+colOffset()); + } + + EIGEN_DEVICE_FUNC + inline const typename internal::remove_all::type& + nestedExpression() const + { + return m_matrix; + } + + EIGEN_DEVICE_FUNC + inline Index index() const + { + return m_index.value(); + } + + protected: + typename internal::ref_selector::non_const_type m_matrix; + const internal::variable_if_dynamicindex m_index; + + private: + // some compilers may fail to optimize std::max etc in case of compile-time constants... + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index absDiagIndex() const EIGEN_NOEXCEPT { return m_index.value()>0 ? m_index.value() : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rowOffset() const EIGEN_NOEXCEPT { return m_index.value()>0 ? 0 : -m_index.value(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index colOffset() const EIGEN_NOEXCEPT { return m_index.value()>0 ? m_index.value() : 0; } + // trigger a compile-time error if someone try to call packet + template typename MatrixType::PacketReturnType packet(Index) const; + template typename MatrixType::PacketReturnType packet(Index,Index) const; +}; + +/** \returns an expression of the main diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * Example: \include MatrixBase_diagonal.cpp + * Output: \verbinclude MatrixBase_diagonal.out + * + * \sa class Diagonal */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::DiagonalReturnType +MatrixBase::diagonal() +{ + return DiagonalReturnType(derived()); +} + +/** This is the const version of diagonal(). */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::ConstDiagonalReturnType +MatrixBase::diagonal() const +{ + return ConstDiagonalReturnType(derived()); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_int.cpp + * Output: \verbinclude MatrixBase_diagonal_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::DiagonalDynamicIndexReturnType +MatrixBase::diagonal(Index index) +{ + return DiagonalDynamicIndexReturnType(derived(), index); +} + +/** This is the const version of diagonal(Index). */ +template +EIGEN_DEVICE_FUNC inline typename MatrixBase::ConstDiagonalDynamicIndexReturnType +MatrixBase::diagonal(Index index) const +{ + return ConstDiagonalDynamicIndexReturnType(derived(), index); +} + +/** \returns an expression of the \a DiagIndex-th sub or super diagonal of the matrix \c *this + * + * \c *this is not required to be square. + * + * The template parameter \a DiagIndex represent a super diagonal if \a DiagIndex > 0 + * and a sub diagonal otherwise. \a DiagIndex == 0 is equivalent to the main diagonal. + * + * Example: \include MatrixBase_diagonal_template_int.cpp + * Output: \verbinclude MatrixBase_diagonal_template_int.out + * + * \sa MatrixBase::diagonal(), class Diagonal */ +template +template +EIGEN_DEVICE_FUNC +inline typename MatrixBase::template DiagonalIndexReturnType::Type +MatrixBase::diagonal() +{ + return typename DiagonalIndexReturnType::Type(derived()); +} + +/** This is the const version of diagonal(). */ +template +template +EIGEN_DEVICE_FUNC +inline typename MatrixBase::template ConstDiagonalIndexReturnType::Type +MatrixBase::diagonal() const +{ + return typename ConstDiagonalIndexReturnType::Type(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONAL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h new file mode 100644 index 0000000..542685c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DiagonalMatrix.h @@ -0,0 +1,391 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALMATRIX_H +#define EIGEN_DIAGONALMATRIX_H + +namespace Eigen { + +#ifndef EIGEN_PARSED_BY_DOXYGEN +template +class DiagonalBase : public EigenBase +{ + public: + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::RealScalar RealScalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + IsVectorAtCompileTime = 0, + Flags = NoPreferredStorageOrderBit + }; + + typedef Matrix DenseMatrixType; + typedef DenseMatrixType DenseType; + typedef DiagonalMatrix PlainObject; + + EIGEN_DEVICE_FUNC + inline const Derived& derived() const { return *static_cast(this); } + EIGEN_DEVICE_FUNC + inline Derived& derived() { return *static_cast(this); } + + EIGEN_DEVICE_FUNC + DenseMatrixType toDenseMatrix() const { return derived(); } + + EIGEN_DEVICE_FUNC + inline const DiagonalVectorType& diagonal() const { return derived().diagonal(); } + EIGEN_DEVICE_FUNC + inline DiagonalVectorType& diagonal() { return derived().diagonal(); } + + EIGEN_DEVICE_FUNC + inline Index rows() const { return diagonal().size(); } + EIGEN_DEVICE_FUNC + inline Index cols() const { return diagonal().size(); } + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const MatrixBase &matrix) const + { + return Product(derived(),matrix.derived()); + } + + typedef DiagonalWrapper, const DiagonalVectorType> > InverseReturnType; + EIGEN_DEVICE_FUNC + inline const InverseReturnType + inverse() const + { + return InverseReturnType(diagonal().cwiseInverse()); + } + + EIGEN_DEVICE_FUNC + inline const DiagonalWrapper + operator*(const Scalar& scalar) const + { + return DiagonalWrapper(diagonal() * scalar); + } + EIGEN_DEVICE_FUNC + friend inline const DiagonalWrapper + operator*(const Scalar& scalar, const DiagonalBase& other) + { + return DiagonalWrapper(scalar * other.diagonal()); + } + + template + EIGEN_DEVICE_FUNC + #ifdef EIGEN_PARSED_BY_DOXYGEN + inline unspecified_expression_type + #else + inline const DiagonalWrapper + #endif + operator+(const DiagonalBase& other) const + { + return (diagonal() + other.diagonal()).asDiagonal(); + } + + template + EIGEN_DEVICE_FUNC + #ifdef EIGEN_PARSED_BY_DOXYGEN + inline unspecified_expression_type + #else + inline const DiagonalWrapper + #endif + operator-(const DiagonalBase& other) const + { + return (diagonal() - other.diagonal()).asDiagonal(); + } +}; + +#endif + +/** \class DiagonalMatrix + * \ingroup Core_Module + * + * \brief Represents a diagonal matrix with its storage + * + * \param _Scalar the type of coefficients + * \param SizeAtCompileTime the dimension of the matrix, or Dynamic + * \param MaxSizeAtCompileTime the dimension of the matrix, or Dynamic. This parameter is optional and defaults + * to SizeAtCompileTime. Most of the time, you do not need to specify it. + * + * \sa class DiagonalWrapper + */ + +namespace internal { +template +struct traits > + : traits > +{ + typedef Matrix<_Scalar,SizeAtCompileTime,1,0,MaxSizeAtCompileTime,1> DiagonalVectorType; + typedef DiagonalShape StorageKind; + enum { + Flags = LvalueBit | NoPreferredStorageOrderBit + }; +}; +} +template +class DiagonalMatrix + : public DiagonalBase > +{ + public: + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename internal::traits::DiagonalVectorType DiagonalVectorType; + typedef const DiagonalMatrix& Nested; + typedef _Scalar Scalar; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + #endif + + protected: + + DiagonalVectorType m_diagonal; + + public: + + /** const version of diagonal(). */ + EIGEN_DEVICE_FUNC + inline const DiagonalVectorType& diagonal() const { return m_diagonal; } + /** \returns a reference to the stored vector of diagonal coefficients. */ + EIGEN_DEVICE_FUNC + inline DiagonalVectorType& diagonal() { return m_diagonal; } + + /** Default constructor without initialization */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix() {} + + /** Constructs a diagonal matrix with given dimension */ + EIGEN_DEVICE_FUNC + explicit inline DiagonalMatrix(Index dim) : m_diagonal(dim) {} + + /** 2D constructor. */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const Scalar& x, const Scalar& y) : m_diagonal(x,y) {} + + /** 3D constructor. */ + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const Scalar& x, const Scalar& y, const Scalar& z) : m_diagonal(x,y,z) {} + + #if EIGEN_HAS_CXX11 + /** \brief Construct a diagonal matrix with fixed size from an arbitrary number of coefficients. \cpp11 + * + * There exists C++98 anologue constructors for fixed-size diagonal matrices having 2 or 3 coefficients. + * + * \warning To construct a diagonal matrix of fixed size, the number of values passed to this + * constructor must match the fixed dimension of \c *this. + * + * \sa DiagonalMatrix(const Scalar&, const Scalar&) + * \sa DiagonalMatrix(const Scalar&, const Scalar&, const Scalar&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + DiagonalMatrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const ArgTypes&... args) + : m_diagonal(a0, a1, a2, args...) {} + + /** \brief Constructs a DiagonalMatrix and initializes it by elements given by an initializer list of initializer + * lists \cpp11 + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE DiagonalMatrix(const std::initializer_list>& list) + : m_diagonal(list) {} + #endif // EIGEN_HAS_CXX11 + + /** Copy constructor. */ + template + EIGEN_DEVICE_FUNC + inline DiagonalMatrix(const DiagonalBase& other) : m_diagonal(other.diagonal()) {} + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** copy constructor. prevent a default copy constructor from hiding the other templated constructor */ + inline DiagonalMatrix(const DiagonalMatrix& other) : m_diagonal(other.diagonal()) {} + #endif + + /** generic constructor from expression of the diagonal coefficients */ + template + EIGEN_DEVICE_FUNC + explicit inline DiagonalMatrix(const MatrixBase& other) : m_diagonal(other) + {} + + /** Copy operator. */ + template + EIGEN_DEVICE_FUNC + DiagonalMatrix& operator=(const DiagonalBase& other) + { + m_diagonal = other.diagonal(); + return *this; + } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + DiagonalMatrix& operator=(const DiagonalMatrix& other) + { + m_diagonal = other.diagonal(); + return *this; + } + #endif + + /** Resizes to given size. */ + EIGEN_DEVICE_FUNC + inline void resize(Index size) { m_diagonal.resize(size); } + /** Sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC + inline void setZero() { m_diagonal.setZero(); } + /** Resizes and sets all coefficients to zero. */ + EIGEN_DEVICE_FUNC + inline void setZero(Index size) { m_diagonal.setZero(size); } + /** Sets this matrix to be the identity matrix of the current size. */ + EIGEN_DEVICE_FUNC + inline void setIdentity() { m_diagonal.setOnes(); } + /** Sets this matrix to be the identity matrix of the given size. */ + EIGEN_DEVICE_FUNC + inline void setIdentity(Index size) { m_diagonal.setOnes(size); } +}; + +/** \class DiagonalWrapper + * \ingroup Core_Module + * + * \brief Expression of a diagonal matrix + * + * \param _DiagonalVectorType the type of the vector of diagonal coefficients + * + * This class is an expression of a diagonal matrix, but not storing its own vector of diagonal coefficients, + * instead wrapping an existing vector expression. It is the return type of MatrixBase::asDiagonal() + * and most of the time this is the only way that it is used. + * + * \sa class DiagonalMatrix, class DiagonalBase, MatrixBase::asDiagonal() + */ + +namespace internal { +template +struct traits > +{ + typedef _DiagonalVectorType DiagonalVectorType; + typedef typename DiagonalVectorType::Scalar Scalar; + typedef typename DiagonalVectorType::StorageIndex StorageIndex; + typedef DiagonalShape StorageKind; + typedef typename traits::XprKind XprKind; + enum { + RowsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + ColsAtCompileTime = DiagonalVectorType::SizeAtCompileTime, + MaxRowsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = DiagonalVectorType::MaxSizeAtCompileTime, + Flags = (traits::Flags & LvalueBit) | NoPreferredStorageOrderBit + }; +}; +} + +template +class DiagonalWrapper + : public DiagonalBase >, internal::no_assignment_operator +{ + public: + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef _DiagonalVectorType DiagonalVectorType; + typedef DiagonalWrapper Nested; + #endif + + /** Constructor from expression of diagonal coefficients to wrap. */ + EIGEN_DEVICE_FUNC + explicit inline DiagonalWrapper(DiagonalVectorType& a_diagonal) : m_diagonal(a_diagonal) {} + + /** \returns a const reference to the wrapped expression of diagonal coefficients. */ + EIGEN_DEVICE_FUNC + const DiagonalVectorType& diagonal() const { return m_diagonal; } + + protected: + typename DiagonalVectorType::Nested m_diagonal; +}; + +/** \returns a pseudo-expression of a diagonal matrix with *this as vector of diagonal coefficients + * + * \only_for_vectors + * + * Example: \include MatrixBase_asDiagonal.cpp + * Output: \verbinclude MatrixBase_asDiagonal.out + * + * \sa class DiagonalWrapper, class DiagonalMatrix, diagonal(), isDiagonal() + **/ +template +EIGEN_DEVICE_FUNC inline const DiagonalWrapper +MatrixBase::asDiagonal() const +{ + return DiagonalWrapper(derived()); +} + +/** \returns true if *this is approximately equal to a diagonal matrix, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isDiagonal.cpp + * Output: \verbinclude MatrixBase_isDiagonal.out + * + * \sa asDiagonal() + */ +template +bool MatrixBase::isDiagonal(const RealScalar& prec) const +{ + if(cols() != rows()) return false; + RealScalar maxAbsOnDiagonal = static_cast(-1); + for(Index j = 0; j < cols(); ++j) + { + RealScalar absOnDiagonal = numext::abs(coeff(j,j)); + if(absOnDiagonal > maxAbsOnDiagonal) maxAbsOnDiagonal = absOnDiagonal; + } + for(Index j = 0; j < cols(); ++j) + for(Index i = 0; i < j; ++i) + { + if(!internal::isMuchSmallerThan(coeff(i, j), maxAbsOnDiagonal, prec)) return false; + if(!internal::isMuchSmallerThan(coeff(j, i), maxAbsOnDiagonal, prec)) return false; + } + return true; +} + +namespace internal { + +template<> struct storage_kind_to_shape { typedef DiagonalShape Shape; }; + +struct Diagonal2Dense {}; + +template<> struct AssignmentKind { typedef Diagonal2Dense Kind; }; + +// Diagonal matrix to Dense assignment +template< typename DstXprType, typename SrcXprType, typename Functor> +struct Assignment +{ + static void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &/*func*/) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + + dst.setZero(); + dst.diagonal() = src.diagonal(); + } + + static void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &/*func*/) + { dst.diagonal() += src.diagonal(); } + + static void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &/*func*/) + { dst.diagonal() -= src.diagonal(); } +}; + +} // namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h b/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h new file mode 100644 index 0000000..7911d1c --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/DiagonalProduct.h @@ -0,0 +1,28 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2007-2009 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DIAGONALPRODUCT_H +#define EIGEN_DIAGONALPRODUCT_H + +namespace Eigen { + +/** \returns the diagonal matrix product of \c *this by the diagonal matrix \a diagonal. + */ +template +template +EIGEN_DEVICE_FUNC inline const Product +MatrixBase::operator*(const DiagonalBase &a_diagonal) const +{ + return Product(derived(),a_diagonal.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_DIAGONALPRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Dot.h b/src/3rdparty/eigen/Eigen/src/Core/Dot.h new file mode 100644 index 0000000..5c3441b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Dot.h @@ -0,0 +1,318 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008, 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DOT_H +#define EIGEN_DOT_H + +namespace Eigen { + +namespace internal { + +// helper function for dot(). The problem is that if we put that in the body of dot(), then upon calling dot +// with mismatched types, the compiler emits errors about failing to instantiate cwiseProduct BEFORE +// looking at the static assertions. Thus this is a trick to get better compile errors. +template +struct dot_nocheck +{ + typedef scalar_conj_product_op::Scalar,typename traits::Scalar> conj_prod; + typedef typename conj_prod::result_type ResScalar; + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE + static ResScalar run(const MatrixBase& a, const MatrixBase& b) + { + return a.template binaryExpr(b).sum(); + } +}; + +template +struct dot_nocheck +{ + typedef scalar_conj_product_op::Scalar,typename traits::Scalar> conj_prod; + typedef typename conj_prod::result_type ResScalar; + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE + static ResScalar run(const MatrixBase& a, const MatrixBase& b) + { + return a.transpose().template binaryExpr(b).sum(); + } +}; + +} // end namespace internal + +/** \fn MatrixBase::dot + * \returns the dot product of *this with other. + * + * \only_for_vectors + * + * \note If the scalar type is complex numbers, then this function returns the hermitian + * (sesquilinear) dot product, conjugate-linear in the first variable and linear in the + * second variable. + * + * \sa squaredNorm(), norm() + */ +template +template +EIGEN_DEVICE_FUNC +EIGEN_STRONG_INLINE +typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType +MatrixBase::dot(const MatrixBase& other) const +{ + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + EIGEN_STATIC_ASSERT_VECTOR_ONLY(OtherDerived) + EIGEN_STATIC_ASSERT_SAME_VECTOR_SIZE(Derived,OtherDerived) +#if !(defined(EIGEN_NO_STATIC_ASSERT) && defined(EIGEN_NO_DEBUG)) + typedef internal::scalar_conj_product_op func; + EIGEN_CHECK_BINARY_COMPATIBILIY(func,Scalar,typename OtherDerived::Scalar); +#endif + + eigen_assert(size() == other.size()); + + return internal::dot_nocheck::run(*this, other); +} + +//---------- implementation of L2 norm and related functions ---------- + +/** \returns, for vectors, the squared \em l2 norm of \c *this, and for matrices the squared Frobenius norm. + * In both cases, it consists in the sum of the square of all the matrix entries. + * For vectors, this is also equals to the dot product of \c *this with itself. + * + * \sa dot(), norm(), lpNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real MatrixBase::squaredNorm() const +{ + return numext::real((*this).cwiseAbs2().sum()); +} + +/** \returns, for vectors, the \em l2 norm of \c *this, and for matrices the Frobenius norm. + * In both cases, it consists in the square root of the sum of the square of all the matrix entries. + * For vectors, this is also equals to the square root of the dot product of \c *this with itself. + * + * \sa lpNorm(), dot(), squaredNorm() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename NumTraits::Scalar>::Real MatrixBase::norm() const +{ + return numext::sqrt(squaredNorm()); +} + +/** \returns an expression of the quotient of \c *this by its own norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \only_for_vectors + * + * \sa norm(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject +MatrixBase::normalized() const +{ + typedef typename internal::nested_eval::type _Nested; + _Nested n(derived()); + RealScalar z = n.squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if(z>RealScalar(0)) + return n / numext::sqrt(z); + else + return n; +} + +/** Normalizes the vector, i.e. divides it by its own norm. + * + * \only_for_vectors + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa norm(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::normalize() +{ + RealScalar z = squaredNorm(); + // NOTE: after extensive benchmarking, this conditional does not impact performance, at least on recent x86 CPU + if(z>RealScalar(0)) + derived() /= numext::sqrt(z); +} + +/** \returns an expression of the quotient of \c *this by its own norm while avoiding underflow and overflow. + * + * \only_for_vectors + * + * This method is analogue to the normalized() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), + * then this function returns a copy of the input. + * + * \sa stableNorm(), stableNormalize(), normalized() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const typename MatrixBase::PlainObject +MatrixBase::stableNormalized() const +{ + typedef typename internal::nested_eval::type _Nested; + _Nested n(derived()); + RealScalar w = n.cwiseAbs().maxCoeff(); + RealScalar z = (n/w).squaredNorm(); + if(z>RealScalar(0)) + return n / (numext::sqrt(z)*w); + else + return n; +} + +/** Normalizes the vector while avoid underflow and overflow + * + * \only_for_vectors + * + * This method is analogue to the normalize() method, but it reduces the risk of + * underflow and overflow when computing the norm. + * + * \warning If the input vector is too small (i.e., this->norm()==0), then \c *this is left unchanged. + * + * \sa stableNorm(), stableNormalized(), normalize() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void MatrixBase::stableNormalize() +{ + RealScalar w = cwiseAbs().maxCoeff(); + RealScalar z = (derived()/w).squaredNorm(); + if(z>RealScalar(0)) + derived() /= numext::sqrt(z)*w; +} + +//---------- implementation of other norms ---------- + +namespace internal { + +template +struct lpNorm_selector +{ + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const MatrixBase& m) + { + EIGEN_USING_STD(pow) + return pow(m.cwiseAbs().array().pow(p).sum(), RealScalar(1)/p); + } +}; + +template +struct lpNorm_selector +{ + EIGEN_DEVICE_FUNC + static inline typename NumTraits::Scalar>::Real run(const MatrixBase& m) + { + return m.cwiseAbs().sum(); + } +}; + +template +struct lpNorm_selector +{ + EIGEN_DEVICE_FUNC + static inline typename NumTraits::Scalar>::Real run(const MatrixBase& m) + { + return m.norm(); + } +}; + +template +struct lpNorm_selector +{ + typedef typename NumTraits::Scalar>::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const MatrixBase& m) + { + if(Derived::SizeAtCompileTime==0 || (Derived::SizeAtCompileTime==Dynamic && m.size()==0)) + return RealScalar(0); + return m.cwiseAbs().maxCoeff(); + } +}; + +} // end namespace internal + +/** \returns the \b coefficient-wise \f$ \ell^p \f$ norm of \c *this, that is, returns the p-th root of the sum of the p-th powers of the absolute values + * of the coefficients of \c *this. If \a p is the special value \a Eigen::Infinity, this function returns the \f$ \ell^\infty \f$ + * norm, that is the maximum of the absolute values of the coefficients of \c *this. + * + * In all cases, if \c *this is empty, then the value 0 is returned. + * + * \note For matrices, this function does not compute the operator-norm. That is, if \c *this is a matrix, then its coefficients are interpreted as a 1D vector. Nonetheless, you can easily compute the 1-norm and \f$\infty\f$-norm matrix operator norms using \link TutorialReductionsVisitorsBroadcastingReductionsNorm partial reductions \endlink. + * + * \sa norm() + */ +template +template +#ifndef EIGEN_PARSED_BY_DOXYGEN +EIGEN_DEVICE_FUNC inline typename NumTraits::Scalar>::Real +#else +EIGEN_DEVICE_FUNC MatrixBase::RealScalar +#endif +MatrixBase::lpNorm() const +{ + return internal::lpNorm_selector::run(*this); +} + +//---------- implementation of isOrthogonal / isUnitary ---------- + +/** \returns true if *this is approximately orthogonal to \a other, + * within the precision given by \a prec. + * + * Example: \include MatrixBase_isOrthogonal.cpp + * Output: \verbinclude MatrixBase_isOrthogonal.out + */ +template +template +bool MatrixBase::isOrthogonal +(const MatrixBase& other, const RealScalar& prec) const +{ + typename internal::nested_eval::type nested(derived()); + typename internal::nested_eval::type otherNested(other.derived()); + return numext::abs2(nested.dot(otherNested)) <= prec * prec * nested.squaredNorm() * otherNested.squaredNorm(); +} + +/** \returns true if *this is approximately an unitary matrix, + * within the precision given by \a prec. In the case where the \a Scalar + * type is real numbers, a unitary matrix is an orthogonal matrix, whence the name. + * + * \note This can be used to check whether a family of vectors forms an orthonormal basis. + * Indeed, \c m.isUnitary() returns true if and only if the columns (equivalently, the rows) of m form an + * orthonormal basis. + * + * Example: \include MatrixBase_isUnitary.cpp + * Output: \verbinclude MatrixBase_isUnitary.out + */ +template +bool MatrixBase::isUnitary(const RealScalar& prec) const +{ + typename internal::nested_eval::type self(derived()); + for(Index i = 0; i < cols(); ++i) + { + if(!internal::isApprox(self.col(i).squaredNorm(), static_cast(1), prec)) + return false; + for(Index j = 0; j < i; ++j) + if(!internal::isMuchSmallerThan(self.col(i).dot(self.col(j)), static_cast(1), prec)) + return false; + } + return true; +} + +} // end namespace Eigen + +#endif // EIGEN_DOT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h b/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h new file mode 100644 index 0000000..6b3c7d3 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/EigenBase.h @@ -0,0 +1,160 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_EIGENBASE_H +#define EIGEN_EIGENBASE_H + +namespace Eigen { + +/** \class EigenBase + * \ingroup Core_Module + * + * Common base class for all classes T such that MatrixBase has an operator=(T) and a constructor MatrixBase(T). + * + * In other words, an EigenBase object is an object that can be copied into a MatrixBase. + * + * Besides MatrixBase-derived classes, this also includes special matrix classes such as diagonal matrices, etc. + * + * Notice that this class is trivial, it is only used to disambiguate overloaded functions. + * + * \sa \blank \ref TopicClassHierarchy + */ +template struct EigenBase +{ +// typedef typename internal::plain_matrix_type::type PlainObject; + + /** \brief The interface type of indices + * \details To change this, \c \#define the preprocessor symbol \c EIGEN_DEFAULT_DENSE_INDEX_TYPE. + * \sa StorageIndex, \ref TopicPreprocessorDirectives. + * DEPRECATED: Since Eigen 3.3, its usage is deprecated. Use Eigen::Index instead. + * Deprecation is not marked with a doxygen comment because there are too many existing usages to add the deprecation attribute. + */ + typedef Eigen::Index Index; + + // FIXME is it needed? + typedef typename internal::traits::StorageKind StorageKind; + + /** \returns a reference to the derived object */ + EIGEN_DEVICE_FUNC + Derived& derived() { return *static_cast(this); } + /** \returns a const reference to the derived object */ + EIGEN_DEVICE_FUNC + const Derived& derived() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC + inline Derived& const_cast_derived() const + { return *static_cast(const_cast(this)); } + EIGEN_DEVICE_FUNC + inline const Derived& const_derived() const + { return *static_cast(this); } + + /** \returns the number of rows. \sa cols(), RowsAtCompileTime */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return derived().rows(); } + /** \returns the number of columns. \sa rows(), ColsAtCompileTime*/ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return derived().cols(); } + /** \returns the number of coefficients, which is rows()*cols(). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index size() const EIGEN_NOEXCEPT { return rows() * cols(); } + + /** \internal Don't use it, but do the equivalent: \code dst = *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const + { derived().evalTo(dst); } + + /** \internal Don't use it, but do the equivalent: \code dst += *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void addTo(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(),cols()); + evalTo(res); + dst += res; + } + + /** \internal Don't use it, but do the equivalent: \code dst -= *this; \endcode */ + template + EIGEN_DEVICE_FUNC + inline void subTo(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + typename Dest::PlainObject res(rows(),cols()); + evalTo(res); + dst -= res; + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheRight(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheRight(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = dst * this->derived(); + } + + /** \internal Don't use it, but do the equivalent: \code dst.applyOnTheLeft(*this); \endcode */ + template + EIGEN_DEVICE_FUNC inline void applyThisOnTheLeft(Dest& dst) const + { + // This is the default implementation, + // derived class can reimplement it in a more optimized way. + dst = this->derived() * dst; + } + +}; + +/*************************************************************************** +* Implementation of matrix base methods +***************************************************************************/ + +/** \brief Copies the generic expression \a other into *this. + * + * \details The expression must provide a (templated) evalTo(Derived& dst) const + * function which does the actual job. In practice, this allows any user to write + * its own special matrix without having to modify MatrixBase + * + * \returns a reference to *this. + */ +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator=(const EigenBase &other) +{ + call_assignment(derived(), other.derived()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator+=(const EigenBase &other) +{ + call_assignment(derived(), other.derived(), internal::add_assign_op()); + return derived(); +} + +template +template +EIGEN_DEVICE_FUNC +Derived& DenseBase::operator-=(const EigenBase &other) +{ + call_assignment(derived(), other.derived(), internal::sub_assign_op()); + return derived(); +} + +} // end namespace Eigen + +#endif // EIGEN_EIGENBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h b/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h new file mode 100644 index 0000000..817a43a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ForceAlignedAccess.h @@ -0,0 +1,150 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FORCEALIGNEDACCESS_H +#define EIGEN_FORCEALIGNEDACCESS_H + +namespace Eigen { + +/** \class ForceAlignedAccess + * \ingroup Core_Module + * + * \brief Enforce aligned packet loads and stores regardless of what is requested + * + * \param ExpressionType the type of the object of which we are forcing aligned packet access + * + * This class is the return type of MatrixBase::forceAlignedAccess() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::forceAlignedAccess() + */ + +namespace internal { +template +struct traits > : public traits +{}; +} + +template class ForceAlignedAccess + : public internal::dense_xpr_base< ForceAlignedAccess >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ForceAlignedAccess) + + EIGEN_DEVICE_FUNC explicit inline ForceAlignedAccess(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return m_expression.outerStride(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return m_expression.innerStride(); } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index row, Index col) const + { + return m_expression.coeff(row, col); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index row, Index col) + { + return m_expression.const_cast_derived().coeffRef(row, col); + } + + EIGEN_DEVICE_FUNC inline const CoeffReturnType coeff(Index index) const + { + return m_expression.coeff(index); + } + + EIGEN_DEVICE_FUNC inline Scalar& coeffRef(Index index) + { + return m_expression.const_cast_derived().coeffRef(index); + } + + template + inline const PacketScalar packet(Index row, Index col) const + { + return m_expression.template packet(row, col); + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& x) + { + m_expression.const_cast_derived().template writePacket(row, col, x); + } + + template + inline const PacketScalar packet(Index index) const + { + return m_expression.template packet(index); + } + + template + inline void writePacket(Index index, const PacketScalar& x) + { + m_expression.const_cast_derived().template writePacket(index, x); + } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + protected: + const ExpressionType& m_expression; + + private: + ForceAlignedAccess& operator=(const ForceAlignedAccess&); +}; + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(),class ForceAlignedAccess + */ +template +inline const ForceAlignedAccess +MatrixBase::forceAlignedAccess() const +{ + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access + * \sa forceAlignedAccessIf(), class ForceAlignedAccess + */ +template +inline ForceAlignedAccess +MatrixBase::forceAlignedAccess() +{ + return ForceAlignedAccess(derived()); +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline typename internal::add_const_on_value_type,Derived&>::type>::type +MatrixBase::forceAlignedAccessIf() const +{ + return derived(); // FIXME This should not work but apparently is never used +} + +/** \returns an expression of *this with forced aligned access if \a Enable is true. + * \sa forceAlignedAccess(), class ForceAlignedAccess + */ +template +template +inline typename internal::conditional,Derived&>::type +MatrixBase::forceAlignedAccessIf() +{ + return derived(); // FIXME This should not work but apparently is never used +} + +} // end namespace Eigen + +#endif // EIGEN_FORCEALIGNEDACCESS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h b/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h new file mode 100644 index 0000000..43aa49b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Fuzzy.h @@ -0,0 +1,155 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_FUZZY_H +#define EIGEN_FUZZY_H + +namespace Eigen { + +namespace internal +{ + +template::IsInteger> +struct isApprox_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) + { + typename internal::nested_eval::type nested(x); + typename internal::nested_eval::type otherNested(y); + return (nested - otherNested).cwiseAbs2().sum() <= prec * prec * numext::mini(nested.cwiseAbs2().sum(), otherNested.cwiseAbs2().sum()); + } +}; + +template +struct isApprox_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar&) + { + return x.matrix() == y.matrix(); + } +}; + +template::IsInteger> +struct isMuchSmallerThan_object_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived& y, const typename Derived::RealScalar& prec) + { + return x.cwiseAbs2().sum() <= numext::abs2(prec) * y.cwiseAbs2().sum(); + } +}; + +template +struct isMuchSmallerThan_object_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const OtherDerived&, const typename Derived::RealScalar&) + { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +template::IsInteger> +struct isMuchSmallerThan_scalar_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const typename Derived::RealScalar& y, const typename Derived::RealScalar& prec) + { + return x.cwiseAbs2().sum() <= numext::abs2(prec * y); + } +}; + +template +struct isMuchSmallerThan_scalar_selector +{ + EIGEN_DEVICE_FUNC + static bool run(const Derived& x, const typename Derived::RealScalar&, const typename Derived::RealScalar&) + { + return x.matrix() == Derived::Zero(x.rows(), x.cols()).matrix(); + } +}; + +} // end namespace internal + + +/** \returns \c true if \c *this is approximately equal to \a other, within the precision + * determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. Two vectors \f$ v \f$ and \f$ w \f$ + * are considered to be approximately equal within precision \f$ p \f$ if + * \f[ \Vert v - w \Vert \leqslant p\,\min(\Vert v\Vert, \Vert w\Vert). \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm (aka Frobenius norm + * L2 norm). + * + * \note Because of the multiplicativeness of this comparison, one can't use this function + * to check whether \c *this is approximately equal to the zero matrix or vector. + * Indeed, \c isApprox(zero) returns false unless \c *this itself is exactly the zero matrix + * or vector. If you want to test whether \c *this is zero, use internal::isMuchSmallerThan(const + * RealScalar&, RealScalar) instead. + * + * \sa internal::isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isApprox( + const DenseBase& other, + const RealScalar& prec +) const +{ + return internal::isApprox_selector::run(derived(), other.derived(), prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than \f$ x \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\vert x\vert. \f] + * + * For matrices, the comparison is done using the Hilbert-Schmidt norm. For this reason, + * the value of the reference scalar \a other should come from the Hilbert-Schmidt norm + * of a reference matrix of same dimensions. + * + * \sa isApprox(), isMuchSmallerThan(const DenseBase&, RealScalar) const + */ +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan( + const typename NumTraits::Real& other, + const RealScalar& prec +) const +{ + return internal::isMuchSmallerThan_scalar_selector::run(derived(), other, prec); +} + +/** \returns \c true if the norm of \c *this is much smaller than the norm of \a other, + * within the precision determined by \a prec. + * + * \note The fuzzy compares are done multiplicatively. A vector \f$ v \f$ is + * considered to be much smaller than a vector \f$ w \f$ within precision \f$ p \f$ if + * \f[ \Vert v \Vert \leqslant p\,\Vert w\Vert. \f] + * For matrices, the comparison is done using the Hilbert-Schmidt norm. + * + * \sa isApprox(), isMuchSmallerThan(const RealScalar&, RealScalar) const + */ +template +template +EIGEN_DEVICE_FUNC bool DenseBase::isMuchSmallerThan( + const DenseBase& other, + const RealScalar& prec +) const +{ + return internal::isMuchSmallerThan_object_selector::run(derived(), other.derived(), prec); +} + +} // end namespace Eigen + +#endif // EIGEN_FUZZY_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h b/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h new file mode 100644 index 0000000..6906aa7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GeneralProduct.h @@ -0,0 +1,465 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERAL_PRODUCT_H +#define EIGEN_GENERAL_PRODUCT_H + +namespace Eigen { + +enum { + Large = 2, + Small = 3 +}; + +// Define the threshold value to fallback from the generic matrix-matrix product +// implementation (heavy) to the lightweight coeff-based product one. +// See generic_product_impl +// in products/GeneralMatrixMatrix.h for more details. +// TODO This threshold should also be used in the compile-time selector below. +#ifndef EIGEN_GEMM_TO_COEFFBASED_THRESHOLD +// This default value has been obtained on a Haswell architecture. +#define EIGEN_GEMM_TO_COEFFBASED_THRESHOLD 20 +#endif + +namespace internal { + +template struct product_type_selector; + +template struct product_size_category +{ + enum { + #ifndef EIGEN_GPU_COMPILE_PHASE + is_large = MaxSize == Dynamic || + Size >= EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD || + (Size==Dynamic && MaxSize>=EIGEN_CACHEFRIENDLY_PRODUCT_THRESHOLD), + #else + is_large = 0, + #endif + value = is_large ? Large + : Size == 1 ? 1 + : Small + }; +}; + +template struct product_type +{ + typedef typename remove_all::type _Lhs; + typedef typename remove_all::type _Rhs; + enum { + MaxRows = traits<_Lhs>::MaxRowsAtCompileTime, + Rows = traits<_Lhs>::RowsAtCompileTime, + MaxCols = traits<_Rhs>::MaxColsAtCompileTime, + Cols = traits<_Rhs>::ColsAtCompileTime, + MaxDepth = EIGEN_SIZE_MIN_PREFER_FIXED(traits<_Lhs>::MaxColsAtCompileTime, + traits<_Rhs>::MaxRowsAtCompileTime), + Depth = EIGEN_SIZE_MIN_PREFER_FIXED(traits<_Lhs>::ColsAtCompileTime, + traits<_Rhs>::RowsAtCompileTime) + }; + + // the splitting into different lines of code here, introducing the _select enums and the typedef below, + // is to work around an internal compiler error with gcc 4.1 and 4.2. +private: + enum { + rows_select = product_size_category::value, + cols_select = product_size_category::value, + depth_select = product_size_category::value + }; + typedef product_type_selector selector; + +public: + enum { + value = selector::ret, + ret = selector::ret + }; +#ifdef EIGEN_DEBUG_PRODUCT + static void debug() + { + EIGEN_DEBUG_VAR(Rows); + EIGEN_DEBUG_VAR(Cols); + EIGEN_DEBUG_VAR(Depth); + EIGEN_DEBUG_VAR(rows_select); + EIGEN_DEBUG_VAR(cols_select); + EIGEN_DEBUG_VAR(depth_select); + EIGEN_DEBUG_VAR(value); + } +#endif +}; + +/* The following allows to select the kind of product at compile time + * based on the three dimensions of the product. + * This is a compile time mapping from {1,Small,Large}^3 -> {product types} */ +// FIXME I'm not sure the current mapping is the ideal one. +template struct product_type_selector { enum { ret = OuterProduct }; }; +template struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template struct product_type_selector<1, N, 1> { enum { ret = LazyCoeffBasedProductMode }; }; +template struct product_type_selector<1, 1, Depth> { enum { ret = InnerProduct }; }; +template<> struct product_type_selector<1, 1, 1> { enum { ret = InnerProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Small,Small> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = LazyCoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Large,Small> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector<1, Large,Large> { enum { ret = GemvProduct }; }; +template<> struct product_type_selector<1, Small,Large> { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemvProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = CoeffBasedProductMode }; }; +template<> struct product_type_selector { enum { ret = GemmProduct }; }; + +} // end namespace internal + +/*********************************************************************** +* Implementation of Inner Vector Vector Product +***********************************************************************/ + +// FIXME : maybe the "inner product" could return a Scalar +// instead of a 1x1 matrix ?? +// Pro: more natural for the user +// Cons: this could be a problem if in a meta unrolled algorithm a matrix-matrix +// product ends up to a row-vector times col-vector product... To tackle this use +// case, we could have a specialization for Block with: operator=(Scalar x); + +/*********************************************************************** +* Implementation of Outer Vector Vector Product +***********************************************************************/ + +/*********************************************************************** +* Implementation of General Matrix Vector Product +***********************************************************************/ + +/* According to the shape/flags of the matrix we have to distinghish 3 different cases: + * 1 - the matrix is col-major, BLAS compatible and M is large => call fast BLAS-like colmajor routine + * 2 - the matrix is row-major, BLAS compatible and N is large => call fast BLAS-like rowmajor routine + * 3 - all other cases are handled using a simple loop along the outer-storage direction. + * Therefore we need a lower level meta selector. + * Furthermore, if the matrix is the rhs, then the product has to be transposed. + */ +namespace internal { + +template +struct gemv_dense_selector; + +} // end namespace internal + +namespace internal { + +template struct gemv_static_vector_if; + +template +struct gemv_static_vector_if +{ + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Scalar* data() { eigen_internal_assert(false && "should never be called"); return 0; } +}; + +template +struct gemv_static_vector_if +{ + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Scalar* data() { return 0; } +}; + +template +struct gemv_static_vector_if +{ + enum { + ForceAlignment = internal::packet_traits::Vectorizable, + PacketSize = internal::packet_traits::size + }; + #if EIGEN_MAX_STATIC_ALIGN_BYTES!=0 + internal::plain_array m_data; + EIGEN_STRONG_INLINE Scalar* data() { return m_data.array; } + #else + // Some architectures cannot align on the stack, + // => let's manually enforce alignment by allocating more data and return the address of the first aligned element. + internal::plain_array m_data; + EIGEN_STRONG_INLINE Scalar* data() { + return ForceAlignment + ? reinterpret_cast((internal::UIntPtr(m_data.array) & ~(std::size_t(EIGEN_MAX_ALIGN_BYTES-1))) + EIGEN_MAX_ALIGN_BYTES) + : m_data.array; + } + #endif +}; + +// The vector is on the left => transposition +template +struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + Transpose destT(dest); + enum { OtherStorageOrder = StorageOrder == RowMajor ? ColMajor : RowMajor }; + gemv_dense_selector + ::run(rhs.transpose(), lhs.transpose(), destT, alpha); + } +}; + +template<> struct gemv_dense_selector +{ + template + static inline void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + typedef typename Dest::RealScalar RealScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + + typedef Map, EIGEN_PLAIN_ENUM_MIN(AlignedMax,internal::packet_traits::size)> MappedDest; + + ActualLhsType actualLhs = LhsBlasTraits::extract(lhs); + ActualRhsType actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + // make sure Dest is a compile-time vector type (bug 1166) + typedef typename conditional::type ActualDest; + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + EvalToDestAtCompileTime = (ActualDest::InnerStrideAtCompileTime==1), + ComplexByReal = (NumTraits::IsComplex) && (!NumTraits::IsComplex), + MightCannotUseDest = ((!EvalToDestAtCompileTime) || ComplexByReal) && (ActualDest::MaxSizeAtCompileTime!=0) + }; + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + RhsScalar compatibleAlpha = get_factor::run(actualAlpha); + + if(!MightCannotUseDest) + { + // shortcut if we are sure to be able to use dest directly, + // this ease the compiler to generate cleaner and more optimzized code for most common cases + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhs.data(), actualRhs.innerStride()), + dest.data(), 1, + compatibleAlpha); + } + else + { + gemv_static_vector_if static_dest; + + const bool alphaIsCompatible = (!ComplexByReal) || (numext::imag(actualAlpha)==RealScalar(0)); + const bool evalToDest = EvalToDestAtCompileTime && alphaIsCompatible; + + ei_declare_aligned_stack_constructed_variable(ResScalar,actualDestPtr,dest.size(), + evalToDest ? dest.data() : static_dest.data()); + + if(!evalToDest) + { + #ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + Index size = dest.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #endif + if(!alphaIsCompatible) + { + MappedDest(actualDestPtr, dest.size()).setZero(); + compatibleAlpha = RhsScalar(1); + } + else + MappedDest(actualDestPtr, dest.size()) = dest; + } + + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhs.data(), actualRhs.innerStride()), + actualDestPtr, 1, + compatibleAlpha); + + if (!evalToDest) + { + if(!alphaIsCompatible) + dest.matrix() += actualAlpha * MappedDest(actualDestPtr, dest.size()); + else + dest = MappedDest(actualDestPtr, dest.size()); + } + } + } +}; + +template<> struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + typedef typename Lhs::Scalar LhsScalar; + typedef typename Rhs::Scalar RhsScalar; + typedef typename Dest::Scalar ResScalar; + + typedef internal::blas_traits LhsBlasTraits; + typedef typename LhsBlasTraits::DirectLinearAccessType ActualLhsType; + typedef internal::blas_traits RhsBlasTraits; + typedef typename RhsBlasTraits::DirectLinearAccessType ActualRhsType; + typedef typename internal::remove_all::type ActualRhsTypeCleaned; + + typename add_const::type actualLhs = LhsBlasTraits::extract(lhs); + typename add_const::type actualRhs = RhsBlasTraits::extract(rhs); + + ResScalar actualAlpha = combine_scalar_factors(alpha, lhs, rhs); + + enum { + // FIXME find a way to allow an inner stride on the result if packet_traits::size==1 + // on, the other hand it is good for the cache to pack the vector anyways... + DirectlyUseRhs = ActualRhsTypeCleaned::InnerStrideAtCompileTime==1 || ActualRhsTypeCleaned::MaxSizeAtCompileTime==0 + }; + + gemv_static_vector_if static_rhs; + + ei_declare_aligned_stack_constructed_variable(RhsScalar,actualRhsPtr,actualRhs.size(), + DirectlyUseRhs ? const_cast(actualRhs.data()) : static_rhs.data()); + + if(!DirectlyUseRhs) + { + #ifdef EIGEN_DENSE_STORAGE_CTOR_PLUGIN + Index size = actualRhs.size(); + EIGEN_DENSE_STORAGE_CTOR_PLUGIN + #endif + Map(actualRhsPtr, actualRhs.size()) = actualRhs; + } + + typedef const_blas_data_mapper LhsMapper; + typedef const_blas_data_mapper RhsMapper; + general_matrix_vector_product + ::run( + actualLhs.rows(), actualLhs.cols(), + LhsMapper(actualLhs.data(), actualLhs.outerStride()), + RhsMapper(actualRhsPtr, 1), + dest.data(), dest.col(0).innerStride(), //NOTE if dest is not a vector at compile-time, then dest.innerStride() might be wrong. (bug 1166) + actualAlpha); + } +}; + +template<> struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate),EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + // TODO if rhs is large enough it might be beneficial to make sure that dest is sequentially stored in memory, otherwise use a temp + typename nested_eval::type actual_rhs(rhs); + const Index size = rhs.rows(); + for(Index k=0; k struct gemv_dense_selector +{ + template + static void run(const Lhs &lhs, const Rhs &rhs, Dest& dest, const typename Dest::Scalar& alpha) + { + EIGEN_STATIC_ASSERT((!nested_eval::Evaluate),EIGEN_INTERNAL_COMPILATION_ERROR_OR_YOU_MADE_A_PROGRAMMING_MISTAKE); + typename nested_eval::type actual_rhs(rhs); + const Index rows = dest.rows(); + for(Index i=0; i +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +const Product +MatrixBase::operator*(const MatrixBase &other) const +{ + // A note regarding the function declaration: In MSVC, this function will sometimes + // not be inlined since DenseStorage is an unwindable object for dynamic + // matrices and product types are holding a member to store the result. + // Thus it does not help tagging this function with EIGEN_STRONG_INLINE. + enum { + ProductIsValid = Derived::ColsAtCompileTime==Dynamic + || OtherDerived::RowsAtCompileTime==Dynamic + || int(Derived::ColsAtCompileTime)==int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived,OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT(ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) +#ifdef EIGEN_DEBUG_PRODUCT + internal::product_type::debug(); +#endif + + return Product(derived(), other.derived()); +} + +/** \returns an expression of the matrix product of \c *this and \a other without implicit evaluation. + * + * The returned product will behave like any other expressions: the coefficients of the product will be + * computed once at a time as requested. This might be useful in some extremely rare cases when only + * a small and no coherent fraction of the result's coefficients have to be computed. + * + * \warning This version of the matrix product can be much much slower. So use it only if you know + * what you are doing and that you measured a true speed improvement. + * + * \sa operator*(const MatrixBase&) + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +const Product +MatrixBase::lazyProduct(const MatrixBase &other) const +{ + enum { + ProductIsValid = Derived::ColsAtCompileTime==Dynamic + || OtherDerived::RowsAtCompileTime==Dynamic + || int(Derived::ColsAtCompileTime)==int(OtherDerived::RowsAtCompileTime), + AreVectors = Derived::IsVectorAtCompileTime && OtherDerived::IsVectorAtCompileTime, + SameSizes = EIGEN_PREDICATE_SAME_MATRIX_SIZE(Derived,OtherDerived) + }; + // note to the lost user: + // * for a dot product use: v1.dot(v2) + // * for a coeff-wise product use: v1.cwiseProduct(v2) + EIGEN_STATIC_ASSERT(ProductIsValid || !(AreVectors && SameSizes), + INVALID_VECTOR_VECTOR_PRODUCT__IF_YOU_WANTED_A_DOT_OR_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTIONS) + EIGEN_STATIC_ASSERT(ProductIsValid || !(SameSizes && !AreVectors), + INVALID_MATRIX_PRODUCT__IF_YOU_WANTED_A_COEFF_WISE_PRODUCT_YOU_MUST_USE_THE_EXPLICIT_FUNCTION) + EIGEN_STATIC_ASSERT(ProductIsValid || SameSizes, INVALID_MATRIX_PRODUCT) + + return Product(derived(), other.derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h b/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h new file mode 100644 index 0000000..cf677a1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GenericPacketMath.h @@ -0,0 +1,1040 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GENERIC_PACKET_MATH_H +#define EIGEN_GENERIC_PACKET_MATH_H + +namespace Eigen { + +namespace internal { + +/** \internal + * \file GenericPacketMath.h + * + * Default implementation for types not supported by the vectorization. + * In practice these functions are provided to make easier the writing + * of generic vectorized code. + */ + +#ifndef EIGEN_DEBUG_ALIGNED_LOAD +#define EIGEN_DEBUG_ALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_LOAD +#define EIGEN_DEBUG_UNALIGNED_LOAD +#endif + +#ifndef EIGEN_DEBUG_ALIGNED_STORE +#define EIGEN_DEBUG_ALIGNED_STORE +#endif + +#ifndef EIGEN_DEBUG_UNALIGNED_STORE +#define EIGEN_DEBUG_UNALIGNED_STORE +#endif + +struct default_packet_traits +{ + enum { + HasHalfPacket = 0, + + HasAdd = 1, + HasSub = 1, + HasShift = 1, + HasMul = 1, + HasNegate = 1, + HasAbs = 1, + HasArg = 0, + HasAbs2 = 1, + HasAbsDiff = 0, + HasMin = 1, + HasMax = 1, + HasConj = 1, + HasSetLinear = 1, + HasBlend = 0, + // This flag is used to indicate whether packet comparison is supported. + // pcmp_eq, pcmp_lt and pcmp_le should be defined for it to be true. + HasCmp = 0, + + HasDiv = 0, + HasSqrt = 0, + HasRsqrt = 0, + HasExp = 0, + HasExpm1 = 0, + HasLog = 0, + HasLog1p = 0, + HasLog10 = 0, + HasPow = 0, + + HasSin = 0, + HasCos = 0, + HasTan = 0, + HasASin = 0, + HasACos = 0, + HasATan = 0, + HasSinh = 0, + HasCosh = 0, + HasTanh = 0, + HasLGamma = 0, + HasDiGamma = 0, + HasZeta = 0, + HasPolygamma = 0, + HasErf = 0, + HasErfc = 0, + HasNdtri = 0, + HasBessel = 0, + HasIGamma = 0, + HasIGammaDerA = 0, + HasGammaSampleDerAlpha = 0, + HasIGammac = 0, + HasBetaInc = 0, + + HasRound = 0, + HasRint = 0, + HasFloor = 0, + HasCeil = 0, + HasSign = 0 + }; +}; + +template struct packet_traits : default_packet_traits +{ + typedef T type; + typedef T half; + enum { + Vectorizable = 0, + size = 1, + AlignedOnScalar = 0, + HasHalfPacket = 0 + }; + enum { + HasAdd = 0, + HasSub = 0, + HasMul = 0, + HasNegate = 0, + HasAbs = 0, + HasAbs2 = 0, + HasMin = 0, + HasMax = 0, + HasConj = 0, + HasSetLinear = 0 + }; +}; + +template struct packet_traits : packet_traits { }; + +template struct unpacket_traits +{ + typedef T type; + typedef T half; + enum + { + size = 1, + alignment = 1, + vectorizable = false, + masked_load_available=false, + masked_store_available=false + }; +}; + +template struct unpacket_traits : unpacket_traits { }; + +template struct type_casting_traits { + enum { + VectorizedCast = 0, + SrcCoeffRatio = 1, + TgtCoeffRatio = 1 + }; +}; + +/** \internal Wrapper to ensure that multiple packet types can map to the same + same underlying vector type. */ +template +struct eigen_packet_wrapper +{ + EIGEN_ALWAYS_INLINE operator T&() { return m_val; } + EIGEN_ALWAYS_INLINE operator const T&() const { return m_val; } + EIGEN_ALWAYS_INLINE eigen_packet_wrapper() {} + EIGEN_ALWAYS_INLINE eigen_packet_wrapper(const T &v) : m_val(v) {} + EIGEN_ALWAYS_INLINE eigen_packet_wrapper& operator=(const T &v) { + m_val = v; + return *this; + } + + T m_val; +}; + + +/** \internal A convenience utility for determining if the type is a scalar. + * This is used to enable some generic packet implementations. + */ +template +struct is_scalar { + typedef typename unpacket_traits::type Scalar; + enum { + value = internal::is_same::value + }; +}; + +/** \internal \returns static_cast(a) (coeff-wise) */ +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/, const SrcPacket& /*c*/, const SrcPacket& /*d*/) { + return static_cast(a); +} +template +EIGEN_DEVICE_FUNC inline TgtPacket +pcast(const SrcPacket& a, const SrcPacket& /*b*/, const SrcPacket& /*c*/, const SrcPacket& /*d*/, + const SrcPacket& /*e*/, const SrcPacket& /*f*/, const SrcPacket& /*g*/, const SrcPacket& /*h*/) { + return static_cast(a); +} + +/** \internal \returns reinterpret_cast(a) */ +template +EIGEN_DEVICE_FUNC inline Target +preinterpret(const Packet& a); /* { return reinterpret_cast(a); } */ + +/** \internal \returns a + b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +padd(const Packet& a, const Packet& b) { return a+b; } +// Avoid compiler warning for boolean algebra. +template<> EIGEN_DEVICE_FUNC inline bool +padd(const bool& a, const bool& b) { return a || b; } + +/** \internal \returns a - b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +psub(const Packet& a, const Packet& b) { return a-b; } + +/** \internal \returns -a (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pnegate(const Packet& a) { return -a; } + +template<> EIGEN_DEVICE_FUNC inline bool +pnegate(const bool& a) { return !a; } + +/** \internal \returns conj(a) (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pconj(const Packet& a) { return numext::conj(a); } + +/** \internal \returns a * b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pmul(const Packet& a, const Packet& b) { return a*b; } +// Avoid compiler warning for boolean algebra. +template<> EIGEN_DEVICE_FUNC inline bool +pmul(const bool& a, const bool& b) { return a && b; } + +/** \internal \returns a / b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pdiv(const Packet& a, const Packet& b) { return a/b; } + +// In the generic case, memset to all one bits. +template +struct ptrue_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/){ + Packet b; + memset(static_cast(&b), 0xff, sizeof(Packet)); + return b; + } +}; + +// For non-trivial scalars, set to Scalar(1) (i.e. a non-zero value). +// Although this is technically not a valid bitmask, the scalar path for pselect +// uses a comparison to zero, so this should still work in most cases. We don't +// have another option, since the scalar type requires initialization. +template +struct ptrue_impl::value && NumTraits::RequireInitialization>::type > { + static EIGEN_DEVICE_FUNC inline T run(const T& /*a*/){ + return T(1); + } +}; + +/** \internal \returns one bits. */ +template EIGEN_DEVICE_FUNC inline Packet +ptrue(const Packet& a) { + return ptrue_impl::run(a); +} + +// In the general case, memset to zero. +template +struct pzero_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& /*a*/) { + Packet b; + memset(static_cast(&b), 0x00, sizeof(Packet)); + return b; + } +}; + +// For scalars, explicitly set to Scalar(0), since the underlying representation +// for zero may not consist of all-zero bits. +template +struct pzero_impl::value>::type> { + static EIGEN_DEVICE_FUNC inline T run(const T& /*a*/) { + return T(0); + } +}; + +/** \internal \returns packet of zeros */ +template EIGEN_DEVICE_FUNC inline Packet +pzero(const Packet& a) { + return pzero_impl::run(a); +} + +/** \internal \returns a <= b as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_le(const Packet& a, const Packet& b) { return a<=b ? ptrue(a) : pzero(a); } + +/** \internal \returns a < b as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_lt(const Packet& a, const Packet& b) { return a EIGEN_DEVICE_FUNC inline Packet +pcmp_eq(const Packet& a, const Packet& b) { return a==b ? ptrue(a) : pzero(a); } + +/** \internal \returns a < b or a==NaN or b==NaN as a bit mask */ +template EIGEN_DEVICE_FUNC inline Packet +pcmp_lt_or_nan(const Packet& a, const Packet& b) { return a>=b ? pzero(a) : ptrue(a); } + +template +struct bit_and { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a & b; + } +}; + +template +struct bit_or { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a | b; + } +}; + +template +struct bit_xor { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a, const T& b) const { + return a ^ b; + } +}; + +template +struct bit_not { + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR EIGEN_ALWAYS_INLINE T operator()(const T& a) const { + return ~a; + } +}; + +// Use operators &, |, ^, ~. +template +struct operator_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { return bit_and()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { return bit_or()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { return bit_xor()(a, b); } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { return bit_not()(a); } +}; + +// Apply binary operations byte-by-byte +template +struct bytewise_bitwise_helper { + EIGEN_DEVICE_FUNC static inline T bitwise_and(const T& a, const T& b) { + return binary(a, b, bit_and()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_or(const T& a, const T& b) { + return binary(a, b, bit_or()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_xor(const T& a, const T& b) { + return binary(a, b, bit_xor()); + } + EIGEN_DEVICE_FUNC static inline T bitwise_not(const T& a) { + return unary(a,bit_not()); + } + + private: + template + EIGEN_DEVICE_FUNC static inline T unary(const T& a, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++); + } + return c; + } + + template + EIGEN_DEVICE_FUNC static inline T binary(const T& a, const T& b, Op op) { + const unsigned char* a_ptr = reinterpret_cast(&a); + const unsigned char* b_ptr = reinterpret_cast(&b); + T c; + unsigned char* c_ptr = reinterpret_cast(&c); + for (size_t i = 0; i < sizeof(T); ++i) { + *c_ptr++ = op(*a_ptr++, *b_ptr++); + } + return c; + } +}; + +// In the general case, use byte-by-byte manipulation. +template +struct bitwise_helper : public bytewise_bitwise_helper {}; + +// For integers or non-trivial scalars, use binary operators. +template +struct bitwise_helper::value && (NumTraits::IsInteger || NumTraits::RequireInitialization)>::type + > : public operator_bitwise_helper {}; + +/** \internal \returns the bitwise and of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pand(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_and(a, b); +} + +/** \internal \returns the bitwise or of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +por(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_or(a, b); +} + +/** \internal \returns the bitwise xor of \a a and \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pxor(const Packet& a, const Packet& b) { + return bitwise_helper::bitwise_xor(a, b); +} + +/** \internal \returns the bitwise not of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +pnot(const Packet& a) { + return bitwise_helper::bitwise_not(a); +} + +/** \internal \returns the bitwise and of \a a and not \a b */ +template EIGEN_DEVICE_FUNC inline Packet +pandnot(const Packet& a, const Packet& b) { return pand(a, pnot(b)); } + +// In the general case, use bitwise select. +template +struct pselect_impl { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return por(pand(a,mask),pandnot(b,mask)); + } +}; + +// For scalars, use ternary select. +template +struct pselect_impl::value>::type > { + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& mask, const Packet& a, const Packet& b) { + return numext::equal_strict(mask, Packet(0)) ? b : a; + } +}; + +/** \internal \returns \a or \b for each field in packet according to \mask */ +template EIGEN_DEVICE_FUNC inline Packet +pselect(const Packet& mask, const Packet& a, const Packet& b) { + return pselect_impl::run(mask, a, b); +} + +template<> EIGEN_DEVICE_FUNC inline bool pselect( + const bool& cond, const bool& a, const bool& b) { + return cond ? a : b; +} + +/** \internal \returns the min or of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, the result is implementation defined. */ +template +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + return op(a,b); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If either \a a or \a b are NaN, NaN is returned. */ +template<> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, + pselect(not_nan_mask_b, op(a, b), b), + a); + } +}; + +/** \internal \returns the min or max of \a a and \a b (coeff-wise) + If both \a a and \a b are NaN, NaN is returned. + Equivalent to std::fmin(a, b). */ +template<> +struct pminmax_impl { + template + static EIGEN_DEVICE_FUNC inline Packet run(const Packet& a, const Packet& b, Op op) { + Packet not_nan_mask_a = pcmp_eq(a, a); + Packet not_nan_mask_b = pcmp_eq(b, b); + return pselect(not_nan_mask_a, + pselect(not_nan_mask_b, op(a, b), a), + b); + } +}; + + +#ifndef SYCL_DEVICE_ONLY +#define EIGEN_BINARY_OP_NAN_PROPAGATION(Type, Func) Func +#else +#define EIGEN_BINARY_OP_NAN_PROPAGATION(Type, Func) \ +[](const Type& a, const Type& b) { \ + return Func(a, b);} +#endif + +/** \internal \returns the min of \a a and \a b (coeff-wise). + If \a a or \b b is NaN, the return value is implementation defined. */ +template EIGEN_DEVICE_FUNC inline Packet +pmin(const Packet& a, const Packet& b) { return numext::mini(a,b); } + +/** \internal \returns the min of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmin(const Packet& a, const Packet& b) { + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet, (pmin))); +} + +/** \internal \returns the max of \a a and \a b (coeff-wise) + If \a a or \b b is NaN, the return value is implementation defined. */ +template EIGEN_DEVICE_FUNC inline Packet +pmax(const Packet& a, const Packet& b) { return numext::maxi(a, b); } + +/** \internal \returns the max of \a a and \a b (coeff-wise). + NaNPropagation determines the NaN propagation semantics. */ +template +EIGEN_DEVICE_FUNC inline Packet pmax(const Packet& a, const Packet& b) { + return pminmax_impl::run(a, b, EIGEN_BINARY_OP_NAN_PROPAGATION(Packet,(pmax))); +} + +/** \internal \returns the absolute value of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +pabs(const Packet& a) { return numext::abs(a); } +template<> EIGEN_DEVICE_FUNC inline unsigned int +pabs(const unsigned int& a) { return a; } +template<> EIGEN_DEVICE_FUNC inline unsigned long +pabs(const unsigned long& a) { return a; } +template<> EIGEN_DEVICE_FUNC inline unsigned long long +pabs(const unsigned long long& a) { return a; } + +/** \internal \returns the addsub value of \a a,b */ +template EIGEN_DEVICE_FUNC inline Packet +paddsub(const Packet& a, const Packet& b) { + return pselect(peven_mask(a), padd(a, b), psub(a, b)); + } + +/** \internal \returns the phase angle of \a a */ +template EIGEN_DEVICE_FUNC inline Packet +parg(const Packet& a) { using numext::arg; return arg(a); } + + +/** \internal \returns \a a logically shifted by N bits to the right */ +template EIGEN_DEVICE_FUNC inline int +parithmetic_shift_right(const int& a) { return a >> N; } +template EIGEN_DEVICE_FUNC inline long int +parithmetic_shift_right(const long int& a) { return a >> N; } + +/** \internal \returns \a a arithmetically shifted by N bits to the right */ +template EIGEN_DEVICE_FUNC inline int +plogical_shift_right(const int& a) { return static_cast(static_cast(a) >> N); } +template EIGEN_DEVICE_FUNC inline long int +plogical_shift_right(const long int& a) { return static_cast(static_cast(a) >> N); } + +/** \internal \returns \a a shifted by N bits to the left */ +template EIGEN_DEVICE_FUNC inline int +plogical_shift_left(const int& a) { return a << N; } +template EIGEN_DEVICE_FUNC inline long int +plogical_shift_left(const long int& a) { return a << N; } + +/** \internal \returns the significant and exponent of the underlying floating point numbers + * See https://en.cppreference.com/w/cpp/numeric/math/frexp + */ +template +EIGEN_DEVICE_FUNC inline Packet pfrexp(const Packet& a, Packet& exponent) { + int exp; + EIGEN_USING_STD(frexp); + Packet result = static_cast(frexp(a, &exp)); + exponent = static_cast(exp); + return result; +} + +/** \internal \returns a * 2^((int)exponent) + * See https://en.cppreference.com/w/cpp/numeric/math/ldexp + */ +template EIGEN_DEVICE_FUNC inline Packet +pldexp(const Packet &a, const Packet &exponent) { + EIGEN_USING_STD(ldexp) + return static_cast(ldexp(a, static_cast(exponent))); +} + +/** \internal \returns the min of \a a and \a b (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pabsdiff(const Packet& a, const Packet& b) { return pselect(pcmp_lt(a, b), psub(b, a), psub(a, b)); } + +/** \internal \returns a packet version of \a *from, from must be 16 bytes aligned */ +template EIGEN_DEVICE_FUNC inline Packet +pload(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet version of \a *from, (un-aligned load) */ +template EIGEN_DEVICE_FUNC inline Packet +ploadu(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet version of \a *from, (un-aligned masked load) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template EIGEN_DEVICE_FUNC inline +typename enable_if::masked_load_available, Packet>::type +ploadu(const typename unpacket_traits::type* from, typename unpacket_traits::mask_t umask); + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (a,a,a,a) */ +template EIGEN_DEVICE_FUNC inline Packet +pset1(const typename unpacket_traits::type& a) { return a; } + +/** \internal \returns a packet with constant coefficients set from bits */ +template EIGEN_DEVICE_FUNC inline Packet +pset1frombits(BitsType a); + +/** \internal \returns a packet with constant coefficients \a a[0], e.g.: (a[0],a[0],a[0],a[0]) */ +template EIGEN_DEVICE_FUNC inline Packet +pload1(const typename unpacket_traits::type *a) { return pset1(*a); } + +/** \internal \returns a packet with elements of \a *from duplicated. + * For instance, for a packet of 8 elements, 4 scalars will be read from \a *from and + * duplicated to form: {from[0],from[0],from[1],from[1],from[2],from[2],from[3],from[3]} + * Currently, this function is only used for scalar * complex products. + */ +template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet +ploaddup(const typename unpacket_traits::type* from) { return *from; } + +/** \internal \returns a packet with elements of \a *from quadrupled. + * For instance, for a packet of 8 elements, 2 scalars will be read from \a *from and + * replicated to form: {from[0],from[0],from[0],from[0],from[1],from[1],from[1],from[1]} + * Currently, this function is only used in matrix products. + * For packet-size smaller or equal to 4, this function is equivalent to pload1 + */ +template EIGEN_DEVICE_FUNC inline Packet +ploadquad(const typename unpacket_traits::type* from) +{ return pload1(from); } + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * a2 = pload1(a+2); + * a3 = pload1(a+3); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast2 + */ +template EIGEN_DEVICE_FUNC +inline void pbroadcast4(const typename unpacket_traits::type *a, + Packet& a0, Packet& a1, Packet& a2, Packet& a3) +{ + a0 = pload1(a+0); + a1 = pload1(a+1); + a2 = pload1(a+2); + a3 = pload1(a+3); +} + +/** \internal equivalent to + * \code + * a0 = pload1(a+0); + * a1 = pload1(a+1); + * \endcode + * \sa pset1, pload1, ploaddup, pbroadcast4 + */ +template EIGEN_DEVICE_FUNC +inline void pbroadcast2(const typename unpacket_traits::type *a, + Packet& a0, Packet& a1) +{ + a0 = pload1(a+0); + a1 = pload1(a+1); +} + +/** \internal \brief Returns a packet with coefficients (a,a+1,...,a+packet_size-1). */ +template EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Packet +plset(const typename unpacket_traits::type& a) { return a; } + +/** \internal \returns a packet with constant coefficients \a a, e.g.: (x, 0, x, 0), + where x is the value of all 1-bits. */ +template EIGEN_DEVICE_FUNC inline Packet +peven_mask(const Packet& /*a*/) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + for(size_t i = 0; i < n; ++i) { + memset(elements+i, ((i & 1) == 0 ? 0xff : 0), sizeof(Scalar)); + } + return ploadu(elements); +} + + +/** \internal copy the packet \a from to \a *to, \a to must be 16 bytes aligned */ +template EIGEN_DEVICE_FUNC inline void pstore(Scalar* to, const Packet& from) +{ (*to) = from; } + +/** \internal copy the packet \a from to \a *to, (un-aligned store) */ +template EIGEN_DEVICE_FUNC inline void pstoreu(Scalar* to, const Packet& from) +{ (*to) = from; } + +/** \internal copy the packet \a from to \a *to, (un-aligned store with a mask) + * There is no generic implementation. We only have implementations for specialized + * cases. Generic case should not be called. + */ +template +EIGEN_DEVICE_FUNC inline +typename enable_if::masked_store_available, void>::type +pstoreu(Scalar* to, const Packet& from, typename unpacket_traits::mask_t umask); + + template EIGEN_DEVICE_FUNC inline Packet pgather(const Scalar* from, Index /*stride*/) + { return ploadu(from); } + + template EIGEN_DEVICE_FUNC inline void pscatter(Scalar* to, const Packet& from, Index /*stride*/) + { pstore(to, from); } + +/** \internal tries to do cache prefetching of \a addr */ +template EIGEN_DEVICE_FUNC inline void prefetch(const Scalar* addr) +{ +#if defined(EIGEN_HIP_DEVICE_COMPILE) + // do nothing +#elif defined(EIGEN_CUDA_ARCH) +#if defined(__LP64__) || EIGEN_OS_WIN64 + // 64-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=l"(addr) : "l"(addr)); +#else + // 32-bit pointer operand constraint for inlined asm + asm(" prefetch.L1 [ %1 ];" : "=r"(addr) : "r"(addr)); +#endif +#elif (!EIGEN_COMP_MSVC) && (EIGEN_COMP_GNUC || EIGEN_COMP_CLANG || EIGEN_COMP_ICC) + __builtin_prefetch(addr); +#endif +} + +/** \internal \returns the reversed elements of \a a*/ +template EIGEN_DEVICE_FUNC inline Packet preverse(const Packet& a) +{ return a; } + +/** \internal \returns \a a with real and imaginary part flipped (for complex type only) */ +template EIGEN_DEVICE_FUNC inline Packet pcplxflip(const Packet& a) +{ + return Packet(numext::imag(a),numext::real(a)); +} + +/************************** +* Special math functions +***************************/ + +/** \internal \returns the sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psin(const Packet& a) { EIGEN_USING_STD(sin); return sin(a); } + +/** \internal \returns the cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pcos(const Packet& a) { EIGEN_USING_STD(cos); return cos(a); } + +/** \internal \returns the tan of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet ptan(const Packet& a) { EIGEN_USING_STD(tan); return tan(a); } + +/** \internal \returns the arc sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pasin(const Packet& a) { EIGEN_USING_STD(asin); return asin(a); } + +/** \internal \returns the arc cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pacos(const Packet& a) { EIGEN_USING_STD(acos); return acos(a); } + +/** \internal \returns the arc tangent of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet patan(const Packet& a) { EIGEN_USING_STD(atan); return atan(a); } + +/** \internal \returns the hyperbolic sine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psinh(const Packet& a) { EIGEN_USING_STD(sinh); return sinh(a); } + +/** \internal \returns the hyperbolic cosine of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pcosh(const Packet& a) { EIGEN_USING_STD(cosh); return cosh(a); } + +/** \internal \returns the hyperbolic tan of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet ptanh(const Packet& a) { EIGEN_USING_STD(tanh); return tanh(a); } + +/** \internal \returns the exp of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pexp(const Packet& a) { EIGEN_USING_STD(exp); return exp(a); } + +/** \internal \returns the expm1 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pexpm1(const Packet& a) { return numext::expm1(a); } + +/** \internal \returns the log of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog(const Packet& a) { EIGEN_USING_STD(log); return log(a); } + +/** \internal \returns the log1p of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog1p(const Packet& a) { return numext::log1p(a); } + +/** \internal \returns the log10 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog10(const Packet& a) { EIGEN_USING_STD(log10); return log10(a); } + +/** \internal \returns the log10 of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet plog2(const Packet& a) { + typedef typename internal::unpacket_traits::type Scalar; + return pmul(pset1(Scalar(EIGEN_LOG2E)), plog(a)); +} + +/** \internal \returns the square-root of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet psqrt(const Packet& a) { return numext::sqrt(a); } + +/** \internal \returns the reciprocal square-root of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet prsqrt(const Packet& a) { + typedef typename internal::unpacket_traits::type Scalar; + return pdiv(pset1(Scalar(1)), psqrt(a)); +} + +/** \internal \returns the rounded value of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pround(const Packet& a) { using numext::round; return round(a); } + +/** \internal \returns the floor of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pfloor(const Packet& a) { using numext::floor; return floor(a); } + +/** \internal \returns the rounded value of \a a (coeff-wise) with current + * rounding mode */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet print(const Packet& a) { using numext::rint; return rint(a); } + +/** \internal \returns the ceil of \a a (coeff-wise) */ +template EIGEN_DECLARE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS +Packet pceil(const Packet& a) { using numext::ceil; return ceil(a); } + +/** \internal \returns the first element of a packet */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +pfirst(const Packet& a) +{ return a; } + +/** \internal \returns the sum of the elements of upper and lower half of \a a if \a a is larger than 4. + * For a packet {a0, a1, a2, a3, a4, a5, a6, a7}, it returns a half packet {a0+a4, a1+a5, a2+a6, a3+a7} + * For packet-size smaller or equal to 4, this boils down to a noop. + */ +template +EIGEN_DEVICE_FUNC inline typename conditional<(unpacket_traits::size%8)==0,typename unpacket_traits::half,Packet>::type +predux_half_dowto4(const Packet& a) +{ return a; } + +// Slow generic implementation of Packet reduction. +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +predux_helper(const Packet& a, Op op) { + typedef typename unpacket_traits::type Scalar; + const size_t n = unpacket_traits::size; + EIGEN_ALIGN_TO_BOUNDARY(sizeof(Packet)) Scalar elements[n]; + pstoreu(elements, a); + for(size_t k = n / 2; k > 0; k /= 2) { + for(size_t i = 0; i < k; ++i) { + elements[i] = op(elements[i], elements[i + k]); + } + } + return elements[0]; +} + +/** \internal \returns the sum of the elements of \a a*/ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type +predux(const Packet& a) +{ + return a; +} + +/** \internal \returns the product of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_mul( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmul))); +} + +/** \internal \returns the min of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min( + const Packet &a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); +} + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_min( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmin))); +} + +/** \internal \returns the min of the elements of \a a */ +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max( + const Packet &a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); +} + +template +EIGEN_DEVICE_FUNC inline typename unpacket_traits::type predux_max( + const Packet& a) { + typedef typename unpacket_traits::type Scalar; + return predux_helper(a, EIGEN_BINARY_OP_NAN_PROPAGATION(Scalar, (pmax))); +} + +#undef EIGEN_BINARY_OP_NAN_PROPAGATION + +/** \internal \returns true if all coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +// not needed yet +// template EIGEN_DEVICE_FUNC inline bool predux_all(const Packet& a) +// { return bool(a); } + +/** \internal \returns true if any coeffs of \a a means "true" + * It is supposed to be called on values returned by pcmp_*. + */ +template EIGEN_DEVICE_FUNC inline bool predux_any(const Packet& a) +{ + // Dirty but generic implementation where "true" is assumed to be non 0 and all the sames. + // It is expected that "true" is either: + // - Scalar(1) + // - bits full of ones (NaN for floats), + // - or first bit equals to 1 (1 for ints, smallest denormal for floats). + // For all these cases, taking the sum is just fine, and this boils down to a no-op for scalars. + typedef typename unpacket_traits::type Scalar; + return numext::not_equal_strict(predux(a), Scalar(0)); +} + +/*************************************************************************** +* The following functions might not have to be overwritten for vectorized types +***************************************************************************/ + +/** \internal copy a packet with constant coefficient \a a (e.g., [a,a,a,a]) to \a *to. \a to must be 16 bytes aligned */ +// NOTE: this function must really be templated on the packet type (think about different packet types for the same scalar type) +template +inline void pstore1(typename unpacket_traits::type* to, const typename unpacket_traits::type& a) +{ + pstore(to, pset1(a)); +} + +/** \internal \returns a * b + c (coeff-wise) */ +template EIGEN_DEVICE_FUNC inline Packet +pmadd(const Packet& a, + const Packet& b, + const Packet& c) +{ return padd(pmul(a, b),c); } + +/** \internal \returns a packet version of \a *from. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt(const typename unpacket_traits::type* from) +{ + if(Alignment >= unpacket_traits::alignment) + return pload(from); + else + return ploadu(from); +} + +/** \internal copy the packet \a from to \a *to. + * The pointer \a from must be aligned on a \a Alignment bytes boundary. */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE void pstoret(Scalar* to, const Packet& from) +{ + if(Alignment >= unpacket_traits::alignment) + pstore(to, from); + else + pstoreu(to, from); +} + +/** \internal \returns a packet version of \a *from. + * Unlike ploadt, ploadt_ro takes advantage of the read-only memory path on the + * hardware if available to speedup the loading of data that won't be modified + * by the current computation. + */ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE Packet ploadt_ro(const typename unpacket_traits::type* from) +{ + return ploadt(from); +} + +/*************************************************************************** +* Fast complex products (GCC generates a function call which is very slow) +***************************************************************************/ + +// Eigen+CUDA does not support complexes. +#if !defined(EIGEN_GPUCC) + +template<> inline std::complex pmul(const std::complex& a, const std::complex& b) +{ return std::complex(a.real()*b.real() - a.imag()*b.imag(), a.imag()*b.real() + a.real()*b.imag()); } + +template<> inline std::complex pmul(const std::complex& a, const std::complex& b) +{ return std::complex(a.real()*b.real() - a.imag()*b.imag(), a.imag()*b.real() + a.real()*b.imag()); } + +#endif + + +/*************************************************************************** + * PacketBlock, that is a collection of N packets where the number of words + * in the packet is a multiple of N. +***************************************************************************/ +template ::size> struct PacketBlock { + Packet packet[N]; +}; + +template EIGEN_DEVICE_FUNC inline void +ptranspose(PacketBlock& /*kernel*/) { + // Nothing to do in the scalar case, i.e. a 1x1 matrix. +} + +/*************************************************************************** + * Selector, i.e. vector of N boolean values used to select (i.e. blend) + * words from 2 packets. +***************************************************************************/ +template struct Selector { + bool select[N]; +}; + +template EIGEN_DEVICE_FUNC inline Packet +pblend(const Selector::size>& ifPacket, const Packet& thenPacket, const Packet& elsePacket) { + return ifPacket.select[0] ? thenPacket : elsePacket; +} + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_GENERIC_PACKET_MATH_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h b/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h new file mode 100644 index 0000000..629af94 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/GlobalFunctions.h @@ -0,0 +1,194 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2010-2016 Gael Guennebaud +// Copyright (C) 2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_GLOBAL_FUNCTIONS_H +#define EIGEN_GLOBAL_FUNCTIONS_H + +#ifdef EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME,FUNCTOR,DOC_OP,DOC_DETAILS) \ + /** \returns an expression of the coefficient-wise DOC_OP of \a x + + DOC_DETAILS + + \sa Math functions, class CwiseUnaryOp + */ \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived> \ + NAME(const Eigen::ArrayBase& x); + +#else + +#define EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(NAME,FUNCTOR,DOC_OP,DOC_DETAILS) \ + template \ + inline const Eigen::CwiseUnaryOp, const Derived> \ + (NAME)(const Eigen::ArrayBase& x) { \ + return Eigen::CwiseUnaryOp, const Derived>(x.derived()); \ + } + +#endif // EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(NAME,FUNCTOR) \ + \ + template \ + struct NAME##_retval > \ + { \ + typedef const Eigen::CwiseUnaryOp, const Derived> type; \ + }; \ + template \ + struct NAME##_impl > \ + { \ + static inline typename NAME##_retval >::type run(const Eigen::ArrayBase& x) \ + { \ + return typename NAME##_retval >::type(x.derived()); \ + } \ + }; + +namespace Eigen +{ + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(real,scalar_real_op,real part,\sa ArrayBase::real) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(imag,scalar_imag_op,imaginary part,\sa ArrayBase::imag) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(conj,scalar_conjugate_op,complex conjugate,\sa ArrayBase::conjugate) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(inverse,scalar_inverse_op,inverse,\sa ArrayBase::inverse) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sin,scalar_sin_op,sine,\sa ArrayBase::sin) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cos,scalar_cos_op,cosine,\sa ArrayBase::cos) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tan,scalar_tan_op,tangent,\sa ArrayBase::tan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atan,scalar_atan_op,arc-tangent,\sa ArrayBase::atan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asin,scalar_asin_op,arc-sine,\sa ArrayBase::asin) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acos,scalar_acos_op,arc-consine,\sa ArrayBase::acos) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sinh,scalar_sinh_op,hyperbolic sine,\sa ArrayBase::sinh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cosh,scalar_cosh_op,hyperbolic cosine,\sa ArrayBase::cosh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(tanh,scalar_tanh_op,hyperbolic tangent,\sa ArrayBase::tanh) +#if EIGEN_HAS_CXX11_MATH + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(asinh,scalar_asinh_op,inverse hyperbolic sine,\sa ArrayBase::asinh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(acosh,scalar_acosh_op,inverse hyperbolic cosine,\sa ArrayBase::acosh) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(atanh,scalar_atanh_op,inverse hyperbolic tangent,\sa ArrayBase::atanh) +#endif + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(logistic,scalar_logistic_op,logistic function,\sa ArrayBase::logistic) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(lgamma,scalar_lgamma_op,natural logarithm of the gamma function,\sa ArrayBase::lgamma) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(digamma,scalar_digamma_op,derivative of lgamma,\sa ArrayBase::digamma) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erf,scalar_erf_op,error function,\sa ArrayBase::erf) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(erfc,scalar_erfc_op,complement error function,\sa ArrayBase::erfc) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(ndtri,scalar_ndtri_op,inverse normal distribution function,\sa ArrayBase::ndtri) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(exp,scalar_exp_op,exponential,\sa ArrayBase::exp) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(expm1,scalar_expm1_op,exponential of a value minus 1,\sa ArrayBase::expm1) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log,scalar_log_op,natural logarithm,\sa Eigen::log10 DOXCOMMA ArrayBase::log) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log1p,scalar_log1p_op,natural logarithm of 1 plus the value,\sa ArrayBase::log1p) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log10,scalar_log10_op,base 10 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log10) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(log2,scalar_log2_op,base 2 logarithm,\sa Eigen::log DOXCOMMA ArrayBase::log2) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs,scalar_abs_op,absolute value,\sa ArrayBase::abs DOXCOMMA MatrixBase::cwiseAbs) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(abs2,scalar_abs2_op,squared absolute value,\sa ArrayBase::abs2 DOXCOMMA MatrixBase::cwiseAbs2) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(arg,scalar_arg_op,complex argument,\sa ArrayBase::arg DOXCOMMA MatrixBase::cwiseArg) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sqrt,scalar_sqrt_op,square root,\sa ArrayBase::sqrt DOXCOMMA MatrixBase::cwiseSqrt) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rsqrt,scalar_rsqrt_op,reciprocal square root,\sa ArrayBase::rsqrt) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(square,scalar_square_op,square (power 2),\sa Eigen::abs2 DOXCOMMA Eigen::pow DOXCOMMA ArrayBase::square) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(cube,scalar_cube_op,cube (power 3),\sa Eigen::pow DOXCOMMA ArrayBase::cube) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(rint,scalar_rint_op,nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(round,scalar_round_op,nearest integer,\sa Eigen::floor DOXCOMMA Eigen::ceil DOXCOMMA ArrayBase::round) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(floor,scalar_floor_op,nearest integer not greater than the giben value,\sa Eigen::ceil DOXCOMMA ArrayBase::floor) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(ceil,scalar_ceil_op,nearest integer not less than the giben value,\sa Eigen::floor DOXCOMMA ArrayBase::ceil) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isnan,scalar_isnan_op,not-a-number test,\sa Eigen::isinf DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isnan) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isinf,scalar_isinf_op,infinite value test,\sa Eigen::isnan DOXCOMMA Eigen::isfinite DOXCOMMA ArrayBase::isinf) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(isfinite,scalar_isfinite_op,finite value test,\sa Eigen::isinf DOXCOMMA Eigen::isnan DOXCOMMA ArrayBase::isfinite) + EIGEN_ARRAY_DECLARE_GLOBAL_UNARY(sign,scalar_sign_op,sign (or 0),\sa ArrayBase::sign) + + /** \returns an expression of the coefficient-wise power of \a x to the given constant \a exponent. + * + * \tparam ScalarExponent is the scalar type of \a exponent. It must be compatible with the scalar type of the given expression (\c Derived::Scalar). + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN + template + inline const CwiseBinaryOp,Derived,Constant > + pow(const Eigen::ArrayBase& x, const ScalarExponent& exponent); +#else + template + EIGEN_DEVICE_FUNC inline + EIGEN_MSVC10_WORKAROUND_BINARYOP_RETURN_TYPE( + const EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(Derived,typename internal::promote_scalar_arg::type,pow)) + pow(const Eigen::ArrayBase& x, const ScalarExponent& exponent) + { + typedef typename internal::promote_scalar_arg::type PromotedExponent; + return EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(Derived,PromotedExponent,pow)(x.derived(), + typename internal::plain_constant_type::type(x.derived().rows(), x.derived().cols(), internal::scalar_constant_op(exponent))); + } +#endif + + /** \returns an expression of the coefficient-wise power of \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power. + * + * Example: \include Cwise_array_power_array.cpp + * Output: \verbinclude Cwise_array_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ + template + inline const Eigen::CwiseBinaryOp, const Derived, const ExponentDerived> + pow(const Eigen::ArrayBase& x, const Eigen::ArrayBase& exponents) + { + return Eigen::CwiseBinaryOp, const Derived, const ExponentDerived>( + x.derived(), + exponents.derived() + ); + } + + /** \returns an expression of the coefficient-wise power of the scalar \a x to the given array of \a exponents. + * + * This function computes the coefficient-wise power between a scalar and an array of exponents. + * + * \tparam Scalar is the scalar type of \a x. It must be compatible with the scalar type of the given array expression (\c Derived::Scalar). + * + * Example: \include Cwise_scalar_power_array.cpp + * Output: \verbinclude Cwise_scalar_power_array.out + * + * \sa ArrayBase::pow() + * + * \relates ArrayBase + */ +#ifdef EIGEN_PARSED_BY_DOXYGEN + template + inline const CwiseBinaryOp,Constant,Derived> + pow(const Scalar& x,const Eigen::ArrayBase& x); +#else + template + EIGEN_DEVICE_FUNC inline + EIGEN_MSVC10_WORKAROUND_BINARYOP_RETURN_TYPE( + const EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE(typename internal::promote_scalar_arg::type,Derived,pow)) + pow(const Scalar& x, const Eigen::ArrayBase& exponents) { + typedef typename internal::promote_scalar_arg::type PromotedScalar; + return EIGEN_SCALAR_BINARYOP_EXPR_RETURN_TYPE(PromotedScalar,Derived,pow)( + typename internal::plain_constant_type::type(exponents.derived().rows(), exponents.derived().cols(), internal::scalar_constant_op(x)), exponents.derived()); + } +#endif + + + namespace internal + { + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(real,scalar_real_op) + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(imag,scalar_imag_op) + EIGEN_ARRAY_DECLARE_GLOBAL_EIGEN_UNARY(abs2,scalar_abs2_op) + } +} + +// TODO: cleanly disable those functions that are not supported on Array (numext::real_ref, internal::random, internal::isApprox...) + +#endif // EIGEN_GLOBAL_FUNCTIONS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/IO.h b/src/3rdparty/eigen/Eigen/src/Core/IO.h new file mode 100644 index 0000000..e81c315 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/IO.h @@ -0,0 +1,258 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_IO_H +#define EIGEN_IO_H + +namespace Eigen { + +enum { DontAlignCols = 1 }; +enum { StreamPrecision = -1, + FullPrecision = -2 }; + +namespace internal { +template +std::ostream & print_matrix(std::ostream & s, const Derived& _m, const IOFormat& fmt); +} + +/** \class IOFormat + * \ingroup Core_Module + * + * \brief Stores a set of parameters controlling the way matrices are printed + * + * List of available parameters: + * - \b precision number of digits for floating point values, or one of the special constants \c StreamPrecision and \c FullPrecision. + * The default is the special value \c StreamPrecision which means to use the + * stream's own precision setting, as set for instance using \c cout.precision(3). The other special value + * \c FullPrecision means that the number of digits will be computed to match the full precision of each floating-point + * type. + * - \b flags an OR-ed combination of flags, the default value is 0, the only currently available flag is \c DontAlignCols which + * allows to disable the alignment of columns, resulting in faster code. + * - \b coeffSeparator string printed between two coefficients of the same row + * - \b rowSeparator string printed between two rows + * - \b rowPrefix string printed at the beginning of each row + * - \b rowSuffix string printed at the end of each row + * - \b matPrefix string printed at the beginning of the matrix + * - \b matSuffix string printed at the end of the matrix + * - \b fill character printed to fill the empty space in aligned columns + * + * Example: \include IOFormat.cpp + * Output: \verbinclude IOFormat.out + * + * \sa DenseBase::format(), class WithFormat + */ +struct IOFormat +{ + /** Default constructor, see class IOFormat for the meaning of the parameters */ + IOFormat(int _precision = StreamPrecision, int _flags = 0, + const std::string& _coeffSeparator = " ", + const std::string& _rowSeparator = "\n", const std::string& _rowPrefix="", const std::string& _rowSuffix="", + const std::string& _matPrefix="", const std::string& _matSuffix="", const char _fill=' ') + : matPrefix(_matPrefix), matSuffix(_matSuffix), rowPrefix(_rowPrefix), rowSuffix(_rowSuffix), rowSeparator(_rowSeparator), + rowSpacer(""), coeffSeparator(_coeffSeparator), fill(_fill), precision(_precision), flags(_flags) + { + // TODO check if rowPrefix, rowSuffix or rowSeparator contains a newline + // don't add rowSpacer if columns are not to be aligned + if((flags & DontAlignCols)) + return; + int i = int(matSuffix.length())-1; + while (i>=0 && matSuffix[i]!='\n') + { + rowSpacer += ' '; + i--; + } + } + std::string matPrefix, matSuffix; + std::string rowPrefix, rowSuffix, rowSeparator, rowSpacer; + std::string coeffSeparator; + char fill; + int precision; + int flags; +}; + +/** \class WithFormat + * \ingroup Core_Module + * + * \brief Pseudo expression providing matrix output with given format + * + * \tparam ExpressionType the type of the object on which IO stream operations are performed + * + * This class represents an expression with stream operators controlled by a given IOFormat. + * It is the return type of DenseBase::format() + * and most of the time this is the only way it is used. + * + * See class IOFormat for some examples. + * + * \sa DenseBase::format(), class IOFormat + */ +template +class WithFormat +{ + public: + + WithFormat(const ExpressionType& matrix, const IOFormat& format) + : m_matrix(matrix), m_format(format) + {} + + friend std::ostream & operator << (std::ostream & s, const WithFormat& wf) + { + return internal::print_matrix(s, wf.m_matrix.eval(), wf.m_format); + } + + protected: + typename ExpressionType::Nested m_matrix; + IOFormat m_format; +}; + +namespace internal { + +// NOTE: This helper is kept for backward compatibility with previous code specializing +// this internal::significant_decimals_impl structure. In the future we should directly +// call digits10() which has been introduced in July 2016 in 3.3. +template +struct significant_decimals_impl +{ + static inline int run() + { + return NumTraits::digits10(); + } +}; + +/** \internal + * print the matrix \a _m to the output stream \a s using the output format \a fmt */ +template +std::ostream & print_matrix(std::ostream & s, const Derived& _m, const IOFormat& fmt) +{ + using internal::is_same; + using internal::conditional; + + if(_m.size() == 0) + { + s << fmt.matPrefix << fmt.matSuffix; + return s; + } + + typename Derived::Nested m = _m; + typedef typename Derived::Scalar Scalar; + typedef typename + conditional< + is_same::value || + is_same::value || + is_same::value || + is_same::value, + int, + typename conditional< + is_same >::value || + is_same >::value || + is_same >::value || + is_same >::value, + std::complex, + const Scalar& + >::type + >::type PrintType; + + Index width = 0; + + std::streamsize explicit_precision; + if(fmt.precision == StreamPrecision) + { + explicit_precision = 0; + } + else if(fmt.precision == FullPrecision) + { + if (NumTraits::IsInteger) + { + explicit_precision = 0; + } + else + { + explicit_precision = significant_decimals_impl::run(); + } + } + else + { + explicit_precision = fmt.precision; + } + + std::streamsize old_precision = 0; + if(explicit_precision) old_precision = s.precision(explicit_precision); + + bool align_cols = !(fmt.flags & DontAlignCols); + if(align_cols) + { + // compute the largest width + for(Index j = 0; j < m.cols(); ++j) + for(Index i = 0; i < m.rows(); ++i) + { + std::stringstream sstr; + sstr.copyfmt(s); + sstr << static_cast(m.coeff(i,j)); + width = std::max(width, Index(sstr.str().length())); + } + } + std::streamsize old_width = s.width(); + char old_fill_character = s.fill(); + s << fmt.matPrefix; + for(Index i = 0; i < m.rows(); ++i) + { + if (i) + s << fmt.rowSpacer; + s << fmt.rowPrefix; + if(width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, 0)); + for(Index j = 1; j < m.cols(); ++j) + { + s << fmt.coeffSeparator; + if(width) { + s.fill(fmt.fill); + s.width(width); + } + s << static_cast(m.coeff(i, j)); + } + s << fmt.rowSuffix; + if( i < m.rows() - 1) + s << fmt.rowSeparator; + } + s << fmt.matSuffix; + if(explicit_precision) s.precision(old_precision); + if(width) { + s.fill(old_fill_character); + s.width(old_width); + } + return s; +} + +} // end namespace internal + +/** \relates DenseBase + * + * Outputs the matrix, to the given stream. + * + * If you wish to print the matrix with a format different than the default, use DenseBase::format(). + * + * It is also possible to change the default format by defining EIGEN_DEFAULT_IO_FORMAT before including Eigen headers. + * If not defined, this will automatically be defined to Eigen::IOFormat(), that is the Eigen::IOFormat with default parameters. + * + * \sa DenseBase::format() + */ +template +std::ostream & operator << +(std::ostream & s, + const DenseBase & m) +{ + return internal::print_matrix(s, m.eval(), EIGEN_DEFAULT_IO_FORMAT); +} + +} // end namespace Eigen + +#endif // EIGEN_IO_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h b/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h new file mode 100644 index 0000000..0847625 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/IndexedView.h @@ -0,0 +1,237 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2017 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INDEXED_VIEW_H +#define EIGEN_INDEXED_VIEW_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : traits +{ + enum { + RowsAtCompileTime = int(array_size::value), + ColsAtCompileTime = int(array_size::value), + MaxRowsAtCompileTime = RowsAtCompileTime != Dynamic ? int(RowsAtCompileTime) : Dynamic, + MaxColsAtCompileTime = ColsAtCompileTime != Dynamic ? int(ColsAtCompileTime) : Dynamic, + + XprTypeIsRowMajor = (int(traits::Flags)&RowMajorBit) != 0, + IsRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : XprTypeIsRowMajor, + + RowIncr = int(get_compile_time_incr::value), + ColIncr = int(get_compile_time_incr::value), + InnerIncr = IsRowMajor ? ColIncr : RowIncr, + OuterIncr = IsRowMajor ? RowIncr : ColIncr, + + HasSameStorageOrderAsXprType = (IsRowMajor == XprTypeIsRowMajor), + XprInnerStride = HasSameStorageOrderAsXprType ? int(inner_stride_at_compile_time::ret) : int(outer_stride_at_compile_time::ret), + XprOuterstride = HasSameStorageOrderAsXprType ? int(outer_stride_at_compile_time::ret) : int(inner_stride_at_compile_time::ret), + + InnerSize = XprTypeIsRowMajor ? ColsAtCompileTime : RowsAtCompileTime, + IsBlockAlike = InnerIncr==1 && OuterIncr==1, + IsInnerPannel = HasSameStorageOrderAsXprType && is_same,typename conditional::type>::value, + + InnerStrideAtCompileTime = InnerIncr<0 || InnerIncr==DynamicIndex || XprInnerStride==Dynamic ? Dynamic : XprInnerStride * InnerIncr, + OuterStrideAtCompileTime = OuterIncr<0 || OuterIncr==DynamicIndex || XprOuterstride==Dynamic ? Dynamic : XprOuterstride * OuterIncr, + + ReturnAsScalar = is_same::value && is_same::value, + ReturnAsBlock = (!ReturnAsScalar) && IsBlockAlike, + ReturnAsIndexedView = (!ReturnAsScalar) && (!ReturnAsBlock), + + // FIXME we deal with compile-time strides if and only if we have DirectAccessBit flag, + // but this is too strict regarding negative strides... + DirectAccessMask = (int(InnerIncr)!=UndefinedIncr && int(OuterIncr)!=UndefinedIncr && InnerIncr>=0 && OuterIncr>=0) ? DirectAccessBit : 0, + FlagsRowMajorBit = IsRowMajor ? RowMajorBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + Flags = (traits::Flags & (HereditaryBits | DirectAccessMask )) | FlagsLvalueBit | FlagsRowMajorBit | FlagsLinearAccessBit + }; + + typedef Block BlockType; +}; + +} + +template +class IndexedViewImpl; + + +/** \class IndexedView + * \ingroup Core_Module + * + * \brief Expression of a non-sequential sub-matrix defined by arbitrary sequences of row and column indices + * + * \tparam XprType the type of the expression in which we are taking the intersections of sub-rows and sub-columns + * \tparam RowIndices the type of the object defining the sequence of row indices + * \tparam ColIndices the type of the object defining the sequence of column indices + * + * This class represents an expression of a sub-matrix (or sub-vector) defined as the intersection + * of sub-sets of rows and columns, that are themself defined by generic sequences of row indices \f$ \{r_0,r_1,..r_{m-1}\} \f$ + * and column indices \f$ \{c_0,c_1,..c_{n-1} \}\f$. Let \f$ A \f$ be the nested matrix, then the resulting matrix \f$ B \f$ has \c m + * rows and \c n columns, and its entries are given by: \f$ B(i,j) = A(r_i,c_j) \f$. + * + * The \c RowIndices and \c ColIndices types must be compatible with the following API: + * \code + * operator[](Index) const; + * Index size() const; + * \endcode + * + * Typical supported types thus include: + * - std::vector + * - std::valarray + * - std::array + * - Plain C arrays: int[N] + * - Eigen::ArrayXi + * - decltype(ArrayXi::LinSpaced(...)) + * - Any view/expressions of the previous types + * - Eigen::ArithmeticSequence + * - Eigen::internal::AllRange (helper for Eigen::all) + * - Eigen::internal::SingleRange (helper for single index) + * - etc. + * + * In typical usages of %Eigen, this class should never be used directly. It is the return type of + * DenseBase::operator()(const RowIndices&, const ColIndices&). + * + * \sa class Block + */ +template +class IndexedView : public IndexedViewImpl::StorageKind> +{ +public: + typedef typename IndexedViewImpl::StorageKind>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(IndexedView) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(IndexedView) + + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + template + IndexedView(XprType& xpr, const T0& rowIndices, const T1& colIndices) + : m_xpr(xpr), m_rowIndices(rowIndices), m_colIndices(colIndices) + {} + + /** \returns number of rows */ + Index rows() const { return internal::size(m_rowIndices); } + + /** \returns number of columns */ + Index cols() const { return internal::size(m_colIndices); } + + /** \returns the nested expression */ + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + typename internal::remove_reference::type& + nestedExpression() { return m_xpr; } + + /** \returns a const reference to the object storing/generating the row indices */ + const RowIndices& rowIndices() const { return m_rowIndices; } + + /** \returns a const reference to the object storing/generating the column indices */ + const ColIndices& colIndices() const { return m_colIndices; } + +protected: + MatrixTypeNested m_xpr; + RowIndices m_rowIndices; + ColIndices m_colIndices; +}; + + +// Generic API dispatcher +template +class IndexedViewImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; +}; + +namespace internal { + + +template +struct unary_evaluator, IndexBased> + : evaluator_base > +{ + typedef IndexedView XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of row/col index */, + + FlagsLinearAccessBit = (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1) ? LinearAccessBit : 0, + + FlagsRowMajorBit = traits::FlagsRowMajorBit, + + Flags = (evaluator::Flags & (HereditaryBits & ~RowMajorBit /*| LinearAccessBit | DirectAccessBit*/)) | FlagsLinearAccessBit | FlagsRowMajorBit, + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit unary_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeff(Index row, Index col) const + { + return m_argImpl.coeff(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index row, Index col) + { + return m_argImpl.coeffRef(m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeffRef( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar& coeffRef(Index index) const + { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeffRef( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const CoeffReturnType coeff(Index index) const + { + Index row = XprType::RowsAtCompileTime == 1 ? 0 : index; + Index col = XprType::RowsAtCompileTime == 1 ? index : 0; + return m_argImpl.coeff( m_xpr.rowIndices()[row], m_xpr.colIndices()[col]); + } + +protected: + + evaluator m_argImpl; + const XprType& m_xpr; + +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INDEXED_VIEW_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Inverse.h b/src/3rdparty/eigen/Eigen/src/Core/Inverse.h new file mode 100644 index 0000000..c514438 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Inverse.h @@ -0,0 +1,117 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014-2019 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_INVERSE_H +#define EIGEN_INVERSE_H + +namespace Eigen { + +template class InverseImpl; + +namespace internal { + +template +struct traits > + : traits +{ + typedef typename XprType::PlainObject PlainObject; + typedef traits BaseTraits; + enum { + Flags = BaseTraits::Flags & RowMajorBit + }; +}; + +} // end namespace internal + +/** \class Inverse + * + * \brief Expression of the inverse of another expression + * + * \tparam XprType the type of the expression we are taking the inverse + * + * This class represents an abstract expression of A.inverse() + * and most of the time this is the only way it is used. + * + */ +template +class Inverse : public InverseImpl::StorageKind> +{ +public: + typedef typename XprType::StorageIndex StorageIndex; + typedef typename XprType::Scalar Scalar; + typedef typename internal::ref_selector::type XprTypeNested; + typedef typename internal::remove_all::type XprTypeNestedCleaned; + typedef typename internal::ref_selector::type Nested; + typedef typename internal::remove_all::type NestedExpression; + + explicit EIGEN_DEVICE_FUNC Inverse(const XprType &xpr) + : m_xpr(xpr) + {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index rows() const EIGEN_NOEXCEPT { return m_xpr.cols(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index cols() const EIGEN_NOEXCEPT { return m_xpr.rows(); } + + EIGEN_DEVICE_FUNC const XprTypeNestedCleaned& nestedExpression() const { return m_xpr; } + +protected: + XprTypeNested m_xpr; +}; + +// Generic API dispatcher +template +class InverseImpl + : public internal::generic_xpr_base >::type +{ +public: + typedef typename internal::generic_xpr_base >::type Base; + typedef typename XprType::Scalar Scalar; +private: + + Scalar coeff(Index row, Index col) const; + Scalar coeff(Index i) const; +}; + +namespace internal { + +/** \internal + * \brief Default evaluator for Inverse expression. + * + * This default evaluator for Inverse expression simply evaluate the inverse into a temporary + * by a call to internal::call_assignment_no_alias. + * Therefore, inverse implementers only have to specialize Assignment, ...> for + * there own nested expression. + * + * \sa class Inverse + */ +template +struct unary_evaluator > + : public evaluator::PlainObject> +{ + typedef Inverse InverseType; + typedef typename InverseType::PlainObject PlainObject; + typedef evaluator Base; + + enum { Flags = Base::Flags | EvalBeforeNestingBit }; + + unary_evaluator(const InverseType& inv_xpr) + : m_result(inv_xpr.rows(), inv_xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + internal::call_assignment_no_alias(m_result, inv_xpr); + } + +protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_INVERSE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Map.h b/src/3rdparty/eigen/Eigen/src/Core/Map.h new file mode 100644 index 0000000..218cc15 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Map.h @@ -0,0 +1,171 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAP_H +#define EIGEN_MAP_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : public traits +{ + typedef traits TraitsBase; + enum { + PlainObjectTypeInnerSize = ((traits::Flags&RowMajorBit)==RowMajorBit) + ? PlainObjectType::ColsAtCompileTime + : PlainObjectType::RowsAtCompileTime, + + InnerStrideAtCompileTime = StrideType::InnerStrideAtCompileTime == 0 + ? int(PlainObjectType::InnerStrideAtCompileTime) + : int(StrideType::InnerStrideAtCompileTime), + OuterStrideAtCompileTime = StrideType::OuterStrideAtCompileTime == 0 + ? (InnerStrideAtCompileTime==Dynamic || PlainObjectTypeInnerSize==Dynamic + ? Dynamic + : int(InnerStrideAtCompileTime) * int(PlainObjectTypeInnerSize)) + : int(StrideType::OuterStrideAtCompileTime), + Alignment = int(MapOptions)&int(AlignedMask), + Flags0 = TraitsBase::Flags & (~NestByRefBit), + Flags = is_lvalue::value ? int(Flags0) : (int(Flags0) & ~LvalueBit) + }; +private: + enum { Options }; // Expressions don't have Options +}; +} + +/** \class Map + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing array of data. + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam MapOptions specifies the pointer alignment in bytes. It can be: \c #Aligned128, \c #Aligned64, \c #Aligned32, \c #Aligned16, \c #Aligned8 or \c #Unaligned. + * The default is \c #Unaligned. + * \tparam StrideType optionally specifies strides. By default, Map assumes the memory layout + * of an ordinary, contiguous array. This can be overridden by specifying strides. + * The type passed here must be a specialization of the Stride template, see examples below. + * + * This class represents a matrix or vector expression mapping an existing array of data. + * It can be used to let Eigen interface without any overhead with non-Eigen data structures, + * such as plain C arrays or structures from other libraries. By default, it assumes that the + * data is laid out contiguously in memory. You can however override this by explicitly specifying + * inner and outer strides. + * + * Here's an example of simply mapping a contiguous array as a \ref TopicStorageOrders "column-major" matrix: + * \include Map_simple.cpp + * Output: \verbinclude Map_simple.out + * + * If you need to map non-contiguous arrays, you can do so by specifying strides: + * + * Here's an example of mapping an array as a vector, specifying an inner stride, that is, the pointer + * increment between two consecutive coefficients. Here, we're specifying the inner stride as a compile-time + * fixed value. + * \include Map_inner_stride.cpp + * Output: \verbinclude Map_inner_stride.out + * + * Here's an example of mapping an array while specifying an outer stride. Here, since we're mapping + * as a column-major matrix, 'outer stride' means the pointer increment between two consecutive columns. + * Here, we're specifying the outer stride as a runtime parameter. Note that here \c OuterStride<> is + * a short version of \c OuterStride because the default template parameter of OuterStride + * is \c Dynamic + * \include Map_outer_stride.cpp + * Output: \verbinclude Map_outer_stride.out + * + * For more details and for an example of specifying both an inner and an outer stride, see class Stride. + * + * \b Tip: to change the array of data mapped by a Map object, you can use the C++ + * placement new syntax: + * + * Example: \include Map_placement_new.cpp + * Output: \verbinclude Map_placement_new.out + * + * This class is the return type of PlainObjectBase::Map() but can also be used directly. + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template class Map + : public MapBase > +{ + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Map) + + typedef typename Base::PointerType PointerType; + typedef PointerType PointerArgType; + EIGEN_DEVICE_FUNC + inline PointerType cast_to_pointer_type(PointerArgType ptr) { return ptr; } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : internal::traits::OuterStrideAtCompileTime != Dynamic ? Index(internal::traits::OuterStrideAtCompileTime) + : IsVectorAtCompileTime ? (this->size() * innerStride()) + : int(Flags)&RowMajorBit ? (this->cols() * innerStride()) + : (this->rows() * innerStride()); + } + + /** Constructor in the fixed-size case. + * + * \param dataPtr pointer to the array to map + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + explicit inline Map(PointerArgType dataPtr, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr)), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + /** Constructor in the dynamic-size vector case. + * + * \param dataPtr pointer to the array to map + * \param size the size of the vector expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + inline Map(PointerArgType dataPtr, Index size, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), size), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + /** Constructor in the dynamic-size matrix case. + * + * \param dataPtr pointer to the array to map + * \param rows the number of rows of the matrix expression + * \param cols the number of columns of the matrix expression + * \param stride optional Stride object, passing the strides. + */ + EIGEN_DEVICE_FUNC + inline Map(PointerArgType dataPtr, Index rows, Index cols, const StrideType& stride = StrideType()) + : Base(cast_to_pointer_type(dataPtr), rows, cols), m_stride(stride) + { + PlainObjectType::Base::_check_template_params(); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Map) + + protected: + StrideType m_stride; +}; + + +} // end namespace Eigen + +#endif // EIGEN_MAP_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MapBase.h b/src/3rdparty/eigen/Eigen/src/Core/MapBase.h new file mode 100644 index 0000000..d856447 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MapBase.h @@ -0,0 +1,310 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2007-2010 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MAPBASE_H +#define EIGEN_MAPBASE_H + +#define EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) \ + EIGEN_STATIC_ASSERT((int(internal::evaluator::Flags) & LinearAccessBit) || Derived::IsVectorAtCompileTime, \ + YOU_ARE_TRYING_TO_USE_AN_INDEX_BASED_ACCESSOR_ON_AN_EXPRESSION_THAT_DOES_NOT_SUPPORT_THAT) + +namespace Eigen { + +/** \ingroup Core_Module + * + * \brief Base class for dense Map and Block expression with direct access + * + * This base class provides the const low-level accessors (e.g. coeff, coeffRef) of dense + * Map and Block objects with direct access. + * Typical users do not have to directly deal with this class. + * + * This class can be extended by through the macro plugin \c EIGEN_MAPBASE_PLUGIN. + * See \link TopicCustomizing_Plugins customizing Eigen \endlink for details. + * + * The \c Derived class has to provide the following two methods describing the memory layout: + * \code Index innerStride() const; \endcode + * \code Index outerStride() const; \endcode + * + * \sa class Map, class Block + */ +template class MapBase + : public internal::dense_xpr_base::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + enum { + RowsAtCompileTime = internal::traits::RowsAtCompileTime, + ColsAtCompileTime = internal::traits::ColsAtCompileTime, + InnerStrideAtCompileTime = internal::traits::InnerStrideAtCompileTime, + SizeAtCompileTime = Base::SizeAtCompileTime + }; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef typename internal::conditional< + bool(internal::is_lvalue::value), + Scalar *, + const Scalar *>::type + PointerType; + + using Base::derived; +// using Base::RowsAtCompileTime; +// using Base::ColsAtCompileTime; +// using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + using Base::IsRowMajor; + + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::eval; + + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + + // bug 217 - compile error on ICC 11.1 + using Base::operator=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + + /** \copydoc DenseBase::rows() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_rows.value(); } + /** \copydoc DenseBase::cols() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_cols.value(); } + + /** Returns a pointer to the first coefficient of the matrix or vector. + * + * \note When addressing this data, make sure to honor the strides returned by innerStride() and outerStride(). + * + * \sa innerStride(), outerStride() + */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const { return m_data; } + + /** \copydoc PlainObjectBase::coeff(Index,Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeff(Index rowId, Index colId) const + { + return m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeff(Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeff(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return m_data[index * innerStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index,Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + return this->m_data[colId * colStride() + rowId * rowStride()]; + } + + /** \copydoc PlainObjectBase::coeffRef(Index) const */ + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + /** \internal */ + template + inline PacketScalar packet(Index rowId, Index colId) const + { + return internal::ploadt + (m_data + (colId * colStride() + rowId * rowStride())); + } + + /** \internal */ + template + inline PacketScalar packet(Index index) const + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return internal::ploadt(m_data + index * innerStride()); + } + + /** \internal Constructor for fixed size matrices or vectors */ + EIGEN_DEVICE_FUNC + explicit inline MapBase(PointerType dataPtr) : m_data(dataPtr), m_rows(RowsAtCompileTime), m_cols(ColsAtCompileTime) + { + EIGEN_STATIC_ASSERT_FIXED_SIZE(Derived) + checkSanity(); + } + + /** \internal Constructor for dynamically sized vectors */ + EIGEN_DEVICE_FUNC + inline MapBase(PointerType dataPtr, Index vecSize) + : m_data(dataPtr), + m_rows(RowsAtCompileTime == Dynamic ? vecSize : Index(RowsAtCompileTime)), + m_cols(ColsAtCompileTime == Dynamic ? vecSize : Index(ColsAtCompileTime)) + { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(Derived) + eigen_assert(vecSize >= 0); + eigen_assert(dataPtr == 0 || SizeAtCompileTime == Dynamic || SizeAtCompileTime == vecSize); + checkSanity(); + } + + /** \internal Constructor for dynamically sized matrices */ + EIGEN_DEVICE_FUNC + inline MapBase(PointerType dataPtr, Index rows, Index cols) + : m_data(dataPtr), m_rows(rows), m_cols(cols) + { + eigen_assert( (dataPtr == 0) + || ( rows >= 0 && (RowsAtCompileTime == Dynamic || RowsAtCompileTime == rows) + && cols >= 0 && (ColsAtCompileTime == Dynamic || ColsAtCompileTime == cols))); + checkSanity(); + } + + #ifdef EIGEN_MAPBASE_PLUGIN + #include EIGEN_MAPBASE_PLUGIN + #endif + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) + + template + EIGEN_DEVICE_FUNC + void checkSanity(typename internal::enable_if<(internal::traits::Alignment>0),void*>::type = 0) const + { +#if EIGEN_MAX_ALIGN_BYTES>0 + // innerStride() is not set yet when this function is called, so we optimistically assume the lowest plausible value: + const Index minInnerStride = InnerStrideAtCompileTime == Dynamic ? 1 : Index(InnerStrideAtCompileTime); + EIGEN_ONLY_USED_FOR_DEBUG(minInnerStride); + eigen_assert(( ((internal::UIntPtr(m_data) % internal::traits::Alignment) == 0) + || (cols() * rows() * minInnerStride * sizeof(Scalar)) < internal::traits::Alignment ) && "data is not aligned"); +#endif + } + + template + EIGEN_DEVICE_FUNC + void checkSanity(typename internal::enable_if::Alignment==0,void*>::type = 0) const + {} + + PointerType m_data; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + +/** \ingroup Core_Module + * + * \brief Base class for non-const dense Map and Block expression with direct access + * + * This base class provides the non-const low-level accessors (e.g. coeff and coeffRef) of + * dense Map and Block objects with direct access. + * It inherits MapBase which defines the const variant for reading specific entries. + * + * \sa class Map, class Block + */ +template class MapBase + : public MapBase +{ + typedef MapBase ReadOnlyMapBase; + public: + + typedef MapBase Base; + + typedef typename Base::Scalar Scalar; + typedef typename Base::PacketScalar PacketScalar; + typedef typename Base::StorageIndex StorageIndex; + typedef typename Base::PointerType PointerType; + + using Base::derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + + using Base::innerStride; + using Base::outerStride; + using Base::rowStride; + using Base::colStride; + + typedef typename internal::conditional< + internal::is_lvalue::value, + Scalar, + const Scalar + >::type ScalarWithConstIfNotLvalue; + + EIGEN_DEVICE_FUNC + inline const Scalar* data() const { return this->m_data; } + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue* data() { return this->m_data; } // no const-cast here so non-const-correct code will give a compile error + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue& coeffRef(Index row, Index col) + { + return this->m_data[col * colStride() + row * rowStride()]; + } + + EIGEN_DEVICE_FUNC + inline ScalarWithConstIfNotLvalue& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + return this->m_data[index * innerStride()]; + } + + template + inline void writePacket(Index row, Index col, const PacketScalar& val) + { + internal::pstoret + (this->m_data + (col * colStride() + row * rowStride()), val); + } + + template + inline void writePacket(Index index, const PacketScalar& val) + { + EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS(Derived) + internal::pstoret + (this->m_data + index * innerStride(), val); + } + + EIGEN_DEVICE_FUNC explicit inline MapBase(PointerType dataPtr) : Base(dataPtr) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index vecSize) : Base(dataPtr, vecSize) {} + EIGEN_DEVICE_FUNC inline MapBase(PointerType dataPtr, Index rows, Index cols) : Base(dataPtr, rows, cols) {} + + EIGEN_DEVICE_FUNC + Derived& operator=(const MapBase& other) + { + ReadOnlyMapBase::Base::operator=(other); + return derived(); + } + + // In theory we could simply refer to Base:Base::operator=, but MSVC does not like Base::Base, + // see bugs 821 and 920. + using ReadOnlyMapBase::Base::operator=; + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MapBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MapBase) +}; + +#undef EIGEN_STATIC_ASSERT_INDEX_BASED_ACCESS + +} // end namespace Eigen + +#endif // EIGEN_MAPBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h b/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h new file mode 100644 index 0000000..61b78f4 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MathFunctions.h @@ -0,0 +1,2057 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (c) 2021, NVIDIA CORPORATION. All rights reserved. +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONS_H +#define EIGEN_MATHFUNCTIONS_H + +// TODO this should better be moved to NumTraits +// Source: WolframAlpha +#define EIGEN_PI 3.141592653589793238462643383279502884197169399375105820974944592307816406L +#define EIGEN_LOG2E 1.442695040888963407359924681001892137426645954152985934135449406931109219L +#define EIGEN_LN2 0.693147180559945309417232121458176568075500134360255254120680009493393621L + +namespace Eigen { + +// On WINCE, std::abs is defined for int only, so let's defined our own overloads: +// This issue has been confirmed with MSVC 2008 only, but the issue might exist for more recent versions too. +#if EIGEN_OS_WINCE && EIGEN_COMP_MSVC && EIGEN_COMP_MSVC<=1500 +long abs(long x) { return (labs(x)); } +double abs(double x) { return (fabs(x)); } +float abs(float x) { return (fabsf(x)); } +long double abs(long double x) { return (fabsl(x)); } +#endif + +namespace internal { + +/** \internal \class global_math_functions_filtering_base + * + * What it does: + * Defines a typedef 'type' as follows: + * - if type T has a member typedef Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl, then + * global_math_functions_filtering_base::type is a typedef for it. + * - otherwise, global_math_functions_filtering_base::type is a typedef for T. + * + * How it's used: + * To allow to defined the global math functions (like sin...) in certain cases, like the Array expressions. + * When you do sin(array1+array2), the object array1+array2 has a complicated expression type, all what you want to know + * is that it inherits ArrayBase. So we implement a partial specialization of sin_impl for ArrayBase. + * So we must make sure to use sin_impl > and not sin_impl, otherwise our partial specialization + * won't be used. How does sin know that? That's exactly what global_math_functions_filtering_base tells it. + * + * How it's implemented: + * SFINAE in the style of enable_if. Highly susceptible of breaking compilers. With GCC, it sure does work, but if you replace + * the typename dummy by an integer template parameter, it doesn't work anymore! + */ + +template +struct global_math_functions_filtering_base +{ + typedef T type; +}; + +template struct always_void { typedef void type; }; + +template +struct global_math_functions_filtering_base + ::type + > +{ + typedef typename T::Eigen_BaseClassForSpecializationOfGlobalMathFuncImpl type; +}; + +#define EIGEN_MATHFUNC_IMPL(func, scalar) Eigen::internal::func##_impl::type> +#define EIGEN_MATHFUNC_RETVAL(func, scalar) typename Eigen::internal::func##_retval::type>::type + +/**************************************************************************** +* Implementation of real * +****************************************************************************/ + +template::IsComplex> +struct real_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x; + } +}; + +template +struct real_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + using std::real; + return real(x); + } +}; + +template struct real_impl : real_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct real_impl > +{ + typedef T RealScalar; + EIGEN_DEVICE_FUNC + static inline T run(const std::complex& x) + { + return x.real(); + } +}; +#endif + +template +struct real_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of imag * +****************************************************************************/ + +template::IsComplex> +struct imag_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar&) + { + return RealScalar(0); + } +}; + +template +struct imag_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + using std::imag; + return imag(x); + } +}; + +template struct imag_impl : imag_default_impl {}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct imag_impl > +{ + typedef T RealScalar; + EIGEN_DEVICE_FUNC + static inline T run(const std::complex& x) + { + return x.imag(); + } +}; +#endif + +template +struct imag_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of real_ref * +****************************************************************************/ + +template +struct real_ref_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar& run(Scalar& x) + { + return reinterpret_cast(&x)[0]; + } + EIGEN_DEVICE_FUNC + static inline const RealScalar& run(const Scalar& x) + { + return reinterpret_cast(&x)[0]; + } +}; + +template +struct real_ref_retval +{ + typedef typename NumTraits::Real & type; +}; + +/**************************************************************************** +* Implementation of imag_ref * +****************************************************************************/ + +template +struct imag_ref_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar& run(Scalar& x) + { + return reinterpret_cast(&x)[1]; + } + EIGEN_DEVICE_FUNC + static inline const RealScalar& run(const Scalar& x) + { + return reinterpret_cast(&x)[1]; + } +}; + +template +struct imag_ref_default_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Scalar run(Scalar&) + { + return Scalar(0); + } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline const Scalar run(const Scalar&) + { + return Scalar(0); + } +}; + +template +struct imag_ref_impl : imag_ref_default_impl::IsComplex> {}; + +template +struct imag_ref_retval +{ + typedef typename NumTraits::Real & type; +}; + +/**************************************************************************** +* Implementation of conj * +****************************************************************************/ + +template::IsComplex> +struct conj_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + return x; + } +}; + +template +struct conj_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + using std::conj; + return conj(x); + } +}; + +template::IsComplex> +struct conj_impl : conj_default_impl {}; + +template +struct conj_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of abs2 * +****************************************************************************/ + +template +struct abs2_impl_default +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x*x; + } +}; + +template +struct abs2_impl_default // IsComplex +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return x.real()*x.real() + x.imag()*x.imag(); + } +}; + +template +struct abs2_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return abs2_impl_default::IsComplex>::run(x); + } +}; + +template +struct abs2_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of sqrt/rsqrt * +****************************************************************************/ + +template +struct sqrt_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE Scalar run(const Scalar& x) + { + EIGEN_USING_STD(sqrt); + return sqrt(x); + } +}; + +// Complex sqrt defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_sqrt(const std::complex& a_x); + +// Custom implementation is faster than `std::sqrt`, works on +// GPU, and correctly handles special cases (unlike MSVC). +template +struct sqrt_impl > +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) + { + return complex_sqrt(x); + } +}; + +template +struct sqrt_retval +{ + typedef Scalar type; +}; + +// Default implementation relies on numext::sqrt, at bottom of file. +template +struct rsqrt_impl; + +// Complex rsqrt defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_rsqrt(const std::complex& a_x); + +template +struct rsqrt_impl > +{ + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE std::complex run(const std::complex& x) + { + return complex_rsqrt(x); + } +}; + +template +struct rsqrt_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of norm1 * +****************************************************************************/ + +template +struct norm1_default_impl; + +template +struct norm1_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + EIGEN_USING_STD(abs); + return abs(x.real()) + abs(x.imag()); + } +}; + +template +struct norm1_default_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_USING_STD(abs); + return abs(x); + } +}; + +template +struct norm1_impl : norm1_default_impl::IsComplex> {}; + +template +struct norm1_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of hypot * +****************************************************************************/ + +template struct hypot_impl; + +template +struct hypot_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of cast * +****************************************************************************/ + +template +struct cast_impl +{ + EIGEN_DEVICE_FUNC + static inline NewType run(const OldType& x) + { + return static_cast(x); + } +}; + +// Casting from S -> Complex leads to an implicit conversion from S to T, +// generating warnings on clang. Here we explicitly cast the real component. +template +struct cast_impl::IsComplex && NumTraits::IsComplex + >::type> +{ + EIGEN_DEVICE_FUNC + static inline NewType run(const OldType& x) + { + typedef typename NumTraits::Real NewReal; + return static_cast(static_cast(x)); + } +}; + +// here, for once, we're plainly returning NewType: we don't want cast to do weird things. + +template +EIGEN_DEVICE_FUNC +inline NewType cast(const OldType& x) +{ + return cast_impl::run(x); +} + +/**************************************************************************** +* Implementation of round * +****************************************************************************/ + +template +struct round_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) +#if EIGEN_HAS_CXX11_MATH + EIGEN_USING_STD(round); +#endif + return Scalar(round(x)); + } +}; + +#if !EIGEN_HAS_CXX11_MATH +#if EIGEN_HAS_C99_MATH +// Use ::roundf for float. +template<> +struct round_impl { + EIGEN_DEVICE_FUNC + static inline float run(const float& x) + { + return ::roundf(x); + } +}; +#else +template +struct round_using_floor_ceil_impl +{ + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) + // Without C99 round/roundf, resort to floor/ceil. + EIGEN_USING_STD(floor); + EIGEN_USING_STD(ceil); + // If not enough precision to resolve a decimal at all, return the input. + // Otherwise, adding 0.5 can trigger an increment by 1. + const Scalar limit = Scalar(1ull << (NumTraits::digits() - 1)); + if (x >= limit || x <= -limit) { + return x; + } + return (x > Scalar(0)) ? Scalar(floor(x + Scalar(0.5))) : Scalar(ceil(x - Scalar(0.5))); + } +}; + +template<> +struct round_impl : round_using_floor_ceil_impl {}; + +template<> +struct round_impl : round_using_floor_ceil_impl {}; +#endif // EIGEN_HAS_C99_MATH +#endif // !EIGEN_HAS_CXX11_MATH + +template +struct round_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of rint * +****************************************************************************/ + +template +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT((!NumTraits::IsComplex), NUMERIC_TYPE_MUST_BE_REAL) +#if EIGEN_HAS_CXX11_MATH + EIGEN_USING_STD(rint); +#endif + return rint(x); + } +}; + +#if !EIGEN_HAS_CXX11_MATH +template<> +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline double run(const double& x) + { + return ::rint(x); + } +}; +template<> +struct rint_impl { + EIGEN_DEVICE_FUNC + static inline float run(const float& x) + { + return ::rintf(x); + } +}; +#endif + +template +struct rint_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of arg * +****************************************************************************/ + +// Visual Studio 2017 has a bug where arg(float) returns 0 for negative inputs. +// This seems to be fixed in VS 2019. +#if EIGEN_HAS_CXX11_MATH && (!EIGEN_COMP_MSVC || EIGEN_COMP_MSVC >= 1920) +// std::arg is only defined for types of std::complex, or integer types or float/double/long double +template::IsComplex || is_integral::value + || is_same::value || is_same::value + || is_same::value > +struct arg_default_impl; + +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + #if defined(EIGEN_HIP_DEVICE_COMPILE) + // HIP does not seem to have a native device side implementation for the math routine "arg" + using std::arg; + #else + EIGEN_USING_STD(arg); + #endif + return static_cast(arg(x)); + } +}; + +// Must be non-complex floating-point type (e.g. half/bfloat16). +template +struct arg_default_impl { + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return (x < Scalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; +#else +template::IsComplex> +struct arg_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + return (x < RealScalar(0)) ? RealScalar(EIGEN_PI) : RealScalar(0); + } +}; + +template +struct arg_default_impl +{ + typedef typename NumTraits::Real RealScalar; + EIGEN_DEVICE_FUNC + static inline RealScalar run(const Scalar& x) + { + EIGEN_USING_STD(arg); + return arg(x); + } +}; +#endif +template struct arg_impl : arg_default_impl {}; + +template +struct arg_retval +{ + typedef typename NumTraits::Real type; +}; + +/**************************************************************************** +* Implementation of expm1 * +****************************************************************************/ + +// This implementation is based on GSL Math's expm1. +namespace std_fallback { + // fallback expm1 implementation in case there is no expm1(Scalar) function in namespace of Scalar, + // or that there is no suitable std::expm1 function available. Implementation + // attributed to Kahan. See: http://www.plunk.org/~hatch/rightway.php. + template + EIGEN_DEVICE_FUNC inline Scalar expm1(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + + EIGEN_USING_STD(exp); + Scalar u = exp(x); + if (numext::equal_strict(u, Scalar(1))) { + return x; + } + Scalar um1 = u - RealScalar(1); + if (numext::equal_strict(um1, Scalar(-1))) { + return RealScalar(-1); + } + + EIGEN_USING_STD(log); + Scalar logu = log(u); + return numext::equal_strict(u, logu) ? u : (u - RealScalar(1)) * x / logu; + } +} + +template +struct expm1_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + #if EIGEN_HAS_CXX11_MATH + using std::expm1; + #else + using std_fallback::expm1; + #endif + return expm1(x); + } +}; + +template +struct expm1_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of log * +****************************************************************************/ + +// Complex log defined in MathFunctionsImpl.h. +template EIGEN_DEVICE_FUNC std::complex complex_log(const std::complex& z); + +template +struct log_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_USING_STD(log); + return static_cast(log(x)); + } +}; + +template +struct log_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run(const std::complex& z) + { + return complex_log(z); + } +}; + +/**************************************************************************** +* Implementation of log1p * +****************************************************************************/ + +namespace std_fallback { + // fallback log1p implementation in case there is no log1p(Scalar) function in namespace of Scalar, + // or that there is no suitable std::log1p function available + template + EIGEN_DEVICE_FUNC inline Scalar log1p(const Scalar& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + typedef typename NumTraits::Real RealScalar; + EIGEN_USING_STD(log); + Scalar x1p = RealScalar(1) + x; + Scalar log_1p = log_impl::run(x1p); + const bool is_small = numext::equal_strict(x1p, Scalar(1)); + const bool is_inf = numext::equal_strict(x1p, log_1p); + return (is_small || is_inf) ? x : x * (log_1p / (x1p - RealScalar(1))); + } +} + +template +struct log1p_impl { + EIGEN_DEVICE_FUNC static inline Scalar run(const Scalar& x) + { + EIGEN_STATIC_ASSERT_NON_INTEGER(Scalar) + #if EIGEN_HAS_CXX11_MATH + using std::log1p; + #else + using std_fallback::log1p; + #endif + return log1p(x); + } +}; + +// Specialization for complex types that are not supported by std::log1p. +template +struct log1p_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run( + const std::complex& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + return std_fallback::log1p(x); + } +}; + +template +struct log1p_retval +{ + typedef Scalar type; +}; + +/**************************************************************************** +* Implementation of pow * +****************************************************************************/ + +template::IsInteger&&NumTraits::IsInteger> +struct pow_impl +{ + //typedef Scalar retval; + typedef typename ScalarBinaryOpTraits >::ReturnType result_type; + static EIGEN_DEVICE_FUNC inline result_type run(const ScalarX& x, const ScalarY& y) + { + EIGEN_USING_STD(pow); + return pow(x, y); + } +}; + +template +struct pow_impl +{ + typedef ScalarX result_type; + static EIGEN_DEVICE_FUNC inline ScalarX run(ScalarX x, ScalarY y) + { + ScalarX res(1); + eigen_assert(!NumTraits::IsSigned || y >= 0); + if(y & 1) res *= x; + y >>= 1; + while(y) + { + x *= x; + if(y&1) res *= x; + y >>= 1; + } + return res; + } +}; + +/**************************************************************************** +* Implementation of random * +****************************************************************************/ + +template +struct random_default_impl {}; + +template +struct random_impl : random_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template +struct random_retval +{ + typedef Scalar type; +}; + +template inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(const Scalar& x, const Scalar& y); +template inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(); + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + return x + (y-x) * Scalar(std::rand()) / Scalar(RAND_MAX); + } + static inline Scalar run() + { + return run(Scalar(NumTraits::IsSigned ? -1 : 0), Scalar(1)); + } +}; + +enum { + meta_floor_log2_terminate, + meta_floor_log2_move_up, + meta_floor_log2_move_down, + meta_floor_log2_bogus +}; + +template struct meta_floor_log2_selector +{ + enum { middle = (lower + upper) / 2, + value = (upper <= lower + 1) ? int(meta_floor_log2_terminate) + : (n < (1 << middle)) ? int(meta_floor_log2_move_down) + : (n==0) ? int(meta_floor_log2_bogus) + : int(meta_floor_log2_move_up) + }; +}; + +template::value> +struct meta_floor_log2 {}; + +template +struct meta_floor_log2 +{ + enum { value = meta_floor_log2::middle>::value }; +}; + +template +struct meta_floor_log2 +{ + enum { value = meta_floor_log2::middle, upper>::value }; +}; + +template +struct meta_floor_log2 +{ + enum { value = (n >= ((unsigned int)(1) << (lower+1))) ? lower+1 : lower }; +}; + +template +struct meta_floor_log2 +{ + // no value, error at compile time +}; + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + if (y <= x) + return x; + // ScalarU is the unsigned counterpart of Scalar, possibly Scalar itself. + typedef typename make_unsigned::type ScalarU; + // ScalarX is the widest of ScalarU and unsigned int. + // We'll deal only with ScalarX and unsigned int below thus avoiding signed + // types and arithmetic and signed overflows (which are undefined behavior). + typedef typename conditional<(ScalarU(-1) > unsigned(-1)), ScalarU, unsigned>::type ScalarX; + // The following difference doesn't overflow, provided our integer types are two's + // complement and have the same number of padding bits in signed and unsigned variants. + // This is the case in most modern implementations of C++. + ScalarX range = ScalarX(y) - ScalarX(x); + ScalarX offset = 0; + ScalarX divisor = 1; + ScalarX multiplier = 1; + const unsigned rand_max = RAND_MAX; + if (range <= rand_max) divisor = (rand_max + 1) / (range + 1); + else multiplier = 1 + range / (rand_max + 1); + // Rejection sampling. + do { + offset = (unsigned(std::rand()) * multiplier) / divisor; + } while (offset > range); + return Scalar(ScalarX(x) + offset); + } + + static inline Scalar run() + { +#ifdef EIGEN_MAKING_DOCS + return run(Scalar(NumTraits::IsSigned ? -10 : 0), Scalar(10)); +#else + enum { rand_bits = meta_floor_log2<(unsigned int)(RAND_MAX)+1>::value, + scalar_bits = sizeof(Scalar) * CHAR_BIT, + shift = EIGEN_PLAIN_ENUM_MAX(0, int(rand_bits) - int(scalar_bits)), + offset = NumTraits::IsSigned ? (1 << (EIGEN_PLAIN_ENUM_MIN(rand_bits,scalar_bits)-1)) : 0 + }; + return Scalar((std::rand() >> shift) - offset); +#endif + } +}; + +template +struct random_default_impl +{ + static inline Scalar run(const Scalar& x, const Scalar& y) + { + return Scalar(random(x.real(), y.real()), + random(x.imag(), y.imag())); + } + static inline Scalar run() + { + typedef typename NumTraits::Real RealScalar; + return Scalar(random(), random()); + } +}; + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random(const Scalar& x, const Scalar& y) +{ + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(x, y); +} + +template +inline EIGEN_MATHFUNC_RETVAL(random, Scalar) random() +{ + return EIGEN_MATHFUNC_IMPL(random, Scalar)::run(); +} + +// Implementation of is* functions + +// std::is* do not work with fast-math and gcc, std::is* are available on MSVC 2013 and newer, as well as in clang. +#if (EIGEN_HAS_CXX11_MATH && !(EIGEN_COMP_GNUC_STRICT && __FINITE_MATH_ONLY__)) || (EIGEN_COMP_MSVC>=1800) || (EIGEN_COMP_CLANG) +#define EIGEN_USE_STD_FPCLASSIFY 1 +#else +#define EIGEN_USE_STD_FPCLASSIFY 0 +#endif + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isnan_impl(const T&) { return false; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isinf_impl(const T&) { return false; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if::value,bool>::type +isfinite_impl(const T&) { return true; } + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isfinite_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isfinite)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isfinite; + return isfinite EIGEN_NOT_A_MACRO (x); + #else + return x<=NumTraits::highest() && x>=NumTraits::lowest(); + #endif +} + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isinf_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isinf)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isinf; + return isinf EIGEN_NOT_A_MACRO (x); + #else + return x>NumTraits::highest() || x::lowest(); + #endif +} + +template +EIGEN_DEVICE_FUNC +typename internal::enable_if<(!internal::is_integral::value)&&(!NumTraits::IsComplex),bool>::type +isnan_impl(const T& x) +{ + #if defined(EIGEN_GPU_COMPILE_PHASE) + return (::isnan)(x); + #elif EIGEN_USE_STD_FPCLASSIFY + using std::isnan; + return isnan EIGEN_NOT_A_MACRO (x); + #else + return x != x; + #endif +} + +#if (!EIGEN_USE_STD_FPCLASSIFY) + +#if EIGEN_COMP_MSVC + +template EIGEN_DEVICE_FUNC bool isinf_msvc_helper(T x) +{ + return _fpclass(x)==_FPCLASS_NINF || _fpclass(x)==_FPCLASS_PINF; +} + +//MSVC defines a _isnan builtin function, but for double only +EIGEN_DEVICE_FUNC inline bool isnan_impl(const long double& x) { return _isnan(x)!=0; } +EIGEN_DEVICE_FUNC inline bool isnan_impl(const double& x) { return _isnan(x)!=0; } +EIGEN_DEVICE_FUNC inline bool isnan_impl(const float& x) { return _isnan(x)!=0; } + +EIGEN_DEVICE_FUNC inline bool isinf_impl(const long double& x) { return isinf_msvc_helper(x); } +EIGEN_DEVICE_FUNC inline bool isinf_impl(const double& x) { return isinf_msvc_helper(x); } +EIGEN_DEVICE_FUNC inline bool isinf_impl(const float& x) { return isinf_msvc_helper(x); } + +#elif (defined __FINITE_MATH_ONLY__ && __FINITE_MATH_ONLY__ && EIGEN_COMP_GNUC) + +#if EIGEN_GNUC_AT_LEAST(5,0) + #define EIGEN_TMP_NOOPT_ATTRIB EIGEN_DEVICE_FUNC inline __attribute__((optimize("no-finite-math-only"))) +#else + // NOTE the inline qualifier and noinline attribute are both needed: the former is to avoid linking issue (duplicate symbol), + // while the second prevent too aggressive optimizations in fast-math mode: + #define EIGEN_TMP_NOOPT_ATTRIB EIGEN_DEVICE_FUNC inline __attribute__((noinline,optimize("no-finite-math-only"))) +#endif + +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const long double& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const double& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isnan_impl(const float& x) { return __builtin_isnan(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const double& x) { return __builtin_isinf(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const float& x) { return __builtin_isinf(x); } +template<> EIGEN_TMP_NOOPT_ATTRIB bool isinf_impl(const long double& x) { return __builtin_isinf(x); } + +#undef EIGEN_TMP_NOOPT_ATTRIB + +#endif + +#endif + +// The following overload are defined at the end of this file +template EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x); +template EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x); +template EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x); + +template T generic_fast_tanh_float(const T& a_x); +} // end namespace internal + +/**************************************************************************** +* Generic math functions * +****************************************************************************/ + +namespace numext { + +#if (!defined(EIGEN_GPUCC) || defined(EIGEN_CONSTEXPR_ARE_DEVICE_FUNC)) +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) +{ + EIGEN_USING_STD(min) + return min EIGEN_NOT_A_MACRO (x,y); +} + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) +{ + EIGEN_USING_STD(max) + return max EIGEN_NOT_A_MACRO (x,y); +} +#else +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T mini(const T& x, const T& y) +{ + return y < x ? y : x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float mini(const float& x, const float& y) +{ + return fminf(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double mini(const double& x, const double& y) +{ + return fmin(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double mini(const long double& x, const long double& y) +{ +#if defined(EIGEN_HIPCC) + // no "fminl" on HIP yet + return (x < y) ? x : y; +#else + return fminl(x, y); +#endif +} + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T maxi(const T& x, const T& y) +{ + return x < y ? y : x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float maxi(const float& x, const float& y) +{ + return fmaxf(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double maxi(const double& x, const double& y) +{ + return fmax(x, y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double maxi(const long double& x, const long double& y) +{ +#if defined(EIGEN_HIPCC) + // no "fmaxl" on HIP yet + return (x > y) ? x : y; +#else + return fmaxl(x, y); +#endif +} +#endif + +#if defined(SYCL_DEVICE_ONLY) + + +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_char) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_short) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_int) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_long) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uchar) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ushort) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_uint) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_ulong) +#define SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY(NAME, FUNC) +#define SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY(NAME, FUNC) +#define SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(NAME, FUNC) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC,cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(NAME, FUNC) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC,cl::sycl::cl_double) +#define SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(NAME, FUNC, RET_TYPE) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_float) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, cl::sycl::cl_double) + +#define SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ +template<> \ + EIGEN_DEVICE_FUNC \ + EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE& x) { \ + return cl::sycl::FUNC(x); \ + } + +#define SYCL_SPECIALIZE_UNARY_FUNC(NAME, FUNC, TYPE) \ + SYCL_SPECIALIZE_GEN_UNARY_FUNC(NAME, FUNC, TYPE, TYPE) + +#define SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE1, ARG_TYPE2) \ + template<> \ + EIGEN_DEVICE_FUNC \ + EIGEN_ALWAYS_INLINE RET_TYPE NAME(const ARG_TYPE1& x, const ARG_TYPE2& y) { \ + return cl::sycl::FUNC(x, y); \ + } + +#define SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE) \ + SYCL_SPECIALIZE_GEN1_BINARY_FUNC(NAME, FUNC, RET_TYPE, ARG_TYPE, ARG_TYPE) + +#define SYCL_SPECIALIZE_BINARY_FUNC(NAME, FUNC, TYPE) \ + SYCL_SPECIALIZE_GEN2_BINARY_FUNC(NAME, FUNC, TYPE, TYPE) + +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(mini, min) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(mini, fmin) +SYCL_SPECIALIZE_INTEGER_TYPES_BINARY(maxi, max) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(maxi, fmax) + +#endif + + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(real, Scalar) real(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(real, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline typename internal::add_const_on_value_type< EIGEN_MATHFUNC_RETVAL(real_ref, Scalar) >::type real_ref(const Scalar& x) +{ + return internal::real_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(real_ref, Scalar) real_ref(Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(real_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(imag, Scalar) imag(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(imag, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(arg, Scalar) arg(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(arg, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline typename internal::add_const_on_value_type< EIGEN_MATHFUNC_RETVAL(imag_ref, Scalar) >::type imag_ref(const Scalar& x) +{ + return internal::imag_ref_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(imag_ref, Scalar) imag_ref(Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(imag_ref, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(conj, Scalar) conj(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(conj, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(abs2, Scalar) abs2(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(abs2, Scalar)::run(x); +} + +EIGEN_DEVICE_FUNC +inline bool abs2(bool x) { return x; } + +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE T absdiff(const T& x, const T& y) +{ + return x > y ? x - y : y - x; +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE float absdiff(const float& x, const float& y) +{ + return fabsf(x - y); +} +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE double absdiff(const double& x, const double& y) +{ + return fabs(x - y); +} + +#if !defined(EIGEN_GPUCC) +// HIP and CUDA do not support long double. +template<> +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE long double absdiff(const long double& x, const long double& y) { + return fabsl(x - y); +} +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(norm1, Scalar) norm1(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(norm1, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(hypot, Scalar) hypot(const Scalar& x, const Scalar& y) +{ + return EIGEN_MATHFUNC_IMPL(hypot, Scalar)::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) + SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(hypot, hypot) +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(log1p, Scalar) log1p(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(log1p, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log1p, log1p) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float log1p(const float &x) { return ::log1pf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double log1p(const double &x) { return ::log1p(x); } +#endif + +template +EIGEN_DEVICE_FUNC +inline typename internal::pow_impl::result_type pow(const ScalarX& x, const ScalarY& y) +{ + return internal::pow_impl::run(x, y); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(pow, pow) +#endif + +template EIGEN_DEVICE_FUNC bool (isnan) (const T &x) { return internal::isnan_impl(x); } +template EIGEN_DEVICE_FUNC bool (isinf) (const T &x) { return internal::isinf_impl(x); } +template EIGEN_DEVICE_FUNC bool (isfinite)(const T &x) { return internal::isfinite_impl(x); } + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isnan, isnan, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isinf, isinf, bool) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE(isfinite, isfinite, bool) +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(rint, Scalar) rint(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(rint, Scalar)::run(x); +} + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(round, Scalar) round(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(round, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(round, round) +#endif + +template +EIGEN_DEVICE_FUNC +T (floor)(const T& x) +{ + EIGEN_USING_STD(floor) + return floor(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(floor, floor) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float floor(const float &x) { return ::floorf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double floor(const double &x) { return ::floor(x); } +#endif + +template +EIGEN_DEVICE_FUNC +T (ceil)(const T& x) +{ + EIGEN_USING_STD(ceil); + return ceil(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(ceil, ceil) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float ceil(const float &x) { return ::ceilf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double ceil(const double &x) { return ::ceil(x); } +#endif + + +/** Log base 2 for 32 bits positive integers. + * Conveniently returns 0 for x==0. */ +inline int log2(int x) +{ + eigen_assert(x>=0); + unsigned int v(x); + static const int table[32] = { 0, 9, 1, 10, 13, 21, 2, 29, 11, 14, 16, 18, 22, 25, 3, 30, 8, 12, 20, 28, 15, 17, 24, 7, 19, 27, 23, 6, 26, 5, 4, 31 }; + v |= v >> 1; + v |= v >> 2; + v |= v >> 4; + v |= v >> 8; + v |= v >> 16; + return table[(v * 0x07C4ACDDU) >> 27]; +} + +/** \returns the square root of \a x. + * + * It is essentially equivalent to + * \code using std::sqrt; return sqrt(x); \endcode + * but slightly faster for float/double and some compilers (e.g., gcc), thanks to + * specializations when SSE is enabled. + * + * It's usage is justified in performance critical functions, like norm/normalize. + */ +template +EIGEN_DEVICE_FUNC +EIGEN_ALWAYS_INLINE EIGEN_MATHFUNC_RETVAL(sqrt, Scalar) sqrt(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(sqrt, Scalar)::run(x); +} + +// Boolean specialization, avoids implicit float to bool conversion (-Wimplicit-conversion-floating-point-to-bool). +template<> +EIGEN_DEFINE_FUNCTION_ALLOWING_MULTIPLE_DEFINITIONS EIGEN_DEVICE_FUNC +bool sqrt(const bool &x) { return x; } + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sqrt, sqrt) +#endif + +/** \returns the reciprocal square root of \a x. **/ +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T rsqrt(const T& x) +{ + return internal::rsqrt_impl::run(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T log(const T &x) { + return internal::log_impl::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(log, log) +#endif + + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float log(const float &x) { return ::logf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double log(const double &x) { return ::log(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +typename internal::enable_if::IsSigned || NumTraits::IsComplex,typename NumTraits::Real>::type +abs(const T &x) { + EIGEN_USING_STD(abs); + return abs(x); +} + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +typename internal::enable_if::IsSigned || NumTraits::IsComplex),typename NumTraits::Real>::type +abs(const T &x) { + return x; +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_INTEGER_TYPES_UNARY(abs, abs) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(abs, fabs) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float abs(const float &x) { return ::fabsf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double abs(const double &x) { return ::fabs(x); } + +template <> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float abs(const std::complex& x) { + return ::hypotf(x.real(), x.imag()); +} + +template <> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double abs(const std::complex& x) { + return ::hypot(x.real(), x.imag()); +} +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T exp(const T &x) { + EIGEN_USING_STD(exp); + return exp(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(exp, exp) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float exp(const float &x) { return ::expf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double exp(const double &x) { return ::exp(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +std::complex exp(const std::complex& x) { + float com = ::expf(x.real()); + float res_real = com * ::cosf(x.imag()); + float res_imag = com * ::sinf(x.imag()); + return std::complex(res_real, res_imag); +} + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +std::complex exp(const std::complex& x) { + double com = ::exp(x.real()); + double res_real = com * ::cos(x.imag()); + double res_imag = com * ::sin(x.imag()); + return std::complex(res_real, res_imag); +} +#endif + +template +EIGEN_DEVICE_FUNC +inline EIGEN_MATHFUNC_RETVAL(expm1, Scalar) expm1(const Scalar& x) +{ + return EIGEN_MATHFUNC_IMPL(expm1, Scalar)::run(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(expm1, expm1) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float expm1(const float &x) { return ::expm1f(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double expm1(const double &x) { return ::expm1(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T cos(const T &x) { + EIGEN_USING_STD(cos); + return cos(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cos,cos) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float cos(const float &x) { return ::cosf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double cos(const double &x) { return ::cos(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T sin(const T &x) { + EIGEN_USING_STD(sin); + return sin(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sin, sin) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float sin(const float &x) { return ::sinf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double sin(const double &x) { return ::sin(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T tan(const T &x) { + EIGEN_USING_STD(tan); + return tan(x); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tan, tan) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tan(const float &x) { return ::tanf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double tan(const double &x) { return ::tan(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T acos(const T &x) { + EIGEN_USING_STD(acos); + return acos(x); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T acosh(const T &x) { + EIGEN_USING_STD(acosh); + return static_cast(acosh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acos, acos) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(acosh, acosh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float acos(const float &x) { return ::acosf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double acos(const double &x) { return ::acos(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T asin(const T &x) { + EIGEN_USING_STD(asin); + return asin(x); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T asinh(const T &x) { + EIGEN_USING_STD(asinh); + return static_cast(asinh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asin, asin) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(asinh, asinh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float asin(const float &x) { return ::asinf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double asin(const double &x) { return ::asin(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T atan(const T &x) { + EIGEN_USING_STD(atan); + return static_cast(atan(x)); +} + +#if EIGEN_HAS_CXX11_MATH +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T atanh(const T &x) { + EIGEN_USING_STD(atanh); + return static_cast(atanh(x)); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atan, atan) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(atanh, atanh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float atan(const float &x) { return ::atanf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double atan(const double &x) { return ::atan(x); } +#endif + + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T cosh(const T &x) { + EIGEN_USING_STD(cosh); + return static_cast(cosh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(cosh, cosh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float cosh(const float &x) { return ::coshf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double cosh(const double &x) { return ::cosh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T sinh(const T &x) { + EIGEN_USING_STD(sinh); + return static_cast(sinh(x)); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(sinh, sinh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float sinh(const float &x) { return ::sinhf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double sinh(const double &x) { return ::sinh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T tanh(const T &x) { + EIGEN_USING_STD(tanh); + return tanh(x); +} + +#if (!defined(EIGEN_GPUCC)) && EIGEN_FAST_MATH && !defined(SYCL_DEVICE_ONLY) +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tanh(float x) { return internal::generic_fast_tanh_float(x); } +#endif + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_UNARY(tanh, tanh) +#endif + +#if defined(EIGEN_GPUCC) +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float tanh(const float &x) { return ::tanhf(x); } + +template<> EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double tanh(const double &x) { return ::tanh(x); } +#endif + +template +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +T fmod(const T& a, const T& b) { + EIGEN_USING_STD(fmod); + return fmod(a, b); +} + +#if defined(SYCL_DEVICE_ONLY) +SYCL_SPECIALIZE_FLOATING_TYPES_BINARY(fmod, fmod) +#endif + +#if defined(EIGEN_GPUCC) +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +float fmod(const float& a, const float& b) { + return ::fmodf(a, b); +} + +template <> +EIGEN_DEVICE_FUNC EIGEN_ALWAYS_INLINE +double fmod(const double& a, const double& b) { + return ::fmod(a, b); +} +#endif + +#if defined(SYCL_DEVICE_ONLY) +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_SIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_INTEGER_TYPES_BINARY +#undef SYCL_SPECIALIZE_UNSIGNED_INTEGER_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_BINARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY +#undef SYCL_SPECIALIZE_FLOATING_TYPES_UNARY_FUNC_RET_TYPE +#undef SYCL_SPECIALIZE_GEN_UNARY_FUNC +#undef SYCL_SPECIALIZE_UNARY_FUNC +#undef SYCL_SPECIALIZE_GEN1_BINARY_FUNC +#undef SYCL_SPECIALIZE_GEN2_BINARY_FUNC +#undef SYCL_SPECIALIZE_BINARY_FUNC +#endif + +} // end namespace numext + +namespace internal { + +template +EIGEN_DEVICE_FUNC bool isfinite_impl(const std::complex& x) +{ + return (numext::isfinite)(numext::real(x)) && (numext::isfinite)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isnan_impl(const std::complex& x) +{ + return (numext::isnan)(numext::real(x)) || (numext::isnan)(numext::imag(x)); +} + +template +EIGEN_DEVICE_FUNC bool isinf_impl(const std::complex& x) +{ + return ((numext::isinf)(numext::real(x)) || (numext::isinf)(numext::imag(x))) && (!(numext::isnan)(x)); +} + +/**************************************************************************** +* Implementation of fuzzy comparisons * +****************************************************************************/ + +template +struct scalar_fuzzy_default_impl {}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, const RealScalar& prec) + { + return numext::abs(x) <= numext::abs(y) * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return numext::abs(x - y) <= numext::mini(numext::abs(x), numext::abs(y)) * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return x <= y || isApprox(x, y, prec); + } +}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const Scalar&, const RealScalar&) + { + return x == Scalar(0); + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar&) + { + return x == y; + } + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, const RealScalar&) + { + return x <= y; + } +}; + +template +struct scalar_fuzzy_default_impl +{ + typedef typename NumTraits::Real RealScalar; + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, const RealScalar& prec) + { + return numext::abs2(x) <= numext::abs2(y) * prec * prec; + } + EIGEN_DEVICE_FUNC + static inline bool isApprox(const Scalar& x, const Scalar& y, const RealScalar& prec) + { + return numext::abs2(x - y) <= numext::mini(numext::abs2(x), numext::abs2(y)) * prec * prec; + } +}; + +template +struct scalar_fuzzy_impl : scalar_fuzzy_default_impl::IsComplex, NumTraits::IsInteger> {}; + +template EIGEN_DEVICE_FUNC +inline bool isMuchSmallerThan(const Scalar& x, const OtherScalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::template isMuchSmallerThan(x, y, precision); +} + +template EIGEN_DEVICE_FUNC +inline bool isApprox(const Scalar& x, const Scalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::isApprox(x, y, precision); +} + +template EIGEN_DEVICE_FUNC +inline bool isApproxOrLessThan(const Scalar& x, const Scalar& y, + const typename NumTraits::Real &precision = NumTraits::dummy_precision()) +{ + return scalar_fuzzy_impl::isApproxOrLessThan(x, y, precision); +} + +/****************************************** +*** The special case of the bool type *** +******************************************/ + +template<> struct random_impl +{ + static inline bool run() + { + return random(0,1)==0 ? false : true; + } + + static inline bool run(const bool& a, const bool& b) + { + return random(a, b)==0 ? false : true; + } +}; + +template<> struct scalar_fuzzy_impl +{ + typedef bool RealScalar; + + template EIGEN_DEVICE_FUNC + static inline bool isMuchSmallerThan(const bool& x, const bool&, const bool&) + { + return !x; + } + + EIGEN_DEVICE_FUNC + static inline bool isApprox(bool x, bool y, bool) + { + return x == y; + } + + EIGEN_DEVICE_FUNC + static inline bool isApproxOrLessThan(const bool& x, const bool& y, const bool&) + { + return (!x) || y; + } + +}; + +} // end namespace internal + +// Default implementations that rely on other numext implementations +namespace internal { + +// Specialization for complex types that are not supported by std::expm1. +template +struct expm1_impl > { + EIGEN_DEVICE_FUNC static inline std::complex run( + const std::complex& x) { + EIGEN_STATIC_ASSERT_NON_INTEGER(RealScalar) + RealScalar xr = x.real(); + RealScalar xi = x.imag(); + // expm1(z) = exp(z) - 1 + // = exp(x + i * y) - 1 + // = exp(x) * (cos(y) + i * sin(y)) - 1 + // = exp(x) * cos(y) - 1 + i * exp(x) * sin(y) + // Imag(expm1(z)) = exp(x) * sin(y) + // Real(expm1(z)) = exp(x) * cos(y) - 1 + // = exp(x) * cos(y) - 1. + // = expm1(x) + exp(x) * (cos(y) - 1) + // = expm1(x) + exp(x) * (2 * sin(y / 2) ** 2) + RealScalar erm1 = numext::expm1(xr); + RealScalar er = erm1 + RealScalar(1.); + RealScalar sin2 = numext::sin(xi / RealScalar(2.)); + sin2 = sin2 * sin2; + RealScalar s = numext::sin(xi); + RealScalar real_part = erm1 - RealScalar(2.) * er * sin2; + return std::complex(real_part, er * s); + } +}; + +template +struct rsqrt_impl { + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE T run(const T& x) { + return T(1)/numext::sqrt(x); + } +}; + +#if defined(EIGEN_GPU_COMPILE_PHASE) +template +struct conj_impl, true> +{ + EIGEN_DEVICE_FUNC + static inline std::complex run(const std::complex& x) + { + return std::complex(numext::real(x), -numext::imag(x)); + } +}; +#endif + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h b/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h new file mode 100644 index 0000000..4eaaaa7 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MathFunctionsImpl.h @@ -0,0 +1,200 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2014 Pedro Gonnet (pedro.gonnet@gmail.com) +// Copyright (C) 2016 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATHFUNCTIONSIMPL_H +#define EIGEN_MATHFUNCTIONSIMPL_H + +namespace Eigen { + +namespace internal { + +/** \internal \returns the hyperbolic tan of \a a (coeff-wise) + Doesn't do anything fancy, just a 13/6-degree rational interpolant which + is accurate up to a couple of ulps in the (approximate) range [-8, 8], + outside of which tanh(x) = +/-1 in single precision. The input is clamped + to the range [-c, c]. The value c is chosen as the smallest value where + the approximation evaluates to exactly 1. In the reange [-0.0004, 0.0004] + the approxmation tanh(x) ~= x is used for better accuracy as x tends to zero. + + This implementation works on both scalars and packets. +*/ +template +T generic_fast_tanh_float(const T& a_x) +{ + // Clamp the inputs to the range [-c, c] +#ifdef EIGEN_VECTORIZE_FMA + const T plus_clamp = pset1(7.99881172180175781f); + const T minus_clamp = pset1(-7.99881172180175781f); +#else + const T plus_clamp = pset1(7.90531110763549805f); + const T minus_clamp = pset1(-7.90531110763549805f); +#endif + const T tiny = pset1(0.0004f); + const T x = pmax(pmin(a_x, plus_clamp), minus_clamp); + const T tiny_mask = pcmp_lt(pabs(a_x), tiny); + // The monomial coefficients of the numerator polynomial (odd). + const T alpha_1 = pset1(4.89352455891786e-03f); + const T alpha_3 = pset1(6.37261928875436e-04f); + const T alpha_5 = pset1(1.48572235717979e-05f); + const T alpha_7 = pset1(5.12229709037114e-08f); + const T alpha_9 = pset1(-8.60467152213735e-11f); + const T alpha_11 = pset1(2.00018790482477e-13f); + const T alpha_13 = pset1(-2.76076847742355e-16f); + + // The monomial coefficients of the denominator polynomial (even). + const T beta_0 = pset1(4.89352518554385e-03f); + const T beta_2 = pset1(2.26843463243900e-03f); + const T beta_4 = pset1(1.18534705686654e-04f); + const T beta_6 = pset1(1.19825839466702e-06f); + + // Since the polynomials are odd/even, we need x^2. + const T x2 = pmul(x, x); + + // Evaluate the numerator polynomial p. + T p = pmadd(x2, alpha_13, alpha_11); + p = pmadd(x2, p, alpha_9); + p = pmadd(x2, p, alpha_7); + p = pmadd(x2, p, alpha_5); + p = pmadd(x2, p, alpha_3); + p = pmadd(x2, p, alpha_1); + p = pmul(x, p); + + // Evaluate the denominator polynomial q. + T q = pmadd(x2, beta_6, beta_4); + q = pmadd(x2, q, beta_2); + q = pmadd(x2, q, beta_0); + + // Divide the numerator by the denominator. + return pselect(tiny_mask, x, pdiv(p, q)); +} + +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE +RealScalar positive_real_hypot(const RealScalar& x, const RealScalar& y) +{ + // IEEE IEC 6059 special cases. + if ((numext::isinf)(x) || (numext::isinf)(y)) + return NumTraits::infinity(); + if ((numext::isnan)(x) || (numext::isnan)(y)) + return NumTraits::quiet_NaN(); + + EIGEN_USING_STD(sqrt); + RealScalar p, qp; + p = numext::maxi(x,y); + if(p==RealScalar(0)) return RealScalar(0); + qp = numext::mini(y,x) / p; + return p * sqrt(RealScalar(1) + qp*qp); +} + +template +struct hypot_impl +{ + typedef typename NumTraits::Real RealScalar; + static EIGEN_DEVICE_FUNC + inline RealScalar run(const Scalar& x, const Scalar& y) + { + EIGEN_USING_STD(abs); + return positive_real_hypot(abs(x), abs(y)); + } +}; + +// Generic complex sqrt implementation that correctly handles corner cases +// according to https://en.cppreference.com/w/cpp/numeric/complex/sqrt +template +EIGEN_DEVICE_FUNC std::complex complex_sqrt(const std::complex& z) { + // Computes the principal sqrt of the input. + // + // For a complex square root of the number x + i*y. We want to find real + // numbers u and v such that + // (u + i*v)^2 = x + i*y <=> + // u^2 - v^2 + i*2*u*v = x + i*v. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x + // 2*u*v = y. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + sqrt(x^2 + y^2))) + // v = y / (2 * u) + // and for x < 0, + // v = sign(y) * sqrt(0.5 * (-x + sqrt(x^2 + y^2))) + // u = y / (2 * v) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w, v = sign(y) * w + // if x > 0: u = w, v = y / (2 * w) + // if x < 0: u = |y| / (2 * w), v = sign(y) * w + + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + numext::hypot(x, y))); + + return + (numext::isinf)(y) ? std::complex(NumTraits::infinity(), y) + : x == zero ? std::complex(w, y < zero ? -w : w) + : x > zero ? std::complex(w, y / (2 * w)) + : std::complex(numext::abs(y) / (2 * w), y < zero ? -w : w ); +} + +// Generic complex rsqrt implementation. +template +EIGEN_DEVICE_FUNC std::complex complex_rsqrt(const std::complex& z) { + // Computes the principal reciprocal sqrt of the input. + // + // For a complex reciprocal square root of the number z = x + i*y. We want to + // find real numbers u and v such that + // (u + i*v)^2 = 1 / (x + i*y) <=> + // u^2 - v^2 + i*2*u*v = x/|z|^2 - i*v/|z|^2. + // By equating the real and imaginary parts we get: + // u^2 - v^2 = x/|z|^2 + // 2*u*v = y/|z|^2. + // + // For x >= 0, this has the numerically stable solution + // u = sqrt(0.5 * (x + |z|)) / |z| + // v = -y / (2 * u * |z|) + // and for x < 0, + // v = -sign(y) * sqrt(0.5 * (-x + |z|)) / |z| + // u = -y / (2 * v * |z|) + // + // Letting w = sqrt(0.5 * (|x| + |z|)), + // if x == 0: u = w / |z|, v = -sign(y) * w / |z| + // if x > 0: u = w / |z|, v = -y / (2 * w * |z|) + // if x < 0: u = |y| / (2 * w * |z|), v = -sign(y) * w / |z| + + const T x = numext::real(z); + const T y = numext::imag(z); + const T zero = T(0); + + const T abs_z = numext::hypot(x, y); + const T w = numext::sqrt(T(0.5) * (numext::abs(x) + abs_z)); + const T woz = w / abs_z; + // Corner cases consistent with 1/sqrt(z) on gcc/clang. + return + abs_z == zero ? std::complex(NumTraits::infinity(), NumTraits::quiet_NaN()) + : ((numext::isinf)(x) || (numext::isinf)(y)) ? std::complex(zero, zero) + : x == zero ? std::complex(woz, y < zero ? woz : -woz) + : x > zero ? std::complex(woz, -y / (2 * w * abs_z)) + : std::complex(numext::abs(y) / (2 * w * abs_z), y < zero ? woz : -woz ); +} + +template +EIGEN_DEVICE_FUNC std::complex complex_log(const std::complex& z) { + // Computes complex log. + T a = numext::abs(z); + EIGEN_USING_STD(atan2); + T b = atan2(z.imag(), z.real()); + return std::complex(numext::log(a), b); +} + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_MATHFUNCTIONSIMPL_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Matrix.h b/src/3rdparty/eigen/Eigen/src/Core/Matrix.h new file mode 100644 index 0000000..f0e59a9 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Matrix.h @@ -0,0 +1,565 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// Copyright (C) 2008-2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIX_H +#define EIGEN_MATRIX_H + +namespace Eigen { + +namespace internal { +template +struct traits > +{ +private: + enum { size = internal::size_at_compile_time<_Rows,_Cols>::ret }; + typedef typename find_best_packet<_Scalar,size>::type PacketScalar; + enum { + row_major_bit = _Options&RowMajor ? RowMajorBit : 0, + is_dynamic_size_storage = _MaxRows==Dynamic || _MaxCols==Dynamic, + max_size = is_dynamic_size_storage ? Dynamic : _MaxRows*_MaxCols, + default_alignment = compute_default_alignment<_Scalar,max_size>::value, + actual_alignment = ((_Options&DontAlign)==0) ? default_alignment : 0, + required_alignment = unpacket_traits::alignment, + packet_access_bit = (packet_traits<_Scalar>::Vectorizable && (EIGEN_UNALIGNED_VECTORIZE || (actual_alignment>=required_alignment))) ? PacketAccessBit : 0 + }; + +public: + typedef _Scalar Scalar; + typedef Dense StorageKind; + typedef Eigen::Index StorageIndex; + typedef MatrixXpr XprKind; + enum { + RowsAtCompileTime = _Rows, + ColsAtCompileTime = _Cols, + MaxRowsAtCompileTime = _MaxRows, + MaxColsAtCompileTime = _MaxCols, + Flags = compute_matrix_flags<_Scalar, _Rows, _Cols, _Options, _MaxRows, _MaxCols>::ret, + Options = _Options, + InnerStrideAtCompileTime = 1, + OuterStrideAtCompileTime = (Options&RowMajor) ? ColsAtCompileTime : RowsAtCompileTime, + + // FIXME, the following flag in only used to define NeedsToAlign in PlainObjectBase + EvaluatorFlags = LinearAccessBit | DirectAccessBit | packet_access_bit | row_major_bit, + Alignment = actual_alignment + }; +}; +} + +/** \class Matrix + * \ingroup Core_Module + * + * \brief The matrix class, also used for vectors and row-vectors + * + * The %Matrix class is the work-horse for all \em dense (\ref dense "note") matrices and vectors within Eigen. + * Vectors are matrices with one column, and row-vectors are matrices with one row. + * + * The %Matrix class encompasses \em both fixed-size and dynamic-size objects (\ref fixedsize "note"). + * + * The first three template parameters are required: + * \tparam _Scalar Numeric type, e.g. float, double, int or std::complex. + * User defined scalar types are supported as well (see \ref user_defined_scalars "here"). + * \tparam _Rows Number of rows, or \b Dynamic + * \tparam _Cols Number of columns, or \b Dynamic + * + * The remaining template parameters are optional -- in most cases you don't have to worry about them. + * \tparam _Options A combination of either \b #RowMajor or \b #ColMajor, and of either + * \b #AutoAlign or \b #DontAlign. + * The former controls \ref TopicStorageOrders "storage order", and defaults to column-major. The latter controls alignment, which is required + * for vectorization. It defaults to aligning matrices except for fixed sizes that aren't a multiple of the packet size. + * \tparam _MaxRows Maximum number of rows. Defaults to \a _Rows (\ref maxrows "note"). + * \tparam _MaxCols Maximum number of columns. Defaults to \a _Cols (\ref maxrows "note"). + * + * Eigen provides a number of typedefs covering the usual cases. Here are some examples: + * + * \li \c Matrix2d is a 2x2 square matrix of doubles (\c Matrix) + * \li \c Vector4f is a vector of 4 floats (\c Matrix) + * \li \c RowVector3i is a row-vector of 3 ints (\c Matrix) + * + * \li \c MatrixXf is a dynamic-size matrix of floats (\c Matrix) + * \li \c VectorXf is a dynamic-size vector of floats (\c Matrix) + * + * \li \c Matrix2Xf is a partially fixed-size (dynamic-size) matrix of floats (\c Matrix) + * \li \c MatrixX3d is a partially dynamic-size (fixed-size) matrix of double (\c Matrix) + * + * See \link matrixtypedefs this page \endlink for a complete list of predefined \em %Matrix and \em Vector typedefs. + * + * You can access elements of vectors and matrices using normal subscripting: + * + * \code + * Eigen::VectorXd v(10); + * v[0] = 0.1; + * v[1] = 0.2; + * v(0) = 0.3; + * v(1) = 0.4; + * + * Eigen::MatrixXi m(10, 10); + * m(0, 1) = 1; + * m(0, 2) = 2; + * m(0, 3) = 3; + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIX_PLUGIN. + * + * Some notes: + * + *

+ *
\anchor dense Dense versus sparse:
+ *
This %Matrix class handles dense, not sparse matrices and vectors. For sparse matrices and vectors, see the Sparse module. + * + * Dense matrices and vectors are plain usual arrays of coefficients. All the coefficients are stored, in an ordinary contiguous array. + * This is unlike Sparse matrices and vectors where the coefficients are stored as a list of nonzero coefficients.
+ * + *
\anchor fixedsize Fixed-size versus dynamic-size:
+ *
Fixed-size means that the numbers of rows and columns are known are compile-time. In this case, Eigen allocates the array + * of coefficients as a fixed-size array, as a class member. This makes sense for very small matrices, typically up to 4x4, sometimes up + * to 16x16. Larger matrices should be declared as dynamic-size even if one happens to know their size at compile-time. + * + * Dynamic-size means that the numbers of rows or columns are not necessarily known at compile-time. In this case they are runtime + * variables, and the array of coefficients is allocated dynamically on the heap. + * + * Note that \em dense matrices, be they Fixed-size or Dynamic-size, do not expand dynamically in the sense of a std::map. + * If you want this behavior, see the Sparse module.
+ * + *
\anchor maxrows _MaxRows and _MaxCols:
+ *
In most cases, one just leaves these parameters to the default values. + * These parameters mean the maximum size of rows and columns that the matrix may have. They are useful in cases + * when the exact numbers of rows and columns are not known are compile-time, but it is known at compile-time that they cannot + * exceed a certain value. This happens when taking dynamic-size blocks inside fixed-size matrices: in this case _MaxRows and _MaxCols + * are the dimensions of the original matrix, while _Rows and _Cols are Dynamic.
+ *
+ * + * ABI and storage layout + * + * The table below summarizes the ABI of some possible Matrix instances which is fixed thorough the lifetime of Eigen 3. + * + * + * + * + * + * + *
Matrix typeEquivalent C structure
\code Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index rows, cols; + * }; + * \endcode
\code + * Matrix + * Matrix \endcode\code + * struct { + * T *data; // with (size_t(data)%EIGEN_MAX_ALIGN_BYTES)==0 + * Eigen::Index size; + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[Rows*Cols]; // with (size_t(data)%A(Rows*Cols*sizeof(T)))==0 + * }; + * \endcode
\code Matrix \endcode\code + * struct { + * T data[MaxRows*MaxCols]; // with (size_t(data)%A(MaxRows*MaxCols*sizeof(T)))==0 + * Eigen::Index rows, cols; + * }; + * \endcode
+ * Note that in this table Rows, Cols, MaxRows and MaxCols are all positive integers. A(S) is defined to the largest possible power-of-two + * smaller to EIGEN_MAX_STATIC_ALIGN_BYTES. + * + * \see MatrixBase for the majority of the API methods for matrices, \ref TopicClassHierarchy, + * \ref TopicStorageOrders + */ + +template +class Matrix + : public PlainObjectBase > +{ + public: + + /** \brief Base class typedef. + * \sa PlainObjectBase + */ + typedef PlainObjectBase Base; + + enum { Options = _Options }; + + EIGEN_DENSE_PUBLIC_INTERFACE(Matrix) + + typedef typename Base::PlainObject PlainObject; + + using Base::base; + using Base::coeffRef; + + /** + * \brief Assigns matrices to each other. + * + * \note This is a special case of the templated operator=. Its purpose is + * to prevent a default operator= from hiding the templated operator=. + * + * \callgraph + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const Matrix& other) + { + return Base::_set(other); + } + + /** \internal + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const DenseBase& other) + { + return Base::_set(other); + } + + /* Here, doxygen failed to copy the brief information when using \copydoc */ + + /** + * \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const EigenBase &other) + { + return Base::operator=(other); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix& operator=(const ReturnByValue& func) + { + return Base::operator=(func); + } + + /** \brief Default constructor. + * + * For fixed-size matrices, does nothing. + * + * For dynamic-size matrices, creates an empty matrix of size 0. Does not allocate any array. Such a matrix + * is called a null matrix. This constructor is the unique way to create null matrices: resizing + * a matrix to 0 is not supported. + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix() : Base() + { + Base::_check_template_params(); + EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + + // FIXME is it still needed + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit Matrix(internal::constructor_without_unaligned_array_assert) + : Base(internal::constructor_without_unaligned_array_assert()) + { Base::_check_template_params(); EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED } + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(Matrix&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_constructible::value) + : Base(std::move(other)) + { + Base::_check_template_params(); + } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix& operator=(Matrix&& other) EIGEN_NOEXCEPT_IF(std::is_nothrow_move_assignable::value) + { + Base::operator=(std::move(other)); + return *this; + } +#endif + +#if EIGEN_HAS_CXX11 + /** \copydoc PlainObjectBase(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&... args) + * + * Example: \include Matrix_variadic_ctor_cxx11.cpp + * Output: \verbinclude Matrix_variadic_ctor_cxx11.out + * + * \sa Matrix(const std::initializer_list>&) + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : Base(a0, a1, a2, a3, args...) {} + + /** \brief Constructs a Matrix and initializes it from the coefficients given as initializer-lists grouped by row. \cpp11 + * + * In the general case, the constructor takes a list of rows, each row being represented as a list of coefficients: + * + * Example: \include Matrix_initializer_list_23_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_23_cxx11.out + * + * Each of the inner initializer lists must contain the exact same number of elements, otherwise an assertion is triggered. + * + * In the case of a compile-time column vector, implicit transposition from a single row is allowed. + * Therefore VectorXd{{1,2,3,4,5}} is legal and the more verbose syntax + * RowVectorXd{{1},{2},{3},{4},{5}} can be avoided: + * + * Example: \include Matrix_initializer_list_vector_cxx11.cpp + * Output: \verbinclude Matrix_initializer_list_vector_cxx11.out + * + * In the case of fixed-sized matrices, the initializer list sizes must exactly match the matrix sizes, + * and implicit transposition is allowed for compile-time vectors only. + * + * \sa Matrix(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE Matrix(const std::initializer_list>& list) : Base(list) {} +#endif // end EIGEN_HAS_CXX11 + +#ifndef EIGEN_PARSED_BY_DOXYGEN + + // This constructor is for both 1x1 matrices and dynamic vectors + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit Matrix(const T& x) + { + Base::_check_template_params(); + Base::template _init1(x); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Matrix(const T0& x, const T1& y) + { + Base::_check_template_params(); + Base::template _init2(x, y); + } + + +#else + /** \brief Constructs a fixed-sized matrix initialized with coefficients starting at \a data */ + EIGEN_DEVICE_FUNC + explicit Matrix(const Scalar *data); + + /** \brief Constructs a vector or row-vector with given dimension. \only_for_vectors + * + * This is useful for dynamic-size vectors. For fixed-size vectors, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x1 matrices. For instance, + * calling Matrix(1) will call the initialization constructor: Matrix(const Scalar&). + * For fixed-size \c 1x1 matrices it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_STRONG_INLINE explicit Matrix(Index dim); + /** \brief Constructs an initialized 1x1 matrix with the given coefficient + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x); + /** \brief Constructs an uninitialized matrix with \a rows rows and \a cols columns. + * + * This is useful for dynamic-size matrices. For fixed-size matrices, + * it is redundant to pass these parameters, so one should use the default constructor + * Matrix() instead. + * + * \warning This constructor is disabled for fixed-size \c 1x2 and \c 2x1 vectors. For instance, + * calling Matrix2f(2,1) will call the initialization constructor: Matrix(const Scalar& x, const Scalar& y). + * For fixed-size \c 1x2 or \c 2x1 vectors it is therefore recommended to use the default + * constructor Matrix() instead, especially when using one of the non standard + * \c EIGEN_INITIALIZE_MATRICES_BY_{ZERO,\c NAN} macros (see \ref TopicPreprocessorDirectives). + */ + EIGEN_DEVICE_FUNC + Matrix(Index rows, Index cols); + + /** \brief Constructs an initialized 2D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) */ + Matrix(const Scalar& x, const Scalar& y); + #endif // end EIGEN_PARSED_BY_DOXYGEN + + /** \brief Constructs an initialized 3D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 3) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + } + /** \brief Constructs an initialized 4D vector with given coefficients + * \sa Matrix(const Scalar&, const Scalar&, const Scalar&, const Scalar&, const ArgTypes&...) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Scalar& x, const Scalar& y, const Scalar& z, const Scalar& w) + { + Base::_check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(Matrix, 4) + m_storage.data()[0] = x; + m_storage.data()[1] = y; + m_storage.data()[2] = z; + m_storage.data()[3] = w; + } + + + /** \brief Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const Matrix& other) : Base(other) + { } + + /** \brief Copy constructor for generic expressions. + * \sa MatrixBase::operator=(const EigenBase&) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Matrix(const EigenBase &other) + : Base(other.derived()) + { } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const EIGEN_NOEXCEPT { return 1; } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const EIGEN_NOEXCEPT { return this->innerSize(); } + + /////////// Geometry module /////////// + + template + EIGEN_DEVICE_FUNC + explicit Matrix(const RotationBase& r); + template + EIGEN_DEVICE_FUNC + Matrix& operator=(const RotationBase& r); + + // allow to extend Matrix outside Eigen + #ifdef EIGEN_MATRIX_PLUGIN + #include EIGEN_MATRIX_PLUGIN + #endif + + protected: + template + friend struct internal::conservative_resize_like_impl; + + using Base::m_storage; +}; + +/** \defgroup matrixtypedefs Global matrix typedefs + * + * \ingroup Core_Module + * + * %Eigen defines several typedef shortcuts for most common matrix and vector types. + * + * The general patterns are the following: + * + * \c MatrixSizeType where \c Size can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size, + * and where \c Type can be \c i for integer, \c f for float, \c d for double, \c cf for complex float, \c cd + * for complex double. + * + * For example, \c Matrix3d is a fixed-size 3x3 matrix type of doubles, and \c MatrixXf is a dynamic-size matrix of floats. + * + * There are also \c VectorSizeType and \c RowVectorSizeType which are self-explanatory. For example, \c Vector4cf is + * a fixed-size vector of 4 complex floats. + * + * With \cpp11, template alias are also defined for common sizes. + * They follow the same pattern as above except that the scalar type suffix is replaced by a + * template parameter, i.e.: + * - `MatrixSize` where `Size` can be \c 2,\c 3,\c 4 for fixed size square matrices or \c X for dynamic size. + * - `MatrixXSize` and `MatrixSizeX` where `Size` can be \c 2,\c 3,\c 4 for hybrid dynamic/fixed matrices. + * - `VectorSize` and `RowVectorSize` for column and row vectors. + * + * With \cpp11, you can also use fully generic column and row vector types: `Vector` and `RowVector`. + * + * \sa class Matrix + */ + +#define EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Size, SizeSuffix) \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##SizeSuffix##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Vector##SizeSuffix##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix RowVector##SizeSuffix##TypeSuffix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, Size) \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##Size##X##TypeSuffix; \ +/** \ingroup matrixtypedefs */ \ +typedef Matrix Matrix##X##Size##TypeSuffix; + +#define EIGEN_MAKE_TYPEDEFS_ALL_SIZES(Type, TypeSuffix) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 2, 2) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 3, 3) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, 4, 4) \ +EIGEN_MAKE_TYPEDEFS(Type, TypeSuffix, Dynamic, X) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 2) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 3) \ +EIGEN_MAKE_FIXED_TYPEDEFS(Type, TypeSuffix, 4) + +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(int, i) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(float, f) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(double, d) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cf) +EIGEN_MAKE_TYPEDEFS_ALL_SIZES(std::complex, cd) + +#undef EIGEN_MAKE_TYPEDEFS_ALL_SIZES +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +#if EIGEN_HAS_CXX11 + +#define EIGEN_MAKE_TYPEDEFS(Size, SizeSuffix) \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##SizeSuffix = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Vector##SizeSuffix = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using RowVector##SizeSuffix = Matrix; + +#define EIGEN_MAKE_FIXED_TYPEDEFS(Size) \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##Size##X = Matrix; \ +/** \ingroup matrixtypedefs */ \ +/** \brief \cpp11 */ \ +template \ +using Matrix##X##Size = Matrix; + +EIGEN_MAKE_TYPEDEFS(2, 2) +EIGEN_MAKE_TYPEDEFS(3, 3) +EIGEN_MAKE_TYPEDEFS(4, 4) +EIGEN_MAKE_TYPEDEFS(Dynamic, X) +EIGEN_MAKE_FIXED_TYPEDEFS(2) +EIGEN_MAKE_FIXED_TYPEDEFS(3) +EIGEN_MAKE_FIXED_TYPEDEFS(4) + +/** \ingroup matrixtypedefs + * \brief \cpp11 */ +template +using Vector = Matrix; + +/** \ingroup matrixtypedefs + * \brief \cpp11 */ +template +using RowVector = Matrix; + +#undef EIGEN_MAKE_TYPEDEFS +#undef EIGEN_MAKE_FIXED_TYPEDEFS + +#endif // EIGEN_HAS_CXX11 + +} // end namespace Eigen + +#endif // EIGEN_MATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h b/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h new file mode 100644 index 0000000..45c3a59 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/MatrixBase.h @@ -0,0 +1,547 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2009 Benoit Jacob +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_MATRIXBASE_H +#define EIGEN_MATRIXBASE_H + +namespace Eigen { + +/** \class MatrixBase + * \ingroup Core_Module + * + * \brief Base class for all dense matrices, vectors, and expressions + * + * This class is the base that is inherited by all matrix, vector, and related expression + * types. Most of the Eigen API is contained in this class, and its base classes. Other important + * classes for the Eigen API are Matrix, and VectorwiseOp. + * + * Note that some methods are defined in other modules such as the \ref LU_Module LU module + * for all functions related to matrix inversions. + * + * \tparam Derived is the derived type, e.g. a matrix type, or an expression, etc. + * + * When writing a function taking Eigen objects as argument, if you want your function + * to take as argument any matrix, vector, or expression, just let it take a + * MatrixBase argument. As an example, here is a function printFirstRow which, given + * a matrix, vector, or expression \a x, prints the first row of \a x. + * + * \code + template + void printFirstRow(const Eigen::MatrixBase& x) + { + cout << x.row(0) << endl; + } + * \endcode + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_MATRIXBASE_PLUGIN. + * + * \sa \blank \ref TopicClassHierarchy + */ +template class MatrixBase + : public DenseBase +{ + public: +#ifndef EIGEN_PARSED_BY_DOXYGEN + typedef MatrixBase StorageBaseType; + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::StorageIndex StorageIndex; + typedef typename internal::traits::Scalar Scalar; + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + + typedef DenseBase Base; + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + using Base::derived; + using Base::const_cast_derived; + using Base::rows; + using Base::cols; + using Base::size; + using Base::coeff; + using Base::coeffRef; + using Base::lazyAssign; + using Base::eval; + using Base::operator-; + using Base::operator+=; + using Base::operator-=; + using Base::operator*=; + using Base::operator/=; + + typedef typename Base::CoeffReturnType CoeffReturnType; + typedef typename Base::ConstTransposeReturnType ConstTransposeReturnType; + typedef typename Base::RowXpr RowXpr; + typedef typename Base::ColXpr ColXpr; +#endif // not EIGEN_PARSED_BY_DOXYGEN + + + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** type of the equivalent square matrix */ + typedef Matrix SquareMatrixType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + + /** \returns the size of the main diagonal, which is min(rows(),cols()). + * \sa rows(), cols(), SizeAtCompileTime. */ + EIGEN_DEVICE_FUNC + inline Index diagonalSize() const { return (numext::mini)(rows(),cols()); } + + typedef typename Base::PlainObject PlainObject; + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal Represents a matrix with all coefficients equal to one another*/ + typedef CwiseNullaryOp,PlainObject> ConstantReturnType; + /** \internal the return type of MatrixBase::adjoint() */ + typedef typename internal::conditional::IsComplex, + CwiseUnaryOp, ConstTransposeReturnType>, + ConstTransposeReturnType + >::type AdjointReturnType; + /** \internal Return type of eigenvalues() */ + typedef Matrix, internal::traits::ColsAtCompileTime, 1, ColMajor> EigenvaluesReturnType; + /** \internal the return type of identity */ + typedef CwiseNullaryOp,PlainObject> IdentityReturnType; + /** \internal the return type of unit vectors */ + typedef Block, SquareMatrixType>, + internal::traits::RowsAtCompileTime, + internal::traits::ColsAtCompileTime> BasisReturnType; +#endif // not EIGEN_PARSED_BY_DOXYGEN + +#define EIGEN_CURRENT_STORAGE_BASE_CLASS Eigen::MatrixBase +#define EIGEN_DOC_UNARY_ADDONS(X,Y) +# include "../plugins/CommonCwiseBinaryOps.h" +# include "../plugins/MatrixCwiseUnaryOps.h" +# include "../plugins/MatrixCwiseBinaryOps.h" +# ifdef EIGEN_MATRIXBASE_PLUGIN +# include EIGEN_MATRIXBASE_PLUGIN +# endif +#undef EIGEN_CURRENT_STORAGE_BASE_CLASS +#undef EIGEN_DOC_UNARY_ADDONS + + /** Special case of the template operator=, in order to prevent the compiler + * from generating a default operator= (issue hit with g++ 4.1) + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const MatrixBase& other); + + // We cannot inherit here via Base::operator= since it is causing + // trouble with MSVC. + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator=(const DenseBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC + Derived& operator=(const ReturnByValue& other); + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator+=(const MatrixBase& other); + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Derived& operator-=(const MatrixBase& other); + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const MatrixBase &other) const; + + template + EIGEN_DEVICE_FUNC + const Product + lazyProduct(const MatrixBase &other) const; + + template + Derived& operator*=(const EigenBase& other); + + template + void applyOnTheLeft(const EigenBase& other); + + template + void applyOnTheRight(const EigenBase& other); + + template + EIGEN_DEVICE_FUNC + const Product + operator*(const DiagonalBase &diagonal) const; + + template + EIGEN_DEVICE_FUNC + typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType + dot(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC RealScalar squaredNorm() const; + EIGEN_DEVICE_FUNC RealScalar norm() const; + RealScalar stableNorm() const; + RealScalar blueNorm() const; + RealScalar hypotNorm() const; + EIGEN_DEVICE_FUNC const PlainObject normalized() const; + EIGEN_DEVICE_FUNC const PlainObject stableNormalized() const; + EIGEN_DEVICE_FUNC void normalize(); + EIGEN_DEVICE_FUNC void stableNormalize(); + + EIGEN_DEVICE_FUNC const AdjointReturnType adjoint() const; + EIGEN_DEVICE_FUNC void adjointInPlace(); + + typedef Diagonal DiagonalReturnType; + EIGEN_DEVICE_FUNC + DiagonalReturnType diagonal(); + + typedef typename internal::add_const >::type ConstDiagonalReturnType; + EIGEN_DEVICE_FUNC + ConstDiagonalReturnType diagonal() const; + + template struct DiagonalIndexReturnType { typedef Diagonal Type; }; + template struct ConstDiagonalIndexReturnType { typedef const Diagonal Type; }; + + template + EIGEN_DEVICE_FUNC + typename DiagonalIndexReturnType::Type diagonal(); + + template + EIGEN_DEVICE_FUNC + typename ConstDiagonalIndexReturnType::Type diagonal() const; + + typedef Diagonal DiagonalDynamicIndexReturnType; + typedef typename internal::add_const >::type ConstDiagonalDynamicIndexReturnType; + + EIGEN_DEVICE_FUNC + DiagonalDynamicIndexReturnType diagonal(Index index); + EIGEN_DEVICE_FUNC + ConstDiagonalDynamicIndexReturnType diagonal(Index index) const; + + template struct TriangularViewReturnType { typedef TriangularView Type; }; + template struct ConstTriangularViewReturnType { typedef const TriangularView Type; }; + + template + EIGEN_DEVICE_FUNC + typename TriangularViewReturnType::Type triangularView(); + template + EIGEN_DEVICE_FUNC + typename ConstTriangularViewReturnType::Type triangularView() const; + + template struct SelfAdjointViewReturnType { typedef SelfAdjointView Type; }; + template struct ConstSelfAdjointViewReturnType { typedef const SelfAdjointView Type; }; + + template + EIGEN_DEVICE_FUNC + typename SelfAdjointViewReturnType::Type selfadjointView(); + template + EIGEN_DEVICE_FUNC + typename ConstSelfAdjointViewReturnType::Type selfadjointView() const; + + const SparseView sparseView(const Scalar& m_reference = Scalar(0), + const typename NumTraits::Real& m_epsilon = NumTraits::dummy_precision()) const; + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(); + EIGEN_DEVICE_FUNC static const IdentityReturnType Identity(Index rows, Index cols); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index size, Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType Unit(Index i); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitX(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitY(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitZ(); + EIGEN_DEVICE_FUNC static const BasisReturnType UnitW(); + + EIGEN_DEVICE_FUNC + const DiagonalWrapper asDiagonal() const; + const PermutationWrapper asPermutation() const; + + EIGEN_DEVICE_FUNC + Derived& setIdentity(); + EIGEN_DEVICE_FUNC + Derived& setIdentity(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setUnit(Index i); + EIGEN_DEVICE_FUNC Derived& setUnit(Index newSize, Index i); + + bool isIdentity(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isDiagonal(const RealScalar& prec = NumTraits::dummy_precision()) const; + + bool isUpperTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isLowerTriangular(const RealScalar& prec = NumTraits::dummy_precision()) const; + + template + bool isOrthogonal(const MatrixBase& other, + const RealScalar& prec = NumTraits::dummy_precision()) const; + bool isUnitary(const RealScalar& prec = NumTraits::dummy_precision()) const; + + /** \returns true if each coefficients of \c *this and \a other are all exactly equal. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator!= */ + template + EIGEN_DEVICE_FUNC inline bool operator==(const MatrixBase& other) const + { return cwiseEqual(other).all(); } + + /** \returns true if at least one pair of coefficients of \c *this and \a other are not exactly equal to each other. + * \warning When using floating point scalar values you probably should rather use a + * fuzzy comparison such as isApprox() + * \sa isApprox(), operator== */ + template + EIGEN_DEVICE_FUNC inline bool operator!=(const MatrixBase& other) const + { return cwiseNotEqual(other).any(); } + + NoAlias EIGEN_DEVICE_FUNC noalias(); + + // TODO forceAlignedAccess is temporarily disabled + // Need to find a nicer workaround. + inline const Derived& forceAlignedAccess() const { return derived(); } + inline Derived& forceAlignedAccess() { return derived(); } + template inline const Derived& forceAlignedAccessIf() const { return derived(); } + template inline Derived& forceAlignedAccessIf() { return derived(); } + + EIGEN_DEVICE_FUNC Scalar trace() const; + + template EIGEN_DEVICE_FUNC RealScalar lpNorm() const; + + EIGEN_DEVICE_FUNC MatrixBase& matrix() { return *this; } + EIGEN_DEVICE_FUNC const MatrixBase& matrix() const { return *this; } + + /** \returns an \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE ArrayWrapper array() { return ArrayWrapper(derived()); } + /** \returns a const \link Eigen::ArrayBase Array \endlink expression of this matrix + * \sa ArrayBase::matrix() */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const ArrayWrapper array() const { return ArrayWrapper(derived()); } + +/////////// LU module /////////// + + inline const FullPivLU fullPivLu() const; + inline const PartialPivLU partialPivLu() const; + + inline const PartialPivLU lu() const; + + EIGEN_DEVICE_FUNC + inline const Inverse inverse() const; + + template + inline void computeInverseAndDetWithCheck( + ResultType& inverse, + typename ResultType::Scalar& determinant, + bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision() + ) const; + + template + inline void computeInverseWithCheck( + ResultType& inverse, + bool& invertible, + const RealScalar& absDeterminantThreshold = NumTraits::dummy_precision() + ) const; + + EIGEN_DEVICE_FUNC + Scalar determinant() const; + +/////////// Cholesky module /////////// + + inline const LLT llt() const; + inline const LDLT ldlt() const; + +/////////// QR module /////////// + + inline const HouseholderQR householderQr() const; + inline const ColPivHouseholderQR colPivHouseholderQr() const; + inline const FullPivHouseholderQR fullPivHouseholderQr() const; + inline const CompleteOrthogonalDecomposition completeOrthogonalDecomposition() const; + +/////////// Eigenvalues module /////////// + + inline EigenvaluesReturnType eigenvalues() const; + inline RealScalar operatorNorm() const; + +/////////// SVD module /////////// + + inline JacobiSVD jacobiSvd(unsigned int computationOptions = 0) const; + inline BDCSVD bdcSvd(unsigned int computationOptions = 0) const; + +/////////// Geometry module /////////// + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /// \internal helper struct to form the return type of the cross product + template struct cross_product_return_type { + typedef typename ScalarBinaryOpTraits::Scalar,typename internal::traits::Scalar>::ReturnType Scalar; + typedef Matrix type; + }; + #endif // EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC +#ifndef EIGEN_PARSED_BY_DOXYGEN + inline typename cross_product_return_type::type +#else + inline PlainObject +#endif + cross(const MatrixBase& other) const; + + template + EIGEN_DEVICE_FUNC + inline PlainObject cross3(const MatrixBase& other) const; + + EIGEN_DEVICE_FUNC + inline PlainObject unitOrthogonal(void) const; + + EIGEN_DEVICE_FUNC + inline Matrix eulerAngles(Index a0, Index a1, Index a2) const; + + // put this as separate enum value to work around possible GCC 4.3 bug (?) + enum { HomogeneousReturnTypeDirection = ColsAtCompileTime==1&&RowsAtCompileTime==1 ? ((internal::traits::Flags&RowMajorBit)==RowMajorBit ? Horizontal : Vertical) + : ColsAtCompileTime==1 ? Vertical : Horizontal }; + typedef Homogeneous HomogeneousReturnType; + EIGEN_DEVICE_FUNC + inline HomogeneousReturnType homogeneous() const; + + enum { + SizeMinusOne = SizeAtCompileTime==Dynamic ? Dynamic : SizeAtCompileTime-1 + }; + typedef Block::ColsAtCompileTime==1 ? SizeMinusOne : 1, + internal::traits::ColsAtCompileTime==1 ? 1 : SizeMinusOne> ConstStartMinusOne; + typedef EIGEN_EXPR_BINARYOP_SCALAR_RETURN_TYPE(ConstStartMinusOne,Scalar,quotient) HNormalizedReturnType; + EIGEN_DEVICE_FUNC + inline const HNormalizedReturnType hnormalized() const; + +////////// Householder module /////////// + + EIGEN_DEVICE_FUNC + void makeHouseholderInPlace(Scalar& tau, RealScalar& beta); + template + EIGEN_DEVICE_FUNC + void makeHouseholder(EssentialPart& essential, + Scalar& tau, RealScalar& beta) const; + template + EIGEN_DEVICE_FUNC + void applyHouseholderOnTheLeft(const EssentialPart& essential, + const Scalar& tau, + Scalar* workspace); + template + EIGEN_DEVICE_FUNC + void applyHouseholderOnTheRight(const EssentialPart& essential, + const Scalar& tau, + Scalar* workspace); + +///////// Jacobi module ///////// + + template + EIGEN_DEVICE_FUNC + void applyOnTheLeft(Index p, Index q, const JacobiRotation& j); + template + EIGEN_DEVICE_FUNC + void applyOnTheRight(Index p, Index q, const JacobiRotation& j); + +///////// SparseCore module ///////// + + template + EIGEN_STRONG_INLINE const typename SparseMatrixBase::template CwiseProductDenseReturnType::Type + cwiseProduct(const SparseMatrixBase &other) const + { + return other.cwiseProduct(derived()); + } + +///////// MatrixFunctions module ///////// + + typedef typename internal::stem_function::type StemFunction; +#define EIGEN_MATRIX_FUNCTION(ReturnType, Name, Description) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name() const; +#define EIGEN_MATRIX_FUNCTION_1(ReturnType, Name, Description, Argument) \ + /** \returns an expression of the matrix Description of \c *this. \brief This function requires the unsupported MatrixFunctions module. To compute the coefficient-wise Description use ArrayBase::##Name . */ \ + const ReturnType Name(Argument) const; + + EIGEN_MATRIX_FUNCTION(MatrixExponentialReturnValue, exp, exponential) + /** \brief Helper function for the unsupported MatrixFunctions module.*/ + const MatrixFunctionReturnValue matrixFunction(StemFunction f) const; + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cosh, hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sinh, hyperbolic sine) +#if EIGEN_HAS_CXX11_MATH + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, atanh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, acosh, inverse hyperbolic cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, asinh, inverse hyperbolic sine) +#endif + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, cos, cosine) + EIGEN_MATRIX_FUNCTION(MatrixFunctionReturnValue, sin, sine) + EIGEN_MATRIX_FUNCTION(MatrixSquareRootReturnValue, sqrt, square root) + EIGEN_MATRIX_FUNCTION(MatrixLogarithmReturnValue, log, logarithm) + EIGEN_MATRIX_FUNCTION_1(MatrixPowerReturnValue, pow, power to \c p, const RealScalar& p) + EIGEN_MATRIX_FUNCTION_1(MatrixComplexPowerReturnValue, pow, power to \c p, const std::complex& p) + + protected: + EIGEN_DEFAULT_COPY_CONSTRUCTOR(MatrixBase) + EIGEN_DEFAULT_EMPTY_CONSTRUCTOR_AND_DESTRUCTOR(MatrixBase) + + private: + EIGEN_DEVICE_FUNC explicit MatrixBase(int); + EIGEN_DEVICE_FUNC MatrixBase(int,int); + template EIGEN_DEVICE_FUNC explicit MatrixBase(const MatrixBase&); + protected: + // mixing arrays and matrices is not legal + template Derived& operator+=(const ArrayBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} + // mixing arrays and matrices is not legal + template Derived& operator-=(const ArrayBase& ) + {EIGEN_STATIC_ASSERT(std::ptrdiff_t(sizeof(typename OtherDerived::Scalar))==-1,YOU_CANNOT_MIX_ARRAYS_AND_MATRICES); return *this;} +}; + + +/*************************************************************************** +* Implementation of matrix base methods +***************************************************************************/ + +/** replaces \c *this by \c *this * \a other. + * + * \returns a reference to \c *this + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline Derived& +MatrixBase::operator*=(const EigenBase &other) +{ + other.derived().applyThisOnTheRight(derived()); + return derived(); +} + +/** replaces \c *this by \c *this * \a other. It is equivalent to MatrixBase::operator*=(). + * + * Example: \include MatrixBase_applyOnTheRight.cpp + * Output: \verbinclude MatrixBase_applyOnTheRight.out + */ +template +template +inline void MatrixBase::applyOnTheRight(const EigenBase &other) +{ + other.derived().applyThisOnTheRight(derived()); +} + +/** replaces \c *this by \a other * \c *this. + * + * Example: \include MatrixBase_applyOnTheLeft.cpp + * Output: \verbinclude MatrixBase_applyOnTheLeft.out + */ +template +template +inline void MatrixBase::applyOnTheLeft(const EigenBase &other) +{ + other.derived().applyThisOnTheLeft(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_MATRIXBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h b/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h new file mode 100644 index 0000000..b427576 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NestByValue.h @@ -0,0 +1,85 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NESTBYVALUE_H +#define EIGEN_NESTBYVALUE_H + +namespace Eigen { + +namespace internal { +template +struct traits > : public traits +{ + enum { + Flags = traits::Flags & ~NestByRefBit + }; +}; +} + +/** \class NestByValue + * \ingroup Core_Module + * + * \brief Expression which must be nested by value + * + * \tparam ExpressionType the type of the object of which we are requiring nesting-by-value + * + * This class is the return type of MatrixBase::nestByValue() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::nestByValue() + */ +template class NestByValue + : public internal::dense_xpr_base< NestByValue >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(NestByValue) + + EIGEN_DEVICE_FUNC explicit inline NestByValue(const ExpressionType& matrix) : m_expression(matrix) {} + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index rows() const EIGEN_NOEXCEPT { return m_expression.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index cols() const EIGEN_NOEXCEPT { return m_expression.cols(); } + + EIGEN_DEVICE_FUNC operator const ExpressionType&() const { return m_expression; } + + EIGEN_DEVICE_FUNC const ExpressionType& nestedExpression() const { return m_expression; } + + protected: + const ExpressionType m_expression; +}; + +/** \returns an expression of the temporary version of *this. + */ +template +EIGEN_DEVICE_FUNC inline const NestByValue +DenseBase::nestByValue() const +{ + return NestByValue(derived()); +} + +namespace internal { + +// Evaluator of Solve -> eval into a temporary +template +struct evaluator > + : public evaluator +{ + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const NestByValue& xpr) + : Base(xpr.nestedExpression()) + {} +}; +} + +} // end namespace Eigen + +#endif // EIGEN_NESTBYVALUE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h b/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h new file mode 100644 index 0000000..570283d --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NoAlias.h @@ -0,0 +1,109 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NOALIAS_H +#define EIGEN_NOALIAS_H + +namespace Eigen { + +/** \class NoAlias + * \ingroup Core_Module + * + * \brief Pseudo expression providing an operator = assuming no aliasing + * + * \tparam ExpressionType the type of the object on which to do the lazy assignment + * + * This class represents an expression with special assignment operators + * assuming no aliasing between the target expression and the source expression. + * More precisely it alloas to bypass the EvalBeforeAssignBit flag of the source expression. + * It is the return type of MatrixBase::noalias() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::noalias() + */ +template class StorageBase> +class NoAlias +{ + public: + typedef typename ExpressionType::Scalar Scalar; + + EIGEN_DEVICE_FUNC + explicit NoAlias(ExpressionType& expression) : m_expression(expression) {} + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator+=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::add_assign_op()); + return m_expression; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE ExpressionType& operator-=(const StorageBase& other) + { + call_assignment_no_alias(m_expression, other.derived(), internal::sub_assign_op()); + return m_expression; + } + + EIGEN_DEVICE_FUNC + ExpressionType& expression() const + { + return m_expression; + } + + protected: + ExpressionType& m_expression; +}; + +/** \returns a pseudo expression of \c *this with an operator= assuming + * no aliasing between \c *this and the source expression. + * + * More precisely, noalias() allows to bypass the EvalBeforeAssignBit flag. + * Currently, even though several expressions may alias, only product + * expressions have this flag. Therefore, noalias() is only useful when + * the source expression contains a matrix product. + * + * Here are some examples where noalias is useful: + * \code + * D.noalias() = A * B; + * D.noalias() += A.transpose() * B; + * D.noalias() -= 2 * A * B.adjoint(); + * \endcode + * + * On the other hand the following example will lead to a \b wrong result: + * \code + * A.noalias() = A * B; + * \endcode + * because the result matrix A is also an operand of the matrix product. Therefore, + * there is no alternative than evaluating A * B in a temporary, that is the default + * behavior when you write: + * \code + * A = A * B; + * \endcode + * + * \sa class NoAlias + */ +template +NoAlias EIGEN_DEVICE_FUNC MatrixBase::noalias() +{ + return NoAlias(derived()); +} + +} // end namespace Eigen + +#endif // EIGEN_NOALIAS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h b/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h new file mode 100644 index 0000000..72eac5a --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/NumTraits.h @@ -0,0 +1,335 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_NUMTRAITS_H +#define EIGEN_NUMTRAITS_H + +namespace Eigen { + +namespace internal { + +// default implementation of digits10(), based on numeric_limits if specialized, +// 0 for integer types, and log10(epsilon()) otherwise. +template< typename T, + bool use_numeric_limits = std::numeric_limits::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits10_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return std::numeric_limits::digits10; } +}; + +template +struct default_digits10_impl // Floating point +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { + using std::log10; + using std::ceil; + typedef typename NumTraits::Real Real; + return int(ceil(-log10(NumTraits::epsilon()))); + } +}; + +template +struct default_digits10_impl // Integer +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return 0; } +}; + + +// default implementation of digits(), based on numeric_limits if specialized, +// 0 for integer types, and log2(epsilon()) otherwise. +template< typename T, + bool use_numeric_limits = std::numeric_limits::is_specialized, + bool is_integer = NumTraits::IsInteger> +struct default_digits_impl +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return std::numeric_limits::digits; } +}; + +template +struct default_digits_impl // Floating point +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { + using std::log; + using std::ceil; + typedef typename NumTraits::Real Real; + return int(ceil(-log(NumTraits::epsilon())/log(static_cast(2)))); + } +}; + +template +struct default_digits_impl // Integer +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static int run() { return 0; } +}; + +} // end namespace internal + +namespace numext { +/** \internal bit-wise cast without changing the underlying bit representation. */ + +// TODO: Replace by std::bit_cast (available in C++20) +template +EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC Tgt bit_cast(const Src& src) { +#if EIGEN_HAS_TYPE_TRAITS + // The behaviour of memcpy is not specified for non-trivially copyable types + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value, THIS_TYPE_IS_NOT_SUPPORTED); + EIGEN_STATIC_ASSERT(std::is_trivially_copyable::value && std::is_default_constructible::value, + THIS_TYPE_IS_NOT_SUPPORTED); +#endif + + EIGEN_STATIC_ASSERT(sizeof(Src) == sizeof(Tgt), THIS_TYPE_IS_NOT_SUPPORTED); + Tgt tgt; + EIGEN_USING_STD(memcpy) + memcpy(&tgt, &src, sizeof(Tgt)); + return tgt; +} +} // namespace numext + +/** \class NumTraits + * \ingroup Core_Module + * + * \brief Holds information about the various numeric (i.e. scalar) types allowed by Eigen. + * + * \tparam T the numeric type at hand + * + * This class stores enums, typedefs and static methods giving information about a numeric type. + * + * The provided data consists of: + * \li A typedef \c Real, giving the "real part" type of \a T. If \a T is already real, + * then \c Real is just a typedef to \a T. If \a T is \c std::complex then \c Real + * is a typedef to \a U. + * \li A typedef \c NonInteger, giving the type that should be used for operations producing non-integral values, + * such as quotients, square roots, etc. If \a T is a floating-point type, then this typedef just gives + * \a T again. Note however that many Eigen functions such as internal::sqrt simply refuse to + * take integers. Outside of a few cases, Eigen doesn't do automatic type promotion. Thus, this typedef is + * only intended as a helper for code that needs to explicitly promote types. + * \li A typedef \c Literal giving the type to use for numeric literals such as "2" or "0.5". For instance, for \c std::complex, Literal is defined as \c U. + * Of course, this type must be fully compatible with \a T. In doubt, just use \a T here. + * \li A typedef \a Nested giving the type to use to nest a value inside of the expression tree. If you don't know what + * this means, just use \a T here. + * \li An enum value \a IsComplex. It is equal to 1 if \a T is a \c std::complex + * type, and to 0 otherwise. + * \li An enum value \a IsInteger. It is equal to \c 1 if \a T is an integer type such as \c int, + * and to \c 0 otherwise. + * \li Enum values ReadCost, AddCost and MulCost representing a rough estimate of the number of CPU cycles needed + * to by move / add / mul instructions respectively, assuming the data is already stored in CPU registers. + * Stay vague here. No need to do architecture-specific stuff. If you don't know what this means, just use \c Eigen::HugeCost. + * \li An enum value \a IsSigned. It is equal to \c 1 if \a T is a signed type and to 0 if \a T is unsigned. + * \li An enum value \a RequireInitialization. It is equal to \c 1 if the constructor of the numeric type \a T must + * be called, and to 0 if it is safe not to call it. Default is 0 if \a T is an arithmetic type, and 1 otherwise. + * \li An epsilon() function which, unlike std::numeric_limits::epsilon(), + * it returns a \a Real instead of a \a T. + * \li A dummy_precision() function returning a weak epsilon value. It is mainly used as a default + * value by the fuzzy comparison operators. + * \li highest() and lowest() functions returning the highest and lowest possible values respectively. + * \li digits() function returning the number of radix digits (non-sign digits for integers, mantissa for floating-point). This is + * the analogue of std::numeric_limits::digits + * which is used as the default implementation if specialized. + * \li digits10() function returning the number of decimal digits that can be represented without change. This is + * the analogue of std::numeric_limits::digits10 + * which is used as the default implementation if specialized. + * \li min_exponent() and max_exponent() functions returning the highest and lowest possible values, respectively, + * such that the radix raised to the power exponent-1 is a normalized floating-point number. These are equivalent to + * std::numeric_limits::min_exponent/ + * std::numeric_limits::max_exponent. + * \li infinity() function returning a representation of positive infinity, if available. + * \li quiet_NaN function returning a non-signaling "not-a-number", if available. + */ + +template struct GenericNumTraits +{ + enum { + IsInteger = std::numeric_limits::is_integer, + IsSigned = std::numeric_limits::is_signed, + IsComplex = 0, + RequireInitialization = internal::is_arithmetic::value ? 0 : 1, + ReadCost = 1, + AddCost = 1, + MulCost = 1 + }; + + typedef T Real; + typedef typename internal::conditional< + IsInteger, + typename internal::conditional::type, + T + >::type NonInteger; + typedef T Nested; + typedef T Literal; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real epsilon() + { + return numext::numeric_limits::epsilon(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits10() + { + return internal::default_digits10_impl::run(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits() + { + return internal::default_digits_impl::run(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int min_exponent() + { + return numext::numeric_limits::min_exponent; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int max_exponent() + { + return numext::numeric_limits::max_exponent; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real dummy_precision() + { + // make sure to override this for floating-point types + return Real(0); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T highest() { + return (numext::numeric_limits::max)(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T lowest() { + return IsInteger ? (numext::numeric_limits::min)() + : static_cast(-(numext::numeric_limits::max)()); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T infinity() { + return numext::numeric_limits::infinity(); + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline T quiet_NaN() { + return numext::numeric_limits::quiet_NaN(); + } +}; + +template struct NumTraits : GenericNumTraits +{}; + +template<> struct NumTraits + : GenericNumTraits +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline float dummy_precision() { return 1e-5f; } +}; + +template<> struct NumTraits : GenericNumTraits +{ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline double dummy_precision() { return 1e-12; } +}; + +template<> struct NumTraits + : GenericNumTraits +{ + EIGEN_CONSTEXPR + static inline long double dummy_precision() { return 1e-15l; } +}; + +template struct NumTraits > + : GenericNumTraits > +{ + typedef _Real Real; + typedef typename NumTraits<_Real>::Literal Literal; + enum { + IsComplex = 1, + RequireInitialization = NumTraits<_Real>::RequireInitialization, + ReadCost = 2 * NumTraits<_Real>::ReadCost, + AddCost = 2 * NumTraits::AddCost, + MulCost = 4 * NumTraits::MulCost + 2 * NumTraits::AddCost + }; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline Real dummy_precision() { return NumTraits::dummy_precision(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline int digits10() { return NumTraits::digits10(); } +}; + +template +struct NumTraits > +{ + typedef Array ArrayType; + typedef typename NumTraits::Real RealScalar; + typedef Array Real; + typedef typename NumTraits::NonInteger NonIntegerScalar; + typedef Array NonInteger; + typedef ArrayType & Nested; + typedef typename NumTraits::Literal Literal; + + enum { + IsComplex = NumTraits::IsComplex, + IsInteger = NumTraits::IsInteger, + IsSigned = NumTraits::IsSigned, + RequireInitialization = 1, + ReadCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::ReadCost), + AddCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::AddCost), + MulCost = ArrayType::SizeAtCompileTime==Dynamic ? HugeCost : ArrayType::SizeAtCompileTime * int(NumTraits::MulCost) + }; + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline RealScalar epsilon() { return NumTraits::epsilon(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + static inline RealScalar dummy_precision() { return NumTraits::dummy_precision(); } + + EIGEN_CONSTEXPR + static inline int digits10() { return NumTraits::digits10(); } +}; + +template<> struct NumTraits + : GenericNumTraits +{ + enum { + RequireInitialization = 1, + ReadCost = HugeCost, + AddCost = HugeCost, + MulCost = HugeCost + }; + + EIGEN_CONSTEXPR + static inline int digits10() { return 0; } + +private: + static inline std::string epsilon(); + static inline std::string dummy_precision(); + static inline std::string lowest(); + static inline std::string highest(); + static inline std::string infinity(); + static inline std::string quiet_NaN(); +}; + +// Empty specialization for void to allow template specialization based on NumTraits::Real with T==void and SFINAE. +template<> struct NumTraits {}; + +template<> struct NumTraits : GenericNumTraits {}; + +} // end namespace Eigen + +#endif // EIGEN_NUMTRAITS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h b/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h new file mode 100644 index 0000000..29abf35 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PartialReduxEvaluator.h @@ -0,0 +1,232 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2011-2018 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PARTIALREDUX_H +#define EIGEN_PARTIALREDUX_H + +namespace Eigen { + +namespace internal { + + +/*************************************************************************** +* +* This file provides evaluators for partial reductions. +* There are two modes: +* +* - scalar path: simply calls the respective function on the column or row. +* -> nothing special here, all the tricky part is handled by the return +* types of VectorwiseOp's members. They embed the functor calling the +* respective DenseBase's member function. +* +* - vectorized path: implements a packet-wise reductions followed by +* some (optional) processing of the outcome, e.g., division by n for mean. +* +* For the vectorized path let's observe that the packet-size and outer-unrolling +* are both decided by the assignement logic. So all we have to do is to decide +* on the inner unrolling. +* +* For the unrolling, we can reuse "internal::redux_vec_unroller" from Redux.h, +* but be need to be careful to specify correct increment. +* +***************************************************************************/ + + +/* logic deciding a strategy for unrolling of vectorized paths */ +template +struct packetwise_redux_traits +{ + enum { + OuterSize = int(Evaluator::IsRowMajor) ? Evaluator::RowsAtCompileTime : Evaluator::ColsAtCompileTime, + Cost = OuterSize == Dynamic ? HugeCost + : OuterSize * Evaluator::CoeffReadCost + (OuterSize-1) * functor_traits::Cost, + Unrolling = Cost <= EIGEN_UNROLLING_LIMIT ? CompleteUnrolling : NoUnrolling + }; + +}; + +/* Value to be returned when size==0 , by default let's return 0 */ +template +EIGEN_DEVICE_FUNC +PacketType packetwise_redux_empty_value(const Func& ) { return pset1(0); } + +/* For products the default is 1 */ +template +EIGEN_DEVICE_FUNC +PacketType packetwise_redux_empty_value(const scalar_product_op& ) { return pset1(1); } + +/* Perform the actual reduction */ +template::Unrolling +> +struct packetwise_redux_impl; + +/* Perform the actual reduction with unrolling */ +template +struct packetwise_redux_impl +{ + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + PacketType run(const Evaluator &eval, const Func& func, Index /*size*/) + { + return redux_vec_unroller::OuterSize>::template run(eval,func); + } +}; + +/* Add a specialization of redux_vec_unroller for size==0 at compiletime. + * This specialization is not required for general reductions, which is + * why it is defined here. + */ +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &, const Func& f) + { + return packetwise_redux_empty_value(f); + } +}; + +/* Perform the actual reduction for dynamic sizes */ +template +struct packetwise_redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + EIGEN_DEVICE_FUNC + static PacketType run(const Evaluator &eval, const Func& func, Index size) + { + if(size==0) + return packetwise_redux_empty_value(func); + + const Index size4 = (size-1)&(~3); + PacketType p = eval.template packetByOuterInner(0,0); + Index i = 1; + // This loop is optimized for instruction pipelining: + // - each iteration generates two independent instructions + // - thanks to branch prediction and out-of-order execution we have independent instructions across loops + for(; i(i+0,0),eval.template packetByOuterInner(i+1,0)), + func.packetOp(eval.template packetByOuterInner(i+2,0),eval.template packetByOuterInner(i+3,0)))); + for(; i(i,0)); + return p; + } +}; + +template< typename ArgType, typename MemberOp, int Direction> +struct evaluator > + : evaluator_base > +{ + typedef PartialReduxExpr XprType; + typedef typename internal::nested_eval::type ArgTypeNested; + typedef typename internal::add_const_on_value_type::type ConstArgTypeNested; + typedef typename internal::remove_all::type ArgTypeNestedCleaned; + typedef typename ArgType::Scalar InputScalar; + typedef typename XprType::Scalar Scalar; + enum { + TraversalSize = Direction==int(Vertical) ? int(ArgType::RowsAtCompileTime) : int(ArgType::ColsAtCompileTime) + }; + typedef typename MemberOp::template Cost CostOpType; + enum { + CoeffReadCost = TraversalSize==Dynamic ? HugeCost + : TraversalSize==0 ? 1 + : int(TraversalSize) * int(evaluator::CoeffReadCost) + int(CostOpType::value), + + _ArgFlags = evaluator::Flags, + + _Vectorizable = bool(int(_ArgFlags)&PacketAccessBit) + && bool(MemberOp::Vectorizable) + && (Direction==int(Vertical) ? bool(_ArgFlags&RowMajorBit) : (_ArgFlags&RowMajorBit)==0) + && (TraversalSize!=0), + + Flags = (traits::Flags&RowMajorBit) + | (evaluator::Flags&(HereditaryBits&(~RowMajorBit))) + | (_Vectorizable ? PacketAccessBit : 0) + | LinearAccessBit, + + Alignment = 0 // FIXME this will need to be improved once PartialReduxExpr is vectorized + }; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType xpr) + : m_arg(xpr.nestedExpression()), m_functor(xpr.functor()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(TraversalSize==Dynamic ? HugeCost : (TraversalSize==0 ? 1 : int(CostOpType::value))); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar coeff(Index i, Index j) const + { + return coeff(Direction==Vertical ? j : i); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const Scalar coeff(Index index) const + { + return m_functor(m_arg.template subVector(index)); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PacketType packet(Index i, Index j) const + { + return packet(Direction==Vertical ? j : i); + } + + template + EIGEN_STRONG_INLINE EIGEN_DEVICE_FUNC + PacketType packet(Index idx) const + { + enum { PacketSize = internal::unpacket_traits::size }; + typedef Block PanelType; + + PanelType panel(m_arg, + Direction==Vertical ? 0 : idx, + Direction==Vertical ? idx : 0, + Direction==Vertical ? m_arg.rows() : Index(PacketSize), + Direction==Vertical ? Index(PacketSize) : m_arg.cols()); + + // FIXME + // See bug 1612, currently if PacketSize==1 (i.e. complex with 128bits registers) then the storage-order of panel get reversed + // and methods like packetByOuterInner do not make sense anymore in this context. + // So let's just by pass "vectorization" in this case: + if(PacketSize==1) + return internal::pset1(coeff(idx)); + + typedef typename internal::redux_evaluator PanelEvaluator; + PanelEvaluator panel_eval(panel); + typedef typename MemberOp::BinaryOp BinaryOp; + PacketType p = internal::packetwise_redux_impl::template run(panel_eval,m_functor.binaryFunc(),m_arg.outerSize()); + return p; + } + +protected: + ConstArgTypeNested m_arg; + const MemberOp m_functor; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PARTIALREDUX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h b/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h new file mode 100644 index 0000000..69401bf --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PermutationMatrix.h @@ -0,0 +1,605 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009 Benoit Jacob +// Copyright (C) 2009-2015 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PERMUTATIONMATRIX_H +#define EIGEN_PERMUTATIONMATRIX_H + +namespace Eigen { + +namespace internal { + +enum PermPermProduct_t {PermPermProduct}; + +} // end namespace internal + +/** \class PermutationBase + * \ingroup Core_Module + * + * \brief Base class for permutations + * + * \tparam Derived the derived class + * + * This class is the base class for all expressions representing a permutation matrix, + * internally stored as a vector of integers. + * The convention followed here is that if \f$ \sigma \f$ is a permutation, the corresponding permutation matrix + * \f$ P_\sigma \f$ is such that if \f$ (e_1,\ldots,e_p) \f$ is the canonical basis, we have: + * \f[ P_\sigma(e_i) = e_{\sigma(i)}. \f] + * This convention ensures that for any two permutations \f$ \sigma, \tau \f$, we have: + * \f[ P_{\sigma\circ\tau} = P_\sigma P_\tau. \f] + * + * Permutation matrices are square and invertible. + * + * Notice that in addition to the member functions and operators listed here, there also are non-member + * operator* to multiply any kind of permutation object with any kind of matrix expression (MatrixBase) + * on either side. + * + * \sa class PermutationMatrix, class PermutationWrapper + */ +template +class PermutationBase : public EigenBase +{ + typedef internal::traits Traits; + typedef EigenBase Base; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + enum { + Flags = Traits::Flags, + RowsAtCompileTime = Traits::RowsAtCompileTime, + ColsAtCompileTime = Traits::ColsAtCompileTime, + MaxRowsAtCompileTime = Traits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = Traits::MaxColsAtCompileTime + }; + typedef typename Traits::StorageIndex StorageIndex; + typedef Matrix + DenseMatrixType; + typedef PermutationMatrix + PlainPermutationType; + typedef PlainPermutationType PlainObject; + using Base::derived; + typedef Inverse InverseReturnType; + typedef void Scalar; + #endif + + /** Copies the other permutation into *this */ + template + Derived& operator=(const PermutationBase& other) + { + indices() = other.indices(); + return derived(); + } + + /** Assignment from the Transpositions \a tr */ + template + Derived& operator=(const TranspositionsBase& tr) + { + setIdentity(tr.size()); + for(Index k=size()-1; k>=0; --k) + applyTranspositionOnTheRight(k,tr.coeff(k)); + return derived(); + } + + /** \returns the number of rows */ + inline EIGEN_DEVICE_FUNC Index rows() const { return Index(indices().size()); } + + /** \returns the number of columns */ + inline EIGEN_DEVICE_FUNC Index cols() const { return Index(indices().size()); } + + /** \returns the size of a side of the respective square matrix, i.e., the number of indices */ + inline EIGEN_DEVICE_FUNC Index size() const { return Index(indices().size()); } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const + { + other.setZero(); + for (Index i=0; i=0 && j>=0 && i=0 && j>=0 && i + void assignTranspose(const PermutationBase& other) + { + for (Index i=0; i + void assignProduct(const Lhs& lhs, const Rhs& rhs) + { + eigen_assert(lhs.cols() == rhs.rows()); + for (Index i=0; i + inline PlainPermutationType operator*(const PermutationBase& other) const + { return PlainPermutationType(internal::PermPermProduct, derived(), other.derived()); } + + /** \returns the product of a permutation with another inverse permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template + inline PlainPermutationType operator*(const InverseImpl& other) const + { return PlainPermutationType(internal::PermPermProduct, *this, other.eval()); } + + /** \returns the product of an inverse permutation with another permutation. + * + * \note \blank \note_try_to_help_rvo + */ + template friend + inline PlainPermutationType operator*(const InverseImpl& other, const PermutationBase& perm) + { return PlainPermutationType(internal::PermPermProduct, other.eval(), perm); } + + /** \returns the determinant of the permutation matrix, which is either 1 or -1 depending on the parity of the permutation. + * + * This function is O(\c n) procedure allocating a buffer of \c n booleans. + */ + Index determinant() const + { + Index res = 1; + Index n = size(); + Matrix mask(n); + mask.fill(false); + Index r = 0; + while(r < n) + { + // search for the next seed + while(r=n) + break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + mask.coeffRef(k0) = true; + for(Index k=indices().coeff(k0); k!=k0; k=indices().coeff(k)) + { + mask.coeffRef(k) = true; + res = -res; + } + } + return res; + } + + protected: + +}; + +namespace internal { +template +struct traits > + : traits > +{ + typedef PermutationStorage StorageKind; + typedef Matrix<_StorageIndex, SizeAtCompileTime, 1, 0, MaxSizeAtCompileTime, 1> IndicesType; + typedef _StorageIndex StorageIndex; + typedef void Scalar; +}; +} + +/** \class PermutationMatrix + * \ingroup Core_Module + * + * \brief Permutation matrix + * + * \tparam SizeAtCompileTime the number of rows/cols, or Dynamic + * \tparam MaxSizeAtCompileTime the maximum number of rows/cols, or Dynamic. This optional parameter defaults to SizeAtCompileTime. Most of the time, you should not have to specify it. + * \tparam _StorageIndex the integer type of the indices + * + * This class represents a permutation matrix, internally stored as a vector of integers. + * + * \sa class PermutationBase, class PermutationWrapper, class DiagonalMatrix + */ +template +class PermutationMatrix : public PermutationBase > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + typedef const PermutationMatrix& Nested; + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename Traits::StorageIndex StorageIndex; + #endif + + inline PermutationMatrix() + {} + + /** Constructs an uninitialized permutation matrix of given size. + */ + explicit inline PermutationMatrix(Index size) : m_indices(size) + { + eigen_internal_assert(size <= NumTraits::highest()); + } + + /** Copy constructor. */ + template + inline PermutationMatrix(const PermutationBase& other) + : m_indices(other.indices()) {} + + /** Generic constructor from expression of the indices. The indices + * array has the meaning that the permutations sends each integer i to indices[i]. + * + * \warning It is your responsibility to check that the indices array that you passes actually + * describes a permutation, i.e., each value between 0 and n-1 occurs exactly once, where n is the + * array's size. + */ + template + explicit inline PermutationMatrix(const MatrixBase& indices) : m_indices(indices) + {} + + /** Convert the Transpositions \a tr to a permutation matrix */ + template + explicit PermutationMatrix(const TranspositionsBase& tr) + : m_indices(tr.size()) + { + *this = tr; + } + + /** Copies the other permutation into *this */ + template + PermutationMatrix& operator=(const PermutationBase& other) + { + m_indices = other.indices(); + return *this; + } + + /** Assignment from the Transpositions \a tr */ + template + PermutationMatrix& operator=(const TranspositionsBase& tr) + { + return Base::operator=(tr.derived()); + } + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + + /**** multiplication helpers to hopefully get RVO ****/ + +#ifndef EIGEN_PARSED_BY_DOXYGEN + template + PermutationMatrix(const InverseImpl& other) + : m_indices(other.derived().nestedExpression().size()) + { + eigen_internal_assert(m_indices.size() <= NumTraits::highest()); + StorageIndex end = StorageIndex(m_indices.size()); + for (StorageIndex i=0; i + PermutationMatrix(internal::PermPermProduct_t, const Lhs& lhs, const Rhs& rhs) + : m_indices(lhs.indices().size()) + { + Base::assignProduct(lhs,rhs); + } +#endif + + protected: + + IndicesType m_indices; +}; + + +namespace internal { +template +struct traits,_PacketAccess> > + : traits > +{ + typedef PermutationStorage StorageKind; + typedef Map, _PacketAccess> IndicesType; + typedef _StorageIndex StorageIndex; + typedef void Scalar; +}; +} + +template +class Map,_PacketAccess> + : public PermutationBase,_PacketAccess> > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + typedef typename IndicesType::Scalar StorageIndex; + #endif + + inline Map(const StorageIndex* indicesPtr) + : m_indices(indicesPtr) + {} + + inline Map(const StorageIndex* indicesPtr, Index size) + : m_indices(indicesPtr,size) + {} + + /** Copies the other permutation into *this */ + template + Map& operator=(const PermutationBase& other) + { return Base::operator=(other.derived()); } + + /** Assignment from the Transpositions \a tr */ + template + Map& operator=(const TranspositionsBase& tr) + { return Base::operator=(tr.derived()); } + + #ifndef EIGEN_PARSED_BY_DOXYGEN + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + Map& operator=(const Map& other) + { + m_indices = other.m_indices; + return *this; + } + #endif + + /** const version of indices(). */ + const IndicesType& indices() const { return m_indices; } + /** \returns a reference to the stored array representing the permutation. */ + IndicesType& indices() { return m_indices; } + + protected: + + IndicesType m_indices; +}; + +template class TranspositionsWrapper; +namespace internal { +template +struct traits > +{ + typedef PermutationStorage StorageKind; + typedef void Scalar; + typedef typename _IndicesType::Scalar StorageIndex; + typedef _IndicesType IndicesType; + enum { + RowsAtCompileTime = _IndicesType::SizeAtCompileTime, + ColsAtCompileTime = _IndicesType::SizeAtCompileTime, + MaxRowsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + MaxColsAtCompileTime = IndicesType::MaxSizeAtCompileTime, + Flags = 0 + }; +}; +} + +/** \class PermutationWrapper + * \ingroup Core_Module + * + * \brief Class to view a vector of integers as a permutation matrix + * + * \tparam _IndicesType the type of the vector of integer (can be any compatible expression) + * + * This class allows to view any vector expression of integers as a permutation matrix. + * + * \sa class PermutationBase, class PermutationMatrix + */ +template +class PermutationWrapper : public PermutationBase > +{ + typedef PermutationBase Base; + typedef internal::traits Traits; + public: + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename Traits::IndicesType IndicesType; + #endif + + inline PermutationWrapper(const IndicesType& indices) + : m_indices(indices) + {} + + /** const version of indices(). */ + const typename internal::remove_all::type& + indices() const { return m_indices; } + + protected: + + typename IndicesType::Nested m_indices; +}; + + +/** \returns the matrix with the permutation applied to the columns. + */ +template +EIGEN_DEVICE_FUNC +const Product +operator*(const MatrixBase &matrix, + const PermutationBase& permutation) +{ + return Product + (matrix.derived(), permutation.derived()); +} + +/** \returns the matrix with the permutation applied to the rows. + */ +template +EIGEN_DEVICE_FUNC +const Product +operator*(const PermutationBase &permutation, + const MatrixBase& matrix) +{ + return Product + (permutation.derived(), matrix.derived()); +} + + +template +class InverseImpl + : public EigenBase > +{ + typedef typename PermutationType::PlainPermutationType PlainPermutationType; + typedef internal::traits PermTraits; + protected: + InverseImpl() {} + public: + typedef Inverse InverseType; + using EigenBase >::derived; + + #ifndef EIGEN_PARSED_BY_DOXYGEN + typedef typename PermutationType::DenseMatrixType DenseMatrixType; + enum { + RowsAtCompileTime = PermTraits::RowsAtCompileTime, + ColsAtCompileTime = PermTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = PermTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = PermTraits::MaxColsAtCompileTime + }; + #endif + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + void evalTo(MatrixBase& other) const + { + other.setZero(); + for (Index i=0; i friend + const Product + operator*(const MatrixBase& matrix, const InverseType& trPerm) + { + return Product(matrix.derived(), trPerm.derived()); + } + + /** \returns the matrix with the inverse permutation applied to the rows. + */ + template + const Product + operator*(const MatrixBase& matrix) const + { + return Product(derived(), matrix.derived()); + } +}; + +template +const PermutationWrapper MatrixBase::asPermutation() const +{ + return derived(); +} + +namespace internal { + +template<> struct AssignmentKind { typedef EigenBase2EigenBase Kind; }; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PERMUTATIONMATRIX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h b/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h new file mode 100644 index 0000000..e2ddbd1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/PlainObjectBase.h @@ -0,0 +1,1128 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2009 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_DENSESTORAGEBASE_H +#define EIGEN_DENSESTORAGEBASE_H + +#if defined(EIGEN_INITIALIZE_MATRICES_BY_ZERO) +# define EIGEN_INITIALIZE_COEFFS +# define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED for(Index i=0;i::quiet_NaN(); +#else +# undef EIGEN_INITIALIZE_COEFFS +# define EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED +#endif + +namespace Eigen { + +namespace internal { + +template struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE void run(Index, Index) + { + } +}; + +template<> struct check_rows_cols_for_overflow { + template + EIGEN_DEVICE_FUNC + static EIGEN_ALWAYS_INLINE void run(Index rows, Index cols) + { + // http://hg.mozilla.org/mozilla-central/file/6c8a909977d3/xpcom/ds/CheckedInt.h#l242 + // we assume Index is signed + Index max_index = (std::size_t(1) << (8 * sizeof(Index) - 1)) - 1; // assume Index is signed + bool error = (rows == 0 || cols == 0) ? false + : (rows > max_index / cols); + if (error) + throw_std_bad_alloc(); + } +}; + +template +struct conservative_resize_like_impl; + +template struct matrix_swap_impl; + +} // end namespace internal + +#ifdef EIGEN_PARSED_BY_DOXYGEN +namespace doxygen { + +// This is a workaround to doxygen not being able to understand the inheritance logic +// when it is hidden by the dense_xpr_base helper struct. +// Moreover, doxygen fails to include members that are not documented in the declaration body of +// MatrixBase if we inherits MatrixBase >, +// this is why we simply inherits MatrixBase, though this does not make sense. + +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template struct dense_xpr_base_dispatcher; +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template +struct dense_xpr_base_dispatcher > + : public MatrixBase {}; +/** This class is just a workaround for Doxygen and it does not not actually exist. */ +template +struct dense_xpr_base_dispatcher > + : public ArrayBase {}; + +} // namespace doxygen + +/** \class PlainObjectBase + * \ingroup Core_Module + * \brief %Dense storage base class for matrices and arrays. + * + * This class can be extended with the help of the plugin mechanism described on the page + * \ref TopicCustomizing_Plugins by defining the preprocessor symbol \c EIGEN_PLAINOBJECTBASE_PLUGIN. + * + * \tparam Derived is the derived type, e.g., a Matrix or Array + * + * \sa \ref TopicClassHierarchy + */ +template +class PlainObjectBase : public doxygen::dense_xpr_base_dispatcher +#else +template +class PlainObjectBase : public internal::dense_xpr_base::type +#endif +{ + public: + enum { Options = internal::traits::Options }; + typedef typename internal::dense_xpr_base::type Base; + + typedef typename internal::traits::StorageKind StorageKind; + typedef typename internal::traits::Scalar Scalar; + + typedef typename internal::packet_traits::type PacketScalar; + typedef typename NumTraits::Real RealScalar; + typedef Derived DenseType; + + using Base::RowsAtCompileTime; + using Base::ColsAtCompileTime; + using Base::SizeAtCompileTime; + using Base::MaxRowsAtCompileTime; + using Base::MaxColsAtCompileTime; + using Base::MaxSizeAtCompileTime; + using Base::IsVectorAtCompileTime; + using Base::Flags; + + typedef Eigen::Map MapType; + typedef const Eigen::Map ConstMapType; + typedef Eigen::Map AlignedMapType; + typedef const Eigen::Map ConstAlignedMapType; + template struct StridedMapType { typedef Eigen::Map type; }; + template struct StridedConstMapType { typedef Eigen::Map type; }; + template struct StridedAlignedMapType { typedef Eigen::Map type; }; + template struct StridedConstAlignedMapType { typedef Eigen::Map type; }; + + protected: + DenseStorage m_storage; + + public: + enum { NeedsToAlign = (SizeAtCompileTime != Dynamic) && (internal::traits::Alignment>0) }; + EIGEN_MAKE_ALIGNED_OPERATOR_NEW_IF(NeedsToAlign) + + EIGEN_DEVICE_FUNC + Base& base() { return *static_cast(this); } + EIGEN_DEVICE_FUNC + const Base& base() const { return *static_cast(this); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_storage.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_storage.cols(); } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeff(Index rowId, Index colId) const + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeff(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeff(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeff(Index index) const + { + return m_storage.data()[index]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index,Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index,Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index rowId, Index colId) + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is an overloaded version of DenseCoeffsBase::coeffRef(Index) const + * provided to by-pass the creation of an evaluator of the expression, thus saving compilation efforts. + * + * See DenseCoeffsBase::coeffRef(Index) const for details. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Scalar& coeffRef(Index index) + { + return m_storage.data()[index]; + } + + /** This is the const version of coeffRef(Index,Index) which is thus synonym of coeff(Index,Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeffRef(Index rowId, Index colId) const + { + if(Flags & RowMajorBit) + return m_storage.data()[colId + rowId * m_storage.cols()]; + else // column-major + return m_storage.data()[rowId + colId * m_storage.rows()]; + } + + /** This is the const version of coeffRef(Index) which is thus synonym of coeff(Index). + * It is provided for convenience. */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const Scalar& coeffRef(Index index) const + { + return m_storage.data()[index]; + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index rowId, Index colId) const + { + return internal::ploadt + (m_storage.data() + (Flags & RowMajorBit + ? colId + rowId * m_storage.cols() + : rowId + colId * m_storage.rows())); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE PacketScalar packet(Index index) const + { + return internal::ploadt(m_storage.data() + index); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + internal::pstoret + (m_storage.data() + (Flags & RowMajorBit + ? colId + rowId * m_storage.cols() + : rowId + colId * m_storage.rows()), val); + } + + /** \internal */ + template + EIGEN_STRONG_INLINE void writePacket(Index index, const PacketScalar& val) + { + internal::pstoret(m_storage.data() + index, val); + } + + /** \returns a const pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar *data() const + { return m_storage.data(); } + + /** \returns a pointer to the data array of this matrix */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar *data() + { return m_storage.data(); } + + /** Resizes \c *this to a \a rows x \a cols matrix. + * + * This method is intended for dynamic-size matrices, although it is legal to call it on any + * matrix as long as fixed dimensions are left unchanged. If you only want to change the number + * of rows and/or of columns, you can use resize(NoChange_t, Index), resize(Index, NoChange_t). + * + * If the current number of coefficients of \c *this exactly matches the + * product \a rows * \a cols, then no memory allocation is performed and + * the current values are left unchanged. In all other cases, including + * shrinking, the data is reallocated and all previous values are lost. + * + * Example: \include Matrix_resize_int_int.cpp + * Output: \verbinclude Matrix_resize_int_int.out + * + * \sa resize(Index) for vectors, resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void resize(Index rows, Index cols) + { + eigen_assert( EIGEN_IMPLIES(RowsAtCompileTime!=Dynamic,rows==RowsAtCompileTime) + && EIGEN_IMPLIES(ColsAtCompileTime!=Dynamic,cols==ColsAtCompileTime) + && EIGEN_IMPLIES(RowsAtCompileTime==Dynamic && MaxRowsAtCompileTime!=Dynamic,rows<=MaxRowsAtCompileTime) + && EIGEN_IMPLIES(ColsAtCompileTime==Dynamic && MaxColsAtCompileTime!=Dynamic,cols<=MaxColsAtCompileTime) + && rows>=0 && cols>=0 && "Invalid sizes when resizing a matrix or array."); + internal::check_rows_cols_for_overflow::run(rows, cols); + #ifdef EIGEN_INITIALIZE_COEFFS + Index size = rows*cols; + bool size_changed = size != this->size(); + m_storage.resize(size, rows, cols); + if(size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + #else + m_storage.resize(rows*cols, rows, cols); + #endif + } + + /** Resizes \c *this to a vector of length \a size + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * Example: \include Matrix_resize_int.cpp + * Output: \verbinclude Matrix_resize_int.out + * + * \sa resize(Index,Index), resize(NoChange_t, Index), resize(Index, NoChange_t) + */ + EIGEN_DEVICE_FUNC + inline void resize(Index size) + { + EIGEN_STATIC_ASSERT_VECTOR_ONLY(PlainObjectBase) + eigen_assert(((SizeAtCompileTime == Dynamic && (MaxSizeAtCompileTime==Dynamic || size<=MaxSizeAtCompileTime)) || SizeAtCompileTime == size) && size>=0); + #ifdef EIGEN_INITIALIZE_COEFFS + bool size_changed = size != this->size(); + #endif + if(RowsAtCompileTime == 1) + m_storage.resize(size, 1, size); + else + m_storage.resize(size, size, 1); + #ifdef EIGEN_INITIALIZE_COEFFS + if(size_changed) EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + #endif + } + + /** Resizes the matrix, changing only the number of columns. For the parameter of type NoChange_t, just pass the special value \c NoChange + * as in the example below. + * + * Example: \include Matrix_resize_NoChange_int.cpp + * Output: \verbinclude Matrix_resize_NoChange_int.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + inline void resize(NoChange_t, Index cols) + { + resize(rows(), cols); + } + + /** Resizes the matrix, changing only the number of rows. For the parameter of type NoChange_t, just pass the special value \c NoChange + * as in the example below. + * + * Example: \include Matrix_resize_int_NoChange.cpp + * Output: \verbinclude Matrix_resize_int_NoChange.out + * + * \sa resize(Index,Index) + */ + EIGEN_DEVICE_FUNC + inline void resize(Index rows, NoChange_t) + { + resize(rows, cols()); + } + + /** Resizes \c *this to have the same dimensions as \a other. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void resizeLike(const EigenBase& _other) + { + const OtherDerived& other = _other.derived(); + internal::check_rows_cols_for_overflow::run(other.rows(), other.cols()); + const Index othersize = other.rows()*other.cols(); + if(RowsAtCompileTime == 1) + { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(1, othersize); + } + else if(ColsAtCompileTime == 1) + { + eigen_assert(other.rows() == 1 || other.cols() == 1); + resize(othersize, 1); + } + else resize(other.rows(), other.cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index rows, Index cols) + { + internal::conservative_resize_like_impl::run(*this, rows, cols); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of columns unchanged. + * + * In case the matrix is growing, new rows will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index rows, NoChange_t) + { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows, cols()); + } + + /** Resizes the matrix to \a rows x \a cols while leaving old values untouched. + * + * As opposed to conservativeResize(Index rows, Index cols), this version leaves + * the number of rows unchanged. + * + * In case the matrix is growing, new columns will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(NoChange_t, Index cols) + { + // Note: see the comment in conservativeResize(Index,Index) + conservativeResize(rows(), cols); + } + + /** Resizes the vector to \a size while retaining old values. + * + * \only_for_vectors. This method does not work for + * partially dynamic matrices when the static dimension is anything other + * than 1. For example it will not work with Matrix. + * + * When values are appended, they will be uninitialized. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResize(Index size) + { + internal::conservative_resize_like_impl::run(*this, size); + } + + /** Resizes the matrix to \a rows x \a cols of \c other, while leaving old values untouched. + * + * The method is intended for matrices of dynamic size. If you only want to change the number + * of rows and/or of columns, you can use conservativeResize(NoChange_t, Index) or + * conservativeResize(Index, NoChange_t). + * + * Matrices are resized relative to the top-left element. In case values need to be + * appended to the matrix they will copied from \c other. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void conservativeResizeLike(const DenseBase& other) + { + internal::conservative_resize_like_impl::run(*this, other); + } + + /** This is a special case of the templated operator=. Its purpose is to + * prevent a default operator= from hiding the templated operator=. + */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const PlainObjectBase& other) + { + return _set(other); + } + + /** \sa MatrixBase::lazyAssign() */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& lazyAssign(const DenseBase& other) + { + _resize_to_match(other); + return Base::lazyAssign(other.derived()); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const ReturnByValue& func) + { + resize(func.rows(), func.cols()); + return Base::operator=(func); + } + + // Prevent user from trying to instantiate PlainObjectBase objects + // by making all its constructor protected. See bug 1074. + protected: + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase() : m_storage() + { +// _check_template_params(); +// EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + +#ifndef EIGEN_PARSED_BY_DOXYGEN + // FIXME is it still needed ? + /** \internal */ + EIGEN_DEVICE_FUNC + explicit PlainObjectBase(internal::constructor_without_unaligned_array_assert) + : m_storage(internal::constructor_without_unaligned_array_assert()) + { +// _check_template_params(); EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } +#endif + +#if EIGEN_HAS_RVALUE_REFERENCES + EIGEN_DEVICE_FUNC + PlainObjectBase(PlainObjectBase&& other) EIGEN_NOEXCEPT + : m_storage( std::move(other.m_storage) ) + { + } + + EIGEN_DEVICE_FUNC + PlainObjectBase& operator=(PlainObjectBase&& other) EIGEN_NOEXCEPT + { + _check_template_params(); + m_storage = std::move(other.m_storage); + return *this; + } +#endif + + /** Copy constructor */ + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const PlainObjectBase& other) + : Base(), m_storage(other.m_storage) { } + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(Index size, Index rows, Index cols) + : m_storage(size, rows, cols) + { +// _check_template_params(); +// EIGEN_INITIALIZE_COEFFS_IF_THAT_OPTION_IS_ENABLED + } + + #if EIGEN_HAS_CXX11 + /** \brief Construct a row of column vector with fixed size from an arbitrary number of coefficients. \cpp11 + * + * \only_for_vectors + * + * This constructor is for 1D array or vectors with more than 4 coefficients. + * There exists C++98 analogue constructors for fixed-size array/vector having 1, 2, 3, or 4 coefficients. + * + * \warning To construct a column (resp. row) vector of fixed length, the number of values passed to this + * constructor must match the the fixed number of rows (resp. columns) of \c *this. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PlainObjectBase(const Scalar& a0, const Scalar& a1, const Scalar& a2, const Scalar& a3, const ArgTypes&... args) + : m_storage() + { + _check_template_params(); + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, sizeof...(args) + 4); + m_storage.data()[0] = a0; + m_storage.data()[1] = a1; + m_storage.data()[2] = a2; + m_storage.data()[3] = a3; + Index i = 4; + auto x = {(m_storage.data()[i++] = args, 0)...}; + static_cast(x); + } + + /** \brief Constructs a Matrix or Array and initializes it by elements given by an initializer list of initializer + * lists \cpp11 + */ + EIGEN_DEVICE_FUNC + explicit EIGEN_STRONG_INLINE PlainObjectBase(const std::initializer_list>& list) + : m_storage() + { + _check_template_params(); + + size_t list_size = 0; + if (list.begin() != list.end()) { + list_size = list.begin()->size(); + } + + // This is to allow syntax like VectorXi {{1, 2, 3, 4}} + if (ColsAtCompileTime == 1 && list.size() == 1) { + eigen_assert(list_size == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + resize(list_size, ColsAtCompileTime); + std::copy(list.begin()->begin(), list.begin()->end(), m_storage.data()); + } else { + eigen_assert(list.size() == static_cast(RowsAtCompileTime) || RowsAtCompileTime == Dynamic); + eigen_assert(list_size == static_cast(ColsAtCompileTime) || ColsAtCompileTime == Dynamic); + resize(list.size(), list_size); + + Index row_index = 0; + for (const std::initializer_list& row : list) { + eigen_assert(list_size == row.size()); + Index col_index = 0; + for (const Scalar& e : row) { + coeffRef(row_index, col_index) = e; + ++col_index; + } + ++row_index; + } + } + } + #endif // end EIGEN_HAS_CXX11 + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const DenseBase &other) + : m_storage() + { + _check_template_params(); + resizeLike(other); + _set_noalias(other); + } + + /** \sa PlainObjectBase::operator=(const EigenBase&) */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const EigenBase &other) + : m_storage() + { + _check_template_params(); + resizeLike(other); + *this = other.derived(); + } + /** \brief Copy constructor with in-place evaluation */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE PlainObjectBase(const ReturnByValue& other) + { + _check_template_params(); + // FIXME this does not automatically transpose vectors if necessary + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + public: + + /** \brief Copies the generic expression \a other into *this. + * \copydetails DenseBase::operator=(const EigenBase &other) + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& operator=(const EigenBase &other) + { + _resize_to_match(other); + Base::operator=(other.derived()); + return this->derived(); + } + + /** \name Map + * These are convenience functions returning Map objects. The Map() static functions return unaligned Map objects, + * while the AlignedMap() functions return aligned Map objects and thus should be called only with 16-byte-aligned + * \a data pointers. + * + * Here is an example using strides: + * \include Matrix_Map_stride.cpp + * Output: \verbinclude Matrix_Map_stride.out + * + * \see class Map + */ + //@{ + static inline ConstMapType Map(const Scalar* data) + { return ConstMapType(data); } + static inline MapType Map(Scalar* data) + { return MapType(data); } + static inline ConstMapType Map(const Scalar* data, Index size) + { return ConstMapType(data, size); } + static inline MapType Map(Scalar* data, Index size) + { return MapType(data, size); } + static inline ConstMapType Map(const Scalar* data, Index rows, Index cols) + { return ConstMapType(data, rows, cols); } + static inline MapType Map(Scalar* data, Index rows, Index cols) + { return MapType(data, rows, cols); } + + static inline ConstAlignedMapType MapAligned(const Scalar* data) + { return ConstAlignedMapType(data); } + static inline AlignedMapType MapAligned(Scalar* data) + { return AlignedMapType(data); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index size) + { return ConstAlignedMapType(data, size); } + static inline AlignedMapType MapAligned(Scalar* data, Index size) + { return AlignedMapType(data, size); } + static inline ConstAlignedMapType MapAligned(const Scalar* data, Index rows, Index cols) + { return ConstAlignedMapType(data, rows, cols); } + static inline AlignedMapType MapAligned(Scalar* data, Index rows, Index cols) + { return AlignedMapType(data, rows, cols); } + + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, const Stride& stride) + { return typename StridedConstMapType >::type(data, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, const Stride& stride) + { return typename StridedMapType >::type(data, stride); } + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, Index size, const Stride& stride) + { return typename StridedConstMapType >::type(data, size, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, Index size, const Stride& stride) + { return typename StridedMapType >::type(data, size, stride); } + template + static inline typename StridedConstMapType >::type Map(const Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedConstMapType >::type(data, rows, cols, stride); } + template + static inline typename StridedMapType >::type Map(Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedMapType >::type(data, rows, cols, stride); } + + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, stride); } + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, Index size, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, size, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, Index size, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, size, stride); } + template + static inline typename StridedConstAlignedMapType >::type MapAligned(const Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedConstAlignedMapType >::type(data, rows, cols, stride); } + template + static inline typename StridedAlignedMapType >::type MapAligned(Scalar* data, Index rows, Index cols, const Stride& stride) + { return typename StridedAlignedMapType >::type(data, rows, cols, stride); } + //@} + + using Base::setConstant; + EIGEN_DEVICE_FUNC Derived& setConstant(Index size, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(NoChange_t, Index cols, const Scalar& val); + EIGEN_DEVICE_FUNC Derived& setConstant(Index rows, NoChange_t, const Scalar& val); + + using Base::setZero; + EIGEN_DEVICE_FUNC Derived& setZero(Index size); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setZero(Index rows, NoChange_t); + + using Base::setOnes; + EIGEN_DEVICE_FUNC Derived& setOnes(Index size); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(NoChange_t, Index cols); + EIGEN_DEVICE_FUNC Derived& setOnes(Index rows, NoChange_t); + + using Base::setRandom; + Derived& setRandom(Index size); + Derived& setRandom(Index rows, Index cols); + Derived& setRandom(NoChange_t, Index cols); + Derived& setRandom(Index rows, NoChange_t); + + #ifdef EIGEN_PLAINOBJECTBASE_PLUGIN + #include EIGEN_PLAINOBJECTBASE_PLUGIN + #endif + + protected: + /** \internal Resizes *this in preparation for assigning \a other to it. + * Takes care of doing all the checking that's needed. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _resize_to_match(const EigenBase& other) + { + #ifdef EIGEN_NO_AUTOMATIC_RESIZING + eigen_assert((this->size()==0 || (IsVectorAtCompileTime ? (this->size() == other.size()) + : (rows() == other.rows() && cols() == other.cols()))) + && "Size mismatch. Automatic resizing is disabled because EIGEN_NO_AUTOMATIC_RESIZING is defined"); + EIGEN_ONLY_USED_FOR_DEBUG(other); + #else + resizeLike(other); + #endif + } + + /** + * \brief Copies the value of the expression \a other into \c *this with automatic resizing. + * + * *this might be resized to match the dimensions of \a other. If *this was a null matrix (not already initialized), + * it will be initialized. + * + * Note that copying a row-vector into a vector (and conversely) is allowed. + * The resizing, if any, is then done in the appropriate way so that row-vectors + * remain row-vectors and vectors remain vectors. + * + * \sa operator=(const MatrixBase&), _set_noalias() + * + * \internal + */ + // aliasing is dealt once in internal::call_assignment + // so at this stage we have to assume aliasing... and resising has to be done later. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& _set(const DenseBase& other) + { + internal::call_assignment(this->derived(), other.derived()); + return this->derived(); + } + + /** \internal Like _set() but additionally makes the assumption that no aliasing effect can happen (which + * is the case when creating a new matrix) so one can enforce lazy evaluation. + * + * \sa operator=(const MatrixBase&), _set() + */ + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE Derived& _set_noalias(const DenseBase& other) + { + // I don't think we need this resize call since the lazyAssign will anyways resize + // and lazyAssign will be called by the assign selector. + //_resize_to_match(other); + // the 'false' below means to enforce lazy evaluation. We don't use lazyAssign() because + // it wouldn't allow to copy a row-vector into a column-vector. + internal::call_assignment_no_alias(this->derived(), other.derived(), internal::assign_op()); + return this->derived(); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(Index rows, Index cols, typename internal::enable_if::type* = 0) + { + const bool t0_is_integer_alike = internal::is_valid_index_type::value; + const bool t1_is_integer_alike = internal::is_valid_index_type::value; + EIGEN_STATIC_ASSERT(t0_is_integer_alike && + t1_is_integer_alike, + FLOATING_POINT_ARGUMENT_PASSED__INTEGER_WAS_EXPECTED) + resize(rows,cols); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(const T0& val0, const T1& val1, typename internal::enable_if::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init2(const Index& val0, const Index& val1, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime==2,T1>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 2) + m_storage.data()[0] = Scalar(val0); + m_storage.data()[1] = Scalar(val1); + } + + // The argument is convertible to the Index type and we either have a non 1x1 Matrix, or a dynamic-sized Array, + // then the argument is meant to be the size of the object. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(Index size, typename internal::enable_if< (Base::SizeAtCompileTime!=1 || !internal::is_convertible::value) + && ((!internal::is_same::XprKind,ArrayXpr>::value || Base::SizeAtCompileTime==Dynamic)),T>::type* = 0) + { + // NOTE MSVC 2008 complains if we directly put bool(NumTraits::IsInteger) as the EIGEN_STATIC_ASSERT argument. + const bool is_integer_alike = internal::is_valid_index_type::value; + EIGEN_UNUSED_VARIABLE(is_integer_alike); + EIGEN_STATIC_ASSERT(is_integer_alike, + FLOATING_POINT_ARGUMENT_PASSED__INTEGER_WAS_EXPECTED) + resize(size); + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar type can be implicitly converted) + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar& val0, typename internal::enable_if::value,T>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = val0; + } + + // We have a 1x1 matrix/array => the argument is interpreted as the value of the unique coefficient (case where scalar type match the index type) + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Index& val0, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime==1 + && internal::is_convertible::value,T*>::type* = 0) + { + EIGEN_STATIC_ASSERT_VECTOR_SPECIFIC_SIZE(PlainObjectBase, 1) + m_storage.data()[0] = Scalar(val0); + } + + // Initialize a fixed size matrix from a pointer to raw data + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar* data){ + this->_set_noalias(ConstMapType(data)); + } + + // Initialize an arbitrary matrix from a dense expression + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const DenseBase& other){ + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from an object convertible to the Derived type. + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Derived& other){ + this->_set_noalias(other); + } + + // Initialize an arbitrary matrix from a generic Eigen expression + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const EigenBase& other){ + this->derived() = other; + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const ReturnByValue& other) + { + resize(other.rows(), other.cols()); + other.evalTo(this->derived()); + } + + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const RotationBase& r) + { + this->derived() = r; + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Scalar& val0, + typename internal::enable_if< Base::SizeAtCompileTime!=Dynamic + && Base::SizeAtCompileTime!=1 + && internal::is_convertible::value + && internal::is_same::XprKind,ArrayXpr>::value,T>::type* = 0) + { + Base::setConstant(val0); + } + + // For fixed-size Array + template + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE void _init1(const Index& val0, + typename internal::enable_if< (!internal::is_same::value) + && (internal::is_same::value) + && Base::SizeAtCompileTime!=Dynamic + && Base::SizeAtCompileTime!=1 + && internal::is_convertible::value + && internal::is_same::XprKind,ArrayXpr>::value,T*>::type* = 0) + { + Base::setConstant(val0); + } + + template + friend struct internal::matrix_swap_impl; + + public: + +#ifndef EIGEN_PARSED_BY_DOXYGEN + /** \internal + * \brief Override DenseBase::swap() since for dynamic-sized matrices + * of same type it is enough to swap the data pointers. + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(DenseBase & other) + { + enum { SwapPointers = internal::is_same::value && Base::SizeAtCompileTime==Dynamic }; + internal::matrix_swap_impl::run(this->derived(), other.derived()); + } + + /** \internal + * \brief const version forwarded to DenseBase::swap + */ + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void swap(DenseBase const & other) + { Base::swap(other.derived()); } + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void _check_template_params() + { + EIGEN_STATIC_ASSERT((EIGEN_IMPLIES(MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1, (int(Options)&RowMajor)==RowMajor) + && EIGEN_IMPLIES(MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1, (int(Options)&RowMajor)==0) + && ((RowsAtCompileTime == Dynamic) || (RowsAtCompileTime >= 0)) + && ((ColsAtCompileTime == Dynamic) || (ColsAtCompileTime >= 0)) + && ((MaxRowsAtCompileTime == Dynamic) || (MaxRowsAtCompileTime >= 0)) + && ((MaxColsAtCompileTime == Dynamic) || (MaxColsAtCompileTime >= 0)) + && (MaxRowsAtCompileTime == RowsAtCompileTime || RowsAtCompileTime==Dynamic) + && (MaxColsAtCompileTime == ColsAtCompileTime || ColsAtCompileTime==Dynamic) + && (Options & (DontAlign|RowMajor)) == Options), + INVALID_MATRIX_TEMPLATE_PARAMETERS) + } + + enum { IsPlainObjectBase = 1 }; +#endif + public: + // These apparently need to be down here for nvcc+icc to prevent duplicate + // Map symbol. + template friend class Eigen::Map; + friend class Eigen::Map; + friend class Eigen::Map; +#if EIGEN_MAX_ALIGN_BYTES>0 + // for EIGEN_MAX_ALIGN_BYTES==0, AlignedMax==Unaligned, and many compilers generate warnings for friend-ing a class twice. + friend class Eigen::Map; + friend class Eigen::Map; +#endif +}; + +namespace internal { + +template +struct conservative_resize_like_impl +{ + #if EIGEN_HAS_TYPE_TRAITS + static const bool IsRelocatable = std::is_trivially_copyable::value; + #else + static const bool IsRelocatable = !NumTraits::RequireInitialization; + #endif + static void run(DenseBase& _this, Index rows, Index cols) + { + if (_this.rows() == rows && _this.cols() == cols) return; + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + + if ( IsRelocatable + && (( Derived::IsRowMajor && _this.cols() == cols) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && _this.rows() == rows) )) // column-major and we change only the number of columns + { + internal::check_rows_cols_for_overflow::run(rows, cols); + _this.derived().m_storage.conservativeResize(rows*cols,rows,cols); + } + else + { + // The storage order does not allow us to use reallocation. + Derived tmp(rows,cols); + const Index common_rows = numext::mini(rows, _this.rows()); + const Index common_cols = numext::mini(cols, _this.cols()); + tmp.block(0,0,common_rows,common_cols) = _this.block(0,0,common_rows,common_cols); + _this.derived().swap(tmp); + } + } + + static void run(DenseBase& _this, const DenseBase& other) + { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + // Note: Here is space for improvement. Basically, for conservativeResize(Index,Index), + // neither RowsAtCompileTime or ColsAtCompileTime must be Dynamic. If only one of the + // dimensions is dynamic, one could use either conservativeResize(Index rows, NoChange_t) or + // conservativeResize(NoChange_t, Index cols). For these methods new static asserts like + // EIGEN_STATIC_ASSERT_DYNAMIC_ROWS and EIGEN_STATIC_ASSERT_DYNAMIC_COLS would be good. + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(Derived) + EIGEN_STATIC_ASSERT_DYNAMIC_SIZE(OtherDerived) + + if ( IsRelocatable && + (( Derived::IsRowMajor && _this.cols() == other.cols()) || // row-major and we change only the number of rows + (!Derived::IsRowMajor && _this.rows() == other.rows()) )) // column-major and we change only the number of columns + { + const Index new_rows = other.rows() - _this.rows(); + const Index new_cols = other.cols() - _this.cols(); + _this.derived().m_storage.conservativeResize(other.size(),other.rows(),other.cols()); + if (new_rows>0) + _this.bottomRightCorner(new_rows, other.cols()) = other.bottomRows(new_rows); + else if (new_cols>0) + _this.bottomRightCorner(other.rows(), new_cols) = other.rightCols(new_cols); + } + else + { + // The storage order does not allow us to use reallocation. + Derived tmp(other); + const Index common_rows = numext::mini(tmp.rows(), _this.rows()); + const Index common_cols = numext::mini(tmp.cols(), _this.cols()); + tmp.block(0,0,common_rows,common_cols) = _this.block(0,0,common_rows,common_cols); + _this.derived().swap(tmp); + } + } +}; + +// Here, the specialization for vectors inherits from the general matrix case +// to allow calling .conservativeResize(rows,cols) on vectors. +template +struct conservative_resize_like_impl + : conservative_resize_like_impl +{ + typedef conservative_resize_like_impl Base; + using Base::run; + using Base::IsRelocatable; + + static void run(DenseBase& _this, Index size) + { + const Index new_rows = Derived::RowsAtCompileTime==1 ? 1 : size; + const Index new_cols = Derived::RowsAtCompileTime==1 ? size : 1; + if(IsRelocatable) + _this.derived().m_storage.conservativeResize(size,new_rows,new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + } + + static void run(DenseBase& _this, const DenseBase& other) + { + if (_this.rows() == other.rows() && _this.cols() == other.cols()) return; + + const Index num_new_elements = other.size() - _this.size(); + + const Index new_rows = Derived::RowsAtCompileTime==1 ? 1 : other.rows(); + const Index new_cols = Derived::RowsAtCompileTime==1 ? other.cols() : 1; + if(IsRelocatable) + _this.derived().m_storage.conservativeResize(other.size(),new_rows,new_cols); + else + Base::run(_this.derived(), new_rows, new_cols); + + if (num_new_elements > 0) + _this.tail(num_new_elements) = other.tail(num_new_elements); + } +}; + +template +struct matrix_swap_impl +{ + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE void run(MatrixTypeA& a, MatrixTypeB& b) + { + a.base().swap(b); + } +}; + +template +struct matrix_swap_impl +{ + EIGEN_DEVICE_FUNC + static inline void run(MatrixTypeA& a, MatrixTypeB& b) + { + static_cast(a).m_storage.swap(static_cast(b).m_storage); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_DENSESTORAGEBASE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Product.h b/src/3rdparty/eigen/Eigen/src/Core/Product.h new file mode 100644 index 0000000..70a6c10 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Product.h @@ -0,0 +1,191 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2011 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_PRODUCT_H +#define EIGEN_PRODUCT_H + +namespace Eigen { + +template class ProductImpl; + +namespace internal { + +template +struct traits > +{ + typedef typename remove_all::type LhsCleaned; + typedef typename remove_all::type RhsCleaned; + typedef traits LhsTraits; + typedef traits RhsTraits; + + typedef MatrixXpr XprKind; + + typedef typename ScalarBinaryOpTraits::Scalar, typename traits::Scalar>::ReturnType Scalar; + typedef typename product_promote_storage_type::ret>::ret StorageKind; + typedef typename promote_index_type::type StorageIndex; + + enum { + RowsAtCompileTime = LhsTraits::RowsAtCompileTime, + ColsAtCompileTime = RhsTraits::ColsAtCompileTime, + MaxRowsAtCompileTime = LhsTraits::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsTraits::MaxColsAtCompileTime, + + // FIXME: only needed by GeneralMatrixMatrixTriangular + InnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(LhsTraits::ColsAtCompileTime, RhsTraits::RowsAtCompileTime), + + // The storage order is somewhat arbitrary here. The correct one will be determined through the evaluator. + Flags = (MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1) ? RowMajorBit + : (MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1) ? 0 + : ( ((LhsTraits::Flags&NoPreferredStorageOrderBit) && (RhsTraits::Flags&RowMajorBit)) + || ((RhsTraits::Flags&NoPreferredStorageOrderBit) && (LhsTraits::Flags&RowMajorBit)) ) ? RowMajorBit + : NoPreferredStorageOrderBit + }; +}; + +} // end namespace internal + +/** \class Product + * \ingroup Core_Module + * + * \brief Expression of the product of two arbitrary matrices or vectors + * + * \tparam _Lhs the type of the left-hand side expression + * \tparam _Rhs the type of the right-hand side expression + * + * This class represents an expression of the product of two arbitrary matrices. + * + * The other template parameters are: + * \tparam Option can be DefaultProduct, AliasFreeProduct, or LazyProduct + * + */ +template +class Product : public ProductImpl<_Lhs,_Rhs,Option, + typename internal::product_promote_storage_type::StorageKind, + typename internal::traits<_Rhs>::StorageKind, + internal::product_type<_Lhs,_Rhs>::ret>::ret> +{ + public: + + typedef _Lhs Lhs; + typedef _Rhs Rhs; + + typedef typename ProductImpl< + Lhs, Rhs, Option, + typename internal::product_promote_storage_type::StorageKind, + typename internal::traits::StorageKind, + internal::product_type::ret>::ret>::Base Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Product) + + typedef typename internal::ref_selector::type LhsNested; + typedef typename internal::ref_selector::type RhsNested; + typedef typename internal::remove_all::type LhsNestedCleaned; + typedef typename internal::remove_all::type RhsNestedCleaned; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + Product(const Lhs& lhs, const Rhs& rhs) : m_lhs(lhs), m_rhs(rhs) + { + eigen_assert(lhs.cols() == rhs.rows() + && "invalid matrix product" + && "if you wanted a coeff-wise or a dot product use the respective explicit functions"); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index rows() const EIGEN_NOEXCEPT { return m_lhs.rows(); } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE EIGEN_CONSTEXPR + Index cols() const EIGEN_NOEXCEPT { return m_rhs.cols(); } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const LhsNestedCleaned& lhs() const { return m_lhs; } + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const RhsNestedCleaned& rhs() const { return m_rhs; } + + protected: + + LhsNested m_lhs; + RhsNested m_rhs; +}; + +namespace internal { + +template::ret> +class dense_product_base + : public internal::dense_xpr_base >::type +{}; + +/** Conversion to scalar for inner-products */ +template +class dense_product_base + : public internal::dense_xpr_base >::type +{ + typedef Product ProductXpr; + typedef typename internal::dense_xpr_base::type Base; +public: + using Base::derived; + typedef typename Base::Scalar Scalar; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE operator const Scalar() const + { + return internal::evaluator(derived()).coeff(0,0); + } +}; + +} // namespace internal + +// Generic API dispatcher +template +class ProductImpl : public internal::generic_xpr_base, MatrixXpr, StorageKind>::type +{ + public: + typedef typename internal::generic_xpr_base, MatrixXpr, StorageKind>::type Base; +}; + +template +class ProductImpl + : public internal::dense_product_base +{ + typedef Product Derived; + + public: + + typedef typename internal::dense_product_base Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Derived) + protected: + enum { + IsOneByOne = (RowsAtCompileTime == 1 || RowsAtCompileTime == Dynamic) && + (ColsAtCompileTime == 1 || ColsAtCompileTime == Dynamic), + EnableCoeff = IsOneByOne || Option==LazyProduct + }; + + public: + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index row, Index col) const + { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert( (Option==LazyProduct) || (this->rows() == 1 && this->cols() == 1) ); + + return internal::evaluator(derived()).coeff(row,col); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE Scalar coeff(Index i) const + { + EIGEN_STATIC_ASSERT(EnableCoeff, THIS_METHOD_IS_ONLY_FOR_INNER_OR_LAZY_PRODUCTS); + eigen_assert( (Option==LazyProduct) || (this->rows() == 1 && this->cols() == 1) ); + + return internal::evaluator(derived()).coeff(i); + } + + +}; + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h b/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h new file mode 100644 index 0000000..8cf294b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ProductEvaluators.h @@ -0,0 +1,1179 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2008-2010 Gael Guennebaud +// Copyright (C) 2011 Jitse Niesen +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + + +#ifndef EIGEN_PRODUCTEVALUATORS_H +#define EIGEN_PRODUCTEVALUATORS_H + +namespace Eigen { + +namespace internal { + +/** \internal + * Evaluator of a product expression. + * Since products require special treatments to handle all possible cases, + * we simply defer the evaluation logic to a product_evaluator class + * which offers more partial specialization possibilities. + * + * \sa class product_evaluator + */ +template +struct evaluator > + : public product_evaluator > +{ + typedef Product XprType; + typedef product_evaluator Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) : Base(xpr) {} +}; + +// Catch "scalar * ( A * B )" and transform it to "(A*scalar) * B" +// TODO we should apply that rule only if that's really helpful +template +struct evaluator_assume_aliasing, + const CwiseNullaryOp, Plain1>, + const Product > > +{ + static const bool value = true; +}; +template +struct evaluator, + const CwiseNullaryOp, Plain1>, + const Product > > + : public evaluator > +{ + typedef CwiseBinaryOp, + const CwiseNullaryOp, Plain1>, + const Product > XprType; + typedef evaluator > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(xpr.lhs().functor().m_other * xpr.rhs().lhs() * xpr.rhs().rhs()) + {} +}; + + +template +struct evaluator, DiagIndex> > + : public evaluator, DiagIndex> > +{ + typedef Diagonal, DiagIndex> XprType; + typedef evaluator, DiagIndex> > Base; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE explicit evaluator(const XprType& xpr) + : Base(Diagonal, DiagIndex>( + Product(xpr.nestedExpression().lhs(), xpr.nestedExpression().rhs()), + xpr.index() )) + {} +}; + + +// Helper class to perform a matrix product with the destination at hand. +// Depending on the sizes of the factors, there are different evaluation strategies +// as controlled by internal::product_type. +template< typename Lhs, typename Rhs, + typename LhsShape = typename evaluator_traits::Shape, + typename RhsShape = typename evaluator_traits::Shape, + int ProductType = internal::product_type::value> +struct generic_product_impl; + +template +struct evaluator_assume_aliasing > { + static const bool value = true; +}; + +// This is the default evaluator implementation for products: +// It creates a temporary and call generic_product_impl +template +struct product_evaluator, ProductTag, LhsShape, RhsShape> + : public evaluator::PlainObject> +{ + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef evaluator Base; + enum { + Flags = Base::Flags | EvalBeforeNestingBit + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : m_result(xpr.rows(), xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + +// FIXME shall we handle nested_eval here?, +// if so, then we must take care at removing the call to nested_eval in the specializations (e.g., in permutation_matrix_product, transposition_matrix_product, etc.) +// typedef typename internal::nested_eval::type LhsNested; +// typedef typename internal::nested_eval::type RhsNested; +// typedef typename internal::remove_all::type LhsNestedCleaned; +// typedef typename internal::remove_all::type RhsNestedCleaned; +// +// const LhsNested lhs(xpr.lhs()); +// const RhsNested rhs(xpr.rhs()); +// +// generic_product_impl::evalTo(m_result, lhs, rhs); + + generic_product_impl::evalTo(m_result, xpr.lhs(), xpr.rhs()); + } + +protected: + PlainObject m_result; +}; + +// The following three shortcuts are enabled only if the scalar types match exactly. +// TODO: we could enable them for different scalar types when the product is not vectorized. + +// Dense = Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::assign_op &) + { + Index dstRows = src.rows(); + Index dstCols = src.cols(); + if((dst.rows()!=dstRows) || (dst.cols()!=dstCols)) + dst.resize(dstRows, dstCols); + // FIXME shall we handle nested_eval here? + generic_product_impl::evalTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense += Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::add_assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::add_assign_op &) + { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::addTo(dst, src.lhs(), src.rhs()); + } +}; + +// Dense -= Product +template< typename DstXprType, typename Lhs, typename Rhs, int Options, typename Scalar> +struct Assignment, internal::sub_assign_op, Dense2Dense, + typename enable_if<(Options==DefaultProduct || Options==AliasFreeProduct)>::type> +{ + typedef Product SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const internal::sub_assign_op &) + { + eigen_assert(dst.rows() == src.rows() && dst.cols() == src.cols()); + // FIXME shall we handle nested_eval here? + generic_product_impl::subTo(dst, src.lhs(), src.rhs()); + } +}; + + +// Dense ?= scalar * Product +// TODO we should apply that rule if that's really helpful +// for instance, this is not good for inner products +template< typename DstXprType, typename Lhs, typename Rhs, typename AssignFunc, typename Scalar, typename ScalarBis, typename Plain> +struct Assignment, const CwiseNullaryOp,Plain>, + const Product >, AssignFunc, Dense2Dense> +{ + typedef CwiseBinaryOp, + const CwiseNullaryOp,Plain>, + const Product > SrcXprType; + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const AssignFunc& func) + { + call_assignment_no_alias(dst, (src.lhs().functor().m_other * src.rhs().lhs())*src.rhs().rhs(), func); + } +}; + +//---------------------------------------- +// Catch "Dense ?= xpr + Product<>" expression to save one temporary +// FIXME we could probably enable these rules for any product, i.e., not only Dense and DefaultProduct + +template +struct evaluator_assume_aliasing::Scalar>, const OtherXpr, + const Product >, DenseShape > { + static const bool value = true; +}; + +template +struct evaluator_assume_aliasing::Scalar>, const OtherXpr, + const Product >, DenseShape > { + static const bool value = true; +}; + +template +struct assignment_from_xpr_op_product +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void run(DstXprType &dst, const SrcXprType &src, const InitialFunc& /*func*/) + { + call_assignment_no_alias(dst, src.lhs(), Func1()); + call_assignment_no_alias(dst, src.rhs(), Func2()); + } +}; + +#define EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(ASSIGN_OP,BINOP,ASSIGN_OP2) \ + template< typename DstXprType, typename OtherXpr, typename Lhs, typename Rhs, typename DstScalar, typename SrcScalar, typename OtherScalar,typename ProdScalar> \ + struct Assignment, const OtherXpr, \ + const Product >, internal::ASSIGN_OP, Dense2Dense> \ + : assignment_from_xpr_op_product, internal::ASSIGN_OP, internal::ASSIGN_OP2 > \ + {} + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_sum_op,add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op,scalar_sum_op,add_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op,scalar_sum_op,sub_assign_op); + +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(assign_op, scalar_difference_op,sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(add_assign_op,scalar_difference_op,sub_assign_op); +EIGEN_CATCH_ASSIGN_XPR_OP_PRODUCT(sub_assign_op,scalar_difference_op,add_assign_op); + +//---------------------------------------- + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + dst.coeffRef(0,0) = (lhs.transpose().cwiseProduct(rhs)).sum(); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + dst.coeffRef(0,0) += (lhs.transpose().cwiseProduct(rhs)).sum(); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { dst.coeffRef(0,0) -= (lhs.transpose().cwiseProduct(rhs)).sum(); } +}; + + +/*********************************************************************** +* Implementation of outer dense * dense vector product +***********************************************************************/ + +// Column major result +template +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs &lhs, const Rhs &rhs, const Func& func, const false_type&) +{ + evaluator rhsEval(rhs); + ei_declare_local_nested_eval(Lhs,lhs,Rhs::SizeAtCompileTime,actual_lhs); + // FIXME if cols is large enough, then it might be useful to make sure that lhs is sequentially stored + // FIXME not very good if rhs is real and lhs complex while alpha is real too + const Index cols = dst.cols(); + for (Index j=0; j +void EIGEN_DEVICE_FUNC outer_product_selector_run(Dst& dst, const Lhs &lhs, const Rhs &rhs, const Func& func, const true_type&) +{ + evaluator lhsEval(lhs); + ei_declare_local_nested_eval(Rhs,rhs,Lhs::SizeAtCompileTime,actual_rhs); + // FIXME if rows is large enough, then it might be useful to make sure that rhs is sequentially stored + // FIXME not very good if lhs is real and rhs complex while alpha is real too + const Index rows = dst.rows(); + for (Index i=0; i +struct generic_product_impl +{ + template struct is_row_major : internal::conditional<(int(T::Flags)&RowMajorBit), internal::true_type, internal::false_type>::type {}; + typedef typename Product::Scalar Scalar; + + // TODO it would be nice to be able to exploit our *_assign_op functors for that purpose + struct set { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() = src; } }; + struct add { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() += src; } }; + struct sub { template EIGEN_DEVICE_FUNC void operator()(const Dst& dst, const Src& src) const { dst.const_cast_derived() -= src; } }; + struct adds { + Scalar m_scale; + explicit adds(const Scalar& s) : m_scale(s) {} + template void EIGEN_DEVICE_FUNC operator()(const Dst& dst, const Src& src) const { + dst.const_cast_derived() += m_scale * src; + } + }; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, set(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, add(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + internal::outer_product_selector_run(dst, lhs, rhs, sub(), is_row_major()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + internal::outer_product_selector_run(dst, lhs, rhs, adds(alpha), is_row_major()); + } + +}; + + +// This base class provides default implementations for evalTo, addTo, subTo, in terms of scaleAndAddTo +template +struct generic_product_impl_base +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { dst.setZero(); scaleAndAddTo(dst, lhs, rhs, Scalar(1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { scaleAndAddTo(dst,lhs, rhs, Scalar(1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { scaleAndAddTo(dst, lhs, rhs, Scalar(-1)); } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { Derived::scaleAndAddTo(dst,lhs,rhs,alpha); } + +}; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename nested_eval::type LhsNested; + typedef typename nested_eval::type RhsNested; + typedef typename Product::Scalar Scalar; + enum { Side = Lhs::IsVectorAtCompileTime ? OnTheLeft : OnTheRight }; + typedef typename internal::remove_all::type>::type MatrixType; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + // Fallback to inner product if both the lhs and rhs is a runtime vector. + if (lhs.rows() == 1 && rhs.cols() == 1) { + dst.coeffRef(0,0) += alpha * lhs.row(0).conjugate().dot(rhs.col(0)); + return; + } + LhsNested actual_lhs(lhs); + RhsNested actual_rhs(rhs); + internal::gemv_dense_selector::HasUsableDirectAccess) + >::run(actual_lhs, actual_rhs, dst, alpha); + } +}; + +template +struct generic_product_impl +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // Same as: dst.noalias() = lhs.lazyProduct(rhs); + // but easier on the compiler side + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void addTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // dst.noalias() += lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::add_assign_op()); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void subTo(Dst& dst, const Lhs& lhs, const Rhs& rhs) + { + // dst.noalias() -= lhs.lazyProduct(rhs); + call_assignment_no_alias(dst, lhs.lazyProduct(rhs), internal::sub_assign_op()); + } + + // This is a special evaluation path called from generic_product_impl<...,GemmProduct> in file GeneralMatrixMatrix.h + // This variant tries to extract scalar multiples from both the LHS and RHS and factor them out. For instance: + // dst {,+,-}= (s1*A)*(B*s2) + // will be rewritten as: + // dst {,+,-}= (s1*s2) * (A.lazyProduct(B)) + // There are at least four benefits of doing so: + // 1 - huge performance gain for heap-allocated matrix types as it save costly allocations. + // 2 - it is faster than simply by-passing the heap allocation through stack allocation. + // 3 - it makes this fallback consistent with the heavy GEMM routine. + // 4 - it fully by-passes huge stack allocation attempts when multiplying huge fixed-size matrices. + // (see https://stackoverflow.com/questions/54738495) + // For small fixed sizes matrices, howver, the gains are less obvious, it is sometimes x2 faster, but sometimes x3 slower, + // and the behavior depends also a lot on the compiler... This is why this re-writting strategy is currently + // enabled only when falling back from the main GEMM. + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic(Dst& dst, const Lhs& lhs, const Rhs& rhs, const Func &func) + { + enum { + HasScalarFactor = blas_traits::HasScalarFactor || blas_traits::HasScalarFactor, + ConjLhs = blas_traits::NeedToConjugate, + ConjRhs = blas_traits::NeedToConjugate + }; + // FIXME: in c++11 this should be auto, and extractScalarFactor should also return auto + // this is important for real*complex_mat + Scalar actualAlpha = combine_scalar_factors(lhs, rhs); + + eval_dynamic_impl(dst, + blas_traits::extract(lhs).template conjugateIf(), + blas_traits::extract(rhs).template conjugateIf(), + func, + actualAlpha, + typename conditional::type()); + } + +protected: + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, const Func &func, const Scalar& s /* == 1 */, false_type) + { + EIGEN_UNUSED_VARIABLE(s); + eigen_internal_assert(s==Scalar(1)); + call_restricted_packet_assignment_no_alias(dst, lhs.lazyProduct(rhs), func); + } + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + void eval_dynamic_impl(Dst& dst, const LhsT& lhs, const RhsT& rhs, const Func &func, const Scalar& s, true_type) + { + call_restricted_packet_assignment_no_alias(dst, s * lhs.lazyProduct(rhs), func); + } +}; + +// This specialization enforces the use of a coefficient-based evaluation strategy +template +struct generic_product_impl + : generic_product_impl {}; + +// Case 2: Evaluate coeff by coeff +// +// This is mostly taken from CoeffBasedProduct.h +// The main difference is that we add an extra argument to the etor_product_*_impl::run() function +// for the inner dimension of the product, because evaluator object do not know their size. + +template +struct etor_product_coeff_impl; + +template +struct etor_product_packet_impl; + +template +struct product_evaluator, ProductTag, DenseShape, DenseShape> + : evaluator_base > +{ + typedef Product XprType; + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : m_lhs(xpr.lhs()), + m_rhs(xpr.rhs()), + m_lhsImpl(m_lhs), // FIXME the creation of the evaluator objects should result in a no-op, but check that! + m_rhsImpl(m_rhs), // Moreover, they are only useful for the packet path, so we could completely disable them when not needed, + // or perhaps declare them on the fly on the packet method... We have experiment to check what's best. + m_innerDim(xpr.lhs().cols()) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::AddCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); +#if 0 + std::cerr << "LhsOuterStrideBytes= " << LhsOuterStrideBytes << "\n"; + std::cerr << "RhsOuterStrideBytes= " << RhsOuterStrideBytes << "\n"; + std::cerr << "LhsAlignment= " << LhsAlignment << "\n"; + std::cerr << "RhsAlignment= " << RhsAlignment << "\n"; + std::cerr << "CanVectorizeLhs= " << CanVectorizeLhs << "\n"; + std::cerr << "CanVectorizeRhs= " << CanVectorizeRhs << "\n"; + std::cerr << "CanVectorizeInner= " << CanVectorizeInner << "\n"; + std::cerr << "EvalToRowMajor= " << EvalToRowMajor << "\n"; + std::cerr << "Alignment= " << Alignment << "\n"; + std::cerr << "Flags= " << Flags << "\n"; +#endif + } + + // Everything below here is taken from CoeffBasedProduct.h + + typedef typename internal::nested_eval::type LhsNested; + typedef typename internal::nested_eval::type RhsNested; + + typedef typename internal::remove_all::type LhsNestedCleaned; + typedef typename internal::remove_all::type RhsNestedCleaned; + + typedef evaluator LhsEtorType; + typedef evaluator RhsEtorType; + + enum { + RowsAtCompileTime = LhsNestedCleaned::RowsAtCompileTime, + ColsAtCompileTime = RhsNestedCleaned::ColsAtCompileTime, + InnerSize = EIGEN_SIZE_MIN_PREFER_FIXED(LhsNestedCleaned::ColsAtCompileTime, RhsNestedCleaned::RowsAtCompileTime), + MaxRowsAtCompileTime = LhsNestedCleaned::MaxRowsAtCompileTime, + MaxColsAtCompileTime = RhsNestedCleaned::MaxColsAtCompileTime + }; + + typedef typename find_best_packet::type LhsVecPacketType; + typedef typename find_best_packet::type RhsVecPacketType; + + enum { + + LhsCoeffReadCost = LhsEtorType::CoeffReadCost, + RhsCoeffReadCost = RhsEtorType::CoeffReadCost, + CoeffReadCost = InnerSize==0 ? NumTraits::ReadCost + : InnerSize == Dynamic ? HugeCost + : InnerSize * (NumTraits::MulCost + int(LhsCoeffReadCost) + int(RhsCoeffReadCost)) + + (InnerSize - 1) * NumTraits::AddCost, + + Unroll = CoeffReadCost <= EIGEN_UNROLLING_LIMIT, + + LhsFlags = LhsEtorType::Flags, + RhsFlags = RhsEtorType::Flags, + + LhsRowMajor = LhsFlags & RowMajorBit, + RhsRowMajor = RhsFlags & RowMajorBit, + + LhsVecPacketSize = unpacket_traits::size, + RhsVecPacketSize = unpacket_traits::size, + + // Here, we don't care about alignment larger than the usable packet size. + LhsAlignment = EIGEN_PLAIN_ENUM_MIN(LhsEtorType::Alignment,LhsVecPacketSize*int(sizeof(typename LhsNestedCleaned::Scalar))), + RhsAlignment = EIGEN_PLAIN_ENUM_MIN(RhsEtorType::Alignment,RhsVecPacketSize*int(sizeof(typename RhsNestedCleaned::Scalar))), + + SameType = is_same::value, + + CanVectorizeRhs = bool(RhsRowMajor) && (RhsFlags & PacketAccessBit) && (ColsAtCompileTime!=1), + CanVectorizeLhs = (!LhsRowMajor) && (LhsFlags & PacketAccessBit) && (RowsAtCompileTime!=1), + + EvalToRowMajor = (MaxRowsAtCompileTime==1&&MaxColsAtCompileTime!=1) ? 1 + : (MaxColsAtCompileTime==1&&MaxRowsAtCompileTime!=1) ? 0 + : (bool(RhsRowMajor) && !CanVectorizeLhs), + + Flags = ((int(LhsFlags) | int(RhsFlags)) & HereditaryBits & ~RowMajorBit) + | (EvalToRowMajor ? RowMajorBit : 0) + // TODO enable vectorization for mixed types + | (SameType && (CanVectorizeLhs || CanVectorizeRhs) ? PacketAccessBit : 0) + | (XprType::IsVectorAtCompileTime ? LinearAccessBit : 0), + + LhsOuterStrideBytes = int(LhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename LhsNestedCleaned::Scalar)), + RhsOuterStrideBytes = int(RhsNestedCleaned::OuterStrideAtCompileTime) * int(sizeof(typename RhsNestedCleaned::Scalar)), + + Alignment = bool(CanVectorizeLhs) ? (LhsOuterStrideBytes<=0 || (int(LhsOuterStrideBytes) % EIGEN_PLAIN_ENUM_MAX(1,LhsAlignment))!=0 ? 0 : LhsAlignment) + : bool(CanVectorizeRhs) ? (RhsOuterStrideBytes<=0 || (int(RhsOuterStrideBytes) % EIGEN_PLAIN_ENUM_MAX(1,RhsAlignment))!=0 ? 0 : RhsAlignment) + : 0, + + /* CanVectorizeInner deserves special explanation. It does not affect the product flags. It is not used outside + * of Product. If the Product itself is not a packet-access expression, there is still a chance that the inner + * loop of the product might be vectorized. This is the meaning of CanVectorizeInner. Since it doesn't affect + * the Flags, it is safe to make this value depend on ActualPacketAccessBit, that doesn't affect the ABI. + */ + CanVectorizeInner = SameType + && LhsRowMajor + && (!RhsRowMajor) + && (int(LhsFlags) & int(RhsFlags) & ActualPacketAccessBit) + && (int(InnerSize) % packet_traits::size == 0) + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index row, Index col) const + { + return (m_lhs.row(row).transpose().cwiseProduct( m_rhs.col(col) )).sum(); + } + + /* Allow index-based non-packet access. It is impossible though to allow index-based packed access, + * which is why we don't set the LinearAccessBit. + * TODO: this seems possible when the result is a vector + */ + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const CoeffReturnType coeff(Index index) const + { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? index : 0; + return (m_lhs.row(row).transpose().cwiseProduct( m_rhs.col(col) )).sum(); + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const PacketType packet(Index row, Index col) const + { + PacketType res; + typedef etor_product_packet_impl PacketImpl; + PacketImpl::run(row, col, m_lhsImpl, m_rhsImpl, m_innerDim, res); + return res; + } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + const PacketType packet(Index index) const + { + const Index row = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? 0 : index; + const Index col = (RowsAtCompileTime == 1 || MaxRowsAtCompileTime==1) ? index : 0; + return packet(row,col); + } + +protected: + typename internal::add_const_on_value_type::type m_lhs; + typename internal::add_const_on_value_type::type m_rhs; + + LhsEtorType m_lhsImpl; + RhsEtorType m_rhsImpl; + + // TODO: Get rid of m_innerDim if known at compile time + Index m_innerDim; +}; + +template +struct product_evaluator, LazyCoeffBasedProductMode, DenseShape, DenseShape> + : product_evaluator, CoeffBasedProductMode, DenseShape, DenseShape> +{ + typedef Product XprType; + typedef Product BaseProduct; + typedef product_evaluator Base; + enum { + Flags = Base::Flags | EvalBeforeNestingBit + }; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit product_evaluator(const XprType& xpr) + : Base(BaseProduct(xpr.lhs(),xpr.rhs())) + {} +}; + +/**************************************** +*** Coeff based product, Packet path *** +****************************************/ + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet &res) + { + etor_product_packet_impl::run(row, col, lhs, rhs, innerDim, res); + res = pmadd(pset1(lhs.coeff(row, Index(UnrollingIndex-1))), rhs.template packet(Index(UnrollingIndex-1), col), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet &res) + { + etor_product_packet_impl::run(row, col, lhs, rhs, innerDim, res); + res = pmadd(lhs.template packet(row, Index(UnrollingIndex-1)), pset1(rhs.coeff(Index(UnrollingIndex-1), col)), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index /*innerDim*/, Packet &res) + { + res = pmul(pset1(lhs.coeff(row, Index(0))),rhs.template packet(Index(0), col)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index /*innerDim*/, Packet &res) + { + res = pmul(lhs.template packet(row, Index(0)), pset1(rhs.coeff(Index(0), col))); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, const Rhs& /*rhs*/, Index /*innerDim*/, Packet &res) + { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index /*row*/, Index /*col*/, const Lhs& /*lhs*/, const Rhs& /*rhs*/, Index /*innerDim*/, Packet &res) + { + res = pset1(typename unpacket_traits::type(0)); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet& res) + { + res = pset1(typename unpacket_traits::type(0)); + for(Index i = 0; i < innerDim; ++i) + res = pmadd(pset1(lhs.coeff(row, i)), rhs.template packet(i, col), res); + } +}; + +template +struct etor_product_packet_impl +{ + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Index row, Index col, const Lhs& lhs, const Rhs& rhs, Index innerDim, Packet& res) + { + res = pset1(typename unpacket_traits::type(0)); + for(Index i = 0; i < innerDim; ++i) + res = pmadd(lhs.template packet(row, i), pset1(rhs.coeff(i, col)), res); + } +}; + + +/*************************************************************************** +* Triangular products +***************************************************************************/ +template +struct triangular_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + triangular_product_impl + ::run(dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl +: generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + triangular_product_impl::run(dst, lhs, rhs.nestedExpression(), alpha); + } +}; + + +/*************************************************************************** +* SelfAdjoint products +***************************************************************************/ +template +struct selfadjoint_product_impl; + +template +struct generic_product_impl + : generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static EIGEN_DEVICE_FUNC + void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + selfadjoint_product_impl::run(dst, lhs.nestedExpression(), rhs, alpha); + } +}; + +template +struct generic_product_impl +: generic_product_impl_base > +{ + typedef typename Product::Scalar Scalar; + + template + static void scaleAndAddTo(Dest& dst, const Lhs& lhs, const Rhs& rhs, const Scalar& alpha) + { + selfadjoint_product_impl::run(dst, lhs, rhs.nestedExpression(), alpha); + } +}; + + +/*************************************************************************** +* Diagonal products +***************************************************************************/ + +template +struct diagonal_product_evaluator_base + : evaluator_base +{ + typedef typename ScalarBinaryOpTraits::ReturnType Scalar; +public: + enum { + CoeffReadCost = int(NumTraits::MulCost) + int(evaluator::CoeffReadCost) + int(evaluator::CoeffReadCost), + + MatrixFlags = evaluator::Flags, + DiagFlags = evaluator::Flags, + + _StorageOrder = (Derived::MaxRowsAtCompileTime==1 && Derived::MaxColsAtCompileTime!=1) ? RowMajor + : (Derived::MaxColsAtCompileTime==1 && Derived::MaxRowsAtCompileTime!=1) ? ColMajor + : MatrixFlags & RowMajorBit ? RowMajor : ColMajor, + _SameStorageOrder = _StorageOrder == (MatrixFlags & RowMajorBit ? RowMajor : ColMajor), + + _ScalarAccessOnDiag = !((int(_StorageOrder) == ColMajor && int(ProductOrder) == OnTheLeft) + ||(int(_StorageOrder) == RowMajor && int(ProductOrder) == OnTheRight)), + _SameTypes = is_same::value, + // FIXME currently we need same types, but in the future the next rule should be the one + //_Vectorizable = bool(int(MatrixFlags)&PacketAccessBit) && ((!_PacketOnDiag) || (_SameTypes && bool(int(DiagFlags)&PacketAccessBit))), + _Vectorizable = bool(int(MatrixFlags)&PacketAccessBit) + && _SameTypes + && (_SameStorageOrder || (MatrixFlags&LinearAccessBit)==LinearAccessBit) + && (_ScalarAccessOnDiag || (bool(int(DiagFlags)&PacketAccessBit))), + _LinearAccessMask = (MatrixType::RowsAtCompileTime==1 || MatrixType::ColsAtCompileTime==1) ? LinearAccessBit : 0, + Flags = ((HereditaryBits|_LinearAccessMask) & (unsigned int)(MatrixFlags)) | (_Vectorizable ? PacketAccessBit : 0), + Alignment = evaluator::Alignment, + + AsScalarProduct = (DiagonalType::SizeAtCompileTime==1) + || (DiagonalType::SizeAtCompileTime==Dynamic && MatrixType::RowsAtCompileTime==1 && ProductOrder==OnTheLeft) + || (DiagonalType::SizeAtCompileTime==Dynamic && MatrixType::ColsAtCompileTime==1 && ProductOrder==OnTheRight) + }; + + EIGEN_DEVICE_FUNC diagonal_product_evaluator_base(const MatrixType &mat, const DiagonalType &diag) + : m_diagImpl(diag), m_matImpl(mat) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(NumTraits::MulCost); + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index idx) const + { + if(AsScalarProduct) + return m_diagImpl.coeff(0) * m_matImpl.coeff(idx); + else + return m_diagImpl.coeff(idx) * m_matImpl.coeff(idx); + } + +protected: + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::true_type) const + { + return internal::pmul(m_matImpl.template packet(row, col), + internal::pset1(m_diagImpl.coeff(id))); + } + + template + EIGEN_STRONG_INLINE PacketType packet_impl(Index row, Index col, Index id, internal::false_type) const + { + enum { + InnerSize = (MatrixType::Flags & RowMajorBit) ? MatrixType::ColsAtCompileTime : MatrixType::RowsAtCompileTime, + DiagonalPacketLoadMode = EIGEN_PLAIN_ENUM_MIN(LoadMode,((InnerSize%16) == 0) ? int(Aligned16) : int(evaluator::Alignment)) // FIXME hardcoded 16!! + }; + return internal::pmul(m_matImpl.template packet(row, col), + m_diagImpl.template packet(id)); + } + + evaluator m_diagImpl; + evaluator m_matImpl; +}; + +// diagonal * dense +template +struct product_evaluator, ProductTag, DiagonalShape, DenseShape> + : diagonal_product_evaluator_base, OnTheLeft> +{ + typedef diagonal_product_evaluator_base, OnTheLeft> Base; + using Base::m_diagImpl; + using Base::m_matImpl; + using Base::coeff; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + typedef typename Lhs::DiagonalVectorType DiagonalType; + + + enum { StorageOrder = Base::_StorageOrder }; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) + : Base(xpr.rhs(), xpr.lhs().diagonal()) + { + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const + { + return m_diagImpl.coeff(row) * m_matImpl.coeff(row, col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const + { + // FIXME: NVCC used to complain about the template keyword, but we have to check whether this is still the case. + // See also similar calls below. + return this->template packet_impl(row,col, row, + typename internal::conditional::type()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const + { + return packet(int(StorageOrder)==ColMajor?idx:0,int(StorageOrder)==ColMajor?0:idx); + } +#endif +}; + +// dense * diagonal +template +struct product_evaluator, ProductTag, DenseShape, DiagonalShape> + : diagonal_product_evaluator_base, OnTheRight> +{ + typedef diagonal_product_evaluator_base, OnTheRight> Base; + using Base::m_diagImpl; + using Base::m_matImpl; + using Base::coeff; + typedef typename Base::Scalar Scalar; + + typedef Product XprType; + typedef typename XprType::PlainObject PlainObject; + + enum { StorageOrder = Base::_StorageOrder }; + + EIGEN_DEVICE_FUNC explicit product_evaluator(const XprType& xpr) + : Base(xpr.lhs(), xpr.rhs().diagonal()) + { + } + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE const Scalar coeff(Index row, Index col) const + { + return m_matImpl.coeff(row, col) * m_diagImpl.coeff(col); + } + +#ifndef EIGEN_GPUCC + template + EIGEN_STRONG_INLINE PacketType packet(Index row, Index col) const + { + return this->template packet_impl(row,col, col, + typename internal::conditional::type()); + } + + template + EIGEN_STRONG_INLINE PacketType packet(Index idx) const + { + return packet(int(StorageOrder)==ColMajor?idx:0,int(StorageOrder)==ColMajor?0:idx); + } +#endif +}; + +/*************************************************************************** +* Products with permutation matrices +***************************************************************************/ + +/** \internal + * \class permutation_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + * This class is specialized for DenseShape below and for SparseShape in SparseCore/SparsePermutation.h + */ +template +struct permutation_matrix_product; + +template +struct permutation_matrix_product +{ + typedef typename nested_eval::type MatrixType; + typedef typename remove_all::type MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const PermutationType& perm, const ExpressionType& xpr) + { + MatrixType mat(xpr); + const Index n = Side==OnTheLeft ? mat.rows() : mat.cols(); + // FIXME we need an is_same for expression that is not sensitive to constness. For instance + // is_same_xpr, Block >::value should be true. + //if(is_same::value && extract_data(dst) == extract_data(mat)) + if(is_same_dense(dst, mat)) + { + // apply the permutation inplace + Matrix mask(perm.size()); + mask.fill(false); + Index r = 0; + while(r < perm.size()) + { + // search for the next seed + while(r=perm.size()) + break; + // we got one, let's follow it until we are back to the seed + Index k0 = r++; + Index kPrev = k0; + mask.coeffRef(k0) = true; + for(Index k=perm.indices().coeff(k0); k!=k0; k=perm.indices().coeff(k)) + { + Block(dst, k) + .swap(Block + (dst,((Side==OnTheLeft) ^ Transposed) ? k0 : kPrev)); + + mask.coeffRef(k) = true; + kPrev = k; + } + } + } + else + { + for(Index i = 0; i < n; ++i) + { + Block + (dst, ((Side==OnTheLeft) ^ Transposed) ? perm.indices().coeff(i) : i) + + = + + Block + (mat, ((Side==OnTheRight) ^ Transposed) ? perm.indices().coeff(i) : i); + } + } + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, rhs, lhs); + } +}; + +template +struct generic_product_impl, Rhs, PermutationShape, MatrixShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Inverse& lhs, const Rhs& rhs) + { + permutation_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, PermutationShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Inverse& rhs) + { + permutation_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + + +/*************************************************************************** +* Products with transpositions matrices +***************************************************************************/ + +// FIXME could we unify Transpositions and Permutation into a single "shape"?? + +/** \internal + * \class transposition_matrix_product + * Internal helper class implementing the product between a permutation matrix and a matrix. + */ +template +struct transposition_matrix_product +{ + typedef typename nested_eval::type MatrixType; + typedef typename remove_all::type MatrixTypeCleaned; + + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void run(Dest& dst, const TranspositionType& tr, const ExpressionType& xpr) + { + MatrixType mat(xpr); + typedef typename TranspositionType::StorageIndex StorageIndex; + const Index size = tr.size(); + StorageIndex j = 0; + + if(!is_same_dense(dst,mat)) + dst = mat; + + for(Index k=(Transposed?size-1:0) ; Transposed?k>=0:k +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, lhs, rhs); + } +}; + +template +struct generic_product_impl +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, rhs, lhs); + } +}; + + +template +struct generic_product_impl, Rhs, TranspositionsShape, MatrixShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Transpose& lhs, const Rhs& rhs) + { + transposition_matrix_product::run(dst, lhs.nestedExpression(), rhs); + } +}; + +template +struct generic_product_impl, MatrixShape, TranspositionsShape, ProductTag> +{ + template + static EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE void evalTo(Dest& dst, const Lhs& lhs, const Transpose& rhs) + { + transposition_matrix_product::run(dst, rhs.nestedExpression(), lhs); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_PRODUCT_EVALUATORS_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Random.h b/src/3rdparty/eigen/Eigen/src/Core/Random.h new file mode 100644 index 0000000..dab2ac8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Random.h @@ -0,0 +1,218 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RANDOM_H +#define EIGEN_RANDOM_H + +namespace Eigen { + +namespace internal { + +template struct scalar_random_op { + EIGEN_EMPTY_STRUCT_CTOR(scalar_random_op) + inline const Scalar operator() () const { return random(); } +}; + +template +struct functor_traits > +{ enum { Cost = 5 * NumTraits::MulCost, PacketAccess = false, IsRepeatable = false }; }; + +} // end namespace internal + +/** \returns a random matrix expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameters \a rows and \a cols are the number of rows and of columns of + * the returned matrix. Must be compatible with this MatrixBase type. + * + * \not_reentrant + * + * This variant is meant to be used for dynamic-size matrix types. For fixed-size types, + * it is redundant to pass \a rows and \a cols as arguments, so Random() should be used + * instead. + * + * + * Example: \include MatrixBase_random_int_int.cpp + * Output: \verbinclude MatrixBase_random_int_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * See DenseBase::NullaryExpr(Index, const CustomNullaryOp&) for an example using C++11 random generators. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random(Index rows, Index cols) +{ + return NullaryExpr(rows, cols, internal::scalar_random_op()); +} + +/** \returns a random vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * The parameter \a size is the size of the returned vector. + * Must be compatible with this MatrixBase type. + * + * \only_for_vectors + * \not_reentrant + * + * This variant is meant to be used for dynamic-size vector types. For fixed-size types, + * it is redundant to pass \a size as argument, so Random() should be used + * instead. + * + * Example: \include MatrixBase_random_int.cpp + * Output: \verbinclude MatrixBase_random_int.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary vector whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random() + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random(Index size) +{ + return NullaryExpr(size, internal::scalar_random_op()); +} + +/** \returns a fixed-size random matrix or vector expression + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * This variant is only for fixed-size MatrixBase types. For dynamic-size types, you + * need to use the variants taking size arguments. + * + * Example: \include MatrixBase_random.cpp + * Output: \verbinclude MatrixBase_random.out + * + * This expression has the "evaluate before nesting" flag so that it will be evaluated into + * a temporary matrix whenever it is nested in a larger expression. This prevents unexpected + * behavior with expressions involving random matrices. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), DenseBase::Random(Index,Index), DenseBase::Random(Index) + */ +template +inline const typename DenseBase::RandomReturnType +DenseBase::Random() +{ + return NullaryExpr(RowsAtCompileTime, ColsAtCompileTime, internal::scalar_random_op()); +} + +/** Sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * Example: \include MatrixBase_setRandom.cpp + * Output: \verbinclude MatrixBase_setRandom.out + * + * \sa class CwiseNullaryOp, setRandom(Index), setRandom(Index,Index) + */ +template +EIGEN_DEVICE_FUNC inline Derived& DenseBase::setRandom() +{ + return *this = Random(rows(), cols()); +} + +/** Resizes to the given \a newSize, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \only_for_vectors + * \not_reentrant + * + * Example: \include Matrix_setRandom_int.cpp + * Output: \verbinclude Matrix_setRandom_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index,Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index newSize) +{ + resize(newSize); + return setRandom(); +} + +/** Resizes to the given size, and sets all coefficients in this expression to random values. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \param rows the new number of rows + * \param cols the new number of columns + * + * Example: \include Matrix_setRandom_int_int.cpp + * Output: \verbinclude Matrix_setRandom_int_int.out + * + * \sa DenseBase::setRandom(), setRandom(Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index rows, Index cols) +{ + resize(rows, cols); + return setRandom(); +} + +/** Resizes to the given size, changing only the number of columns, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(Index, NoChange_t), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(NoChange_t, Index cols) +{ + return setRandom(rows(), cols); +} + +/** Resizes to the given size, changing only the number of rows, and sets all + * coefficients in this expression to random values. For the parameter of type + * NoChange_t, just pass the special value \c NoChange. + * + * Numbers are uniformly spread through their whole definition range for integer types, + * and in the [-1:1] range for floating point scalar types. + * + * \not_reentrant + * + * \sa DenseBase::setRandom(), setRandom(Index), setRandom(NoChange_t, Index), class CwiseNullaryOp, DenseBase::Random() + */ +template +EIGEN_STRONG_INLINE Derived& +PlainObjectBase::setRandom(Index rows, NoChange_t) +{ + return setRandom(rows, cols()); +} + +} // end namespace Eigen + +#endif // EIGEN_RANDOM_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Redux.h b/src/3rdparty/eigen/Eigen/src/Core/Redux.h new file mode 100644 index 0000000..b6790d1 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Redux.h @@ -0,0 +1,515 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008 Gael Guennebaud +// Copyright (C) 2006-2008 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REDUX_H +#define EIGEN_REDUX_H + +namespace Eigen { + +namespace internal { + +// TODO +// * implement other kind of vectorization +// * factorize code + +/*************************************************************************** +* Part 1 : the logic deciding a strategy for vectorization and unrolling +***************************************************************************/ + +template +struct redux_traits +{ +public: + typedef typename find_best_packet::type PacketType; + enum { + PacketSize = unpacket_traits::size, + InnerMaxSize = int(Evaluator::IsRowMajor) + ? Evaluator::MaxColsAtCompileTime + : Evaluator::MaxRowsAtCompileTime, + OuterMaxSize = int(Evaluator::IsRowMajor) + ? Evaluator::MaxRowsAtCompileTime + : Evaluator::MaxColsAtCompileTime, + SliceVectorizedWork = int(InnerMaxSize)==Dynamic ? Dynamic + : int(OuterMaxSize)==Dynamic ? (int(InnerMaxSize)>=int(PacketSize) ? Dynamic : 0) + : (int(InnerMaxSize)/int(PacketSize)) * int(OuterMaxSize) + }; + + enum { + MightVectorize = (int(Evaluator::Flags)&ActualPacketAccessBit) + && (functor_traits::PacketAccess), + MayLinearVectorize = bool(MightVectorize) && (int(Evaluator::Flags)&LinearAccessBit), + MaySliceVectorize = bool(MightVectorize) && (int(SliceVectorizedWork)==Dynamic || int(SliceVectorizedWork)>=3) + }; + +public: + enum { + Traversal = int(MayLinearVectorize) ? int(LinearVectorizedTraversal) + : int(MaySliceVectorize) ? int(SliceVectorizedTraversal) + : int(DefaultTraversal) + }; + +public: + enum { + Cost = Evaluator::SizeAtCompileTime == Dynamic ? HugeCost + : int(Evaluator::SizeAtCompileTime) * int(Evaluator::CoeffReadCost) + (Evaluator::SizeAtCompileTime-1) * functor_traits::Cost, + UnrollingLimit = EIGEN_UNROLLING_LIMIT * (int(Traversal) == int(DefaultTraversal) ? 1 : int(PacketSize)) + }; + +public: + enum { + Unrolling = Cost <= UnrollingLimit ? CompleteUnrolling : NoUnrolling + }; + +#ifdef EIGEN_DEBUG_ASSIGN + static void debug() + { + std::cerr << "Xpr: " << typeid(typename Evaluator::XprType).name() << std::endl; + std::cerr.setf(std::ios::hex, std::ios::basefield); + EIGEN_DEBUG_VAR(Evaluator::Flags) + std::cerr.unsetf(std::ios::hex); + EIGEN_DEBUG_VAR(InnerMaxSize) + EIGEN_DEBUG_VAR(OuterMaxSize) + EIGEN_DEBUG_VAR(SliceVectorizedWork) + EIGEN_DEBUG_VAR(PacketSize) + EIGEN_DEBUG_VAR(MightVectorize) + EIGEN_DEBUG_VAR(MayLinearVectorize) + EIGEN_DEBUG_VAR(MaySliceVectorize) + std::cerr << "Traversal" << " = " << Traversal << " (" << demangle_traversal(Traversal) << ")" << std::endl; + EIGEN_DEBUG_VAR(UnrollingLimit) + std::cerr << "Unrolling" << " = " << Unrolling << " (" << demangle_unrolling(Unrolling) << ")" << std::endl; + std::cerr << std::endl; + } +#endif +}; + +/*************************************************************************** +* Part 2 : unrollers +***************************************************************************/ + +/*** no vectorization ***/ + +template +struct redux_novec_unroller +{ + enum { + HalfLength = Length/2 + }; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator &eval, const Func& func) + { + return func(redux_novec_unroller::run(eval,func), + redux_novec_unroller::run(eval,func)); + } +}; + +template +struct redux_novec_unroller +{ + enum { + outer = Start / Evaluator::InnerSizeAtCompileTime, + inner = Start % Evaluator::InnerSizeAtCompileTime + }; + + typedef typename Evaluator::Scalar Scalar; + + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator &eval, const Func&) + { + return eval.coeffByOuterInner(outer, inner); + } +}; + +// This is actually dead code and will never be called. It is required +// to prevent false warnings regarding failed inlining though +// for 0 length run() will never be called at all. +template +struct redux_novec_unroller +{ + typedef typename Evaluator::Scalar Scalar; + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE Scalar run(const Evaluator&, const Func&) { return Scalar(); } +}; + +/*** vectorization ***/ + +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &eval, const Func& func) + { + enum { + PacketSize = unpacket_traits::size, + HalfLength = Length/2 + }; + + return func.packetOp( + redux_vec_unroller::template run(eval,func), + redux_vec_unroller::template run(eval,func) ); + } +}; + +template +struct redux_vec_unroller +{ + template + EIGEN_DEVICE_FUNC + static EIGEN_STRONG_INLINE PacketType run(const Evaluator &eval, const Func&) + { + enum { + PacketSize = unpacket_traits::size, + index = Start * PacketSize, + outer = index / int(Evaluator::InnerSizeAtCompileTime), + inner = index % int(Evaluator::InnerSizeAtCompileTime), + alignment = Evaluator::Alignment + }; + return eval.template packetByOuterInner(outer, inner); + } +}; + +/*************************************************************************** +* Part 3 : implementation of all cases +***************************************************************************/ + +template::Traversal, + int Unrolling = redux_traits::Unrolling +> +struct redux_impl; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + Scalar res; + res = eval.coeffByOuterInner(0, 0); + for(Index i = 1; i < xpr.innerSize(); ++i) + res = func(res, eval.coeffByOuterInner(0, i)); + for(Index i = 1; i < xpr.outerSize(); ++i) + for(Index j = 0; j < xpr.innerSize(); ++j) + res = func(res, eval.coeffByOuterInner(i, j)); + return res; + } +}; + +template +struct redux_impl + : redux_novec_unroller +{ + typedef redux_novec_unroller Base; + typedef typename Evaluator::Scalar Scalar; + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType& /*xpr*/) + { + return Base::run(eval,func); + } +}; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketScalar; + + template + static Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + const Index size = xpr.size(); + + const Index packetSize = redux_traits::PacketSize; + const int packetAlignment = unpacket_traits::alignment; + enum { + alignment0 = (bool(Evaluator::Flags & DirectAccessBit) && bool(packet_traits::AlignedOnScalar)) ? int(packetAlignment) : int(Unaligned), + alignment = EIGEN_PLAIN_ENUM_MAX(alignment0, Evaluator::Alignment) + }; + const Index alignedStart = internal::first_default_aligned(xpr); + const Index alignedSize2 = ((size-alignedStart)/(2*packetSize))*(2*packetSize); + const Index alignedSize = ((size-alignedStart)/(packetSize))*(packetSize); + const Index alignedEnd2 = alignedStart + alignedSize2; + const Index alignedEnd = alignedStart + alignedSize; + Scalar res; + if(alignedSize) + { + PacketScalar packet_res0 = eval.template packet(alignedStart); + if(alignedSize>packetSize) // we have at least two packets to partly unroll the loop + { + PacketScalar packet_res1 = eval.template packet(alignedStart+packetSize); + for(Index index = alignedStart + 2*packetSize; index < alignedEnd2; index += 2*packetSize) + { + packet_res0 = func.packetOp(packet_res0, eval.template packet(index)); + packet_res1 = func.packetOp(packet_res1, eval.template packet(index+packetSize)); + } + + packet_res0 = func.packetOp(packet_res0,packet_res1); + if(alignedEnd>alignedEnd2) + packet_res0 = func.packetOp(packet_res0, eval.template packet(alignedEnd2)); + } + res = func.predux(packet_res0); + + for(Index index = 0; index < alignedStart; ++index) + res = func(res,eval.coeff(index)); + + for(Index index = alignedEnd; index < size; ++index) + res = func(res,eval.coeff(index)); + } + else // too small to vectorize anything. + // since this is dynamic-size hence inefficient anyway for such small sizes, don't try to optimize. + { + res = eval.coeff(0); + for(Index index = 1; index < size; ++index) + res = func(res,eval.coeff(index)); + } + + return res; + } +}; + +// NOTE: for SliceVectorizedTraversal we simply bypass unrolling +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + typedef typename redux_traits::PacketType PacketType; + + template + EIGEN_DEVICE_FUNC static Scalar run(const Evaluator &eval, const Func& func, const XprType& xpr) + { + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + const Index innerSize = xpr.innerSize(); + const Index outerSize = xpr.outerSize(); + enum { + packetSize = redux_traits::PacketSize + }; + const Index packetedInnerSize = ((innerSize)/packetSize)*packetSize; + Scalar res; + if(packetedInnerSize) + { + PacketType packet_res = eval.template packet(0,0); + for(Index j=0; j(j,i)); + + res = func.predux(packet_res); + for(Index j=0; j::run(eval, func, xpr); + } + + return res; + } +}; + +template +struct redux_impl +{ + typedef typename Evaluator::Scalar Scalar; + + typedef typename redux_traits::PacketType PacketType; + enum { + PacketSize = redux_traits::PacketSize, + Size = Evaluator::SizeAtCompileTime, + VectorizedSize = (int(Size) / int(PacketSize)) * int(PacketSize) + }; + + template + EIGEN_DEVICE_FUNC static EIGEN_STRONG_INLINE + Scalar run(const Evaluator &eval, const Func& func, const XprType &xpr) + { + EIGEN_ONLY_USED_FOR_DEBUG(xpr) + eigen_assert(xpr.rows()>0 && xpr.cols()>0 && "you are using an empty matrix"); + if (VectorizedSize > 0) { + Scalar res = func.predux(redux_vec_unroller::template run(eval,func)); + if (VectorizedSize != Size) + res = func(res,redux_novec_unroller::run(eval,func)); + return res; + } + else { + return redux_novec_unroller::run(eval,func); + } + } +}; + +// evaluator adaptor +template +class redux_evaluator : public internal::evaluator<_XprType> +{ + typedef internal::evaluator<_XprType> Base; +public: + typedef _XprType XprType; + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + explicit redux_evaluator(const XprType &xpr) : Base(xpr) {} + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + typedef typename XprType::PacketScalar PacketScalar; + + enum { + MaxRowsAtCompileTime = XprType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = XprType::MaxColsAtCompileTime, + // TODO we should not remove DirectAccessBit and rather find an elegant way to query the alignment offset at runtime from the evaluator + Flags = Base::Flags & ~DirectAccessBit, + IsRowMajor = XprType::IsRowMajor, + SizeAtCompileTime = XprType::SizeAtCompileTime, + InnerSizeAtCompileTime = XprType::InnerSizeAtCompileTime + }; + + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + CoeffReturnType coeffByOuterInner(Index outer, Index inner) const + { return Base::coeff(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); } + + template + EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE + PacketType packetByOuterInner(Index outer, Index inner) const + { return Base::template packet(IsRowMajor ? outer : inner, IsRowMajor ? inner : outer); } + +}; + +} // end namespace internal + +/*************************************************************************** +* Part 4 : public API +***************************************************************************/ + + +/** \returns the result of a full redux operation on the whole matrix or vector using \a func + * + * The template parameter \a BinaryOp is the type of the functor \a func which must be + * an associative operator. Both current C++98 and C++11 functor styles are handled. + * + * \warning the matrix must be not empty, otherwise an assertion is triggered. + * + * \sa DenseBase::sum(), DenseBase::minCoeff(), DenseBase::maxCoeff(), MatrixBase::colwise(), MatrixBase::rowwise() + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::redux(const Func& func) const +{ + eigen_assert(this->rows()>0 && this->cols()>0 && "you are using an empty matrix"); + + typedef typename internal::redux_evaluator ThisEvaluator; + ThisEvaluator thisEval(derived()); + + // The initial expression is passed to the reducer as an additional argument instead of + // passing it as a member of redux_evaluator to help + return internal::redux_impl::run(thisEval, func, derived()); +} + +/** \returns the minimum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is minimum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::minCoeff() const +{ + return derived().redux(Eigen::internal::scalar_min_op()); +} + +/** \returns the maximum of all coefficients of \c *this. + * In case \c *this contains NaN, NaNPropagation determines the behavior: + * NaNPropagation == PropagateFast : undefined + * NaNPropagation == PropagateNaN : result is NaN + * NaNPropagation == PropagateNumbers : result is maximum of elements that are not NaN + * \warning the matrix must be not empty, otherwise an assertion is triggered. + */ +template +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::maxCoeff() const +{ + return derived().redux(Eigen::internal::scalar_max_op()); +} + +/** \returns the sum of all coefficients of \c *this + * + * If \c *this is empty, then the value 0 is returned. + * + * \sa trace(), prod(), mean() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::sum() const +{ + if(SizeAtCompileTime==0 || (SizeAtCompileTime==Dynamic && size()==0)) + return Scalar(0); + return derived().redux(Eigen::internal::scalar_sum_op()); +} + +/** \returns the mean of all coefficients of *this +* +* \sa trace(), prod(), sum() +*/ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::mean() const +{ +#ifdef __INTEL_COMPILER + #pragma warning push + #pragma warning ( disable : 2259 ) +#endif + return Scalar(derived().redux(Eigen::internal::scalar_sum_op())) / Scalar(this->size()); +#ifdef __INTEL_COMPILER + #pragma warning pop +#endif +} + +/** \returns the product of all coefficients of *this + * + * Example: \include MatrixBase_prod.cpp + * Output: \verbinclude MatrixBase_prod.out + * + * \sa sum(), mean(), trace() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +DenseBase::prod() const +{ + if(SizeAtCompileTime==0 || (SizeAtCompileTime==Dynamic && size()==0)) + return Scalar(1); + return derived().redux(Eigen::internal::scalar_product_op()); +} + +/** \returns the trace of \c *this, i.e. the sum of the coefficients on the main diagonal. + * + * \c *this can be any matrix, not necessarily square. + * + * \sa diagonal(), sum() + */ +template +EIGEN_DEVICE_FUNC EIGEN_STRONG_INLINE typename internal::traits::Scalar +MatrixBase::trace() const +{ + return derived().diagonal().sum(); +} + +} // end namespace Eigen + +#endif // EIGEN_REDUX_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Ref.h b/src/3rdparty/eigen/Eigen/src/Core/Ref.h new file mode 100644 index 0000000..c2a37ea --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Ref.h @@ -0,0 +1,381 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2012 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REF_H +#define EIGEN_REF_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : public traits > +{ + typedef _PlainObjectType PlainObjectType; + typedef _StrideType StrideType; + enum { + Options = _Options, + Flags = traits >::Flags | NestByRefBit, + Alignment = traits >::Alignment + }; + + template struct match { + enum { + IsVectorAtCompileTime = PlainObjectType::IsVectorAtCompileTime || Derived::IsVectorAtCompileTime, + HasDirectAccess = internal::has_direct_access::ret, + StorageOrderMatch = IsVectorAtCompileTime || ((PlainObjectType::Flags&RowMajorBit)==(Derived::Flags&RowMajorBit)), + InnerStrideMatch = int(StrideType::InnerStrideAtCompileTime)==int(Dynamic) + || int(StrideType::InnerStrideAtCompileTime)==int(Derived::InnerStrideAtCompileTime) + || (int(StrideType::InnerStrideAtCompileTime)==0 && int(Derived::InnerStrideAtCompileTime)==1), + OuterStrideMatch = IsVectorAtCompileTime + || int(StrideType::OuterStrideAtCompileTime)==int(Dynamic) || int(StrideType::OuterStrideAtCompileTime)==int(Derived::OuterStrideAtCompileTime), + // NOTE, this indirection of evaluator::Alignment is needed + // to workaround a very strange bug in MSVC related to the instantiation + // of has_*ary_operator in evaluator. + // This line is surprisingly very sensitive. For instance, simply adding parenthesis + // as "DerivedAlignment = (int(evaluator::Alignment))," will make MSVC fail... + DerivedAlignment = int(evaluator::Alignment), + AlignmentMatch = (int(traits::Alignment)==int(Unaligned)) || (DerivedAlignment >= int(Alignment)), // FIXME the first condition is not very clear, it should be replaced by the required alignment + ScalarTypeMatch = internal::is_same::value, + MatchAtCompileTime = HasDirectAccess && StorageOrderMatch && InnerStrideMatch && OuterStrideMatch && AlignmentMatch && ScalarTypeMatch + }; + typedef typename internal::conditional::type type; + }; + +}; + +template +struct traits > : public traits {}; + +} + +template class RefBase + : public MapBase +{ + typedef typename internal::traits::PlainObjectType PlainObjectType; + typedef typename internal::traits::StrideType StrideType; + +public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(RefBase) + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index innerStride() const + { + return StrideType::InnerStrideAtCompileTime != 0 ? m_stride.inner() : 1; + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR inline Index outerStride() const + { + return StrideType::OuterStrideAtCompileTime != 0 ? m_stride.outer() + : IsVectorAtCompileTime ? this->size() + : int(Flags)&RowMajorBit ? this->cols() + : this->rows(); + } + + EIGEN_DEVICE_FUNC RefBase() + : Base(0,RowsAtCompileTime==Dynamic?0:RowsAtCompileTime,ColsAtCompileTime==Dynamic?0:ColsAtCompileTime), + // Stride<> does not allow default ctor for Dynamic strides, so let' initialize it with dummy values: + m_stride(StrideType::OuterStrideAtCompileTime==Dynamic?0:StrideType::OuterStrideAtCompileTime, + StrideType::InnerStrideAtCompileTime==Dynamic?0:StrideType::InnerStrideAtCompileTime) + {} + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(RefBase) + +protected: + + typedef Stride StrideBase; + + // Resolves inner stride if default 0. + static EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index resolveInnerStride(Index inner) { + return inner == 0 ? 1 : inner; + } + + // Resolves outer stride if default 0. + static EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR Index resolveOuterStride(Index inner, Index outer, Index rows, Index cols, bool isVectorAtCompileTime, bool isRowMajor) { + return outer == 0 ? isVectorAtCompileTime ? inner * rows * cols : isRowMajor ? inner * cols : inner * rows : outer; + } + + // Returns true if construction is valid, false if there is a stride mismatch, + // and fails if there is a size mismatch. + template + EIGEN_DEVICE_FUNC bool construct(Expression& expr) + { + // Check matrix sizes. If this is a compile-time vector, we do allow + // implicitly transposing. + EIGEN_STATIC_ASSERT( + EIGEN_PREDICATE_SAME_MATRIX_SIZE(PlainObjectType, Expression) + // If it is a vector, the transpose sizes might match. + || ( PlainObjectType::IsVectorAtCompileTime + && ((int(PlainObjectType::RowsAtCompileTime)==Eigen::Dynamic + || int(Expression::ColsAtCompileTime)==Eigen::Dynamic + || int(PlainObjectType::RowsAtCompileTime)==int(Expression::ColsAtCompileTime)) + && (int(PlainObjectType::ColsAtCompileTime)==Eigen::Dynamic + || int(Expression::RowsAtCompileTime)==Eigen::Dynamic + || int(PlainObjectType::ColsAtCompileTime)==int(Expression::RowsAtCompileTime)))), + YOU_MIXED_MATRICES_OF_DIFFERENT_SIZES + ) + + // Determine runtime rows and columns. + Index rows = expr.rows(); + Index cols = expr.cols(); + if(PlainObjectType::RowsAtCompileTime==1) + { + eigen_assert(expr.rows()==1 || expr.cols()==1); + rows = 1; + cols = expr.size(); + } + else if(PlainObjectType::ColsAtCompileTime==1) + { + eigen_assert(expr.rows()==1 || expr.cols()==1); + rows = expr.size(); + cols = 1; + } + // Verify that the sizes are valid. + eigen_assert( + (PlainObjectType::RowsAtCompileTime == Dynamic) || (PlainObjectType::RowsAtCompileTime == rows)); + eigen_assert( + (PlainObjectType::ColsAtCompileTime == Dynamic) || (PlainObjectType::ColsAtCompileTime == cols)); + + + // If this is a vector, we might be transposing, which means that stride should swap. + const bool transpose = PlainObjectType::IsVectorAtCompileTime && (rows != expr.rows()); + // If the storage format differs, we also need to swap the stride. + const bool row_major = ((PlainObjectType::Flags)&RowMajorBit) != 0; + const bool expr_row_major = (Expression::Flags&RowMajorBit) != 0; + const bool storage_differs = (row_major != expr_row_major); + + const bool swap_stride = (transpose != storage_differs); + + // Determine expr's actual strides, resolving any defaults if zero. + const Index expr_inner_actual = resolveInnerStride(expr.innerStride()); + const Index expr_outer_actual = resolveOuterStride(expr_inner_actual, + expr.outerStride(), + expr.rows(), + expr.cols(), + Expression::IsVectorAtCompileTime != 0, + expr_row_major); + + // If this is a column-major row vector or row-major column vector, the inner-stride + // is arbitrary, so set it to either the compile-time inner stride or 1. + const bool row_vector = (rows == 1); + const bool col_vector = (cols == 1); + const Index inner_stride = + ( (!row_major && row_vector) || (row_major && col_vector) ) ? + ( StrideType::InnerStrideAtCompileTime > 0 ? Index(StrideType::InnerStrideAtCompileTime) : 1) + : swap_stride ? expr_outer_actual : expr_inner_actual; + + // If this is a column-major column vector or row-major row vector, the outer-stride + // is arbitrary, so set it to either the compile-time outer stride or vector size. + const Index outer_stride = + ( (!row_major && col_vector) || (row_major && row_vector) ) ? + ( StrideType::OuterStrideAtCompileTime > 0 ? Index(StrideType::OuterStrideAtCompileTime) : rows * cols * inner_stride) + : swap_stride ? expr_inner_actual : expr_outer_actual; + + // Check if given inner/outer strides are compatible with compile-time strides. + const bool inner_valid = (StrideType::InnerStrideAtCompileTime == Dynamic) + || (resolveInnerStride(Index(StrideType::InnerStrideAtCompileTime)) == inner_stride); + if (!inner_valid) { + return false; + } + + const bool outer_valid = (StrideType::OuterStrideAtCompileTime == Dynamic) + || (resolveOuterStride( + inner_stride, + Index(StrideType::OuterStrideAtCompileTime), + rows, cols, PlainObjectType::IsVectorAtCompileTime != 0, + row_major) + == outer_stride); + if (!outer_valid) { + return false; + } + + ::new (static_cast(this)) Base(expr.data(), rows, cols); + ::new (&m_stride) StrideBase( + (StrideType::OuterStrideAtCompileTime == 0) ? 0 : outer_stride, + (StrideType::InnerStrideAtCompileTime == 0) ? 0 : inner_stride ); + return true; + } + + StrideBase m_stride; +}; + +/** \class Ref + * \ingroup Core_Module + * + * \brief A matrix or vector expression mapping an existing expression + * + * \tparam PlainObjectType the equivalent matrix type of the mapped data + * \tparam Options specifies the pointer alignment in bytes. It can be: \c #Aligned128, , \c #Aligned64, \c #Aligned32, \c #Aligned16, \c #Aligned8 or \c #Unaligned. + * The default is \c #Unaligned. + * \tparam StrideType optionally specifies strides. By default, Ref implies a contiguous storage along the inner dimension (inner stride==1), + * but accepts a variable outer stride (leading dimension). + * This can be overridden by specifying strides. + * The type passed here must be a specialization of the Stride template, see examples below. + * + * This class provides a way to write non-template functions taking Eigen objects as parameters while limiting the number of copies. + * A Ref<> object can represent either a const expression or a l-value: + * \code + * // in-out argument: + * void foo1(Ref x); + * + * // read-only const argument: + * void foo2(const Ref& x); + * \endcode + * + * In the in-out case, the input argument must satisfy the constraints of the actual Ref<> type, otherwise a compilation issue will be triggered. + * By default, a Ref can reference any dense vector expression of float having a contiguous memory layout. + * Likewise, a Ref can reference any column-major dense matrix expression of float whose column's elements are contiguously stored with + * the possibility to have a constant space in-between each column, i.e. the inner stride must be equal to 1, but the outer stride (or leading dimension) + * can be greater than the number of rows. + * + * In the const case, if the input expression does not match the above requirement, then it is evaluated into a temporary before being passed to the function. + * Here are some examples: + * \code + * MatrixXf A; + * VectorXf a; + * foo1(a.head()); // OK + * foo1(A.col()); // OK + * foo1(A.row()); // Compilation error because here innerstride!=1 + * foo2(A.row()); // Compilation error because A.row() is a 1xN object while foo2 is expecting a Nx1 object + * foo2(A.row().transpose()); // The row is copied into a contiguous temporary + * foo2(2*a); // The expression is evaluated into a temporary + * foo2(A.col().segment(2,4)); // No temporary + * \endcode + * + * The range of inputs that can be referenced without temporary can be enlarged using the last two template parameters. + * Here is an example accepting an innerstride!=1: + * \code + * // in-out argument: + * void foo3(Ref > x); + * foo3(A.row()); // OK + * \endcode + * The downside here is that the function foo3 might be significantly slower than foo1 because it won't be able to exploit vectorization, and will involve more + * expensive address computations even if the input is contiguously stored in memory. To overcome this issue, one might propose to overload internally calling a + * template function, e.g.: + * \code + * // in the .h: + * void foo(const Ref& A); + * void foo(const Ref >& A); + * + * // in the .cpp: + * template void foo_impl(const TypeOfA& A) { + * ... // crazy code goes here + * } + * void foo(const Ref& A) { foo_impl(A); } + * void foo(const Ref >& A) { foo_impl(A); } + * \endcode + * + * See also the following stackoverflow questions for further references: + * - Correct usage of the Eigen::Ref<> class + * + * \sa PlainObjectBase::Map(), \ref TopicStorageOrders + */ +template class Ref + : public RefBase > +{ + private: + typedef internal::traits Traits; + template + EIGEN_DEVICE_FUNC inline Ref(const PlainObjectBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0); + public: + + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + + + #ifndef EIGEN_PARSED_BY_DOXYGEN + template + EIGEN_DEVICE_FUNC inline Ref(PlainObjectBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0) + { + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + // Construction must pass since we will not create temprary storage in the non-const case. + const bool success = Base::construct(expr.derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + template + EIGEN_DEVICE_FUNC inline Ref(const DenseBase& expr, + typename internal::enable_if::MatchAtCompileTime),Derived>::type* = 0) + #else + /** Implicit constructor from any dense expression */ + template + inline Ref(DenseBase& expr) + #endif + { + EIGEN_STATIC_ASSERT(bool(internal::is_lvalue::value), THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + EIGEN_STATIC_ASSERT(bool(Traits::template match::MatchAtCompileTime), STORAGE_LAYOUT_DOES_NOT_MATCH); + EIGEN_STATIC_ASSERT(!Derived::IsPlainObjectBase,THIS_EXPRESSION_IS_NOT_A_LVALUE__IT_IS_READ_ONLY); + // Construction must pass since we will not create temporary storage in the non-const case. + const bool success = Base::construct(expr.const_cast_derived()); + EIGEN_UNUSED_VARIABLE(success) + eigen_assert(success); + } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Ref) + +}; + +// this is the const ref version +template class Ref + : public RefBase > +{ + typedef internal::traits Traits; + public: + + typedef RefBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Ref) + + template + EIGEN_DEVICE_FUNC inline Ref(const DenseBase& expr, + typename internal::enable_if::ScalarTypeMatch),Derived>::type* = 0) + { +// std::cout << match_helper::HasDirectAccess << "," << match_helper::OuterStrideMatch << "," << match_helper::InnerStrideMatch << "\n"; +// std::cout << int(StrideType::OuterStrideAtCompileTime) << " - " << int(Derived::OuterStrideAtCompileTime) << "\n"; +// std::cout << int(StrideType::InnerStrideAtCompileTime) << " - " << int(Derived::InnerStrideAtCompileTime) << "\n"; + construct(expr.derived(), typename Traits::template match::type()); + } + + EIGEN_DEVICE_FUNC inline Ref(const Ref& other) : Base(other) { + // copy constructor shall not copy the m_object, to avoid unnecessary malloc and copy + } + + template + EIGEN_DEVICE_FUNC inline Ref(const RefBase& other) { + construct(other.derived(), typename Traits::template match::type()); + } + + protected: + + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr,internal::true_type) + { + // Check if we can use the underlying expr's storage directly, otherwise call the copy version. + if (!Base::construct(expr)) { + construct(expr, internal::false_type()); + } + } + + template + EIGEN_DEVICE_FUNC void construct(const Expression& expr, internal::false_type) + { + internal::call_assignment_no_alias(m_object,expr,internal::assign_op()); + Base::construct(m_object); + } + + protected: + TPlainObjectType m_object; +}; + +} // end namespace Eigen + +#endif // EIGEN_REF_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Replicate.h b/src/3rdparty/eigen/Eigen/src/Core/Replicate.h new file mode 100644 index 0000000..ab5be7e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Replicate.h @@ -0,0 +1,142 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REPLICATE_H +#define EIGEN_REPLICATE_H + +namespace Eigen { + +namespace internal { +template +struct traits > + : traits +{ + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + enum { + RowsAtCompileTime = RowFactor==Dynamic || int(MatrixType::RowsAtCompileTime)==Dynamic + ? Dynamic + : RowFactor * MatrixType::RowsAtCompileTime, + ColsAtCompileTime = ColFactor==Dynamic || int(MatrixType::ColsAtCompileTime)==Dynamic + ? Dynamic + : ColFactor * MatrixType::ColsAtCompileTime, + //FIXME we don't propagate the max sizes !!! + MaxRowsAtCompileTime = RowsAtCompileTime, + MaxColsAtCompileTime = ColsAtCompileTime, + IsRowMajor = MaxRowsAtCompileTime==1 && MaxColsAtCompileTime!=1 ? 1 + : MaxColsAtCompileTime==1 && MaxRowsAtCompileTime!=1 ? 0 + : (MatrixType::Flags & RowMajorBit) ? 1 : 0, + + // FIXME enable DirectAccess with negative strides? + Flags = IsRowMajor ? RowMajorBit : 0 + }; +}; +} + +/** + * \class Replicate + * \ingroup Core_Module + * + * \brief Expression of the multiple replication of a matrix or vector + * + * \tparam MatrixType the type of the object we are replicating + * \tparam RowFactor number of repetitions at compile time along the vertical direction, can be Dynamic. + * \tparam ColFactor number of repetitions at compile time along the horizontal direction, can be Dynamic. + * + * This class represents an expression of the multiple replication of a matrix or vector. + * It is the return type of DenseBase::replicate() and most of the time + * this is the only way it is used. + * + * \sa DenseBase::replicate() + */ +template class Replicate + : public internal::dense_xpr_base< Replicate >::type +{ + typedef typename internal::traits::MatrixTypeNested MatrixTypeNested; + typedef typename internal::traits::_MatrixTypeNested _MatrixTypeNested; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Replicate) + typedef typename internal::remove_all::type NestedExpression; + + template + EIGEN_DEVICE_FUNC + inline explicit Replicate(const OriginalMatrixType& matrix) + : m_matrix(matrix), m_rowFactor(RowFactor), m_colFactor(ColFactor) + { + EIGEN_STATIC_ASSERT((internal::is_same::type,OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + eigen_assert(RowFactor!=Dynamic && ColFactor!=Dynamic); + } + + template + EIGEN_DEVICE_FUNC + inline Replicate(const OriginalMatrixType& matrix, Index rowFactor, Index colFactor) + : m_matrix(matrix), m_rowFactor(rowFactor), m_colFactor(colFactor) + { + EIGEN_STATIC_ASSERT((internal::is_same::type,OriginalMatrixType>::value), + THE_MATRIX_OR_EXPRESSION_THAT_YOU_PASSED_DOES_NOT_HAVE_THE_EXPECTED_TYPE) + } + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const { return m_matrix.rows() * m_rowFactor.value(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const { return m_matrix.cols() * m_colFactor.value(); } + + EIGEN_DEVICE_FUNC + const _MatrixTypeNested& nestedExpression() const + { + return m_matrix; + } + + protected: + MatrixTypeNested m_matrix; + const internal::variable_if_dynamic m_rowFactor; + const internal::variable_if_dynamic m_colFactor; +}; + +/** + * \return an expression of the replication of \c *this + * + * Example: \include MatrixBase_replicate.cpp + * Output: \verbinclude MatrixBase_replicate.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(Index,Index), class Replicate + */ +template +template +EIGEN_DEVICE_FUNC const Replicate +DenseBase::replicate() const +{ + return Replicate(derived()); +} + +/** + * \return an expression of the replication of each column (or row) of \c *this + * + * Example: \include DirectionWise_replicate_int.cpp + * Output: \verbinclude DirectionWise_replicate_int.out + * + * \sa VectorwiseOp::replicate(), DenseBase::replicate(), class Replicate + */ +template +EIGEN_DEVICE_FUNC const typename VectorwiseOp::ReplicateReturnType +VectorwiseOp::replicate(Index factor) const +{ + return typename VectorwiseOp::ReplicateReturnType + (_expression(),Direction==Vertical?factor:1,Direction==Horizontal?factor:1); +} + +} // end namespace Eigen + +#endif // EIGEN_REPLICATE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h b/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h new file mode 100644 index 0000000..52de73b --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Reshaped.h @@ -0,0 +1,454 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2017 Gael Guennebaud +// Copyright (C) 2014 yoco +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RESHAPED_H +#define EIGEN_RESHAPED_H + +namespace Eigen { + +/** \class Reshaped + * \ingroup Core_Module + * + * \brief Expression of a fixed-size or dynamic-size reshape + * + * \tparam XprType the type of the expression in which we are taking a reshape + * \tparam Rows the number of rows of the reshape we are taking at compile time (optional) + * \tparam Cols the number of columns of the reshape we are taking at compile time (optional) + * \tparam Order can be ColMajor or RowMajor, default is ColMajor. + * + * This class represents an expression of either a fixed-size or dynamic-size reshape. + * It is the return type of DenseBase::reshaped(NRowsType,NColsType) and + * most of the time this is the only way it is used. + * + * However, in C++98, if you want to directly maniputate reshaped expressions, + * for instance if you want to write a function returning such an expression, you + * will need to use this class. In C++11, it is advised to use the \em auto + * keyword for such use cases. + * + * Here is an example illustrating the dynamic case: + * \include class_Reshaped.cpp + * Output: \verbinclude class_Reshaped.out + * + * Here is an example illustrating the fixed-size case: + * \include class_FixedReshaped.cpp + * Output: \verbinclude class_FixedReshaped.out + * + * \sa DenseBase::reshaped(NRowsType,NColsType) + */ + +namespace internal { + +template +struct traits > : traits +{ + typedef typename traits::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + enum{ + MatrixRows = traits::RowsAtCompileTime, + MatrixCols = traits::ColsAtCompileTime, + RowsAtCompileTime = Rows, + ColsAtCompileTime = Cols, + MaxRowsAtCompileTime = Rows, + MaxColsAtCompileTime = Cols, + XpxStorageOrder = ((int(traits::Flags) & RowMajorBit) == RowMajorBit) ? RowMajor : ColMajor, + ReshapedStorageOrder = (RowsAtCompileTime == 1 && ColsAtCompileTime != 1) ? RowMajor + : (ColsAtCompileTime == 1 && RowsAtCompileTime != 1) ? ColMajor + : XpxStorageOrder, + HasSameStorageOrderAsXprType = (ReshapedStorageOrder == XpxStorageOrder), + InnerSize = (ReshapedStorageOrder==int(RowMajor)) ? int(ColsAtCompileTime) : int(RowsAtCompileTime), + InnerStrideAtCompileTime = HasSameStorageOrderAsXprType + ? int(inner_stride_at_compile_time::ret) + : Dynamic, + OuterStrideAtCompileTime = Dynamic, + + HasDirectAccess = internal::has_direct_access::ret + && (Order==int(XpxStorageOrder)) + && ((evaluator::Flags&LinearAccessBit)==LinearAccessBit), + + MaskPacketAccessBit = (InnerSize == Dynamic || (InnerSize % packet_traits::size) == 0) + && (InnerStrideAtCompileTime == 1) + ? PacketAccessBit : 0, + //MaskAlignedBit = ((OuterStrideAtCompileTime!=Dynamic) && (((OuterStrideAtCompileTime * int(sizeof(Scalar))) % 16) == 0)) ? AlignedBit : 0, + FlagsLinearAccessBit = (RowsAtCompileTime == 1 || ColsAtCompileTime == 1) ? LinearAccessBit : 0, + FlagsLvalueBit = is_lvalue::value ? LvalueBit : 0, + FlagsRowMajorBit = (ReshapedStorageOrder==int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = traits::Flags & ( (HereditaryBits & ~RowMajorBit) | MaskPacketAccessBit), + + Flags = (Flags0 | FlagsLinearAccessBit | FlagsLvalueBit | FlagsRowMajorBit | FlagsDirectAccessBit) + }; +}; + +template class ReshapedImpl_dense; + +} // end namespace internal + +template class ReshapedImpl; + +template class Reshaped + : public ReshapedImpl::StorageKind> +{ + typedef ReshapedImpl::StorageKind> Impl; + public: + //typedef typename Impl::Base Base; + typedef Impl Base; + EIGEN_GENERIC_PUBLIC_INTERFACE(Reshaped) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reshaped) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline Reshaped(XprType& xpr) + : Impl(xpr) + { + EIGEN_STATIC_ASSERT(RowsAtCompileTime!=Dynamic && ColsAtCompileTime!=Dynamic,THIS_METHOD_IS_ONLY_FOR_FIXED_SIZE) + eigen_assert(Rows * Cols == xpr.rows() * xpr.cols()); + } + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline Reshaped(XprType& xpr, + Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) + { + eigen_assert((RowsAtCompileTime==Dynamic || RowsAtCompileTime==reshapeRows) + && (ColsAtCompileTime==Dynamic || ColsAtCompileTime==reshapeCols)); + eigen_assert(reshapeRows * reshapeCols == xpr.rows() * xpr.cols()); + } +}; + +// The generic default implementation for dense reshape simply forward to the internal::ReshapedImpl_dense +// that must be specialized for direct and non-direct access... +template +class ReshapedImpl + : public internal::ReshapedImpl_dense >::HasDirectAccess> +{ + typedef internal::ReshapedImpl_dense >::HasDirectAccess> Impl; + public: + typedef Impl Base; + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl) + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr) : Impl(xpr) {} + EIGEN_DEVICE_FUNC inline ReshapedImpl(XprType& xpr, Index reshapeRows, Index reshapeCols) + : Impl(xpr, reshapeRows, reshapeCols) {} +}; + +namespace internal { + +/** \internal Internal implementation of dense Reshaped in the general case. */ +template +class ReshapedImpl_dense + : public internal::dense_xpr_base >::type +{ + typedef Reshaped ReshapedType; + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + typedef typename internal::ref_selector::non_const_type MatrixTypeNested; + typedef typename internal::remove_all::type NestedExpression; + + class InnerIterator; + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr) + : m_xpr(xpr), m_rows(Rows), m_cols(Cols) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : m_xpr(xpr), m_rows(nRows), m_cols(nCols) + {} + + EIGEN_DEVICE_FUNC Index rows() const { return m_rows; } + EIGEN_DEVICE_FUNC Index cols() const { return m_cols; } + + #ifdef EIGEN_PARSED_BY_DOXYGEN + /** \sa MapBase::data() */ + EIGEN_DEVICE_FUNC inline const Scalar* data() const; + EIGEN_DEVICE_FUNC inline Index innerStride() const; + EIGEN_DEVICE_FUNC inline Index outerStride() const; + #endif + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& + nestedExpression() const { return m_xpr; } + + /** \returns the nested expression */ + EIGEN_DEVICE_FUNC + typename internal::remove_reference::type& + nestedExpression() { return m_xpr; } + + protected: + + MatrixTypeNested m_xpr; + const internal::variable_if_dynamic m_rows; + const internal::variable_if_dynamic m_cols; +}; + + +/** \internal Internal implementation of dense Reshaped in the direct access case. */ +template +class ReshapedImpl_dense + : public MapBase > +{ + typedef Reshaped ReshapedType; + typedef typename internal::ref_selector::non_const_type XprTypeNested; + public: + + typedef MapBase Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReshapedType) + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(ReshapedImpl_dense) + + /** Fixed-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr) + : Base(xpr.data()), m_xpr(xpr) + {} + + /** Dynamic-size constructor + */ + EIGEN_DEVICE_FUNC + inline ReshapedImpl_dense(XprType& xpr, Index nRows, Index nCols) + : Base(xpr.data(), nRows, nCols), + m_xpr(xpr) + {} + + EIGEN_DEVICE_FUNC + const typename internal::remove_all::type& nestedExpression() const + { + return m_xpr; + } + + EIGEN_DEVICE_FUNC + XprType& nestedExpression() { return m_xpr; } + + /** \sa MapBase::innerStride() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index innerStride() const + { + return m_xpr.innerStride(); + } + + /** \sa MapBase::outerStride() */ + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index outerStride() const + { + return ((Flags&RowMajorBit)==RowMajorBit) ? this->cols() : this->rows(); + } + + protected: + + XprTypeNested m_xpr; +}; + +// Evaluators +template struct reshaped_evaluator; + +template +struct evaluator > + : reshaped_evaluator >::HasDirectAccess> +{ + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + // TODO: should check for smaller packet types + typedef typename packet_traits::type PacketScalar; + + enum { + CoeffReadCost = evaluator::CoeffReadCost, + HasDirectAccess = traits::HasDirectAccess, + +// RowsAtCompileTime = traits::RowsAtCompileTime, +// ColsAtCompileTime = traits::ColsAtCompileTime, +// MaxRowsAtCompileTime = traits::MaxRowsAtCompileTime, +// MaxColsAtCompileTime = traits::MaxColsAtCompileTime, +// +// InnerStrideAtCompileTime = traits::HasSameStorageOrderAsXprType +// ? int(inner_stride_at_compile_time::ret) +// : Dynamic, +// OuterStrideAtCompileTime = Dynamic, + + FlagsLinearAccessBit = (traits::RowsAtCompileTime == 1 || traits::ColsAtCompileTime == 1 || HasDirectAccess) ? LinearAccessBit : 0, + FlagsRowMajorBit = (traits::ReshapedStorageOrder==int(RowMajor)) ? RowMajorBit : 0, + FlagsDirectAccessBit = HasDirectAccess ? DirectAccessBit : 0, + Flags0 = evaluator::Flags & (HereditaryBits & ~RowMajorBit), + Flags = Flags0 | FlagsLinearAccessBit | FlagsRowMajorBit | FlagsDirectAccessBit, + + PacketAlignment = unpacket_traits::alignment, + Alignment = evaluator::Alignment + }; + typedef reshaped_evaluator reshaped_evaluator_type; + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) : reshaped_evaluator_type(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } +}; + +template +struct reshaped_evaluator + : evaluator_base > +{ + typedef Reshaped XprType; + + enum { + CoeffReadCost = evaluator::CoeffReadCost /* TODO + cost of index computations */, + + Flags = (evaluator::Flags & (HereditaryBits /*| LinearAccessBit | DirectAccessBit*/)), + + Alignment = 0 + }; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) : m_argImpl(xpr.nestedExpression()), m_xpr(xpr) + { + EIGEN_INTERNAL_CHECK_COST_VALUE(CoeffReadCost); + } + + typedef typename XprType::Scalar Scalar; + typedef typename XprType::CoeffReturnType CoeffReturnType; + + typedef std::pair RowCol; + + inline RowCol index_remap(Index rowId, Index colId) const + { + if(Order==ColMajor) + { + const Index nth_elem_idx = colId * m_xpr.rows() + rowId; + return RowCol(nth_elem_idx % m_xpr.nestedExpression().rows(), + nth_elem_idx / m_xpr.nestedExpression().rows()); + } + else + { + const Index nth_elem_idx = colId + rowId * m_xpr.cols(); + return RowCol(nth_elem_idx / m_xpr.nestedExpression().cols(), + nth_elem_idx % m_xpr.nestedExpression().cols()); + } + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index rowId, Index colId) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + EIGEN_STRONG_INLINE const CoeffReturnType coeff(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.coeff(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline Scalar& coeffRef(Index index) + { + EIGEN_STATIC_ASSERT_LVALUE(XprType) + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + + } + + EIGEN_DEVICE_FUNC + inline const Scalar& coeffRef(Index index) const + { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeffRef(row_col.first, row_col.second); + } + + EIGEN_DEVICE_FUNC + inline const CoeffReturnType coeff(Index index) const + { + const RowCol row_col = index_remap(Rows == 1 ? 0 : index, + Rows == 1 ? index : 0); + return m_argImpl.coeff(row_col.first, row_col.second); + } +#if 0 + EIGEN_DEVICE_FUNC + template + inline PacketScalar packet(Index rowId, Index colId) const + { + const RowCol row_col = index_remap(rowId, colId); + return m_argImpl.template packet(row_col.first, row_col.second); + + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index rowId, Index colId, const PacketScalar& val) + { + const RowCol row_col = index_remap(rowId, colId); + m_argImpl.const_cast_derived().template writePacket + (row_col.first, row_col.second, val); + } + + template + EIGEN_DEVICE_FUNC + inline PacketScalar packet(Index index) const + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second); + } + + template + EIGEN_DEVICE_FUNC + inline void writePacket(Index index, const PacketScalar& val) + { + const RowCol row_col = index_remap(RowsAtCompileTime == 1 ? 0 : index, + RowsAtCompileTime == 1 ? index : 0); + return m_argImpl.template packet(row_col.first, row_col.second, val); + } +#endif +protected: + + evaluator m_argImpl; + const XprType& m_xpr; + +}; + +template +struct reshaped_evaluator +: mapbase_evaluator, + typename Reshaped::PlainObject> +{ + typedef Reshaped XprType; + typedef typename XprType::Scalar Scalar; + + EIGEN_DEVICE_FUNC explicit reshaped_evaluator(const XprType& xpr) + : mapbase_evaluator(xpr) + { + // TODO: for the 3.4 release, this should be turned to an internal assertion, but let's keep it as is for the beta lifetime + eigen_assert(((internal::UIntPtr(xpr.data()) % EIGEN_PLAIN_ENUM_MAX(1,evaluator::Alignment)) == 0) && "data is not aligned"); + } +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RESHAPED_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h b/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h new file mode 100644 index 0000000..4dad13e --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/ReturnByValue.h @@ -0,0 +1,119 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2009-2010 Gael Guennebaud +// Copyright (C) 2009-2010 Benoit Jacob +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_RETURNBYVALUE_H +#define EIGEN_RETURNBYVALUE_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : public traits::ReturnType> +{ + enum { + // We're disabling the DirectAccess because e.g. the constructor of + // the Block-with-DirectAccess expression requires to have a coeffRef method. + // Also, we don't want to have to implement the stride stuff. + Flags = (traits::ReturnType>::Flags + | EvalBeforeNestingBit) & ~DirectAccessBit + }; +}; + +/* The ReturnByValue object doesn't even have a coeff() method. + * So the only way that nesting it in an expression can work, is by evaluating it into a plain matrix. + * So internal::nested always gives the plain return matrix type. + * + * FIXME: I don't understand why we need this specialization: isn't this taken care of by the EvalBeforeNestingBit ?? + * Answer: EvalBeforeNestingBit should be deprecated since we have the evaluators + */ +template +struct nested_eval, n, PlainObject> +{ + typedef typename traits::ReturnType type; +}; + +} // end namespace internal + +/** \class ReturnByValue + * \ingroup Core_Module + * + */ +template class ReturnByValue + : public internal::dense_xpr_base< ReturnByValue >::type, internal::no_assignment_operator +{ + public: + typedef typename internal::traits::ReturnType ReturnType; + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(ReturnByValue) + + template + EIGEN_DEVICE_FUNC + inline void evalTo(Dest& dst) const + { static_cast(this)->evalTo(dst); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return static_cast(this)->rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return static_cast(this)->cols(); } + +#ifndef EIGEN_PARSED_BY_DOXYGEN +#define Unusable YOU_ARE_TRYING_TO_ACCESS_A_SINGLE_COEFFICIENT_IN_A_SPECIAL_EXPRESSION_WHERE_THAT_IS_NOT_ALLOWED_BECAUSE_THAT_WOULD_BE_INEFFICIENT + class Unusable{ + Unusable(const Unusable&) {} + Unusable& operator=(const Unusable&) {return *this;} + }; + const Unusable& coeff(Index) const { return *reinterpret_cast(this); } + const Unusable& coeff(Index,Index) const { return *reinterpret_cast(this); } + Unusable& coeffRef(Index) { return *reinterpret_cast(this); } + Unusable& coeffRef(Index,Index) { return *reinterpret_cast(this); } +#undef Unusable +#endif +}; + +template +template +EIGEN_DEVICE_FUNC Derived& DenseBase::operator=(const ReturnByValue& other) +{ + other.evalTo(derived()); + return derived(); +} + +namespace internal { + +// Expression is evaluated in a temporary; default implementation of Assignment is bypassed so that +// when a ReturnByValue expression is assigned, the evaluator is not constructed. +// TODO: Finalize port to new regime; ReturnByValue should not exist in the expression world + +template +struct evaluator > + : public evaluator::ReturnType> +{ + typedef ReturnByValue XprType; + typedef typename internal::traits::ReturnType PlainObject; + typedef evaluator Base; + + EIGEN_DEVICE_FUNC explicit evaluator(const XprType& xpr) + : m_result(xpr.rows(), xpr.cols()) + { + ::new (static_cast(this)) Base(m_result); + xpr.evalTo(m_result); + } + +protected: + PlainObject m_result; +}; + +} // end namespace internal + +} // end namespace Eigen + +#endif // EIGEN_RETURNBYVALUE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Reverse.h b/src/3rdparty/eigen/Eigen/src/Core/Reverse.h new file mode 100644 index 0000000..28cdd76 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Reverse.h @@ -0,0 +1,217 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2006-2008 Benoit Jacob +// Copyright (C) 2009 Ricard Marxer +// Copyright (C) 2009-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_REVERSE_H +#define EIGEN_REVERSE_H + +namespace Eigen { + +namespace internal { + +template +struct traits > + : traits +{ + typedef typename MatrixType::Scalar Scalar; + typedef typename traits::StorageKind StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ref_selector::type MatrixTypeNested; + typedef typename remove_reference::type _MatrixTypeNested; + enum { + RowsAtCompileTime = MatrixType::RowsAtCompileTime, + ColsAtCompileTime = MatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = MatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = MatrixType::MaxColsAtCompileTime, + Flags = _MatrixTypeNested::Flags & (RowMajorBit | LvalueBit) + }; +}; + +template struct reverse_packet_cond +{ + static inline PacketType run(const PacketType& x) { return preverse(x); } +}; + +template struct reverse_packet_cond +{ + static inline PacketType run(const PacketType& x) { return x; } +}; + +} // end namespace internal + +/** \class Reverse + * \ingroup Core_Module + * + * \brief Expression of the reverse of a vector or matrix + * + * \tparam MatrixType the type of the object of which we are taking the reverse + * \tparam Direction defines the direction of the reverse operation, can be Vertical, Horizontal, or BothDirections + * + * This class represents an expression of the reverse of a vector. + * It is the return type of MatrixBase::reverse() and VectorwiseOp::reverse() + * and most of the time this is the only way it is used. + * + * \sa MatrixBase::reverse(), VectorwiseOp::reverse() + */ +template class Reverse + : public internal::dense_xpr_base< Reverse >::type +{ + public: + + typedef typename internal::dense_xpr_base::type Base; + EIGEN_DENSE_PUBLIC_INTERFACE(Reverse) + typedef typename internal::remove_all::type NestedExpression; + using Base::IsRowMajor; + + protected: + enum { + PacketSize = internal::packet_traits::size, + IsColMajor = !IsRowMajor, + ReverseRow = (Direction == Vertical) || (Direction == BothDirections), + ReverseCol = (Direction == Horizontal) || (Direction == BothDirections), + OffsetRow = ReverseRow && IsColMajor ? PacketSize : 1, + OffsetCol = ReverseCol && IsRowMajor ? PacketSize : 1, + ReversePacket = (Direction == BothDirections) + || ((Direction == Vertical) && IsColMajor) + || ((Direction == Horizontal) && IsRowMajor) + }; + typedef internal::reverse_packet_cond reverse_packet; + public: + + EIGEN_DEVICE_FUNC explicit inline Reverse(const MatrixType& matrix) : m_matrix(matrix) { } + + EIGEN_INHERIT_ASSIGNMENT_OPERATORS(Reverse) + + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index rows() const EIGEN_NOEXCEPT { return m_matrix.rows(); } + EIGEN_DEVICE_FUNC EIGEN_CONSTEXPR + inline Index cols() const EIGEN_NOEXCEPT { return m_matrix.cols(); } + + EIGEN_DEVICE_FUNC inline Index innerStride() const + { + return -m_matrix.innerStride(); + } + + EIGEN_DEVICE_FUNC const typename internal::remove_all::type& + nestedExpression() const + { + return m_matrix; + } + + protected: + typename MatrixType::Nested m_matrix; +}; + +/** \returns an expression of the reverse of *this. + * + * Example: \include MatrixBase_reverse.cpp + * Output: \verbinclude MatrixBase_reverse.out + * + */ +template +EIGEN_DEVICE_FUNC inline typename DenseBase::ReverseReturnType +DenseBase::reverse() +{ + return ReverseReturnType(derived()); +} + + +//reverse const overload moved DenseBase.h due to a CUDA compiler bug + +/** This is the "in place" version of reverse: it reverses \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * - it allows future optimizations (cache friendliness, etc.) + * + * \sa VectorwiseOp::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC inline void DenseBase::reverseInPlace() +{ + if(cols()>rows()) + { + Index half = cols()/2; + leftCols(half).swap(rightCols(half).reverse()); + if((cols()%2)==1) + { + Index half2 = rows()/2; + col(half).head(half2).swap(col(half).tail(half2).reverse()); + } + } + else + { + Index half = rows()/2; + topRows(half).swap(bottomRows(half).reverse()); + if((rows()%2)==1) + { + Index half2 = cols()/2; + row(half).head(half2).swap(row(half).tail(half2).reverse()); + } + } +} + +namespace internal { + +template +struct vectorwise_reverse_inplace_impl; + +template<> +struct vectorwise_reverse_inplace_impl +{ + template + static void run(ExpressionType &xpr) + { + const int HalfAtCompileTime = ExpressionType::RowsAtCompileTime==Dynamic?Dynamic:ExpressionType::RowsAtCompileTime/2; + Index half = xpr.rows()/2; + xpr.topRows(fix(half)) + .swap(xpr.bottomRows(fix(half)).colwise().reverse()); + } +}; + +template<> +struct vectorwise_reverse_inplace_impl +{ + template + static void run(ExpressionType &xpr) + { + const int HalfAtCompileTime = ExpressionType::ColsAtCompileTime==Dynamic?Dynamic:ExpressionType::ColsAtCompileTime/2; + Index half = xpr.cols()/2; + xpr.leftCols(fix(half)) + .swap(xpr.rightCols(fix(half)).rowwise().reverse()); + } +}; + +} // end namespace internal + +/** This is the "in place" version of VectorwiseOp::reverse: it reverses each column or row of \c *this. + * + * In most cases it is probably better to simply use the reversed expression + * of a matrix. However, when reversing the matrix data itself is really needed, + * then this "in-place" version is probably the right choice because it provides + * the following additional benefits: + * - less error prone: doing the same operation with .reverse() requires special care: + * \code m = m.reverse().eval(); \endcode + * - this API enables reverse operations without the need for a temporary + * + * \sa DenseBase::reverseInPlace(), reverse() */ +template +EIGEN_DEVICE_FUNC void VectorwiseOp::reverseInPlace() +{ + internal::vectorwise_reverse_inplace_impl::run(m_matrix); +} + +} // end namespace Eigen + +#endif // EIGEN_REVERSE_H diff --git a/src/3rdparty/eigen/Eigen/src/Core/Select.h b/src/3rdparty/eigen/Eigen/src/Core/Select.h new file mode 100644 index 0000000..7c86bf8 --- /dev/null +++ b/src/3rdparty/eigen/Eigen/src/Core/Select.h @@ -0,0 +1,164 @@ +// This file is part of Eigen, a lightweight C++ template library +// for linear algebra. +// +// Copyright (C) 2008-2010 Gael Guennebaud +// +// This Source Code Form is subject to the terms of the Mozilla +// Public License v. 2.0. If a copy of the MPL was not distributed +// with this file, You can obtain one at http://mozilla.org/MPL/2.0/. + +#ifndef EIGEN_SELECT_H +#define EIGEN_SELECT_H + +namespace Eigen { + +/** \class Select + * \ingroup Core_Module + * + * \brief Expression of a coefficient wise version of the C++ ternary operator ?: + * + * \param ConditionMatrixType the type of the \em condition expression which must be a boolean matrix + * \param ThenMatrixType the type of the \em then expression + * \param ElseMatrixType the type of the \em else expression + * + * This class represents an expression of a coefficient wise version of the C++ ternary operator ?:. + * It is the return type of DenseBase::select() and most of the time this is the only way it is used. + * + * \sa DenseBase::select(const DenseBase&, const DenseBase&) const + */ + +namespace internal { +template +struct traits > + : traits +{ + typedef typename traits::Scalar Scalar; + typedef Dense StorageKind; + typedef typename traits::XprKind XprKind; + typedef typename ConditionMatrixType::Nested ConditionMatrixNested; + typedef typename ThenMatrixType::Nested ThenMatrixNested; + typedef typename ElseMatrixType::Nested ElseMatrixNested; + enum { + RowsAtCompileTime = ConditionMatrixType::RowsAtCompileTime, + ColsAtCompileTime = ConditionMatrixType::ColsAtCompileTime, + MaxRowsAtCompileTime = ConditionMatrixType::MaxRowsAtCompileTime, + MaxColsAtCompileTime = ConditionMatrixType::MaxColsAtCompileTime, + Flags = (unsigned int)ThenMatrixType::Flags & ElseMatrixType::Flags & RowMajorBit + }; +}; +} + +template +class Select : public internal::dense_xpr_base< Select >::type, + internal::no_assignment_operator +{ + public: + + typedef typename internal::dense_xpr_base

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 ARsaA1 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg b/examples/multimedia/video/recorder/doc/images/qmlrecorder.jpg new file mode 100644 index 0000000000000000000000000000000000000000..1ef0e4447ad5133b35698bc27a27e12888f6edc2 GIT binary patch literal 95965 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�s^Ve_UC|8I;^Ax{e| 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 literal 0 HcmV?d00001 diff --git a/examples/multimedia/video/recorder/doc/src/recorder.qdoc b/examples/multimedia/video/recorder/doc/src/recorder.qdoc new file mode 100644 index 0000000..3c0de37 --- /dev/null +++ b/examples/multimedia/video/recorder/doc/src/recorder.qdoc @@ -0,0 +1,102 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR GFDL-1.3-no-invariants-only + +/*! + \example video/recorder + \title QML Video Recorder + \ingroup multimedia_examples + \ingroup video_examples_qml + \ingroup camera_examples_qml + \examplecategory {Multimedia} + \brief Recording audio and video using Qt Quick. + \meta {tag} {quick} + + \image qmlrecorder.jpg + + \e{QML Recorder} demonstrates a simple application that can record + audio and video separate or together, using a microphone, a camera, or + with screen capturing. + + \include examples-run.qdocinc + + \section1 Overview + At its core, this is a QML application, see + \l{Getting Started Programming with Qt Quick}. This documentation is focused + on how this example uses the \l{Qt Multimedia QML Types}. + + \image qml-recorder-overview.gif "Animation cycling through qml objects declared in main.qml" + + The example uses the QML \l Camera and \l AudioInput types connected to a + \l CaptureSession. A \l MediaRecorder object is then used to record the + captured audio and video. + + In addition to QtMultimedia, features of Qt Quick Windows, Controls, and + Layouts are used to implement the graphic user interface and functionality. + Playback won't be covered here, for that see the \l{QML Media Player Example}. + + The example demonstrates the following: + \list + \li Input devices can be selected. + \li An input type switched off. + \li Settings for capturing such as quality, codec choice, file format, + and assigning metadata. + \li Captured files are stored and can be played back. + \endlist + + \section1 Recording + + The application implements recording. + + \section2 captureSession + + In \c main.qml, \c captureSession is declared like so: + + \quotefromfile video/recorder/main.qml + \skipto CaptureSession + \printto MediaRecorder + + \section2 recorder + + In \c main.qml, the \l MediaRecorder \c recorder handles recording media + as well as capturing a thumbnail for the file and appending it to a ListModel, + \c mediaList. + \printto Playback + + \c mediaList is declared in the \l Frame \c mediaListFrame + \quotefromfile video/recorder/main.qml + \skipto Frame + \printuntil playback: playback + + \section2 controls + + \image qml-recorder-control-bar-overview.gif + + These are defined in \c Controls.qml and declared in main.qml. + + Its root is a \l Row that contains the \l{Column}{Columns} \c inputControls, + \c recordButton, \c optionButtons, each defined in their own .qml files. + + \section3 Selecting a video source + + Defined in \c VideoSourceSelect.qml, \c VideoSourceSlect is comprised of a + \l Switch and a \l ComboBox and enables the user to select from available + cameras. + + \quotefromfile video/recorder/VideoSourceSelect.qml + \skipto Row + \printto ComboBox + + \c comboBox, declared in the above snippet, assigns the current video source. + + \printuntil camera.cameraDevice = currentValue.camera + + \section3 Selecting an audio input + + Implemented in the same way as \l{Selecting a video source} and defined in + \c AudioInputSelect.qml like so: + + \quotefromfile video/recorder/AudioInputSelect.qml + \skipto Row + \printto audioInput.device = currentValue + +*/ diff --git a/examples/multimedia/video/recorder/main.cpp b/examples/multimedia/video/recorder/main.cpp new file mode 100644 index 0000000..92e54cb --- /dev/null +++ b/examples/multimedia/video/recorder/main.cpp @@ -0,0 +1,51 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +#include +#include + +#if QT_CONFIG(permissions) + #include +#endif + +int main(int argc, char *argv[]) +{ + QGuiApplication app(argc, argv); + + QQmlApplicationEngine engine; + const QUrl url(QStringLiteral("qrc:/main.qml")); + QObject::connect( + &engine, &QQmlApplicationEngine::objectCreated, &app, + [url](QObject *obj, const QUrl &objUrl) { + if (!obj && url == objUrl) + QCoreApplication::exit(-1); + }, + Qt::QueuedConnection); + +#if QT_CONFIG(permissions) + // If the permissions are not granted, display another main window, which + // simply contains the error message. + const QUrl noPermissionsUrl(QStringLiteral("qrc:/main_no_permissions.qml")); + QCameraPermission cameraPermission; + qApp->requestPermission(cameraPermission, [&](const QPermission &permission) { + if (permission.status() != Qt::PermissionStatus::Granted) { + qWarning("Camera permission is not granted!"); + engine.load(noPermissionsUrl); + return; + } + QMicrophonePermission micPermission; + qApp->requestPermission(micPermission, [&](const QPermission &permission) { + if (permission.status() != Qt::PermissionStatus::Granted) { + qWarning("Microphone permission is not granted!"); + engine.load(noPermissionsUrl); + } else { + engine.load(url); + } + }); + }); +#else + engine.load(url); +#endif + + return app.exec(); +} diff --git a/examples/multimedia/video/recorder/main.qml b/examples/multimedia/video/recorder/main.qml new file mode 100644 index 0000000..d8d1cd5 --- /dev/null +++ b/examples/multimedia/video/recorder/main.qml @@ -0,0 +1,144 @@ +// Copyright (C) 2021 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Window +import QtQuick.Controls +import QtQuick.Layouts +import QtMultimedia + +Window { + id: root + visible: true + title: "Media recorder" + width: Style.screenWidth + height: Style.screenHeigth + + color: palette.window + + onWidthChanged:{ + Style.calculateRatio(root.width, root.height) + } + + VideoOutput { + id: videoOutput + anchors.fill: parent + visible: !playback.playing + } + + Popup { + id: recorderError + anchors.centerIn: Overlay.overlay + Text { id: recorderErrorText } + } + + CaptureSession { + id: captureSession + recorder: recorder + audioInput: controls.audioInput + camera: controls.camera + screenCapture: controls.screenCapture + windowCapture: controls.windowCapture + videoOutput: videoOutput + } + + MediaRecorder { + id: recorder + onRecorderStateChanged: + (state) => { + if (state === MediaRecorder.StoppedState) { + root.contentOrientation = Qt.PrimaryOrientation + mediaList.append() + } else if (state === MediaRecorder.RecordingState && captureSession.camera) { + // lock orientation while recording and create a preview image + root.contentOrientation = root.screen.orientation; + videoOutput.grabToImage(function(res) { mediaList.mediaThumbnail = res.url }) + } + } + onActualLocationChanged: (url) => { mediaList.mediaUrl = url } + onErrorOccurred: { recorderErrorText.text = recorder.errorString; recorderError.open(); } + } + + Playback { + id: playback + anchors { + fill: parent + margins: 50 + } + active: controls.capturesVisible + } + + Frame { + id: mediaListFrame + height: 150 + width: parent.width + anchors.bottom: controlsFrame.top + x: controls.capturesVisible ? 0 : parent.width + background: Rectangle { + anchors.fill: parent + color: palette.base + opacity: 0.8 + } + + Behavior on x { NumberAnimation { duration: 200 } } + + MediaList { + id: mediaList + anchors.fill: parent + playback: playback + } + } + + Frame { + id: controlsFrame + + anchors { + left: parent.left + right: parent.right + bottom: parent.bottom + } + + height: controls.height + Style.interSpacing * 2 + (settingsEncoder.visible? settingsEncoder.height : 0) +(settingsMetaData.visible? settingsMetaData.height : 0) + + background: Rectangle { + anchors.fill: parent + color: palette.base + opacity: 0.8 + } + + Behavior on height { NumberAnimation { duration: 100 } } + + ColumnLayout { + anchors.fill: parent + + Controls { + Layout.alignment: Qt.AlignHCenter + id: controls + recorder: recorder + } + + StyleRectangle { + Layout.alignment: Qt.AlignHCenter + visible: controls.settingsVisible + width: controls.width + height: 1 + } + + SettingsEncoder { + + id:settingsEncoder + Layout.alignment: Qt.AlignHCenter + visible: controls.settingsVisible + padding: Style.interSpacing + recorder: recorder + } + + SettingsMetaData { + id: settingsMetaData + Layout.alignment: Qt.AlignHCenter + visible: !Style.isMobile() && controls.settingsVisible + recorder: recorder + } + } + } +} diff --git a/examples/multimedia/video/recorder/main_no_permissions.qml b/examples/multimedia/video/recorder/main_no_permissions.qml new file mode 100644 index 0000000..8c76533 --- /dev/null +++ b/examples/multimedia/video/recorder/main_no_permissions.qml @@ -0,0 +1,26 @@ +// Copyright (C) 2023 The Qt Company Ltd. +// SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +import QtQuick +import QtQuick.Window + +Window { + id: root + visible: true + title: "Media recorder" + width: Style.screenWidth + height: Style.screenHeigth + + StyleRectangle { + anchors.fill: parent + Text { + anchors.fill: parent + anchors.margins: 20 + wrapMode: Text.WordWrap + verticalAlignment: Text.AlignVCenter + horizontalAlignment: Text.AlignHCenter + text: qsTr("The example is not usable without the permissions.\n" + + "Please grant all requested permissions and restart the application.") + } + } +} diff --git a/examples/multimedia/video/recorder/qmldir b/examples/multimedia/video/recorder/qmldir new file mode 100644 index 0000000..400b74b --- /dev/null +++ b/examples/multimedia/video/recorder/qmldir @@ -0,0 +1,2 @@ +module CustomStyles +singleton Style 1.0 Style.qml diff --git a/examples/multimedia/video/video.pro b/examples/multimedia/video/video.pro new file mode 100644 index 0000000..2915ce4 --- /dev/null +++ b/examples/multimedia/video/video.pro @@ -0,0 +1,3 @@ +TEMPLATE = subdirs + +SUBDIRS += qmlvideo diff --git a/examples/multimedia/videographicsitem/CMakeLists.txt b/examples/multimedia/videographicsitem/CMakeLists.txt new file mode 100644 index 0000000..4c34172 --- /dev/null +++ b/examples/multimedia/videographicsitem/CMakeLists.txt @@ -0,0 +1,41 @@ +# Copyright (C) 2022 The Qt Company Ltd. +# SPDX-License-Identifier: LicenseRef-Qt-Commercial OR BSD-3-Clause + +cmake_minimum_required(VERSION 3.16) +project(videographicsitem LANGUAGES CXX) + +set(CMAKE_AUTOMOC ON) + +if(NOT DEFINED INSTALL_EXAMPLESDIR) + set(INSTALL_EXAMPLESDIR "examples") +endif() + +set(INSTALL_EXAMPLEDIR "${INSTALL_EXAMPLESDIR}/multimedia/videographicsitem") + +find_package(Qt6 REQUIRED COMPONENTS Core Gui Multimedia MultimediaWidgets Widgets) + +qt_add_executable(videographicsitem + main.cpp + videoplayer.cpp videoplayer.h +) + +set_target_properties(videographicsitem PROPERTIES + WIN32_EXECUTABLE TRUE + MACOSX_BUNDLE TRUE +) + +target_link_libraries(videographicsitem PUBLIC + Qt::Core + Qt::Gui + Qt::Multimedia + Qt::MultimediaWidgets + Qt::Widgets +) + +qt_add_ios_ffmpeg_libraries(videographicsitem) + +install(TARGETS videographicsitem + RUNTIME DESTINATION "${INSTALL_EXAMPLEDIR}" + BUNDLE DESTINATION "${INSTALL_EXAMPLEDIR}" + LIBRARY DESTINATION "${INSTALL_EXAMPLEDIR}" +) diff --git a/examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png b/examples/multimedia/videographicsitem/doc/images/video-videographicsitem.png new file mode 100644 index 0000000000000000000000000000000000000000..e333c54a294aac8df163e9882e7dc91a066668e1 GIT binary patch literal 54436 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