Signed-off-by: Frank Schäfer <[email protected]>
---
lib/include/libv4lconvert.h | 20 ++++++++++++++++++--
1 Datei geändert, 18 Zeilen hinzugefügt(+), 2 Zeilen entfernt(-)
diff --git a/lib/include/libv4lconvert.h b/lib/include/libv4lconvert.h
index 167b57d..509655e 100644
--- a/lib/include/libv4lconvert.h
+++ b/lib/include/libv4lconvert.h
@@ -89,8 +89,24 @@ LIBV4L_PUBLIC int v4lconvert_needs_conversion(struct
v4lconvert_data *data,
const struct v4l2_format *src_fmt, /* in */
const struct v4l2_format *dest_fmt); /* in */
-/* return value of -1 on error, otherwise the amount of bytes written to
- dest */
+/* This function does the following conversions:
+ - format conversion
+ - cropping
+ if enabled:
+ - processing (auto whitebalance, auto gain, gamma correction)
+ - horizontal/vertical flipping
+ - 90 degree (clockwise) rotation
+
+ NOTE: the last 3 steps are enabled/disabled depending on
+ - the internal device list
+ - the state of the (software emulated) image controls
+
+ Therefore this function should
+ - not be used when getting the frames from libv4l
+ - be called only once per frame
+ Otherwise this may result in unintended double conversions !
+
+ Returns the amount of bytes written to dest an -1 on error */
LIBV4L_PUBLIC int v4lconvert_convert(struct v4lconvert_data *data,
const struct v4l2_format *src_fmt, /* in */
const struct v4l2_format *dest_fmt, /* in */
--
1.7.10.4
--
To unsubscribe from this list: send the line "unsubscribe linux-media" in
the body of a message to [email protected]
More majordomo info at http://vger.kernel.org/majordomo-info.html