.. index:: pair: class; EE::Graphics::TextureFactory
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory:

class EE::Graphics::TextureFactory
==================================

.. toctree::
	:hidden:

	struct_EE_Graphics_TextureFactory_LiveTextureRecord.rst
	struct_EE_Graphics_TextureFactory_TextureDeleter.rst

Overview
~~~~~~~~

Creates textures and weakly observes every live texture for diagnostics. :ref:`More...<details-class_e_e_1_1_graphics_1_1_texture_factory>`


.. ref-code-block:: cpp
	:class: doxyrest-overview-code-block

	#include <texturefactory.hpp>
	
	class TextureFactory: protected :ref:`EE::System::Mutex<doxid-class_e_e_1_1_system_1_1_mutex>` {
	public:
		// structs
	
		struct :ref:`LiveTextureRecord<doxid-struct_e_e_1_1_graphics_1_1_texture_factory_1_1_live_texture_record>`;
		struct :ref:`TextureDeleter<doxid-struct_e_e_1_1_graphics_1_1_texture_factory_1_1_texture_deleter>`;

		// construction
	
		:target:`~TextureFactory<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a49471396d4892d0595ff76d242289d1f>`();

		// methods
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`createEmptyTexture<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a4950dbccae4000008bd7532151ca11d6>`(
			const unsigned int& Width,
			const unsigned int& Height,
			const unsigned int& Channels = 4,
			const :ref:`Color<doxid-class_e_e_1_1_system_1_1_color>`& DefaultColor = :ref:`Color<doxid-class_e_e_1_1_system_1_1_color>`(0, 0, 0, 255),
			const bool& Mipmap = false,
			const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
			const bool& CompressTexture = false,
			const bool& KeepLocalCopy = false,
			const std::string& Filename = std::string("")
		);
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`loadFromPixels<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a76679dc0e9d132994e66374481a9bad3>`(
			const unsigned char* Pixels,
			const unsigned int& Width,
			const unsigned int& Height,
			const unsigned int& Channels,
			const bool& Mipmap = false,
			const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
			const bool& CompressTexture = false,
			const bool& KeepLocalCopy = false,
			const std::string& FileName = std::string("")
		);
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`loadFromPack<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aae555ab251c6e5f88d6ac1fbaf5a1af8>`(
			:ref:`Pack<doxid-class_e_e_1_1_system_1_1_pack>`* Pack,
			const std::string& FilePackPath,
			const bool& Mipmap = false,
			const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
			const bool& CompressTexture = false,
			const bool& KeepLocalCopy = false,
			const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`()
		);
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`loadFromMemory<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a09bd10f512c9ab0e33f9d4a029f82a01>`(
			const unsigned char* ImagePtr,
			const unsigned int& Size,
			const bool& Mipmap = false,
			const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
			const bool& CompressTexture = false,
			const bool& KeepLocalCopy = false,
			const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`()
		);
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`loadFromStream<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a5bdf45d16a6aa63ecc644bbfcce087e2>`(:ref:`IOStream<doxid-class_e_e_1_1_system_1_1_i_o_stream>`& Stream, const bool& Mipmap = false, const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`, const bool& CompressTexture = false, const bool& KeepLocalCopy = false, const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`());
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`loadFromFile<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aaef345eec6805c558788d9355501afb9>`(const std::string& Filepath, const bool& Mipmap = false, const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`, const bool& CompressTexture = false, const bool& KeepLocalCopy = false, const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`());
		void :ref:`bind<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1af41b5272d74c2003b7a992dfba7806f3>`(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId, :ref:`Texture::CoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7>` coordinateType = :ref:`Texture::CoordinateType::Normalized<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7a66b28fcf83c9f24cd5b4d7bdc8f8ba0e>`, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& textureUnit = 0, const bool& forceRebind = false);
		void :ref:`bind<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aa2d32888928a51e2cfeafb41afc3a111>`(const :ref:`Texture<doxid-class_e_e_1_1_graphics_1_1_texture>`* Tex, :ref:`Texture::CoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7>` coordinateType = :ref:`Texture::CoordinateType::Normalized<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7a66b28fcf83c9f24cd5b4d7bdc8f8ba0e>`, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit = 0, const bool& forceRebind = false);
		int :ref:`getCurrentTexture<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a2b47949fa0e4fbe39159994196be3200>`(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit = 0) const;
		void :ref:`setCurrentTexture<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a1d6c27bfd2530e5e8b066f989c1dbdc2>`(const int& textureHandle, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit);
		void :ref:`invalidateTextureBindings<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ad131abfbaadbad8c7fc7f5a7df9ccea8>`();
		:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` :ref:`getTextureCount<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a4009c625b2de4b5d7c45877d556f9425>`();
		:ref:`TextureRegistrySnapshot<doxid-namespace_e_e_1_1_graphics_1aa05244894f6f9908cedc19e108d15384>` :ref:`snapshotTextures<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a32d1fcf39c7f7e9aedab1a392163d2ee>`();
		void :ref:`purgeExpiredTextures<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a3305220dd9ddcc628ecd95a3739cc349>`();
		:ref:`Uint64<doxid-namespace_e_e_1ae05f59b032c290566852fe63cb26135c>` :ref:`getLiveTextureGeneration<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a0640969587abb1f46201760688058114>`() const;
		void :ref:`collectReleasedTextures<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a19c3fb6e5f57396f7fa86b01f458160d>`();
		std::size_t :ref:`getPendingReleaseCount<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aeeefbd2b141f91d5ce71df47423ff326>`();
		void :ref:`setActiveTextureUnit<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a94999e239a379b3b3906377bc38dbfd8>`(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& Unit);
		unsigned int :ref:`getValidTextureSize<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aab28adb167bf2d94cd4b9d590c2851b6>`(const unsigned int& Size);
		bool :ref:`existsId<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ae3eb1c44cb1237e37e0d42427b431d6f>`(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId);
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`getTexture<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a2d70c89bcc2cc9f7523f2edcee39cc80>`(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId);
		unsigned int :ref:`getTextureMemorySize<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a7f5bcb6cbf1f72059214f8a54b83585e>`();
	
		:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` :ref:`pushTexture<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ac0650ff8f8a0fd160daed1b950d874b5>`(
			const std::string& Filepath,
			const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& textureHandle,
			const unsigned int& Width,
			const unsigned int& Height,
			const unsigned int& ImgWidth,
			const unsigned int& ImgHeight,
			const bool& Mipmap,
			const unsigned int& Channels,
			const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode,
			const bool& CompressTexture,
			const bool& LocalCopy = false,
			const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& MemSize = 0
		);
	
		const :ref:`Texture::CoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7>`& :target:`getLastCoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a70fa932b613423cf189e9f7ea8139479>`() const;
	};

