<<StackHeader(camera_info_manager_py)>>

<<TOC(4)>>

== Overview ==

This package contains no ROS nodes or utility commands. 

It provides a Python module for camera drivers to manage the [[image_pipeline/CameraInfo|camera calibration data]] required by the [[image_pipeline|ROS image pipeline]].

== Camera Names ==

The API includes a camera name, which is written when `CameraInfo` is saved and checked when data are loaded, with a warning logged if the name read does not match.

Camera driver authors should refer to the [[http://docs.ros.org/lunar/api/camera_info_manager_py/html/python/camera_info_manager.html#camera_info_manager.CameraInfoManager|CameraInfoManager class API documentation]] for syntax details and recommendations for assigning camera names. 

== URL Names ==

The location for getting and saving calibration data is expressed by Uniform Resource Locator (URL). These URLs are commonly used in the APIs of this package and may also contain substitution variables to refer to common locations. Please see the [[http://docs.ros.org/lunar/api/camera_info_manager_py/html/python/camera_info_manager.html#camera_info_manager.CameraInfoManager|CameraInfoManager class API documentation]] for supported URLs, file formats and substitution variables, which include `${ROS_HOME}` and the camera name, `${NAME}`.

== ROS API ==

=== CameraInfoManager ===

This Python class provides the following ROS interfaces when instantiated in a Python camera driver node:

==== Services ====

 * `set_camera_info` (<<SrvLink(sensor_msgs/SetCameraInfo)>>) for calibration information

<<Version(Groovy)>>: a driver can now handle more than one camera, using a different [[http://docs.ros.org/lunar/api/camera_info_manager_py/html/python/camera_info_manager.html#camera_info_manager.CameraInfoManager|namespace parameter]] with the !CameraInfoManager class instance of each device. 

==== Parameters ====

This package does not read ROS parameters directly. Where appropriate, we recommend that drivers provide a `~camera_info_url` parameter for the URL string passed to !CameraInfoManager.

== Python API ==

Open a link from `Code API` in the top-right corner of this web page.

## AUTOGENERATED DON'T DELETE
## CategoryStack