On Thu, 2002-02-21 at 19:35, Gerd Knorr wrote: > > I'm talking about the API itself, not the text on the API.html page. > > Maybe I should update my Programming-FAQ (in the xawtv tarball), put > > it into API.html and mail Alan a diff ... > > Ok, here we go. Comments? If we're discussing this anyway... ;-) What I've found confusing about the API.html is that it describes VIDIOC[SG]WIN and VIDIOCCAPTURE as "capture", while it would be more appropriate to call this "video overlay display" or so, because I've (for quite some time) thought that you needed to do VIDIOCCAPTURE to start grabbing frames (which is what I think of when someone says 'capture'). I.e: The capture area is described by a struct video_window. becomes struct video_window describes the video window that is being used for video overlay. Merely setting the window does not enable capturing. Overlay capturing is activated by passing the VIDIOCCAPTURE ioctl a value of 1, and disabled by passing it a value of 0. becomes To actually enable the video overlay, you need to call the VIDIOCCAPTURE ioctl and pass it a value of 1. Passing it a value of 0 will disable video overlay. Would that make any sense? Ronald -- - .-. - /V\ | Ronald Bultje <rbultje@xxxxxxxxxxxxxxxxxxx> - // \\ | Running: Linux 2.4.17-XFS and OpenBSD 3.0 - /( )\ | http://ronald.bitfreak.net/ - ^^-^^
