Java client for the Thumbor image service which allows you to build URIs in an expressive fashion using a fluent API.
This library is also fully compatible with the Android platform.
Download the latest JAR or grab via Maven:
<dependency>
<groupId>com.squareup</groupId>
<artifactId>pollexor</artifactId>
<version>2.0.4</version>
</dependency>
or Gradle:
compile 'com.squareup:pollexor:2.0.4'
Snapshots of the development version are available in Sonatype's snapshots
repository.
// Without encryption:
Thumbor thumbor = Thumbor.create("http://example.com/");
// With encryption:
Thumbor thumbor = Thumbor.create("http://example.com/", "key");
thumbor.buildImage("http://example.com/image.png")
.resize(48, 48)
.toUrl()
// Produces: /unsafe/48x48/example.com/image.png
thumbor.buildImage("http://example.com/image.png")
.crop(10, 10, 90, 90)
.resize(40, 40)
.smart()
.toUrl()
// Produces: /unsafe/10x10:90x90/smart/40x40/example.com/image.png
thumbor.buildImage("http://example.com/image.png")
.crop(5, 5, 195, 195)
.resize(95, 95)
.align(BOTTOM, RIGHT)
.toUrl()
// Produces: /unsafe/5x5:195x195/right/bottom/95x95/example.com/image.png
thumbor.buildImage("http://example.com/background.png")
.resize(200, 100)
.filter(
roundCorner(10),
watermark(thumbor.buildImage("http://example.com/overlay1.png").resize(200, 100)),
watermark(thumbor.buildImage("http://example.com/overlay2.png").resize(50, 50), 75, 25),
quality(85)
)
.toUrl()
// Produces: /unsafe/200x100/filters:round_corner(10,255,255,255):watermark(/unsafe/200x100/example.com/overlay1.png,0,0,0):watermark(/unsafe/50x50/example.com/overlay2.png,75,25,0):quality(85)/example.com/background.png
Note: If you are using a version of Thumbor older than 3.0 you must call
legacy()
to ensure the encryption used will be supported by the server.
Copyright 2012 Square, Inc.
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.