diff options
author | Oneric <oneric@oneric.stub> | 2020-10-11 15:54:24 +0200 |
---|---|---|
committer | Oleg Oshmyan <chortos@inbox.lv> | 2020-10-27 01:03:04 +0200 |
commit | 1017c1c5053ac4522282b9db85e30b8c752676a6 (patch) | |
tree | 95ab2c77d98f95daeb27021013e6fd8553dd94ac | |
parent | 152d0484e98f118d01987138695cf40579c9e297 (diff) | |
download | libass-1017c1c5053ac4522282b9db85e30b8c752676a6.tar.bz2 libass-1017c1c5053ac4522282b9db85e30b8c752676a6.tar.xz |
doc: clarify docs regarding track creation and freeing
-rw-r--r-- | libass/ass.c | 3 | ||||
-rw-r--r-- | libass/ass.h | 8 |
2 files changed, 7 insertions, 4 deletions
diff --git a/libass/ass.c b/libass/ass.c index abfbe7a..5c149c8 100644 --- a/libass/ass.c +++ b/libass/ass.c @@ -68,6 +68,9 @@ void ass_free_track(ASS_Track *track) { int i; + if (!track) + return; + if (track->parser_priv) { free(track->parser_priv->read_order_bitmap); free(track->parser_priv->fontname); diff --git a/libass/ass.h b/libass/ass.h index 0dcd17b..582af83 100644 --- a/libass/ass.h +++ b/libass/ass.h @@ -550,7 +550,7 @@ ASS_Image *ass_render_frame(ASS_Renderer *priv, ASS_Track *track, /** * \brief Allocate a new empty track object. * \param library handle - * \return pointer to empty track + * \return pointer to empty track or NULL on failure */ ASS_Track *ass_new_track(ASS_Library *); @@ -573,7 +573,7 @@ int ass_track_set_feature(ASS_Track *track, ASS_Feature feature, int enable); /** * \brief Deallocate track and all its child objects (styles and events). - * \param track track to deallocate + * \param track track to deallocate or NULL */ void ass_free_track(ASS_Track *track); @@ -663,7 +663,7 @@ void ass_flush_events(ASS_Track *track); * \param library library handle * \param fname file name * \param codepage encoding (iconv format) - * \return newly allocated track + * \return newly allocated track or NULL on failure */ ASS_Track *ass_read_file(ASS_Library *library, char *fname, char *codepage); @@ -674,7 +674,7 @@ ASS_Track *ass_read_file(ASS_Library *library, char *fname, * \param buf pointer to subtitles text * \param bufsize size of buffer * \param codepage encoding (iconv format) - * \return newly allocated track + * \return newly allocated track or NULL on failure */ ASS_Track *ass_read_memory(ASS_Library *library, char *buf, size_t bufsize, char *codepage); |