Compressor Head is a web application for compressing/scaling an image before downloading it. It is built on Python and hosted on the Google App Engine.
Compressor Head compresses images to the desired resolution before passing these images back to the user to download. This saves data and storage resources.
Running on the Google App Engine, the image conversion is nearly instantaneous. The usage of the memcache library also speeds up the conversion process if the same image has been retrieved previously.
- Usage
- Usage example
- Working with the project
- API reference
- Set up Compressor-head in Google Cloud Platform
- Author
- Contact us
- Copyright
URL - http://compressor-head.appspot.com/image/?image_url=[IMAGE_URL]&width=[WIDTH]&height=[HEIGHT]&format=[FORMAT]
Where
*IMAGE_URL* is the URL of the image which is to be compressed.
*WIDTH* is the desired width.
*HEIGHT* is the desired height.
*FORMAT* is the desired image format (Supported formats - JPEG, PNG and WEBP).
Both WIDTH and HEIGHT should be integers greater than or equal to 0:
- If both are 0, the image will not be scaled.
- If one of the two is 0, it will scale that non-zero dimension and the other dimension will be scaled such that the aspect ratio remains the same.
- If both are greater than 0, both the width and height will scale accordingly, which may change the aspect ratio of the image.
Sample Image URL - http://compressor-head.appspot.com/image
This is a 5.8 MB JPEG image, with dimensions of 5649×3684
To resize the image -
- Resize (Width) :
http://compressor-head.appspot.com/image/?image_url=http://compressor-head.appspot.com/image&width=500&height=0&format=jpegNote: This retains the aspect ratio of the image, and the height is scaled accordingly.
This returns an image 37 KB JPEG image with dimensions 500x326
- Resize (Height) :
http://compressor-head.appspot.com/image/?image_url=http://compressor-head.appspot.com/image&width=0&height=250&format=pngNote: This retains the aspect ratio of the image, and the width is scaled accordingly.
This returns an image 164 KB PNG image with dimensions 383x250
- Resize (Width & Height) :
http://compressor-head.appspot.com/image/?image_url=http://compressor-head.appspot.com/image&width=500&height=350&format=jpegNote: This may change the aspect ratio of the image.
This returns an image 41 KB JPEG image with dimensions 500x350
Note: You can also use the WEBP format, but it's not shown as an example as GitHub does not render WEBPs. A sample WEBP conversion of this conversion can be found here.
If you'd like to get more hands-on with the project, check out the following documentation:
- Google App Engine (Python): Images API
- Google App Engine (Python): Memcache API
- Google App Engine (Python): URL downloading API
- Vinay Sajip: logging
- The Webapp2 Maintainers: webapp2
Before starting with steps you must have installed the lastest version of Phyton on your local machine.
-
Sign up or log in to the Google Cloud Platform Console. (important)
-
Create a new project on it.
-
In the upper left corner, click on the three perpendicular lines
, and then select API Manager.
-
In the Google Cloud APIs section, select Compute Engine API.
Install and start the Google Cloud SDK on your local machine's platform by referencing the Before you Begin and initialize the SDK sections with one of the following links below:
For any queries, chat with us here
Copyright 2017 Murad. All rights reserved.
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.