Miscellaneous

Miscellaneous — Miscellaneous functions.

Synopsis




                    flickcurl_size;
void                flickcurl_free_size                 (flickcurl_size *size);
void                flickcurl_free_sizes                (flickcurl_size **sizes_object);
void                flickcurl_free_location             (flickcurl_location *location);
void                flickcurl_free_perms                (flickcurl_perms *perms);
const char*         flickcurl_get_field_value_type_label
                                                        (flickcurl_field_value_type datatype);
const char*         flickcurl_get_location_accuracy_label
                                                        (int accuracy);
const char*         flickcurl_get_shared_secret         (flickcurl *fc);
flickcurl_photo**   flickcurl_interestingness_getList   (flickcurl *fc,
                                                         const char *date,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
                    flickcurl_license;

Description

Miscellaneous functions.

Details

flickcurl_size

typedef struct {
  char *label;
  int width;
  int height;
  char *source;
  char *url;
} flickcurl_size;

A photo at a size.

char *label;

label

int width;

width in pixels

int height;

height in pixels

char *source;

raw image source URL

char *url;

url of photo page

flickcurl_free_size ()

void                flickcurl_free_size                 (flickcurl_size *size);

Destructor for size object

size :

size object

flickcurl_free_sizes ()

void                flickcurl_free_sizes                (flickcurl_size **sizes_object);

Destructor for array of size objects

sizes_object :

size object array

flickcurl_free_location ()

void                flickcurl_free_location             (flickcurl_location *location);

Destructor for location object

location :

location object

flickcurl_free_perms ()

void                flickcurl_free_perms                (flickcurl_perms *perms);

Destructor for perms object

perms :

perms object

flickcurl_get_field_value_type_label ()

const char*         flickcurl_get_field_value_type_label
                                                        (flickcurl_field_value_type datatype);

Get label for datatype

datatype :

datatype enum

Returns :

label string or NULL if none valid

flickcurl_get_location_accuracy_label ()

const char*         flickcurl_get_location_accuracy_label
                                                        (int accuracy);

Get label for an accuracy

accuracy :

accuracy

Returns :

label string or NULL if none valid

flickcurl_get_shared_secret ()

const char*         flickcurl_get_shared_secret         (flickcurl *fc);

Get current Shared Secret

fc :

flickcurl object

Returns :

shared secret or NULL if none set

flickcurl_interestingness_getList ()

flickcurl_photo**   flickcurl_interestingness_getList   (flickcurl *fc,
                                                         const char *date,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);

Returns the list of interesting photos for the most recent day or a user-specified date.

Implements flickr.interestingness.getList (0.13)

fc :

flickcurl context

date :

A specific date, formatted as YYYY-MM-DD, to return interesting photos for. (or NULL)

extras :

A comma-delimited list of extra information to fetch for each returned record. Currently supported fields are: license, date_upload, date_taken, owner_name, icon_server, original_format, last_update, geo, tags, machine_tags. (or NULL)

per_page :

Number of photos to return per page default 100, max 500

page :

The page of results to return, default 1

Returns :

non-0 on failure

flickcurl_license

typedef struct {
  /* license id */
  int id;
  /* license url or NULL if none */
  char *url;
  /* license name */
  char *name;
} flickcurl_license;

A photo license.

int id;

license ID

char *url;

license URL

char *name;

license short name