Image

Display raw and compressed images, superimposed with annotations.

Select an image topic to display from the dropdown.

image panel

Supported encodings

Raw imagesCompressed images
8UC1webp
8UC3jpeg
16UC1png
32FC1
bayer_bggr8
bayer_gbrg8
bayer_grbg8
bayer_rggb8
bgr8
bgra8
mono8
mono16
rgb8
rgba8
uyuv
yuyv
yuv422 (deprecated, use uyuv)

Annotations

If your robot is publishing CameraCalibration messages for the selected camera, you can go to the Markers section of the panel to toggle on any ImageAnnotations topic. Any given image annotation topic will overlay a combination of CircleAnnotations and PointsAnnotations onto your selected camera image.

For unrectified images, the image markers will be transformed based on the Camera Calibration.

When zooming in or out on an image, image markers will re-render to remain sharp.

User interactions

Right-click on the image to download it as a PNG file.

download as png

Click any displayed image marker to view its details.

marker details

Use the available zoom controls to adjust the image's scale.

image scale

Scroll to zoom, and drag to pan – by default, the maximum zoom will be set to 300%, but this value can be adjusted in the panel settings.

Settings

General
TopicCamera image topic to display
Transform markersDisplays transform markers in the context of the image
Synchronize timestampsSynchronizes messages from the camera topic and selected markers topics
Bilinear smoothingResamples images to minimize visual distortion when resizing, using bilinear interpolation
Flip horizontalFlip image horizontally over a vertical axis
Flip verticalFlip image vertically over a horizontal axis
RotationRotate image by 90°, 180°, or 270°
Min (depth images)Minimum scaling value for depth images (default: 0); currently only used for mono16 and 16UC1 images
Max (depth images)Maximum scaling value for depth images (default: 10000); currently only used for mono16 and 16UC1 images
Markers
Image annotation markers to toggle on and off

Supported messages

To use this panel, your data source must provide messages conforming to one of the following supported schemas.

RawImage

frameworkschema
ROS 1sensor_msgs/Image
ROS 2sensor_msgs/msg/Image
Customfoxglove.RawImage

CompressedImage

frameworkschema
ROS 1sensor_msgs/CompressedImage
ROS 2sensor_msgs/msg/CompressedImage
Customfoxglove.CompressedImage

CameraCalibration

NOTE: Studio currently only supports plumb_bob and rational_polynomial for the distortion_model field value.

frameworkschema
ROS 1sensor_msgs/CameraInfo
ROS 2sensor_msgs/msg/CameraInfo
Customfoxglove.CameraCalibration

ImageAnnotation

frameworkschema
ROS 1visualization_msgs/ImageMarker
ROS 2visualization_msgs/msg/ImageMarker

ImageAnnotations

frameworkschema
ROS 1foxglove_msgs/ImageMarkerArray
Customfoxglove.ImageAnnotations

Additional resources