Overview:

Unlike SDL_image which copies raw image data from an SDL_RWops into the resultant SDL_Surface or SDL_Texture, opening a TTF_Font from an SDL_RWops does not make any copy of the data. This means that the SDL_RWops must be kept alive for the lifetime of the TTF_Font. In the case of SDL_ttf, this behavior makes sense, but does not appear to be documented anywhere (namely [https://www.libsdl.org/projects/SDL_ttf/docs/SDL_ttf.html]).

Attempting to use this TTF_Font after the SDL_RWops has been closed may result in a segfault or other unexpected behavior.



Expected Results:

The behavior should be documented that opening a TTF_Font from an SDL_RWops requires the SDL_RWops to be kept alive for the lifetime of the TTF_Font. Inspection of the source should not be necessary to understand this requirement.



Build Date & Hardware: (N/A)



Additional Builds and Platforms: (N/A)



Additional Information:

Related issue reported at [https://github.com/andelf/rust-sdl2_ttf/issues/29], which begins with, "As far as I understand RWops must outlive Font, since C library uses them after font is created." Clearly the requirement is not well established by the current documentation.