|
| 1 | +# v0.30.alpha Release Notes |
| 2 | +## Highlights |
| 3 | +* New GStreamer (GST) API used to created Custom DSL Pipeline Components. See [#1174](https://github.com/prominenceai/deepstream-services-library/issues/1174). |
| 4 | +* Pipeline Components can now be linked together by one of two methods. See [#1176](https://github.com/prominenceai/deepstream-services-library/issues/1176) and [#1212](https://github.com/prominenceai/deepstream-services-library/issues/1212). |
| 5 | + * By-position - allows Pipelines to be assemebled over subsequent calls - the default link method in all previous releases. |
| 6 | + * By-add-order - allows full user control over the order of linking - new and now default method of linking. |
| 7 | +* New ODE Actions: |
| 8 | + * Snap-Label-To-Grid Action. See [#1191](https://github.com/prominenceai/deepstream-services-library/issues/1191). |
| 9 | + * Connect-Label-To-BBox Action. See [#1192](https://github.com/prominenceai/deepstream-services-library/issues/1191). |
| 10 | +* New Examples and Overview Section on "Working with Buffer-Surfaces and OpenCV". See [#1209](https://github.com/prominenceai/deepstream-services-library/issues/1209) |
| 11 | +* A number of critical bugs have been resolved, see the list below. |
| 12 | + |
| 13 | +## Issues closed in this release |
| 14 | +### Bugs closed in this release |
| 15 | +* RTSP Source API Reference - constructor section is missing the drop_frame_interval [#1175](https://github.com/prominenceai/deepstream-services-library/issues/1175) |
| 16 | +* Remove input queue from branch - unnecessary, as first component will have its own input queue. [#1180](https://github.com/prominenceai/deepstream-services-library/issues/1180) |
| 17 | +* dsl_ode_action_label_offset_new is missing from dsl.py [#1188](https://github.com/prominenceai/deepstream-services-library/issues/1188) |
| 18 | +* Pipeline with Secondary Inference components and a Message Sink fail to fully transition to a playing state [#1202](https://github.com/prominenceai/deepstream-services-library/issues/1202) |
| 19 | +* WebRTC Sink Inatallation Instructions missing dependencies for DS 6.4/7.0 GST 1.20 [#1217](https://github.com/prominenceai/deepstream-services-library/issues/1217) |
| 20 | +* V4L2 Source is failing to play when running on dGPU - currently using wrong plugin [#1219](https://github.com/prominenceai/deepstream-services-library/issues/1219) |
| 21 | + |
| 22 | +### Enhancements closed in this release |
| 23 | +* Implement new GStreamer Element and Bin APIs - allow clients to create custom DSL Pipeline Components [#1174](https://github.com/prominenceai/deepstream-services-library/issues/1174) |
| 24 | +* Extend Pipelines/Branches to be able to link components by both position and by add-order. [#1176](https://github.com/prominenceai/deepstream-services-library/issues/1176) |
| 25 | +* Update Triton Inference Service examples to use new traficcamnet models. [#1184](https://github.com/prominenceai/deepstream-services-library/issues/1176) |
| 26 | +* Tracking algorithm for all Triggers is incorrect/insufficient for how the Tracker libs actually work. [#1186](https://github.com/prominenceai/deepstream-services-library/issues/1176) |
| 27 | +* Implement new snap-label-to-grid ODE Action - dsl_ode_action_label_snap_to_grid_new [#1191](https://github.com/prominenceai/deepstream-services-library/issues/1191) |
| 28 | +* Implement new connect-label-bbox ODE Action - dsl_ode_action_label_connect_to_bbox_new [#1192](https://github.com/prominenceai/deepstream-services-library/issues/1191) |
| 29 | +* ODE Actions need to include classifier meta labels when printing, logging, filing, and messaging object data. [#1195](https://github.com/prominenceai/deepstream-services-library/issues/1195) |
| 30 | +* Implement dsl_sink_message_payload_debug_dir_get/set services to dump Message Converter payloads. [#1199](https://github.com/prominenceai/deepstream-services-library/issues/1199) |
| 31 | +* Remove unnecessary tee and fake sink from the IoT Message Sink Component. [#1203](https://github.com/prominenceai/deepstream-services-library/issues/1203) |
| 32 | +* Make message-converter-config-file optional for IoT Message Sink [#1204](https://github.com/prominenceai/deepstream-services-library/issues/1204) |
| 33 | +* Add examples and overview to cover how to work with opencv in an Custom Pad Probe Handler [#1209](https://github.com/prominenceai/deepstream-services-library/issues/1209) |
| 34 | +* Set DSL_PIPELINE_LINK_METHOD_DEFAULT to DSL_PIPELINE_LINK_METHOD_BY_ADD_ORDER [#1212](https://github.com/prominenceai/deepstream-services-library/issues/1212) |
| 35 | +* Update conditional WebRTC Sink build inclussion - make boolean vs tied to gstreamer version [#1216](https://github.com/prominenceai/deepstream-services-library/issues/1216) |
| 36 | + |
| 37 | +### New Symbolic Constants in this release |
| 38 | +**New GStreamer (GST) Element API Return Values** |
| 39 | +```c |
| 40 | +#define DSL_RESULT_GST_ELEMENT_RESULT 0x00D00000 |
| 41 | +#define DSL_RESULT_GST_ELEMENT_NAME_NOT_UNIQUE 0x00D00001 |
| 42 | +#define DSL_RESULT_GST_ELEMENT_NAME_NOT_FOUND 0x00D00002 |
| 43 | +#define DSL_RESULT_GST_ELEMENT_THREW_EXCEPTION 0x00D00003 |
| 44 | +#define DSL_RESULT_GST_ELEMENT_IN_USE 0x00D00004 |
| 45 | +#define DSL_RESULT_GST_ELEMENT_SET_FAILED 0x00D00005 |
| 46 | +#define DSL_RESULT_GST_ELEMENT_HANDLER_ADD_FAILED 0x00D00006 |
| 47 | +#define DSL_RESULT_GST_ELEMENT_HANDLER_REMOVE_FAILED 0x00D00007 |
| 48 | +#define DSL_RESULT_GST_ELEMENT_PAD_TYPE_INVALID 0x00D00008 |
| 49 | +``` |
| 50 | +**New GStreamer (GST) Bin API Return Values** |
| 51 | +```c |
| 52 | +#define DSL_RESULT_GST_BIN_RESULT 0x00E00000 |
| 53 | +#define DSL_RESULT_GST_BIN_NAME_NOT_UNIQUE 0x00E00001 |
| 54 | +#define DSL_RESULT_GST_BIN_NAME_NOT_FOUND 0x00E00002 |
| 55 | +#define DSL_RESULT_GST_BIN_NAME_BAD_FORMAT 0x00E00003 |
| 56 | +#define DSL_RESULT_GST_BIN_THREW_EXCEPTION 0x00E00004 |
| 57 | +#define DSL_RESULT_GST_BIN_IS_IN_USE 0x00E00005 |
| 58 | +#define DSL_RESULT_GST_BIN_SET_FAILED 0x00E00006 |
| 59 | +#define DSL_RESULT_GST_BIN_ELEMENT_ADD_FAILED 0x00E00007 |
| 60 | +#define DSL_RESULT_GST_BIN_ELEMENT_REMOVE_FAILED 0x00E00008 |
| 61 | +#define DSL_RESULT_GST_BIN_ELEMENT_NOT_IN_USE 0x00E00009 |
| 62 | +``` |
| 63 | + |
| 64 | +**Methods of linking Pipeline components** |
| 65 | +```c |
| 66 | +#define DSL_PIPELINE_LINK_METHOD_BY_POSITION 0 |
| 67 | +#define DSL_PIPELINE_LINK_METHOD_BY_ADD_ORDER 1 |
| 68 | +#define DSL_PIPELINE_LINK_METHOD_DEFAULT DSL_PIPELINE_LINK_METHOD_BY_ADD_ORDER |
| 69 | +``` |
| 70 | + |
| 71 | +### New Services in this release |
| 72 | +**New GStreamer (GST) API:** |
| 73 | +* [`dsl_gst_element_new`](/docs/api-gst.md#dsl_gst_element_new) |
| 74 | +* [`dsl_gst_bin_new`](docs/api-gst.md#dsl_gst_bin_new) |
| 75 | +* [`dsl_gst_bin_new_element_add_many`](docs/api-gst.md#dsl_gst_bin_new_element_add_many) |
| 76 | +* [`dsl_gst_element_delete`](docs/api-gst.md#dsl_gst_element_delete) |
| 77 | +* [`dsl_gst_element_delete_many`](docs/api-gst.md#dsl_gst_element_delete_many) |
| 78 | +* [`dsl_gst_element_delete_all`](docs/api-gst.md#dsl_gst_element_delete_all) |
| 79 | +* [`dsl_gst_element_property_boolean_get`](/docs/api-gst.md#dsl_gst_element_property_boolean_get) |
| 80 | +* [`dsl_gst_element_property_boolean_set`](/docs/api-gst.md#dsl_gst_element_property_boolean_set) |
| 81 | +* [`dsl_gst_element_property_float_get`](/docs/api-gst.md#dsl_gst_element_property_float_get) |
| 82 | +* [`dsl_gst_element_property_float_set`](/docs/api-gst.md#dsl_gst_element_property_float_set) |
| 83 | +* [`dsl_gst_element_property_uint_get`](/docs/api-gst.md#dsl_gst_element_property_uint_get) |
| 84 | +* [`dsl_gst_element_property_uint_set`](/docs/api-gst.md#dsl_gst_element_property_uint_set) |
| 85 | +* [`dsl_gst_element_property_int_get`](/docs/api-gst.md#dsl_gst_element_property_int_get) |
| 86 | +* [`dsl_gst_element_property_int_set`](/docs/api-gst.md#dsl_gst_element_property_int_set) |
| 87 | +* [`dsl_gst_element_property_uint64_get`](/docs/api-gst.md#dsl_gst_element_property_uint64_get) |
| 88 | +* [`dsl_gst_element_property_uint64_set`](/docs/api-gst.md#dsl_gst_element_property_uint64_set) |
| 89 | +* [`dsl_gst_element_property_int64_get`](/docs/api-gst.md#dsl_gst_element_property_int64_get) |
| 90 | +* [`dsl_gst_element_property_int64_set`](/docs/api-gst.md#dsl_gst_element_property_int64_set) |
| 91 | +* [`dsl_gst_element_property_string_get`](/docs/api-gst.md#dsl_gst_element_property_string_get) |
| 92 | +* [`dsl_gst_element_property_string_set`](/docs/api-gst.md#dsl_gst_element_property_string_set) |
| 93 | +* [`dsl_gst_element_list_size`](/docs/api-gst.md#dsl_gst_element_list_size) |
| 94 | +* [`dsl_gst_element_pph_add`](/docs/api-gst.md#dsl_gst_element_pph_add) |
| 95 | +* [`dsl_gst_element_pph_remove`](/docs/api-gst.md#dsl_gst_element_pph_remove) |
| 96 | +* [`dsl_gst_bin_element_add`](/docs/api-gst.md#dsl_gst_bin_element_add) |
| 97 | +* [`dsl_gst_bin_element_add_many`](/docs/api-gst.md#dsl_gst_bin_element_add_many) |
| 98 | +* [`dsl_gst_bin_element_remove`](/docs/api-gst.md#dsl_gst_bin_element_remove) |
| 99 | +* [`dsl_gst_bin_element_remove_many`](/docs/api-gst.md#dsl_gst_bin_element_remove_many) |
| 100 | + |
| 101 | +**New Pipeline Link Method Services** |
| 102 | +* [`dsl_pipeline_link_method_get`](/docs/api-pipeline.md#dsl_pipeline_link_method_get) |
| 103 | +* [`dsl_pipeline_link_method_set`](/docs/api-pipeline.md#dsl_pipeline_link_method_set) |
| 104 | + |
| 105 | +**New ODE Actions** |
| 106 | +* [`dsl_ode_action_label_connect_to_bbox_new`](/docs/api-ode-action.md#dsl_ode_action_label_connect_to_bbox_new) |
| 107 | +* [`dsl_ode_action_label_snap_to_grid_new`](/docs/api-ode-action.md#dsl_ode_action_label_snap_to_grid_new) |
| 108 | + |
| 109 | +**New Sink Services** |
| 110 | +* [`dsl_sink_message_payload_debug_dir_get`](/docs/api-sink.md#dsl_sink_message_payload_debug_dir_get) |
| 111 | +* [`dsl_sink_message_payload_debug_dir_set`](/docs/api-sink.md#dsl_sink_message_payload_debug_dir_set) |
| 112 | + |
| 113 | +### New Examples in this release |
| 114 | +* [pipeline_with_custom_gst_bin_and_elements.py](/examples/python/pipeline_with_custom_gst_bin_and_elements.py) |
| 115 | +* [pipeline_with_custom_gst_bin_and_elements.cpp](/examples/python/pipeline_with_custom_gst_bin_and_elements.cpp) |
| 116 | +* [4file_custom_pph_using_opencv.py](/examples/python/4file_custom_pph_using_opencv.py) |
| 117 | +* [4file_custom_pph_using_opencv.cpp](/examples/python/4file_custom_pph_using_opencv.cpp) |
| 118 | + |
0 commit comments