https://github.com/dblock/dzt

Slice deep-zoom images.
https://github.com/dblock/dzt

Last synced: 7 months ago
JSON representation

Slice deep-zoom images.

• Host: GitHub
• URL: https://github.com/dblock/dzt
• Owner: dblock
• License: mit
• Created: 2014-03-17T03:04:28.000Z (about 12 years ago)
• Default Branch: master
• Last Pushed: 2020-01-07T15:38:53.000Z (over 6 years ago)
• Last Synced: 2025-08-16T15:27:27.350Z (10 months ago)
• Language: Ruby
• Size: 4.5 MB
• Stars: 56
• Watchers: 8
• Forks: 14
• Open Issues: 3
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.md

Awesome Lists containing this project

README

          
DZT

===

[![Gem Version](http://img.shields.io/gem/v/dzt.svg)](http://badge.fury.io/rb/dzt)

[![Build Status](http://img.shields.io/travis/dblock/dzt.svg)](https://travis-ci.org/dblock/dzt)

[![Dependency Status](https://gemnasium.com/dblock/dzt.svg)](https://gemnasium.com/dblock/dzt)

[![Code Climate](https://codeclimate.com/github/dblock/dzt.svg)](https://codeclimate.com/github/dblock/dzt)

Slice deep-zoom tiled images to be used with [OpenSeaDragon](http://openseadragon.github.io/) or [ARTiledImageView](https://github.com/dblock/ARTiledImageView).

![](screenshots/goya.gif)

## Usage

```

gem install dzt

```

#### Get Help

```

dzt help

```

#### Tile an Image

```

dzt slice image.jpg --output tiles

```

Creates a *tiles* folder with deep-zoom tiles. This will use the defaults defined in [/lib/dzt/tiler.rb](/lib/dzt/tiler.rb#L7-L10).

You can pass in flags to override all these options, such as:

```

dzt slice image.jpg --output=tiles --format=90 --tile-format=png

```

Additionally, you can have generated files uploaded to S3 for you. You can specify that like:

```

dzt slice image.jpg --acl=public-read --bucket=bucket --s3-key=prefix --aws-id=id --aws-secret=secret

```

The files will be uploaded to the bucket specified, and generated files will be prefixed by the s3 key.

## Contributing

See [CONTRIBUTING](CONTRIBUTING.md).

## Copyright and License

Copyright (c) 2015, Daniel Doubrovkine, [Artsy](http://artsy.github.io). Some tiling code inspired from [deep_zoom_slicer](https://github.com/meso-unimpressed/deep_zoom_slicer).

This project is licensed under the [MIT License](LICENSE.md).