mirror of https://github.com/minetest/irrlicht.git
83 lines
2.9 KiB
C++
83 lines
2.9 KiB
C++
// Copyright (C) 2002-2012 Nikolaus Gebhardt
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#pragma once
|
|
|
|
#include "IGUIElement.h"
|
|
|
|
namespace irr
|
|
{
|
|
namespace video
|
|
{
|
|
class ITexture;
|
|
}
|
|
namespace gui
|
|
{
|
|
//! GUI element displaying an image.
|
|
class IGUIImage : public IGUIElement
|
|
{
|
|
public:
|
|
//! constructor
|
|
IGUIImage(IGUIEnvironment *environment, IGUIElement *parent, s32 id, core::rect<s32> rectangle) :
|
|
IGUIElement(EGUIET_IMAGE, environment, parent, id, rectangle) {}
|
|
|
|
//! Sets an image texture
|
|
virtual void setImage(video::ITexture *image) = 0;
|
|
|
|
//! Gets the image texture
|
|
virtual video::ITexture *getImage() const = 0;
|
|
|
|
//! Sets the color of the image
|
|
/** \param color Color with which the image is drawn. If the color
|
|
equals Color(255,255,255,255) it is ignored. */
|
|
virtual void setColor(video::SColor color) = 0;
|
|
|
|
//! Sets if the image should scale to fit the element
|
|
virtual void setScaleImage(bool scale) = 0;
|
|
|
|
//! Sets if the image should use its alpha channel to draw itself
|
|
virtual void setUseAlphaChannel(bool use) = 0;
|
|
|
|
//! Gets the color of the image
|
|
virtual video::SColor getColor() const = 0;
|
|
|
|
//! Returns true if the image is scaled to fit, false if not
|
|
virtual bool isImageScaled() const = 0;
|
|
|
|
//! Returns true if the image is using the alpha channel, false if not
|
|
virtual bool isAlphaChannelUsed() const = 0;
|
|
|
|
//! Sets the source rectangle of the image. By default the full image is used.
|
|
/** \param sourceRect coordinates inside the image or an area with size 0 for using the full image (default). */
|
|
virtual void setSourceRect(const core::rect<s32> &sourceRect) = 0;
|
|
|
|
//! Returns the customized source rectangle of the image to be used.
|
|
/** By default an empty rectangle of width and height 0 is returned which means the full image is used. */
|
|
virtual core::rect<s32> getSourceRect() const = 0;
|
|
|
|
//! Restrict drawing-area.
|
|
/** This allows for example to use the image as a progress bar.
|
|
Base for area is the image, which means:
|
|
- The original clipping area when the texture is scaled or there is no texture.
|
|
- The source-rect for an unscaled texture (but still restricted afterward by the clipping area)
|
|
Unlike normal clipping this does not affect the gui-children.
|
|
\param drawBoundUVs: Coordinates between 0 and 1 where 0 are for left+top and 1 for right+bottom
|
|
*/
|
|
virtual void setDrawBounds(const core::rect<f32> &drawBoundUVs = core::rect<f32>(0.f, 0.f, 1.f, 1.f)) = 0;
|
|
|
|
//! Get drawing-area restrictions.
|
|
virtual core::rect<f32> getDrawBounds() const = 0;
|
|
|
|
//! Sets whether to draw a background color (EGDC_3D_DARK_SHADOW) when no texture is set
|
|
/** By default it's enabled */
|
|
virtual void setDrawBackground(bool draw) = 0;
|
|
|
|
//! Checks if a background is drawn when no texture is set
|
|
/** \return true if background drawing is enabled, false otherwise */
|
|
virtual bool isDrawBackgroundEnabled() const = 0;
|
|
};
|
|
|
|
} // end namespace gui
|
|
} // end namespace irr
|