Fix #3.

Author: smoothjazzmine

README.md

@@ -32,7 +32,7 @@ Use `pip install ingame` to install the project.
 
 ```python
 from ingame.core import InGame, Screen, EventType
-from ingame.objects import Text, Button, Input
+from ingame.objects import Text, Button, Input, Image
 
 app = InGame()
 
@@ -59,6 +59,12 @@ def ht_click() -> None:
 
 Button(screen, text="Print input value", command=ht_click, packargs={"pady": 10})
 
+# Display a local image (resize to 100x100)
+img = Image(screen, source="/path/to/image.png", width=100, height=100, packargs={"pady": 10})
+
+# Display a remote image (auto-size)
+# img2 = Image(screen, source="https://example.com/image.jpg")
+
 
 
 screen.show()
@@ -85,7 +91,26 @@ Handles registering and triggering events:
 * `@event(type: EventType.Key)`: Registers a function for a specific key event.
 * `trigger_event(type)`: Manually triggers an event.
 
-### `Screen`
+
+### `Image`
+
+Displays an image from a local file or remote URL.
+
+**Constructor:**
+
+```python
+Image(screen_obj, source, packargs=None, width=None, height=None, **kwargs)
+```
+
+- `screen_obj`: The `Screen` to attach the image to
+- `source`: Path to local file or remote URL
+- `packargs`: Optional dict for layout (e.g., `{"pady": 10}`)
+- `width`, `height`: Resize image (preserves aspect ratio if only one is set)
+- `**kwargs`: Additional tkinter.Label options
+
+**Methods:**
+- `config(**kwargs)`: Configure the image widget
+- `destroy()`: Remove the image from the GUI
 
 Simple `tkinter` window with key event binding:
 

src/ingame/objects.py

@@ -101,6 +101,76 @@ def destroy(
 
         self.text_obj.destroy()
 
+class Image(Object):
+    """
+    Displays an image (from file or URL) on the given Screen, packs it with optional args,
+    and provides a destroy() method for cleanup. Supports basic transformations (resize, scale, position).
+    """
+
+    image_obj: tk.Label
+    _photo_image: Any
+
+
+    def __init__(
+        self,
+        screen_obj: Screen,
+        source: str,
+        /,
+        packargs: Optional[dict[Any, Optional[Any]]] = None,
+        width: Optional[int] = None,
+        height: Optional[int] = None,
+        **kwargs: Any
+    ) -> None:
+        """
+        source: Path to local file or URL
+        width, height: Optional resize dimensions
+        """
+        import io
+        from PIL import Image as PILImage, ImageTk
+        import requests
+
+        if not isinstance(screen_obj, Screen):
+            raise TypeError("screen_obj must be an instance of Screen")
+
+        if packargs is None:
+            packargs = {}
+
+        # Load image from file or URL
+        img_data = None
+        if source.startswith("http://") or source.startswith("https://"):
+            resp = requests.get(source)
+            resp.raise_for_status()
+            img_data = io.BytesIO(resp.content)
+        else:
+            img_data = source
+
+        pil_img = PILImage.open(img_data)
+        if width or height:
+            # If only one is provided, keep aspect ratio
+            orig_w, orig_h = pil_img.size
+            if width and not height:
+                height = int(orig_h * (width / orig_w))
+            elif height and not width:
+                width = int(orig_w * (height / orig_h))
+            pil_img = pil_img.resize((width, height), PILImage.LANCZOS)
+
+        self._photo_image = ImageTk.PhotoImage(pil_img)
+        self.image_obj = tk.Label(screen_obj.root, image=self._photo_image, **kwargs)
+        self.image_obj.pack(**{k: v for k, v in packargs.items() if v is not None})
+
+    def config(
+        self,
+        **kwargs
+    ) -> None:
+        """Configure object"""
+        self.image_obj.config(**kwargs)
+
+    def destroy(
+        self
+    ) -> None:
+        """Destroy image widget"""
+        self.image_obj.destroy()
+
 class Input(Object):
     """
     Creates a single line text input box on the given Screen, packs it with optional args,