Share |
ShareEmbedCreateRequest |
ConversionPresets for embeds |
- ShareEmbedCreateRequest now supports setting ConversionPresets on EmbedContents (see Contents property).
- A conversion preset might be locked (cannot be changed via the URL) or unlocked. In the latter case, both a short and a long URL (containing the conversion preset) are delivered when fetching the Share.
- Note: Only image outputs are supported to be edited. See below for supported conversion parameters.
|
See ShareTests.cs
|
Content |
/v1/contents/downloads/{contentId}/{outputFormatId}/{conversionPreset} |
Image editing |
- New endpoint to edit an image output.
- Supported conversion parameters:
-
crop:200x300[,fp:0.5,0.4] : Crop image to 200x300 pixels. Optionally specify a focal point (floating point values are relative to image dimensions, absolute location is also supported).
-
crop:200x300,gravity:ne : Crop image to 200x300 pixels from top right corner (gravity one out of nw,n,ne,e,se,s,sw,e) .
-
scale-to:1920x1080 : Scale output to 1920x1080 (smaller images are upscaled, proportions are kept).
-
fit-in:1920x1080 : Scale output to 1920x1080 (smaller images are not upscaled, proportions are kept).
-
resize-to:1920x1080 : Scale output to 1920x1080 (smaller images are upscaled, proportions are not kept).
-
rotate:90[,dir:ccw] : Rotate image by 90 degrees. dir:ccw designated counterclockwise direction.
-
alpha:discard : Discard alpha channel.
-
alpha:replace(#FFFFFF) : Replace alpha channel with white color.
-
alpha:replace-inv(#FFFFFF) : Invert alpha channel, then replace alpha channel with white color.
-
sharpen:0.5[,r:0.2,t:0.3] : Sharpen image with unsharpen mask. First value designates amount, r designates radius, t designates threshold.
-
quality:90 : Applicable if final output is JPEG. Set quality of JPEG.
-
compression:none|lzw|rle|zip : Applicable if final output is TIFF. Set compression algorithm.
- Select output format (supported: JPEG|TIFF|PNG) by appending filename with extension to the conversion (i.e.
image.png converts to PNG format).
- Examples:
-
crop:300x300/quality:90/image.jpg : Crop to 300x300, centered in image. Deliver JPEG with quality 90 and filename image.jpg.
-
crop:300x300,gravity:nw/rotate:90ccw/alpha:discard/image.png : Crop to 300x300, from top left corner. Rotate by 90° counterclockwise, discard alpha channel, deliver PNG with filename image.png.
|
See ContentTests.cs
|
Content |
/v1/contents/checkContentSchemaChange |
File replacement check |
- New endpoint to check if a change of
ContentSchemaId is possible without the need to remove layers.
- This is possible when a file of an existing Content is replaced.
|
See ContentTests.cs
|
Content |
/v1/contents/{contentId}/file/check |
File replacement check |
- Convenience endpoint to check
ContentSchemaId change for a specific file replacement.
- Should be called after upload and before actual file replacement call.
|
See ContentTests.cs
|
Content |
/v1/contents/many/repair/batch and /v1/contents/many/repair/filter
|
Repair DataExtraction of Content |
- Endpoints to trigger retry of DataExtraction (normally carried out before import of Transfer).
- Returned BusinessProcess will complete when Contents have been extracted and results applied.
- Wait for completion of continuation BusinessProcess if you intend to search based on extracted fields.
- Can cause change of
ContentSchemaId , thus flags similar to ContentFileUpdateRequest are available and potentially needed for the repair to have an effect.
|
See PictureparkSwagger.json
|
Content |
ContentSearchRequest |
Content permissions resolution |
-
ResolveBehaviors property added.
- If the
ContentSearchResolveBehavior.Permissions enum is sent in the list of ResolveBehaviors , each Content returns the ContentRights property filled with the rights the current user performing the search has on the Content.
- If the
ResolveBehaviors are sent as an empty list or not sent at all, the behavior of the endpoint remain unchanged and the ContentRights property will not be returned.
|
|
Schema |
/v1/schemas/{id}/referenced (GetReferenced)
/v1/Schemas/many/referenced (GetManyReferenced)
|
Returned source schema in GetReferenced |
- The single and many endpoints for to get the referenced schemas, supports now the query parameter
sourceSchema .
- If
sourceSchema is set to true, the schema for which the referenced schemas are requested will also be returned.
- If
sourceSchema is set to false or is not sent, the behavior of the endpoint remains unchanged, and the source schema is not returned.
|
|
OutputFormats |
CopyFormat |
New rendering format for creating copy of source Output |
- Allows creating exact same Output including extension from existing Format.
- Preparation for upcoming XmpWriteback feature.
- CopyFormat cannot be used when any parent format has XmpWriteback enabled.
|
See OutputFormatTests.cs
|