All possible parameters?

[sidonaldson]

Excuse me if this has been asked before - I've searched everywhere!

Is there any documentation for a full list of param to pass through to Sharp? The demo UI has been a good help but is there more?

[dougtoppin]

@sidonaldson Unfortunately, a complete list of Sharp supported functions it not in the current solution documentation.

Our backlog includes updating the documentation with both a complete list of supported functions for both Sharp and Thumbor style requests and including more examples of various requests.

For now, if you look at *source/image-handler/image-handler.ts * you will see the applyEdits which has the request mapping.

[dougtoppin]

@sidonaldson Something to note is that many sharp supported functions can be passed using the function name.

All of them have not been tested but when using the base64encoded request style, try using the sharp function.

For example, to specify the desired output format toFormat can be used.

const imageRequest = JSON.stringify({
    bucket: bucket,
    key: key,
    edits: {
        resize: {
            width : 400,
            height: 200,
            fit: 'cover',
        },
        toFormat: 'jpeg'
    }
});

For thumbor style requests, the filters are documented at https://docs.aws.amazon.com/solutions/latest/serverless-image-handler/thumbor-filters.html

[sidonaldson]

@dougtoppin this is great thanks! and I appreciate how documentation is always hard to maintain and update.

We've successfully implemented the service in our own stack now!

One thing that has cropped up (literally) is the desire to crop by only specifying one dimension. Is that possible via the URL? i.e. /1000/image.jpg instead of /1000x800/image.jpg so the proportion is kept but the image is just reduced?

[td234]

I am wondering the same things. I did find a solution for you. If you pass a zero as one dimension it will retain h:w ratio. So, pass /image/1000x0/image.jpg

Have you figured out how to pass 'cover' or 'fill' in the URL?