Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Excerpt

Picturepark generates (renders) static (preconfigured, pre-rendered) and dynamic (on-demand rendered) formats. Both are available in the format selection dialogue which opens up when you download or share. 

Expand
titleCreate a Download Format / Output Format

Create a Download Format / Output Format

The static formats are created on customer creation. Check Format Modifications for your desired settings. 

The dynamic formats are created via API: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_Create . It is recommended to test your settings using the preview operation, which allows generating a temporary preview of your desired output to validate your settings: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_RenderFormatPreview  based on the actual Content Items of your Picturepark. 

Filter by label (Content by label)
showLabelsfalse
max20
showSpacefalse
titleExamples
excerptTypesimple
cqllabel = "output-format" and label = "solution" and space = "SOL"

Expand
titleUpdate a Download Format / Output Format

Update a Download Format / Output Format

You cannot update static format attributes (e.g. resizing). You can however update attributes like:  

  • XMP Writeback (enableXmpWriteback; boolean)

  • Filename pattern used when the file is downloaded (downloadFileNamePatterns; string translated)

  • Permission to access output formats even if the source is not accessible (viewForAll; boolean)

You can update output formats using the API: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_Update

Apply Resize Action

PUT: {{apiHost}}/v1/outputformats/{id}

Code Block
languagejson
{
    "id": "MyFirstFormat",    
    "names": {
        "en": "My first format"
    },
    "sourceOutputFormats": {
        "image": "Original",
        "video": "VideoPreview",
        "document": "DocumentPreview",
        "audio": "AudioPreview",
        "vector": "VectorPreview"
    },
    "format": {
        "kind": "JpegFormat",
        "resizeAction":{
        	"width":50,
        	"height":50,
        	"resizeMode":"fit"
        }
    }
}
Expand
titleDynamic Formats

Dynamic Formats

Dynamic Formats can be defined for images only and are rendered on demand for the selected Content Item in Picturepark and not saved to the storage but only to a cache for the configured retention time. Dynamic formats may be Hero Images, Social Media Images, or Campaign Specials.

The benefits of dynamic rendering

  • Those are customizable by the customer during operation (setup via API)

  • Dynamic formats are cached (retention time configuration), so for frequently accessed content, the downloader does not have to wait for frequently accessed content

  • Saves storage, in case of Picturepark does not store them on storage which saves money for the monthly storage subscription price. 

The drawback of dynamic rendering

  • The download of multiple dynamic formats of the same Content Item is possible. 

  • Rendering on request (lazy) may take some time until Picturepark generates the output is generated from Picturepark. Picturepark will notify you when you can access the ready-to-download file.

    Image RemovedImage Added

    You can continue working in Picturepark while waiting for your download to be ready. 

  • Only available to produce images (rasterized files). 

  • Costs performance of rendering microservice.  

...

Expand
titlePreviews

Previews

Previews are static formats, available for File Types. 

  • The standard windows server fonts are installed on our rendering server and will be applied and rendered to document previews. Any other fonts will be substituted.

  • A You see a file format icon based on the default file extension for that file format when Picturepark couldn’t render a preview e.g. Indd for Indesign files - is shown where no preview outputs can be rendered.

  • The original file is also available - accessing (download) the Original File can be restricted with Content Permissions. 

You cannot restrict Access/Download of previews, but it is possible that you add a watermark to Preview which is then also applied to other Formats and Thumbnails derived from the Preview. Check for formats and thumbnails if their rendering source is the Preview format to ensure that the Watermark is applied everywhere.   

Picturepark generates the following previews for supported file formats.

No

Preview name

Height Size (max)

Width (max)

Color profile

File Format

Quality

DPI (Vertical/Horizontal

Keep Clipping Path

Bit rate

Restrict Access/Download

Preview

1600px

1600pxNotes

Preview

1600x1600

SRGB

.jpg

95

Original

False

  • DPI original

  • No clipping path

  • Can't restrict Access/Download

Thumbnail

Large

320px320x320

320px

Original

.jpg

95

Original

False

No

Thumbnail

Medium

200px

220px200x220

Original

.jpg

95

Original

False

No

Thumbnail

Small

90px90x120

120px

Original

.jpg

95

Original

False

No

Video

Keyframes (these are Small thumbnails used in UI for Video Thumb-Slider in player)

160px

160px 160x160 (per sprite max 50 sprites)

RGB

.jpg

80

72

NA

No

Pdf

(These PDFs are used for display in the document viewer (even though a pdf would have an original it may be too large to make a good document viewer pdf i.e. to display on mobile so we render a format for this.)

NA


.pdf

90

No

Video

Small

360px360x480

480px


.mp4

No


Video

Large

1280px

720px1280x720


.mp4No


Audio

Small

NA

NA

.mp3

128kb/ps


No.mp3


Expand
titleCreate a Dynamic Format

Create a Download Format / Output Format

The static formats are created on customer creation. Check Format Modifications for your desired settings. 

The dynamic formats are created via API: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_Create . It is recommended to test your settings using the preview operation, which allows generating a temporary preview of your desired output to validate your settings: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_RenderFormatPreview  based on the actual Content Items of your Picturepark. 

Filter by label (Content by label)
showLabelsfalse
max20
showSpacefalse
titleExamples
excerptTypesimple
cqllabel = "output-format" and label = "solution" and space = "SOL"

Expand
titleUpdate a Download Format / Output Format

Update a Download Format / Output Format

You cannot update static format attributes (e.g. resizing). You can however update attributes like:  

  • XMP Writeback (enableXmpWriteback; boolean)

  • Filename pattern used when the file is downloaded (downloadFileNamePatterns; string translated)

  • Permission to access output formats even if the source is not accessible (viewForAll; boolean)

You can update output formats using the API: https://demo.picturepark.com/Docs/Rest/index.html#operation/OutputFormat_Update

Apply Resize Action

PUT: {{apiHost}}/v1/outputformats/{id}

Code Block
languagejson
{
    "id": "MyFirstFormat",    
    "names": {
        "en": "My first format"
    },
    "sourceOutputFormats": {
        "image": "Original",
        "video": "VideoPreview",
        "document": "DocumentPreview",
        "audio": "AudioPreview",
        "vector": "VectorPreview"
    },
    "format": {
        "kind": "JpegFormat",
        "resizeAction":{
        	"width":50,
        	"height":50,
        	"resizeMode":"fit"
        }
    }
}