pyclickimage.ImageViewer

class pyclickimage.ImageViewer(parent=None, half_shift=True)

Bases: QGraphicsView

Interactive image viewer with: - subpixel cursor tracking - crosshair overlay - zoom with mouse wheel - precise click detection (drag-safe) - marker system for annotation

half-shift :

• True = (0,0) on the center of the first pixel.

• False = (0,0) on the corner of the first pixel.

add_marker(center: ~typing.Tuple[float, float], color: ~PyQt5.QtGui.QColor = <PyQt5.QtGui.QColor object>, size: int = 8) → None

Add a cross-style marker at a given position.

Parameters:

• center (Tuple[float, float]) – (x, y) coordinates.

• color (QtGui.QColor) – Marker color.

• size (int) – Half-size of cross arms.

clear_markers() → None

Remove all markers from the scene.

get_crosshair_color() → QColor

Return current crosshair color.

left_click_signal

load_image(path: str) → None

Load an image into the viewer.

Parameters:

path (str) – Path to image file.

Raises:

ValueError – If image cannot be loaded.

mouseMoveEvent(event: QMouseEvent) → None

Update crosshair and coordinate display.

Parameters:

event (QtGui.QMouseEvent) – Mouse move event.

mousePressEvent(event: QMouseEvent) → None

Store press position for click validation.

Parameters:

event (QtGui.QMouseEvent) – Mouse press event.

mouseReleaseEvent(event: QMouseEvent) → None

Detect valid click and emit coordinates.

Parameters:

event (QtGui.QMouseEvent) – Mouse release event.

reset_view() → None

Reset the view to the initial state (no zoom, centered image).

This method: - resets the internal zoom counter - resets Qt transformation matrix - re-applies fitInView on the current image

right_click_signal

set_crosshair_color(color)

Set the crosshair color

set_image(pixmap: QPixmap)

Set the displayed image in the viewer.

Parameters:

pixmap (QtGui.QPixmap) – Image already converted for Qt display.

wheelEvent(event: QWheelEvent) → None

Handle zoom with mouse wheel.

Parameters:

event (QtGui.QWheelEvent) – Wheel event.