Add doc comment to PM::splitBuffer

src/processor/processor_motion.cpp

@@ -58,6 +58,24 @@ void ProcessorMotion::splitBuffer(const wolf::CaptureMotionPtr& _capture_source,
                                   const FrameBasePtr& _keyframe_target,
                                   const wolf::CaptureMotionPtr& _capture_target)
 {
+    /** we are doing this:
+     *
+     *  Before split:
+     *
+     *             ts_split
+     *    KF          |          F or KF
+     *    * -----------------------*
+     *  origin                   source
+     *
+     *
+     *  After split:
+     *
+     *    KF          KF         F or KF
+     *    * ----------* -----------*
+     *  origin     target        source
+     *
+     */
+
     // split the buffer
     // and give the part of the buffer before the new keyframe to the capture for the KF callback
     _capture_source->getBuffer().split(_ts_split, _capture_target->getBuffer());