All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros
kanzi::Renderbuffer Class Reference

Renderbuffers provide the images that can be rendered to by attaching them to the framebuffer as color or depth stencil images. More...

#include <kanzi/graphics_3d/renderbuffer.hpp>

Inheritance diagram for kanzi::Renderbuffer:
kanzi::Surface kanzi::GPUResource kanzi::Resource kanzi::Object

Public Member Functions

 Renderbuffer (Domain *domain, GraphicsFormat format, unsigned int sampleCount, unsigned int width, unsigned int height, unsigned int faceCount, unsigned int mipLevelCount)
 
virtual ~Renderbuffer () KZ_OVERRIDE
 
unsigned int getGLHandle (unsigned int face, unsigned int mipLevel) const
 
- Public Member Functions inherited from kanzi::Surface
GraphicsFormat getFormat () const
 Get GraphicsFormat of Surface. More...
 
unsigned int getSampleCount () const
 Get number multisample samples. 0 means multisampling is disabled. More...
 
unsigned int getWidth () const
 Get width in pixels. More...
 
unsigned int getHeight () const
 Get height in pixels. More...
 
unsigned int getSliceCount () const
 Get number of slices. More...
 
unsigned int getFaceCount () const
 Get number of faces. This should be six for cubemaps and one for everything else. More...
 
unsigned int getMipLevelCount () const
 Get number of mipmap levels. More...
 
bool isWellFormed () const
 Return true if Surface is valid shape and format. More...
 
virtual ~Surface () KZ_OVERRIDE
 
- Public Member Functions inherited from kanzi::GPUResource
virtual ~GPUResource () KZ_OVERRIDE
 
void deploy ()
 Make graphics API object(s) in the resource usable by preparing GPU objects and data in them. More...
 
void undeploy ()
 Free the GPU objects. After this, the resource is not usable for graphics API until deploy() is called again. More...
 
void invalidate ()
 Notify resource that graphics context was lost and all GPU resources are invalid. More...
 
unsigned int getGPUMemoryUsage () const
 
RenderergetRenderer () const
 
bool getDeployOnLoad () const
 Returns true if GPUResource is automatically deployed when loaded. More...
 
void setDeployOnLoad (bool value)
 Sets GPUResource automatic deployment on loade on or orr. More...
 
bool isDeployed () const
 
void deployed ()
 
void undeployed ()
 
virtual void loadFromKZB (const KzuResourceLoaderThreadContext *threadContext, KzcInputStream *inputStream, const KzuBinaryFileInfo *file) KZ_OVERRIDE
 Function for loading the resource from .KZB. More...
 
virtual void finishLoadingOverride (const KzuResourceLoaderThreadContext *threadContext) KZ_OVERRIDE
 Function for finishing the loading of the resource. More...
 
virtual void unloadOverride () KZ_OVERRIDE
 Unload function for resource. More...
 
virtual unsigned int getCPUMemoryUsage () const KZ_OVERRIDE
 Function for getting the memory usage of a resource. More...
 
- Public Member Functions inherited from kanzi::Resource
KzcMemoryManagergetMemoryManager () const
 
 Resource (Domain *domain, string_view name)
 
virtual ~Resource ()
 
void setKZB (const KzuBinaryDirectory *binaryDirectory, kzString path)
 
void setLoaded ()
 
kzString getName () const
 Accessor. More...
 
void load ()
 
void unload ()
 
bool isLoaded () const
 
void kzuResourceLoad_private (const KzuResourceLoaderThreadContext *threadContext)
 Private function for kzuResourceLoad() with specified thread context. More...
 
void kzuResourceFinishLoading_private (const KzuResourceLoaderThreadContext *threadContext)
 Private function for finishing the loading of the resource. More...
 
KzuResourceLoadingStrategy getLoadingStrategy () const
 
void setLoadingStrategy (KzuResourceLoadingStrategy loadingStrategy)
 
bool getKeepAlive () const
 Tells if the resource has keep alive flag set. More...
 
void setKeepAlive (bool keepAlive)
 Sets the keep alive flag. More...
 
- Public Member Functions inherited from kanzi::Object
 Object (Domain *domain)
 
virtual ~Object ()
 
