1 #ifndef DALI_GRAPHICS_GLES_PROGRAM_H
2 #define DALI_GRAPHICS_GLES_PROGRAM_H
5 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
7 * Licensed under the Apache License, Version 2.0 (the "License");
8 * you may not use this file except in compliance with the License.
9 * You may obtain a copy of the License at
11 * http://www.apache.org/licenses/LICENSE-2.0
13 * Unless required by applicable law or agreed to in writing, software
14 * distributed under the License is distributed on an "AS IS" BASIS,
15 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16 * See the License for the specific language governing permissions and
17 * limitations under the License.
21 #include <dali/graphics-api/graphics-program-create-info.h>
22 #include <dali/graphics-api/graphics-program.h>
25 #include "gles-graphics-resource.h"
27 namespace Dali::Graphics::GLES
32 * @brief Program implementation
34 * Program implementation is owned only by the PipelineCache
36 * Like pipeline, it's created and managed by the PipelineCache
44 * @param[in] createInfo Valid create info structure
45 * @param[in] controller Valid reference to the controller object
47 ProgramImpl(const Graphics::ProgramCreateInfo& createInfo, Graphics::EglGraphicsController& controller);
55 * @brief Destroys GL resources associated with the Program
57 * @return True on success
62 * @brief Creates GL resource for this Program
64 * @return True on success
69 * @brief Returns GL program id
71 * @return GL program id
73 [[nodiscard]] uint32_t GetGlProgram() const;
76 * @brief Increases ref count
78 * @return new refcount
83 * @brief Decreases ref count
85 * @return New refcount
90 * @brief Returns reflection
92 * @return Valid reflection associated with the Program
94 [[nodiscard]] const GLES::Reflection& GetReflection() const;
97 * @brief Returns controller
99 * @return Valid Controller object
101 [[nodiscard]] EglGraphicsController& GetController() const;
104 * @brief Returns create info structure
106 * @return Reference to valid create info structure
108 [[nodiscard]] const ProgramCreateInfo& GetCreateInfo() const;
111 * @brief Returns parameter value specified by parameterId
113 * This function can be used as a backdoor into the implementation
114 * used to retrieve internal data.
116 * @param[in] parameterId Integer parameter id
117 * @param[out] out Pointer to write to
119 * @return True on success
121 bool GetParameter(uint32_t parameterId, void* out);
124 friend class Program;
127 std::unique_ptr<Impl> mImpl;
130 ///////////////////////////////////////////////////////////////
133 * @brief Wrapper for the pipeline implementation
135 * This object is returned back to the client-side
137 class Program : public Graphics::Program
143 * @param[in] impl Pointer to valid implementation
145 explicit Program(ProgramImpl* impl)
157 * @brief Returns reference to the Reflection object
161 [[nodiscard]] const GLES::Reflection& GetReflection() const;
164 * @brief Retrieves internal program implementation
166 * @return Valid pointer to the ProgramImpl object
168 [[nodiscard]] ProgramImpl* GetImplementation() const
174 * @brief Returns controller
178 [[nodiscard]] EglGraphicsController& GetController() const;
181 * @brief Returns create info structure
183 * @return create info structure
185 [[nodiscard]] const ProgramCreateInfo& GetCreateInfo() const;
187 bool operator==(const GLES::Program& program) const
189 return (program.mProgram == mProgram);
192 bool operator==(const GLES::ProgramImpl* programImpl) const
194 return (programImpl == mProgram);
197 bool operator!=(const GLES::Program& program) const
199 return (program.mProgram != mProgram);
203 * @brief Run by UniquePtr to discard resource
205 void DiscardResource();
208 * @brief Destroying GL resources
210 * This function is kept for compatibility with Resource<> class
211 * so can the object can be use with templated functions.
213 void DestroyResource()
215 // nothing to do here
219 ProgramImpl* mProgram{nullptr};
221 } // namespace Dali::Graphics::GLES
223 #endif //DALI_GRAPHICS_GLES_PROGRAM_H