move the av_parse_color() function from libavfilter to libavcore

Originally committed as revision 25761 to svn://svn.ffmpeg.org/ffmpeg/trunk

1 files changed, 22 insertions, 0 deletions

diff --git a/libavcore/parseutils.h b/libavcore/parseutils.h
index ad31ef29e5..052427bbfd 100644
--- a/libavcore/parseutils.h
+++ b/libavcore/parseutils.h
@@ -50,4 +50,26 @@ int av_parse_video_size(int *width_ptr, int *height_ptr, const char *str);
  */
 int av_parse_video_rate(AVRational *rate, const char *str);
 
+/**
+ * Put the RGBA values that correspond to color_string in rgba_color.
+ *
+ * @param color_string a string specifying a color. It can be the name of
+ * a color (case insensitive match) or a [0x|#]RRGGBB[AA] sequence,
+ * possibly followed by "@" and a string representing the alpha
+ * component.
+ * The alpha component may be a string composed by "0x" followed by an
+ * hexadecimal number or a decimal number between 0.0 and 1.0, which
+ * represents the opacity value (0x00/0.0 means completely transparent,
+ * 0xff/1.0 completely opaque).
+ * If the alpha component is not specified then 0xff is assumed.
+ * The string "random" will result in a random color.
+ * @param slen length of the initial part of color_string containing the
+ * color. It can be set to -1 if color_string is a null terminated string
+ * containing nothing else than the color.
+ * @return >= 0 in case of success, a negative value in case of
+ * failure (for example if color_string cannot be parsed).
+ */
+int av_parse_color(uint8_t *rgba_color, const char *color_string, int slen,
+                   void *log_ctx);
+
 #endif /* AVCORE_PARSEUTILS_H */