package bimage-unix

  1. Overview
  2. Docs
Bimage_unix provides methods for encoding/decoding images in many formats using ImageMagick/stb_image

Install

Dune Dependency

Authors

Maintainers

Sources

bimage-v0.2.1.tbz
sha256=edc83c7f2749277376a070df72e7b654b963e85f630ec56353b4ea53445d5e3a
sha512=2d92eb3e3518910fe16d1f4cb4b5b75dd49cfaf3fd06c2f6dbcf2dea1ff5457f85978649042e3ada0978fb149cfa16da2da910693b0cb1390d48174bcb7b8643

Description

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

Tags

image processing

Published: 12 Apr 2020

README

bimage — Image processing library

v0.2.1

bimage is an image processing library for OCaml.

Features

  • Simple image type based on bigarrays

  • Supports u8, u16, i32, i64, f32, f64, complex32 and complex64 datatypes

  • Multiple layout support (Planar/Interleaved)

  • Composable image operations

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

  • Support for displaying images using GTK (bimage-gtk) or SDL (bimage-sdl)

bimage is distributed under the ISC license.

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

Installation

bimage can be installed with opam:

opam install bimage

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

opam install bimage-unix

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

Examples

An example showing how to create an image and how to use Image.for_each:

open Bimage

let _ =
(* Create a new image *)
let a = Image.create u8 gray 64 64 in

(* Iterate over each pixel *)
let _ =
    Image.for_each (fun x y _px ->
      Image.set a x y 0 (x + y)
    ) a
in

(* Save the image using ImageMagick *)
Bimage_unix.Magick.write "test1.jpg" a

The above example does direct image processing, however you may also use Exprs which can be used to compose operations.

Turning an Expr.t into an Op.t:

open Bimage
open Expr

(** Create an expression to get the average pixel for each pixel,
    [~@] is used to create [index] parameters *)
let avg = func (pixel ~@0 X Y) (fun _x _y _c px ->
  Pixel.fold ( + ) 0 px
)

let avg_minus_1 = Expr.(avg -. 1.0)
let avg_times_3 = Expr.(avg *. 3.0)

(** Turn it into an Op, which can be evaulated with `Op.eval` *)
let op = Expr.op avg

(** Exprs can also be evaluated directly using `Op.eval_expr` *)
let result = Op.eval_expr avg ~output:dest [| a |]

An example composing two Ops:

open Bimage
open Bimage_unix

let _ =
(* Load an image using ImageMagick *)
let a = match Magick.read f32 rgb "test/test.jpg" with
  | Ok img -> img
  | Error e -> failwith (Error.to_string e)
in

(* Create an operation to convert to grayscale and subtract 1.0 *)
let f = Op.(grayscale &- scalar 0.5) in

(* Create a destination image *)
let dest = Image.like_with_color gray a in

(* Run the operation *)
let () = Op.eval f ~output:dest [| a |] in

(* Save the image using ImageMagick *)
Magick.write "test2.jpg" dest

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 (5)

  1. ctypes-foreign >= "0.4"
  2. ctypes >= "0.14"
  3. bimage = version
  4. dune >= "2.0"
  5. ocaml >= "4.07.0"

Dev Dependencies

None

Used by

None

Conflicts

None

OCaml

Innovation. Community. Security.