Blame docs/libs/html/gst-plugins-base-libs-Tags.html

Packit 971217
Packit 971217
<html>
Packit 971217
<head>
Packit 971217
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
Packit 971217
<title>Tags: GStreamer Base Plugins 1.0 Library Reference Manual</title>
Packit 971217
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
Packit 971217
<link rel="home" href="index.html" title="GStreamer Base Plugins 1.0 Library Reference Manual">
Packit 971217
<link rel="up" href="gstreamer-tag.html" title="Tag Support Library">
Packit 971217
<link rel="prev" href="gstreamer-tag.html" title="Tag Support Library">
Packit 971217
<link rel="next" href="gst-plugins-base-libs-GstVorbisTag.html" title="GstVorbisTag">
Packit 971217
<meta name="generator" content="GTK-Doc V1.27 (XML mode)">
Packit 971217
<link rel="stylesheet" href="style.css" type="text/css">
Packit 971217
</head>
Packit 971217
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
Packit 971217
Packit 971217
Packit 971217
Top  | 
Packit 971217
                  Description
Packit 971217
Packit 971217
Home
Packit 971217
Up
Packit 971217
Prev
Packit 971217
Next
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Tags

Packit 971217

Tags — additional tag definitions for plugins and applications

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Functions

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
void
Packit 971217
Packit 971217
Packit 971217
gst_tag_register_musicbrainz_tags ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
gchar *
Packit 971217
Packit 971217
Packit 971217
gst_tag_freeform_string_to_utf8 ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
gboolean
Packit 971217
Packit 971217
Packit 971217
gst_tag_parse_extended_comment ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
GstSample *
Packit 971217
Packit 971217
Packit 971217
gst_tag_image_data_to_image_sample ()
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Types and Values

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICBRAINZ_TRACKID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICBRAINZ_ARTISTID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICBRAINZ_ALBUMID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICBRAINZ_ALBUMARTISTID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICBRAINZ_TRMID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CDDA_CDDB_DISCID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CDDA_CDDB_DISCID_FULL
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CDDA_MUSICBRAINZ_DISCID
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CMML_CLIP
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CMML_HEAD
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CMML_STREAM
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_SHUTTER_SPEED
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_FOCAL_RATIO
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_FOCAL_LENGTH
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_ISO_SPEED
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_EXPOSURE_PROGRAM
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_EXPOSURE_MODE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_GAIN_ADJUSTMENT
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_WHITE_BALANCE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_CONTRAST
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_SATURATION
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_SHARPNESS
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_FLASH_FIRED
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_FLASH_MODE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_METERING_MODE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_SOURCE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_CAPTURING_EXPOSURE_COMPENSATION
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_IMAGE_HORIZONTAL_PPI
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_IMAGE_VERTICAL_PPI
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_ID3V2_HEADER_SIZE
Packit 971217
Packit 971217
Packit 971217
#define
Packit 971217
GST_TAG_MUSICAL_KEY
Packit 971217
Packit 971217
Packit 971217
enum
Packit 971217
GstTagImageType
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Includes

Packit 971217
#include <gst/tag/tag.h>
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Description

Packit 971217

Contains additional standardized GStreamer tag definitions for plugins

Packit 971217
and applications, and functions to register them with the GStreamer
Packit 971217
tag system.

Packit 971217
Packit 971217
Packit 971217

Functions

Packit 971217
Packit 971217

gst_tag_register_musicbrainz_tags ()

Packit 971217
void
Packit 971217
gst_tag_register_musicbrainz_tags (void);
Packit 971217

Registers additional musicbrainz-specific tags with the GStreamer tag

Packit 971217
system. Plugins and applications that use these tags should call this
Packit 971217
function before using them. Can be called multiple times.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_tag_freeform_string_to_utf8 ()

Packit 971217
gchar *
Packit 971217
gst_tag_freeform_string_to_utf8 (const gchar *data,
Packit 971217
                                 gint size,
Packit 971217
                                 const gchar **env_vars);
Packit 971217

Convenience function to read a string with unknown character encoding. If

Packit 971217
the string is already in UTF-8 encoding, it will be returned right away.
Packit 971217
If not it tries to detect byte-order-mark for UTF-16/32 cases and use that.
Packit 971217
Otherwise, the environment will be searched for a number of environment
Packit 971217
variables (whose names are specified in the NULL-terminated string array
Packit 971217
env_vars
Packit 971217
) containing a list of character encodings to try/use. If none
Packit 971217
are specified, the current locale will be tried. If that also doesn't work,
Packit 971217
WINDOWS-1252/ISO-8859-1 is assumed (which will almost always succeed).

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

