package bimage

  1. Overview
  2. Docs
A simple, efficient image-processing library

Install

Dune Dependency

Authors

Maintainers

Sources

bimage-v0.3.0.tbz
sha256=d3c16024d56ad368dca87cdd09aac6d949e8834770942fd27175474f423569a4
sha512=946ddd44508356c99617f45d4c93eb7dc4eaee4e1d4e38dcce8e65a327fa90773f46c0f178afc1db550935bfbc44aed3340f4f1d12d2f851c14ba4a28e8a41c7

Description

An image processing library for OCaml providing efficient, composable operations. Additionally, bimage supports most types supported by Bigarray.

Tags

image processing

Published: 07 Feb 2021

README

bimage — Image processing library

v0.3.0

bimage is an image processing library for OCaml.

Features

  • Simple image type based on bigarrays

  • Supports u8, u16, i32, i64, f32, f64 datatypes

  • Composable image operations

  • Image I/O using OpenImageIO (bimage-io)

  • Image I/O using ImageMagick/GraphicsMagick and stb_image (bimage-unix)

  • GLFW window support (bimage-display)

bimage is distributed under the ISC license.

Homepage: https://github.com/zshipko/ocaml-bimage

Installation

bimage can be installed with opam:

$ opam install bimage

bimage-io can be installed by running:

$ opam install bimage-io

Additionally, bimage-unix, which provides stb-image and ImageMagick bindings, can be installed by running:

$ opam install bimage-unix

If you don't use opam consult the opam file for build instructions.

Getting started

  • Type.t: Defines the type of an image: u8, u16, f32, f64, i32ori64`

  • Color.t: Defines the color of an image: gray, rgb, rgba, xyz and yuv

    • It's possible to extend the color type by implementing COLOR

  • Image.t: Image type

  • Kernel.t: Convolution kernels

  • Transform.t: Image transformations

  • Expr.t: Expression combinator

    • Building blocks for image processing filters

  • Filter.t: Executable image filter

    • Makes Expr.t executable

There is a corresponding file for each of these types in src/.

Examples

See examples/ for usage examples

Documentation

The documentation and API reference is generated from the source interfaces. It can be consulted online or via odig doc bimage.

Tests

In the distribution sample programs and tests are located in the test directory. They can be built and run with:

dune runtest

Dependencies (2)

  1. dune >= "2.0"
  2. ocaml >= "4.08.0"

Dev Dependencies

None

Used by (4)

  1. bimage-display < "0.3.1"
  2. bimage-io < "0.3.1"
  3. bimage-lwt < "0.3.1"
  4. bimage-unix = "0.3.0"

Conflicts

None