| GData Reference Manual | ||||
|---|---|---|---|---|
| Top | Description | Object Hierarchy | Properties | ||||
#include <gdata/media/gdata-media-thumbnail.h>
GDataMediaThumbnail;
GDataMediaThumbnailClass;
const gchar * gdata_media_thumbnail_get_uri (GDataMediaThumbnail *self);
guint gdata_media_thumbnail_get_height (GDataMediaThumbnail *self);
guint gdata_media_thumbnail_get_width (GDataMediaThumbnail *self);
gint64 gdata_media_thumbnail_get_time (GDataMediaThumbnail *self);
GDataDownloadStream * gdata_media_thumbnail_download (GDataMediaThumbnail *self,
GDataService *service,
GCancellable *cancellable,
GError **error);
GDataMediaThumbnail represents a "thumbnail" element from the Media RSS specification.
The class only implements parsing, not XML output, at the moment.
typedef struct _GDataMediaThumbnail GDataMediaThumbnail;
All the fields in the GDataMediaThumbnail structure are private and should never be accessed directly.
typedef struct {
} GDataMediaThumbnailClass;
All the fields in the GDataMediaThumbnailClass structure are private and should never be accessed directly.
Since 0.4.0
const gchar * gdata_media_thumbnail_get_uri (GDataMediaThumbnail *self);
Gets the "uri" property.
|
a GDataMediaThumbnail |
Returns : |
the thumbnail's URI |
Since 0.4.0
guint gdata_media_thumbnail_get_height (GDataMediaThumbnail *self);
Gets the "height" property.
|
a GDataMediaThumbnail |
Returns : |
the thumbnail's height in pixels, or 0
|
Since 0.4.0
guint gdata_media_thumbnail_get_width (GDataMediaThumbnail *self);
Gets the "width" property.
|
a GDataMediaThumbnail |
Returns : |
the thumbnail's width in pixels, or 0
|
Since 0.4.0
gint64 gdata_media_thumbnail_get_time (GDataMediaThumbnail *self);
Gets the "time" property.
|
a GDataMediaThumbnail |
Returns : |
the thumbnail's time offset in the media, or -1
|
Since 0.4.0
GDataDownloadStream * gdata_media_thumbnail_download (GDataMediaThumbnail *self,GDataService *service,GCancellable *cancellable,GError **error);
Downloads and returns a GDataDownloadStream allowing the thumbnail data represented by self to be read.
To get the content type of the downloaded data, gdata_download_stream_get_content_type() can be called on the returned GDataDownloadStream.
Calling gdata_download_stream_get_content_length() on the stream will not return a meaningful result, however, as the stream is encoded in chunks,
rather than by content length.
In order to cancel the download, a GCancellable passed in to cancellable must be cancelled using g_cancellable_cancel(). Cancelling the individual
GInputStream operations on the GDataDownloadStream will not cancel the entire download; merely the read or close operation in question. See the
"cancellable" for more details.
|
a GDataMediaThumbnail |
|
the GDataService |
|
a GCancellable for the entire download stream, or NULL. [allow-none]
|
|
a GError, or NULL
|
Returns : |
a GDataDownloadStream to download the thumbnail with, or NULL; unref with g_object_unref(). [transfer full]
|
Since 0.8.0
"height" property"height" guint : Read
The height of the thumbnail, in pixels.
For more information, see the Media RSS specification.
Default value: 0
Since 0.4.0
"time" property"time" gint64 : Read
The time offset of the thumbnail in relation to the media object, in milliseconds.
For more information, see the Media RSS specification.
Allowed values: >= -1
Default value: -1
Since 0.4.0
"uri" property"uri" gchar* : Read
The URI of the thumbnail.
For more information, see the Media RSS specification.
Default value: NULL
Since 0.4.0
"width" property"width" guint : Read
The width of the thumbnail, in pixels.
For more information, see the Media RSS specification.
Default value: 0
Since 0.4.0