Method acquireFrame

app/src/DataModel/FrameBuilder.cpp:285–307

* @brief Claims a free pool slot, copies @p src + @p ts into it, and returns an aliasing * shared_ptr: no deleter, no per-frame control block. */

 *        shared_ptr: no deleter, no per-frame control block.
 */
SS_HOT DataModel::TimestampedFramePtr DataModel::FrameBuilder::acquireFrame(
  const DataModel::Frame& src, const DataModel::TimestampedFrame::SteadyTimePoint& ts)
{
  const size_t idx = claimPoolSlot();
  if (idx == kInvalidSlotIdx) [[unlikely]] {
    notePoolExhausted();
    auto heap                 = std::make_shared<TimestampedFrame>(src, ts);
    heap->structureGeneration = m_framePoolGeneration;
    return heap;
  }

  const auto& slotOwner = m_framePool[idx];
  auto* slotRaw         = slotOwner.get();

  if (preparePooledSlot(slotRaw, src)) [[likely]]
    copy_frame_values(slotRaw->frame.data, src);

  slotRaw->frame.timestamp           = ts;
  slotRaw->frame.structureGeneration = m_framePoolGeneration;
  Q_ASSERT(slotRaw->frame.data.groups.size() == src.groups.size());

  return TimestampedFramePtr(slotOwner, &slotRaw->frame);
}

/**
 * @brief Convenience overload that timestamps the slot with SteadyClock::now().