Documentation
About FAQ Projects GitHub Troubleshoot EV3 Manager Bluetooth Forum LEGO Support FIRST LEGO League
Reference
show string show number show value show mood show image clear screen show ports on event is pressed was pressed pause until set light battery level
run stop reset set brake set inverted set regulated tank steer angle speed clear counts stop all motors
Sensors
on event pause until is pressed was pressed
angle rate reset
on event distance pause until
Infrared
on event distance pause until
on event pause until is pressed was pressed set remote channel
on color detected pause until color detected on light detected pause until light condition detected color light
play sound effect play sound effect until done play tone ring tone stop all sounds rest change tempo by set tempo note frequency beat set volume
seconds millis reset pause until
log log value send to screen
Blocks
On Start
repeat for while for of
if Boolean
assign change var var
Math JavaScript blocks Custom blocks
Python
Calling Sequencing Variables Operators Statements Functions Classes
JavaScript
Calling Sequencing Variables Operators Statements Functions Types Classes Interfaces Generics
Types
Number String Boolean Array Function
Developers
Command Line Interface Visual Studio Code support Blocks Embed
Getting Started
Try Use
Tutorials
Wake Up! Make An Animation What Animal Am I? Music Brick Run Motors Tank ZigZag Touch to Run Touch Sensor Values What Color? Line Following Red Light, Green Light Reflected Light Measure Reflected Light Calibration Object Near? Security Alert
Coding
Autonomous Parking Object Detection Line Detection
Design Engineering
Make It Move Without Wheels Make It Smarter and Faster Make a System that Communicates
Maker
Make a Sound Machine Make a Security Gadget
Documentation
About FAQ Projects GitHub Troubleshoot EV3 Manager Bluetooth Forum LEGO Support FIRST LEGO League
Reference
show string show number show value show mood show image clear screen show ports on event is pressed was pressed pause until set light battery level
run stop reset set brake set inverted set regulated tank steer angle speed clear counts stop all motors
Sensors
on event pause until is pressed was pressed
angle rate reset
on event distance pause until
Infrared
on event distance pause until
on event pause until is pressed was pressed set remote channel
on color detected pause until color detected on light detected pause until light condition detected color light
play sound effect play sound effect until done play tone ring tone stop all sounds rest change tempo by set tempo note frequency beat set volume
seconds millis reset pause until
log log value send to screen
Blocks
On Start
repeat for while for of
if Boolean
assign change var var
Math JavaScript blocks Custom blocks
Python
Calling Sequencing Variables Operators Statements Functions Classes
JavaScript
Calling Sequencing Variables Operators Statements Functions Types Classes Interfaces Generics
Types
Number String Boolean Array Function
Developers
Command Line Interface Visual Studio Code support Blocks Embed
Getting Started
Try Use
Tutorials
Wake Up! Make An Animation What Animal Am I? Music Brick Run Motors Tank ZigZag Touch to Run Touch Sensor Values What Color? Line Following Red Light, Green Light Reflected Light Measure Reflected Light Calibration Object Near? Security Alert
Coding
Autonomous Parking Object Detection Line Detection
Design Engineering
Make It Move Without Wheels Make It Smarter and Faster Make a System that Communicates
Maker
Make a Sound Machine Make a Security Gadget

proximity

Get the promixity of an object measured by the infrared sensor.

sensors.infrared1.proximity();

The proximity value returned is a number between 0 and 100 which is a relative measurment of distance to an object. A value of 0 means something is very close and 100 means something is far away. The proximity is determined by the amount of infrared light reflected back by an object. The proximity value for an object that has a lighter color and smooth surface will be less than an object at the same distance with a darker color and a rough surface.

Proximity isn’t an actual measurement units of distance, like in centimeters or meters, but it gives you an idea whether something is close or not so close.

Returns

  • a number that is 0 for (very near) to 100 (far). The value is relative to the range of the infrared sensor.

Example

When the infrared sensor on port 4 detects a near object, display its proximity value on the screen.

sensors.infrared4.onEvent(InfraredSensorEvent.ObjectNear, function () {
    brick.clearScreen()
    brick.showValue("proximity", sensors.infrared4.proximity(), 1)
})

See also

on event, pause until

Edit this page on GitHub
Edit template of this page on GitHub
Edit template of this page on GitHub