On this page

IlluminanceSubscriber QML Type

Subscribes to 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:

SubscriberBase

Status: Experimental Extension

Properties

Signals

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.

IlluminanceSubscriber receives illuminance values from a ROS 2 topic. Set the topic and node properties, then connect to the messageReceived() signal.

See also IlluminancePublisher and illuminance.

Property Documentation

header : header

The header field of the last received message. Updated whenever a new message arrives. headerChanged is emitted on every update.

illuminance : double

The illuminance field of the last received message. Updated whenever a new message arrives. illuminanceChanged is emitted on every update.

message : illuminance

The last message received on topic. Updated whenever a new message arrives.

variance : double

The variance field of the last received message. Updated whenever a new message arrives. varianceChanged is emitted on every update.

Signal Documentation

messageReceived(illuminance msg)

Emitted when a new illuminance arrives on topic. msg contains the received value.

Note: The corresponding handler is onMessageReceived.

© 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.