xref: /aosp_15_r20/external/skia/src/gpu/graphite/task/ComputeTask.h (revision c8dee2aa9b3f27cf6c858bd81872bdeb2c07ed17)
1*c8dee2aaSAndroid Build Coastguard Worker /*
2*c8dee2aaSAndroid Build Coastguard Worker  * Copyright 2022 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 skgpu_graphite_task_ComputeTask_DEFINED
9*c8dee2aaSAndroid Build Coastguard Worker #define skgpu_graphite_task_ComputeTask_DEFINED
10*c8dee2aaSAndroid Build Coastguard Worker 
11*c8dee2aaSAndroid Build Coastguard Worker #include "include/private/base/SkTArray.h"
12*c8dee2aaSAndroid Build Coastguard Worker #include "src/gpu/graphite/task/Task.h"
13*c8dee2aaSAndroid Build Coastguard Worker #include "src/gpu/graphite/task/TaskList.h"
14*c8dee2aaSAndroid Build Coastguard Worker 
15*c8dee2aaSAndroid Build Coastguard Worker #include <memory>
16*c8dee2aaSAndroid Build Coastguard Worker 
17*c8dee2aaSAndroid Build Coastguard Worker namespace skgpu::graphite {
18*c8dee2aaSAndroid Build Coastguard Worker 
19*c8dee2aaSAndroid Build Coastguard Worker class DispatchGroup;
20*c8dee2aaSAndroid Build Coastguard Worker 
21*c8dee2aaSAndroid Build Coastguard Worker /**
22*c8dee2aaSAndroid Build Coastguard Worker  * ComputeTask handles preparing and recording DispatchGroups into a series of compute dispatches
23*c8dee2aaSAndroid Build Coastguard Worker  * within a command buffer. It is guaranteed that dispatches within a DispatchGroup will be executed
24*c8dee2aaSAndroid Build Coastguard Worker  * sequentially.
25*c8dee2aaSAndroid Build Coastguard Worker  */
26*c8dee2aaSAndroid Build Coastguard Worker class ComputeTask final : public Task {
27*c8dee2aaSAndroid Build Coastguard Worker public:
28*c8dee2aaSAndroid Build Coastguard Worker     using DispatchGroupList = skia_private::STArray<1, std::unique_ptr<DispatchGroup>>;
29*c8dee2aaSAndroid Build Coastguard Worker 
30*c8dee2aaSAndroid Build Coastguard Worker     static sk_sp<ComputeTask> Make(DispatchGroupList dispatchGroups);
31*c8dee2aaSAndroid Build Coastguard Worker 
32*c8dee2aaSAndroid Build Coastguard Worker     ~ComputeTask() override;
33*c8dee2aaSAndroid Build Coastguard Worker 
34*c8dee2aaSAndroid Build Coastguard Worker     Status prepareResources(ResourceProvider*,
35*c8dee2aaSAndroid Build Coastguard Worker                             ScratchResourceManager*,
36*c8dee2aaSAndroid Build Coastguard Worker                             const RuntimeEffectDictionary*) override;
37*c8dee2aaSAndroid Build Coastguard Worker     Status addCommands(Context*, CommandBuffer*, ReplayTargetData) override;
38*c8dee2aaSAndroid Build Coastguard Worker 
39*c8dee2aaSAndroid Build Coastguard Worker private:
40*c8dee2aaSAndroid Build Coastguard Worker     explicit ComputeTask(DispatchGroupList dispatchGroups);
41*c8dee2aaSAndroid Build Coastguard Worker 
42*c8dee2aaSAndroid Build Coastguard Worker     DispatchGroupList fDispatchGroups;
43*c8dee2aaSAndroid Build Coastguard Worker 
44*c8dee2aaSAndroid Build Coastguard Worker     // Every element of this list is a task that must execute before the DispatchGroup stored at the
45*c8dee2aaSAndroid Build Coastguard Worker     // same array index. Child tasks are allowed to be a nullptr to represent NOP (i.e. the
46*c8dee2aaSAndroid Build Coastguard Worker     // corresponding DispatchGroup doesn't have any pre-tasks).
47*c8dee2aaSAndroid Build Coastguard Worker     skia_private::TArray<sk_sp<Task>> fChildTasks;
48*c8dee2aaSAndroid Build Coastguard Worker };
49*c8dee2aaSAndroid Build Coastguard Worker 
50*c8dee2aaSAndroid Build Coastguard Worker }  // namespace skgpu::graphite
51*c8dee2aaSAndroid Build Coastguard Worker 
52*c8dee2aaSAndroid Build Coastguard Worker #endif  // skgpu_graphite_task_ComputeTask_DEFINED
53