Recommend using a real image library over tcod image loading functions.

Author: HexDecimal

tcod/image.py

@@ -12,7 +12,7 @@
 import numpy as np
 
 import tcod.console
-from tcod._internal import _console
+from tcod._internal import _console, deprecate
 from tcod.loader import ffi, lib
 
 
@@ -329,6 +329,11 @@ def _get_format_name(format: int) -> str:
     return str(format)
 
 
+@deprecate(
+    "This function may be removed in the future."
+    "  It's recommended to load images with a more complete image library such as python-Pillow or python-imageio.",
+    category=PendingDeprecationWarning,
+)
 def load(filename: str) -> np.ndarray:
     """Load a PNG file as an RGBA array.
 

tcod/libtcodpy.py

@@ -2921,7 +2921,10 @@ def image_is_pixel_transparent(image: tcod.image.Image, x: int, y: int) -> bool:
     return bool(lib.TCOD_image_is_pixel_transparent(image.image_c, x, y))
 
 
-@pending_deprecate()
+@pending_deprecate(
+    "This function may be removed in the future."
+    "  It's recommended to load images with a more complete image library such as python-Pillow or python-imageio."
+)
 def image_load(filename: str) -> tcod.image.Image:
     """Load an image file into an Image instance and return it.