public class TableSectionFilter
extends SectionFilter
This class defines a section filter operation optimized to capture entire tables with minimum
intervention required from the application. When filtering is started, first one section
matching the specified pattern will be filtered. Once that section has been found, the
last_section_number field will be used to determine the number of Section objects required
to hold the entire table. This number of objects will be created and filtering re-started to
capture all the sections of the table. The SectionAvailableEvent will be generated each time
a Section is captured. The EndOfFilteringEvent will be generated when the complete table
has been captured.
The version_number of all sections of the table will be the same. If a section is captured with a
version_number that differs from the version_number of the section first captured, a
VersionChangeDetectedEvent will be generated. The newly captured section will be ignored
and filtering will continue on the table with the version number of the first captured section.
Only one VersionChangeDetectedEvent will be sent per filtering action.
Care should be taking in setting the filter parameters, a too restrictive filter will never stop
automatically and a too wide filter can produce inconsistent results (e.g. filtering short sections
using a TableSectionFilter)
When the API detects a filtering situation where the filter parameters have been incompletely defined,
resulting in a blocking filter or a non MPEG-2 compliant result, an InCompleteFilteringEvent is sent
and filtering is stopped.
- Version:
- updated to DAVIC 1.3.1