NAOqi PeoplePerception - Overview | API
Namespace : AL
#include <alproxies/alpeopleperceptionproxy.h>
Returns: | Maximum detection and tracking range in meters. The default value is 3.5 meters. |
---|
Returns: | Time after which a person disappears from the PeopleList. The default value is 10 seconds. See ALPeoplePerceptionProxy::setTimeBeforePersonDisappears() for a description of this parameter. |
---|
Returns: | Time after which a visible person disappears from the PeopleList. The default value is 2 seconds. See ALPeoplePerceptionProxy::setTimeBeforeVisiblePersonDisappears() for a description of this parameter. |
---|
Returns: | true if the module uses the face detection, false otherwise. |
---|
Returns: | true if the fast mode is enabled, false otherwise. |
---|
Returns: | true if the module currently pushes data to ALMemory for graphical display in Choregraphe, false otherwise. |
---|
Returns: | true if the module uses the movement detection, false otherwise. |
---|
Empties the current population and erases all data related to People Perception and associated modules from ALMemory.
Enables or disables the fast mode. When enabled, all optional detections (face and movement for example) are disabled. If this method is called with enable = false, all optional detections will be turned on.
Parameters: |
|
---|
Enables or disables the push of debug data into ALMemory. These data are used by Choregraphe to display spheres representing humans in the Robot View.
Parameters: |
|
---|
Sets the maximum detection and tracking range. Any person further away than this distance will not be tracked. Setting this range to a smaller value can help preventing the background noise from being detected as a human shape but will require humans to get closer to the robot in order to be successfully detected and tracked.
Parameters: |
|
---|
Enables or disables the movement detection to detect people. This can make the overall process slower if enabled.
Parameters: |
|
---|
Sets the time after which a person disappears from the PeopleList (see Events) if he/she is no more visible because the robot looks away. The robot knows that it moved and that the person cannot be seen anymore if he/she stays at the same position.
Parameters: |
|
---|
Sets the time after which a person disappears from the PeopleList (see Events) if he/she is no more visible because he/she moved or is hidden from the camera. In this case the robot didn’t move but doesn’t see the person anymore.
Parameters: |
|
---|
Deprecated since version 1.22: The face detection is always enabled.
Raised when a new person is detected and added to the population.
Parameters: |
|
---|
Raised when a person is removed from the population.
Parameters: |
|
---|
Raised whenever at least one person is visible by the robot. Contains information about the detected people, it is used by ALTracker to track people.
It is organized as follows:
MovementInfo =
[
[TimeStamp_Seconds, TimeStamp_Microseconds],
[PersonData_1, PersonData_2, ... PersonData_n],
CameraPose_InTorsoFrame,
CameraPose_InRobotFrame,
Camera_Id
]
TimeStamp: this field is the time stamp of the image that was used to perform the detection.
PersonData_i: each of these fields contains the description of a person. It has the following structure:
PersonData_i =
[
Id,
DistanceToCamera,
PitchAngleInImage,
YawAngleInImage
]
where PitchAngleInImage and YawAngleInImage are angular coordinates of the person’s head in the image, in radians.
CameraPose_InTorsoFrame: describes the Position6D of the camera at the time the image was taken, in FRAME_TORSO.
CameraPose_InRobotFrame: describes the Position6D of the camera at the time the image was taken, in FRAME_ROBOT.
Camera_Id: gives the Id of the camera used for the detection.
Raised every time the population data has been updated.
Raised every time the list of persons in the current population changes. The associated data is a list of people IDs (integers) in the current population. These IDs are used to search ALMemory for each person’s attributes. PeopleList is the union of NonVisiblePeopleList and VisiblePeopleList.
For further details, see: PeoplePerception/NonVisiblePeopleList() and PeoplePerception/VisiblePeopleList() .
Raised every time the list of people who are currently not visible by the robot (the IsVisible attribute equals 0) changes. This list is a subset of the PeopleList.
Raised every time the list of people who are currently visible by the robot (the IsVisible attribute equals 1) changes. This list is a subset of the PeopleList.
Raised when the value of the maximum detection range has been modified.
Yaw and Pitch angles (in radians) of the top of the shape of a person relative to the robot’s torso.
Distance (in meters) between the person and the camera.
Says whether the face of the person is detected or not. This key may not be present in memory if the face detection has never been performed on a specific person.
Time elapsed (in seconds) since the last time this person was detected.
3D head position of the person in the FRAME_ROBOT space.
3D head position of the person in the FRAME_TORSO space.
3D head position of the person in the FRAME_WORLD space.
Time elapsed (in seconds) since the first time this person was detected.
Estimated height of a person in meters. It is computed as the maximum detected height over time.
The primary color of clothing of the person. It can be either “Black”, “Gray”, “White”, “Red”, “Orange”, “Yellow”, “Green”, “Blue” or “Purple”.
The H, S and V components of the primary color of clothing of the person in the HSV Colorspace.