Watermark still.

22Aug2011

Watermark an existing still and save it as a new one.

Request URL

/still/$still_id/watermark [POST]

Request Authorization

This call needs EGA authentication.

Request Parameters

Parameter (Type)DescriptionRequiredDefault valueMax. length
still_id (ALPHA_NUM)The still ID.Required-
user_id (ALPHA_NUM)The owner ID to match.Required-
watermark_id (ALPHA_NUM)The watermark ID.Required-
default (BOOL)Is default still? Only used when still_upload = true.OptionalFALSE-
mediamosa_version (MEDIAMOSA_VERSION)Provide the version to get the REST call returned in the format of the specified MediaMosa version. Keep empty or skip to retrieve in current (latest) version. Provide '2' to retrieve the REST call in 2.x format. Or be more specific by providing up to 3 digits; '2.3.0'. This setting will override any setting used by client application or the default setting in MediaMosa.Optional-
order (INT)Still order number. Only used when still_upload = true.Optional0-
tag (STRING)Mediafile tag to set. An empty tag will clear possible set mediafile tag.Optional-
watermark_dst_x (INT)X-coordinate of destination point of watermark.Optional0-
watermark_dst_y (INT)Y-coordinate of destination point of watermark.Optional0-
watermark_h_align (STRING)Horizontal align of watermark.
Value (when supplied) must be either "top" or "bottom".
Optionaltop-
watermark_pct (INT)Alpha transparency of watermark (watermark visibility in percentage [0 - 100%]).Optional75-
watermark_v_align (STRING)Vertical align of watermark.
Value (when supplied) must be either "left" or "right".
Optionalleft-

Example Request

still/Cd2WoNCzHX14mfLwbxbPgowc/watermark

Example Response

<items>
  <item id="1">
    <still_id>OW35AQyoPNUSi4iINunmS2nr</still_id>
  </item>
</items>