This page has been translated automatically.
Video Tutorials
Interface
Essentials
Advanced
How To
Professional (SIM)
UnigineEditor
Interface Overview
Assets Workflow
Settings and Preferences
Working With Projects
Adjusting Node Parameters
Setting Up Materials
Setting Up Properties
Lighting
Sandworm
Using Editor Tools for Specific Tasks
Extending Editor Functionality
Built-in Node Types
Nodes
Objects
Effects
Decals
Light Sources
Geodetics
World Nodes
Sound Objects
Pathfinding Objects
Players
Programming
Fundamentals
Setting Up Development Environment
Usage Examples
C++
C#
UnigineScript
UUSL (Unified UNIGINE Shader Language)
Plugins
File Formats
Materials and Shaders
Rebuilding the Engine Tools
GUI
Double Precision Coordinates
API
Containers
Common Functionality
Controls-Related Classes
Engine-Related Classes
Filesystem Functionality
GUI-Related Classes
Math Functionality
Node-Related Classes
Objects-Related Classes
Networking Functionality
Pathfinding-Related Classes
Physics-Related Classes
Plugins-Related Classes
IG Plugin
CIGIConnector Plugin
Content Creation
Content Optimization
Materials
Material Nodes Library
Miscellaneous
Input
Math
Matrix
Textures
Art Samples
Tutorials
Warning! This version of documentation is OUTDATED, as it describes an older SDK version! Please switch to the documentation for the latest SDK version.
Warning! This version of documentation describes an old SDK version which is no longer supported! Please upgrade to the latest SDK version.

Unigine::RenderTarget Class

Header: #include <UnigineTextures.h>

A container to which an image is rendered (a framebuffer abstraction).

RenderTarget Class

Members


static RenderTargetPtr create ( ) #

Constructor. Creates a new render target.

void destroy ( ) #

Destroys the render target.

void enable ( ) #

Enables the render target.

void enableCompute ( ) #

Enables the render target with the use of compute shader output.

void disable ( ) #

Disables the render target.

void flush ( ) #

Flushes the render target.

Ptr<Texture> getColorTexture ( int slot ) const#

Returns a color texture by the specified slot.

Arguments

  • int slot - Texture slot.

Return value

Color texture if it exists, otherwise nullptr.

void bindColorTexture ( int slot, const Ptr<Texture> & texture ) #

Binds all layers and faces (if supported by the texture type) of a texture on the 0 mip level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Color texture to be bound.

void bindColorTexture2D ( int slot, const Ptr<Texture> & texture, int mip = 0 ) #

Binds the specified slot of a 2D texture on the specified mipmap level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - 2D color texture to be bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindColorTexture2DArray ( int slot, const Ptr<Texture> & texture, int layer = -1, int mip = 0 ) #

Binds the specified slot and layer of a 2D texture array on the specified mipmap level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - 2D color texture array to be bound.
  • int layer - Number of the 2D texture array layer. With the default value of -1, all layers of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindColorTextureCube ( int slot, const Ptr<Texture> & texture, int face = -1, int mip = 0 ) #

Binds the specified slot and face of a texture cube on the specified mipmap level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Color texture cube to be bound.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindColorTextureCubeArray ( int slot, const Ptr<Texture> & texture, int layer = -1, int face = -1, int mip = 0 ) #

Binds the specified layer and face of a texture cube array on the specified mipmap level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Color cube array texture to be bound.
  • int layer - Number of the texture cube array layer. With the default value of -1, all layers of the texture on a specified mip level are bound.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindColorTexture3D ( int slot, const Ptr<Texture> & texture, int depth = -1, int mip = 0 ) #

Binds the specified depth layer of a 3D texture on the specified mipmap level to the specified slot as render target.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - 3D Color texture to be bound.
  • int depth - 3D texture depth layer. With the default value of -1, all depth layers of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void unbindColorTexture ( int slot ) #

Unbinds a render target texture from the specified slot.

Arguments

  • int slot - Texture slot.

void unbindColorTextures ( ) #

Unbinds all render target textures from a render target.

Ptr<Texture> getDepthTexture ( ) const#

Returns the depth texture.

Return value

Depth texture if it exists, otherwise nullptr.

void bindDepthTexture ( const Ptr<Texture> & texture ) #

Binds all layers and faces (if supported by the texture type) of a texture on the 0 mip level to the specified slot as depth target.

Arguments

  • const Ptr<Texture> & texture - Depth texture to be bound.

void bindDepthTexture2D ( const Ptr<Texture> & texture, int mip = 0 ) #

Binds a 2D depth texture on the specified mipmap level as depth target.

Arguments

void bindDepthTexture2DArray ( const Ptr<Texture> & texture, int layer = -1, int mip = 0 ) #

Binds the specified layer of a depth texture on the specified mipmap level as depth target.

Arguments

  • const Ptr<Texture> & texture - 2D depth texture array to be bound.
  • int layer - Number of the 2D depth texture array layer. With the default value of -1, all layers of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindDepthTextureCube ( const Ptr<Texture> & texture, int face = -1, int mip = 0 ) #

Binds the specified face of a depth texture cube on the specified mipmap level as depth target.

Arguments

  • const Ptr<Texture> & texture - Depth texture cube to be bound.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindDepthTextureCubeArray ( const Ptr<Texture> & texture, int layer = -1, int face = -1, int mip = 0 ) #

Binds the specified layer and face of a depth texture cube array on the specified mipmap level as depth target.

Arguments

  • const Ptr<Texture> & texture - Depth texture cube array to be bound.
  • int layer - Number of the texture cube array layer. With the default value of -1, all layers of the texture on a specified mip level are bound.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void unbindDepthTexture ( ) #

Unbinds a depth texture from a depth target.

Ptr<Texture> getUnorderedAccessTexture ( int slot ) const#

Returns an unordered access texture by the specified slot.

Arguments

  • int slot - Texture slot.

Return value

Unordered access texture if it exists, otherwise nullptr.

void bindUnorderedAccessTexture ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false ) #

Binds all layers and faces (if supported by the texture type) of a texture on the 0 mip level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access texture to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.

void bindUnorderedAccessTexture2D ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false, int mip = 0 ) #

Binds a 2D texture on the specified mipmap level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access 2D texture to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindUnorderedAccessTexture2DArray ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false, int layer = -1, int mip = 0 ) #

Binds the specified layer of a 2D texture array on the specified mipmap level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access 2D texture array to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.
  • int layer - Number of the 2D texture array layer. With the default value of -1, all layers of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindUnorderedAccessTextureCube ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false, int face = -1, int mip = 0 ) #

Binds the specified face of a texture cube on the specified mipmap level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access texture cube to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindUnorderedAccessTextureCubeArray ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false, int layer = -1, int face = -1, int mip = 0 ) #

Binds the specified layer and face of a texture cube on the specified mipmap level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access texture cube array to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.
  • int layer - Number of the texture cube array layer.
  • int face - The face of the cube. With the default value of -1, all faces of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void bindUnorderedAccessTexture3D ( int slot, const Ptr<Texture> & texture, bool writeonly = false, bool atomic = false, int depth = -1, int mip = 0 ) #

Binds the specified layer of a 3D texture on the specified mipmap level to the specified slot for unordered access.

Arguments

  • int slot - Texture slot.
  • const Ptr<Texture> & texture - Unordered access 3D texture to be bound.
  • bool writeonly - Access flag. true to use the texture for writing only, otherwise false.
  • bool atomic - Set true to bind the texture with the GL_32UI format; otherwise — false. This flag is to be set for OpenGL only.
  • int depth - 3D texture depth layer. With the default value of -1, all depth layers of the texture on a specified mip level are bound.
  • int mip - Mipmap level number in the range from 0 to the total number of mipmaps.

void unbindUnorderedAccessTexture ( int slot ) #

Unbinds an unordered access texture from the specified slot.

Arguments

  • int slot - Texture slot.

void unbindUnorderedAccessTextures ( ) #

Unbinds all unordered access textures for unordered access resources.

Ptr<StructuredBuffer> getStructuredBuffer ( int slot ) const#

Returns a structured buffer by the specified slot.

Arguments

  • int slot - Texture slot.

Return value

Structured buffer if it exists, otherwise nullptr.

void bindStructuredBuffer ( int slot, const Ptr<StructuredBuffer> & buffer ) #

Binds a structured buffer to a device by the specified slot.

Arguments

void unbindStructuredBuffer ( int slot ) #

Unbinds a structured buffer for unordered access resources.

Arguments

  • int slot - Texture slot.

void unbindStructuredBuffers ( ) #

Unbinds all structured buffers for unordered access resources.

bool isEnabled ( ) const#

Returns a value indicating if the render target is enabled.

Return value

1 if the render target is enabled, otherwise 0.

bool isCompleted ( ) const#

Returns a value indicating if the render target is completed.

Return value

1 if the render target is completed, otherwise 0.

void unbindAll ( ) #

Unbinds all color, depth, and unordered access textures as well as structured buffers.
Last update: 2022-10-10
Build: ()