Thumbnails

Avatar

Background image

Login background image

Emblem

Icon

Images

Profile header background

Teaser image

Custom Thumbnails

Since API version 1.3.6, custom thumbnail sizes can be requested using urls like /files/{eid}/?w=200&h=100.

The w and h parameters represent the desired width and height respectively. The following rules apply for the returned thumbnail:

• The image will be scaled proportionally. This means when a width of 200 and a height of 100 is requested, the image will be scaled to fit inside these dimensions, but may not have those exact dimensions if the aspect ratio of the image is not 2:1
• The image will never be enlarged. If the image already fits within the requested dimensions, it will be returned in its original size.
• It’s possible to provide only the w or h parameter. The image will be scaled proportionally to fit within that width or height.
• When a specific thumbnail size is requested for the first time, a lower-quality version may be returned at first. A high-quality version may be generated asynchronously, so that subsequent requests for that thumbnail will result in a high-quality thumbnail. Note that the difference between the lower-quality and the high-quality thumbnails is generally hard to see.

To prevent abuse, not all combinations of width and height are allowed. The following table shows the possible combinations. For any of the listed combinations, it is also possible to use only one of the components (w or h). Some values are only allowed for certain kinds of source images.