Partial Configurations

A session configuration can include a group of useful tasks from another file, called a partial configuration. This means that you can build groups of related tasks and re-use them in different places, or move a complex sequence of operations into a separate file.

A partial configuration has a similar structure to a session configuration. It begins with a section named [Library], rather than [Session], but contains a list of tasks defined using the Engine parameter. Each of the tasks is configured in a named section. The [Library] section also specifies the input to, and output from, the partial configuration.

The following is an example partial configuration.

[Library]
Engine0 = ObjectClassRecognizer
Engine1 = ObjectTypeFilter
Input0 = PartialConfigInput
Output0 = PartialConfigOutput:ObjectTypeFilter.Output

[ObjectClassRecognizer]
Type = ObjectClassRecognition
Recognizer = ...
Input = PartialConfigInput

[ObjectTypeFilter]
Type = Filter
Input = ObjectClassRecognizer.DataWithSource
LuaScript = OutputCarsOnly.lua

To use a partial configuration, set the Import parameter in the [Session] section of your session configuration. This specifies the name of a section that provides more information about the partial configuration. In the named section:

For example:

[Session]
Engine0 = IngestSourceMedia
Engine1 = FilterVideoFrames
Engine2 = OutputXML
Import0 = UseMyPartialConfig

[IngestSourceMedia]
Type=Video
...

[FilterVideoFrames]
Type=Filter
...

[UseMyPartialConfig]
Config = MyPartialConfig.cfg
// Send track FilterVideoFrames.Output to partial configuration
// In the partial configuration this track is called PartialConfigInput
Input0 = PartialConfigInput:FilterVideoFrames.Output

[OutputXML]
Type=XML
// Use track returned from partial configuration
Input = UseMyPartialConfig.PartialConfigOutput
...

A partial configuration can import other partial configurations. If you want to do this, set the Import parameter in the [Library] section.


_FT_HTML5_bannerTitle.htm