Photo

Photo — Photo.

Synopsis

                    flickcurl_photo;
void                flickcurl_free_photo                (flickcurl_photo *photo);
void                flickcurl_free_photos               (flickcurl_photo **photos);
const char *        flickcurl_get_photo_field_label     (flickcurl_photo_field_type field);
char *              flickcurl_photo_as_page_uri         (flickcurl_photo *photo);
char *              flickcurl_photo_as_short_uri        (flickcurl_photo *photo);
char *              flickcurl_photo_as_source_uri       (flickcurl_photo *photo,
                                                         const char c);
char *              flickcurl_photo_as_user_icon_uri    (flickcurl_photo *photo);
char *              flickcurl_photo_id_as_short_uri     (char *photo_id);
char *              flickcurl_source_uri_as_photo_id    (const char *uri);
                    flickcurl_photo_field;
enum                flickcurl_photo_field_type;
enum                flickcurl_field_value_type;
int                 flickcurl_photos_addTags            (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *tags);
char *              flickcurl_photos_comments_addComment
                                                        (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *comment_text);
int                 flickcurl_photos_comments_deleteComment
                                                        (flickcurl *fc,
                                                         const char *comment_id);
int                 flickcurl_photos_comments_editComment
                                                        (flickcurl *fc,
                                                         const char *comment_id,
                                                         const char *comment_text);
flickcurl_comment ** flickcurl_photos_comments_getList  (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photos_list * flickcurl_photos_comments_getRecentForContacts_params
                                                        (flickcurl *fc,
                                                         int date_lastcomment,
                                                         const char *contacts_filter,
                                                         flickcurl_photos_list_params *list_params);
int                 flickcurl_photos_delete             (flickcurl *fc,
                                                         const char *photo_id);
int                 flickcurl_photos_geo_batchCorrectLocation
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         const char *place_id,
                                                         int woe_id);
int                 flickcurl_photos_geo_correctLocation
                                                        (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *place_id,
                                                         int woe_id);
