Class SwingImageViewer

java.lang.Object

java.awt.Component

java.awt.Container

javax.swing.JComponent

javax.swing.JPanel

uno.anahata.asi.swing.agi.render.SwingImageViewer

All Implemented Interfaces:

ImageObserver, MenuContainer, Serializable, Accessible, MediaViewerComponent

public class SwingImageViewer
extends JPanel
implements MediaViewerComponent

High-fidelity pure Swing image viewer implementing MediaViewerComponent.

Supports smooth interactive zoom (mouse wheel), mouse dragging to pan when zoomed, double-click fit/1:1 toggle, integrated MediaToolbar, and right-click context actions.

Author:

anahata

See Also:

• Serialized Form

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
private class	SwingImageViewer.ImageCanvas	Interactive canvas rendering the scaled image centered in the viewport.

Nested classes/interfaces inherited from class JPanel

JPanel.AccessibleJPanel

Nested classes/interfaces inherited from class JComponent

JComponent.AccessibleJComponent

Nested classes/interfaces inherited from class Container

Container.AccessibleAWTContainer

Nested classes/interfaces inherited from class Component

Component.AccessibleAWTComponent, Component.BaselineResizeBehavior, Component.BltBufferStrategy, Component.FlipBufferStrategy

Field Summary

Fields

Modifier and Type	Field	Description
private final SwingImageViewer.ImageCanvas	canvas	The interactive image drawing canvas.
private boolean	fitToView	Whether the image is currently fitted to the viewport dimensions.
private BufferedImage	image	Decoded full-resolution image.
private double	scale	Current zoom scale factor (1.0 = 100% 1:1).
private final JScrollPane	scrollPane	The scroll pane enclosing the canvas.
private final MediaToolbar	toolbar	The action and metadata toolbar.

Fields inherited from class JComponent

listenerList, TOOL_TIP_TEXT_KEY, ui, UNDEFINED_CONDITION, WHEN_ANCESTOR_OF_FOCUSED_COMPONENT, WHEN_FOCUSED, WHEN_IN_FOCUSED_WINDOW

Fields inherited from class Component

accessibleContext, BOTTOM_ALIGNMENT, CENTER_ALIGNMENT, LEFT_ALIGNMENT, RIGHT_ALIGNMENT, TOP_ALIGNMENT

Fields inherited from interface ImageObserver

ABORT, ALLBITS, ERROR, FRAMEBITS, HEIGHT, PROPERTIES, SOMEBITS, WIDTH

Constructor Summary

Constructors

Constructor	Description
SwingImageViewer(@NonNull AgiPanel agiPanel)	Constructs a new SwingImageViewer.

Method Summary

Modifier and Type	Method	Description
private void	calculateFitScale()	Computes the scale needed to fit the image inside the viewport.
void	dispose()	Permanently disposes of the component, releasing native decoders, textures, and timers.
JComponent	getComponent()	Returns the Swing JComponent to be embedded in the UI hierarchy.
void	load(byte[] data, String mimeType, String displayName, URI sourceUri)	Loads and initializes the media data for display and playback.
private void	setupInteractions()	Configures mouse wheel zoom, pan dragging, and context menu.
private void	showContextMenu(MouseEvent e)	Displays a popup context menu with common image actions.
void	stop()	Stops active audio or video playback, pausing decoding threads.
void	toggleFitOrActualSize()	Toggles between fit-to-view and actual 1:1 pixel size.
private void	updateCanvasSize()	Updates the canvas dimensions to match the scaled image size.
void	zoom(double factor, Point anchor)	Zooms the image by a multiplier centered on the given anchor point.

Methods inherited from class JPanel

getAccessibleContext, getUI, getUIClassID, paramString, setUI, updateUI

Methods inherited from class JComponent

