https://github.com/lovasoa/pff-extract

pff (zoomify single-file image format) to jpeg converter
https://github.com/lovasoa/pff-extract

dezoomify jpeg-converter pff zoomable-images

Last synced: about 2 months ago
JSON representation

pff (zoomify single-file image format) to jpeg converter

• Host: GitHub
• URL: https://github.com/lovasoa/pff-extract
• Owner: lovasoa
• License: gpl-2.0
• Created: 2015-03-14T16:08:38.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2020-11-19T08:08:11.000Z (about 4 years ago)
• Last Synced: 2024-05-01T23:28:00.708Z (8 months ago)
• Topics: dezoomify, jpeg-converter, pff, zoomable-images
• Language: C
• Size: 2.37 MB
• Stars: 5
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pff-extract

Pyramidal File Format (PFF) to jpeg converter. PFF is zoomify's single-file zoomable image format.

The pff file format is proprietary, and [I reversed-engineered it](https://github.com/lovasoa/pff-extract/wiki/Zoomify-PFF-file-format-documentation) using only a few sample files. This program is based on this reverse-engineering work, and thus might not work on every pff file. If it doesn't work for you, please [open a bug](https://github.com/lovasoa/pff-extract/issues/new).

## Installation

We distribute linux and MacOS binaries on our [release page](https://github.com/lovasoa/pff-extract/releases).

If you are on windows, you can use the linux (ubuntu) binaries with [WSL](https://docs.microsoft.com/en-us/windows/wsl/install-win10).

## Usage

```

pff-extract input.pff [output.jpg]

```

## Compilation

```

gcc -o pff-extract pff-extract.c -lturbojpeg

```

### Dependencies

 * [libjpeg-turbo](http://www.libjpeg-turbo.org/) v2.0+ to decompress the tiles

   and to compress the resulting image.

   In ubuntu 20.04+, it can be installed with `sudo apt install libturbojpeg0-dev`.

   On fedora: `sudo dnf install turbojpeg-devel`.

### Correctness

This program should handle all files safely, even malformed ones, 

and display a clear error message when it fails to process a file.

Version 0.7 was fuzzed for multiple hours on 12 instances of [AFL](https://github.com/google/AFL),

without any crash. The program should be safe from memory errors.

However, this is a free software that comes without any warranty of any kind.

If you find an error, you can [report it](https://github.com/lovasoa/pff-extract/issues/new).