IMGART it's an HTTP service for image processing based on filters and profiles.
Documentation: https://imgart.onrender.com/api/v1/docs
git clone [email protected]:Talento90/imgart.git
make deps
docker-compose up
or make docker
open http:localhost:4005
{host}/api/v1/images?imgSrc={0}&profile={1}&filters={2}
Example
https://imgart.onrender.com/api/v1/images?imgSrc=https://goo.gl/mq7yPD&profile=example&filters=[{"id":"rotate","parameters":{"angle":-90}}]
Result
The engine behind image manipulation is the fabulous library: github.com/disintegration/
Available Effects
Effect | JSON | Result |
---|---|---|
overlay | {"id":"overlay","parameters":{"position":[25,75],"url":"https://goo.gl/UBrXeo","opacity":100}} |
|
resize | {"id":"resize","parameters":{"width":25,"height":50,"filter":"linear"}} |
|
crop | {"id":"crop","parameters":{"rectangle":[0,0,202,150]}} |
|
rotate | {"id":"rotate","parameters":{"angle":-90,"bgcolor":"transparent"}} |
|
blur | {"id":"blur","parameters":{"sigma":0.9} |
|
brightness | {"id":"brightness","parameters":{"percentage":-50}} |
|
contrast | {"id":"contrast","parameters":{"percentage":100}} |
|
gamma | {"id":"gamma","parameters":{"gamma":0.2}} |
It's possible to combine multiple effects:
/api/v1/images?imgSrc=https://raw.githubusercontent.com/Talento90/imgart/master/assets/gopher.png&filters=[{"id":"overlay","parameters":{"position":[25,75],"url":"https://goo.gl/UBrXeo"}},{"id":"overlay","parameters":{"position":[22,-35],"url":"https://goo.gl/aEkkDh"}}, {"id":"crop","parameters":{"rectangle":[0,0,202,150]}}]
If you don't want to specify filters in URL, you can create a profile with all pre configured filters and then use it in query parameters &profile={profile-id}
.
Create Profile
POST /api/v1/profiles
{
"id": "my-profile",
"filters": [
{ "id": "brightness", "parameters":{ "percentage":0.3}},
{ "id": "crop", "parameters":{"rectangle":[0,0,100,200]}}
]
}
Using profile in query parameters
GET /api/v1/images?imgSrc={image url}&profile=my-profile