0.16.1 • Published 8 years ago

ikona v0.16.1

Weekly downloads
3
License
ISC
Repository
github
Last release
8 years ago

Ikona (Εικόνα)

CLI tool for image processing

Brush

Install & Run

sudo npm install -g ikona

Then from your command line just type ikona

Now you can use the following commands:

Commands

###help [command]

Displays helpful information for a command. e.g. help resize

Example

help resize

HELP

###exit

Exits from the cli

###resize <imageDir>

Resizes an image.

Example

resize realcat.jpg -h 200 -w 200 -o resizecat

Cat Cat2

Options
OptionDescription
-hThe height of the new imageOptional, default="auto"
-wThe width of the new imageOptional, default="auto"
-oThe name of the new fileOptional, default="chroma.jpg"
-mThe algorithm that will be used for resizingBilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier, default=Bilinear

###scale <imageDir>

Scale an image by the given factor

Example

scale realcat.jpg -f 1.5 -o bigcat

Cat Cat2

Options
OptionDescription
-fScale factorOptional, default=2
-oThe name of the new fileOptional, default="chroma.jpg"
-mThe algorithm that will be usedBilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier, default=Bilinear

###scaletofit <imageDir>

Scale the image to the largest size that fits inside the given width and height

Example

scaletofit realcat.jpg -h 450 -w 500 -o scaletofitcat

Cat Cat2

Options
OptionDescription
-hThe height of the new imageOptional, default="auto"
-wThe width of the new imageOptional, default="auto"
-oThe name of the new fileOptional, default="chroma.jpg"
-mThe algorithm that will be usedBilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier, default=Bilinear

###cover <imageDir>

Scale the image to the given width and height, some parts of the image may be clipped

Example

cover realcat.jpg -h 300 -w 100 -o covercat

Cat Cat2

Options
OptionDescription
-hThe height of the new imageOptional, default="auto"
-wThe width of the new imageOptional, default="auto"
-oThe name of the new fileOptional, default="chroma.jpg"
-mThe algorithm that will be usedBilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier, default=Bilinear

###contain <imageDir>

Scale the image to the given width and height, some parts of the image may be letter boxed

Example

contain realcat.jpg -h 200 -w 250 -o containcat

Cat Cat2

Options
OptionDescription
-hThe height of the new imageOptional, default="auto"
-wThe width of the new imageOptional, default="auto"
-oThe name of the new fileOptional, default="chroma.jpg"

###swap <imageDir> <channel1> <channel2>

Swap the color channels of an image

Example

swap realcat.jpg green blue

Cat Cat2

Options
OptionDescription
-hThe height of the new imageOptional, default="auto"
-wThe width of the new imageOptional, default="auto"
-oThe name of the new fileOptional, default="chroma.jpg"
-mThe algorithm that will be used for resizingBilinear, Nearest_Neighbor, Bicubic, Hermite, Bezier, default=Bilinear

###crop <imageDir>

Crop an image on the given points

Example

crop realcat.jpeg -x 20 -y 20 -h 70 -w 70 -o croppedcat

Cat Cat2

Options
OptionDescription
-xStarting point in the x axisOptional, default=0
-yStarting point in the y axisOptional, default=0
-hThe height of the new imageOptional, default=250
-wThe width of the new imageOptional, default=250
-oThe name of the new fileOptional, default="chroma.jpg"

###brightness <imageDir>

Adjust the brighness by a value -1 to +1

Example

brightness realcat.jpg -f 0.5 -o brightcat

Cat Cat2

Options
OptionDescription
-fBrightness factorOptional, default=1
-oThe name of the new fileOptional, default="chroma.jpg"

###contrast <imageDir>

Adjust the contrast by a value -1 to +1

Example

contrast realcat.jpg -f 0.5 -o contrastcat

Cat Cat2

Options
OptionDescription
-fContrast factorOptional, default=1
-oThe name of the new fileOptional, default="chroma.jpg"

###grey <imageDir>

Remove colour from the image

Example

grey realcat.jpg -o greycat

Cat Cat2

Options
OptionDescription
-oThe name of the new fileOptional, default="chroma.jpg"

###normalize <imageDir>

Normalize the channels in an image

Example

normalize realcat.jpg -o normalcat

Cat Cat2

Options
OptionDescription
-oThe name of the new fileOptional, default="chroma.jpg"

###invert <imageDir>

Normalize the channels in an image

Example

invert realcat.jpg -o invertcat

Cat Cat2

Options
OptionDescription
-oThe name of the new fileOptional, default="chroma.jpg"

###dominant <imageDir>

Displays the dominant colors of an image

Example

dominant abstract.jpg -h

Options
OptionDescription
-hDisplays the colors in hex format
-wDisplays the colors in rgba format

###fade <imageDir>

Multiply the alpha channel by each pixel by the factor f, 0 - 1

Example

fade realcat.jpg -f 0.5 -o fadecat

Options
OptionDescription
-fFade factorOptional, default=1
-oThe name of the new fileOptional, default="chroma.jpg"

###sepia <imageDir>

Apply a sepia wash to the image

Example

sepia realcat.jpg -o sepiacat

Cat Cat2

Options
OptionDescription
-oThe name of the new fileOptional, default="chroma.jpg"

###posterize <imageDir>

Apply a posterization effect with f factor

Example

posterize realcat.jpg -f 5 -o postercat

Cat Cat2

Options
OptionDescription
-fPosterize factorOptional, default=1
-oThe name of the new fileOptional, default="chroma.jpg"

###rotate <imageDir>

Rotate the image clockwise by a number of degrees.

Example

rotate realcat.jpg -d 30 -o rotatedcat

Cat Cat2

Options
OptionDescription
-dDegreesOptional, default=90
-oThe name of the new fileOptional, default="chroma.jpg"

###flip <imageDir>

Rotate the image clockwise by a number of degrees.

Example

flip realcat.jpg -h -o flippedcat

Cat Cat2

Options
OptionDescription
-hHorizontally
-vVertically
-oThe name of the new fileOptional, default="chroma.jpg"