[MPlayer-cvslog] r32023 - trunk/eosd.h

[cigaes]

Author: cigaes
Date: Fri Aug 27 16:12:20 2010
New Revision: 32023

Log:
Add Doxygen comments and formal parameters names in eosd.h.

Modified:
   trunk/eosd.h

Modified: trunk/eosd.h
==============================================================================
--- trunk/eosd.h	Fri Aug 27 14:14:59 2010	(r32022)
+++ trunk/eosd.h	Fri Aug 27 16:12:20 2010	(r32023)
@@ -22,12 +22,44 @@
 #ifndef MPLAYER_EOSD_H
 #define MPLAYER_EOSD_H
 
-void eosd_init(vf_instance_t *);
+/**
+ * Initialize the EOSD subsystem.
+ *
+ * @param vf  the video filter chain where the rendering will take place.
+ */
+void eosd_init(vf_instance_t *vf);
 
-void eosd_configure(mp_eosd_res_t *, int);
-struct ass_image *eosd_render_frame(double, int *);
+/**
+ * Configure the resolution for EOSD rendering.
+ * Should be called by the rendering engine whenever the resolution or
+ * settings change.
+ *
+ * @param res      resolution and margins of the rendering area.
+ * @param hinting  nonzero if hinting is useful.
+ */
+void eosd_configure(mp_eosd_res_t *res, int hinting);
+
+/**
+ * Renders the EOSD elements for the current frame.
+ * Should be called by the rendering engine when it is about to do or
+ * prepare the rendering.
+ *
+ * @param ts       presentation timestamp of the frame.
+ * @param changed  if not NULL, will be set to 0 if the elements are
+ *                 identical since the last call, 1 if they have changed
+ *                 only in coordinates, and 2 if they have really changed.
+ * @return         a linked list of EOSD elements.
+ */
+struct ass_image *eosd_render_frame(double ts, int *changed);
+
+/**
+ * Shut down the EOSD subsystem and free the associated resources.
+ */
 void eosd_uninit(void);
 
+/**
+ * Initialize the use of EOSD for ASS subtitles rendering.
+ */
 void eosd_ass_init(struct ass_library *);
 
 #endif /* MPLAYER_EOSD_H */