// 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 #include "BackendObject.h" #include "DirectGLES/BackendObject_DirectGLES.h" #include "DirectVulkan/BackendObject_DirectVulkan.h" namespace MobileGL::MG_Backend { extern UniquePtr& 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