NAP
Public Member Functions | Public Attributes | List of all members
CubeMapFromFile Class Reference

#include <cubemapfromfile.h>

Public Member Functions

 CubeMapFromFile (Core &core)
 
virtual bool init (utility::ErrorState &errorState) override
 
- Public Member Functions inherited from EquiRectangularCubeMap
virtual ~EquiRectangularCubeMap () override
 
 EquiRectangularCubeMap (Core &core)
 
virtual bool init (nap::Texture2D &equiRectangularTexture, utility::ErrorState &errorState)
 
Texture2DgetSourceTexture ()
 
const Texture2DgetSourceTexture () const
 
virtual void onDestroy ()
 
- Public Member Functions inherited from RenderTextureCube
 RenderTextureCube (Core &core)
 
virtual bool init (bool enableMips, utility::ErrorState &errorState)
 
- Public Member Functions inherited from TextureCube
 TextureCube (Core &core)
 
virtual ~TextureCube () override
 
bool init (const SurfaceDescriptor &descriptor, int mipCount, const glm::vec4 &clearColor, VkImageUsageFlags requiredFlags, utility::ErrorState &errorState)
 
const glm::vec2 getSize () const
 
int getWidth () const
 
int getHeight () const
 
virtual uint getLayerCount () const override
 
virtual uint getMipLevels () const override
 
virtual const ImageDatagetHandle () const override
 
virtual ImageDatagetHandle () override
 
bool init (const SurfaceDescriptor &descriptor, bool mipCount, const glm::vec4 &clearColor, VkImageUsageFlags requiredFlags, utility::ErrorState &errorState)=delete
 
- Public Member Functions inherited from Texture
 Texture (Core &core)
 
virtual ~Texture ()
 
VkFormat getFormat () const
 
const SurfaceDescriptorgetDescriptor () const
 
RenderServicegetRenderService ()
 
const RenderServicegetRenderService () const
 
- Public Member Functions inherited from Resource
 Resource ()
 
- Public Member Functions inherited from Object
 Object ()
 
virtual ~Object ()
 
 Object (Object &)=delete
 
Objectoperator= (const Object &)=delete
 
 Object (Object &&)=delete
 
Objectoperator= (Object &&)=delete
 

Public Attributes

std::string mImagePath
 Property: 'ImagePath' Path to the image on disk to load. More...
 
- Public Attributes inherited from EquiRectangularCubeMap
bool mSampleShading = false
 Property: 'SampleShading' Reduces texture aliasing when cubemap is generated, at higher computational cost. More...
 
bool mGenerateLods
 Property: 'GenerateLODs' whether to create mip-maps when the cubemap is generated. More...
 
- Public Attributes inherited from RenderTextureCube
int mWidth = 1024
 Property: 'Width' width of a cube face texture in texels. More...
 
int mHeight = 1024
 Property: 'Height' of a cube face texture in texels. More...
 
EColorSpace mColorSpace = EColorSpace::Linear
 Property: 'ColorSpace' texture color space. More...
 
EFormat mColorFormat = EFormat::RGBA8
 Property: 'ColorFormat' color texture format. More...
 
RGBAColorFloat mClearColor = { 0.0f, 0.0f, 0.0f, 0.0f }
 Property: 'ClearColor' color selection used for clearing the texture. More...
 
- Public Attributes inherited from Texture
nap::Signal textureDestroyed
 Signal that is triggered before texture is destroyed. More...
 
- Public Attributes inherited from Object
std::string mID
 Property: 'mID' unique name of the object. Used as an identifier by the system. More...
 

Additional Inherited Members

- Public Types inherited from RenderTextureCube
enum  EFormat {
  RGBA8, BGRA8, R8, RGBA16,
  R16, RGBA32, R32
}
 
- Static Public Member Functions inherited from Object
static bool isIDProperty (rtti::Instance &object, const rtti::Property &property)
 
- Static Public Attributes inherited from TextureCube
static constexpr const uint layerCount = 6
 
- Protected Member Functions inherited from Texture
virtual void clear (VkCommandBuffer commandBuffer)
 
void requestClear ()
 
- Protected Attributes inherited from EquiRectangularCubeMap
RenderAdvancedServicemRenderAdvancedService = nullptr
 
- Protected Attributes inherited from TextureCube
ImageData mImageData = { TextureCube::layerCount }
 Cube Texture vulkan image buffers. More...
 
uint32 mMipLevels = 1
 Total number of generated mip-maps. More...
 
- Protected Attributes inherited from Texture
RenderServicemRenderService
 Reference to the render service. More...
 
SurfaceDescriptor mDescriptor
 Texture description. More...
 
VkFormat mFormat = VK_FORMAT_UNDEFINED
 Vulkan texture format. More...
 
VkClearColorValue mClearColor = { 0.0f, 0.0f, 0.0f, 0.0f }
 Color used for clearing the texture. More...
 

Description

Creates a 6 face cubemap from an equirectangular image loaded from disk.

This object must be pre-rendered at least once in a headless render pass in the first frame. The RenderAdvanced service queues a headless RenderService::RenderCommand for each nap::CubeMapFromFile in the scene after resource initialization, and will be handled when headless render commands are recorded. The code below only begins a headless recording operation only when headless commands are queued in the render service.

{
// Handles `nap::CubeMapFromFile` pre-render operations in the first frame
}
Inheritance diagram for CubeMapFromFile:
[legend]
Collaboration diagram for CubeMapFromFile:
[legend]

Constructor & Destructor Documentation

◆ CubeMapFromFile()

CubeMapFromFile ( Core core)

Member Function Documentation

◆ init()

virtual bool init ( utility::ErrorState errorState)
overridevirtual

Loads the equirectangular image from disk and schedules the conversion to a 6 face cubemap on the GPU.

Parameters
errorStatecontains the error when initialization fails
Returns
true when successful, otherwise false.

Reimplemented from RenderTextureCube.

Member Data Documentation

◆ mImagePath

std::string mImagePath

Property: 'ImagePath' Path to the image on disk to load.

nap::RenderService::isHeadlessCommandQueued
bool isHeadlessCommandQueued() const
Definition: renderservice.h:645
nap::RenderService::beginHeadlessRecording
bool beginHeadlessRecording()
nap::RenderService::endHeadlessRecording
void endHeadlessRecording()
nap::Texture::mRenderService
RenderService & mRenderService
Reference to the render service.
Definition: texture.h:104