Inherited Members
-----------------

.. ref-code-block:: cpp
	:class: doxyrest-overview-inherited-code-block

	public:
		// methods
	
		void :ref:`lock<doxid-class_e_e_1_1_system_1_1_mutex_1a6f72cee2e7ed17e38d21ca8b230ee5e3>`();
		void :ref:`unlock<doxid-class_e_e_1_1_system_1_1_mutex_1acbd7dc7fc94d5db6a7c5a4ecfd9d123c>`();
		bool :ref:`tryLock<doxid-class_e_e_1_1_system_1_1_mutex_1a3d9e371eeb72a34025994422a5a08169>`();

.. _details-class_e_e_1_1_graphics_1_1_texture_factory:

Detailed Documentation
~~~~~~~~~~~~~~~~~~~~~~

Creates textures and weakly observes every live texture for diagnostics.

Methods
-------

.. index:: pair: function; createEmptyTexture
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a4950dbccae4000008bd7532151ca11d6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` createEmptyTexture(
		const unsigned int& Width,
		const unsigned int& Height,
		const unsigned int& Channels = 4,
		const :ref:`Color<doxid-class_e_e_1_1_system_1_1_color>`& DefaultColor = :ref:`Color<doxid-class_e_e_1_1_system_1_1_color>`(0, 0, 0, 255),
		const bool& Mipmap = false,
		const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
		const bool& CompressTexture = false,
		const bool& KeepLocalCopy = false,
		const std::string& Filename = std::string("")
	)

Creates an empty texture



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Width

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Width

	*
		- Height

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Height

	*
		- Channels

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Number of Channels (in bytes)

	*
		- DefaultColor

		- The background color for the texture

	*
		- Mipmap

		- Create Mipmap?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- Filename

		- A filename to recognize the texture.



.. rubric:: Returns:

The created texture

.. index:: pair: function; loadFromPixels
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a76679dc0e9d132994e66374481a9bad3:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` loadFromPixels(
		const unsigned char* Pixels,
		const unsigned int& Width,
		const unsigned int& Height,
		const unsigned int& Channels,
		const bool& Mipmap = false,
		const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
		const bool& CompressTexture = false,
		const bool& KeepLocalCopy = false,
		const std::string& FileName = std::string("")
	)

