1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
|
// Copyright 2018 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
#ifndef GPU_COMMAND_BUFFER_COMMON_SHARED_IMAGE_USAGE_H_
#define GPU_COMMAND_BUFFER_COMMON_SHARED_IMAGE_USAGE_H_
#include <stdint.h>
#include <string>
#include "gpu/gpu_export.h"
namespace gpu {
// Please update the function, CreateLabelForSharedImageUsage, when adding a new
// enum value.
enum SharedImageUsage : uint32_t {
// Image will be used in GLES2Interface
SHARED_IMAGE_USAGE_GLES2 = 1 << 0,
// Image will be used as a framebuffer (hint)
SHARED_IMAGE_USAGE_GLES2_FRAMEBUFFER_HINT = 1 << 1,
// Image will be used in RasterInterface
SHARED_IMAGE_USAGE_RASTER = 1 << 2,
// Image will be read from inside Display Compositor
SHARED_IMAGE_USAGE_DISPLAY_READ = 1 << 3,
// Image will be written to inside Display Compositor
SHARED_IMAGE_USAGE_DISPLAY_WRITE = 1 << 4,
// Image will be used as a scanout buffer (overlay)
SHARED_IMAGE_USAGE_SCANOUT = 1 << 5,
// Image will be used in OOP rasterization. This flag is used on top of
// SHARED_IMAGE_USAGE_RASTER to indicate that the client will only use
// RasterInterface for OOP rasterization. TODO(backer): Eliminate once we can
// CPU raster to SkImage via RasterInterface.
SHARED_IMAGE_USAGE_OOP_RASTERIZATION = 1 << 6,
// Image will be used by Dawn (for WebGPU)
SHARED_IMAGE_USAGE_WEBGPU = 1 << 7,
// Image may use concurrent read/write access. Used by single buffered canvas.
// TODO(crbug.com/969114): This usage is currently not supported in GL/Vulkan
// interop cases.
SHARED_IMAGE_USAGE_CONCURRENT_READ_WRITE = 1 << 8,
// Image will be used for video decode acceleration on Chrome OS.
SHARED_IMAGE_USAGE_VIDEO_DECODE = 1 << 9,
// Image will be used as a WebGPU swapbuffer
SHARED_IMAGE_USAGE_WEBGPU_SWAP_CHAIN_TEXTURE = 1 << 10,
// The image was created by VideoToolbox on macOS, and is backed by a
// CVPixelBuffer's IOSurface. Because of this backing, IOSurfaceIsInUse will
// always return true.
SHARED_IMAGE_USAGE_MACOS_VIDEO_TOOLBOX = 1 << 11,
// Image will be used with mipmap enabled
SHARED_IMAGE_USAGE_MIPMAP = 1 << 12,
// Image will be used for CPU Writes by client
SHARED_IMAGE_USAGE_CPU_WRITE = 1 << 13,
// Image will be used in RasterInterface with RawDraw.
SHARED_IMAGE_USAGE_RAW_DRAW = 1 << 14,
// Image will be used in RasterInterface for DelegatedCompositing.
// TODO(crbug.com/1254033): this usage shall be removed after cc is able to
// set a single (duplicated) fence for bunch of tiles instead of having the SI
// framework creating fences for each single message when write access ends.
SHARED_IMAGE_USAGE_RASTER_DELEGATED_COMPOSITING = 1 << 15,
// Image will be created on the high performance GPU if supported.
SHARED_IMAGE_USAGE_HIGH_PERFORMANCE_GPU = 1 << 16,
// Windows only: image will be backed by a DComp surface. A swap chain is
// preferred when an image is opaque and expected to update frequently and
// independently of other overlays. This flag is incompatible with
// DISPLAY_READ.
SHARED_IMAGE_USAGE_SCANOUT_DCOMP_SURFACE = 1 << 17,
// Image will be used as a WebGPU storage texture.
SHARED_IMAGE_USAGE_WEBGPU_STORAGE_TEXTURE = 1 << 18,
// Start service side only usage flags after this entry. They must be larger
// than `LAST_CLIENT_USAGE`.
LAST_CLIENT_USAGE = SHARED_IMAGE_USAGE_WEBGPU_STORAGE_TEXTURE,
// Image will have pixels uploaded from CPU. The backing must implement
// `UploadFromMemory()` if it supports this usage. Clients should specify
// SHARED_IMAGE_USAGE_CPU_WRITE if they need to write pixels to the image.
SHARED_IMAGE_USAGE_CPU_UPLOAD = 1 << 19,
LAST_SHARED_IMAGE_USAGE = SHARED_IMAGE_USAGE_CPU_UPLOAD
};
// Returns true if usage is a valid client usage.
GPU_EXPORT bool IsValidClientUsage(uint32_t usage);
// Create a string to label SharedImageUsage.
GPU_EXPORT std::string CreateLabelForSharedImageUsage(uint32_t usage);
} // namespace gpu
#endif // GPU_COMMAND_BUFFER_COMMON_SHARED_IMAGE_USAGE_H_
|
