Add ass_set_pixel_aspect(), deprecate ass_set_aspect_ratio()

ass_set_aspect_ratio() is confusing, because it takes a DAR and SAR
value, while libass just needs a single pixel aspect ratio. Introduce
ass_set_pixel_aspect(), which sets the pixel aspect ratio directly.

ass_set_aspect_ratio() is considered deprecated. There's no reason to
remove it, but hopefully directing users to ass_set_pixel_aspect() will
make for a simpler API.

Improve the doxygen and document what ass_set_margins() actually does.

1 files changed, 5 insertions, 1 deletions

diff --git a/libass/ass_render_api.c b/libass/ass_render_api.c
index 80af81f..5777aad 100644
--- a/libass/ass_render_api.c
+++ b/libass/ass_render_api.c
@@ -101,7 +101,11 @@ void ass_set_use_margins(ASS_Renderer *priv, int use)
 
 void ass_set_aspect_ratio(ASS_Renderer *priv, double dar, double sar)
 {
-    double par = dar / sar;
+    ass_set_pixel_aspect(priv, dar / sar);
+}
+
+void ass_set_pixel_aspect(ASS_Renderer *priv, double par)
+{
     if (priv->settings.par != par) {
         priv->settings.par = par;
         ass_reconfigure(priv);