Creates a new image URL based on the given Config, Attributes and original image URL.

Attributes can occur in any order. If an attribute is specified multiple times, the last occurrence wins - very much like how elm/html attributes work.

You might want to use currying to ease usage of this package:

thumbor : List Thumbor.Attribute -> String -> String
thumbor =
    Thumbor.url
        { host = "https://example.com:1138"
        , key = Just "thefutureishere"
        }


-- Prepare a common configuration for teaser images
prepareTeaserImage : String -> String
prepareTeaserImage =
    thumbor [ Thumbor.scale 200 300 ]


-- Actually use this package to create a modified image
view : Model -> Html msg
view model =
    img [ src (prepareTeaserImage "https://example.com/image.jpg") ] []

Thumbor server configuration. The baseUrl configures the base URL your Thumbor instance is hosted on. It must contain at least an URL schema and host and can contain a custom port or path.

key contains your key for URL signing. If Nothing is provided, URL signing will be disabled.

Important Security Notice: Since Elm is mostly used in front-end code, your key will be exposed in clear-text to all clients, nullifying the effect of this security measure.

Make sure you have an alternate concept to stop URL tampering!

Examples:

{ baseUrl = "https://example.com"
, key = Just "thefutureishere"
}


{ baseUrl = "https://example.com/thumbor"
, key = Just "thefutureishere"
}


{ baseUrl = "https://example.com:1138/thumbor"
, key = Just "thefutureishere"
}

Represents a Thumbor attribute, controlling how images are processed. See below for a list of available attribute constructors.

Specifies the size of the image that will be returned by the service.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#image-size

Same as size, but always uses Fixed sizing for convenience.

Useful for applications that provide custom real-time cropping capabilities. This crop is performed before the rest of the operations, so it can be used as a prepare step before resizing and smart-cropping.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#manual-crop

Controls where the cropping will occur if some width needs to be trimmed. The default is Center.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#horizontal-align

Controls where the cropping will occur if some height needs to be trimmed. The default is Middle.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#vertical-align

Removes surrounding space in images based on its color. You can pass in the source where the color should be sampled with a TrimSource. In addition, you can specify a color tolerance with the second parameter. The tolerance value will be clamped between 0 and 442.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#trim

Same as trim, but always uses TopLeft source and 0 tolerance.

Specifies that the image should not be auto-cropped and auto-resized to be exactly the specified size, and should be fit in an imaginary box (given by the sizing argument) instead.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#fit-in

Sets a list of filters as a chain to be used. See Thumbor.Filter for available filters and their usage.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#filters

Thumbor uses some advanced techniques for obtaining important points of the image, called focal points.

If you use this attribute, smart cropping will be performed and will override both horizontal and vertical alignments if it finds any focal points.

Thumbor docs: https://thumbor.readthedocs.io/en/latest/usage.html#smart-cropping