mirror of
https://github.com/MobileGL-Dev/MobileGL
synced 2026-11-20 16:31:57 +09:00
44 lines
2.3 KiB
C++
44 lines
2.3 KiB
C++
// MobileGL - MobileGL/MG_Backend/BackendObjects.h
|
|
// Copyright (c) 2025-2026 MobileGL-Dev
|
|
// Licensed under the GNU Lesser General Public License v3.0:
|
|
// https://www.gnu.org/licenses/gpl-3.0.txt
|
|
// https://www.gnu.org/licenses/lgpl-3.0.txt
|
|
// SPDX-License-Identifier: LGPL-3.0-only
|
|
// End of Source File Header
|
|
|
|
#pragma once
|
|
#include <Includes.h>
|
|
#include "BackendObject.h"
|
|
#include "DirectGLES/BackendObject_DirectGLES.h"
|
|
#include "DirectVulkan/BackendObject_DirectVulkan.h"
|
|
|
|
namespace MobileGL::MG_Backend {
|
|
extern UniquePtr<BackendObject>& pActiveBackendObject;
|
|
extern GlobalBackendFunctionsTable gBackendFunctionsTable;
|
|
|
|
#if MOBILEGL_BUILD_DISAGGREGATED
|
|
// P5 v1. The counterpart of Init()'s single split hook, and a NO-OP in every run that is
|
|
// not split. It exists ONLY in a split build: G1 admits no new symbol in the pull build,
|
|
// so MobileGL/Init.cpp's call sits under the same #if rather than calling a no-op.
|
|
//
|
|
// IT MUST RUN FIRST, BEFORE ANYTHING ELSE IN DestroyImpl. ARCHITECTURE.md:537's order is
|
|
// publish -> the server drains and acks -> stop the apply thread (Kill, then join) -> close
|
|
// the transport -> the client drains the compile pool -> MobileGL::Destroy() -> release the
|
|
// sync/query handles; DestroyImpl IS MobileGL::Destroy, so everything before that arrow has
|
|
// to happen at its top. Two consequences are load-bearing rather than tidy:
|
|
//
|
|
// * the apply thread is JOINED before PipeStats::Shutdown() dumps, so nothing is writing
|
|
// a counter while the final line is produced;
|
|
// * the apply thread is joined before pActiveBackendObject.reset(), so the server's own
|
|
// BackendObject - which is NOT that global (table 3) - is destroyed on the thread that
|
|
// owns the context, by ServerLoop::Stop, rather than on the app thread.
|
|
//
|
|
// The sync/query registries stay where they are, drained at MobileGL/Init.cpp:62 and :67
|
|
// BEFORE pActiveBackendObject.reset(). ARCHITECTURE.md:537 puts them after
|
|
// MobileGL::Destroy(); the two are only reconcilable if a split sync handle is
|
|
// client-minted and needs no backend call, which is P10's. CONTRACT-P5 4 flags this as a
|
|
// KNOWN OPEN ITEM and asks v1 to record which way it went: P5 keeps today's order.
|
|
void ShutdownSplitRoles();
|
|
#endif
|
|
} // namespace MobileGL::MG_Backend
|