libgphoto2 photo camera library (libgphoto2) API
2.5.1
|
#include "config.h"
#include <gphoto2/gphoto2-file.h>
#include <stdlib.h>
#include <stdio.h>
#include <errno.h>
#include <unistd.h>
#include <string.h>
#include <sys/stat.h>
#include <utime.h>
#include <gphoto2/gphoto2-port-log.h>
#include <gphoto2/gphoto2-port-portability.h>
#include <gphoto2/gphoto2-result.h>
Data Structures | |
struct | _CameraFile |
Macros | |
#define | _POSIX_SOURCE |
#define | _BSD_SOURCE |
#define | CHECK_NULL(r) {if (!(r)) return (GP_ERROR_BAD_PARAMETERS);} |
#define | CHECK_RESULT(result) {int r = (result); if (r < 0) return (r);} |
#define | CHECK_MEM(m) {if (!(m)) return (GP_ERROR_NO_MEMORY);} |
#define | MAX_PATH 256 |
Functions | |
int | gp_file_new (CameraFile **file) |
int | gp_file_new_from_fd (CameraFile **file, int fd) |
int | gp_file_new_from_handler (CameraFile **file, CameraFileHandler *handler, void *private) |
int | gp_file_free (CameraFile *file) |
descruct a CameraFile object. More... | |
int | gp_file_ref (CameraFile *file) |
Increase reference counter for CameraFile object. More... | |
int | gp_file_unref (CameraFile *file) |
Decrease reference counter for CameraFile object. More... | |
int | gp_file_append (CameraFile *file, const char *data, unsigned long int size) |
int | gp_file_slurp (CameraFile *file, char *data, size_t size, size_t *readlen) |
int | gp_file_set_data_and_size (CameraFile *file, char *data, unsigned long int size) |
int | gp_file_get_data_and_size (CameraFile *file, const char **data, unsigned long int *size) |
int | gp_file_save (CameraFile *file, const char *filename) |
int | gp_file_open (CameraFile *file, const char *filename) |
int | gp_file_clean (CameraFile *file) |
int | gp_file_copy (CameraFile *destination, CameraFile *source) |
int | gp_file_get_name (CameraFile *file, const char **name) |
int | gp_file_get_name_by_type (CameraFile *file, const char *basename, CameraFileType type, char **newname) |
int | gp_file_get_mime_type (CameraFile *file, const char **mime_type) |
int | gp_file_set_name (CameraFile *file, const char *name) |
int | gp_file_set_mime_type (CameraFile *file, const char *mime_type) |
int | gp_file_detect_mime_type (CameraFile *file) |
int | gp_file_adjust_name_for_mime_type (CameraFile *file) |
int | gp_file_get_mtime (CameraFile *file, time_t *mtime) |
int | gp_file_set_mtime (CameraFile *file, time_t mtime) |
int gp_file_adjust_name_for_mime_type | ( | CameraFile * | file | ) |
file | a CameraFile |
int gp_file_append | ( | CameraFile * | file, |
const char * | data, | ||
unsigned long int | size | ||
) |
file | a CameraFile |
data | |
size |
int gp_file_clean | ( | CameraFile * | file | ) |
file | a CameraFile |
int gp_file_copy | ( | CameraFile * | destination, |
CameraFile * | source | ||
) |
destination | a CameraFile |
source | a CameraFile |
int gp_file_detect_mime_type | ( | CameraFile * | file | ) |
file | a CameraFile |
int gp_file_free | ( | CameraFile * | file | ) |
int gp_file_get_data_and_size | ( | CameraFile * | file, |
const char ** | data, | ||
unsigned long int * | size | ||
) |
Get a pointer to the data and the file's size.
file | a CameraFile |
data | |
size |
Both data and size can be NULL and will then be ignored.
The pointer to data that is returned is still owned by libgphoto2 and its lifetime is the same as the #file.
int gp_file_get_mime_type | ( | CameraFile * | file, |
const char ** | mime_type | ||
) |
file | a CameraFile |
mime_type | a pointer to a MIME type string |
int gp_file_get_mtime | ( | CameraFile * | file, |
time_t * | mtime | ||
) |
file | a CameraFile |
mtime |
int gp_file_get_name | ( | CameraFile * | file, |
const char ** | name | ||
) |
file | a CameraFile |
name | a pointer to a name string |
int gp_file_get_name_by_type | ( | CameraFile * | file, |
const char * | basename, | ||
CameraFileType | type, | ||
char ** | newname | ||
) |
file | a CameraFile |
basename | the basename of the file |
type | the gphoto type of the file |
newname | the new name generated |
This function takes the basename and generates a filename out of it depending on the gphoto filetype and the mime type in the file. The gphoto filetype will be converted to a prefix, like thumb_ or raw_, the mimetype will replace the current suffix by a different one (if necessary).
This can be used so that saving thumbnails or metadata will not overwrite the normal files.
int gp_file_new | ( | CameraFile ** | file | ) |
int gp_file_new_from_fd | ( | CameraFile ** | file, |
int | fd | ||
) |
Create new CameraFile object from a UNIX filedescriptor.
file | a pointer to a CameraFile |
fd | a UNIX filedescriptor |
int gp_file_new_from_handler | ( | CameraFile ** | file, |
CameraFileHandler * | handler, | ||
void * | private | ||
) |
Create new CameraFile object using a programmatic handler.
file | a pointer to a CameraFile |
handler | a #CameraFileHandler |
private | a private pointer for frontend use |
int gp_file_open | ( | CameraFile * | file, |
const char * | filename | ||
) |
file | a CameraFile |
filename |
int gp_file_ref | ( | CameraFile * | file | ) |
Increase reference counter for CameraFile object.
file | a CameraFile |
int gp_file_save | ( | CameraFile * | file, |
const char * | filename | ||
) |
file | a CameraFile |
filename |
int gp_file_set_data_and_size | ( | CameraFile * | file, |
char * | data, | ||
unsigned long int | size | ||
) |
file | a CameraFile |
data | |
size |
int gp_file_set_mime_type | ( | CameraFile * | file, |
const char * | mime_type | ||
) |
file | a CameraFile |
mime_type | a MIME type string |
int gp_file_set_mtime | ( | CameraFile * | file, |
time_t | mtime | ||
) |
file | a CameraFile |
mtime |
int gp_file_set_name | ( | CameraFile * | file, |
const char * | name | ||
) |
file | a CameraFile |
name | a pointer to a MIME type string |
int gp_file_slurp | ( | CameraFile * | file, |
char * | data, | ||
size_t | size, | ||
size_t * | readlen | ||
) |
int gp_file_unref | ( | CameraFile * | file | ) |
Decrease reference counter for CameraFile object.
file | a CameraFile |