ht t p: / / el ect r oni cs. henni ngkar l sen.

com ( C) 2013 Henni ng Kar l sen

Image Converters
Part of the UTFT Tools suite

Manual


UTFT I mage Conver t er s Page 1
ImageConverter565.exe:


Filename: When a suppor t ed i mage f i l e has been opened t hi s f i el d wi l l show t he
name of t he f i l e ( wi t hout a f i l e ext enst i on) .

Dimensions: Shows t he di mensi ons of t he cur r ent l y l oaded i mage i n pi xel s.

Converted Size: Shows t he si ze of t he conver t ed i mage wi t h t he cur r ent l y sel ect ed
opt i ons.


I f t hi s i con i s vi si bl e t he r esul t i ng c ar r ay pr oduced f r omt he i mage
wi l l not be abl e t o compi l e. Thi s i s due t o a l i mi t at i on i n t he AVR- GCC
compi l er .
These l i mi t at i ons i s onl y appl i cabl e f or t he Ar dui no ( AVR) t ar get
pl at f or mand onl y when savi ng as a . c f i l e.

Reduce size to: Check t hi s box t o enabl e t he i mage si ze r educt i on f eat ur es.

Lock aspect ratio When t hi s box i s checked t he wi dt h t o hei ght r at i o wi l l be l ocked when
ent er i ng new di mensi ons.

___ x ___ pixels Ent er t he desi r ed di mensi ons of t he i mage i n t hese boxes ( Wi dt h x
Hei ght ) .

Quick Select: Use t hi s dr op- down l i st t o qui ckl y sel ect one of t he pr e- sel ect ed i mage
di mensi ons. Usi ng t hi s dr op- down l i st wi l l de- sel ect t he Lock aspect
r at i o check box.

Array Name: The name of t he ar r ay when savi ng i mages as . c ar r ay f i l es.
The name i s set t o t he f i l ename of t he l oaded i mage f i l e as a def aul t .
Thi s f i el d i s di sabl ed when savi ng as . r aw f i l es as no ar r ay name i s
needed.

Save as: Sel ect what t ype of f i l e you want t o save t he i mage as.

Target Board: Sel ect what t ype of boar d t he . c ar r ay f i l e i s i ndended f or .
These r adi o but t ons wi l l be di sabl ed when Save as i s set t o . r aw.


Cl i ck t hi s but t on t o open a new i mage f or conver si on.


Cl i ck t hi s but t on t o save t he conver t ed i mage wi t h t he cur r ent set t i ngs.
A pr ogr ess bar wi l l be vi si bl e at t he bot t omof t he wi ndow dur i ng t hi s
pr ocess. An Abor t but t on wi l l al so be vi si bl e whi l e savi ng.


Cl i ck t hi s but t on t o abor t t he cur r ent conver si on/ save pr ocess.
Thi s but t on i s onl y vi si bl e dur i ng conver si on and savi ng.


Cl i ck t hi s but t on t o exi t t he pr ogr am.



UTFT I mage Conver t er s Page 2
ImgConv.exe:


Thi s command l i ne t ool can be used f or bat ch conver si ons as wel l as f or conver t i ng si ngl e
i mages.

<filespec> can be t he name of a si ngl e i mage or i t can cont ai n wi l dcar ds ( * or ?) f or
conver t i ng mul t i pl e i mages. A f ul l pat h t o t he f i l e( s) can be i ncl uded i f t he i mage( s) ar e not
i n t he cur r ent di r ect or y.
The saved f i l e wi l l have t he same f i l ename as t he i mage f i l es t hat ar e bei ng conver t ed wi t h
t he except i on t hat t he f i l e ext ensi on wi l l be changed t o . c or . r aw dependi ng on what f i l e
t ype you ar e conver t i ng t o.

You must speci f y ei t her /c t o conver t t he i mage( s) t o . c ar r ay f i l es or /r t o conver t t o . r aw
f i l e( s) .

Al l out put f i l es wi l l by def aul t be saved t o t he cur r ent di r ect or y. To r edi r ect t he out put t o
anot her di r ect or y you can speci f y t he /o <path> par amet er . The /o and t he pat h must be
separ at ed by a space.

The def aul t t ar get pl at f or mi s AVR ( Most Ar dui nos) i f t he /t par amet er i s not used. To sel ect
anot her t ar get pl at f or myou must use t he /t <platform> par amet er . Val i d pl at f or ms ar e AVR
( Most Ar dui nos) , ARM ( Ar dui no Due) and PIC32 ( chi pKi t boar ds) . The /t and t he t ar get pl at f or m
must be separ at ed by a space.
Thi s par amet er has no ef f ect when conver t i ng t o . r aw f i l es.

Thi s t ool does not change t he si ze of t he i mage( s) so you must r esi ze t hemt o t he desi r ed si ze
bef or e r unni ng t he conver si on.

Examples:
To conver t al l t he PNG i mages i n t he C: \ My Pi ct ur es di r ect or y t o . r aw f i l es and save t hemi n
t he C: \ r awI mages di r ect or y:
ImgConv C:\My Pictures\*.png /r /o C:\rawImages

To conver t a si ngl e i mage ( t est i mage. j pg) i n t he cur r ent di r ect or y t o a . c ar r ay f i l e f or
chi pKi t boar ds ( PI C32) and save t he . c f i l e t o t he cur r ent di r ect or y:
ImgConv testimage.jpg /c /t PIC32

Bot h exampl es assume t hat t he I mgConv. exe f i l e i s i n t he cur r ent di r ect or y or i s avai l abl e somewher e i n t he sear ch pat h.

- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
I mgConv v1. 0 - ( C) 2013 Henni ng Kar l sen
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
Thi s t ool i s l i censed under a CC BY- NC- SA 3. 00 ( Cr eat i ve Commons
At t r i but i on- NonCommer ci al - Shar eAl i ke 3. 0 Unpor t ed) l i cense.
For mor e i nf or mat i on see: ht t p: / / cr eat i vecommons. or g/ l i censes/ by- nc- sa/ 3. 0/
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Usage:
I mgConv <f i l espec> / c| r [ / o <pat h>] [ / t AVR| ARM| PI C32]

<f i l espec>: Fi l e( s) t o conver t
par amet er s: / c - Cr eat e out put as . c ar r ay f i l es
/ r - Cr eat e out put as . r aw f i l es
/ o <pat h> - Set t he out put di r ect or y t o <pat h>
/ t <pl at f or m> - Sel ect t ar get pl at f or m
AVR : Most Ar dui nos
ARM : Ar dui no Due
PI C32: chi pKi t boar ds

You must speci f y ei t her / c or / r . Al l ot her par amet er s ar e opt i onal .
I f / o i s omi t t ed t he cur r ent di r ect or y wi l l be used f or out put .
I f / t i s omi t t ed t he t ar get pl at f or mwi l l be set t o AVR.

C: \ >
These t ool s ar e l i censed under a CC BY-NC-SA 3.0 ( Cr eat i ve Commons At t r i but i on-
NonCommer ci al - Shar eAl i ke 3. 0 Unpor t ed) Li cense.

For mor e i nf or mat i on see: http://creativecommons.org/licenses/by-nc-sa/3.0/
The source code for the tools are available upon request for the purpose
of porting them to other operating systems