diff options
author | Yoann Lopes <yoann.lopes@digia.com> | 2014-01-22 16:18:42 +0100 |
---|---|---|
committer | The Qt Project <gerrit-noreply@qt-project.org> | 2014-02-28 14:10:00 +0100 |
commit | b28ee24628f77fced393cacc45500be6761e4497 (patch) | |
tree | 811173f8a2caf84e0fa386010283ccfd32c6ad0d /src/multimedia/doc/src/cameraoverview.qdoc | |
parent | d964388b38ec4762e315d86aacb779604bcdca1b (diff) | |
download | qtmultimedia-b28ee24628f77fced393cacc45500be6761e4497.tar.gz |
New QCameraInfo class.
The class allows to get the list of available cameras on the system as
well as getting some static information about them such as their unique
ID, display name, physical position and sensor orientation.
This makes QCamera::availableDevices() and QCamera::deviceDescription()
obsolete.
This patch contains the API, documentation and auto-tests but not the
actual implementation by each backend (except for retrieving the default
camera device).
[ChangeLog][QtMultimedia] Added new QCameraInfo class
[ChangeLog][QtMultimedia] QCamera: availableDevices() and
deviceDescription() are deprecated, use QCameraInfo instead
Change-Id: I64fd65729ab26a789468979ed5444ee90bb82cd0
Reviewed-by: Christian Stromme <christian.stromme@digia.com>
Diffstat (limited to 'src/multimedia/doc/src/cameraoverview.qdoc')
-rw-r--r-- | src/multimedia/doc/src/cameraoverview.qdoc | 11 |
1 files changed, 10 insertions, 1 deletions
diff --git a/src/multimedia/doc/src/cameraoverview.qdoc b/src/multimedia/doc/src/cameraoverview.qdoc index 71515ab19..b2b9d46a5 100644 --- a/src/multimedia/doc/src/cameraoverview.qdoc +++ b/src/multimedia/doc/src/cameraoverview.qdoc @@ -118,7 +118,7 @@ VideoOutput { \endqml In C++, your choice depends on whether you are using widgets, or QGraphicsView. -The \l QVideoWidget class is used in the widgets case, and \l QGraphicsVideoItem +The \l QCameraViewfinder class is used in the widgets case, and \l QGraphicsVideoItem is useful for QGraphicsView. \snippet multimedia-snippets/camera.cpp Camera overview viewfinder @@ -130,6 +130,15 @@ need to render the viewfinder image yourself. \snippet multimedia-snippets/camera.cpp Camera overview surface +On mobile devices, the viewfinder image might not always be in the orientation you would expect. +The camera sensors on these devices are often mounted in landscape while the natural +orientation of the screen is portrait. This results in the image appearing sideways or inverted +depending on the device orientation. In order to reflect on screen what the user actually sees, you +should make sure the viewfinder frames are always rotated to the correct orientation, taking into +account the camera sensor orientation and the current display orientation. + + \snippet multimedia-snippets/camera.cpp Camera overview viewfinder orientation + \section2 Still Images After setting up a viewfinder and finding something photogenic, |