| Message ID | 20191004115514.31259-1-bnvandana@gmail.com (mailing list archive) |
|---|---|
| State | New, archived |
| Headers | show |
| Series | Documentation:media:v4l2:Add vivid metadata doc | expand |
On 10/4/19 1:55 PM, Vandana BN wrote: > Adds new file for describing new metadata format V4L2_META_FMT_VIVID added in vivid driver. > > Signed-off-by: Vandana BN <bnvandana@gmail.com> > --- > Documentation/media/uapi/v4l/meta-formats.rst | 1 + > .../media/uapi/v4l/pixfmt-meta-vivid.rst | 43 +++++++++++++++++++ > 2 files changed, 44 insertions(+) > create mode 100644 Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > > diff --git a/Documentation/media/uapi/v4l/meta-formats.rst b/Documentation/media/uapi/v4l/meta-formats.rst > index b10ca9ee3968..74c8659ee9d6 100644 > --- a/Documentation/media/uapi/v4l/meta-formats.rst > +++ b/Documentation/media/uapi/v4l/meta-formats.rst > @@ -24,3 +24,4 @@ These formats are used for the :ref:`metadata` interface only. > pixfmt-meta-uvc > pixfmt-meta-vsp1-hgo > pixfmt-meta-vsp1-hgt > + pixfmt-meta-vivid > diff --git a/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > new file mode 100644 > index 000000000000..e6c349fadf30 > --- /dev/null > +++ b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > @@ -0,0 +1,43 @@ > +.. Permission is granted to copy, distribute and/or modify this > +.. document under the terms of the GNU Free Documentation License, > +.. Version 1.1 or any later version published by the Free Software > +.. Foundation, with no Invariant Sections, no Front-Cover Texts > +.. and no Back-Cover Texts. A copy of the license is included at > +.. Documentation/media/uapi/fdl-appendix.rst. > +.. > +.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections > + > +.. _v4l2-meta-fmt-vivid: > + > +******************************* > +V4L2_META_FMT_VIVID ('VIVID') That's a fivecc instead of a fourcc :-) > +******************************* > + > +VIVID Metadata Format > + > + > +Description > +=========== > + > +This format describes metadata in vivid driver. Say: ...describes the metadata format used by the vivid driver. > + > +It sets Brightness, Saturation, Contrast and Hue, each of which maps to > +corresponding control in vivid driver with respect to its range and default values. ...controls of the... ...respect to the range... > + > +It contains the following fields: > + > +.. flat-table:: VIVID Metadata > + :widths: 1 4 > + :header-rows: 1 > + :stub-columns: 0 > + > + * - Field > + - Description > + * - u16 brightness; > + - Image brightness, value can be in range 0 to 255, with default value as 128. - Image brightness, the value is in the range 0 to 255, with the default value as 128. > + * - u16 contrast; > + - Image contrast, value can be in range 0 to 255, with default value as 128. > + * - u16 saturation; > + - Image color saturation, value can be in range 0 to 255, with default value as 128. > + * - s16 hue; > + - Image color balance, value can be in range -128 to 128, with default value as 0. > Ditto. Regards, Hans
Em Fri, 4 Oct 2019 13:59:00 +0200 Hans Verkuil <hverkuil@xs4all.nl> escreveu: > On 10/4/19 1:55 PM, Vandana BN wrote: > > Adds new file for describing new metadata format V4L2_META_FMT_VIVID added in vivid driver. > > > > Signed-off-by: Vandana BN <bnvandana@gmail.com> > > --- > > Documentation/media/uapi/v4l/meta-formats.rst | 1 + > > .../media/uapi/v4l/pixfmt-meta-vivid.rst | 43 +++++++++++++++++++ > > 2 files changed, 44 insertions(+) > > create mode 100644 Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > > > > diff --git a/Documentation/media/uapi/v4l/meta-formats.rst b/Documentation/media/uapi/v4l/meta-formats.rst > > index b10ca9ee3968..74c8659ee9d6 100644 > > --- a/Documentation/media/uapi/v4l/meta-formats.rst > > +++ b/Documentation/media/uapi/v4l/meta-formats.rst > > @@ -24,3 +24,4 @@ These formats are used for the :ref:`metadata` interface only. > > pixfmt-meta-uvc > > pixfmt-meta-vsp1-hgo > > pixfmt-meta-vsp1-hgt > > + pixfmt-meta-vivid > > diff --git a/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > > new file mode 100644 > > index 000000000000..e6c349fadf30 > > --- /dev/null > > +++ b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst > > @@ -0,0 +1,43 @@ > > +.. Permission is granted to copy, distribute and/or modify this > > +.. document under the terms of the GNU Free Documentation License, > > +.. Version 1.1 or any later version published by the Free Software > > +.. Foundation, with no Invariant Sections, no Front-Cover Texts > > +.. and no Back-Cover Texts. A copy of the license is included at > > +.. Documentation/media/uapi/fdl-appendix.rst. > > +.. > > +.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections Could you please re-license it with dual GFDL and GPL? See for example: Documentation/media/uapi/mediactl/media-request-ioc-queue.rst For the text we're adding to all new documentation files on media. Regards, Mauro > > + > > +.. _v4l2-meta-fmt-vivid: > > + > > +******************************* > > +V4L2_META_FMT_VIVID ('VIVID') > > That's a fivecc instead of a fourcc :-) > > > +******************************* > > + > > +VIVID Metadata Format > > + > > + > > +Description > > +=========== > > + > > +This format describes metadata in vivid driver. > > Say: ...describes the metadata format used by the vivid driver. > > > + > > +It sets Brightness, Saturation, Contrast and Hue, each of which maps to > > +corresponding control in vivid driver with respect to its range and default values. > > ...controls of the... > ...respect to the range... > > > + > > +It contains the following fields: > > + > > +.. flat-table:: VIVID Metadata > > + :widths: 1 4 > > + :header-rows: 1 > > + :stub-columns: 0 > > + > > + * - Field > > + - Description > > + * - u16 brightness; > > + - Image brightness, value can be in range 0 to 255, with default value as 128. > > - Image brightness, the value is in the range 0 to 255, with the default value as 128. > > > + * - u16 contrast; > > + - Image contrast, value can be in range 0 to 255, with default value as 128. > > + * - u16 saturation; > > + - Image color saturation, value can be in range 0 to 255, with default value as 128. > > + * - s16 hue; > > + - Image color balance, value can be in range -128 to 128, with default value as 0. > > > > Ditto. > > Regards, > > Hans Thanks, Mauro
Vandana, Can you post a v3 with this proposed license? Thanks! Hans On 10/16/19 9:45 PM, Mauro Carvalho Chehab wrote: > Em Fri, 4 Oct 2019 13:59:00 +0200 > Hans Verkuil <hverkuil@xs4all.nl> escreveu: > >> On 10/4/19 1:55 PM, Vandana BN wrote: >>> Adds new file for describing new metadata format V4L2_META_FMT_VIVID added in vivid driver. >>> >>> Signed-off-by: Vandana BN <bnvandana@gmail.com> >>> --- >>> Documentation/media/uapi/v4l/meta-formats.rst | 1 + >>> .../media/uapi/v4l/pixfmt-meta-vivid.rst | 43 +++++++++++++++++++ >>> 2 files changed, 44 insertions(+) >>> create mode 100644 Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst >>> >>> diff --git a/Documentation/media/uapi/v4l/meta-formats.rst b/Documentation/media/uapi/v4l/meta-formats.rst >>> index b10ca9ee3968..74c8659ee9d6 100644 >>> --- a/Documentation/media/uapi/v4l/meta-formats.rst >>> +++ b/Documentation/media/uapi/v4l/meta-formats.rst >>> @@ -24,3 +24,4 @@ These formats are used for the :ref:`metadata` interface only. >>> pixfmt-meta-uvc >>> pixfmt-meta-vsp1-hgo >>> pixfmt-meta-vsp1-hgt >>> + pixfmt-meta-vivid >>> diff --git a/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst >>> new file mode 100644 >>> index 000000000000..e6c349fadf30 >>> --- /dev/null >>> +++ b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst >>> @@ -0,0 +1,43 @@ >>> +.. Permission is granted to copy, distribute and/or modify this >>> +.. document under the terms of the GNU Free Documentation License, >>> +.. Version 1.1 or any later version published by the Free Software >>> +.. Foundation, with no Invariant Sections, no Front-Cover Texts >>> +.. and no Back-Cover Texts. A copy of the license is included at >>> +.. Documentation/media/uapi/fdl-appendix.rst. >>> +.. >>> +.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections > > Could you please re-license it with dual GFDL and GPL? > > See for example: > Documentation/media/uapi/mediactl/media-request-ioc-queue.rst > > For the text we're adding to all new documentation files on media. > > Regards, > Mauro > >>> + >>> +.. _v4l2-meta-fmt-vivid: >>> + >>> +******************************* >>> +V4L2_META_FMT_VIVID ('VIVID') >> >> That's a fivecc instead of a fourcc :-) >> >>> +******************************* >>> + >>> +VIVID Metadata Format >>> + >>> + >>> +Description >>> +=========== >>> + >>> +This format describes metadata in vivid driver. >> >> Say: ...describes the metadata format used by the vivid driver. >> >>> + >>> +It sets Brightness, Saturation, Contrast and Hue, each of which maps to >>> +corresponding control in vivid driver with respect to its range and default values. >> >> ...controls of the... >> ...respect to the range... >> >>> + >>> +It contains the following fields: >>> + >>> +.. flat-table:: VIVID Metadata >>> + :widths: 1 4 >>> + :header-rows: 1 >>> + :stub-columns: 0 >>> + >>> + * - Field >>> + - Description >>> + * - u16 brightness; >>> + - Image brightness, value can be in range 0 to 255, with default value as 128. >> >> - Image brightness, the value is in the range 0 to 255, with the default value as 128. >> >>> + * - u16 contrast; >>> + - Image contrast, value can be in range 0 to 255, with default value as 128. >>> + * - u16 saturation; >>> + - Image color saturation, value can be in range 0 to 255, with default value as 128. >>> + * - s16 hue; >>> + - Image color balance, value can be in range -128 to 128, with default value as 0. >>> >> >> Ditto. >> >> Regards, >> >> Hans > > > > Thanks, > Mauro >
diff --git a/Documentation/media/uapi/v4l/meta-formats.rst b/Documentation/media/uapi/v4l/meta-formats.rst index b10ca9ee3968..74c8659ee9d6 100644 --- a/Documentation/media/uapi/v4l/meta-formats.rst +++ b/Documentation/media/uapi/v4l/meta-formats.rst @@ -24,3 +24,4 @@ These formats are used for the :ref:`metadata` interface only. pixfmt-meta-uvc pixfmt-meta-vsp1-hgo pixfmt-meta-vsp1-hgt + pixfmt-meta-vivid diff --git a/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst new file mode 100644 index 000000000000..e6c349fadf30 --- /dev/null +++ b/Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst @@ -0,0 +1,43 @@ +.. Permission is granted to copy, distribute and/or modify this +.. document under the terms of the GNU Free Documentation License, +.. Version 1.1 or any later version published by the Free Software +.. Foundation, with no Invariant Sections, no Front-Cover Texts +.. and no Back-Cover Texts. A copy of the license is included at +.. Documentation/media/uapi/fdl-appendix.rst. +.. +.. TODO: replace it to GFDL-1.1-or-later WITH no-invariant-sections + +.. _v4l2-meta-fmt-vivid: + +******************************* +V4L2_META_FMT_VIVID ('VIVID') +******************************* + +VIVID Metadata Format + + +Description +=========== + +This format describes metadata in vivid driver. + +It sets Brightness, Saturation, Contrast and Hue, each of which maps to +corresponding control in vivid driver with respect to its range and default values. + +It contains the following fields: + +.. flat-table:: VIVID Metadata + :widths: 1 4 + :header-rows: 1 + :stub-columns: 0 + + * - Field + - Description + * - u16 brightness; + - Image brightness, value can be in range 0 to 255, with default value as 128. + * - u16 contrast; + - Image contrast, value can be in range 0 to 255, with default value as 128. + * - u16 saturation; + - Image color saturation, value can be in range 0 to 255, with default value as 128. + * - s16 hue; + - Image color balance, value can be in range -128 to 128, with default value as 0.
Adds new file for describing new metadata format V4L2_META_FMT_VIVID added in vivid driver. Signed-off-by: Vandana BN <bnvandana@gmail.com> --- Documentation/media/uapi/v4l/meta-formats.rst | 1 + .../media/uapi/v4l/pixfmt-meta-vivid.rst | 43 +++++++++++++++++++ 2 files changed, 44 insertions(+) create mode 100644 Documentation/media/uapi/v4l/pixfmt-meta-vivid.rst