BansheeEngine/BansheeD3D11RenderAPI/Include/BsD3D11Mappings.h

//********************************** Banshee Engine (www.banshee3d.com) **************************************************//
//**************** Copyright (c) 2016 Marko Pintera ([email protected]). All rights reserved. **********************//
#pragma once

#include "BsD3D11Prerequisites.h"
#include "BsTexture.h"
#include "BsPixelData.h"
#include "BsIndexBuffer.h"
#include "BsVertexData.h"
#include "BsSamplerState.h"
#include "BsDrawOps.h"

namespace BansheeEngine
{
	/**
	 * @brief	Helper class that maps engine types to DirectX 1 types
	 */
	class BS_D3D11_EXPORT D3D11Mappings
	{
	public:
		/**
		 * @brief	Converts engine to DX11 specific texture addressing mode.
		 */
		static D3D11_TEXTURE_ADDRESS_MODE get(TextureAddressingMode tam);

		/**
		 * @brief	Converts engine to DX11 specific blend factor.
		 */
		static D3D11_BLEND get(BlendFactor bf);

		/**
		 * @brief	Converts engine to DX11 specific blend operation.
		 */
		static D3D11_BLEND_OP get(BlendOperation bo);

		/**
		 * @brief	Converts engine to DX11 specific comparison function.
		 */
		static D3D11_COMPARISON_FUNC get(CompareFunction cf);

		/**
		 * @brief	Converts engine to DX11 specific culling mode.
		 */
		static D3D11_CULL_MODE get(CullingMode cm);

		/**
		 * @brief	Converts engine to DX11 specific polygon fill mode.
		 */
		static D3D11_FILL_MODE get(PolygonMode mode);

		/**
		 * @brief	Return DirectX 11 stencil operation and optionally 
		 *			invert it (greater than becomes less than, etc.)
		 */
		static D3D11_STENCIL_OP get(StencilOperation op, bool invert = false);

		/**
		 * @brief	Converts engine texture filter type to DirectX 11 filter
		 *			shift (used for combining to get actual min/mag/mip filter
		 *			bit location).
		 */
		static DWORD get(FilterType ft);

		/**
		 * @brief	Returns DirectX 11 texture filter from the provided min, mag
		 *			and mip filter options, and optionally a filter with comparison support.
		 */
		static D3D11_FILTER get(const FilterOptions min, const FilterOptions mag, 
			const FilterOptions mip, const bool comparison = false);

		/**
		 * @brief	Converts engine to DX11 buffer usage.
		 */
		static DWORD get(GpuBufferUsage usage);

		/**
		 * @brief	Converts engine to DX11 lock options, while also constraining
		 *			the options depending on provided usage type.
		 */
		static D3D11_MAP get(GpuLockOptions options, GpuBufferUsage usage);

		/**
		 * @brief	Converts engine to DX11 vertex element type.
		 */
		static DXGI_FORMAT get(VertexElementType type);

		/**
		 * @brief	Returns a string describing the provided vertex element semantic.
		 */
		static LPCSTR get(VertexElementSemantic sem);

		/**
		 * @brief	Returns engine semantic from the provided semantic string. Throws an exception
		 *			for semantics that do not exist.
		 */
		static VertexElementSemantic get(LPCSTR sem);

		/**
		 * @brief	Converts DirectX 11 GPU parameter component type to engine vertex element type.
		 */
		static VertexElementType getInputType(D3D_REGISTER_COMPONENT_TYPE type);

		/**
		 * @brief	Returns DX11 primitive topology based on the provided draw operation type.
		 */
		static D3D11_PRIMITIVE_TOPOLOGY getPrimitiveType(DrawOperationType type);

		/**
		 * @brief	Converts engine color to DX11 color.
		 */
		static void get(const Color& inColor, float* outColor);

		/**
		 * @brief	Checks does the provided map value include writing.
		 */
		static bool isMappingWrite(D3D11_MAP map);

		/**
		 * @brief	Checks does the provided map value include reading.
		 */
		static bool isMappingRead(D3D11_MAP map);

		/**
		 * @brief	Converts DX11 pixel format to engine pixel format.
		 */
		static PixelFormat getPF(DXGI_FORMAT d3dPF);

		/**
		 * @brief	Converts engine pixel format to DX11 pixel format. Some formats
		 *			depend on whether hardware gamma is used or not, in which case
		 *			set the "hwGamma" parameter as needed.
		 */
		static DXGI_FORMAT getPF(PixelFormat format, bool hwGamma);
		
		/** 
		 * Returns a typeless version of a depth stencil format. Required for creating a depth stencil texture it can be
		 * bound both for shader reading and depth/stencil writing.
		 */
		static DXGI_FORMAT getTypelessDepthStencilPF(PixelFormat format);

		/** Returns a format of a depth stencil texture that can be used for reading the texture in the shader. */
		static DXGI_FORMAT getShaderResourceDepthStencilPF(PixelFormat format);

		/**
		 * @brief	Converts engine to DX11 buffer usage.
		 */
		static D3D11_USAGE getUsage(GpuBufferUsage mUsage);

		/**
		 * @brief	Converts engine to DX11 buffer access flags.
		 */
		static UINT getAccessFlags(GpuBufferUsage mUsage);

		/**
		 * @brief	Converts engine to DX11 lock options.
		 */
		static D3D11_MAP getLockOptions(GpuLockOptions lockOptions);

		/**
		 * @brief	Checks is the provided buffer usage dynamic.
		 */
		static bool isDynamic(GpuBufferUsage mUsage);

		/**
		 * @brief	Finds the closest pixel format that DX11 supports.
		 */
		static PixelFormat getClosestSupportedPF(PixelFormat format, bool hwGamma);

		/**
		 * @brief	Returns size in bytes of a pixel surface of the specified size and format, while
		 *			using DX11 allocation rules for padding.
		 */
		static UINT32 getSizeInBytes(PixelFormat pf, UINT32 width = 1, UINT32 height = 1);
	};
}