data

Packit 971217

string data.

Packit 971217
[array length=size][element-type gchar]
Packit 971217
Packit 971217
Packit 971217

size

Packit 971217

length of string data, or -1 if the string is NUL-terminated

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

env_vars

Packit 971217

(array zero-terminated=1)

Packit 971217
a NULL-terminated string array of environment variable names, or NULL

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

a newly-allocated string in UTF-8 encoding, or NULL

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_tag_parse_extended_comment ()

Packit 971217
gboolean
Packit 971217
gst_tag_parse_extended_comment (const gchar *ext_comment,
Packit 971217
                                gchar **key,
Packit 971217
                                gchar **lang,
Packit 971217
                                gchar **value,
Packit 971217
                                gboolean fail_if_no_key);
Packit 971217

Convenience function to parse a GST_TAG_EXTENDED_COMMENT string and

Packit 971217
separate it into its components.

Packit 971217

If successful, key

Packit 971217
, lang
Packit 971217
 and/or value
Packit 971217
 will be set to newly allocated
Packit 971217
strings that you need to free with g_free() when done. key
Packit 971217
 and lang
Packit 971217
Packit 971217
may also be set to NULL by this function if there is no key or no language
Packit 971217
code in the extended comment string.

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

ext_comment

Packit 971217

an extended comment string, see GST_TAG_EXTENDED_COMMENT

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

key

Packit 971217

return location for the comment description key, or NULL.

Packit 971217
[out][nullable]
Packit 971217
Packit 971217
Packit 971217

lang

Packit 971217

return location for the comment ISO-639 language code, or NULL.

Packit 971217
[out][nullable]
Packit 971217
Packit 971217
Packit 971217

value

Packit 971217

return location for the actual comment string, or NULL.

Packit 971217
[out]
Packit 971217
Packit 971217
Packit 971217

fail_if_no_key

Packit 971217

whether to fail if strings are not in key=value form

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

TRUE if the string could be parsed, otherwise FALSE

Packit 971217
Packit 971217
Packit 971217

Packit 971217
Packit 971217

gst_tag_image_data_to_image_sample ()

Packit 971217
GstSample *
Packit 971217
gst_tag_image_data_to_image_sample (const guint8 *image_data,
Packit 971217
                                    guint image_data_len,
Packit 971217
                                    GstTagImageType image_type);
Packit 971217

Helper function for tag-reading plugins to create a GstSample suitable to

Packit 971217
add to a GstTagList as an image tag (such as GST_TAG_IMAGE or
Packit 971217
GST_TAG_PREVIEW_IMAGE) from the encoded image data and an (optional) image
Packit 971217
type.

Packit 971217

Background: cover art and other images in tags are usually stored as a

Packit 971217
blob of binary image data, often accompanied by a MIME type or some other
Packit 971217
content type string (e.g. 'png', 'jpeg', 'jpg'). Sometimes there is also an
Packit 971217
'image type' to indicate what kind of image this is (e.g. front cover,
Packit 971217
back cover, artist, etc.). The image data may also be an URI to the image
Packit 971217
rather than the image itself.

Packit 971217

In GStreamer, image tags are GstSamples containing the raw image

Packit 971217
data, with the sample caps describing the content type of the image
Packit 971217
(e.g. image/jpeg, image/png, text/uri-list). The sample info may contain
Packit 971217
an additional 'image-type' field of GST_TYPE_TAG_IMAGE_TYPE to describe
Packit 971217
the type of image (front cover, back cover etc.). GST_TAG_PREVIEW_IMAGE
Packit 971217
tags should not carry an image type, their type is already indicated via
Packit 971217
the special tag name.

Packit 971217

This function will do various checks and typefind the encoded image

