Skip to content

Release Notes#

Version v.4.1.9#

  • The log messages concerning the passage of AGS and head angles (pitch, yaw, roll) thresholds were updated.

    Previously, the messages looked as follows:

    W0202 19:42:41.390820 334559 Filtrator.cpp:207] [angles] Track [2] Angles threshold not passed W0202 19:42:41.408515 334559 Filtrator.cpp:310] [ags] Track [1] Low ags score.

    Now the messages display detailed information about the values of AGS and head angles:

    W0204 17:34:17.581794 408736 Filtrator.cpp:207] [angles] Track [2] Angles threshold not passed. Angles: [pitch:43.1522, roll:-6.2322, yaw:4.7375]. W0204 17:34:17.600826 408736 Filtrator.cpp:313] [ags] Track [1] Low ags score: 0.407889.

  • Information about the specific number of the bestshot from the track that will be sent was added to the logs:

    W0204 17:34:17.915912 408933 RequestBuilderProxy.cpp:73] [bestshot] Track [1]. Bestshot [2] will be sent.

    Information about the bestshot number is displayed in the "bestshot_send_number" field in the JSON being sent (relevant when the "json" value is set for the "request-type" parameter in the FaceStream settings).

Version 4.1.7#

  • Updated the version of the Liveness FlyingFaces function, which is used when the "use_flying_faces_liveness_filtration" parameter is enabled.

Version 4.1.6#

  • Updated the version of the Liveness FlyingFaces function, which is used when the "use_flying_faces_liveness_filtration" parameter is enabled.

  • In the "primary_track_policy" mode, added timestamps for the "best_shot_min_size" and "best_shot_proper_size" parameters. Now, when the minimum threshold for starting detection processing and the required threshold for sending detection is reached, the time will be recorded, which is displayed in the sent json by the "timestamp_best_shot_min_size" and "timestamp_best_shot_proper_size" fields, respectively.

Version 4.1.4#

  • Starting from this version, the server time will be sent with the bestshot. Previously, the device time was sent. This feature applies to all types of sources (video files, a set of images and video streams).

Version 4.1.3#

  • An error with increasing memory consumption when the preview is enabled in the FS in server mode was fixed.

Version 4.1.2#

  • The problems with removing video streams using the FS API were fixed.

  • GPU optimization was performed. The number of skipped frames when working with 35 video streams in FullHD was decreased from 6% to 3%.

  • FS version is now logged at startup.

  • The possibility to receive the last frame from a video stream in JPEG format was added to the FS API. The "/streams/preview/frame/{id}" resource is used for this purpose.

  • The problem with reading of the boolean values from the Configurator service was fixed. The values were converted to integer values in the Configurator service, and FS could not use them.

Version 4.1.1#

  • Tracker error was fixed. If most of the tracked area of at least one of the tracks was outside the frame at some point, the track did not end, and the processing of this video stream continued with errors.

Version 4.1.0#

  • API version 6 support was added for sending data from FaceStream to LUNA PLATFORM 5.

    The description of sending data to the LUNA PLATFORM was updated in the section "Image Sending to LUNA PLATFORM". This section lists the FaceStream parameters for sending images:

    • directly to LUNA PLATFORM 5,

    • to Backport 3 (implements support for LUNA PLATFORM 3 API requests in LUNA PLATFORM 5),

    • to Backport 4 (implements support for LUNA PLATFORM 4 API requests in LUNA PLATFORM 5).

  • Changes to input.json:

    • The "luna_account_id" parameter was moved to input.json and now available per video stream.

    • The "image_store_url" parameter was added. It enables to set the URL for the Image Store service to send the source frame to LUNA PLATFORM.

    It is required to enable the "Send-source-frame" parameter to send the source frame.

    The bucket for saving the source frame should be created in advance in the Image Store.

  • Changes to fs3config.conf:

    • The "jpeg-quality-level" setting was added.  It enables you to set the quality of the original image when it is sent to the LUNA PLATFORM. By default, the image compression is not performed, which may affect the processing speed.

    • The list of tags for logging information was expanded. See the "Tags" section. The following tags were added:

      • common - general information;

      • client - information about sending messages to LUNA PLATFORM and the responses received;

      • json - information about processing parameters from configuration files and the Configurator service;

      • http_api - information about API requests sent to FaceStream in server mode and received responses;

      • image - information about frames processing;

      • gstreamer - information about GStream library operation;

      • debug - debug information. It is recommended to use this tag when debugging only and not during FS operation. It provides a large amount of debugging information.

      Logs text includes the corresponding tag. It can be used for logs filtration.

  • Adding a new video stream (POST "/streams") is now performed asynchronously in server mode. The response to the request is returned immediately, without waiting for the stream to be created.

  • The FaceStream performance when using GPU was significantly improved.

  • The stability of FaceStream when using CPU and GPU was improved.

  • CPU load was signigicantly reduced when using the GPU.

  • The description in the "Liveness" section was extended. The requirements for the camera location, recommendations for FaceStream settings, and answers to frequently asked questions were added.

  • The "stream-images-buffer-max-size" parameter default value was set to 40 for maximum FaceStream performance. It is important to note that this leads to a significant increase in memory consumption.

Version 4.0.0#

  • CPU memory leaks were fixed.
  • REST API bugs were fixed.
  • Logging was improved. The bug with logging severity in TrackEngine config was fixed. Added was a new severity level "debug".
  • New parameters were added in TrackEngine config. Removed the parameter "fragment-buffer-size". The parameter "frame-buffer-size" renamed to "frames-buffer-size".

  • Performance and memory consumption optimizations were performed. CPU utilization was improved.

  • The "Memory consumption when running FaceStream" section was added. It describes the reasons for increasing memory consumption when running FaceStream;

  • The "General recommendations for FaceStream configuration" section was added. This section lists the main configurable parameters, their impact on performance, and gives answers to other frequently asked questions.
  • The "Trackengine configuration" section was added. It contains the description of TrackEngine parameters.

  • The licensing system was updated:

    • The "License activation" section was added;

    • The Sentinel HASP utility was deleted from the distribution package;

  • The "Use FaceStream with Configurator" section was added. The section includes specified data about the interaction of FaceStream and the Configurator service;

  • The description for adding configurations in Configurator provided in the Docker container was added;

    • Examples of JSON files with FaceStream parameters were added to the distribution package:

      • luna_configurator_dump.json,

      • luna_configurator_dump_with_streams_example.json;

  • The section with information about formats, video compression standards, and protocols used by FaceStream was added;

  • The possibility of GPU processing was implemented. Now all the video stream processing can be performed using the GPU.

  • The new "statistics" tag to the "Tags" section was added. The tag displays information about performance, FPS, and missed frames;

  • The possibility to set the number of frames processed per second using the "real_time_mode_fps" parameter was added;
  • The "convert-full-frame" and "frame-processing-mode" parameters were added. They enable you to convert a decoded frame to an RGB image of the desired size, which improves the image quality;
  • The "aggregate-attr-requests" parameter was added. It enables aggregation when executing the "Generate events" request in LUNA PLATFORM 4;
  • The list of installed dependencies for FaceStream was updated;
  • The section about installing TBB was deleted. now you don't need to install the library separately;
  • The requirement for the "Name" field in input.json was added. It must be limited to 20 characters;
  • The "mouth-occlusion-threshold" parameter description was updated.
  • The "stream-images-buffer-max-size" parameter default value was set to 20.
Back to top