Spork

Spork is a utility by Appcelerator for generating images in a variety of sizes for Titanium.

It provides convenient ways of generating application icons, splash screens, and images for things like buttons at a variety of sizes and resolutions to accomodate different platforms (iOS, Android, Mobile Web) from single sources.

Note that Spork depends on having an install of the amazing utility ImageMagick and, in particular, the convert command line utility.

Current Status

July 20, 2012 - Unstable

Installation

Spork is available as a Node.JS NPM module by running the following command:

[sudo] npm install -g tispork

Local Installation

To install your own local copy (with executable), clone this repository, navigate to the top level directory, and install via:

[sudo] npm install -g .	

Running Spork fromt the command line

You can run the spork utility from the command line using node.

Usage: tispork [options] [command]

Commands:

icons <project-dir>
Generate from a master icon, appicon.png, program icons for all platforms.

splashes <project-dir>
Generate from two master splash screens, Portrait.png and Landscape.png, splash screens for the specified platforms.

assets <project-dir> <assets-folder>
Generate multiple resolutions of assets from high res assets. Assumes your assets are all in the <project-dir>/images/<asset-folder>.

Options:

-h, --help       output usage information
-V, --version    output the version number
-a, --android    Generate Android assets
-i, --ios        Generate iOS (iPhone/iPad) assets
-m, --mobileweb  Generate mobile web (HTML5) assets
-d, --debug      For debugging, output all commands to the console.
-w, --width <n>  For assets command only, width in pixels of the smallest size of the image.
-3, --three      For assets command and Android only, generate image at scale 3 in the 3:4:6:8 ratio, where 8 is the original size
-4, --four       For assets command and Android only, generate image at scale 4 in the 3:4:6:8 ratio, where 8 is the original size
-6, --six        For assets command and Android only, generate image at scale 6 in the 3:4:6:8 ratio, where 8 is the original size
-8, --eight      For assets command and Android only, generate image at scale 8 in the 3:4:6:8 ratio, where 8 is the original size
-r, --retina     For assets command and iOS only, source image is considered to be for retina display @2x, generate 50% scaled version. Similar to 4:8 in the 

3:4:6:8 Android ratio. --all For assets command, generate assets for all sizes for the specified platforms

Included in the install are three PSD files that have guides and layers that display how clipping is to occur so that you can position your logo and other assets correctly.

To Do

• Need to handle variable appicon sizes for Android

Credits

Legal

Alloy is developed by Appcelerator and the community and is Copyright (c) 2012 by Appcelerator, Inc. All Rights Reserved. Alloy is made available under the Apache Public License, version 2. See the LICENSE file for more information.