Skip to main content

A command-line utility for generating Android drawables in the required densities.

Project description

The Android asset resizer can be used to generate drawable assets from a larger source image, like an iOS @2x asset or an xhdpi drawable.

The script will generate the expected mdpi, hdpi, xhdpi and xxhdpi assets from the source image.

If you like this library and it’s saved you some time, please consider supporting further development with a Gittip donation!

Requirements

Installing

$ pip install android-asset-resizer

If you’d like to use the pillow imaging library instead of PIL you can install the script with this command:

$ pip install --no-deps android-asset-resizer && pip install pillow

Examples

You can easily generate Android assets from your @2x iOS assets:

$ aaresize assets/icon@2x.png

Running this command will generate the following assets:

- res
  - drawable-mdpi
    - icon.png
  - drawable-hdpi
    - icon.png
  - drawable-xhdpi
    - icon.png
  - drawable-xxhdpi
    - icon.png

These assets were created from the original @2x asset where the icon in the drawable-xhdpi folder is just a copy of the original.

You can also resize an entire directory of images:

$ aaresize assets/*@2x.png

An Android xhdpi asset is roughly equivalent to an @2x asset, so you can easily resize those too:

$ aaresize res/drawable-xhdpi/*.png

If you have a large drawable-xxhdpi asset you can use the --density flag to generate the smaller assets:

$ aaresize res/drawable-xxhdpi/*.png --density=xxhdpi

You can also easily add a prefix to your new assets:

$ aaresize assets/*@2x.png --prefix=ic_

Use the --ldpi flag to generate low density assets:

$ aaresize res/drawable-xhdpi/*.png --ldpi

Use the --exclude flag to specify a list of files that should not be resized:

$ aaresize res/drawable-xhdpi/*.png --exclude=ic_launcher.png,ic_status.png

You can also import the AssetResizer class and incorporate it into your own scripts:

from PIL import Image
from android_asset_resizer.resizer import AssetResizer

# Create our resizer
resizer = AssetResizer(out_dir, source_density='xhdpi',
    prefix='ic_', image_filter=Image.ANTIALIAS)

# Make our resource directories
resizer.mkres()

# Resize an image
resizer.resize(path)

Bug reports

If you encounter any issues, please open a new issue on the project’s GitHub page.

License

Copyright 2013 Tristan Waddington

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

android-asset-resizer-1.3.1.tar.gz (10.1 kB view hashes)

Uploaded Source

Built Distribution

android_asset_resizer-1.3.1-py2.py3-none-any.whl (9.3 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page