Represents a render-target to which cameras can render images. More...
#include <ignition/rendering/RenderTarget.hh>
Public Member Functions | |
virtual | ~RenderTarget () |
Destructor. More... | |
virtual void | AddRenderPass (const RenderPassPtr &_pass)=0 |
Add a render pass to the render target. More... | |
virtual math::Color | BackgroundColor () const =0 |
Get the background color of the render target. This should be the same as the scene background color. More... | |
virtual void | Copy (Image &_image) const =0 |
Write rendered image to given Image. The RenderTarget will convert the underlying image to the specified format listed in the given Image. However if the given image is not of the correct size no work will be done. Calling this function before an image has been rendered will result in undefined behavior. More... | |
virtual PixelFormat | Format () const =0 |
Set the render target image format. More... | |
virtual unsigned int | Height () const =0 |
Get render target height in pixels. More... | |
virtual void | RemoveRenderPass (const RenderPassPtr &_pass)=0 |
Remove a render pass from the render target. More... | |
virtual RenderPassPtr | RenderPassByIndex (unsigned int _index) const =0 |
Get a render pass by index. More... | |
virtual unsigned int | RenderPassCount () const =0 |
Get the number of render passes applied to the render target. More... | |
virtual void | SetFormat (PixelFormat _format)=0 |
Set the render target image format. More... | |
virtual void | SetHeight (const unsigned int _height)=0 |
Set the render target height in pixels. More... | |
virtual void | SetWidth (const unsigned int _width)=0 |
Set the render target width in pixels. More... | |
virtual unsigned int | Width () const =0 |
Get render target width in pixels. More... | |
Public Member Functions inherited from Object | |
virtual | ~Object () |
Destructor. More... | |
virtual void | Destroy ()=0 |
Destroy any resources associated with this object. Invoking any other functions after destroying an object will result in undefined behavior. More... | |
virtual unsigned int | Id () const =0 |
Get the object ID. This ID will be unique across all objects inside a given scene, but necessarily true for objects across different scenes. More... | |
virtual std::string | Name () const =0 |
Get the object name. This name will be unique across all objects inside a given scene, but necessarily true for objects across different scenes. More... | |
virtual void | PostRender ()=0 |
Post process this object and any of its children after rendering. More... | |
virtual void | PreRender ()=0 |
Prepare this object and any of its children for rendering. This should be called for each object in a scene just before rendering, which can be achieved by a single call to Scene::PreRender. More... | |
virtual ScenePtr | Scene () const =0 |
Get the Scene that created this object. More... | |
Detailed Description
Represents a render-target to which cameras can render images.
Constructor & Destructor Documentation
◆ ~RenderTarget()
|
inlinevirtual |
Destructor.
Member Function Documentation
◆ AddRenderPass()
|
pure virtual |
Add a render pass to the render target.
- Parameters
-
[in] _pass New render pass to add
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::AddRenderPass().
◆ BackgroundColor()
|
pure virtual |
Get the background color of the render target. This should be the same as the scene background color.
- Returns
- Render target background color.
Implemented in Ogre2RenderTarget, BaseRenderTarget< T >, and OgreRenderTarget.
◆ Copy()
|
pure virtual |
Write rendered image to given Image. The RenderTarget will convert the underlying image to the specified format listed in the given Image. However if the given image is not of the correct size no work will be done. Calling this function before an image has been rendered will result in undefined behavior.
- Parameters
-
[out] _image Image to which output will be written
Implemented in Ogre2RenderTarget, and OgreRenderTarget.
Referenced by BaseCamera< OgreSensor >::Copy().
◆ Format()
|
pure virtual |
Set the render target image format.
- Returns
- Render target format
Implemented in BaseRenderTarget< T >.
Referenced by BaseCamera< OgreSensor >::ImageFormat().
◆ Height()
|
pure virtual |
Get render target height in pixels.
- Returns
- The Render target height in pixels
Implemented in BaseRenderTarget< T >.
Referenced by BaseCamera< OgreSensor >::ImageHeight().
◆ RemoveRenderPass()
|
pure virtual |
Remove a render pass from the render target.
- Parameters
-
[in] _pass render pass to remove
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::RemoveRenderPass().
◆ RenderPassByIndex()
|
pure virtual |
Get a render pass by index.
- Returns
- Render pass at the specified index
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::RenderPassByIndex().
◆ RenderPassCount()
|
pure virtual |
Get the number of render passes applied to the render target.
- Returns
- Number of render passes applied
Implemented in BaseRenderTarget< T >.
Referenced by BaseCamera< OgreSensor >::RenderPassCount().
◆ SetFormat()
|
pure virtual |
Set the render target image format.
- Parameters
-
[in] _format New target format
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::SetImageFormat().
◆ SetHeight()
|
pure virtual |
Set the render target height in pixels.
- Parameters
-
[in] _height New render target height in pixels
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::SetImageHeight().
◆ SetWidth()
|
pure virtual |
Set the render target width in pixels.
- Parameters
-
[in] _width New render target width in pixels
Implemented in BaseRenderTarget< T >, BaseRenderTarget< Ogre2Object >, and BaseRenderTarget< OgreObject >.
Referenced by BaseCamera< OgreSensor >::SetImageWidth().
◆ Width()
|
pure virtual |
Get render target width in pixels.
- Returns
- The render target width in pixels
Implemented in BaseRenderTarget< T >.
Referenced by BaseCamera< OgreSensor >::ImageWidth().
The documentation for this class was generated from the following file: