pixelflow 0.1.2__tar.gz → 0.1.3__tar.gz

{pixelflow-0.1.2 → pixelflow-0.1.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pixelflow
-Version: 0.1.2
+Version: 0.1.3
 Summary: Computer vision processing library for visualizing and analyzing detection results from ML models
 Author-email: Emrah Nazif <emrah@datamarkin.com>, Datamarkin <support@datamarkin.com>
 License: MIT
@@ -29,6 +29,7 @@ Requires-Dist: shapely>=2.0.0
 Requires-Dist: numpy>=1.21.0
 Requires-Dist: opencv-python>=4.8.0
 Requires-Dist: scipy>=1.10.0
+Requires-Dist: Pillow>=9.0.0
 Provides-Extra: dev
 Requires-Dist: pytest>=7.0.0; extra == "dev"
 Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
@@ -50,12 +51,12 @@ import pixelflow as pf
 from ultralytics import YOLO
 
 model = YOLO("yolo11n.pt")
-media = pf.Media("traffic.mp4")
+video = pf.VideoReader("traffic.mp4", width=640)
 tracker = pf.tracker.ByteTracker()
 zones = pf.Zones()
 zones.add_zone([(100, 400), (500, 400), (500, 600), (100, 600)], zone_id="entrance")
 
-for frame in media.frames:
+for frame in video:
     detections = pf.detections.from_ultralytics(model.predict(frame))
     detections = tracker.update(detections)
     zones.update(detections)
@@ -64,7 +65,8 @@ for frame in media.frames:
     frame = pf.annotate.label(frame, detections)
     frame = pf.annotate.zones(frame, zones)
 
-    pf.show_frame("Live", frame)
+    if pf.show_frame("Live", frame) == ord('q'):
+        break
 ```
 
 ## Installation
@@ -139,29 +141,32 @@ english_text = detections.filter_by_text_language("en")
 
 ### Media Handling
 
-Unified interface for videos, images, webcams, and streams:
+Purpose-built classes for videos, cameras, and images:
 
 ```python
 import pixelflow as pf
 
-# Video file with automatic resizing
-media = pf.Media("video.mp4", width=640)
-print(media.info)  # MediaInfo(resolution=1920x1080, fps=30.00, frames=900, duration=30.00s)
+# Read a video file
+video = pf.VideoReader("video.mp4", width=640)
+print(f"{video.width}x{video.height}, {video.fps}fps, {len(video)} frames")
 
-for frame in media.frames:  # Lazy loading, memory efficient
-    # Process frame
-    pf.show_frame("Preview", frame)
+for frame in video:       # Replayable — resets on each iteration
+    if pf.show_frame("Preview", frame) == ord('q'):
+        break
 
-# Webcam
-webcam = pf.Media(0)
+# Load a single image
+image = pf.read_image("photo.jpg", width=640)
 
-# Network stream
-stream = pf.Media("rtsp://camera.local/stream")
+# Webcam / network stream
+cam = pf.CameraStream(0, width=640)
+cam = pf.CameraStream("rtsp://camera.local/stream")
 
 # Write processed video
-for frame in pf.Media("input.mp4").frames:
+writer = pf.VideoWriter("output.mp4", fps=video.fps)
+for frame in video:
     processed = process(frame)
-    pf.write_frame("output.mp4", processed, media.info)
+    writer.write(processed)
+writer.close()
 ```
 
 ### Zone-Based Analytics

{pixelflow-0.1.2 → pixelflow-0.1.3}/README.md

@@ -13,12 +13,12 @@ import pixelflow as pf
 from ultralytics import YOLO
 
 model = YOLO("yolo11n.pt")
-media = pf.Media("traffic.mp4")
+video = pf.VideoReader("traffic.mp4", width=640)
 tracker = pf.tracker.ByteTracker()
 zones = pf.Zones()
 zones.add_zone([(100, 400), (500, 400), (500, 600), (100, 600)], zone_id="entrance")
 
-for frame in media.frames:
+for frame in video:
     detections = pf.detections.from_ultralytics(model.predict(frame))
     detections = tracker.update(detections)
     zones.update(detections)
@@ -27,7 +27,8 @@ for frame in media.frames:
     frame = pf.annotate.label(frame, detections)
     frame = pf.annotate.zones(frame, zones)
 
-    pf.show_frame("Live", frame)
+    if pf.show_frame("Live", frame) == ord('q'):
+        break
 ```
 
 ## Installation
@@ -102,29 +103,32 @@ english_text = detections.filter_by_text_language("en")
 
 ### Media Handling
 
-Unified interface for videos, images, webcams, and streams:
+Purpose-built classes for videos, cameras, and images:
 
 ```python
 import pixelflow as pf
 
-# Video file with automatic resizing
-media = pf.Media("video.mp4", width=640)
-print(media.info)  # MediaInfo(resolution=1920x1080, fps=30.00, frames=900, duration=30.00s)
+# Read a video file
+video = pf.VideoReader("video.mp4", width=640)
+print(f"{video.width}x{video.height}, {video.fps}fps, {len(video)} frames")
 
-for frame in media.frames:  # Lazy loading, memory efficient
-    # Process frame
-    pf.show_frame("Preview", frame)
+for frame in video:       # Replayable — resets on each iteration
+    if pf.show_frame("Preview", frame) == ord('q'):
+        break
 
-# Webcam
-webcam = pf.Media(0)
+# Load a single image
+image = pf.read_image("photo.jpg", width=640)
 
-# Network stream
-stream = pf.Media("rtsp://camera.local/stream")
+# Webcam / network stream
+cam = pf.CameraStream(0, width=640)
+cam = pf.CameraStream("rtsp://camera.local/stream")
 
 # Write processed video
-for frame in pf.Media("input.mp4").frames:
+writer = pf.VideoWriter("output.mp4", fps=video.fps)
+for frame in video:
     processed = process(frame)
-    pf.write_frame("output.mp4", processed, media.info)
+    writer.write(processed)
+writer.close()
 ```
 
 ### Zone-Based Analytics

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/__init__.py

@@ -1,4 +1,4 @@
-__version__ = "0.1.2"
+__version__ = "0.1.3"
 __author__ = "Datamarkin"
 
 # Import core modules
@@ -14,9 +14,15 @@ from . import slicer
 from . import smoother
 from . import timer
 from . import tracker
+from . import assets
+from .classes import COCO_CLASSES
 
 # Import specific functions for top-level access
-from .media import Media, MediaInfo, write_frame, show_frame, close_display
+from .media import (
+    DisplayExit, VideoReader, CameraStream, VideoWriter,
+    read_image, read_video, display_video, display_image, save_image,
+    close_display, to_pil, from_pil,
+)
 from .zones import Zones
 from .crossings import Crossings
 from .slicer import SlicedInference, auto_slice_size
@@ -38,11 +44,18 @@ __all__ = [
 
     # Media handling
     "media",
-    "Media",
-    "MediaInfo",
-    "write_frame",
-    "show_frame",
+    "DisplayExit",
+    "VideoReader",
+    "CameraStream",
+    "VideoWriter",
+    "read_image",
+    "read_video",
+    "display_video",
+    "display_image",
+    "save_image",
     "close_display",
+    "to_pil",
+    "from_pil",
 
     # Spatial analysis
     "zones",
@@ -51,6 +64,7 @@ __all__ = [
     "Crossings",
 
     # Processing utilities
+    "assets",
     "slicer",
     "SlicedInference",
     "auto_slice_size",
@@ -62,6 +76,9 @@ __all__ = [
     "TimeTracker",
     "tracker",
 
+    # Constants
+    "COCO_CLASSES",
+
     # Metadata
     "__version__",
     "__author__"

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/__init__.py

@@ -23,7 +23,7 @@ from .zones import zones
 # TODO: Import these once implemented
 from .filled_box import filled_box
 # from .dot import dot
-# from .fps_counter import fps_counter
+from .fps_counter import fps_counter
 from .grid_overlay import grid_overlay
 # from .heatmap import heatmap
 from .keypoint import keypoint
@@ -56,5 +56,8 @@ __all__ = [
 
     # Zone annotators
     'zones',
-    'crossings'
+    'crossings',
+
+    # Overlay annotators
+    'fps_counter',
 ]

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/anchors.py

@@ -38,7 +38,7 @@ def anchors(
     Supports drawing individual anchor points or multiple points simultaneously.
     
     Args:
-        image (np.ndarray): Input image to draw anchor points on in BGR format.
+        image (np.ndarray): Input image to draw anchor points on in RGB format.
                            Image is modified in-place.
         detections (Detections): Detection results containing bounding boxes.
                                 Each detection must have a 'bbox' attribute with (x1, y1, x2, y2) coordinates.
@@ -51,7 +51,7 @@ def anchors(
         thickness (Optional[int]): Thickness of circle outline in pixels.
                                   Use -1 for filled circles.
                                   If None, defaults to -1 (filled).
-        colors (Optional[List[tuple]]): List of BGR color tuples for custom colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples for custom colors.
                                        Colors mapped to unique class_ids in order of appearance.
                                        If None, uses default ColorManager colors.
     

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/box.py

@@ -22,13 +22,13 @@ def box(
     Automatically adapts line thickness based on image dimensions for optimal visibility.
 
     Args:
-        image (np.ndarray): Input image to draw boxes on (BGR format).
+        image (np.ndarray): Input image to draw boxes on (RGB format).
                            Modified in-place with drawn bounding boxes.
         detections (Detections): Detections object containing bounding boxes.
                                 Each detection must have a 'bbox' attribute with (x1, y1, x2, y2) coordinates.
         thickness (Optional[int]): Line thickness for bounding boxes in pixels.
                                   If None, automatically determined based on image size.
-        colors (Optional[List[tuple]]): List of BGR color tuples to override default colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples to override default colors.
                                        Colors are mapped to unique class_ids in order of appearance.
                                        If None, uses default ColorManager colors.
 
@@ -54,7 +54,7 @@ def box(
         >>> annotated = pf.annotators.box(image, detections)
         >>>
         >>> # Override with custom colors for specific classes
-        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Blue, Green, Red
+        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Red, Green, Blue
         >>> annotated = pf.annotators.box(image, detections, colors=custom_colors)
         >>>
         >>> # Use custom thickness for fine control

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/crossing.py

@@ -29,18 +29,18 @@ def crossing(
     The annotation adapts automatically to image resolution for optimal visibility.
     
     Args:
-        image (np.ndarray): Input BGR image to annotate. Must be a 3-channel NumPy array
+        image (np.ndarray): Input RGB image to annotate. Must be a 3-channel NumPy array
                            with shape (height, width, 3).
         crossing_line: Crossing object from pixelflow.crossings containing line geometry,
                       counts, and color. Must have attributes: start, end, color,
                       in_count, out_count.
         thickness (Optional[int]): Line thickness in pixels. If None, uses adaptive
                                   sizing based on image resolution. Range: [1, ∞].
-        color (Optional[Tuple[int, int, int]]): Line color as BGR tuple (0-255 each).
+        color (Optional[Tuple[int, int, int]]): Line color as RGB tuple (0-255 each).
                                               If None, uses crossing_line.color.
         text_thickness (Optional[int]): Text stroke thickness in pixels. If None,
                                        uses adaptive sizing. Range: [1, ∞].
-        text_color (Optional[Tuple[int, int, int]]): Text color as BGR tuple (0-255 each).
+        text_color (Optional[Tuple[int, int, int]]): Text color as RGB tuple (0-255 each).
                                                    Default is white (255, 255, 255).
         text_scale (Optional[float]): Text scale factor. If None, uses adaptive sizing.
                                      Range: (0, ∞). Default ~0.5.
@@ -146,7 +146,7 @@ def crossing(
     start_point = tuple(map(int, crossing_line.start))
     end_point = tuple(map(int, crossing_line.end))
     cv2.line(image, start_point, end_point, crossing_color, thickness, cv2.LINE_AA)
-    
+
     # Draw end point markers (scale with image size)
     marker_size = max(3, int(params['thickness'] * 2.5))
     cv2.circle(image, start_point, marker_size, text_color, -1, cv2.LINE_AA)
@@ -191,7 +191,7 @@ def crossing(
             bg_x2 = text_x + text_width + text_padding
             bg_y2 = text_y + text_padding
             cv2.rectangle(image, (bg_x1, bg_y1), (bg_x2, bg_y2), crossing_color, -1)
-        
+
         # Draw text
         cv2.putText(
             image, text, (text_x, text_y),
@@ -211,7 +211,7 @@ def crossings(image: np.ndarray, crossings_manager) -> np.ndarray:
     information using the crossing() function.
     
     Args:
-        image (np.ndarray): Input BGR image to annotate. Must be a 3-channel NumPy array
+        image (np.ndarray): Input RGB image to annotate. Must be a 3-channel NumPy array
                            with shape (height, width, 3).
         crossings_manager: Crossings manager object containing multiple crossing lines.
                           Must have a 'crossings' attribute that is iterable,

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/filled_box.py

@@ -23,7 +23,7 @@ def filled_box(
     dimensions for optimal visibility and uses alpha blending for professional-quality results.
     
     Args:
-        image (np.ndarray): Input image to draw filled boxes on in BGR color format.
+        image (np.ndarray): Input image to draw filled boxes on in RGB color format.
                            Expected shape: (height, width, 3) with uint8 values [0, 255].
         detections (Detections): Detections object containing bounding boxes.
                                Each detection must have a 'bbox' attribute with (x1, y1, x2, y2) 
@@ -33,8 +33,8 @@ def filled_box(
                                  Range: [0.0, 1.0] where 0.0 is fully transparent and 1.0 is opaque.
                                  Values outside this range are automatically clamped.
                                  If None, automatically calculated based on image size (typically 0.3-0.5).
-        colors (Optional[List[tuple]]): List of BGR color tuples to override default colors.
-                                      Each tuple should contain (B, G, R) values in range [0, 255].
+        colors (Optional[List[tuple]]): List of RGB color tuples to override default colors.
+                                      Each tuple should contain (R, G, B) values in range [0, 255].
                                       Colors are mapped to unique class_ids in order of appearance.
                                       If None, uses default ColorManager colors based on class_id.
     
@@ -66,7 +66,7 @@ def filled_box(
         >>> annotated = pf.annotate.filled_box(image, detections, opacity=0.25)
         >>> 
         >>> # Override with custom colors for specific visualization needs
-        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Blue, Green, Red
+        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Red, Green, Blue
         >>> annotated = pf.annotate.filled_box(image, detections, opacity=0.4, colors=custom_colors)
         >>> 
         >>> # High opacity for maximum emphasis in presentations

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/fps_counter.py

@@ -32,12 +32,15 @@ def fps_counter(image: np.ndarray, detections: 'Detections', thickness=None):
     else:
         font_scale = 1
     
-    # Import colors locally to avoid circular dependency
-    from .. import colors as color_module
-    colors = color_module.ColorManager()
-    
-    # Draw FPS text
+    # Compute adaptive position based on image dimensions
+    params = _get_adaptive_params(image)
+    padding = params['padding']
+    text_size = cv2.getTextSize(f"FPS: 000", cv2.FONT_HERSHEY_SIMPLEX, font_scale, thickness)[0]
+    position = (padding, padding + text_size[1])
+
+    # Draw FPS text in green (RGB)
+    fps_color = (0, 255, 0)
     fps_text = f"FPS: {int(fps_counter.fps)}"
-    cv2.putText(image, fps_text, (10, 30), cv2.FONT_HERSHEY_SIMPLEX, font_scale, colors.ui('fps'), thickness)
+    cv2.putText(image, fps_text, position, cv2.FONT_HERSHEY_SIMPLEX, font_scale, fps_color, thickness)
 
     return image

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/grid_overlay.py

@@ -26,7 +26,7 @@ def grid_overlay(
     Can create filled checkerboard patterns for visual segmentation.
     
     Args:
-        image (np.ndarray): Input image to draw grid overlays on. Must be in BGR format
+        image (np.ndarray): Input image to draw grid overlays on. Must be in RGB format
                            with shape (H, W, 3) and dtype uint8.
         detections (Detections): Detections object containing bounding boxes.
                                 Each detection must have a 'bbox' attribute with (x1, y1, x2, y2) coordinates
@@ -38,7 +38,7 @@ def grid_overlay(
         thickness (Optional[int]): Line thickness for grid lines in pixels.
                                   If None, automatically determined based on image size (typically 1-3).
                                   Range: Must be >= 1. Values > 10 may cause visual overlap.
-        colors (Optional[List[tuple]]): List of BGR color tuples to override default colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples to override default colors.
                                        Each tuple must be 3 integers in range [0, 255].
                                        Colors are mapped to unique class_ids in order of appearance.
                                        If None, uses default ColorManager colors.
@@ -151,7 +151,7 @@ def grid_overlay(
                         cell_x2 = int(x1 + (col + 1) * cell_width)
                         cell_y2 = int(y1 + (row + 1) * cell_height)
                         
-                        cv2.rectangle(overlay, (cell_x1, cell_y1), (cell_x2, cell_y2), 
+                        cv2.rectangle(overlay, (cell_x1, cell_y1), (cell_x2, cell_y2),
                                     color, thickness=cv2.FILLED)
             
             # Blend overlay with original image
@@ -161,7 +161,7 @@ def grid_overlay(
         for i in range(1, cols):
             x_pos = int(x1 + (width * i / cols))
             cv2.line(image, (x_pos, y1), (x_pos, y2), color=color, thickness=thickness)
-        
+
         # Draw horizontal grid lines
         for i in range(1, rows):
             y_pos = int(y1 + (height * i / rows))

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/keypoint.py

@@ -26,7 +26,7 @@ def keypoint(
     point annotations.
 
     Args:
-        image (np.ndarray): Input image to draw keypoints on (BGR format).
+        image (np.ndarray): Input image to draw keypoints on (RGB format).
                            Modified in-place with drawn keypoint markers.
         detections (Detections): Detections object containing keypoints.
                                 Each detection may have a 'keypoints' attribute with
@@ -36,7 +36,7 @@ def keypoint(
         thickness (Optional[int]): Thickness of circle outline in pixels.
                                   Use -1 for filled circles (default).
                                   If None, defaults to -1 (filled).
-        colors (Optional[List[tuple]]): List of BGR color tuples for custom colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples for custom colors.
                                        Colors mapped to unique class_ids in order.
                                        If None, uses default ColorManager colors.
         show_names (bool): If True, draws keypoint names as text labels next to points.
@@ -67,7 +67,7 @@ def keypoint(
         ...     image, detections,
         ...     radius=5,
         ...     thickness=2,
-        ...     colors=[(0, 255, 0)],  # Green
+        ...     colors=[(0, 255, 0)],  # Green (RGB)
         ...     show_names=True
         ... )
         >>>

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/keypoint_skeleton.py

@@ -50,7 +50,7 @@ def keypoint_skeleton(
     body structure, wing structure, or any connected landmark system.
 
     Args:
-        image (np.ndarray): Input image to draw skeleton on (BGR format).
+        image (np.ndarray): Input image to draw skeleton on (RGB format).
                            Modified in-place with drawn skeleton lines.
         detections (Detections): Detections object containing keypoints.
                                 Each detection may have a 'keypoints' attribute with
@@ -61,7 +61,7 @@ def keypoint_skeleton(
                                                        If None, uses COCO human pose skeleton.
         thickness (Optional[int]): Line thickness for skeleton connections in pixels.
                                   If None, automatically determined based on image size.
-        colors (Optional[List[tuple]]): List of BGR color tuples for custom colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples for custom colors.
                                        Colors mapped to unique class_ids in order.
                                        If None, uses default ColorManager colors.
 

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/label.py

@@ -29,7 +29,7 @@ def label(
     
     Args:
         image (np.ndarray): Input image to annotate. Must be a valid OpenCV image array
-                           in BGR format with shape (H, W, 3) or (H, W).
+                           in RGB format with shape (H, W, 3) or (H, W).
         detections (Detections): PixelFlow detections object containing bounding box
                                coordinates and optional attributes (class_name, confidence,
                                class_id, tracker_id).
@@ -48,10 +48,10 @@ def label(
                       Range: [0, 50]. Default is 6.
         line_spacing (int): Additional spacing in pixels between lines for multi-line text.
                            Range: [0, 20]. Default is 2.
-        bg_color (Optional[Union[tuple, str]]): Background rectangle color in BGR format.
+        bg_color (Optional[Union[tuple, str]]): Background rectangle color in RGB format.
                                               If None, uses automatic color based on class_id.
-                                              Can be tuple (B, G, R) or color string.
-        text_color (tuple): Text color in BGR format. Default is white (255, 255, 255).
+                                              Can be tuple (R, G, B) or color string.
+        text_color (tuple): Text color in RGB format. Default is white (255, 255, 255).
         
     Returns:
         np.ndarray: Input image with labels drawn directly on it (in-place modification).

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/mask.py

@@ -22,7 +22,7 @@ def mask(
     lists, with automatic format detection and conversion for seamless integration.
     
     Args:
-        frame (np.ndarray): Input video frame in BGR format (height, width, 3).
+        frame (np.ndarray): Input video frame in RGB format (height, width, 3).
                            Modified in-place with overlaid masks.
         detections (Detections): Detections object containing mask data.
                                 Each detection's masks attribute can contain binary arrays
@@ -30,7 +30,7 @@ def mask(
         opacity (float): Opacity level for blending masks with the frame.
                         Range: [0.0, 1.0]. Default is 0.5 (semi-transparent).
                         Value of 1.0 creates opaque masks, 0.0 makes them invisible.
-        colors (Optional[List[tuple]]): List of BGR color tuples to override default colors.
+        colors (Optional[List[tuple]]): List of RGB color tuples to override default colors.
                                        Colors are mapped to unique class_ids in order of appearance.
                                        If None, uses default ColorManager colors.
         
@@ -57,7 +57,7 @@ def mask(
         >>> annotated = pf.annotators.mask(image, detections)
         >>> 
         >>> # Use custom colors for specific classes
-        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Blue, Green, Red
+        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Red, Green, Blue
         >>> annotated = pf.annotators.mask(image, detections, colors=custom_colors)
         >>> 
         >>> # Create opaque masks for clear segmentation boundaries

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/oval.py

@@ -26,7 +26,7 @@ def oval(
     effects, and ground-based tracking visualizations.
     
     Args:
-        image (np.ndarray): Input image array with shape (H, W, 3) in BGR color format.
+        image (np.ndarray): Input image array with shape (H, W, 3) in RGB color format.
         detections (Detections): PixelFlow detections object containing bounding boxes. 
                                 Each detection must have a `.bbox` attribute with 
                                 (x1, y1, x2, y2) coordinates.
@@ -38,8 +38,8 @@ def oval(
         end_angle (int): Ending angle of the ellipse arc in degrees. 
                         Range: -180 to 360. Default is 235 (bottom-right, creating 
                         bottom arc spanning ~280 degrees).
-        colors (Optional[List[Tuple[int, int, int]]]): List of BGR color tuples 
-                                                      (B, G, R) where each value is 
+        colors (Optional[List[Tuple[int, int, int]]]): List of RGB color tuples
+                                                      (R, G, B) where each value is
                                                       0-255. Colors are mapped to unique 
                                                       class_ids in order of appearance. 
                                                       If None, uses default ColorManager colors.

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/polygon.py

@@ -23,15 +23,15 @@ def polygon(
     color schemes for visual distinction between different object classes.
     
     Args:
-        image (np.ndarray): Input image to draw polygons on. Must be a valid BGR image array.
+        image (np.ndarray): Input image to draw polygons on. Must be a valid RGB image array.
         detections (Detections): Detections object containing segmentation data.
                                 Each detection must have a 'segments' attribute with polygon coordinates.
         thickness (Optional[int]): Line thickness for polygon outlines in pixels.
                                  If None, automatically calculated based on image dimensions.
                                  Range: [1-50]. Default is adaptive (typically 1-6).
-        colors (Optional[List[Tuple[int, int, int]]]): List of BGR color tuples to override default colors.
+        colors (Optional[List[Tuple[int, int, int]]]): List of RGB color tuples to override default colors.
                                                      Colors are cycled through unique class_ids in order of appearance.
-                                                     Each tuple should be (B, G, R) with values [0-255].
+                                                     Each tuple should be (R, G, B) with values [0-255].
                                                      If None, uses default ColorManager colors.
         
     Returns:
@@ -57,7 +57,7 @@ def polygon(
         >>> annotated = pf.annotators.polygon(image, results)
         >>> 
         >>> # Customize line thickness and colors
-        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Blue, Green, Red
+        >>> custom_colors = [(255, 0, 0), (0, 255, 0), (0, 0, 255)]  # Red, Green, Blue
         >>> annotated = pf.annotators.polygon(image, results, thickness=3, colors=custom_colors)
         >>> 
         >>> # Use adaptive thickness on high-resolution image

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/utils.py

@@ -32,16 +32,16 @@ def _get_adaptive_params(image):
     base_scale = np.sqrt(width * height) / 1000 * ADAPTIVE_SCALE_MULTIPLIER
     
     params = {
-        'thickness': max(1, int(base_scale * 2)),
-        'font_scale': max(0.3, base_scale * 0.5),
-        'font_thickness': max(1, int(base_scale * 1.5)),
-        'padding': max(2, int(base_scale * 5)),
-        'margin': max(1, int(base_scale * 2)),
-        'text_offset': max(10, int(base_scale * 20)),
-        'blur_kernel': max(3, int(base_scale * 15)) | 1,  # ensure odd number
+        'thickness': max(1, int(base_scale * 3)),
+        'font_scale': max(0.3, base_scale * 0.6),
+        'font_thickness': max(1, int(base_scale * 2.5)),
+        'padding': max(2, int(base_scale * 8)),
+        'margin': max(1, int(base_scale * 3)),
+        'text_offset': max(10, int(base_scale * 25)),
+        'blur_kernel': max(3, int(base_scale * 25)) | 1,  # ensure odd number
         'pixel_size': max(2, int(base_scale * 10)),
-        'corner_radius': max(0, int(base_scale * 5)),
-        'shadow_offset': max(1, int(base_scale * 2)),
+        'corner_radius': max(0, int(base_scale * 8)),
+        'shadow_offset': max(1, int(base_scale * 3)),
     }
     
     _adaptive_cache[shape_key] = params

{pixelflow-0.1.2 → pixelflow-0.1.3}/pixelflow/annotators/zones.py

@@ -28,7 +28,7 @@ def zones(
     thickness based on image resolution for optimal visibility across different image sizes.
     
     Args:
-        image (np.ndarray): Input image to annotate. Must be 3-channel BGR format.
+        image (np.ndarray): Input image to annotate. Must be 3-channel RGB format.
         zone_manager: ZoneManager instance containing polygon zones with associated metadata.
                      Must have 'zones' attribute containing Zone objects with polygon, color, 
                      name, and count attributes.