<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html>
<html lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<!-- qmediametadata.cpp -->
<title>QMediaMetaData Namespace | Qt Multimedia 5.12.6</title>
<link rel="stylesheet" type="text/css" href="style/offline-simple.css" />
<script type="text/javascript">
document.getElementsByTagName("link").item(0).setAttribute("href", "style/offline.css");
// loading style sheet breaks anchors that were jumped to before
// so force jumping to anchor again
setTimeout(function() {
var anchor = location.hash;
// need to jump to different anchor first (e.g. none)
location.hash = "#";
setTimeout(function() {
location.hash = anchor;
}, 0);
}, 0);
</script>
</head>
<body>
<div class="header" id="qtdocheader">
<div class="main">
<div class="main-rounded">
<div class="navigationbar">
<table><tr>
<td >Qt 5.12</td><td ><a href="qtmultimedia-index.html">Qt Multimedia</a></td><td >QMediaMetaData Namespace</td></tr></table><table class="buildversion"><tr>
<td id="buildversion" width="100%" align="right"><a href="qtmultimedia-index.html">Qt 5.12.6 Reference Documentation</a></td>
</tr></table>
</div>
</div>
<div class="content">
<div class="line">
<div class="content mainContent">
<div class="sidebar">
<div class="toc">
<h3><a name="toc">Contents</a></h3>
<ul>
<li class="level1"><a href="#details">Detailed Description</a></li>
</ul>
</div>
<div class="sidebar-content" id="sidebar-content"></div></div>
<h1 class="title">QMediaMetaData Namespace</h1>
<!-- $$$QMediaMetaData-brief -->
<p>Provides identifiers for meta-data attributes. <a href="#details">More...</a></p>
<!-- @@@QMediaMetaData -->
<div class="table"><table class="alignedsummary">
<tr><td class="memItemLeft rightAlign topAlign"> Header:</td><td class="memItemRight bottomAlign"> <span class="preprocessor">#include <QMediaMetaData></span>
</td></tr><tr><td class="memItemLeft rightAlign topAlign"> qmake:</td><td class="memItemRight bottomAlign"> QT += multimedia</td></tr></table></div><ul>
</ul>
<a name="details"></a>
<!-- $$$QMediaMetaData-description -->
<div class="descr">
<h2 id="details">Detailed Description</h2>
<p>Provides identifiers for meta-data attributes.</p>
<p><b>Note: </b>Not all identifiers are supported on all platforms. Please consult vendor documentation for specific support on different platforms.</p><div class="table"><table class="generic" width="60%">
<thead><tr class="qt-style"><th colspan="3">Common attributes</th></tr>
<tr class="qt-style"><th >Value</th><th >Description</th><th >Type</th></tr></thead>
<tr valign="top" class="odd"><td >Title</td><td >The title of the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#SubTitle-var">SubTitle</a></td><td >The sub-title of the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Author</td><td >The authors of the media.</td><td >QStringList</td></tr>
<tr valign="top" class="even"><td >Comment</td><td >A user comment about the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Description</td><td >A description of the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >Category</td><td >The category of the media.</td><td >QStringList</td></tr>
<tr valign="top" class="odd"><td >Genre</td><td >The genre of the media.</td><td >QStringList</td></tr>
<tr valign="top" class="even"><td >Year</td><td >The year of release of the media.</td><td >int</td></tr>
<tr valign="top" class="odd"><td >Date</td><td >The date of the media.</td><td >QDate.</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#UserRating-var">UserRating</a></td><td >A user rating of the media.</td><td >int [0..100]</td></tr>
<tr valign="top" class="odd"><td >Keywords</td><td >A list of keywords describing the media.</td><td >QStringList</td></tr>
<tr valign="top" class="even"><td >Language</td><td >The language of media, as an ISO 639-2 code.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Publisher</td><td >The publisher of the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >Copyright</td><td >The media's copyright notice.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#ParentalRating-var">ParentalRating</a></td><td >The parental rating of the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#RatingOrganization-var">RatingOrganization</a></td><td >The organization responsible for the parental rating of the media.</td><td >QString</td></tr>
<thead><tr class="qt-style"><th colspan="3">Media attributes</th></tr></thead>
<tr valign="top" class="odd"><td >Size</td><td >The size in bytes of the media.</td><td >qint64</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#MediaType-var">MediaType</a></td><td >The type of the media (audio, video, etc).</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Duration</td><td >The duration in millseconds of the media.</td><td >qint64</td></tr>
<thead><tr class="qt-style"><th colspan="3">Audio attributes</th></tr></thead>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#AudioBitRate-var">AudioBitRate</a></td><td >The bit rate of the media's audio stream in bits per second.</td><td >int</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#AudioCodec-var">AudioCodec</a></td><td >The codec of the media's audio stream.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#AverageLevel-var">AverageLevel</a></td><td >The average volume level of the media.</td><td >int</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#ChannelCount-var">ChannelCount</a></td><td >The number of channels in the media's audio stream.</td><td >int</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#PeakValue-var">PeakValue</a></td><td >The peak volume of the media's audio stream.</td><td >int</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#SampleRate-var">SampleRate</a></td><td >The sample rate of the media's audio stream in hertz.</td><td >int</td></tr>
<thead><tr class="qt-style"><th colspan="3">Music attributes</th></tr></thead>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#AlbumTitle-var">AlbumTitle</a></td><td >The title of the album the media belongs to.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#AlbumArtist-var">AlbumArtist</a></td><td >The principal artist of the album the media belongs to.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#ContributingArtist-var">ContributingArtist</a></td><td >The artists contributing to the media.</td><td >QStringList</td></tr>
<tr valign="top" class="odd"><td >Composer</td><td >The composer of the media.</td><td >QStringList</td></tr>
<tr valign="top" class="even"><td >Conductor</td><td >The conductor of the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Lyrics</td><td >The lyrics to the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >Mood</td><td >The mood of the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#TrackNumber-var">TrackNumber</a></td><td >The track number of the media.</td><td >int</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#TrackCount-var">TrackCount</a></td><td >The number of tracks on the album containing the media.</td><td >int</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#CoverArtUrlSmall-var">CoverArtUrlSmall</a></td><td >The URL of a small cover art image.</td><td >QUrl</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#CoverArtUrlLarge-var">CoverArtUrlLarge</a></td><td >The URL of a large cover art image.</td><td >QUrl</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#CoverArtImage-var">CoverArtImage</a></td><td >An embedded cover art image.</td><td >QImage</td></tr>
<thead><tr class="qt-style"><th colspan="3">Image and video attributes</th></tr></thead>
<tr valign="top" class="even"><td >Resolution</td><td >The dimensions of an image or video.</td><td >QSize</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#PixelAspectRatio-var">PixelAspectRatio</a></td><td >The pixel aspect ratio of an image or video.</td><td >QSize</td></tr>
<thead><tr class="qt-style"><th colspan="3">Video attributes</th></tr></thead>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#VideoFrameRate-var">VideoFrameRate</a></td><td >The frame rate of the media's video stream.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#VideoBitRate-var">VideoBitRate</a></td><td >The bit rate of the media's video stream in bits per second.</td><td >int</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#VideoCodec-var">VideoCodec</a></td><td >The codec of the media's video stream.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#PosterUrl-var">PosterUrl</a></td><td >The URL of a poster image.</td><td >QUrl</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#PosterImage-var">PosterImage</a></td><td >An embedded poster image.</td><td >QImage</td></tr>
<thead><tr class="qt-style"><th colspan="3">Movie attributes</th></tr></thead>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#ChapterNumber-var">ChapterNumber</a></td><td >The chapter number of the media.</td><td >int</td></tr>
<tr valign="top" class="even"><td >Director</td><td >The director of the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#LeadPerformer-var">LeadPerformer</a></td><td >The lead performer in the media.</td><td >QStringList</td></tr>
<tr valign="top" class="even"><td >Writer</td><td >The writer of the media.</td><td >QStringList</td></tr>
<thead><tr class="qt-style"><th colspan="3">Photo attributes.</th></tr></thead>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#CameraManufacturer-var">CameraManufacturer</a></td><td >The manufacturer of the camera used to capture the media.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#CameraModel-var">CameraModel</a></td><td >The model of the camera used to capture the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Event</td><td >The event during which the media was captured.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >Subject</td><td >The subject of the media.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td >Orientation</td><td >Orientation of image.</td><td >int (degrees)</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#ExposureTime-var">ExposureTime</a></td><td >Exposure time, given in seconds.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#FNumber-var">FNumber</a></td><td >The F Number.</td><td >int</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#ExposureProgram-var">ExposureProgram</a></td><td >The class of the program used by the camera to set exposure when the picture is taken.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#ISOSpeedRatings-var">ISOSpeedRatings</a></td><td >Indicates the ISO Speed and ISO Latitude of the camera or input device as specified in ISO 12232.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#ExposureBiasValue-var">ExposureBiasValue</a></td><td >The exposure bias. The unit is the APEX (Additive System of Photographic Exposure) setting.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#DateTimeOriginal-var">DateTimeOriginal</a></td><td >The date and time when the original image data was generated.</td><td >QDateTime</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#DateTimeDigitized-var">DateTimeDigitized</a></td><td >The date and time when the image was stored as digital data.</td><td >QDateTime</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#SubjectDistance-var">SubjectDistance</a></td><td >The distance to the subject, given in meters.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#MeteringMode-var">MeteringMode</a></td><td >The metering mode.</td><td ><a href="qcameraexposure.html#MeteringMode-enum">QCameraExposure::MeteringMode</a></td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#LightSource-var">LightSource</a></td><td >The kind of light source.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >Flash</td><td >Status of flash when the image was shot.</td><td ><a href="qcameraexposure.html#FlashMode-enum">QCameraExposure::FlashMode</a></td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#FocalLength-var">FocalLength</a></td><td >The actual focal length of the lens, in mm.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#ExposureMode-var">ExposureMode</a></td><td >Indicates the exposure mode set when the image was shot.</td><td ><a href="qcameraexposure.html#ExposureMode-enum">QCameraExposure::ExposureMode</a></td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#WhiteBalance-var">WhiteBalance</a></td><td >Indicates the white balance mode set when the image was shot.</td><td ><a href="qcameraimageprocessing.html#WhiteBalanceMode-enum">QCameraImageProcessing::WhiteBalanceMode</a></td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#DigitalZoomRatio-var">DigitalZoomRatio</a></td><td >Indicates the digital zoom ratio when the image was shot.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#FocalLengthIn35mmFilm-var">FocalLengthIn35mmFilm</a></td><td >Indicates the equivalent focal length assuming a 35mm film camera, in mm.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#SceneCaptureType-var">SceneCaptureType</a></td><td >Indicates the type of scene that was shot. It can also be used to record the mode in which the image was shot.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GainControl-var">GainControl</a></td><td >Indicates the degree of overall image gain adjustment.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td >Contrast</td><td >Indicates the direction of contrast processing applied by the camera when the image was shot.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td >Saturation</td><td >Indicates the direction of saturation processing applied by the camera when the image was shot.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td >Sharpness</td><td >Indicates the direction of sharpness processing applied by the camera when the image was shot.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#DeviceSettingDescription-var">DeviceSettingDescription</a></td><td >Exif tag, indicates information on the picture-taking conditions of a particular camera model.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSLatitude-var">GPSLatitude</a></td><td >Latitude value of the geographical position (decimal degrees). A positive latitude indicates the Northern Hemisphere, and a negative latitude indicates the Southern Hemisphere.</td><td >double</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSLongitude-var">GPSLongitude</a></td><td >Longitude value of the geographical position (decimal degrees). A positive longitude indicates the Eastern Hemisphere, and a negative longitude indicates the Western Hemisphere.</td><td >double</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSAltitude-var">GPSAltitude</a></td><td >The value of altitude in meters above sea level.</td><td >double</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSTimeStamp-var">GPSTimeStamp</a></td><td >Time stamp of GPS data.</td><td >QDateTime</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSSatellites-var">GPSSatellites</a></td><td >GPS satellites used for measurements.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSStatus-var">GPSStatus</a></td><td >Status of GPS receiver at image creation time.</td><td >QString</td></tr>
<tr valign="top" class="even"><td >GPSDOP</td><td >Degree of precision for GPS data.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSSpeed-var">GPSSpeed</a></td><td >Speed of GPS receiver movement in kilometers per hour.</td><td >qreal</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSTrack-var">GPSTrack</a></td><td >Direction of GPS receiver movement. The range of values is [0.0, 360), with 0 direction pointing on either true or magnetic north, depending on <a href="qmediametadata.html#GPSTrackRef-var">GPSTrackRef</a>.</td><td >qreal</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSTrackRef-var">GPSTrackRef</a></td><td >Reference for movement direction.</td><td >QChar. 'T' means true direction and 'M' is magnetic direction.</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSImgDirection-var">GPSImgDirection</a></td><td >Direction of image when captured.</td><td >qreal The range of values is [0.0, 360).</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSImgDirectionRef-var">GPSImgDirectionRef</a></td><td >Reference for image direction.</td><td >QChar. 'T' means true direction and 'M' is magnetic direction.</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSMapDatum-var">GPSMapDatum</a></td><td >Geodetic survey data used by the GPS receiver.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#GPSProcessingMethod-var">GPSProcessingMethod</a></td><td >The name of the method used for location finding.</td><td >QString</td></tr>
<tr valign="top" class="even"><td ><a href="qmediametadata.html#GPSAreaInformation-var">GPSAreaInformation</a></td><td >The name of the GPS area.</td><td >QString</td></tr>
<tr valign="top" class="odd"><td ><a href="qmediametadata.html#ThumbnailImage-var">ThumbnailImage</a></td><td >An embedded thumbnail image.</td><td >QImage</td></tr>
</table></div>
</div>
<!-- @@@QMediaMetaData -->
</div>
</div>
</div>
</div>
</div>
<div class="footer">
<p>
<acronym title="Copyright">©</acronym> 2019 The Qt Company Ltd.
Documentation contributions included herein are the copyrights of
their respective owners.<br/> The documentation provided herein is licensed under the terms of the <a href="http://www.gnu.org/licenses/fdl.html">GNU Free Documentation License version 1.3</a> as published by the Free Software Foundation.<br/> Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property
of their respective owners. </p>
</div>
</body>
</html>
