3DiVi Face SDK
3.24.0
|
def face_sdk.modules.video_worker.SearchResult.__init__ | ( | self, | |
person_id | |||
) |
Уникальный идентификатор человека.
Уникальный идентификатор элемента.
Результат сравнения шаблонов.
def face_sdk.modules.video_worker.TrackingCallbackData.__init__ | ( | self | ) |
Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count).
Целочисленный идентификатор кадра (который был возвращен методом VideoWorker.add_video_frame).
Вектор лиц, найденных трекером. Большинство сэмплов будут получены с кадра frame_id, но некоторые могут быть получены с предыдущих кадров. Используйте метод RawSample.get_frame_id, чтобы определить, к какому кадру относится сэмпл.
Вектор идентификаторов лиц (track_id). track_id равен sample.get_id() для сэмпла в любом VideoWorker коллбэке. (samples_track_id.size() == samples.size())
Так как это трекинг, то некоторые сэмплы могут быть ошибочными, поэтому мы помечаем сэмплы флагом "weak", если они не прошли повторную проверку фронтальным детектором лиц. "weak" сэмплы не используются для распознавания (samples_weak.size() == samples.size())
Качество сэмпла. Точно такое же, как и у FaceQualityEstimator (samples_quality.size() == samples.size())
Результат проверки сэмпла на хорошие условия освещения и отсутствие сильного размытия (samples_good_light_and_blur.size() == samples.size())
Результат проверки сэмпла на отсутствие слишком больших углов поворота лица (samples_good_angles.size() == samples.size())
Результат проверки сэмпла на приемлемый размер лица, см. параметр min_template_generation_face_size в конфигурационном файле. len(samples_good_face_size) == len(samples)
Результат проверки сэмпла фронтальным детектором лиц len(samples_detector_confirmed) == len(samples.size()
Результат проверки сэмпла посредством DepthLivenessEstimator, требуются кадры глубины, см. VideoWorker.addDepthFrame. См. также face_sdk_3divi.modules.depth_liveness_estimator.Liveness. len(samples_depth_liveness_confirmed) == len(samples)
Результат проверки сэмпла посредством IRLivenessEstimator, требуются кадры глубины, см. VideoWorker.addIRFrame. См. также face_sdk_3divi.modules.ir_liveness_estimator.Liveness. len(samples_ir_liveness_confirmed) == samples.size)
Флаг, обозначающий, что пол и возраст определены для этого трека. len(samples_track_age_gender_set) == len(samples)
Оценки пола и возраста для этого трека. len(samples_track_age_gender) == len(samples)
Флаг, обозначающий, что эмоции определены для этого трека. len(samples_track_emotions_set) == len(samples)
Оценка эмоций для этого трека. len(samples_track_emotions) == len(samples)
Состояние проверки лица на принадлежность живому человеку посредством сценария. См. также ActiveLiveness::ActiveLivenessStatus. (samples_active_liveness_status.size() == samples.size())
def face_sdk.modules.video_worker.TemplateCreatedCallbackData.__init__ | ( | self, | |
stream_id | |||
) |
Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count).
Целочисленный идентификатор кадра (который был возвращен методом VideoWorker.add_video_frame).
Качество сэмпла. Точно такое же, как и у FaceQualityEstimator.
Сэмпл лица.
Шаблон, созданный из sample.
def face_sdk.modules.video_worker.MatchFoundCallbackData.__init__ | ( | self, | |
stream_id | |||
) |
Найденные элементы с расстоянием меньше distance_threshold (но не более k ближайших элементов; величина k установлена в конфигурационном файле под тегом search_k).
При вызове после N последовательных несовпадений первый элемент в search_results будет иметь нулевое расстояние, а person_id и element_id равны face_sdk_3divi.modules.video_worker.MATCH_NOT_FOUND_ID.
def face_sdk.modules.video_worker.TrackingLostCallbackData.__init__ | ( | self | ) |
Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count).
Целочисленный идентификатор кадра, на котором лицо было замечено впервые.
Целочисленный идентификатор кадра, после которого трекинг лица был потерян.
Лучшее качество среди всех кадров.
Целочисленный идентификатор кадра с наилучшим качеством.
Идентификатор потерянного лица (track_id). track_id равен sample.get_id() для сэмпла в любом VideoWorker коллбэке.
Лучший сэмпл лица с кадра best_quality_frame_id. Будет равен NULL, если включен флаг "weak_tracks_in_tracking_callback" и все сэмплы с данным track_id помечены флагом "weak=true".
Шаблон, созданный из best_quality_sample. Будет равен NULL при нулевом количестве потоков обработки или best_quality_sample, равном NULL.
Флаг, означающий, что sti_person_id определен. Значение sti_person_id не определено, если кратковременная идентификация отключена, либо если для данного трека не было сгенерировано ни одного шаблона.
Идентификатор "sti_person" - набора треков, объединенных кратковременной идентификацией. Значение sti_person_id совпадает с track_id первого элемента, сформировавшего этот набор "sti_person".
def face_sdk.modules.video_worker.StiPersonOutdatedCallbackData.__init__ | ( | self, | |
stream_id, | |||
sti_person_id | |||
) |
Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count).
Идентификатор "sti_person" - набора треков, объединенных кратковременной идентификацией. Значение sti_person_id совпадает с track_id первого элемента, сформировавшего этот набор "sti_person".
def face_sdk.modules.video_worker.DatabaseElement.__init__ | ( | self, | |
element_id | |||
) |
Уникальный идентификатор элемента.
Уникальный идентификатор человека.
Шаблон лица.
Порог распознавания.
Установка разных порогов распознавания для разных людей может быть полезной в некоторых случаях. Например, в том случае, если определенный преступник из черного списка опаснее остальных, и вы хотите увеличить вероятность его распознавания, несмотря на увеличение вероятности ложного распознавания.
def face_sdk.modules.video_worker.Params.__init__ | ( | self | ) |
Задать конфигурационный файл VideoWorker с опционально переопределенными параметрами.
Задать имя конфигурационного файла для используемого распознавателя (Recognizer).
Задать конфигурационный файл Recognizer с опционально переопределенными параметрами (Recognizer).
Задать количество видеопотоков.
Задать количество потоков для создания шаблонов.
Задать количество потоков для сравнения шаблонов, созданных из видеопотоков, с базой.
Задать количество потоков для определения пола и возраста.
Задать количество потоков для определения эмоций.
Задать флаг, включающий кратковременную идентификацию.
Задать порог распознавания для кратковременной идентификации.
Задать в секундах длину временного интервала для кратковременной идентификации.
Задать в секундах длину временного интервала для кратковременной идентификации.
Конструктор по умолчанию, устанавливает строки пустыми, числа нулем, флаги выключены.
def face_sdk.modules.video_worker.VideoWorker.add_depth_frame | ( | self, | |
depth_frame | |||
) |
Подать кадр определенного видеопотока c данными глубины.
Потокобезопасный.
[in] | depth_frame | Кадр глубины (DepthMapRaw). |
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
[in] | timestamp_microsec | Временная метка кадра в микросекундах |
def face_sdk.modules.video_worker.VideoWorker.add_ir_frame | ( | self, | |
ir_frame | |||
) |
Подать кадр определенного видеопотока c инфракрасными данными.
Потокобезопасный.
[in] | ir_frame | Инфракрасный кадр (IRFrameRaw). |
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
[in] | timestamp_microsec | Временная метка кадра в микросекундах |
def face_sdk.modules.video_worker.VideoWorker.add_match_found_callback_ext | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события распознавания (MatchFound).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_match_found_callback_u | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события распознавания (MatchFound).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_sti_person_outdated_callback_u | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события распознавания (MatchFound).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_template_created_callback_u | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события создания шаблона (TemplateCreated).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_tracking_callback_u | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события трекинга (Tracking).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_tracking_lost_callback_u | ( | self, | |
callback, | |||
userdata, | |||
int | |||
) |
Добавить обработчик события распознавания (MatchFound).
Потокобезопасный.
[in] | callback | Функция коллбэка. |
[in] | userdata | Любой указатель. При вызове коллбэка он будет передан через аргумент userdata. |
def face_sdk.modules.video_worker.VideoWorker.add_video_frame | ( | self, | |
frame | |||
) |
Подать новый кадр определенного видеопотока.
Результаты трекинга и распознавания будут возвращаться асинхронно в коллбэках Tracking, MatchFound и TrackingLost. Потокобезопасный.
[in] | frame | Изображение кадра. Допустимы только цветные изображения (т.е. face_sdk_3divi.modules.raw_image.Format.FORMAT_RGB, face_sdk_3divi.modules.raw_image.Format.FORMAT_BGR, face_sdk_3divi.modules.raw_image.Format.FORMAT_YUV_NV21 и face_sdk_3divi.modules.raw_image.Format.FORMAT_YUV_NV12). |
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
[in] | timestamp_microsec | Временная метка кадра в микросекундах |
def face_sdk.modules.video_worker.VideoWorker.check_exception | ( | self | ) |
Исключения, выброшенные в коллбэках и внутренних потоках, будут выброшены повторно при вызове данного метода.
Потокобезопасный.
def face_sdk.modules.video_worker.VideoWorker.disable_age_gender_estimation_on_stream | ( | self, | |
stream_id | |||
) |
Отключить определение пола и возраста для данного потока.
Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.disable_emotions_estimation_on_stream | ( | self, | |
stream_id | |||
) |
Отключить определение эмоций для данного потока.
Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.disable_processing_on_stream | ( | self, | |
stream_id | |||
) |
Отключить генерацию шаблонов для данного потока.
Соответственно, сравнения также остановятся. Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.enable_age_gender_estimation_on_stream | ( | self, | |
stream_id | |||
) |
Включить определение пола и возраста для данного потока.
Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.enable_emotions_estimation_on_stream | ( | self, | |
stream_id | |||
) |
Включить определение эмоций для данного потока.
Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.enable_processing_on_stream | ( | self, | |
stream_id | |||
) |
Включить генерацию шаблонов для данного потока.
Соответственно, сравнения также возобновятся. Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.get_method_name | ( | self, | |
str | |||
) |
Получить имя метода используемого распознавателя.
Потокобезопасный.
def face_sdk.modules.video_worker.VideoWorker.get_streams_count | ( | self | ) |
Получить количество видеопотоков.
Потокобезопасный.
def face_sdk.modules.video_worker.VideoWorker.get_tracking_conveyor_size | ( | self, | |
stream_id | |||
) |
Получить размер N конвейера трекинга.
Tracking коллбэк будет вызван с frame_id = X не раньше, чем VideoWorker.add_video_frame вернет значение X + N - 1, где N - значение, которое вернул VideoWorker.get_tracking_conveyor_size. Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.remove_match_found_callback | ( | self, | |
callback_id | |||
) |
Удалить обработчик события создания шаблона (MatchFound).
Потокобезопасный.
[in] | callback_id | Идентификатор коллбэка, полученный от VideoWorker.add_match_found_callback. |
def face_sdk.modules.video_worker.VideoWorker.remove_sti_person_outdated_callback | ( | self, | |
callback_id | |||
) |
Удалить обработчик события создания шаблона (StiPersonOutdated).
Потокобезопасный.
[in] | callback_id | Идентификатор коллбэка, полученный от VideoWorker.add_sti_person_outdated_callback. |
def face_sdk.modules.video_worker.VideoWorker.remove_template_created_callback | ( | self, | |
callback_id | |||
) |
Удалить обработчик события создания шаблона (TemplateCreated).
Потокобезопасный.
[in] | callback_id | Идентификатор коллбэка, полученный от VideoWorker.add_template_created_callback. |
def face_sdk.modules.video_worker.VideoWorker.remove_tracking_callback | ( | self, | |
callback_id | |||
) |
Удалить обработчик события создания шаблона (Tracking).
Потокобезопасный.
[in] | callback_id | Идентификатор коллбэка, полученный от VideoWorker.add_tracking_callback. |
def face_sdk.modules.video_worker.VideoWorker.remove_tracking_lost_callback | ( | self, | |
callback_id | |||
) |
Удалить обработчик события создания шаблона (TrackingLost).
Потокобезопасный.
[in] | callback_id | Идентификатор коллбэка, полученный от VideoWorker.add_tracking_lost_callback. |
def face_sdk.modules.video_worker.VideoWorker.reset_stream | ( | self, | |
stream_id | |||
) |
Сбросить состояние работы для указанного видеопотока.
В процессе происходит ожидание выполняющихся в данный момент коллбэков, поэтому не синхронизируйте вызов resetStream с кодом внутри коллбэков, иначе возможен deadlock. После возврата управления от resetStream не будет вызвано ни одного коллбэка, относящегося к предыдущим кадрам или трекам. Необходимо освободить память, выделенную для треков, track_id которых меньше возвращенного значения, так как для треков, удаленных в процессе этого сброса, TrackingLost коллбэк вызван не будет. Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.reset_tracker_on_stream | ( | self, | |
stream_id | |||
) |
Сбросить состояние трекера для указанного видеопотока.
Потокобезопасный.
[in] | stream_id | Целочисленный идентификатор видеопотока (0 <= stream_id < streams_count). |
def face_sdk.modules.video_worker.VideoWorker.set_database | ( | self, | |
elements | |||
) |
Задать / заменить базу (можно вызывать в любое время).
Доступно только при ненулевом количестве потоков сравнения (matching_threads_count). Потокобезопасный.
[in] | elements | Вектор элементов базы. |
[in] | acceleration | Тип ускорения поиска. |
def face_sdk.modules.video_worker.VideoWorker.set_parameter | ( | self, | |
parameter | |||
) |
Изменить значение параметра в runtime.
[in] | parameter | Имя параметра (имя тэга из .xml конфигурационного файла). |
[in] | value | Новое значение параметра. |