Top |
Description
GDataMediaThumbnail represents a "thumbnail" element from the
Media RSS specification.The class only implements parsing, not XML output, at the moment.
Functions
gdata_media_thumbnail_get_uri ()
const gchar *
gdata_media_thumbnail_get_uri (GDataMediaThumbnail *self
);
Gets the “uri” property.
Since: 0.4.0
gdata_media_thumbnail_get_height ()
guint
gdata_media_thumbnail_get_height (GDataMediaThumbnail *self
);
Gets the “height” property.
Since: 0.4.0
gdata_media_thumbnail_get_width ()
guint
gdata_media_thumbnail_get_width (GDataMediaThumbnail *self
);
Gets the “width” property.
Since: 0.4.0
gdata_media_thumbnail_get_time ()
gint64
gdata_media_thumbnail_get_time (GDataMediaThumbnail *self
);
Gets the “time” property.
Since: 0.4.0
gdata_media_thumbnail_download ()
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.
Parameters
self |
||
service |
the GDataService |
|
cancellable |
a GCancellable for the entire download stream, or |
[allow-none] |
error |
Returns
a GDataDownloadStream to download the thumbnail with, or NULL
; unref with g_object_unref()
.
[transfer full]
Since: 0.8.0
Types and Values
GDataMediaThumbnail
typedef struct _GDataMediaThumbnail GDataMediaThumbnail;
All the fields in the GDataMediaThumbnail structure are private and should never be accessed directly.
GDataMediaThumbnailClass
typedef struct { } GDataMediaThumbnailClass;
All the fields in the GDataMediaThumbnailClass structure are private and should never be accessed directly.
Since: 0.4.0
Property Details
The “height”
property
“height” guint
The height of the thumbnail, in pixels.
For more information, see the Media RSS specification.
Flags: Read
Default value: 0
Since: 0.4.0
The “time”
property
“time” gint64
The time offset of the thumbnail in relation to the media object, in milliseconds.
For more information, see the Media RSS specification.
Flags: Read
Allowed values: >= -1
Default value: -1
Since: 0.4.0
The “uri”
property
“uri” gchar *
The URI of the thumbnail.
For more information, see the Media RSS specification.
Flags: Read
Default value: NULL
Since: 0.4.0
The “width”
property
“width” guint
The width of the thumbnail, in pixels.
For more information, see the Media RSS specification.
Flags: Read
Default value: 0
Since: 0.4.0