tiffany

A library for parsing Tagged Image File Format (Tiff) files

License	The MIT License (MIT)
GroupId	ag.granular
ArtifactId	tiffany
Last Version	0.1.2
Release Date	Oct 16, 2020
Type	pom
Description	tiffany A library for parsing Tagged Image File Format (Tiff) files
Project URL	https://github.com/granular-oss/tiffany
Source Code Management	https://github.com/granular-oss/tiffany

Download tiffany

Filename	Size
tiffany-0.1.2.pom
tiffany-0.1.2.module	1 KB
tiffany-0.1.2-sources.jar	261 bytes
tiffany-0.1.2-javadoc.jar	261 bytes

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/ag.granular/tiffany/ -->
<dependency>
    <groupId>ag.granular</groupId>
    <artifactId>tiffany</artifactId>
    <version>0.1.2</version>
    <type>pom</type>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/ag.granular/tiffany/
implementation 'ag.granular:tiffany:0.1.2'

Gradle Kotlin

// https://jarcasting.com/artifacts/ag.granular/tiffany/
implementation ("ag.granular:tiffany:0.1.2")

Apache Buildr

'ag.granular:tiffany:pom:0.1.2'

Apache Ivy

<dependency org="ag.granular" name="tiffany" rev="0.1.2">
  <artifact name="tiffany" type="pom" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='ag.granular', module='tiffany', version='0.1.2')
)

Scala SBT

libraryDependencies += "ag.granular" % "tiffany" % "0.1.2"

Leiningen

[ag.granular/tiffany "0.1.2"]

Dependencies

There are no dependencies for this project. It is a standalone project that does not depend on any other jars.

Project Modules

There are no modules declared in this project.

Tiffany

A library for parsing Tagged Image File Format (Tiff) files on any platform (currently JVM and native iOS)

The library inspired by the TIFF Java developed at the National Geospatial-Intelligence Agency (NGA) in collaboration with BIT Systems. The software use, modification, and distribution rights are stipulated within the MIT license.

Pull Requests

If you'd like to contribute to this project, please make a pull request. We'll review the pull request and discuss the changes. All pull request contributions to this project will be released under the MIT license.

About

Tiffany is a Kotlin Multiplatform library for reading and writing Tagged Image File Format files. Implementation is based on the TIFF specification and ported from TIFF Java implementation: https://github.com/ngageoint/tiff-java/

Usage

View the latest Javadoc TODO

Read

//val data: ByteArray = ...

val tiffFile: TIFFImage = TiffReader(data).readTiff()
val fileDirectories: List<FileDirectory> = tiffFile?.fileDirectories

// read the first directory in tiff file
val fileDirectory = fileDirectories[0]
val rasters: TypedRasters = fileDirectory.readTypedRasters()

// get the width and height
val rasterWidth = rasters.width
val rasterHeight = rasters.height

val samples1: ShortArray = (rasters.samples[0] as TypedSample.ShortSample).data
val samples2: ShortArray = (rasters.samples[1] as TypedSample.ShortSample).data

Write

val tiffImage: TiffImage = ...
val tiffBytes: ByteArray = TiffWriter().writeTiffToBytes(tiffImage)

Installation

TODO provide link to the maven once published

Build

Build this repository using Gradle:

    ./gradlew build

Publish to local maven for local testing:

    ./gradlew publishToMavenLocal

Granular, Inc

Granular Open Source Software

Versions

Version
0.1.2 Oct 16, 2020
0.1.1 May 19, 2020
0.1.0 Dec 31, 2019
0.0.1 Dec 6, 2019