opencv

README

OpenCV

OpenCV (Open Source Computer Vision Library) is an open source computer vision and machine learning software library. OpenCV was built to provide a common infrastructure for computer vision applications and to accelerate the use of machine perception in the commercial products. Being a BSD-licensed product, OpenCV makes it easy for businesses to utilize and modify the code.

For more info about OpenCV click here

How to Install

This package requires OpenCV version 2.4 to be installed on your system. Please note that it is not compatible with OpenCV 3.x at this time.

OSX

To install OpenCV on OSX using Homebrew:

$ brew tap homebrew/science && brew install opencv

Ubuntu

To install OpenCV on Ubuntu 14.04:

$ sudo apt-get install libopencv-dev

Or, follow the official OpenCV installation guide

Windows

Follow the official OpenCV installation guide

Now you can install the package with

go get -d -u gobot.io/x/gobot/... && go install gobot.io/x/gobot/platforms/opencv

How to Use

Example using the camera.

package main

import (
	cv "github.com/lazywei/go-opencv/opencv"
	"gobot.io/x/gobot"
	"gobot.io/x/gobot/platforms/opencv"
)

func main() {
	window := opencv.NewWindowDriver()
	camera := opencv.NewCameraDriver(0)

	work := func() {
		camera.On(camera.Event("frame"), func(data interface{}) {
			window.ShowImage(data.(*cv.IplImage))
		})
	}

	robot := gobot.NewRobot("cameraBot",
		[]gobot.Device{window, camera},
		work,
	)

	robot.Start()
}

Documentation

Overview

Package opencv contains the Gobot drivers for opencv.

Installing:

This package requires `opencv` to be installed on your system

Then you can install the package with:

go get gobot.io/x/gobot && go install gobot.io/x/gobot/platforms/opencv

Example:

package main

import (
	cv "gobot.io/x/go-opencv/opencv"
	"gobot.io/x/gobot"
	"gobot.io/x/gobot/platforms/opencv"
)

func main() {
	window := opencv.NewWindowDriver()
	camera := opencv.NewCameraDriver(0)

	work := func() {
		camera.On(camera.Event("frame"), func(data interface{}) {
			window.ShowImage(data.(*cv.IplImage))
		})
	}

	robot := gobot.NewRobot("cameraBot",
		[]gobot.Device{window, camera},
		work,
	)

	robot.Start()
}

For further information refer to opencv README: https://gobot.io/x/gobot/blob/master/platforms/opencv/README.md

Index

• Constants
• func DetectFaces(haar string, image *cv.IplImage) []*cv.Rect
• func DrawRectangles(image *cv.IplImage, rect []*cv.Rect, r int, g int, b int, thickness int) *cv.IplImage
• type CameraDriver
  • func NewCameraDriver(source interface{}, v ...time.Duration) *CameraDriver
  • func (c *CameraDriver) Connection() gobot.Connection
  • func (c *CameraDriver) Halt() (err error)
  • func (c *CameraDriver) Name() string
  • func (c *CameraDriver) SetName(n string)
  • func (c *CameraDriver) Start() (err error)
• type WindowDriver
  • func NewWindowDriver() *WindowDriver
  • func (w *WindowDriver) Connection() gobot.Connection
  • func (w *WindowDriver) Halt() (err error)
  • func (w *WindowDriver) Name() string
  • func (w *WindowDriver) SetName(n string)
  • func (w *WindowDriver) ShowImage(image *cv.IplImage)
  • func (w *WindowDriver) Start() (err error)

Constants

const (
	// Frame event
	Frame = "frame"
)

Functions

func DetectFaces

func DetectFaces(haar string, image *cv.IplImage) []*cv.Rect

DetectFaces loads Haar cascade to detect face objects in image

func DrawRectangles

func DrawRectangles(image *cv.IplImage, rect []*cv.Rect, r int, g int, b int, thickness int) *cv.IplImage

DrawRectangles uses Rect array values to return image with rectangles drawn.

Types

type CameraDriver

type CameraDriver struct {
	Source interface{}

	gobot.Eventer
	// contains filtered or unexported fields
}

CameraDriver is the Gobot Driver for the OpenCV camera

func NewCameraDriver

func NewCameraDriver(source interface{}, v ...time.Duration) *CameraDriver

NewCameraDriver creates a new driver with specified source. It also creates a start function to either set camera as a File or Camera capture.

func (*CameraDriver) Connection

func (c *CameraDriver) Connection() gobot.Connection

Connection returns the Driver's connection

func (*CameraDriver) Halt

func (c *CameraDriver) Halt() (err error)

Halt stops camera driver

func (*CameraDriver) Name

func (c *CameraDriver) Name() string

Name returns the Driver name

func (*CameraDriver) SetName

func (c *CameraDriver) SetName(n string)

SetName sets the Driver name

func (*CameraDriver) Start

func (c *CameraDriver) Start() (err error)

Start initializes camera by grabbing a frame every `interval` and publishing an frame event

type WindowDriver

type WindowDriver struct {
	// contains filtered or unexported fields
}

WindowDriver is the Gobot Driver for the OpenCV window

func NewWindowDriver

func NewWindowDriver() *WindowDriver

NewWindowDriver creates a new window driver. It adds an start function to initialize window

func (*WindowDriver) Connection

func (w *WindowDriver) Connection() gobot.Connection

Connection returns the Driver's connection

func (*WindowDriver) Halt

func (w *WindowDriver) Halt() (err error)

Halt returns true if camera is halted successfully

func (*WindowDriver) Name

func (w *WindowDriver) Name() string

Name returns the Driver name

func (*WindowDriver) SetName

func (w *WindowDriver) SetName(n string)

SetName sets the Driver name

func (*WindowDriver) ShowImage

func (w *WindowDriver) ShowImage(image *cv.IplImage)

ShowImage displays image in window

func (*WindowDriver) Start

func (w *WindowDriver) Start() (err error)

Start starts window thread and driver