![]() |
![]() |
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); 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_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_safety_level_label (int safety_level); int flickcurl_get_safety_level_from_string (const char *safety_level_string);
typedef struct { double latitude; double longitude; int accuracy; } flickcurl_location;
A Location in the world with an optional accuracy
double |
The latitude from -90 to 90 |
double |
The longitude from -180 to 180 |
int |
Recorded accuracy level of the location. World level is 1, Country is ~3, Region ~6, City ~11, Street ~16. Current range is 1-16. (<0 for unknown 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.
int |
non-0 to set the photo to public else private |
int |
non-0 to make the photo visible to contacts when private |
int |
non-0 to make the photo visible to friends when private |
int |
non-0 to make the photo visible to family when private |
int |
who can add comments to the photo and it's notes. one of: 0 nobody, 1 friends & family, 2 contacts, 3 everybody |
int |
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.
char * |
label |
int |
width in pixels |
int |
height in pixels |
char * |
raw image source URL |
char * |
url of photo page |
char * |
'photo' or 'video' |
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 |
const char* flickcurl_get_shared_secret (flickcurl *fc);
Get current Shared Secret
|
flickcurl object |
Returns : |
shared secret or NULL if none set |
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.
int |
license ID |
char * |
license URL |
char * |
license short name |
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_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 |