render: the M1 thread pipeline — one render thread, one decode thread
docs/zh/plans/render-pipeline-threads.md M1: an in-process alternative to the worker-process pool, behind OAK_PIPELINE=threads (processes stays the default and is fully retained). - pipeline.rs: PipelineBackend implements JobDispatch over a single render thread draining a bounded FIFO (cap 8; blocking post with condvar backpressure and a one-ahead exception for re-posts from the render thread itself; shutdown drains with Error::State like the inline dispatcher). The DecodeService is a single decode thread behind a bounded command queue with a real LRU (tick-based eviction), rendezvous requests (None on shutdown -> the caller decodes inline), prefetch gated on render-queue room, and a Sync barrier; it installs into a process-wide slot that eval's footage path consults per frame (no service -> the synchronous decode it always was). - The manager gains RenderBackendChoice::Pipeline; init() reads OAK_PIPELINE (threads -> pipeline, anything else -> the process pool), audio stays deliberately inline. - Present mapping: the UI thread consumes through the ticket completion, unchanged — no fourth thread is invented. - Tests: decode-service unit tests (rendezvous, LRU hit/eviction, error propagation, backpressure gate) plus a six-case integration suite matrixed over inline vs pipeline — consecutive-frame and out-of-order seek pixel equality asserted byte for byte, with decode counters proving the service (not the caller) did the codec work.
This commit is contained in:
@@ -38,12 +38,16 @@ impl ManagerGuard {
|
||||
/// Initialize the manager and hold the serialization lock. Uses the
|
||||
/// test-only inline backend so no oak-worker children are spawned.
|
||||
pub fn init() -> Self {
|
||||
Self::init_with(oak_render::manager::RenderBackendChoice::Threads)
|
||||
}
|
||||
|
||||
/// Initialize the manager with an explicit backend choice and hold the
|
||||
/// serialization lock. Callers that pass `Pipeline` get the M1 thread
|
||||
/// pipeline; everything else behaves like [`ManagerGuard::init`].
|
||||
pub fn init_with(choice: oak_render::manager::RenderBackendChoice) -> Self {
|
||||
let guard = MANAGER_LOCK.lock().unwrap_or_else(|e| e.into_inner());
|
||||
oak_render::manager::RenderManager::shutdown();
|
||||
oak_render::manager::RenderManager::init_with_backend(
|
||||
oak_render::manager::RenderBackendChoice::Threads,
|
||||
)
|
||||
.expect("manager init");
|
||||
oak_render::manager::RenderManager::init_with_backend(choice).expect("manager init");
|
||||
Self { _guard: guard }
|
||||
}
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user