/* Copyright 2015-2018 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
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT OF ANY PROPRIETARY RIGHTS.
*
* 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"
#include "Image.h"
namespace Diligent
{
/// Texture loading information
struct TextureLoadInfo
{
/// Texture name passed over to the texture creation method
const Char *Name;
/// Usage
USAGE Usage;
/// Bind flags
BIND_FLAGS BindFlags;
/// Number of mip levels
Uint32 MipLevels;
/// CPU access flags
CPU_ACCESS_FLAGS CPUAccessFlags;
/// Flag indicating if this texture uses sRGB gamma encoding
Bool IsSRGB;
/// Flag indicating that the procedure should generate lower mip levels
Bool GenerateMips;
/// Texture format
TEXTURE_FORMAT Format;
TextureLoadInfo() :
Name(""),
Usage( USAGE_STATIC ),
BindFlags( BIND_SHADER_RESOURCE ),
MipLevels(0),
CPUAccessFlags(CPU_ACCESS_NONE),
IsSRGB(false),
GenerateMips(true),
Format(TEX_FORMAT_UNKNOWN)
{}
};
/// 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 CreateTextureFromImage( Image *pSrcImage,
const TextureLoadInfo& TexLoadInfo,
IRenderDevice *pDevice,
ITexture **ppTexture );
/// Creates a texture from DDS data blob
/// \param [in] pDDSData - Pointer to the DDS data blob
/// \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 CreateTextureFromDDS( IDataBlob *pDDSData,
const TextureLoadInfo& TexLoadInfo,
IRenderDevice *pDevice,
ITexture **ppTexture );
};