Loads a RAW :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` from Memory



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Pixels

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` array

	*
		- Width

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Width

	*
		- Height

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Height

	*
		- Channels

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Number of Channels (in bytes)

	*
		- Mipmap

		- Create Mipmap?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- FileName

		- A filename to recognize the texture ( the path in case that was loaded from outside the texture factory ).



.. rubric:: Returns:

The texture loaded or null if error

.. index:: pair: function; loadFromPack
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aae555ab251c6e5f88d6ac1fbaf5a1af8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` loadFromPack(
		:ref:`Pack<doxid-class_e_e_1_1_system_1_1_pack>`* Pack,
		const std::string& FilePackPath,
		const bool& Mipmap = false,
		const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
		const bool& CompressTexture = false,
		const bool& KeepLocalCopy = false,
		const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`()
	)

Load a texture from Pack file



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Pack

		- Pointer to the pack instance

	*
		- FilePackPath

		- The path of the file inside the pack

	*
		- Mipmap

		- Create Mipmap?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- imageformatConfiguration

		- The specific image format configuration to use when decoding the image.



.. rubric:: Returns:

The texture loaded or null if error

.. index:: pair: function; loadFromMemory
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a09bd10f512c9ab0e33f9d4a029f82a01:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` loadFromMemory(
		const unsigned char* ImagePtr,
		const unsigned int& Size,
		const bool& Mipmap = false,
		const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`,
		const bool& CompressTexture = false,
		const bool& KeepLocalCopy = false,
		const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`()
	)

Load a texture from memory



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- ImagePtr

		- The image data in RAM just as if it were still in a file

	*
		- Size

		- The size of the texture ( Width \* Height \* BytesPerPixel )

	*
		- Mipmap

		- Use mipmaps?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- imageformatConfiguration

		- The specific image format configuration to use when decoding the image.



.. rubric:: Returns:

The texture loaded or null if error

.. index:: pair: function; loadFromStream
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a5bdf45d16a6aa63ecc644bbfcce087e2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` loadFromStream(:ref:`IOStream<doxid-class_e_e_1_1_system_1_1_i_o_stream>`& Stream, const bool& Mipmap = false, const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`, const bool& CompressTexture = false, const bool& KeepLocalCopy = false, const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`())