DomaingetDomain () const
 Returns the domain the object belongs to. More...
 
KzuPropertyManager * getPropertyManager () const
 Returns the property manager of the object. More...
 
KzuTaskSchedulergetTaskScheduler () const
 Returns the task scheduler of the object. More...
 
KzuMessageDispatchergetMessageDispatcher () const
 Returns the message dispatcher of the object. More...
 
ResourceManagergetResourceManager () const
 Returns the resource manager of the object. More...
 
virtual const MetaclassgetDynamicMetaclass () const
 Returns the metaclass of the dynamic type of the object. More...
 
bool isTypeOf (const Metaclass *objectType) const
 Determines if the type of this object is the given type or derived from it. More...
 
template<typename DataType >
void setProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::DataType value)
 Sets the local value of a property. More...
 
void setProperty (const PropertyType< ResourceID > &propertyType, ResourceSharedPtr value)
 Sets the local value of a resource id property with a resource pointer. More...
 
template<typename DataType >
DataType getProperty (const PropertyType< DataType > &propertyType) const
 Returns the current value of a property. More...
 
template<typename DataType >
bool getProperty (const PropertyType< DataType > &propertyType, typename PropertyType< DataType >::DataType &value) const
 Evaluates the property value in the same way as the overload above but does not default to the value in property metadata if there are no inputs to the property value. More...
 
template<typename DataType >
void setAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::DataType value)
 
void setAbstractProperty (AbstractPropertyType abstractPropertyType, ResourceSharedPtr value)
 
template<typename DataType >
DataType getAbstractProperty (AbstractPropertyType abstractPropertyType) const
 
template<typename DataType >
bool getAbstractProperty (AbstractPropertyType abstractPropertyType, typename PropertyType< DataType >::DataType &value) const
 
bool hasValue (AbstractPropertyType propertyType) const
 Evaluates whether there are any inputs into the property value. More...
 
bool hasLocalValue (AbstractPropertyType propertyType) const
 Evaluates whether there is a local value set for the property. More...
 
void removeLocalValue (AbstractPropertyType propertyType)
 Removes the local value associated with the property. More...
 
void copyLocalValues (const Object &other)
 Copies all local values from another object. More...
 
virtual void onPropertyChanged (AbstractPropertyType propertyType, KzuPropertyNotificationReason reason)
 Virtual function to handle property change notifications. More...
 
AppliedStyleEntryapplyObjectStyle (kanzi::StyleSharedPtr style)
 Applies a style to an object. More...
 
void unapplyObjectStyle (AppliedStyleEntry *appliedStyleEntry)
 
void applyObjectStyles ()
 Apply all styles for an object node. More...
 
void unapplyObjectStyles ()
 Unapplies and removes all applied styles. More...
 

Static Public Member Functions

static RenderbufferSharedPtr create (Domain *domain, GraphicsFormat format, unsigned int sampleCount, unsigned int width, unsigned int height, unsigned int faceCount, unsigned int mipLevelCount)
 
- Static Public Member Functions inherited from kanzi::Object
static const MetaclassgetStaticMetaclass ()
 Returns the metaclass of Object class. More...
 
static
PropertyTypeEditorInfoSharedPtr 
makeEditorInfo ()
 Default implementation that returns empty editor info. More...
 

Protected Member Functions

virtual void invalidateOverride () KZ_OVERRIDE
 Notify resource that graphics context was lost and all GPU resources are invalid. Called by invalidate() More...
 
virtual void deployOverride () KZ_OVERRIDE
 Make graphics API object(s) in the resource usable by preparing GPU objects and data in them. Called by deploy() More...
 
virtual void undeployOverride () KZ_OVERRIDE
 Free the GPU objects. After this, the resource is not usable for graphics API until deploy() is called again. Called by undeploy() More...
 
virtual void freeCommonData () KZ_OVERRIDE
 Notify resource that graphics context was lost and all GPU resources are invalid. More...
 
virtual unsigned int getGPUMemoryUsageOverride () const KZ_OVERRIDE
 
virtual void attach (Framebuffer &framebuffer, APIAttachment apiAttachment, unsigned int face, unsigned int mipLevel) KZ_OVERRIDE
 
virtual bool isRenderable (unsigned int face, unsigned int mipLevel) const KZ_OVERRIDE
 
