[MPlayer-cvslog] r19972 - in trunk/libass: ass_bitmap.c ass_bitmap.h

[eugeni]

Author: eugeni
Date: Sun Sep 24 18:15:47 2006
New Revision: 19972

Modified:
   trunk/libass/ass_bitmap.c
   trunk/libass/ass_bitmap.h

Log:
Cosmetics: add some comments.


Modified: trunk/libass/ass_bitmap.c
==============================================================================
--- trunk/libass/ass_bitmap.c	(original)
+++ trunk/libass/ass_bitmap.c	Sun Sep 24 18:15:47 2006
@@ -174,6 +174,12 @@
 	return bm;
 }
 
+/**
+ * \brief fix outline bitmap and generate shadow bitmap
+ * Two things are done here:
+ * 1. Glyph bitmap is subtracted from outline bitmap. This way looks much better in some cases.
+ * 2. Shadow bitmap is created as a sum of glyph and outline bitmaps.
+ */
 static bitmap_t* fix_outline_and_shadow(bitmap_t* bm_g, bitmap_t* bm_o)
 {
 	int x, y;

Modified: trunk/libass/ass_bitmap.h
==============================================================================
--- trunk/libass/ass_bitmap.h	(original)
+++ trunk/libass/ass_bitmap.h	Sun Sep 24 18:15:47 2006
@@ -12,7 +12,17 @@
 	unsigned char* buffer; // w x h buffer
 } bitmap_t;
 
+/**
+ * \brief perform glyph rendering
+ * \param glyph original glyph
+ * \param outline_glyph "border" glyph, produced from original by FreeType's glyph stroker
+ * \param bm_g out: pointer to the bitmap of original glyph is returned here
+ * \param bm_o out: pointer to the bitmap of outline (border) glyph is returned here
+ * \param bm_g out: pointer to the bitmap of glyph shadow is returned here
+ * \param be 1 = produces blurred bitmaps, 0 = normal bitmaps
+ */
 int glyph_to_bitmap(ass_synth_priv_t* priv, FT_Glyph glyph, FT_Glyph outline_glyph, bitmap_t** bm_g, bitmap_t** bm_o, bitmap_t** bm_s, int be);
+
 void ass_free_bitmap(bitmap_t* bm);
 
 #endif