|  |  | Flickcurl Flickr API Manual |  | |
|---|---|---|---|---|
| Top | Description | ||||
flickcurl_location; flickcurl_perms; 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); flickcurl_photo ** flickcurl_interestingness_getList (flickcurl *fc,const char *date,const char *extras,int per_page,int page); flickcurl_photos_list * flickcurl_interestingness_getList_params (flickcurl *fc,const char *date,flickcurl_photos_list_params *list_params); flickcurl_license; const char * flickcurl_get_content_type_label (int content_type); int flickcurl_get_content_type_from_string (const char *content_type_string); const char * flickcurl_get_hidden_label (int hidden); int flickcurl_get_hidden_from_string (const char *hidden_string); const char * flickcurl_get_safety_level_label (int safety_level); int flickcurl_get_safety_level_from_string (const char *safety_level_string); char * flickcurl_user_icon_uri (int farm,int server,char *nsid);
typedef struct {
  double latitude;
  double longitude;
  int accuracy;
} flickcurl_location;
A Location in the world with an optional accuracy
typedef struct {
  int is_public;
  int is_contact;
  int is_friend;
  int is_family;
  int perm_comment;
  int perm_addmeta;
} flickcurl_perms;
Permissions as used by flickcurl_photos_getPerms() and 
flickcurl_photos_setPerms() which use public, friend, family,
perm_comment and perm-addmeta.  flickcurl_photos_geo_setPerms() uses
public, contact, friend and family.
A Photo permission.
| non-0 to set the photo to public else private | |
| non-0 to make the photo visible to contacts when private | |
| non-0 to make the photo visible to friends when private | |
| non-0 to make the photo visible to family when private | |
| who can add comments to the photo and it's notes. one of: 0 nobody, 1 friends & family, 2 contacts, 3 everybody | |
| who can add notes and tags to the photo. one of: 0 nobody / just the owner, 1 friends & family, 2 contacts, 3 everybody | 
typedef struct {
  char *label;
  int width;
  int height;
  char *source;
  char *url;
  char* media;
} flickcurl_size;
A photo at a size.
Supported sizes and their letter suffixes used in the source and
the url fields are as follows:
s: small square 75x75. q: large square 150x150 (2011-03-12 or later). t: thumbnail, 100 on longest side. m: small, 240 on longest side. n: small, 320 on longest side (2011-03-12 or later). -: medium, 500 on longest side. z: medium 640, 640 on longest side. b: large, 1024 on longest side*. o: original image, either a jpg, gif or png, depending on source format.
The 'q' and 'n' sizes were announced 2011-03-12 in http://tech.groups.yahoo.com/group/yws-flickr/message/7483
void                flickcurl_free_size                 (flickcurl_size *size);
Destructor for size object
| 
 | size object | 
void                flickcurl_free_sizes                (flickcurl_size **sizes_object);
Destructor for array of size objects
| 
 | size object array | 
void                flickcurl_free_location             (flickcurl_location *location);
Destructor for location object
| 
 | location object | 
void                flickcurl_free_perms                (flickcurl_perms *perms);
Destructor for perms object
| 
 | perms object | 
const char *        flickcurl_get_field_value_type_label
                                                        (flickcurl_field_value_type datatype);
Get label for datatype
| 
 | datatype enum | 
| Returns : | label string or NULL if none valid | 
const char *        flickcurl_get_location_accuracy_label
                                                        (int accuracy);
Get label for an accuracy
| 
 | accuracy | 
| Returns : | label string or NULL if none valid | 
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.
See flickcurl_interestingness_getList() for full description of arguments.
Implements flickr.interestingness.getList (0.13)
| 
 | flickcurl context | 
| 
 | A specific date, formatted as YYYY-MM-DD, to return interesting photos for. (or NULL) | 
| 
 | A comma-delimited list of extra information to fetch for each returned record. See flickcurl_photos_list_params for the full list (or NULL) | 
| 
 | Number of photos to return per page default 100, max 500 | 
| 
 | The page of results to return, default 1 | 
| Returns : | non-0 on failure | 
flickcurl_photos_list * flickcurl_interestingness_getList_params (flickcurl *fc,const char *date,flickcurl_photos_list_params *list_params);
Returns the list of interesting photos for the most recent day or a user-specified date.
Optional extra type 'media' that will return an extra media = VALUE for VALUE "photo" or "video". API addition 2008-04-07.
| 
 | flickcurl context | 
| 
 | A specific date, formatted as YYYY-MM-DD, to return interesting photos for. (or NULL) | 
| 
 | flickcurl_photos_list_params result parameters (or NULL) | 
| Returns : | non-0 on failure | 
typedef struct {
  /* license id */
  int id;
  /* license url or NULL if none */
  char *url;
  /* license name */
  char *name;
} flickcurl_license;
A photo license.
const char *        flickcurl_get_content_type_label    (int content_type);
Get label for a content type.
| 
 | safety level index | 
| Returns : | pointer to shared string label for content type or "unknown" | 
int                 flickcurl_get_content_type_from_string
                                                        (const char *content_type_string);
Get the enumeration value for a content type string.
Parses the string value into a content type either from an integer form like '1' or a label like 'photo'.
| 
 | string | 
| Returns : | content type enumeration value or <0 on error | 
const char *        flickcurl_get_hidden_label          (int hidden);
Get label for a hidden status
| 
 | safety level index | 
| Returns : | pointer to shared string label for hidden status or "unknown" | 
int                 flickcurl_get_hidden_from_string    (const char *hidden_string);
Get the enumeration value for a hidden status string.
Parses the string value into a safety level either from an integer form like '1' or a label like 'hidden'.
| 
 | string | 
| Returns : | safety level enumeration value or <0 on error | 
const char *        flickcurl_get_safety_level_label    (int safety_level);
Get label for a safety level.
| 
 | safety level index | 
| Returns : | pointer to shared string label for safety level or "unknown" | 
int                 flickcurl_get_safety_level_from_string
                                                        (const char *safety_level_string);
Get the enumeration value for a safety level string.
Parses the string value into a safety level either from an integer form like '1' or a label like 'safe'.
| 
 | string | 
| Returns : | safety level enumeration value or <0 on error | 
char * flickcurl_user_icon_uri (int farm,int server,char *nsid);
Get the user's icon URI
The icon URI returned is always a 48x48 pixel JPEG.
If server is 0 (or the other fields are NULL), the default icon URI of
https://www.flickr.com/images/buddyicon.jpg is returned.
Defined by https://www.flickr.com/services/api/misc.buddyicons.html
| 
 | user icon farm | 
| 
 | user icon server or 0 | 
| 
 | user nsid | 
| Returns : | new icon URI string or NULL on failure |