@smartface/image-processor

1.2.6 • Public • Published

image-processor npm version

Generates imagesets for iOS and drawables for Android

Installation

npm i -g @smartface/image-processor

Usage

sfImageProcessor  --srcImage [IMAGE-PATH] --destiOSFolder [DEST_IOS_FOLDER] --destAndroidFolder [DEST_ANDROID_FOLDER]

--srcImage         : must be absolute path (required)
--destiOSFolder    : must be absolute path (required)
--destAndroidFolder: must be absolute path (required)
--scaleFactor      : scale factor of given 'srcImage' float value ( 1.5, 3) (optional)
--delete           : flag -> delete images from 'destiOSFolder' and 'destAndroidFolder' (optional)
--isIconImage      : flag -> generate given image as AppIcon (icons)    
--isLaunchImage    : flag -> generate given image as LaunchImage (splash images)   
--minimize         : flag -> minimizes image that will be generated as possibly as. default value is false (optional) 

Example input: smartface.png, smartface.ios.png, smarface.android.4x.png

Description

  1. parse srcImage
    • image(.$(OS))(.$(SCALE)).png
  2. generate images by $(OS) and $(SCALE)

Default $(SCALE) is 3x

Examples

srcImage=smartface.png

sfImageProcessor --srcImage=/images/smartface.png --destAndroidFolder=/android --destiOSFolder=/ios

Generates:

- /ios/smartface.imageset
    - smartface.png
    - smartface@2x.png
    - smartface@3x.png
- /android/drawable-mdpi/smartface.png
- /android/drawable-hdpi/smartface.png
- /android/drawable-xhdpi/smartface.png
- /android/drawable-xxhdpi/smartface.png

srcImage=smartface.ios.png

sfImageProcessor --srcImage=/images/smartface.ios.png --destAndroidFolder=/android --destiOSFolder=/ios

Generates:
    
- /ios/smartface.imageset
    - Contents.json   
    - smartface.png
    - smartface@2x.png
    - smartface@3x.png

srcImage=smartface.ios.2x.png

sfImageProcessor --srcImage=/images/smartface.ios.2x.png --destAndroidFolder=/android --destiOSFolder=/ios

Generates:
    
- /ios/smartface.imageset
    - Contents.json   
    - smartface.png
    - smartface@2x.png

srcImage=smartface.android.4x.png

sfImageProcessor --srcImage=/images/smartface.android.4x.png --destAndroidFolder=/android --destiOSFolder=/ios

Generates:
    
- /android/drawable-mdpi/smartface.png
- /android/drawable-hdpi/smartface.png
- /android/drawable-xhdpi/smartface.png
- /android/drawable-xxhdpi/smartface.png
- /android/drawable-xxxhdpi/smartface.png

You can generate AppIcon (icons)

given srcImage size should be 1024 X 1024 at least.

sfImageProcessor --srcImage=/images/icon.png --destAndroidFolder=/android --destiOSFolder=/ios --isIconImage=true

Generates:

- /ios/AppIcon.appiconset
    - Icon-40.png
	- Icon-40@2x.png
	- Icon-60@2x.png
	- Icon-72.png
	- Icon-72@2x.png
	- Icon-76.png
	- Icon-76@2x.png
	- Icon-Small-50.png
	- Icon-Small-50@2x.png
	- Icon-Small.png
	- Icon-Small@2x.png
	- Icon.png
	- Icon@2x.png
	- Icon-Small@3x.png
	- Icon-40@3x.png
	- Icon-60@3x.png
	- Icon-40@2x.png
	- Icon-Small.png
	- Icon-Small@2x.png
	- Icon-83.5@2x.png
	- NotificationIcon@2x.png
	- NotificationIcon@3x.png
	- NotificationIcon~ipad.png
	- NotificationIcon~ipad@2x.png
	- ios-marketing.png
- /android/drawable-mdpi/icon.png
- /android/drawable-hdpi/icon.png
- /android/drawable-xhdpi/icon.png
- /android/drawable-xxhdpi/icon.png
- /android/drawable-xxxhdpi/icon.png
- /android/drawable/icon.png

You can generate LaunchImage (splash images)

given srcImage size should be 2208 X 2208 at least.

sfImageProcessor --srcImage=/images/splash.png --destAndroidFolder=/android --destiOSFolder=/ios --isLaunchImage=true

Generates:

- /ios/LaunchImage.launchimage
	- Default-Portrait-2436h@3x.png
	- Default-Landscape-2436h@3x.png
	- Default.png
	- Default@2x.png
	- Default-568h@2x.png
	- Default-568h@2x.png
	- Default@2x.png
	- Default~ipad.png
	- Default~ipad@2x.png
	- Default~ipad~landscape.png
	- Default~ipad~landscape@2x.png
	- Default~ipad~nostatusbar.png
	- Default~ipad~nostatusbar.png
	- Default~ipad~nostatusbar@2x.png
	- Default~ipad~nostatusbar@2x.png
	- Default~ipad~landscape~nostatusbar.png
	- Default~ipad~landscape~nostatusbar.png
	- Default~ipad~landscape~nostatusbar@2x.png
	- Default~ipad~landscape~nostatusbar@2x.png
	- Default-Portrait-736h@3x.png
	- Default-Landscape-736h@3x.png
	- Default-667h@2x.png
- /android/drawable-mdpi/splash_image.png
- /android/drawable-hdpi/splash_image.png
- /android/drawable-xhdpi/splash_image.png
- /android/drawable-xxhdpi/splash_image.png
- /android/drawable-xxxhdpi/splash_image.png
- /android/drawable/splash_image.png

Note

If --delete flag is set, deletes generated images.

Package Sidebar

Install

npm i @smartface/image-processor

Weekly Downloads

13

Version

1.2.6

License

ISC

Unpacked Size

37.7 kB

Total Files

17

Last publish

Collaborators

  • sbasbug
  • alnyli07
  • smf
  • furkan.arabaci