Proximity sensor properties

The proximity sensor properties are part of the scene object properties dialog, which is located at [Menu bar --> Tools --> Scene object properties]. You can also open the dialog with a double-click on an object icon in the scene hierarchy, or with a click on its toolbar button:

[Scene object properties toolbar button]


In the scene object properties dialog, click the Proximity sensor button to display the proximity sensor dialog (the Proximity sensor button only appears if the last selection is a proximity sensor). The dialog displays the settings and parameters of the last selected proximity sensor. If more than one proximity sensor is selected, then some parameters can be copied from the last selected proximity sensor to the other selected proximity sensors (Apply to selection-buttons):

[Proximity sensor dialog]


  • Enable all proximity sensors: enables or disables the proximity sensor functionality for all proximity sensors.
  • Explicit handling: indicates whether the sensor should be explicitely handled. If checked, the sensor will not be handled when simHandleProximitySensor(sim_handle_all_except_explicit) is called, but only if simHandleProximitySensor(sim_handle_all) or simHandleProximitySensor(proximitySensorHandle) is called. This is useful if the user wishes to handle the sensor in a child script rather than in the main script (if not checked the sensor will be handled twice, once when simHandleProximitySensor(sim_handle_all_except_explicit) is called in the main script, and once when simHandleProximitySensor(proximitySensorHandle) is called in the child script). Refer also to the section on explicit and non-explicit calls.
  • Sensor subtype: select the most suited sensor type for your application. Available types include: ultrasonic, infrared, laser, inductive and capacitive. This setting has no direct effect on how the proximity sensor will operate, it will simply discard some entities from detection that were not tagged as detectable by ultrasonic sensor or detectable by laser for instance. Entities can be individually tagged in the object common properties (check/uncheck any item in the Detectable properties-section).
  • Entity to detect: allows specifying what entity should be detected. Remember that only appropriately tagged detectable objects will be detected.
  • Show volume parameters: Toggles the proximity sensor volume dialog. That dialog allows to customize a proximity sensor's detection volume.
  • Show detection parameters: opens the proximity sensor detection parameter dialog. That dialog allows to customize various detection parameters.
  • Show volume when detecting: displays or hides the detection volume when the proximity sensor detects something.
  • Show volume when not detecting: displays or hides the detection volume when the proximity sensor doesn't detect anything.
  • Sensing point size: the size of the sensing point. This has no effect on calculations (the sensing point, even if displayed big, is always considered as a point).
  • Colors: allows adjusting the color of the various elements of a proximity sensor.

  • Recommended topics

  • Proximity sensors
  • Proximits sensor types and mode of operation
  • Detectable objects
  • Object common properties
  • Proximity sensor volume dialog
  • Proximity sensor detection parameter dialog