Skip to content

boechat107/eye-boof

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

eye-boof

Build Status codecov Clojars Project

Codox API

eye-boof is a small library of image processing algorithms completely based on BoofCV. eye-boof aims to provide a much smaller set of functionalities than BoofCV, focused on simplicity and the most general algorithms. For applications beyond that, it's strongly recommended to use BoofCV directly.

Usage

Most of times we need to work with images that already exist, like files in the internet. To load a file from a URL, we can write something like this:

(require '[eye-boof.core :refer :all]
         '[eye-boof.visualization :refer [show-image]])

(def color-img (-> "http://png-3.vector.me/files/images/8/0/807142/realistic_vector_eye_thumb.jpg"
                   (java.net.URL.)
                   (load-image->planar-u8)))

;; Visualize the image:
(show-image color-img)

color-img
;; #object[boofcv.struct.image.Planar 0x2762ce07 "boofcv.struct.image.Planar@2762ce07"]

color eye

Note that a Planar data structure is returned, which is the common data structure to store the pixel intensities of color images. To know how many color channels this image holds, we can type

(num-of-bands color-img)
;; 3

what probably means a RGB image. To take a grayscale version of the image, we can take one of the color bands, like the Red:

(band! color-img 0)
;; #object[boofcv.struct.image.GrayU8 0x77ca00df "boofcv.struct.image.GrayU8@77ca00df"]

red channel

Other way of doing this is loading the image as a gray image (the intensities of each channel are averaged together):

(-> "http://png-3.vector.me/files/images/8/0/807142/realistic_vector_eye_thumb.jpg"
    (java.net.URL.)
    (load-image->gray-u8))
;; #object[boofcv.struct.image.GrayU8 0x77ca00df "boofcv.struct.image.GrayU8@77ca00df"]

To save an image into a disk file, we can use the function save-image! from the eye-boof.io namespace. The string path of the file tells the format representation of the image, like jpg or png for example. The supported formats are the same supported by javax.imageio.ImageIO, the underlying class to read/write image files.

(save-image! color-img "color_eye.jpg")
;; nil

More examples

Additional examples and documentation can be found in the wiki pages.

License

Copyright © 2013 Andre Boechat

Distributed under the Eclipse Public License, the same as Clojure.

About

Clojure image processing library based on BoofCV.

Topics

Resources

Stars

Watchers

Forks

Packages

No packages published