Loading...
Searching...
No Matches
Texture.hpp
Go to the documentation of this file.
1
2//
3// SFML - Simple and Fast Multimedia Library
4// Copyright (C) 2007-2023 Laurent Gomila (laurent@sfml-dev.org)
5//
6// This software is provided 'as-is', without any express or implied warranty.
7// In no event will the authors be held liable for any damages arising from the use of this software.
8//
9// Permission is granted to anyone to use this software for any purpose,
10// including commercial applications, and to alter it and redistribute it freely,
11// subject to the following restrictions:
12//
13// 1. The origin of this software must not be misrepresented;
14// you must not claim that you wrote the original software.
15// If you use this software in a product, an acknowledgment
16// in the product documentation would be appreciated but is not required.
17//
18// 2. Altered source versions must be plainly marked as such,
19// and must not be misrepresented as being the original software.
20//
21// 3. This notice may not be removed or altered from any source distribution.
22//
24
25#ifndef SFML_TEXTURE_HPP
26#define SFML_TEXTURE_HPP
27
29// Headers
34
35
36namespace sf
37{
38class InputStream;
39class RenderTarget;
40class RenderTexture;
41class Text;
42class Window;
43
49{
50public:
51
61
62public:
63
71
78 Texture(const Texture& copy);
79
85
97 bool create(unsigned int width, unsigned int height);
98
128 bool loadFromFile(const std::string& filename, const IntRect& area = IntRect());
129
160 bool loadFromMemory(const void* data, std::size_t size, const IntRect& area = IntRect());
161
191 bool loadFromStream(InputStream& stream, const IntRect& area = IntRect());
192
215 bool loadFromImage(const Image& image, const IntRect& area = IntRect());
216
224
239
256 void update(const Uint8* pixels);
257
278 void update(const Uint8* pixels, unsigned int width, unsigned int height, unsigned int x, unsigned int y);
279
298 void update(const Texture& texture);
299
315 void update(const Texture& texture, unsigned int x, unsigned int y);
316
335 void update(const Image& image);
336
352 void update(const Image& image, unsigned int x, unsigned int y);
353
372 void update(const Window& window);
373
389 void update(const Window& window, unsigned int x, unsigned int y);
390
405 void setSmooth(bool smooth);
406
415 bool isSmooth() const;
416
440 void setSrgb(bool sRgb);
441
450 bool isSrgb() const;
451
474 void setRepeated(bool repeated);
475
484 bool isRepeated() const;
485
510
519 Texture& operator =(const Texture& right);
520
527 void swap(Texture& right);
528
539 unsigned int getNativeHandle() const;
540
572 static void bind(const Texture* texture, CoordinateType coordinateType = Normalized);
573
584 static unsigned int getMaximumSize();
585
586private:
587
588 friend class Text;
589 friend class RenderTexture;
590 friend class RenderTarget;
591
605 static unsigned int getValidSize(unsigned int size);
606
614 void invalidateMipmap();
615
617 // Member data
619 Vector2u m_size;
620 Vector2u m_actualSize;
621 unsigned int m_texture;
622 bool m_isSmooth;
623 bool m_sRgb;
624 bool m_isRepeated;
625 mutable bool m_pixelsFlipped;
626 bool m_fboAttachment;
627 bool m_hasMipmap;
628 Uint64 m_cacheId;
629};
630
631} // namespace sf
632
633
634#endif // SFML_TEXTURE_HPP
635
#define SFML_GRAPHICS_API
GlResource()
Default constructor.
Class for loading, manipulating and saving images.
Definition Image.hpp:47
Abstract class for custom file input streams.
Base class for all render targets (window, texture, ...)
Target for off-screen 2D rendering into a texture.
Graphical text that can be drawn to a render target.
Definition Text.hpp:49
void update(const Image &image)
Update the texture from an image.
static unsigned int getMaximumSize()
Get the maximum texture size allowed.
void setSmooth(bool smooth)
Enable or disable the smooth filter.
void update(const Uint8 *pixels, unsigned int width, unsigned int height, unsigned int x, unsigned int y)
Update a part of the texture from an array of pixels.
void update(const Window &window, unsigned int x, unsigned int y)
Update a part of the texture from the contents of a window.
friend class RenderTexture
Definition Texture.hpp:589
bool loadFromMemory(const void *data, std::size_t size, const IntRect &area=IntRect())
Load the texture from a file in memory.
Texture()
Default constructor.
bool isSmooth() const
Tell whether the smooth filter is enabled or not.
Texture(const Texture &copy)
Copy constructor.
unsigned int getNativeHandle() const
Get the underlying OpenGL handle of the texture.
bool generateMipmap()
Generate a mipmap using the current texture data.
Image copyToImage() const
Copy the texture pixels to an image.
bool loadFromStream(InputStream &stream, const IntRect &area=IntRect())
Load the texture from a custom stream.
void update(const Image &image, unsigned int x, unsigned int y)
Update a part of the texture from an image.
bool create(unsigned int width, unsigned int height)
Create the texture.
void update(const Texture &texture, unsigned int x, unsigned int y)
Update a part of this texture from another texture.
bool loadFromFile(const std::string &filename, const IntRect &area=IntRect())
Load the texture from a file on disk.
void swap(Texture &right)
Swap the contents of this texture with those of another.
~Texture()
Destructor.
bool isSrgb() const
Tell whether the texture source is converted from sRGB or not.
Vector2u getSize() const
Return the size of the texture.
friend class RenderTarget
Definition Texture.hpp:590
CoordinateType
Types of texture coordinates that can be used for rendering.
Definition Texture.hpp:57
@ Pixels
Texture coordinates in range [0 .. size].
Definition Texture.hpp:59
@ Normalized
Texture coordinates in range [0 .. 1].
Definition Texture.hpp:58
void setRepeated(bool repeated)
Enable or disable repeating.
bool loadFromImage(const Image &image, const IntRect &area=IntRect())
Load the texture from an image.
void update(const Window &window)
Update the texture from the contents of a window.
void update(const Uint8 *pixels)
Update the whole texture from an array of pixels.
static void bind(const Texture *texture, CoordinateType coordinateType=Normalized)
Bind a texture for rendering.
friend class Text
Definition Texture.hpp:588
bool isRepeated() const
Tell whether the texture is repeated or not.
void setSrgb(bool sRgb)
Enable or disable conversion from sRGB.
void update(const Texture &texture)
Update a part of this texture from another texture.
Window that serves as a target for OpenGL rendering.
unsigned char Uint8
Definition Config.hpp:219
Vector2< unsigned int > Vector2u
Definition Vector2.hpp:254
Rect< int > IntRect
Definition Rect.hpp:216
unsigned long long Uint64
Definition Config.hpp:239