Understanding documentation

edit

Hi all,

We have just started to use OpenCV for Python 2.7. My question is about the documentation. I find it hard to understand finding the documentation for APIs.

For example, In one of the example there is use of the following code

ret,frame = cap.read()
frame.shape

I was looking to understand what is this shape API returns, and the API returns objects, to understand its members. But failed to find it.

Another example: according to the doc VideoCapture.putText() is a legacy API. What is the new API that should be used?

Thanks,