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
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
|
/*
* Copyright 2019-2021 Diligent Graphics LLC
* Copyright 2015-2019 Egor Yusov
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*
* In no event and under no legal theory, whether in tort (including negligence),
* contract, or otherwise, unless required by applicable law (such as deliberate
* and grossly negligent acts) or agreed to in writing, shall any Contributor be
* liable for any damages, including any direct, indirect, special, incidental,
* or consequential damages of any character arising as a result of this License or
* out of the use or inability to use the software (including but not limited to damages
* for loss of goodwill, work stoppage, computer failure or malfunction, or any and
* all other commercial damages or losses), even if such Contributor has been advised
* of the possibility of such damages.
*/
#pragma once
#include "../../../DiligentCore/Primitives/interface/FileStream.h"
#include "../../../DiligentCore/Graphics/GraphicsEngine/interface/RenderDevice.h"
#include "../../../DiligentCore/Graphics/GraphicsEngine/interface/Texture.h"
DILIGENT_BEGIN_NAMESPACE(Diligent)
struct Image;
// clang-format off
/// Texture loading information
struct TextureLoadInfo
{
/// Texture name passed over to the texture creation method
const Char* Name DEFAULT_VALUE(nullptr);
/// Usage
USAGE Usage DEFAULT_VALUE(USAGE_IMMUTABLE);
/// Bind flags
BIND_FLAGS BindFlags DEFAULT_VALUE(BIND_SHADER_RESOURCE);
/// Number of mip levels
Uint32 MipLevels DEFAULT_VALUE(0);
/// CPU access flags
CPU_ACCESS_FLAGS CPUAccessFlags DEFAULT_VALUE(CPU_ACCESS_NONE);
/// Flag indicating if this texture uses sRGB gamma encoding
Bool IsSRGB DEFAULT_VALUE(False);
/// Flag indicating that the procedure should generate lower mip levels
Bool GenerateMips DEFAULT_VALUE(True);
/// Texture format
TEXTURE_FORMAT Format DEFAULT_VALUE(TEX_FORMAT_UNKNOWN);
#if DILIGENT_CPP_INTERFACE
explicit TextureLoadInfo(const Char* _Name,
USAGE _Usage = TextureLoadInfo{}.Usage,
BIND_FLAGS _BindFlags = TextureLoadInfo{}.BindFlags,
Uint32 _MipLevels = TextureLoadInfo{}.MipLevels,
CPU_ACCESS_FLAGS _CPUAccessFlags = TextureLoadInfo{}.CPUAccessFlags,
Bool _IsSRGB = TextureLoadInfo{}.IsSRGB,
Bool _GenerateMips = TextureLoadInfo{}.GenerateMips,
TEXTURE_FORMAT _Format = TextureLoadInfo{}.Format) :
Name {_Name},
Usage {_Usage},
BindFlags {_BindFlags},
MipLevels {_MipLevels},
CPUAccessFlags {_CPUAccessFlags},
IsSRGB {_IsSRGB},
GenerateMips {_GenerateMips},
Format {_Format}
{}
TextureLoadInfo(){};
#endif
};
typedef struct TextureLoadInfo TextureLoadInfo;
// clang-format on
#include "../../../DiligentCore/Primitives/interface/DefineGlobalFuncHelperMacros.h"
/// Creates a texture from 2D image
/// \param [in] pSrcImage - Pointer to the source image data
/// \param [in] TexLoadInfo - Texture loading information
/// \param [in] pDevice - Render device that will be used to create the texture
/// \param [out] ppTexture - Memory location where pointer to the created texture will be stored
void DILIGENT_GLOBAL_FUNCTION(CreateTextureFromImage)(struct Image* pSrcImage,
const TextureLoadInfo REF TexLoadInfo,
IRenderDevice* pDevice,
ITexture** ppTexture);
/// Creates a texture from DDS data blob
/// \param [in] pDDSData - Pointer to DDS data
/// \param [in] DataSize - DDS data size
/// \param [in] TexLoadInfo - Texture loading information
/// \param [in] pDevice - Render device that will be used to create the texture
/// \param [out] ppTexture - Memory location where pointer to the created texture will be stored
void DILIGENT_GLOBAL_FUNCTION(CreateTextureFromDDS)(const void* pDDSData,
size_t DataSize,
const TextureLoadInfo REF TexLoadInfo,
IRenderDevice* pDevice,
ITexture** ppTexture);
/// Creates a texture from KTX data blob
/// \param [in] pKTXData - Pointer to KTX data
/// \param [in] DataSize - KTX data size
/// \param [in] TexLoadInfo - Texture loading information
/// \param [in] pDevice - Render device that will be used to create the texture
/// \param [out] ppTexture - Memory location where pointer to the created texture will be stored
void DILIGENT_GLOBAL_FUNCTION(CreateTextureFromKTX)(const void* pKTXData,
size_t DataSize,
const TextureLoadInfo REF TexLoadInfo,
IRenderDevice* pDevice,
ITexture** ppTexture);
#include "../../../DiligentCore/Primitives/interface/UndefGlobalFuncHelperMacros.h"
DILIGENT_END_NAMESPACE // namespace Diligent
|
