Python and OpenCV 2.4.3

edit

Python documentation is a little patchy, but in my opinion worth persisting with. Sometimes the C++ description is very helpful as it says the type of array required.

The main problem with your code examples is that OpenCV Python functions which process images take as input Numpy arrays. This means you have to read the image from .jpg into an array, and then pass it to the function. The result from cvtColor is another Numpy array.

Example:

import numpy as np
import cv2
im=cv2.imread('c:/temp/i1.jpg',cv2.cv.CV_LOAD_IMAGE_COLOR)
type(im)  #Shows Numpy array
im.shape #Numpy array object shape gives image size
cv2.imshow('Colour',im)
im_gray=cv2.cvtColor(im,cv2.COLOR_BGR2GRAY)
cv2.imshow('Gray',im_gray)  #show image on screen
cv2.imwrite('c:/temp/i1g.jpg',im_gray)  #write to file
im_gray[...]=0  #Use Numpy broadcasting
cv2.imshow('Turned black',im_gray)

If you unpack the OpenCV source there is a directory of samples called opencv\samples\python2 These are all using the cv2 interface.

I sympathise with your confusion at the state of the official documentation, but your example is an issue with your Python syntax, not with OpenCV or its documentation. Importing like so:

import cv

will not add symbols in the cv module to the local namespace. You can either reference the cv module every time you want to use a symbol from it (e.g.: cv.cvtColor and cv.CV_RGB2GRAY) or import the symbols you need into the local namespace (e.g.: from cv import cvtColor, CV_RGB2GRAY) or just import everything: from cv import *.

I don't know of any better source of documentation, sorry.