Maria GDK 5.0.0.738
Documentation of native code in develop branch
Loading...
Searching...
No Matches
STK::IconRenderItem Class Referencefinal
Inheritance diagram for STK::IconRenderItem:
STK::RenderItem2D

Public Member Functions

 IconRenderItem (std::shared_ptr< STK::Texture > texture, const Vector2f textureSize, Vector2f textureOffset={0.5, 0.5})
 
 IconRenderItem (const IconRenderItem &icon)
 
void render (GraphicsRender2D &renderer, const STK::Matrix4x4f &pj, const STK::Matrix4x4f &vm, const STK::Viewport &vp) override
 
int getBatchId () const override
 
const STK::Matrix4x4fgetIconTransform ()
 
std::shared_ptr< STK::TexturegetTexture () const
 
const Vector2fgetTextureOffset () const
 
void setTextureOffset (Vector2f offset)
 
void setTextureOffset (float x, float y)
 
void setIconOffset (Vector2f offset)
 
void setIconOffset (const float x, const float y)
 
void setTextureCoordTransform (const Vector4f &transform)
 
const Vector4fgetTextureCoordTransform () const
 
const Vector2fgetIconOffset () const
 
Vector2f getIconOffset ()
 
const Vector2fgetTextureSize () const
 
void setTextureSize (Vector2f size)
 
void setTextureSize (float w, float h)
 
void cleanupBuffers () override
 
void setColor (const STK::Color4f &color)
 
const STK::Color4fgetColor () const
 
void setKeepUpright (bool keep_upright)
 
bool keepUpright () const
 
void updateViewportScaling (const STK::Matrix4x4f &vm)
 
void setIconBoundingBox (std::optional< OrientedBoundingBox2f > bbox)
 
std::optional< OrientedBoundingBox2fgetIconBoundingBox () const
 
virtual STK::Box2< float > getViewBoundingBox (const STK::Matrix4x4f &mvp, const STK::Viewport &glVp, bool reverse_y=false) override
 Get bounding box in viewport pixel coordinates.
 
- Public Member Functions inherited from STK::RenderItem2D
virtual void render (GraphicsRender2D &renderer, const STK::Matrix4x4f &pj, const STK::Matrix4x4f &vm, const STK::Viewport &vp)=0
 
virtual void cleanupBuffers ()=0
 
virtual int getBatchId () const =0
 
void setDepth (float depth)
 
float getDepth () const
 
void setStencilValue (unsigned char stencil_value)
 Set value for stencil operations.
 
unsigned char getStencilValue () const
 Get value for stencil operations.
 
void setStencilMode (StencilMode mode)
 Stencil buffer operations.
 
StencilMode getStencilMode () const
 Stencil buffer operations.
 
const STK::Matrix4x4fgetTransform ()
 
void setPosition (float x, float y)
 Set 2D position of the item. This method will invalidate the transform and cause it to be recalculated on the next frame.
 
void setPosition (const STK::Vector2f &pos)
 Same as above.
 
void setPositionX (float x)
 Set X position separately.
 
void setPositionY (float y)
 Set Y position separately.
 
const STK::Vector2fgetPosition () const
 
float getPositionX () const
 
float getPositionY () const
 
void setScale (const STK::Vector2f &scale)
 
void setScale (float scale)
 Set scale factor for the text item. This method will invalidate the transform and cause it to be recalculated on the next frame.
 
STK::Vector2f getScale () const
 Returns current scale factor for the item.
 
void setAngle (float angle)
 Set rotation angle for the item. Positive rotation direction is counter-clockwise. This method will invalidate the transform and cause it to be recalculated on the next frame.
 
float getAngle () const
 
void setTransform (const STK::Matrix4x4f &transform)
 Set transform directly. This method will set the transformation matrix for this item directly. This will override any values for setPosition(), setScale(), setDepth() and setAngle(). Also, any subsequent calls to these methods will again override this method. In short, either use setTransform() or setPosition/Scale/Angle/Depth.
 
void setPreTransform (const STK::Matrix4x4f &transform)
 
void setPostTransform (const STK::Matrix4x4f &transform)
 
std::optional< STK::Matrix4x4fgetPreTransform () const
 
std::optional< STK::Matrix4x4fgetPostTransform () const
 
void setOpacity (float opacity)
 
float getOpacity () const
 
virtual STK::Box2< float > getViewBoundingBox (const STK::Matrix4x4f &mvp, const STK::Viewport &glVp, bool reverse_y=false)=0
 Get bounding box in viewport pixel coordinates.
 

Protected Member Functions

void updateTransform () override
 
void setViewportScale (const float scale)
 
- Protected Member Functions inherited from STK::RenderItem2D
virtual void updateTransform ()
 
void setViewScale (float x, float y)
 

Additional Inherited Members

- Protected Attributes inherited from STK::RenderItem2D
float depth_ = 0
 
STK::Matrix4x4f transform_
 
STK::Vector2f pos_
 
float angle_ = 0.0f
 
float opacity_ = 1.0f
 
STK::Vector2f scale_ { 1.0f, 1.0f }
 
bool transform_dirty_ = false
 
std::optional< STK::Matrix4x4fpre_transform_
 
std::optional< STK::Matrix4x4fpost_transform_
 
std::mutex xfm_mutex_
 
unsigned char stencil_value_ = 0
 
StencilMode stencil_mode_ = StencilMode::NONE
 
float view_scale_x_ = 1.0f
 
float view_scale_y_ = 1.0f
 

Member Function Documentation

◆ cleanupBuffers()

void IconRenderItem::cleanupBuffers ( )
overridevirtual

Clean up OpenGL graphics objects This method should clean up all OpenGL related buffers and objects. This is normally called by GraphicsRender2D::cleanup()

Implements STK::RenderItem2D.

◆ getBatchId()

int IconRenderItem::getBatchId ( ) const
overridevirtual

Render batch id. This number indicates which item should be rendered together if the depths are equal.

Implements STK::RenderItem2D.

◆ getViewBoundingBox()

STK::Box2< float > STK::IconRenderItem::getViewBoundingBox ( const STK::Matrix4x4f mvp,
const STK::Viewport glVp,
bool  reverse_y = false 
)
overridevirtual

Get bounding box in viewport pixel coordinates.

Parameters
mvpProjection/Modelview matrix.
glVpOpenGL viewport
reverse_yIf true, any pixel coordinate calculations are using positive y direction downwards. This applies for example to text and icon items which have separate pixel coordinate transforms.
Returns
Min/Max coordinates for the object in pixel coordinates.

Implements STK::RenderItem2D.

◆ render()

void IconRenderItem::render ( GraphicsRender2D renderer,
const STK::Matrix4x4f pj,
const STK::Matrix4x4f vm,
const STK::Viewport vp 
)
overridevirtual

Render item into the current frame. This method should render a single item into the GraphicsRender2D.

Implements STK::RenderItem2D.

◆ setIconOffset() [1/2]

void STK::IconRenderItem::setIconOffset ( const float  x,
const float  y 
)
inline

It is important to note, that this is in OpenGL pixel coordinates, where positive Y is upwards.

◆ setIconOffset() [2/2]

void STK::IconRenderItem::setIconOffset ( Vector2f  offset)
inline

Set the icon offset in pixels from the center of the It is important to note, that this is in OpenGL pixel coordinates, where positive Y is upwards.

◆ updateTransform()

void IconRenderItem::updateTransform ( )
overrideprotectedvirtual

Reimplemented from STK::RenderItem2D.


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