- Protected Member Functions inherited from kanzi::Surface
 Surface (Domain *domain, string_view name="")
 
unsigned int getGpuMemoryUsageEstimate () const
 
void configure (GraphicsFormat format, unsigned int sampleCount, unsigned int width, unsigned int height, unsigned int sliceCount, unsigned int faceCount, unsigned int mipLevelCount)
 Set format and shape for the Surface. More...
 
void setFaceCount (unsigned int value)
 
void setSliceCount (unsigned int value)
 
- Protected Member Functions inherited from kanzi::GPUResource
 GPUResource (Domain *domain, string_view name="")
 
- Protected Member Functions inherited from kanzi::Resource
KzuResourceLoadState getLoadState ()
 Access. More...
 
- Protected Member Functions inherited from kanzi::Object
void initialize ()
 
void onCopy (const Object &other)
 

Additional Inherited Members

- Public Types inherited from kanzi::Surface
enum  APIAttachment {
  APIAttachmentColor0, APIAttachmentColor1, APIAttachmentColor2, APIAttachmentColor3,
  APIAttachmentDepth, APIAttachmentStencil, APIAttachmentInvalid
}
 
- Protected Types inherited from kanzi::Object
typedef vector
< AppliedStyleEntry * > 
AppliedStyleContainer
 Applied style container. More...
 
- Protected Attributes inherited from kanzi::Object
AppliedStyleContainer m_appliedStyles
 Listing of applied styles applied to this object. More...
 

Detailed Description

Renderbuffers provide the images that can be rendered to by attaching them to the framebuffer as color or depth stencil images.

Unlike textures, you cannot access renderbuffers using the samplers from shaders. When you direct rendering to a framebuffer, the depth and stencil tests require either renderbuffer or texture attached to the framebuffer.

You can read the content of renderbuffers with the ReadPixels() function.

Constructor & Destructor Documentation

kanzi::Renderbuffer::Renderbuffer ( Domain domain,
GraphicsFormat  format,
unsigned int  sampleCount,
unsigned int  width,
unsigned int  height,
unsigned int  faceCount,
unsigned int  mipLevelCount 
)
explicit
virtual kanzi::Renderbuffer::~Renderbuffer ( )
virtual

Member Function Documentation

static RenderbufferSharedPtr kanzi::Renderbuffer::create ( Domain domain,
GraphicsFormat  format,
unsigned int  sampleCount,
unsigned int  width,
unsigned int  height,
unsigned int  faceCount,
unsigned int  mipLevelCount 
)
static
unsigned int kanzi::Renderbuffer::getGLHandle ( unsigned int  face,
unsigned int  mipLevel 
) const
virtual void kanzi::Renderbuffer::invalidateOverride ( )
protectedvirtual

Notify resource that graphics context was lost and all GPU resources are invalid. Called by invalidate()

Reimplemented from kanzi::GPUResource.

virtual void kanzi::Renderbuffer::deployOverride ( )
protectedvirtual

Make graphics API object(s) in the resource usable by preparing GPU objects and data in them. Called by deploy()

Reimplemented from kanzi::Surface.

virtual void kanzi::Renderbuffer::undeployOverride ( )
protectedvirtual

Free the GPU objects. After this, the resource is not usable for graphics API until deploy() is called again. Called by undeploy()

Reimplemented from kanzi::GPUResource.

virtual void kanzi::Renderbuffer::freeCommonData ( )
protectedvirtual

Notify resource that graphics context was lost and all GPU resources are invalid.

Reimplemented from kanzi::Surface.

virtual unsigned int kanzi::Renderbuffer::getGPUMemoryUsageOverride ( ) const
protectedvirtual

Reimplemented from kanzi::GPUResource.

virtual void kanzi::Renderbuffer::attach ( Framebuffer framebuffer,
APIAttachment  apiAttachment,
unsigned int  face,
unsigned int  mipLevel 
)
protectedvirtual

Implements kanzi::Surface.

virtual bool kanzi::Renderbuffer::isRenderable ( unsigned int  face,
unsigned int  mipLevel 
) const
protectedvirtual

Implements kanzi::Surface.


The documentation for this class was generated from the following file: