Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/square/pollexor
Java client for the Thumbor image service which allows you to build URIs in an expressive fashion using a fluent API.
https://github.com/square/pollexor
Last synced: 4 days ago
JSON representation
Java client for the Thumbor image service which allows you to build URIs in an expressive fashion using a fluent API.
- Host: GitHub
- URL: https://github.com/square/pollexor
- Owner: square
- License: apache-2.0
- Created: 2012-07-17T18:06:03.000Z (over 12 years ago)
- Default Branch: trunk
- Last Pushed: 2024-02-07T20:44:01.000Z (9 months ago)
- Last Synced: 2024-04-13T17:52:11.128Z (7 months ago)
- Language: Java
- Homepage: https://square.github.io/pollexor/
- Size: 281 KB
- Stars: 641
- Watchers: 22
- Forks: 87
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.txt
Awesome Lists containing this project
- awesome-thumbor - GitHub - 16% open</span> · <span title="Last update timestamp on package manager" alt="Last update timestamp on package manager">⏱️ 07.08.2024</span>): (Java Integration & URL Generation)
README
Pollexor - Java Thumbor client by Square
========================================
Java client for the [Thumbor image service][1] 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
--------
Download [the latest JAR][2] or grab via Gradle:
```groovy
implementation 'com.squareup:pollexor:3.0.0'
```
or Maven:
```xml
com.squareup
pollexor
3.0.0
```
Snapshots of the development version are available in [Sonatype's `snapshots` repository][snap].
Examples
--------
```java
// Without encryption:
Thumbor thumbor = Thumbor.create("http://example.com/");
// With encryption:
Thumbor thumbor = Thumbor.create("http://example.com/", "key");
```
```java
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
```
License
=======
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.
[1]: https://github.com/globocom/thumbor
[2]: https://search.maven.org/remote_content?g=com.squareup&a=pollexor&v=LATEST
[snap]: https://s01.oss.sonatype.org/content/repositories/snapshots/