Packit 971217
data (we can't trust the declared mime type).

Packit 971217
Packit 971217

Parameters

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

image_data

Packit 971217

the (encoded) image.

Packit 971217
[array length=image_data_len]
Packit 971217
Packit 971217
Packit 971217

image_data_len

Packit 971217

the length of the encoded image data at image_data

Packit 971217

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

image_type

Packit 971217

type of the image, or GST_TAG_IMAGE_TYPE_UNDEFINED. Pass

Packit 971217
GST_TAG_IMAGE_TYPE_NONE if no image type should be set at all (e.g.
Packit 971217
for preview images)

Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Returns

Packit 971217

a newly-allocated image sample for use in tag lists, or NULL

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

Types and Values

Packit 971217
Packit 971217

GST_TAG_MUSICBRAINZ_TRACKID

Packit 971217
#define GST_TAG_MUSICBRAINZ_TRACKID "musicbrainz-trackid"
Packit 971217
Packit 971217

MusicBrainz track ID

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_MUSICBRAINZ_ARTISTID

Packit 971217
#define GST_TAG_MUSICBRAINZ_ARTISTID "musicbrainz-artistid"
Packit 971217
Packit 971217

MusicBrainz artist ID

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_MUSICBRAINZ_ALBUMID

Packit 971217
#define GST_TAG_MUSICBRAINZ_ALBUMID "musicbrainz-albumid"
Packit 971217
Packit 971217

MusicBrainz album ID

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_MUSICBRAINZ_ALBUMARTISTID

Packit 971217
#define GST_TAG_MUSICBRAINZ_ALBUMARTISTID "musicbrainz-albumartistid"
Packit 971217
Packit 971217

MusicBrainz album artist ID

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_MUSICBRAINZ_TRMID

Packit 971217
#define GST_TAG_MUSICBRAINZ_TRMID "musicbrainz-trmid"
Packit 971217
Packit 971217

MusicBrainz track TRM ID

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CDDA_CDDB_DISCID

Packit 971217
#define GST_TAG_CDDA_CDDB_DISCID              "discid"
Packit 971217
Packit 971217

CDDB disc id in its short form (e.g. 'aa063d0f')

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CDDA_CDDB_DISCID_FULL

Packit 971217
#define GST_TAG_CDDA_CDDB_DISCID_FULL         "discid-full"
Packit 971217
Packit 971217

CDDB disc id including all details

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CDDA_MUSICBRAINZ_DISCID

Packit 971217
#define GST_TAG_CDDA_MUSICBRAINZ_DISCID       "musicbrainz-discid"
Packit 971217
Packit 971217

Musicbrainz disc id (e.g. 'ahg7JUcfR3vCYBphSDIogOOWrr0-')

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL

Packit 971217
#define GST_TAG_CDDA_MUSICBRAINZ_DISCID_FULL  "musicbrainz-discid-full"
Packit 971217
Packit 971217

Musicbrainz disc id details

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CMML_CLIP

Packit 971217
#define GST_TAG_CMML_CLIP "cmml-clip"
Packit 971217
Packit 971217

Annodex CMML clip element tag

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CMML_HEAD

Packit 971217
#define GST_TAG_CMML_HEAD "cmml-head"
Packit 971217
Packit 971217

Annodex CMML head element tag

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CMML_STREAM

Packit 971217
#define GST_TAG_CMML_STREAM "cmml-stream"
Packit 971217
Packit 971217

Annodex CMML stream element tag

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_SHUTTER_SPEED

Packit 971217
#define GST_TAG_CAPTURING_SHUTTER_SPEED        "capturing-shutter-speed"
Packit 971217
Packit 971217

Shutter speed used when capturing an image, in seconds. (fraction)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_FOCAL_RATIO

Packit 971217
#define GST_TAG_CAPTURING_FOCAL_RATIO          "capturing-focal-ratio"
Packit 971217
Packit 971217

Focal ratio (f-number) used when capturing an image. (double)

Packit 971217

The value stored is the denominator of the focal ratio (f-number).

Packit 971217
For example, if this tag value is 2, the focal ratio is f/2.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_FOCAL_LENGTH

Packit 971217
#define GST_TAG_CAPTURING_FOCAL_LENGTH         "capturing-focal-length"
Packit 971217
Packit 971217

Focal length used when capturing an image, in mm. (double)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO

Packit 971217
#define GST_TAG_CAPTURING_DIGITAL_ZOOM_RATIO   "capturing-digital-zoom-ratio"
Packit 971217
Packit 971217

Digital zoom ratio used when capturing an image. (double)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_ISO_SPEED

Packit 971217
#define GST_TAG_CAPTURING_ISO_SPEED           "capturing-iso-speed"
Packit 971217
Packit 971217

ISO speed used when capturing an image. (integer)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_EXPOSURE_PROGRAM

Packit 971217
#define GST_TAG_CAPTURING_EXPOSURE_PROGRAM     "capturing-exposure-program"
Packit 971217
Packit 971217

Type of exposure control used when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
  "undefined"
Packit 971217
  "manual"
Packit 971217
  "normal" - automatically controlled
Packit 971217
  "aperture-priority" - user selects aperture value
Packit 971217
  "shutter-priority" - user selects shutter speed
Packit 971217
  "creative" - biased towards depth of field
Packit 971217
  "action" - biased towards fast shutter speed
Packit 971217
  "portrait" - closeup, leaving background out of focus
Packit 971217
  "landscape" - landscape photos, background in focus

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_EXPOSURE_MODE

Packit 971217
#define GST_TAG_CAPTURING_EXPOSURE_MODE       "capturing-exposure-mode"
Packit 971217
Packit 971217

Exposure mode used when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
  "auto-exposure"
Packit 971217
  "manual-exposure"
Packit 971217
  "auto-bracket"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE

Packit 971217
#define GST_TAG_CAPTURING_SCENE_CAPTURE_TYPE  "capturing-scene-capture-type"
Packit 971217
Packit 971217

Scene mode used when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
  "standard"
Packit 971217
  "landscape"
Packit 971217
  "portrait"
Packit 971217
  "night-scene"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_GAIN_ADJUSTMENT

Packit 971217
#define GST_TAG_CAPTURING_GAIN_ADJUSTMENT     "capturing-gain-adjustment"
Packit 971217
Packit 971217

Gain adjustment applied to an image. (string)

Packit 971217

The allowed values are:

Packit 971217
  "none"
Packit 971217
  "low-gain-up"
Packit 971217
  "high-gain-up"
Packit 971217
  "low-gain-down"
Packit 971217
  "high-gain-down"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_WHITE_BALANCE

Packit 971217
#define GST_TAG_CAPTURING_WHITE_BALANCE       "capturing-white-balance"
Packit 971217
Packit 971217

White balance mode used when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
  "auto"
Packit 971217
  "manual"
Packit 971217
  "daylight"
Packit 971217
  "cloudy"
Packit 971217
  "tungsten"
Packit 971217
  "fluorescent"
Packit 971217
  "fluorescent h" (newer daylight-calibrated fluorescents)
Packit 971217
  "flash"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_CONTRAST

Packit 971217
#define GST_TAG_CAPTURING_CONTRAST            "capturing-contrast"
Packit 971217
Packit 971217

Direction of contrast processing applied when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
 "normal"
Packit 971217
 "soft"
Packit 971217
 "hard"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_SATURATION

Packit 971217
#define GST_TAG_CAPTURING_SATURATION          "capturing-saturation"
Packit 971217
Packit 971217

Direction of saturation processing applied when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
 "normal"
Packit 971217
 "low-saturation"
Packit 971217
 "high-saturation"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_SHARPNESS

Packit 971217
#define GST_TAG_CAPTURING_SHARPNESS          "capturing-sharpness"
Packit 971217
Packit 971217

Direction of sharpness processing applied when capturing an image. (string)

Packit 971217

The allowed values are:

Packit 971217
 "normal"
Packit 971217
 "soft"
Packit 971217
 "hard"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_FLASH_FIRED

Packit 971217
#define GST_TAG_CAPTURING_FLASH_FIRED         "capturing-flash-fired"
Packit 971217
Packit 971217

If flash was fired during the capture of an image. (boolean)

Packit 971217

Note that if this tag isn't present, it should not be assumed that

Packit 971217
the flash did not fire. It should be treated as unknown.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_FLASH_MODE

Packit 971217
#define GST_TAG_CAPTURING_FLASH_MODE         "capturing-flash-mode"
Packit 971217
Packit 971217

The flash mode selected during the capture of an image. (string)

Packit 971217

The allowed values are:

Packit 971217
 "auto"
Packit 971217
 "always"
Packit 971217
 "never"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_METERING_MODE

Packit 971217
#define GST_TAG_CAPTURING_METERING_MODE      "capturing-metering-mode"
Packit 971217
Packit 971217

Defines the way a camera determines the exposure. (string)

Packit 971217

The allowed values are:

Packit 971217
  "unknown"
Packit 971217
  "average"
Packit 971217
  "center-weighted-average"
Packit 971217
  "spot"
Packit 971217
  "multi-spot"
Packit 971217
  "pattern"
Packit 971217
  "partial"
Packit 971217
  "other"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_SOURCE

Packit 971217
#define GST_TAG_CAPTURING_SOURCE             "capturing-source"
Packit 971217
Packit 971217

Indicates the source of capture. The device/medium used to do the

Packit 971217
capture. (string)

Packit 971217

Allowed values are:

Packit 971217
  "dsc" (= digital still camera)
Packit 971217
  "transparent-scanner"
Packit 971217
  "reflex-scanner"
Packit 971217
  "other"

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_CAPTURING_EXPOSURE_COMPENSATION

Packit 971217
#define GST_TAG_CAPTURING_EXPOSURE_COMPENSATION "capturing-exposure-compensation"
Packit 971217
Packit 971217

Exposure compensation using when capturing an image in EV. (double)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_IMAGE_HORIZONTAL_PPI

Packit 971217
#define GST_TAG_IMAGE_HORIZONTAL_PPI         "image-horizontal-ppi"
Packit 971217
Packit 971217

Media (image/video) intended horizontal pixel density in ppi. (double)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_IMAGE_VERTICAL_PPI

Packit 971217
#define GST_TAG_IMAGE_VERTICAL_PPI           "image-vertical-ppi"
Packit 971217
Packit 971217

Media (image/video) intended vertical pixel density in ppi. (double)

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_ID3V2_HEADER_SIZE

Packit 971217
#define GST_TAG_ID3V2_HEADER_SIZE            10
Packit 971217
Packit 971217

ID3V2 header size considered minimum input for some functions such as

Packit 971217
gst_tag_list_from_id3v2_tag() and gst_tag_get_id3v2_tag_size() for example.

Packit 971217
Packit 971217

Packit 971217
Packit 971217

GST_TAG_MUSICAL_KEY

Packit 971217
#define GST_TAG_MUSICAL_KEY                   "musical-key"
Packit 971217
Packit 971217

Musical key in which the sound starts. It is represented as a string

Packit 971217
with a maximum length of three characters. The ground keys are
Packit 971217
represented with "A","B","C","D","E", "F" and "G" and halfkeys
Packit 971217
represented with "b" and "#". Minor is represented as "m" (e.g. "Dbm").
Packit 971217
Off key is represented with an "o" only.
Packit 971217
This notation might be extended in the future to support non-minor/major
Packit 971217
keys.

Packit 971217

Since: 1.2

Packit 971217
Packit 971217

Packit 971217
Packit 971217

enum GstTagImageType

Packit 971217

Type of image contained in an image tag (specified as "image-type" field in

Packit 971217
the info structure in the image's GstSample)

Packit 971217
Packit 971217

Members

Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_NONE

Packit 971217
Packit 971217

No image type. Can be used to

Packit 971217
     tell functions such as gst_tag_image_data_to_image_sample() that no
Packit 971217
     image type should be set.

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_UNDEFINED

Packit 971217
Packit 971217

Undefined/other image type

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_FRONT_COVER

Packit 971217
Packit 971217

Cover (front)

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_BACK_COVER

Packit 971217
Packit 971217

Cover (back)

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_LEAFLET_PAGE

Packit 971217
Packit 971217

Leaflet page

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_MEDIUM

Packit 971217
Packit 971217

Medium (e.g. label side of CD)

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_LEAD_ARTIST

Packit 971217
Packit 971217

Lead artist/lead performer/soloist

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_ARTIST

Packit 971217
Packit 971217

Artist/performer

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_CONDUCTOR

Packit 971217
Packit 971217

Conductor

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_BAND_ORCHESTRA

Packit 971217
Packit 971217

Band/orchestra

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_COMPOSER

Packit 971217
Packit 971217

Composer

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_LYRICIST

Packit 971217
Packit 971217

Lyricist/text writer

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_RECORDING_LOCATION

Packit 971217
Packit 971217

Recording location

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_DURING_RECORDING

Packit 971217
Packit 971217

During recording

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_DURING_PERFORMANCE

Packit 971217
Packit 971217

During performance

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_VIDEO_CAPTURE

Packit 971217
Packit 971217

Movie/video screen capture

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_FISH

Packit 971217
Packit 971217

A fish as funny as the ID3v2 spec

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_ILLUSTRATION

Packit 971217
Packit 971217

Illustration

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_BAND_ARTIST_LOGO

Packit 971217
Packit 971217

Band/artist logotype

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217

GST_TAG_IMAGE_TYPE_PUBLISHER_STUDIO_LOGO

Packit 971217
Packit 971217

Publisher/studio logotype

Packit 971217
Packit 971217
 
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217
Packit 971217

See Also

Packit 971217

GstTagList

Packit 971217
Packit 971217
Packit 971217
Packit 971217

Generated by GTK-Doc V1.27
Packit 971217
</body>
Packit 971217
</html>