Usage

Viewing a single image topic

image_view image:=<image topic> [image transport type]

For example, to view raw images on the topic /camera/image, use:

image_view image:=/camera/image

You may save the current image by left-clicking on the display window. By default, images will be saved as frame0000.jpg, frame0001.jpg, .... }}}

If you want to view a compressed image stream (usually a good idea over wireless!) using the capabilities of image_transport, specify the transport type as a command-line argument. For example, if theora_image_transport is built on the publisher's side, you can use theora transport:

image_view image:=/camera/image theora

Note that this is merely shorthand equivalent to setting the ~image_transport parameter:

image_view image:=/camera/image _image_transport:=theora

Viewing stereo images

stereo_view stereo:=<stereo namespace> image:=<image topic identifier>

For example, to view stereo image pairs on topics /my_stereo_cam/left/image_rect_color and /my_stereo_cam/right/image_rect_color, use:

stereo_view stereo:=/my_stereo_cam image:=image_rect_color

stereo_view also shows the disparity image computed from the stereo pair, color-mapped for clarity.

You may save the current image pair by left-clicking on either display window. By default, images will be saved as left0000.jpg, right0000.jpg, left0001.jpg, right0001.jpg....

Nodes

image_view

Simple image viewer for ROS topics.

Subscribed Topics

image (sensor_msgs/Image)
  • The image topic. Should be remapped to the name of the real image topic.

Parameters

~autosize (bool, default: false)
  • Whether the window should autosize itself to the image or be resizeable by the user.
~filename_format (string, default: "frame%04i.jpg")
  • printf-style format for saved image names. Use to control name, location and format of saved images.
~image_transport (string, default: "raw")
  • Transport used for the image stream. image_view allows you to specify this as a simple command-line argument for convenience.
~window_name (string, default: name of the image topic)
  • The name of the display window.

stereo_view

Viewer for stereo images. Shows the left/right image pair and the disparity image (color-mapped) computed from them.

Subscribed Topics

<stereo>/left/<image> (sensor_msgs/Image)
  • The left image topic. Formal parameters stereo and image should be remapped appropriately.
<stereo>/right/<image> (sensor_msgs/Image)
  • The right image topic. Formal parameters stereo and image should be remapped appropriately.
<stereo>/disparity (stereo_msgs/DisparityImage)
  • The disparity image computed from the left/right stereo pair.

Parameters

~autosize (bool, default: true)
  • Whether the windows should autosize to the image or be resizeable by the user.
~filename_format (string, default: "%s%04i.jpg")
  • printf-style format for saved image names. Use to control name, location and format of saved images. The string argument is "left" or "right".
~image_transport (string, default: "raw")
  • Transport used for the image streams.

Wiki: image_view/cturtle (last edited 2011-02-03 23:54:36 by PatrickMihelich)