| Top |
gboolean (*PopplerMediaSaveFunc) (const gchar *buf,gsize count,gpointer data,GError **error);
Specifies the type of the function passed to
poppler_media_save_to_callback(). It is called once for each block of
bytes that is "written" by poppler_media_save_to_callback(). If
successful it should return TRUE. If an error occurs it should set
error
and return FALSE, in which case poppler_media_save_to_callback()
will fail with the same error.
buf |
buffer containing bytes to be written. |
[array length=count][element-type guint8] |
count |
number of bytes in |
|
data |
user data passed to |
[closure] |
error |
GError to set on error, or |
Since: 0.14
gboolean
poppler_media_get_auto_play (PopplerMedia *poppler_media);
Returns the auto-play parameter.
Since: 20.04.0
const gchar *
poppler_media_get_filename (PopplerMedia *poppler_media);
Returns the media clip filename, in case of non-embedded media. filename might be a local relative or absolute path or a URI
Since: 0.14
const gchar *
poppler_media_get_mime_type (PopplerMedia *poppler_media);
Returns the media clip mime-type
Since: 0.14
gfloat
poppler_media_get_repeat_count (PopplerMedia *poppler_media);
Returns the repeat count parameter.
Since: 20.04.0
gboolean
poppler_media_get_show_controls (PopplerMedia *poppler_media);
Returns the show controls parameter.
Since: 20.04.0
gboolean
poppler_media_is_embedded (PopplerMedia *poppler_media);
Whether the media clip is embedded in the PDF. If the result is TRUE, the embedded stream
can be saved with poppler_media_save() or poppler_media_save_to_callback() function.
If the result is FALSE, the media clip filename can be retrieved with
poppler_media_get_filename() function.
Since: 0.14
gboolean poppler_media_save (PopplerMedia *poppler_media,const char *filename,GError **error);
Saves embedded stream of poppler_media
to a file indicated by filename
.
If error
is set, FALSE will be returned.
Possible errors include those in the G_FILE_ERROR domain
and whatever the save function generates.
poppler_media |
||
filename |
name of file to save |
|
error |
return location for error, or |
[allow-none] |
Since: 0.14
gboolean poppler_media_save_to_fd (PopplerMedia *poppler_media,int fd,GError **error);
Saves embedded stream of poppler_media
to a file referred to by fd
.
If error
is set, FALSE will be returned.
Possible errors include those in the G_FILE_ERROR domain
and whatever the save function generates.
Note that this function takes ownership of fd
; you must not operate on it
again, nor close it.
poppler_media |
||
fd |
a valid file descriptor open for writing |
|
error |
return location for error, or |
[allow-none] |
Since: 21.12.0
gboolean poppler_media_save_to_callback (PopplerMedia *poppler_media,PopplerMediaSaveFunc save_func,gpointer user_data,GError **error);
Saves embedded stream of poppler_media
by feeding the produced data to save_func
. Can be used
when you want to store the media clip stream to something other than a file, such as
an in-memory buffer or a socket. If error
is set, FALSE will be
returned. Possible errors include those in the G_FILE_ERROR domain and
whatever the save function generates.
poppler_media |
||
save_func |
a function that is called to save each block of data that the save routine generates. |
[scope call] |
user_data |
user data to pass to the save function. |
|
error |
return location for error, or |
[allow-none] |
Since: 0.14