Load a :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` from stream



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Stream

		- The IOStream instance

	*
		- Mipmap

		- Use mipmaps?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- imageformatConfiguration

		- The specific image format configuration to use when decoding the image.



.. rubric:: Returns:

The texture loaded or null if error

.. index:: pair: function; loadFromFile
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aaef345eec6805c558788d9355501afb9:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` loadFromFile(const std::string& Filepath, const bool& Mipmap = false, const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode = :ref:`Texture::ClampMode::ClampToEdge<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29aea74556551231333c36debc3d373261134>`, const bool& CompressTexture = false, const bool& KeepLocalCopy = false, const :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`& imageformatConfiguration = :ref:`Image::FormatConfiguration<doxid-class_e_e_1_1_graphics_1_1_image_1_1_format_configuration>`())

Load a :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` from a file path



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Filepath

		- The path for the texture

	*
		- Mipmap

		- Use mipmaps?

	*
		- ClampMode

		- Defines the CLAMP MODE

	*
		- CompressTexture

		- If use the DXT compression on the texture loading ( if the card can display them, will convert RGB to DXT1, RGBA to DXT5 )

	*
		- KeepLocalCopy

		- Keep the array data copy. ( useful if want to reload the texture )

	*
		- imageformatConfiguration

		- The specific image format configuration to use when decoding the image.



.. rubric:: Returns:

The texture loaded or null if error

.. index:: pair: function; bind
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1af41b5272d74c2003b7a992dfba7806f3:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void bind(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId, :ref:`Texture::CoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7>` coordinateType = :ref:`Texture::CoordinateType::Normalized<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7a66b28fcf83c9f24cd5b4d7bdc8f8ba0e>`, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& textureUnit = 0, const bool& forceRebind = false)

Binds the texture identity indicated. This is useful if you are rendering a texture outside this class.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- textureId

		- The process-wide texture identity.

	*
		- coordinateType

		- Use normalized or pixel coordinates

	*
		- textureUnit

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Unit binded

	*
		- forceRebind

		- Force the texture bind (even if is already binded ).

.. index:: pair: function; bind
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aa2d32888928a51e2cfeafb41afc3a111:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void bind(const :ref:`Texture<doxid-class_e_e_1_1_graphics_1_1_texture>`* Tex, :ref:`Texture::CoordinateType<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7>` coordinateType = :ref:`Texture::CoordinateType::Normalized<doxid-class_e_e_1_1_graphics_1_1_texture_1ad9f8e4e6cf1e1a73958113c2fec041b7a66b28fcf83c9f24cd5b4d7bdc8f8ba0e>`, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit = 0, const bool& forceRebind = false)

Bind the the :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` indicated. This is useful if you are rendering a texture outside this class.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Tex

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Pointer

	*
		- coordinateType

		- Selects the coordinate type to use with the binded texture.

	*
		- TextureUnit

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Unit binded

	*
		- forceRebind

		- Force the texture bind (even if is already binded ).

.. index:: pair: function; getCurrentTexture
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a2b47949fa0e4fbe39159994196be3200:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	int getCurrentTexture(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit = 0) const



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- TextureUnit

		- The bound texture unit.



.. rubric:: Returns:

The currently bound OpenGL texture handle.

.. index:: pair: function; setCurrentTexture
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a1d6c27bfd2530e5e8b066f989c1dbdc2:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void setCurrentTexture(const int& textureHandle, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureUnit)

Sets the currently bound OpenGL texture handle.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- textureHandle

		- The OpenGL texture handle.

	*
		- TextureUnit

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Unit binded

.. index:: pair: function; invalidateTextureBindings
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ad131abfbaadbad8c7fc7f5a7df9ccea8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void invalidateTextureBindings()

Invalidates cached OpenGL binding state after changing the current graphics context.

.. index:: pair: function; getTextureCount
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a4009c625b2de4b5d7c45877d556f9425:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` getTextureCount()

Returns the number of currently live textures.

.. index:: pair: function; snapshotTextures
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a32d1fcf39c7f7e9aedab1a392163d2ee:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TextureRegistrySnapshot<doxid-namespace_e_e_1_1_graphics_1aa05244894f6f9908cedc19e108d15384>` snapshotTextures()



.. rubric:: Returns:

A non-owning diagnostic snapshot of every currently live texture.

.. index:: pair: function; purgeExpiredTextures
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a3305220dd9ddcc628ecd95a3739cc349:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void purgeExpiredTextures()

Removes expired records from the diagnostic live-texture registry.

.. index:: pair: function; getLiveTextureGeneration
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a0640969587abb1f46201760688058114:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`Uint64<doxid-namespace_e_e_1ae05f59b032c290566852fe63cb26135c>` getLiveTextureGeneration() const



.. rubric:: Returns:

The generation of the live-texture registry. It changes when a texture is created or its last owning handle is released.

.. index:: pair: function; collectReleasedTextures
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a19c3fb6e5f57396f7fa86b01f458160d:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void collectReleasedTextures()

Destroys textures whose final owning handle was released. Must run on the graphics thread after pending batches have been flushed and while a context is current.

.. index:: pair: function; getPendingReleaseCount
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aeeefbd2b141f91d5ce71df47423ff326:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	std::size_t getPendingReleaseCount()



.. rubric:: Returns:

The number of textures waiting for graphics-thread destruction.

.. index:: pair: function; setActiveTextureUnit
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a94999e239a379b3b3906377bc38dbfd8:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	void setActiveTextureUnit(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& Unit)

Active a texture unit

.. index:: pair: function; getValidTextureSize
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1aab28adb167bf2d94cd4b9d590c2851b6:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	unsigned int getValidTextureSize(const unsigned int& Size)



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Size

		- 



.. rubric:: Returns:

A valid texture size for the video card (checks if support non power of two textures)

.. index:: pair: function; existsId
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ae3eb1c44cb1237e37e0d42427b431d6f:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	bool existsId(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId)

Determines whether the texture identity is currently live.

.. index:: pair: function; getTexture
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a2d70c89bcc2cc9f7523f2edcee39cc80:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` getTexture(:ref:`ResourceId<doxid-class_e_e_1_1_graphics_1_1_resource_id>` textureId)



.. rubric:: Returns:

The live texture matching ``textureId``, or null if it has expired.

.. index:: pair: function; getTextureMemorySize
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1a7f5bcb6cbf1f72059214f8a54b83585e:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	unsigned int getTextureMemorySize()



.. rubric:: Returns:

The memory used by the textures (in bytes)

.. index:: pair: function; pushTexture
.. _doxid-class_e_e_1_1_graphics_1_1_texture_factory_1ac0650ff8f8a0fd160daed1b950d874b5:

.. ref-code-block:: cpp
	:class: doxyrest-title-code-block

	:ref:`TexturePtr<doxid-namespace_e_e_1_1_graphics_1a1b0289aa7a715a456098fe54cf5dc391>` pushTexture(
		const std::string& Filepath,
		const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& textureHandle,
		const unsigned int& Width,
		const unsigned int& Height,
		const unsigned int& ImgWidth,
		const unsigned int& ImgHeight,
		const bool& Mipmap,
		const unsigned int& Channels,
		const :ref:`Texture::ClampMode<doxid-class_e_e_1_1_graphics_1_1_texture_1a9d684bc9542a51ac49b2f2def30e29ae>`& ClampMode,
		const bool& CompressTexture,
		const bool& LocalCopy = false,
		const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& MemSize = 0
	)

It's possible to create textures outside the texture factory loader, but the library will need to know of this texture, so it's necessary to push the texture to the factory.



.. rubric:: Parameters:

.. list-table::
	:widths: 20 80

	*
		- Filepath

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` path ( if exists )

	*
		- textureHandle

		- The OpenGL texture handle.

	*
		- Width

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Width

	*
		- Height

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Height

	*
		- ImgWidth

		- :ref:`Image <doxid-class_e_e_1_1_graphics_1_1_image>` Width.

	*
		- ImgHeight

		- :ref:`Image <doxid-class_e_e_1_1_graphics_1_1_image>` Height

	*
		- Mipmap

		- Tell if the texture has mipmaps

	*
		- Channels

		- :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` number of Channels ( bytes per pixel )

	*
		- ClampMode

		- The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Clamp Mode

	*
		- CompressTexture

		- The texture is compressed?

	*
		- LocalCopy

		- If keep a local copy in memory of the texture

	*
		- MemSize

		- The size of the texture in memory ( just if you need to specify the real size in memory, just useful to calculate the total texture memory ).