              
QVideoFrame Class Reference |
| enum | FieldType { ProgressiveFrame, TopField, BottomField, InterlacedFrame } |
| enum | PixelFormat { Format_Invalid, Format_ARGB32, Format_ARGB32_Premultiplied, Format_RGB32, ..., Format_User } |
Public Functions
| QVideoFrame () | |
| QVideoFrame ( QAbstractVideoBuffer * buffer, const QSize & size, PixelFormat format ) | |
| QVideoFrame ( int bytes, const QSize & size, int bytesPerLine, PixelFormat format ) | |
| QVideoFrame ( const QImage & image ) | |
| QVideoFrame ( const QVideoFrame & other ) | |
| ~QVideoFrame () | |
| uchar * | bits () |
| const uchar * | bits () const |
| int | bytesPerLine () const |
| qint64 | endTime () const |
| FieldType | fieldType () const |
| QVariant | handle () const |
| QAbstractVideoBuffer::HandleType | handleType () const |
| int | height () const |
| bool | isMapped () const |
| bool | isReadable () const |
| bool | isValid () const |
| bool | isWritable () const |
| bool | map ( QAbstractVideoBuffer::MapMode mode ) |
| QAbstractVideoBuffer::MapMode | mapMode () const |
| int | mappedBytes () const |
| PixelFormat | pixelFormat () const |
| void | setEndTime ( qint64 time ) |
| void | setFieldType ( FieldType field ) |
| void | setStartTime ( qint64 time ) |
| QSize | size () const |
| qint64 | startTime () const |
| void | unmap () |
| int | width () const |
| QVideoFrame & | operator= ( const QVideoFrame & other ) |
Static Public Members
| QImage::Format | imageFormatFromPixelFormat ( PixelFormat format ) |
| PixelFormat | pixelFormatFromImageFormat ( QImage::Format format ) |
Detailed Description
The QVideoFrame class provides a representation of a frame of video data.
A QVideoFrame encapsulates the data of a video frame, and information about the frame.
The contents of a video frame can be mapped to memory using the map() function. While mapped the video data can accessed using the bits() function which returns a pointer to a buffer, the total size of which is given by the mappedBytes(), and the size of each line is given by bytesPerLine(). The return value of the handle() function may be used to access frame data using the internal buffer's native APIs.
The video data in a QVideoFrame is encapsulated in a QAbstractVideoBuffer. A QVideoFrame may be constructed from any buffer type by subclassing the QAbstractVideoBuffer class.
Note: QVideoFrame is explicitly shared, any change made to video frame will also apply to any copies.
Member Type Documentation
enum QVideoFrame::FieldType
Specifies the field an interlaced video frame belongs to.
| Constant | Value | Description |
|---|---|---|
| QVideoFrame::ProgressiveFrame | 0 | The frame is not interlaced. |
| QVideoFrame::TopField | 1 | The frame contains a top field. |
| QVideoFrame::BottomField | 2 | The frame contains a bottom field. |
| QVideoFrame::InterlacedFrame | 3 | The frame contains a merged top and bottom field. |
enum QVideoFrame::PixelFormat
Enumerates video data types.
| Constant | Value | Description |
|---|---|---|
| QVideoFrame::Format_Invalid | 0 | The frame is invalid. |
| QVideoFrame::Format_ARGB32 | 1 | The frame is stored using a 32-bit ARGB format (0xAARRGGBB). This is equivalent to QImage::Format_ARGB32. |
| QVideoFrame::Format_ARGB32_Premultiplied | 2 | The frame stored using a premultiplied 32-bit ARGB format (0xAARRGGBB). This is equivalent to QImage::Format_ARGB32_Premultiplied. |
| QVideoFrame::Format_RGB32 | 3 | The frame stored using a 32-bit RGB format (0xffRRGGBB). This is equivalent to QImage::Format_RGB32 |
| QVideoFrame::Format_RGB24 | 4 | The frame is stored using a 24-bit RGB format (8-8-8). This is equivalent to QImage::Format_RGB888 |
| QVideoFrame::Format_RGB565 | 5 | The frame is stored using a 16-bit RGB format (5-6-5). This is equivalent to QImage::Format_RGB16. |
| QVideoFrame::Format_RGB555 | 6 | The frame is stored using a 16-bit RGB format (5-5-5). This is equivalent to QImage::Format_RGB555. |
| QVideoFrame::Format_ARGB8565_Premultiplied | 7 | The frame is stored using a 24-bit premultiplied ARGB format (8-6-6-5). |
| QVideoFrame::Format_BGRA32 | 8 | The frame is stored using a 32-bit ARGB format (0xBBGGRRAA). |
| QVideoFrame::Format_BGRA32_Premultiplied | 9 | The frame is stored using a premultiplied 32bit BGRA format. |
| QVideoFrame::Format_BGR32 | 10 | The frame is stored using a 32-bit BGR format (0xBBGGRRff). |
| QVideoFrame::Format_BGR24 | 11 | The frame is stored using a 24-bit BGR format (0xBBGGRR). |
| QVideoFrame::Format_BGR565 | 12 | The frame is stored using a 16-bit BGR format (5-6-5). |
| QVideoFrame::Format_BGR555 | 13 | The frame is stored using a 16-bit BGR format (5-5-5). |
| QVideoFrame::Format_BGRA5658_Premultiplied | 14 | The frame is stored using a 24-bit premultiplied BGRA format (5-6-5-8). |
| QVideoFrame::Format_AYUV444 | 15 | The frame is stored using a packed 32-bit AYUV format (0xAAYYUUVV). |
| QVideoFrame::Format_AYUV444_Premultiplied | 16 | The frame is stored using a packed premultiplied 32-bit AYUV format (0xAAYYUUVV). |
| QVideoFrame::Format_YUV444 | 17 | The frame is stored using a 24-bit packed YUV format (8-8-8). |
| QVideoFrame::Format_YUV420P | 18 | The frame is stored using an 8-bit per component planar YUV format with the U and V planes horizontally and vertically sub-sampled, i.e. the height and width of the U and V planes are half that of the Y plane. |
| QVideoFrame::Format_YV12 | 19 | The frame is stored using an 8-bit per component planar YVU format with the V and U planes horizontally and vertically sub-sampled, i.e. the height and width of the V and U planes are half that of the Y plane. |
| QVideoFrame::Format_UYVY | 20 | The frame is stored using an 8-bit per component packed YUV format with the U and V planes horizontally sub-sampled (U-Y-V-Y), i.e. two horizontally adjacent pixels are stored as a 32-bit macropixel which has a Y value for each pixel and common U and V values. |
| QVideoFrame::Format_YUYV | 21 | The frame is stored using an 8-bit per component packed YUV format with the U and V planes horizontally sub-sampled (Y-U-Y-V), i.e. two horizontally adjacent pixels are stored as a 32-bit macropixel which has a Y value for each pixel and common U and V values. |
| QVideoFrame::Format_NV12 | 22 | The frame is stored using an 8-bit per component semi-planar YUV format with a Y plane (Y) followed by a horizontally and vertically sub-sampled, packed UV plane (U-V). |
| QVideoFrame::Format_NV21 | 23 | The frame is stored using an 8-bit per component semi-planar YUV format with a Y plane (Y) followed by a horizontally and vertically sub-sampled, packed VU plane (V-U). |
| QVideoFrame::Format_IMC1 | 24 | The frame is stored using an 8-bit per component planar YUV format with the U and V planes horizontally and vertically sub-sampled. This is similar to the Format_YUV420P type, except that the bytes per line of the U and V planes are padded out to the same stride as the Y plane. |
| QVideoFrame::Format_IMC2 | 25 | The frame is stored using an 8-bit per component planar YUV format with the U and V planes horizontally and vertically sub-sampled. This is similar to the Format_YUV420P type, except that the lines of the U and V planes are interleaved, i.e. each line of U data is followed by a line of V data creating a single line of the same stride as the Y data. |
| QVideoFrame::Format_IMC3 | 26 | The frame is stored using an 8-bit per component planar YVU format with the V and U planes horizontally and vertically sub-sampled. This is similar to the Format_YV12 type, except that the bytes per line of the V and U planes are padded out to the same stride as the Y plane. |
| QVideoFrame::Format_IMC4 | 27 | The frame is stored using an 8-bit per component planar YVU format with the V and U planes horizontally and vertically sub-sampled. This is similar to the Format_YV12 type, except that the lines of the V and U planes are interleaved, i.e. each line of V data is followed by a line of U data creating a single line of the same stride as the Y data. |
| QVideoFrame::Format_Y8 | 28 | The frame is stored using an 8-bit greyscale format. |
| QVideoFrame::Format_Y16 | 29 | The frame is stored using a 16-bit linear greyscale format. Little endian. |
| QVideoFrame::Format_User | 1000 | Start value for user defined pixel formats. |
Member Function Documentation
QVideoFrame::QVideoFrame ()
Constructs a null video frame.
QVideoFrame::QVideoFrame ( QAbstractVideoBuffer * buffer, const QSize & size, PixelFormat format )
Constructs a video frame from a buffer of the given pixel format and size in pixels.
Note: This doesn't increment the reference count of the video buffer.
QVideoFrame::QVideoFrame ( int bytes, const QSize & size, int bytesPerLine, PixelFormat format )
Constructs a video frame of the given pixel format and size in pixels.
The bytesPerLine (stride) is the length of each scan line in bytes, and bytes is the total number of bytes that must be allocated for the frame.
QVideoFrame::QVideoFrame ( const QImage & image )
Constructs a video frame from an image.
Note: This will construct an invalid video frame if there is no frame type equivalent to the image format.
See also pixelFormatFromImageFormat().
QVideoFrame::QVideoFrame ( const QVideoFrame & other )
Constructs a copy of other.
QVideoFrame::~QVideoFrame ()
Destroys a video frame.
uchar * QVideoFrame::bits ()
Returns a pointer to the start of the frame data buffer.
This value is only valid while the frame data is mapped.
See also map(), mappedBytes(), and bytesPerLine().
const uchar * QVideoFrame::bits () const
Returns a pointer to the start of the frame data buffer.
This value is only valid while the frame data is mapped.
See also map(), mappedBytes(), and bytesPerLine().
int QVideoFrame::bytesPerLine () const
Returns the number of bytes in a scan line.
Note: This is the bytes per line of the first plane only. The bytes per line of subsequent planes should be calculated as per the frame type.
This value is only valid while the frame data is mapped.
See also bits(), map(), and mappedBytes().
qint64 QVideoFrame::endTime () const
Returns the presentation time when a frame should stop being displayed.
See also setEndTime().
FieldType QVideoFrame::fieldType () const
Returns the field an interlaced video frame belongs to.
If the video is not interlaced this will return WholeFrame.
See also setFieldType().
QVariant QVideoFrame::handle () const
Returns a type specific handle to a video frame's buffer.
For an OpenGL texture this would be the texture ID.
See also QAbstractVideoBuffer::handle().
QAbstractVideoBuffer::HandleType QVideoFrame::handleType () const
Returns the type of a video frame's handle.
int QVideoFrame::height () const
Returns the height of a video frame.
QImage::Format QVideoFrame::imageFormatFromPixelFormat ( PixelFormat format ) [static]
Returns an image format equivalent to a video frame pixel format. If there is no equivalent format QImage::Format_Invalid is returned instead.
bool QVideoFrame::isMapped () const
Identifies if a video frame's contents are currently mapped to system memory.
This is a convenience function which checks that the MapMode of the frame is not equal to QAbstractVideoBuffer::NotMapped.
Returns true if the contents of the video frame are mapped to system memory, and false otherwise.
See also mapMode() and QAbstractVideoBuffer::MapMode.
bool QVideoFrame::isReadable () const
Identifies if the mapped contents of a video frame were read from the frame when it was mapped.
This is a convenience function which checks if the MapMode contains the QAbstractVideoBuffer::WriteOnly flag.
Returns true if the contents of the mapped memory were read from the video frame, and false otherwise.
See also mapMode() and QAbstractVideoBuffer::MapMode.
bool QVideoFrame::isValid () const
Identifies whether a video frame is valid.
An invalid frame has no video buffer associated with it.
Returns true if the frame is valid, and false if it is not.
bool QVideoFrame::isWritable () const
Identifies if the mapped contents of a video frame will be persisted when the frame is unmapped.
This is a convenience function which checks if the MapMode contains the QAbstractVideoBuffer::WriteOnly flag.
Returns true if the video frame will be updated when unmapped, and false otherwise.
Note: The result of altering the data of a frame that is mapped in read-only mode is undefined. Depending on the buffer implementation the changes may be persisted, or worse alter a shared buffer.
See also mapMode() and QAbstractVideoBuffer::MapMode.
bool QVideoFrame::map ( QAbstractVideoBuffer::MapMode mode )
Maps the contents of a video frame to memory.
The map mode indicates whether the contents of the mapped memory should be read from and/or written to the frame. If the map mode includes the QAbstractVideoBuffer::ReadOnly flag the mapped memory will be populated with the content of the video frame when mapped. If the map mode inclues the QAbstractVideoBuffer::WriteOnly flag the content of the mapped memory will be persisted in the frame when unmapped.
While mapped the contents of a video frame can be accessed directly through the pointer returned by the bits() function.
When access to the data is no longer needed be sure to call the unmap() function to release the mapped memory.
Returns true if the buffer was mapped to memory in the given mode and false otherwise.
See also unmap(), mapMode(), and bits().
QAbstractVideoBuffer::MapMode QVideoFrame::mapMode () const
Returns the mode a video frame was mapped to system memory in.
See also map() and QAbstractVideoBuffer::MapMode.
int QVideoFrame::mappedBytes () const
Returns the number of bytes occupied by the mapped frame data.
This value is only valid while the frame data is mapped.
See also map().
PixelFormat QVideoFrame::pixelFormat () const
Returns the color format of a video frame.
PixelFormat QVideoFrame::pixelFormatFromImageFormat ( QImage::Format format ) [static]
Returns an video pixel format equivalent to an image format. If there is no equivalent format QVideoFrame::InvalidType is returned instead.
void QVideoFrame::setEndTime ( qint64 time )
Sets the presentation time when a frame should stop being displayed.
See also endTime().
void QVideoFrame::setFieldType ( FieldType field )
Sets the field an interlaced video frame belongs to.
See also fieldType().
void QVideoFrame::setStartTime ( qint64 time )
Sets the presentation time when the frame should be displayed.
See also startTime().
QSize QVideoFrame::size () const
Returns the size of a video frame.
qint64 QVideoFrame::startTime () const
Returns the presentation time when the frame should be displayed.
See also setStartTime().
void QVideoFrame::unmap ()
Releases the memory mapped by the map() function.
If the MapMode included the QAbstractVideoBuffer::WriteOnly flag this will persist the current content of the mapped memory to the video frame.
See also map().
int QVideoFrame::width () const
Returns the width of a video frame.
Assigns the contents of other to a video frame.
Best Of
Actualités les plus lues
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 54
- Créer des applications avec un style Metro avec Qt, exemples en QML et C++, un article du blog Digia traduit par Thibaut Cuvelier 0
- Orientation de l'écran en QML, un article de Christophe Dumez traduit par Thibaut Cuvelier 0
- « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 54
- Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
- Apercevoir la troisième dimension ou l'utilisation multithreadée d'OpenGL dans Qt, un article des Qt Quarterly traduit par Guillaume Belz 0
- BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
- Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
- Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
- La rubrique Qt a besoin de vous ! 1
- Linus Torvalds : le "C++ est un langage horrible", en justifiant le choix du C pour le système de gestion de version Git 100
- Comment prendre en compte l'utilisateur dans vos applications ? Pour un développeur, « 90 % des utilisateurs sont des idiots » 229
- Quel est LE livre que tout développeur doit lire absolument ? Celui qui vous a le plus marqué et inspiré 96
- Apple cède et s'engage à payer des droits à Nokia, le conflit des brevets entre les deux firmes s'achève 158
- Nokia porte à nouveau plainte contre Apple pour violation de sept nouveaux brevets 158
- Quel est le code dont vous êtes le plus fier ? Pourquoi l'avez-vous écrit ? Et pourquoi vous a-t-il donné autant de satisfaction ? 83
- Le Draft final de la norme C++ 0X validé 181
Le Qt Quarterly au hasard
FAQ sur l'internationalisation
Communauté
Ressources
- 91 cours et tutoriels Qt
- F.A.Q. Qt : 200 questions et réponses
- 48 Qt Quarterly, 35 Qt Labs et 22 Qt DevNet en français
- 43 outils Qt
- 99 sources Qt
- 26 binaires Qt
- 6 livres Qt et 9 critiques
- La documentation de Qt 4.7 en français : 157 classes, 70 concepts et 24 modules
- 3 certifications Qt
Liens utiles
Contact
- Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).
Qt dans le magazine
| Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. | Qt 4.6 | |
| Copyright © 2012 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD. | ||
| Vous avez déniché une erreur ? Un bug ? Une redirection cassée ? Ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP ! | ||
Copyright © 2000-2012 - www.developpez.com