Gif images are a different beast than regular images. They are encapsulated “programs” which run and animate an image. They cannot simply be “cropped” down to a new size because each frame must be “cropped”. Often times, GIFs are even smart enough to compress themselves so that only parts of the image are animated to make them smaller.
As such, they do not fit into the regular flow of Blitline. They must be handled specially, or they will just be output as static single files (usually the first image in the GIF).
Animated GIFs must be specified with a “src_type” : “gif”, and the function that operates on the gif must be specified in the “src_data” element:
For example:
{
"application_id": "YOUR_APP_ID",
"src": "https:\/\/s3.amazonaws.com\/img.blitline\/sample.gif",
"postback_url": "https:\/\/blitline.com\/stats",
"src_type": "gif",
"src_data": {
"name": "resize_gif",
"params": {
"width": 100,
"height": 100
},
"save": {
"image_identifier": "foo",
"s3_destination": {
"bucket": "bltemp.shortlife",
"key": "grumpy_squirrel\/out\/out.gif"
}
}
}
}
There are 3 operation we support for manipulating GIFs, you can find examples below:
Resize Gif
{
"application_id":"YOUR_APP_ID",
"src":"https://s3.amazonaws.com/img.blitline/sample.gif",
"src_type" : "gif",
"src_data" : {
"name" : "resize_gif",
"params" : {
"width" : 100,
"height" : 100
},
"save" : {
"image_identifier": "foo",
"s3_destination":{
"bucket":"bltemp.shortlife",
"key":"grumpy_squirrel/out/out.gif"
}
}
}
}
Resize Gif to Fit
{
"application_id":"YOUR_APP_ID",
"src":"https://s3.amazonaws.com/img.blitline/sample.gif",
"src_type" : "gif",
"src_data" : {
"name" : "resize_gif_to_fit",
"params" : {
"width" : 100,
"height" : 100
},
"save" : {
"image_identifier": "foo",
"s3_destination":{
"bucket":"bltemp.shortlife",
"key":"grumpy_squirrel/out/out.gif"
}
}
}
}
Gif Overlay
Overlays an image onto an animated gif.
{
"application_id":"YOUR_APP_ID",
"src":"https://s3.amazonaws.com/img.blitline/sample.gif",
"src_type" : "gif",
"src_data" : {
"name" : "gif_overlay",
"params" : {
"overlay_src" : "http://localtion-of-overlay-image"
},
"save" : {
"image_identifier": "foo",
"s3_destination":{
"bucket":"bltemp.shortlife",
"key":"grumpy_squirrel/out/out.gif"
}
}
}
}
Convert Gif to Video File
Will take an animated GIF and turn it into an mp4 video.
You MUST provide an S3 Destination for gif_to_vid functionality.
{
"application_id": "YOUR_APP_ID",
"src": "https://s3.amazonaws.com/blitdoc/gifs/superbowl.gif",
"src_type": "pre_process_only",
"pre_process": [
{
"gif_to_vid": {
"loop_count": 4,
"s3_destination": {
"bucket": "bltemp.shortlife",
"key": "grumpy_squirrel/movified_gif_4.mp4"
}
}
}
]
}