Debian Codegraph @

media_driver/agnostic/common/codec/hal/codechal_encode_allocator.h

raw
1 /*
2 * Copyright (c) 2017, Intel Corporation
3 *
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and associated documentation files (the "Software"),
6 * to deal in the Software without restriction, including without limitation
7 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
8 * and/or sell copies of the Software, and to permit persons to whom the
9 * Software is furnished to do so, subject to the following conditions:
10 *
11 * The above copyright notice and this permission notice shall be included
12 * in all copies or substantial portions of the Software.
13 *
14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
15 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
18 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
19 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
20 * OTHER DEALINGS IN THE SOFTWARE.
21 */
22 //!
23 //! \file codechal_encode_allocator.h
24 //! \brief Resource allocator for all buffer/surface used by encoder
25 //!
26
27 #ifndef __CODECHAL_ENCODE_ALLOCATOR_H__
28 #define __CODECHAL_ENCODE_ALLOCATOR_H__
29
30 #include "codechal_allocator.h"
31
32 //!
33 //! \enum ResourceName
34 //! \brief Resource name
35 //!
36 enum ResourceName
37 {
38 // common VDEnc buffer
39 vdencStats = 0,
40 vdencIntraRowStoreScratch = vdencStats + 1,
41 vdencEnd = vdencIntraRowStoreScratch,
42
43 // common PAK buffer
44 pakStats = vdencEnd + 1,
45 pakInfo = pakStats + 1,
46 pakEnd = pakInfo,
47
48 // HEVC buffer
49 hevcMbCodeBuffer = pakEnd + 1,
50 brcInputForEncKernel = hevcMbCodeBuffer + 1,
51
52 // tracked buffer
53 trackedBuffer = 512,
54 cscSurface = trackedBuffer,
55 mbCodeBuffer = cscSurface + 32,
56 mvDataBuffer = mbCodeBuffer + 32,
57 mvTemporalBuffer = mvDataBuffer + 32,
58 ds4xSurface = mvTemporalBuffer + 32,
59 ds2xSurface = ds4xSurface + 32,
60 ds16xSurface = ds2xSurface + 32,
61 ds32xSurface = ds16xSurface + 32,
62 ds4xRecon = ds32xSurface + 32,
63 ds8xRecon = ds4xRecon + 32,
64 trackedBufferEnd = ds8xRecon,
65
66 // recycled buffer
67 recycledBuffer = trackedBufferEnd + 32,
68 brcReadSurface = recycledBuffer,
69 recycledBufferEnd = brcReadSurface
70 };
71
72 typedef union _RESOURCE_TAG
73 {
74 struct
75 {
76 union
77 {
78 struct
79 {
80 uint16_t trackedRecycleBufferIndex : MOS_BITFIELD_RANGE(0, 4);
81 uint16_t trackedRecycleBufferName : MOS_BITFIELD_RANGE(5, 10);
82 uint16_t codec : MOS_BITFIELD_RANGE(11, 13);
83 uint16_t type : MOS_BITFIELD_RANGE(14, 15);
84 };
85 uint16_t typeID;
86 };
87 uint16_t format : MOS_BITFIELD_RANGE(0, 3);
88 uint16_t tile : MOS_BITFIELD_RANGE(4, 6);
89 uint16_t zeroOnAllocation : MOS_BITFIELD_BIT(7);
90 uint16_t reserved : MOS_BITFIELD_RANGE(8, 15);
91 union
92 {
93 struct
94 {
95 uint16_t width;
96 uint16_t height;
97 };
98 uint32_t size;
99 };
100 };
101 uint64_t tag;
102 }RESOURCE_TAG, *PRESOURCE_TAG;
103
104 //!
105 //! \class CodechalEncodeAllocator
106 //! \brief This class provides resource management for all codecs to
107 //! obtain buffer/surface/resource used by EU kernel and HW.
108 //!
109 class CodechalEncodeAllocator : public CodechalAllocator
110 {
111 public:
112 //!
113 //! \brief Allocate resource
114 //!
115 //! \return pointer to resource, NULL if error
116 //!
117 void* AllocateResource(
118 uint32_t codec, uint32_t width, uint32_t height, ResourceName name, const char *bufName, uint8_t index = 0,
119 bool zeroOnAllocation = false, MOS_FORMAT format = Format_Buffer, MOS_TILE_TYPE tile = MOS_TILE_LINEAR, uint32_t dwMemType = 0);
120
121 //!
122 //! \brief Return address/pointer of a resource already allocated
123 //!
124 //! \return pointer to resource, NULL if the resource not allcoated yet
125 //!
126 void* GetResource(uint32_t codec, ResourceName name, uint8_t index = 0);
127
128 //!
129 //! \brief Return size of allocated resource
130 //!
131 //! \return size of allocated resource
132 //!
133 uint32_t GetResourceSize(uint32_t codec, ResourceName name, uint8_t index = 0);
134
135 //!
136 //! \brief Release a resource
137 //!
138 void ReleaseResource(uint32_t codec, ResourceName name, uint8_t index = 0);
139
140 //!
141 //! \brief Constructor
142 //!
143 CodechalEncodeAllocator(CodechalEncoderState* encoder);
144
145 //!
146 //! \brief Destructor
147 //!
148 ~CodechalEncodeAllocator();
149
150 private:
151 CodechalEncodeAllocator(const CodechalEncodeAllocator&) = delete;
152 CodechalEncodeAllocator& operator=(const CodechalEncodeAllocator&) = delete;
153
154 uint16_t MosToAllocatorCodec(uint32_t);
155 uint16_t MosToAllocatorFormat(MOS_FORMAT format);
156 uint16_t MosToAllocatorTile(MOS_TILE_TYPE type);
157
158 inline bool IsTrackedBuffer(ResourceName name)
159 {
160 return (trackedBuffer <= name && name <= trackedBufferEnd);
161 }
162
163 inline bool IsRecycleBuffer(ResourceName name)
164 {
165 return (recycledBuffer <= name && name <= recycledBufferEnd);
166 }
167
168 uint16_t SetResourceID(uint32_t codec, ResourceName name, uint8_t index);
169 virtual uint16_t GetResourceID(uint64_t resourceTag, Match level) override;
170
171 CodechalEncoderState* m_encoder = nullptr; //!< Pointer to ENCODER base class
172
173 static const uint16_t m_bufIndexMask = (1 << 5) - 1;
174 static const uint16_t m_bufNameMask = (1 << 14) - 1;
175 };
176 #endif // __CODECHAL_ENCODE_ALLOCATOR_H__