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 ldpi, mdpi, hdpi and xhdpi assets from the source image.

Requirements

  • PIL (tested with version 1.1.7, may work with earlier versions)

Installing

$ pip install android-asset-resizer

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-ldpi
    - icon.png
  - drawable-mdpi
    - icon.png
  - drawable-hdpi
    - icon.png
  - drawable-xhdpi
    - 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_

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)

Publishing

# Register with pypi (only done once)
$ python setup.py register

# Upload a new binary distribution to pypi
$ python setup.py bdist_egg upload

# Upload a new source distribution to pypi
$ python setup.py sdist upload

Bug reports

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

License

See the LICENSE file.

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.0.1.tar.gz (9.7 kB view hashes)

Uploaded Source

Built Distribution

android_asset_resizer-1.0.1-py2.7.egg (10.6 kB view hashes)

Uploaded Source

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