The UTFTConverter package

This is a package candidate release! Here you can preview how this package release will appear once published to the main package index (which can be accomplished via the 'maintain' link below). Please note that once a package has been published to the main package index it cannot be undone! Please consult the package uploading documentation for more information.

[maintain]

Warnings:

About:

This package was created because I could not find a tool that can be used on UNIX systems to parse a picture into an array of RGB565 values and save them to a .c or .raw file. Both formats are used by the UTFT library to display pictures on to a TFT display.

This package includes, but not limited to, an executable which is made to be as identical as possible to the corresponding tool that is also downloaded with the UTFT library.

Usage:

 ./UTFTConverter <filespec> /c|r [/o <path>] [/t AVR|ARM|PIC32]

 <filespec>:  File(s) to convert
 parameters: /c            - Create output as .c array files
             /r            - Create output as .raw files
             /o <path>     - Set the output directory to <path>
             /t <platform> - Select target plaform
                             AVR   : Most Arduinos, Bobuion
                             ARM   : Arduino Due, Teensy, TI CC3200 LaunchPad
                             PIC32 : All chipKit boards

 You must specify either /c or /r. All other parameters are optional.
 If /o is ommited the current directory will be used for output.
 If /t is ommited the target platform will be set to AVR.'

Supported formats:

The binary tests if the pictures are encoded correctly via magic bytes using ImageType. If the extention is wrong, but the encoding is correct, it will still try to convert the picture.

The exported library is using JuicyPixels to convert incoming

and translates every pixel to a RGB565 format, which is a 4 digit hex number.

Library:

The only really reusable library is the Format.RGB565. It support the conversion from

Example usage:

 >>> toRGB565 (0, 0, 255)
 31
 >>> toRGB565Hex (0, 0, 255)
 "001F"
 >>> toHex 100
 64
 >>> toNHex 6 100
 "0064"

[Skip to ReadMe]

Properties

Versions0.1.0.0, 0.1.0.1, 0.1.0.1
Change logNone available
Dependenciesbase (>=4.7 && <4.9), bytestring (==0.10.*), directory (==1.2.*), filepath (>=1.3 && <1.5), image-type (>=0.1.0.0), JuicyPixels (==3.2.*), time (>=1.4 && <1.6), UTFTConverter (==0.1.*) [details]
LicenseMIT
AuthorAlexander Isenko
MaintainerAlexander Isenko <alex.isenko@protonmail.com>
CategoryGraphics, Text
Home pagehttp://github.com/cirquit/UTFTConverter
Bug trackerhttp://github.com/cirquit/UTFTConverter/issues
Source repositoryhead: git clone git://github.com/cirquit/UTFTConverter.git
ExecutablesUTFTConverter
UploadedWed May 4 22:35:20 UTC 2016 by cirquit

Modules

[Index]

Downloads

Maintainers' corner

For package maintainers and hackage trustees

Readme for UTFTConverter-0.1.0.1

UTFTConverter

This is my take at an offline converter from the below defined formats to .c or .raw format.

I will try to make the tool as identical as possible to the corresponding tool at RinkyDink.

Usage:

./UTFTConverter <filespec> /c|r [/o <path>] [/t AVR|ARM|PIC32]

<filespec>:  File(s) to convert
parameters: /c            - Create output as .c array files
            /r            - Create output as .raw files
            /o <path>     - Set the output directory to <path>\n
            /t <platform> - Select target plaform
                            AVR   : Most Arduinos, Bobuion
                            ARM   : Arduino Due, Teensy, TI CC3200 LaunchPad
                            PIC32 : All chipKit boards\n

You must specify either /c or /r. All other parameters are optional.
If /o is ommited the current directory will be used for output.
If /t is ommited the target platform will be set to AVR.

Differences to the Windows tool:

Binaries

Installation via cabal:

Step 1: Install the Glasgow Haskell Compiler and cabal OR the Haskell packaging tool

For Ubuntu distributions:

For any operation system:

Step 2: When you have ghc and cabal OR the Haskell Platform installed:

If you want the library AND the binary (the easier way):

If you want to build it by hand:

Installation via stack:

To do:

About:

While working on a streaming project on the Arduino, I needed to convert .jpg's to the .c or .raw format on the fly and send them to the Arduino. Unfortunately, the tools that were included in the corresponding UTFT library were compiled for Windows and there was no public API to do so. That's why I thought it would be a nice first project, that some people could benefit from.