addAncestorListener, addNotify, addVetoableChangeListener, computeVisibleRect, contains, createToolTip, disable, enable, firePropertyChange, firePropertyChange, firePropertyChange, fireVetoableChange, getActionForKeyStroke, getActionMap, getAlignmentX, getAlignmentY, getAncestorListeners, getAutoscrolls, getBaseline, getBaselineResizeBehavior, getBorder, getBounds, getClientProperty, getComponentGraphics, getComponentPopupMenu, getConditionForKeyStroke, getDebugGraphicsOptions, getDefaultLocale, getFontMetrics, getGraphics, getHeight, getInheritsPopupMenu, getInputMap, getInputMap, getInputVerifier, getInsets, getInsets, getListeners, getLocation, getMaximumSize, getMinimumSize, getNextFocusableComponent, getPopupLocation, getPreferredSize, getRegisteredKeyStrokes, getRootPane, getSize, getToolTipLocation, getToolTipText, getToolTipText, getTopLevelAncestor, getTransferHandler, getVerifyInputWhenFocusTarget, getVetoableChangeListeners, getVisibleRect, getWidth, getX, getY, grabFocus, hide, isDoubleBuffered, isLightweightComponent, isManagingFocus, isOpaque, isOptimizedDrawingEnabled, isPaintingForPrint, isPaintingOrigin, isPaintingTile, isRequestFocusEnabled, isValidateRoot, paint, paintBorder, paintChildren, paintComponent, paintImmediately, paintImmediately, print, printAll, printBorder, printChildren, printComponent, processComponentKeyEvent, processKeyBinding, processKeyEvent, processMouseEvent, processMouseMotionEvent, putClientProperty, registerKeyboardAction, registerKeyboardAction, removeAncestorListener, removeNotify, removeVetoableChangeListener, repaint, repaint, requestDefaultFocus, requestFocus, requestFocus, requestFocusInWindow, requestFocusInWindow, resetKeyboardActions, reshape, revalidate, scrollRectToVisible, setActionMap, setAlignmentX, setAlignmentY, setAutoscrolls, setBackground, setBorder, setComponentPopupMenu, setDebugGraphicsOptions, setDefaultLocale, setDoubleBuffered, setEnabled, setFocusTraversalKeys, setFont, setForeground, setInheritsPopupMenu, setInputMap, setInputVerifier, setMaximumSize, setMinimumSize, setNextFocusableComponent, setOpaque, setPreferredSize, setRequestFocusEnabled, setToolTipText, setTransferHandler, setUI, setVerifyInputWhenFocusTarget, setVisible, unregisterKeyboardAction, update

Methods inherited from class Container

add, add, add, add, add, addContainerListener, addImpl, addPropertyChangeListener, addPropertyChangeListener, applyComponentOrientation, areFocusTraversalKeysSet, countComponents, deliverEvent, doLayout, findComponentAt, findComponentAt, getComponent, getComponentAt, getComponentAt, getComponentCount, getComponents, getComponentZOrder, getContainerListeners, getFocusTraversalKeys, getFocusTraversalPolicy, getLayout, getMousePosition, insets, invalidate, isAncestorOf, isFocusCycleRoot, isFocusCycleRoot, isFocusTraversalPolicyProvider, isFocusTraversalPolicySet, layout, list, list, locate, minimumSize, paintComponents, preferredSize, printComponents, processContainerEvent, processEvent, remove, remove, removeAll, removeContainerListener, setComponentZOrder, setFocusCycleRoot, setFocusTraversalPolicy, setFocusTraversalPolicyProvider, setLayout, transferFocusDownCycle, validate, validateTree

Methods inherited from class Component

action, add, addComponentListener, addFocusListener, addHierarchyBoundsListener, addHierarchyListener, addInputMethodListener, addKeyListener, addMouseListener, addMouseMotionListener, addMouseWheelListener, bounds, checkImage, checkImage, coalesceEvents, contains, createImage, createImage, createVolatileImage, createVolatileImage, disableEvents, dispatchEvent, enable, enableEvents, enableInputMethods, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, firePropertyChange, getBackground, getBounds, getColorModel, getComponentListeners, getComponentOrientation, getCursor, getDropTarget, getFocusCycleRootAncestor, getFocusListeners, getFocusTraversalKeysEnabled, getFont, getForeground, getGraphicsConfiguration, getHierarchyBoundsListeners, getHierarchyListeners, getIgnoreRepaint, getInputContext, getInputMethodListeners, getInputMethodRequests, getKeyListeners, getLocale, getLocation, getLocationOnScreen, getMouseListeners, getMouseMotionListeners, getMousePosition, getMouseWheelListeners, getName, getParent, getPropertyChangeListeners, getPropertyChangeListeners, getSize, getToolkit, getTreeLock, gotFocus, handleEvent, hasFocus, imageUpdate, inside, isBackgroundSet, isCursorSet, isDisplayable, isEnabled, isFocusable, isFocusOwner, isFocusTraversable, isFontSet, isForegroundSet, isLightweight, isMaximumSizeSet, isMinimumSizeSet, isPreferredSizeSet, isShowing, isValid, isVisible, keyDown, keyUp, list, list, list, location, lostFocus, mouseDown, mouseDrag, mouseEnter, mouseExit, mouseMove, mouseUp, move, nextFocus, paintAll, postEvent, prepareImage, prepareImage, processComponentEvent, processFocusEvent, processHierarchyBoundsEvent, processHierarchyEvent, processInputMethodEvent, processMouseWheelEvent, remove, removeComponentListener, removeFocusListener, removeHierarchyBoundsListener, removeHierarchyListener, removeInputMethodListener, removeKeyListener, removeMouseListener, removeMouseMotionListener, removeMouseWheelListener, removePropertyChangeListener, removePropertyChangeListener, repaint, repaint, repaint, requestFocus, requestFocus, requestFocusInWindow, resize, resize, setBounds, setBounds, setComponentOrientation, setCursor, setDropTarget, setFocusable, setFocusTraversalKeysEnabled, setIgnoreRepaint, setLocale, setLocation, setLocation, setMixingCutoutShape, setName, setSize, setSize, show, show, size, toString, transferFocus, transferFocusBackward, transferFocusUpCycle

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Details

toolbar

private final MediaToolbar toolbar

The action and metadata toolbar.

scrollPane

private final JScrollPane scrollPane

The scroll pane enclosing the canvas.

canvas

private final SwingImageViewer.ImageCanvas canvas

The interactive image drawing canvas.

image

private BufferedImage image

Decoded full-resolution image.

scale

private double scale

Current zoom scale factor (1.0 = 100% 1:1).

fitToView

private boolean fitToView

Whether the image is currently fitted to the viewport dimensions.

Constructor Details

SwingImageViewer

public SwingImageViewer(@NonNull
 @NonNull AgiPanel agiPanel)

Constructs a new SwingImageViewer.

Parameters:

agiPanel - The parent AgiPanel providing session and configuration context.

Method Details

setupInteractions

private void setupInteractions()

Configures mouse wheel zoom, pan dragging, and context menu.

toggleFitOrActualSize

public void toggleFitOrActualSize()

Toggles between fit-to-view and actual 1:1 pixel size.

zoom

public void zoom(double factor,
 Point anchor)

Zooms the image by a multiplier centered on the given anchor point.

Parameters:

factor - Zoom factor.

anchor - Mouse anchor point.

calculateFitScale

private void calculateFitScale()

Computes the scale needed to fit the image inside the viewport.

updateCanvasSize

private void updateCanvasSize()

Updates the canvas dimensions to match the scaled image size.

showContextMenu

private void showContextMenu(MouseEvent e)

Displays a popup context menu with common image actions.

Parameters:

e - Mouse event triggering the popup.

getComponent

public JComponent getComponent()

Returns the Swing JComponent to be embedded in the UI hierarchy.

Returns this JPanel as the primary visual component.

Specified by:

getComponent in interface MediaViewerComponent

Returns:

the Swing component.

load

public void load(byte[] data,
 String mimeType,
 String displayName,
 URI sourceUri)

Loads and initializes the media data for display and playback.

Decodes image bytes and updates metadata and toolbar.

Specified by:

load in interface MediaViewerComponent

Parameters:

data - The raw binary data.

mimeType - The detected MIME type (e.g. "video/mp4", "image/png", "audio/wav").

displayName - An optional human-readable name or file name for the media item.

sourceUri - An optional source URI on disk or remote network.

stop

public void stop()

Stops active audio or video playback, pausing decoding threads.

No active audio or video playback in image viewer.

Specified by:

stop in interface MediaViewerComponent

dispose

public void dispose()

Permanently disposes of the component, releasing native decoders, textures, and timers.

Releases image buffer.

Specified by:

dispose in interface MediaViewerComponent