Re: [PATCH 2/4] v4l: add documentation for selection API

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



On Tuesday 27 September 2011 11:20:29 Hans Verkuil wrote:
> On Wednesday, August 31, 2011 14:28:21 Tomasz Stanislawski wrote:
> > This patch adds a documentation for VIDIOC_{G/S}_SELECTION ioctl.
> > Moreover, the patch adds the description of modeling of composing,
> > cropping and scaling features in V4L2. Finally, some examples are
> > presented.
> > 
> > Signed-off-by: Tomasz Stanislawski <t.stanislaws@xxxxxxxxxxx>
> > Signed-off-by: Kyungmin Park <kyungmin.park@xxxxxxxxxxx>

[snip]

> >    <section id="crop">
> > 
> > -    <title>Image Cropping, Insertion and Scaling</title>
> > +    <title>Deprecated API for image cropping, insertion and
> > scaling</title>
> 
> I wouldn't call this deprecated. It's part of the API and we will just keep
> on supporting this.

I think we should still encourage driver and application developers to 
implement the selection API and use it when available instead of the crop API.

> I would instead refer to the new section on the selection API.

[snip]

> > +<para>The range of coordinates of the top left corner, width and height
> > of a +area which can be sampled is given by the <constant>
> > V4L2_SEL_CROP_BOUNDS +</constant> target. To support a wide range of
> > hardware this specification does +not define an origin or units.</para>
> 
> I know this phrase is present in the crop API, but I've never liked it. It
> makes life very hard for applications if the units aren't in pixels. The
> main reason the crop API was written in that way was for analog video
> receivers: while analog TV has discrete lines, in the horizontal direction
> there really isn't a clear 'pixel' concept. However, I've always thought
> that was a bogus argument since after sampling you end up with pixels
> anyway.
> 
> In my opinion the selection API should deal with pixels only.

What about hardware that supports sub-pixel cropping and/or composing ?

> The main driver where this might cause problems is bttv. I'm not sure how
> the selection vs crop API translation would work there. It might be best to
> just keep the current crop implementation in bttv and make a separate
> selection implementation. I'm pretty sure the bttv driver actually
> does/can do sub-pixel cropping.
> 
> With respect to the origin: I think I would put the top-left corner of the
> default crop rectangle at (0, 0). Strictly speaking it shouldn't matter
> where the origin is, but it seems to me that that's a logical choice.

For sensor drivers I found it easier to have the pixel array origin at (0, 0). 
It might just be me though.

-- 
Regards,

Laurent Pinchart
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at  http://vger.kernel.org/majordomo-info.html


[Index of Archives]     [Linux Input]     [Video for Linux]     [Gstreamer Embedded]     [Mplayer Users]     [Linux USB Devel]     [Linux Audio Users]     [Linux Kernel]     [Linux SCSI]     [Yosemite Backpacking]
  Powered by Linux