xref: /aosp_15_r20/external/skia/include/gpu/ganesh/vk/GrVkDirectContext.h (revision c8dee2aa9b3f27cf6c858bd81872bdeb2c07ed17)
1*c8dee2aaSAndroid Build Coastguard Worker /*
2*c8dee2aaSAndroid Build Coastguard Worker  * Copyright 2023 Google LLC
3*c8dee2aaSAndroid Build Coastguard Worker  *
4*c8dee2aaSAndroid Build Coastguard Worker  * Use of this source code is governed by a BSD-style license that can be
5*c8dee2aaSAndroid Build Coastguard Worker  * found in the LICENSE file.
6*c8dee2aaSAndroid Build Coastguard Worker  */
7*c8dee2aaSAndroid Build Coastguard Worker 
8*c8dee2aaSAndroid Build Coastguard Worker #ifndef GrVkDirectContext_DEFINED
9*c8dee2aaSAndroid Build Coastguard Worker #define GrVkDirectContext_DEFINED
10*c8dee2aaSAndroid Build Coastguard Worker 
11*c8dee2aaSAndroid Build Coastguard Worker #include "include/core/SkRefCnt.h"
12*c8dee2aaSAndroid Build Coastguard Worker #include "include/private/base/SkAPI.h"
13*c8dee2aaSAndroid Build Coastguard Worker 
14*c8dee2aaSAndroid Build Coastguard Worker class GrDirectContext;
15*c8dee2aaSAndroid Build Coastguard Worker struct GrContextOptions;
16*c8dee2aaSAndroid Build Coastguard Worker namespace skgpu {
17*c8dee2aaSAndroid Build Coastguard Worker struct VulkanBackendContext;
18*c8dee2aaSAndroid Build Coastguard Worker }
19*c8dee2aaSAndroid Build Coastguard Worker 
20*c8dee2aaSAndroid Build Coastguard Worker namespace GrDirectContexts {
21*c8dee2aaSAndroid Build Coastguard Worker /**
22*c8dee2aaSAndroid Build Coastguard Worker  * The Vulkan context (VkQueue, VkDevice, VkInstance) must be kept alive until the returned
23*c8dee2aaSAndroid Build Coastguard Worker  * GrDirectContext is destroyed. This also means that any objects created with this
24*c8dee2aaSAndroid Build Coastguard Worker  * GrDirectContext (e.g. SkSurfaces, SkImages, etc.) must also be released as they may hold
25*c8dee2aaSAndroid Build Coastguard Worker  * refs on the GrDirectContext. Once all these objects and the GrDirectContext are released,
26*c8dee2aaSAndroid Build Coastguard Worker  * then it is safe to delete the vulkan objects.
27*c8dee2aaSAndroid Build Coastguard Worker  */
28*c8dee2aaSAndroid Build Coastguard Worker SK_API sk_sp<GrDirectContext> MakeVulkan(const skgpu::VulkanBackendContext&,
29*c8dee2aaSAndroid Build Coastguard Worker                                          const GrContextOptions&);
30*c8dee2aaSAndroid Build Coastguard Worker SK_API sk_sp<GrDirectContext> MakeVulkan(const skgpu::VulkanBackendContext&);
31*c8dee2aaSAndroid Build Coastguard Worker }
32*c8dee2aaSAndroid Build Coastguard Worker 
33*c8dee2aaSAndroid Build Coastguard Worker #endif
34