flickcurl_location * flickcurl_photos_geo_getLocation   (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_perms *   flickcurl_photos_geo_getPerms       (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo **  flickcurl_photos_geo_photosForLocation
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_geo_photosForLocation_params
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         flickcurl_photos_list_params *list_params);
int                 flickcurl_photos_geo_removeLocation (flickcurl *fc,
                                                         const char *photo_id);
int                 flickcurl_photos_geo_setContext     (flickcurl *fc,
                                                         const char *photo_id,
                                                         int context);
int                 flickcurl_photos_geo_setLocation    (flickcurl *fc,
                                                         const char *photo_id,
                                                         flickcurl_location *location);
int                 flickcurl_photos_geo_setPerms       (flickcurl *fc,
                                                         const char *photo_id,
                                                         flickcurl_perms *perms);
flickcurl_context ** flickcurl_photos_getAllContexts    (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo **  flickcurl_photos_getContactsPhotos  (flickcurl *fc,
                                                         int contact_count,
                                                         int just_friends,
                                                         int single_photo,
                                                         int include_self,
                                                         const char *extras);
flickcurl_photos_list * flickcurl_photos_getContactsPhotos_params
                                                        (flickcurl *fc,
                                                         int contact_count,
                                                         int just_friends,
                                                         int single_photo,
                                                         int include_self,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_photo **  flickcurl_photos_getContactsPublicPhotos
                                                        (flickcurl *fc,
                                                         const char *user_id,
                                                         int photo_count,
                                                         int just_friends,
                                                         int single_photo,
                                                         int include_self,
                                                         const char *extras);
flickcurl_photos_list * flickcurl_photos_getContactsPublicPhotos_params
                                                        (flickcurl *fc,
                                                         const char *user_id,
                                                         int photo_count,
                                                         int just_friends,
                                                         int single_photo,
                                                         int include_self,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_context ** flickcurl_photos_getContext        (flickcurl *fc,
                                                         const char *photo_id);
int **              flickcurl_photos_getCounts          (flickcurl *fc,
                                                         const char **dates_array,
                                                         const char **taken_dates_array);
flickcurl_exif **   flickcurl_photos_getExif            (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *secret);
flickcurl_person ** flickcurl_photos_getFavorites       (flickcurl *fc,
                                                         const char *photo_id,
                                                         int page,
                                                         int per_page);
flickcurl_photo *   flickcurl_photos_getInfo            (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo *   flickcurl_photos_getInfo2           (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *secret);
flickcurl_photo **  flickcurl_photos_getNotInSet        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_getNotInSet_params
                                                        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_perms *   flickcurl_photos_getPerms           (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo **  flickcurl_photos_getRecent          (flickcurl *fc,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_getRecent_params
                                                        (flickcurl *fc,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_size **   flickcurl_photos_getSizes           (flickcurl *fc,
                                                         const char *photo_id);
flickcurl_photo **  flickcurl_photos_getUntagged        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_getUntagged_params
                                                        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_photo **  flickcurl_photos_getWithGeoData     (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_getWithGeoData_params
                                                        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_photo **  flickcurl_photos_getWithoutGeoData  (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_getWithoutGeoData_params
                                                        (flickcurl *fc,
                                                         int min_upload_date,
                                                         int max_upload_date,
                                                         const char *min_taken_date,
                                                         const char *max_taken_date,
                                                         int privacy_filter,
                                                         flickcurl_photos_list_params *list_params);
flickcurl_license ** flickcurl_photos_licenses_getInfo  (flickcurl *fc);
flickcurl_license * flickcurl_photos_licenses_getInfo_by_id
                                                        (flickcurl *fc,
                                                         int id);
int                 flickcurl_photos_licenses_setLicense
                                                        (flickcurl *fc,
                                                         const char *photo_id,
                                                         int license_id);
char *              flickcurl_photos_notes_add          (flickcurl *fc,
                                                         const char *photo_id,
                                                         int note_x,
                                                         int note_y,
                                                         int note_w,
                                                         int note_h,
                                                         const char *note_text);
int                 flickcurl_photos_notes_delete       (flickcurl *fc,
                                                         const char *note_id);
int                 flickcurl_photos_notes_edit         (flickcurl *fc,
                                                         const char *note_id,
                                                         int note_x,
                                                         int note_y,
                                                         int note_w,
                                                         int note_h,
                                                         const char *note_text);
flickcurl_photo **  flickcurl_photos_recentlyUpdated    (flickcurl *fc,
                                                         int min_date,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);
flickcurl_photos_list * flickcurl_photos_recentlyUpdated_params
                                                        (flickcurl *fc,
                                                         int min_date,
                                                         flickcurl_photos_list_params *list_params);
int                 flickcurl_photos_removeTag          (flickcurl *fc,
                                                         const char *tag_id);
flickcurl_upload_status * flickcurl_photos_replace      (flickcurl *fc,
                                                         const char *photo_file,
                                                         const char *photo_id,
                                                         int async);
flickcurl_photo **  flickcurl_photos_search             (flickcurl *fc,
                                                         flickcurl_search_params *params);
flickcurl_photos_list * flickcurl_photos_search_params  (flickcurl *fc,
                                                         flickcurl_search_params *params,
                                                         flickcurl_photos_list_params *list_params);
                    flickcurl_search_params;
int                 flickcurl_search_params_init        (flickcurl_search_params *params);
int                 flickcurl_photos_setContentType     (flickcurl *fc,
                                                         const char *photo_id,
                                                         int content_type);
int                 flickcurl_photos_setDates           (flickcurl *fc,
                                                         const char *photo_id,
                                                         int date_posted,
                                                         int date_taken,
                                                         int date_taken_granularity);
int                 flickcurl_photos_setMeta            (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *title,
                                                         const char *description);
int                 flickcurl_photos_setPerms           (flickcurl *fc,
                                                         const char *photo_id,
                                                         flickcurl_perms *perms);
int                 flickcurl_photos_setSafetyLevel     (flickcurl *fc,
                                                         const char *photo_id,
                                                         int safety_level,
                                                         int hidden);
int                 flickcurl_photos_setTags            (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *tags);
int                 flickcurl_photos_transform_rotate   (flickcurl *fc,
                                                         const char *photo_id,
                                                         int degrees);
flickcurl_ticket ** flickcurl_photos_upload_checkTickets
                                                        (flickcurl *fc,
                                                         const char **tickets_ids);
flickcurl_upload_status * flickcurl_photos_upload_params
                                                        (flickcurl *fc,
                                                         flickcurl_upload_params *params);

Description

Photo.

Details

flickcurl_photo

typedef struct {
  char *id;
  char *uri;
  
  flickcurl_tag** tags;
  int tags_count;
  
  flickcurl_photo_field fields[PHOTO_FIELD_LAST + 1];

  flickcurl_place* place;

  flickcurl_video* video;

  char *media_type;

  flickcurl_note** notes;
  int notes_count;
} flickcurl_photo;

A photo or video.

char *id;

photo/video ID

char *uri;

photo/video page URI

flickcurl_tag **tags;

array of tags (may be NULL)

int tags_count;

size of tags array

flickcurl_photo_field fields[PHOTO_FIELD_LAST + 1];

metadata fields

flickcurl_place *place;

place

flickcurl_video *video;

video (may be NULL)

char *media_type;

"photo" or "video"

flickcurl_note **notes;

array of notes (may be NULL)

int notes_count;

size of notes array

flickcurl_free_photo ()

void                flickcurl_free_photo                (flickcurl_photo *photo);

Destructor for photo object

photo :

photo object

flickcurl_free_photos ()

void                flickcurl_free_photos               (flickcurl_photo **photos);

Destructor for array of photo objects

photos :

photo object array

flickcurl_get_photo_field_label ()

const char *        flickcurl_get_photo_field_label     (flickcurl_photo_field_type field);

Get label for photo field.

field :

field enum

Returns :

label string or NULL if none valid

flickcurl_photo_as_page_uri ()

char *              flickcurl_photo_as_page_uri         (flickcurl_photo *photo);

Get a photo's page URI

photo :

photo object

Returns :

new source URI string or NULL on failure

flickcurl_photo_as_short_uri ()

char *              flickcurl_photo_as_short_uri        (flickcurl_photo *photo);

Get a short URI for a photo

Encoded based on description given in http://www.flickr.com/groups/api/discuss/72157616713786392/

photo :

photo object

Returns :

new short URI string or NULL on failure

flickcurl_photo_as_source_uri ()

char *              flickcurl_photo_as_source_uri       (flickcurl_photo *photo,
                                                         const char c);

Get a photo's image source URIs

c can be s,m,t,b for sizes, o for original, otherwise default https://www.flickr.com/services/api/misc.urls.html

photo :

photo object

c :

size s, m, t or b

Returns :

new source URI string or NULL on failure

flickcurl_photo_as_user_icon_uri ()

char *              flickcurl_photo_as_user_icon_uri    (flickcurl_photo *photo);

Get the user's icon URI

The icon URI returned is always a 48x48 pixel JPEG

photo :

photo object

Returns :

new icon URI string or NULL on failure

flickcurl_photo_id_as_short_uri ()

char *              flickcurl_photo_id_as_short_uri     (char *photo_id);

Get a short URI for a photo ID

Encoded based on description given in http://www.flickr.com/groups/api/discuss/72157616713786392/

photo_id :

photo ID

Returns :

new short URI string or NULL on failure

flickcurl_source_uri_as_photo_id ()

char *              flickcurl_source_uri_as_photo_id    (const char *uri);

Get a photo ID from an image source URI

Turns an URL that points to the photo into a photo ID. i.e. given an URI like these: https://farm{farm-id}.static.flickr.com/{server-id}/{photo-id}_{o-secret}_o.(jpg|gif|png) or https://farm{farm-id}.static.flickr.com/{server-id}/{photo-id}_{secret}_[mstb].jpg https://farm{farm-id}.static.flickr.com/{server-id}/{photo-id}_{secret}.jpg (or the same with staticflickr.com) returns the {photo-id}

uri :

source uri

Returns :

new photo ID string or NULL on failure

flickcurl_photo_field

typedef struct {
  char* string;
  flickcurl_photo_field_type integer;
  flickcurl_field_value_type type;
} flickcurl_photo_field;

Field of a photo structure

char *string;

string field value

flickcurl_photo_field_type integer;

integer field value

flickcurl_field_value_type type;

field type

enum flickcurl_photo_field_type

typedef enum {
  PHOTO_FIELD_none,
  PHOTO_FIELD_dateuploaded,
  PHOTO_FIELD_farm,
  PHOTO_FIELD_isfavorite,
  PHOTO_FIELD_license,
  PHOTO_FIELD_originalformat,
  PHOTO_FIELD_rotation,
  PHOTO_FIELD_server,
  PHOTO_FIELD_dates_lastupdate,
  PHOTO_FIELD_dates_posted,
  PHOTO_FIELD_dates_taken,
  PHOTO_FIELD_dates_takengranularity,
  PHOTO_FIELD_description,
  PHOTO_FIELD_editability_canaddmeta,
  PHOTO_FIELD_editability_cancomment,
  PHOTO_FIELD_geoperms_iscontact,
  PHOTO_FIELD_geoperms_isfamily,
  PHOTO_FIELD_geoperms_isfriend,
  PHOTO_FIELD_geoperms_ispublic,
  PHOTO_FIELD_location_accuracy,
  PHOTO_FIELD_location_latitude,
  PHOTO_FIELD_location_longitude,
  PHOTO_FIELD_owner_location,
  PHOTO_FIELD_owner_nsid,
  PHOTO_FIELD_owner_realname,
  PHOTO_FIELD_owner_username,
  PHOTO_FIELD_title,
  PHOTO_FIELD_visibility_isfamily,
  PHOTO_FIELD_visibility_isfriend,
  PHOTO_FIELD_visibility_ispublic,
  PHOTO_FIELD_secret,
  PHOTO_FIELD_originalsecret,
  PHOTO_FIELD_location_neighbourhood,
  PHOTO_FIELD_location_neighborhood = PHOTO_FIELD_location_neighbourhood,
  PHOTO_FIELD_location_locality,
  PHOTO_FIELD_location_county,
  PHOTO_FIELD_location_region,
  PHOTO_FIELD_location_country,
  PHOTO_FIELD_location_placeid,
  PHOTO_FIELD_neighbourhood_placeid,
  PHOTO_FIELD_neighborhood_placeid = PHOTO_FIELD_neighbourhood_placeid,
  PHOTO_FIELD_locality_placeid,
  PHOTO_FIELD_county_placeid,
  PHOTO_FIELD_region_placeid,
  PHOTO_FIELD_country_placeid,
  PHOTO_FIELD_location_woeid,
  PHOTO_FIELD_neighbourhood_woeid,
  PHOTO_FIELD_neighborhood_woeid  = PHOTO_FIELD_neighbourhood_woeid,
  PHOTO_FIELD_locality_woeid,
  PHOTO_FIELD_county_woeid,
  PHOTO_FIELD_region_woeid,
  PHOTO_FIELD_country_woeid,
  PHOTO_FIELD_usage_candownload,
  PHOTO_FIELD_usage_canblog,
  PHOTO_FIELD_usage_canprint,
  PHOTO_FIELD_owner_iconserver,
  PHOTO_FIELD_owner_iconfarm,
  PHOTO_FIELD_original_width,
  PHOTO_FIELD_original_height,
  PHOTO_FIELD_views,
  PHOTO_FIELD_comments,
  PHOTO_FIELD_favorites,
  PHOTO_FIELD_gallery_comment,
  PHOTO_FIELD_FIRST = PHOTO_FIELD_dateuploaded,
  PHOTO_FIELD_LAST = PHOTO_FIELD_gallery_comment
} flickcurl_photo_field_type;

Fields of a flickcurl_photo*

PHOTO_FIELD_none

internal

PHOTO_FIELD_dateuploaded

date uploaded

PHOTO_FIELD_farm

farm number

PHOTO_FIELD_isfavorite

is favorite boolean

PHOTO_FIELD_license

license

PHOTO_FIELD_originalformat

original format

PHOTO_FIELD_rotation

rotation

PHOTO_FIELD_server

server

PHOTO_FIELD_dates_lastupdate

last update date

PHOTO_FIELD_dates_posted

posted date

PHOTO_FIELD_dates_taken

taken date

PHOTO_FIELD_dates_takengranularity

taken granularity

PHOTO_FIELD_description

description

PHOTO_FIELD_editability_canaddmeta

can add metadata boolean

PHOTO_FIELD_editability_cancomment

can comment boolean

PHOTO_FIELD_geoperms_iscontact

geo perms are for contacts

PHOTO_FIELD_geoperms_isfamily

geo perms are for family

PHOTO_FIELD_geoperms_isfriend

geo perms are for frind

PHOTO_FIELD_geoperms_ispublic

geo perms are for public

PHOTO_FIELD_location_accuracy

location accuracy

PHOTO_FIELD_location_latitude

location latitude

PHOTO_FIELD_location_longitude

location longitude

PHOTO_FIELD_owner_location

owner location

PHOTO_FIELD_owner_nsid

owner NSID

PHOTO_FIELD_owner_realname

owner real name

PHOTO_FIELD_owner_username

owner user name

PHOTO_FIELD_title

title

PHOTO_FIELD_visibility_isfamily

visibility is for family

PHOTO_FIELD_visibility_isfriend

visibility is for friend

PHOTO_FIELD_visibility_ispublic

visibility is for public

PHOTO_FIELD_secret

photo secret

PHOTO_FIELD_originalsecret

photo original secret

PHOTO_FIELD_location_neighbourhood

location neighbourhood

PHOTO_FIELD_location_neighborhood

deprecated

PHOTO_FIELD_location_locality

location locality

PHOTO_FIELD_location_county

location county

PHOTO_FIELD_location_region

location region

PHOTO_FIELD_location_country

location country

PHOTO_FIELD_location_placeid

location place ID

PHOTO_FIELD_neighbourhood_placeid

neighborhood place ID

PHOTO_FIELD_neighborhood_placeid

dprecated

PHOTO_FIELD_locality_placeid

locality place ID

PHOTO_FIELD_county_placeid

county place ID

PHOTO_FIELD_region_placeid

region place ID

PHOTO_FIELD_country_placeid

country place ID

PHOTO_FIELD_location_woeid

location WOE ID

PHOTO_FIELD_neighbourhood_woeid

neighborhood WOE ID

PHOTO_FIELD_neighborhood_woeid

deprecated

PHOTO_FIELD_locality_woeid

locality WOE ID

PHOTO_FIELD_county_woeid

county WOE ID

PHOTO_FIELD_region_woeid

region WOE ID

PHOTO_FIELD_country_woeid

country WOE ID

PHOTO_FIELD_usage_candownload

can download

PHOTO_FIELD_usage_canblog

can blog

PHOTO_FIELD_usage_canprint

can print

PHOTO_FIELD_owner_iconserver

server of owner's icon

PHOTO_FIELD_owner_iconfarm

farm of owner's icon

PHOTO_FIELD_original_width

original photo width

PHOTO_FIELD_original_height

original photo height

PHOTO_FIELD_views

number of photo views

PHOTO_FIELD_comments

number of photo comments

PHOTO_FIELD_favorites

number of photo favorites

PHOTO_FIELD_gallery_comment

comment on the photo when used in a gallery

PHOTO_FIELD_FIRST

internal offset to first in enum list

PHOTO_FIELD_LAST

internal offset to last in enum list

enum flickcurl_field_value_type

typedef enum {
  VALUE_TYPE_NONE, /* empty field */
  VALUE_TYPE_PHOTO_ID, /* internal */
  VALUE_TYPE_PHOTO_URI, /* internal */
  VALUE_TYPE_UNIXTIME,
  VALUE_TYPE_BOOLEAN,
  VALUE_TYPE_DATETIME,
  VALUE_TYPE_FLOAT,
  VALUE_TYPE_INTEGER,
  VALUE_TYPE_STRING,
  VALUE_TYPE_URI,
  VALUE_TYPE_PERSON_ID, /* internal */
  VALUE_TYPE_MEDIA_TYPE, /* internal */
  VALUE_TYPE_TAG_STRING, /* internal */
  VALUE_TYPE_COLLECTION_ID, /* internal */
  VALUE_TYPE_ICON_PHOTOS, /* internal */
  VALUE_TYPE_LAST = VALUE_TYPE_ICON_PHOTOS
} flickcurl_field_value_type;

Field data types

VALUE_TYPE_NONE

internal

VALUE_TYPE_PHOTO_ID

internal

VALUE_TYPE_PHOTO_URI

internal

VALUE_TYPE_UNIXTIME

a unixtime

VALUE_TYPE_BOOLEAN

boolean

VALUE_TYPE_DATETIME

date time

VALUE_TYPE_FLOAT

floating point number

VALUE_TYPE_INTEGER

integer

VALUE_TYPE_STRING

string

VALUE_TYPE_URI

URI

VALUE_TYPE_PERSON_ID

person ID

VALUE_TYPE_MEDIA_TYPE

internal

VALUE_TYPE_TAG_STRING

internal

VALUE_TYPE_COLLECTION_ID

internal

VALUE_TYPE_ICON_PHOTOS

internal

VALUE_TYPE_LAST

internal offset to last in enum list

flickcurl_photos_addTags ()

int                 flickcurl_photos_addTags            (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *tags);

Add tags to a photo.

Implements flickr.photos.addTags (0.9)

fc :

flickcurl context

photo_id :

photo ID

tags :

tags to add as a space-separated list

Returns :

non-0 on failure

flickcurl_photos_comments_addComment ()

char *              flickcurl_photos_comments_addComment
                                                        (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *comment_text);

Add comment to a photo as the currently authenticated user.

Implements flickr.photos.comments.addComment (0.10)

fc :

flickcurl context

photo_id :

The id of the photo to add a comment to.

comment_text :

Text of the comment

Returns :

new comment ID or non-NULL on failure

flickcurl_photos_comments_deleteComment ()

int                 flickcurl_photos_comments_deleteComment
                                                        (flickcurl *fc,
                                                         const char *comment_id);

Delete a comment as the currently authenticated user.

Implements flickr.photos.comments.deleteComment (0.10)

fc :

flickcurl context

comment_id :

The id of the comment to edit.

Returns :

non-0 on failure

flickcurl_photos_comments_editComment ()

int                 flickcurl_photos_comments_editComment
                                                        (flickcurl *fc,
                                                         const char *comment_id,
                                                         const char *comment_text);

Edit the text of a comment as the currently authenticated user.

Implements flickr.photos.comments.editComment (0.10)

fc :

flickcurl context

comment_id :

The id of the comment to edit.

comment_text :

Update the comment to this text.

Returns :

non-0 on failure

flickcurl_photos_comments_getList ()

flickcurl_comment ** flickcurl_photos_comments_getList  (flickcurl *fc,
                                                         const char *photo_id);

Returns the comments for a photo

Implements flickr.photos.comments.getList (0.10)

fc :

flickcurl context

photo_id :

The id of the photo to fetch comments for.

Returns :

array of comments or NULL on failure

flickcurl_photos_comments_getRecentForContacts_params ()

flickcurl_photos_list * flickcurl_photos_comments_getRecentForContacts_params
                                                        (flickcurl *fc,
                                                         int date_lastcomment,
                                                         const char *contacts_filter,
                                                         flickcurl_photos_list_params *list_params);

Return the list of photos belonging to your contacts that have been commented on recently.

Implements flickr.photos.comments.getRecentForContacts (1.12)

fc :

flickcurl context

date_lastcomment :

Limits the resultset to photos that have been commented on since this date. The date should be in the form of a Unix timestamp. The default, and maximum, offset is (1) hour (or <0)

contacts_filter :

A comma-separated list of contact NSIDs to limit the scope of the query to (or NULL)

list_params :

flickcurl_photos_list_params result parameters (or NULL)

Returns :

list of photos or NULL on failure

flickcurl_photos_delete ()

int                 flickcurl_photos_delete             (flickcurl *fc,
                                                         const char *photo_id);

Delete a photo.

Implements flickr.photos.delete (0.9)

fc :

flickcurl context

photo_id :

photo ID

Returns :

non-0 on failure

flickcurl_photos_geo_batchCorrectLocation ()

int                 flickcurl_photos_geo_batchCorrectLocation
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         const char *place_id,
                                                         int woe_id);

Correct the places hierarchy for all the photos for a user at a given location (latitude, longitude and accuracy).

You must pass either a valid Places ID in place_id or a WOE ID in woe_id.

Batch corrections are processed in a delayed queue so it may take a few minutes before the changes are reflected in a user's photos.

Implements flickr.photos.geo.batchCorrectLocation (1.8)

fc :

flickcurl context

location :

The location (lat, long, accuracy) of the photos to update.

place_id :

A Flickr Places ID (or NULL)

woe_id :

A Where On Earth (WOE) ID (or 0)

Returns :

non-0 on failure

flickcurl_photos_geo_correctLocation ()

int                 flickcurl_photos_geo_correctLocation
                                                        (flickcurl *fc,
                                                         const char *photo_id,
                                                         const char *place_id,
                                                         int woe_id);

Correct a photo location.

You must pass either a valid Places ID in place_id or a WOE ID in woe_id.

Implements flickr.photos.geo.correctLocation (1.8)

fc :

flickcurl context

photo_id :

The ID of the photo whose WOE location is being corrected.

place_id :

A Flickr Places ID (or NULL)

woe_id :

A Where On Earth (WOE) ID (or NULL)

Returns :

non-0 on failure

flickcurl_photos_geo_getLocation ()

flickcurl_location * flickcurl_photos_geo_getLocation   (flickcurl *fc,
                                                         const char *photo_id);

Get the geo data (latitude and longitude and the accuracy level) for a photo.

Implements flickr.photos.geo.getLocation (0.12)

fc :

flickcurl context

photo_id :

The id of the photo you want to retrieve location data for.

Returns :

non-0 on failure

flickcurl_photos_geo_getPerms ()

flickcurl_perms *   flickcurl_photos_geo_getPerms       (flickcurl *fc,
                                                         const char *photo_id);

Get permissions for who may view geo data for a photo.

Implements flickr.photos.geo.getPerms (0.12)

fc :

flickcurl context

photo_id :

The id of the photo to get permissions for.

Returns :

non-0 on failure

flickcurl_photos_geo_photosForLocation ()

flickcurl_photo **  flickcurl_photos_geo_photosForLocation
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         const char *extras,
                                                         int per_page,
                                                         int page);

Get a list of photos for a user at a specific location (latitude, longitude and accuracy)

Implements flickr.photos.geo.photosForLocation (1.8)

fc :

flickcurl context

location :

The location (lat, long, accuracy) of the photos

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, o_dims, views, media (or NULL)

per_page :

Number of photos to return per page. If this argument is omitted, it defaults to 100. The maximum allowed value is 500 (or NULL)

page :

The page of results to return. If this argument is omitted, it defaults to 1 (or NULL)

Returns :

list of photos or NULL on failure

flickcurl_photos_geo_photosForLocation_params ()

flickcurl_photos_list * flickcurl_photos_geo_photosForLocation_params
                                                        (flickcurl *fc,
                                                         flickcurl_location *location,
                                                         flickcurl_photos_list_params *list_params);

Get a list of photos for a user at a specific location (latitude, longitude and accuracy)

fc :

flickcurl context

location :

The location (lat, long, accuracy) of the photos

list_params :

flickcurl_photos_list_params result parameters (or NULL)

Returns :

list of photos or NULL on failure

flickcurl_photos_geo_removeLocation ()

int                 flickcurl_photos_geo_removeLocation (flickcurl *fc,
                                                         const char *photo_id);

Removes the geo data associated with a photo.

Implements flickr.photos.geo.removeLocation (0.12)

fc :

flickcurl context

photo_id :

The id of the photo you want to remove location data from.

Returns :

non-0 on failure

flickcurl_photos_geo_setContext ()

int                 flickcurl_photos_geo_setContext     (flickcurl *fc,
                                                         const char *photo_id,
                                                         int context);

Indicate the state of a photo's geotagginess beyond latitude and longitude.

Note : photos passed to this method must already be geotagged using the flickcurl_photos_geo_setLocation() method.

Implements flickr.photos.geo.setContext (1.8)

fc :

flickcurl context

photo_id :

The id of the photo to set context data for.

context :

Context is a numeric value representing the photo's geotagginess beyond latitude and longitude. The current values are: 0: not defined, 1: indoors, 2: outdoors.

Returns :

non-0 on failure

flickcurl_photos_geo_setLocation ()

int                 flickcurl_photos_geo_setLocation    (flickcurl *fc,
                                                         const char *photo_id,
                                                         flickcurl_location *location);

Sets the geo data (latitude and longitude and, optionally, the accuracy level) for a photo.

Implements flickr.photos.geo.setLocation (0.12)

fc :

flickcurl context

photo_id :

The id of the photo to set location data for.

location :

The location

Returns :

non-0 on failure

flickcurl_photos_geo_setPerms ()

int                 flickcurl_photos_geo_setPerms       (flickcurl *fc,
                                                         const char *photo_id,
                                                         flickcurl_perms *perms);

Set the permission for who may view the geo data associated with a photo.

Implements flickr.photos.geo.setPerms (0.12)

fc :

flickcurl context

photo_id :

The id of the photo to get permissions for.

perms :

Geo permissions

Returns :

non-0 on failure

flickcurl_photos_getAllContexts ()

flickcurl_context ** flickcurl_photos_getAllContexts    (flickcurl *fc,
                                                         const char *photo_id);

Get all visible sets and pools the photo belongs to.

Implements flickr.photos.getAllContexts (0.7)

Returns an array of size 3 [prev, next, NULL] flickcurl_context* or NULL on error

fc :

flickcurl context

photo_id :

photo ID

Returns :

prev, next contexts or NULL

flickcurl_photos_getContactsPhotos ()

flickcurl_photo **  flickcurl_photos_getContactsPhotos  (flickcurl *fc,
                                                         int contact_count,
                                                         int just_friends,
                                                         int single_photo,
                                                         int include_self,
                                                         const char *extras);

Fetch a list of recent photos from the calling users' con