149 lines
6.8 KiB
C++
149 lines
6.8 KiB
C++
// Copyright (c) 2012-2021 Wojciech Figat. All rights reserved.
|
|
|
|
#pragma once
|
|
|
|
#include "PixelFormat.h"
|
|
#include "RenderView.h"
|
|
#include "Engine/Scripting/ScriptingType.h"
|
|
|
|
class Model;
|
|
class SkinnedModel;
|
|
struct RenderContext;
|
|
|
|
PACK_STRUCT(struct QuadShaderData
|
|
{
|
|
Vector4 Color;
|
|
});
|
|
|
|
/// <summary>
|
|
/// Set of utilities for rendering.
|
|
/// </summary>
|
|
API_CLASS(Static) class RenderTools
|
|
{
|
|
DECLARE_SCRIPTING_TYPE_NO_SPAWN(RenderTools);
|
|
public:
|
|
|
|
// Calculate a subresource index for a texture
|
|
FORCE_INLINE static int32 CalcSubresourceIndex(uint32 mipSlice, int32 arraySlice, int32 mipLevels)
|
|
{
|
|
return mipSlice + arraySlice * mipLevels;
|
|
}
|
|
|
|
/// <summary>
|
|
/// Computes the feature level for the given shader profile.
|
|
/// </summary>
|
|
/// <param name="profile">The shader profile.</param>
|
|
/// <returns>The feature level matching the given shader profile.</returns>
|
|
static FeatureLevel GetFeatureLevel(ShaderProfile profile);
|
|
|
|
/// <summary>
|
|
/// Check if the given shader profile supports the tessellation. Runtime can reject tessellation support but it defines if given shader profile CAN support tessellation.
|
|
/// </summary>
|
|
/// <param name="profile">The profile.</param>
|
|
/// <returns>True if can support tessellation shaders, otherwise false.</returns>
|
|
static bool CanSupportTessellation(ShaderProfile profile);
|
|
|
|
/// <summary>
|
|
/// Computes the image row pitch in bytes, and the slice pitch (size in bytes of the image) based on format, width, and height.
|
|
/// </summary>
|
|
/// <param name="format">The pixel format of the surface.</param>
|
|
/// <param name="width">The surface width.</param>
|
|
/// <param name="height">The surface height.</param>
|
|
/// <param name="rowPitch">The number of bytes in a scanline of pixels in the image. A standard pitch is 'byte' aligned and therefore it is equal to bytes-per-pixel * width-of-image. For block-compressed (BC) formats, this is the number of bytes in a row of blocks (which covers up to 4 scanlines at once). The rowPitch can be larger than the number of valid pixels in the image due to alignment padding.</param>
|
|
/// <param name="slicePitch">For volume (3D) textures, slicePitch is the number of bytes in each depth slice. For 1D and 2D images, this is simply the total size of the image including any alignment padding.</param>
|
|
static void ComputePitch(PixelFormat format, int32 width, int32 height, uint32& rowPitch, uint32& slicePitch);
|
|
|
|
public:
|
|
|
|
static void UpdateModelLODTransition(byte& lodTransition);
|
|
|
|
/// <summary>
|
|
/// Computes the bounds screen radius squared.
|
|
/// </summary>
|
|
/// <param name="origin">The bounds origin.</param>
|
|
/// <param name="radius">The bounds radius.</param>
|
|
/// <param name="view">The render view.</param>
|
|
/// <returns>The squared radius.</returns>
|
|
FORCE_INLINE static float ComputeBoundsScreenRadiusSquared(const Vector3& origin, const float radius, const RenderView& view)
|
|
{
|
|
return ComputeBoundsScreenRadiusSquared(origin, radius, view.Position, view.Projection);
|
|
}
|
|
|
|
/// <summary>
|
|
/// Computes the bounds screen radius squared.
|
|
/// </summary>
|
|
/// <param name="origin">The bounds origin.</param>
|
|
/// <param name="radius">The bounds radius.</param>
|
|
/// <param name="viewOrigin">The render view position.</param>
|
|
/// <param name="projectionMatrix">The render view projection matrix.</param>
|
|
/// <returns>The squared radius.</returns>
|
|
static float ComputeBoundsScreenRadiusSquared(const Vector3& origin, float radius, const Vector3& viewOrigin, const Matrix& projectionMatrix);
|
|
|
|
/// <summary>
|
|
/// Computes the model LOD index to use during rendering.
|
|
/// </summary>
|
|
/// <param name="model">The model.</param>
|
|
/// <param name="origin">The bounds origin.</param>
|
|
/// <param name="radius">The bounds radius.</param>
|
|
/// <param name="renderContext">The rendering context.</param>
|
|
/// <returns>The zero-based LOD index. Returns -1 if model should not be rendered.</returns>
|
|
API_FUNCTION() static int32 ComputeModelLOD(const Model* model, API_PARAM(Ref) const Vector3& origin, float radius, API_PARAM(Ref) const RenderContext& renderContext);
|
|
|
|
/// <summary>
|
|
/// Computes the skinned model LOD index to use during rendering.
|
|
/// </summary>
|
|
/// <param name="model">The skinned model.</param>
|
|
/// <param name="origin">The bounds origin.</param>
|
|
/// <param name="radius">The bounds radius.</param>
|
|
/// <param name="renderContext">The rendering context.</param>
|
|
/// <returns>The zero-based LOD index. Returns -1 if model should not be rendered.</returns>
|
|
API_FUNCTION() static int32 ComputeSkinnedModelLOD(const SkinnedModel* model, API_PARAM(Ref) const Vector3& origin, float radius, API_PARAM(Ref) const RenderContext& renderContext);
|
|
};
|
|
|
|
// Get texture memory usage
|
|
// @param format Surface pixels format type
|
|
// @param width Width in pixels
|
|
// @param height Height in pixels
|
|
// @param mipLevels Amount of mip levels
|
|
// @returns Memory usage in bytes
|
|
extern uint64 CalculateTextureMemoryUsage(PixelFormat format, int32 width, int32 height, int32 mipLevels);
|
|
|
|
// Get texture memory usage
|
|
// @param format Surface pixels format type
|
|
// @param width Width in pixels
|
|
// @param height Height in pixels
|
|
// @param depth Depth in pixels
|
|
// @param mipLevels Amount of mip levels
|
|
// @returns Memory usage in bytes
|
|
extern uint64 CalculateTextureMemoryUsage(PixelFormat format, int32 width, int32 height, int32 depth, int32 mipLevels);
|
|
|
|
// Calculate mip levels count for a texture 1D
|
|
// @param width Most detailed mip width
|
|
// @param useMipLevels True if use mip levels, otherwise false (use only 1 mip)
|
|
// @returns Mip levels count
|
|
extern int32 MipLevelsCount(int32 width, bool useMipLevels = true);
|
|
|
|
// Calculate mip levels count for a texture 2D
|
|
// @param width Most detailed mip width
|
|
// @param height Most detailed mip height
|
|
// @param useMipLevels True if use mip levels, otherwise false (use only 1 mip)
|
|
// @returns Mip levels count
|
|
extern int32 MipLevelsCount(int32 width, int32 height, bool useMipLevels = true);
|
|
|
|
// Calculate mip levels count for a texture 3D
|
|
// @param width Most detailed mip width
|
|
// @param height Most detailed mip height
|
|
// @param depth Most detailed mip depths
|
|
// @param useMipLevels True if use mip levels, otherwise false (use only 1 mip)
|
|
// @returns Mip levels count
|
|
extern int32 MipLevelsCount(int32 width, int32 height, int32 depth, bool useMipLevels = true);
|
|
|
|
/// <summary>
|
|
/// Calculate distance from view center to the sphere center less sphere radius, clamped to fit view far plane
|
|
/// </summary>
|
|
/// <param name="view">Render View</param>
|
|
/// <param name="center">Sphere center</param>
|
|
/// <param name="radius">Sphere radius</param>
|
|
/// <returns>Distance from view center to the sphere center less sphere radius</returns>
|
|
extern float ViewToCenterLessRadius(const RenderView& view, const Vector3& center, float radius);
|