go-opencv/README.md
2014-11-27 13:42:41 -05:00

97 lines
2.1 KiB
Markdown

#Go OpenCV binding
This is a fork of https://github.com/chai2010/opencv . At the time of the fork (Dec 9, 2013) the original project was inactive, but now it seems to be active again starting from Aug 25, 2014. Efforts to merge the two projects are very welcome.
## Install
### Linux & Mac OS X
Install Go and OpenCV, you might want to install both of them via `apt-get` or `homebrew`.
```
go get github.com/lazywei/go-opencv
cd ${GoOpenCVRoot}/samples && go run hellocv.go
```
### Windows
- Install Go and MinGw
- install OpenCV-2.4.x to MinGW dir
- `libopencv*.dll` --> `${MinGWRoot}\bin`
- `libopencv*.lib` --> `${MinGWRoot}\lib`
- `include\opencv` --> `${MinGWRoot}\include\opencv`
- `include\opencv2` --> `${MinGWRoot}\include\opencv2`
```
go get code.google.com/p/go-opencv/trunk/opencv
cd ${GoOpenCVRoot}/trunk/samples && go run hellocv.go
```
## Example
### Resizing
```go
package main
import opencv "github.com/lazywei/go-opencv/opencv"
func main() {
filename := "bert.jpg"
srcImg := opencv.LoadImage(filename)
if srcImg == nil {
panic("Loading Image failed")
}
defer srcImg.Release()
resized1 := opencv.Resize(srcImg, 400, 0, 0)
resized2 := opencv.Resize(srcImg, 300, 500, 0)
resized3 := opencv.Resize(srcImg, 300, 500, 2)
opencv.SaveImage("resized1.jpg", resized1, 0)
opencv.SaveImage("resized2.jpg", resized2, 0)
opencv.SaveImage("resized3.jpg", resized3, 0)
}
```
### Webcam
Yet another cool example is created by @saratovsource which demos how to use webcam:
```
cd samples
go run webcam.go
```
### More
You can find more samples at: https://github.com/lazywei/go-opencv/tree/master/samples
## How to contribute
- Fork this repo
- Clone the main repo, and add your fork as a remote
```
git clone https://github.com/lazywei/go-opencv.git
cd go-opencv
git remote rename origin upstream
git remote add origin https://github.com/your_github_account/go-opencv.git
```
- Create new feature branch
```
git checkout -b your-feature-branch
```
- Commit your change and push it to your repo
```
git commit -m 'new feature'
git push origin your-feature-branch
```
- Open a pull request!
## TODOs
- More details doc
- Implement more bindings