On this page

IlluminancePublisher QML Type

Publishes sensor_msgs::msg::Illuminance messages — Single photometric illuminance measurement. Light should be assumed to be measured along the sensor's x-axis (the area of detection is the y-z plane). More...

Import Statement: import QtRos2.SensorMsgs
Inherits:

PublisherBase

Status: Experimental Extension

Properties

Methods

Detailed Description

The illuminance should have a 0 or positive value and be received with the sensor's +X axis pointing toward the light source.

Photometric illuminance is the measure of the human eye's sensitivity of the intensity of light encountering or passing through a surface.

All other Photometric and Radiometric measurements should not use this message. This message cannot represent:

  • Luminous intensity (candela/light source output)
  • Luminance (nits/light output per area)
  • Irradiance (watt/area), etc.

IlluminancePublisher publishes illuminance values to a ROS 2 topic. Set the topic and node properties, then call publish() to send messages.

See also IlluminanceSubscriber and illuminance.

Property Documentation

header : header

The header field value included in the next publish. Setting this property emits headerChanged and, when autoPublish is true, requests a publish at the end of the current event-loop iteration.

illuminance : double

The illuminance field value included in the next publish. Setting this property emits illuminanceChanged and, when autoPublish is true, requests a publish at the end of the current event-loop iteration.

variance : double

The variance field value included in the next publish. Setting this property emits varianceChanged and, when autoPublish is true, requests a publish at the end of the current event-loop iteration.

Method Documentation

void publish(illuminance msg)

Publishes illuminance msg to the ROS 2 topic set by the topic property. Does nothing if the publisher is not connected.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.