|  |  |  | libsocialweb DBus API Reference Manual |  | 
|---|---|---|---|---|
| Top | Description | Implemented Interfaces | Signals | ||||
| com.meego.libsocialweb.PhotoUploadcom.meego.libsocialweb.PhotoUpload — PhotoUpload interface | 
UploadPhoto (in 's' local_filename, in 'a{ss}' fields, out 'i' opid)
Objects implementing com.meego.libsocialweb.PhotoUpload also implements org.freedesktop.DBus.Introspectable, org.freedesktop.DBus.Properties
UploadPhoto()
UploadPhoto (in  's'     local_filename,
             in  'a{ss}' fields,
             out 'i'     opid)
            Upload the photo local_filename.  The upload will be performed
            asynchronously and opid can be used to identify the upload in the
            "PhotoUploadProgress" signal.
          
            fields is a set of key-value pairs that are passed to the service.
            None of these are required and not all services support all of the
            keys.  Generic keys are:
          
title: The photo's title
There are also service-specific keys for accessing features that cannot be abstracted sufficiently. These are prefixed with "x-[service name]-" to avoid conflicts and make it clear that these have specific semantics. These are:
x-flickr-is-public: Set's the Flickr "is_public" parameter. 1 if the photos should be publically viewable, 0 otherwise.
x-flickr-is-friend: Set's the Flickr "is_friend" parameter. 1 if the photos should be viewable by friends, 0 otherwise.
x-flickr-is-family: Set's the Flickr "is_family" parameter. 1 if the photos should be viewable by family, 0 otherwise.
| 
 | The local filename of the image to upload. | 
| 
 | Key-value pairs containing metadata. | 
| 
 | Operation identifier, used in the "PhotoUploadProgress" signal. | 
PhotoUploadProgress ('i' opid,
                     'i' progress,
                     's' error_message)
            Emitted periodically as the upload is performed.  progress can go
            from 0 to 100 as the upload is performed. If there is an error then
            progress is -1 and error_message is set.
          
            This signal is guaranteed to be emitted at least once with either
            progress at 100 (i.e. upload complete) or an error state.
          
| 
 | Operation identifier, as returned by UploadPhoto(). | 
| 
 | Current progress, the normal range being 0 (not started) to 100 (completed), with -1 meaning an error occurred. | 
| 
 | The human-readable error message.  This will be set if progressis -1. |