Initial API

[lu-zero]

Design

The library assumes a Sequence of reference and encoded Frames exists and computes a per-frame and per-sequence quality evaluation.

• It outputs the per-frame information as the frames are provided and can output the per-sequence information as requested. NOTE: during the actual verification is possible to stop once a single frame mismatch is detected. During the encoding is possible to stop once the per-sequence or the per-frame values are below the acceptable range.

• A global context is used to store all the metrics system internals, it can be reused over multiple sequences.

• The next API iteration will add a mean to configure some details (e.g. per-sequence evaluation function).

Implementation

• [x] Data structures

  • [x] MeaFrame: frame-data holder
  • [x] MeaFrameQuality: per-frame metrics information
  • [x] MeaContext: main context
  • [x] MeaSequenceQuality: per-sequence metrics information

• [x] Functions

  • [x] mea_context_new()
  • [x] mea_context_drop()
  • [x] mea_sequence_start()
  • [x] mea_sequence_status()
  • [x] mea_frame_process()

[lu-zero]

The first iteration of the API is pending some testing.

[lu-zero]

@j0sh I'd consider this issue complete, we'll track further iteration on the next milestone.