.. index:: pair: class; EE::Graphics::TextureAtlasManager
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager:

class EE::Graphics::TextureAtlasManager
=======================================

.. toctree::
	:hidden:

Overview
~~~~~~~~

The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlas Manager is a singleton class that manages all the instances of :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlases instanciated. Releases the :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlases instances automatically. So the user doesn't need to release any :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlas instance. :ref:`More...<details-class_e_e_1_1_graphics_1_1_texture_atlas_manager>`


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

	#include <textureatlasmanager.hpp>
	
	class TextureAtlasManager: public :ref:`EE::System::ResourceManagerMulti<doxid-class_e_e_1_1_system_1_1_resource_manager_multi>` {
	public:
		// construction
	
		virtual :target:`~TextureAtlasManager<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a2ac035d2edf8609a8b9ce98396586699>`();

		// methods
	
		:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* :ref:`loadFromFile<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a2d25bca257381677d223fc3b13d25023>`(const std::string& TextureAtlasPath);
		:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* :ref:`loadFromStream<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1acf910b9abef42b3704a0893feddaff3b>`(:ref:`IOStream<doxid-class_e_e_1_1_system_1_1_i_o_stream>`& IOS);
		:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* :ref:`loadFromMemory<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a9cda96af18ef9660dfb9216b4b01d9c5>`(const :ref:`Uint8<doxid-namespace_e_e_1aa226754e64fe26f32b5526c7cd36fa75>`* Data, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& DataSize, const std::string& TextureAtlasName);
		:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* :ref:`loadFromPack<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a229ea689b748578310b440dc1bc2d087>`(:ref:`Pack<doxid-class_e_e_1_1_system_1_1_pack>`* Pack, const std::string& FilePackPath);
		:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`* :ref:`getTextureRegionByName<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a0eb77f17a9c99699ce01e543646e3178>`(const std::string& Name);
		:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`* :ref:`getTextureRegionById<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1ab1f8db05db7fa74fc8828024c02c820a>`(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& Id);
		std::vector<:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`*> :ref:`getTextureRegionsByPattern<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1acabb39067a1f952bcfb763f6f0f51638>`(const std::string& name, const std::string& extension = "", :ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* SearchInTextureAtlas = NULL);
		std::vector<:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`*> :ref:`getTextureRegionsByPatternId<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a831ac82ef22cd0cd4046147747860fde>`(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureRegionId, const std::string& extension = "", :ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* SearchInTextureAtlas = NULL);
		void :ref:`printResources<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a588439d6710791e9e01b59a94b799d1d>`();
		void :ref:`setPrintWarnings<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a1bcfa83843c5c1884e1bb173ab63ae46>`(const bool& warn);
		const bool& :ref:`getPrintWarnings<doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a2718801a10b1c8467b3f118797c5112d>`() const;
	};

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

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

	public:
		// methods
	
		virtual T* :ref:`add<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1ac0f0caa8e492b11249ea8ca7c0c46990>`(T* resource);
		bool :ref:`remove<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a12c7e18ff617ff6f1a55edfbd858cee3>`(T* resource, bool remove = true);
		bool :ref:`removeById<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a3aab46e254b1abcc8dcf2b06cda3b6bb>`(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& id, bool remove = true);
		bool :ref:`removeByName<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a423b5795b38f006b4f552db5ebaba38b>`(const std::string& name, bool remove = true);
		T* :ref:`getByName<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a6c2f8afac946644e9ce976d08cbd88ad>`(const std::string& name);
		T* :ref:`getById<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1ab3ca548aa576425f5feac53d3bc476d9>`(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& id);
		:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` :ref:`getCount<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1ad84f082f07988a432e329f90ef5c08df>`();
		:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` :ref:`getCount<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1aae0589a8d0c7a9bdc9bb25b726477411>`(const std::string& name);
		:ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>` :ref:`getCount<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1acdcddc0bc34f0cafe1c02acaecc68aa6>`(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& id);
		bool :ref:`exists<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a57354620b98bb9225e8772bbdea47e1c>`(const std::string& name);
		bool :ref:`existsId<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a0f609fc97fb096cf62cc4ae21c8f0bed>`(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& id);
		void :ref:`destroy<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a955e22fe333f3df453abf74c033720f4>`();
		void :ref:`printNames<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1ab96e703afd8129a9289e00d3d1a39265>`();
		std::unordered_multimap<:ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`, T*>& :ref:`getResources<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a19572662a03714d57e77fa25f9d20f88>`();
		const bool& :ref:`isDestroying<doxid-class_e_e_1_1_system_1_1_resource_manager_multi_1a99dbbf5ccf0e34c85c37c4f4faf45ccc>`() const;

.. _details-class_e_e_1_1_graphics_1_1_texture_atlas_manager:

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

The :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlas Manager is a singleton class that manages all the instances of :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlases instanciated. Releases the :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlases instances automatically. So the user doesn't need to release any :ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` Atlas instance.

Methods
-------

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

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

	:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* loadFromFile(const std::string& TextureAtlasPath)

Loads a texture atlas from its path ( the texture atlas binary is expected, not the texture, the ".eta" file ).

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

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

	:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* loadFromStream(:ref:`IOStream<doxid-class_e_e_1_1_system_1_1_i_o_stream>`& IOS)

Loads a texture atlas from a io stream.

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

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

	:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* loadFromMemory(const :ref:`Uint8<doxid-namespace_e_e_1aa226754e64fe26f32b5526c7cd36fa75>`* Data, const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& DataSize, const std::string& TextureAtlasName)

Loads a texture atlas from memory.

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

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

	:ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* loadFromPack(:ref:`Pack<doxid-class_e_e_1_1_system_1_1_pack>`* Pack, const std::string& FilePackPath)

Loads a texture atlas from a pack file.

.. index:: pair: function; getTextureRegionByName
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a0eb77f17a9c99699ce01e543646e3178:

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

	:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`* getTextureRegionByName(const std::string& Name)

It will search for a :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` Name in the texture atlases loaded.



.. rubric:: Returns:

The first :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` found with the given name in any atlas.

.. index:: pair: function; getTextureRegionById
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1ab1f8db05db7fa74fc8828024c02c820a:

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

	:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`* getTextureRegionById(const :ref:`String::HashType<doxid-class_e_e_1_1_string_1a105c2ab365f2a3085c714617f129b386>`& Id)

It will search for a :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` Id in the texture atlases loaded.



.. rubric:: Returns:

The first :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` found with the given id in any atlas.

.. index:: pair: function; getTextureRegionsByPattern
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1acabb39067a1f952bcfb763f6f0f51638:

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

	std::vector<:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`*> getTextureRegionsByPattern(const std::string& name, const std::string& extension = "", :ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* SearchInTextureAtlas = NULL)

Search for a pattern name For example search for name "car" with extensions "png", i will try to find car00.png car01.png car02.png, and so on, it will continue if find something, otherwise it will stop ( it will always search at least for car00.png and car01.png )

.. note::

	:ref:`Texture <doxid-class_e_e_1_1_graphics_1_1_texture>` atlases saves the TextureRegions names without extension by default.



.. rubric:: Parameters:

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

	*
		- name

		- First part of the sub texture name

	*
		- extension

		- Extension of the sub texture name ( if have one, otherwise is empty )

	*
		- SearchInTextureAtlas

		- If you want only to search in a especific atlas ( NULL if you want to search in all atlases )

.. index:: pair: function; getTextureRegionsByPatternId
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a831ac82ef22cd0cd4046147747860fde:

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

	std::vector<:ref:`TextureRegion<doxid-class_e_e_1_1_graphics_1_1_texture_region>`*> getTextureRegionsByPatternId(const :ref:`Uint32<doxid-namespace_e_e_1acb11e434631749f2da0e0004d6038558>`& TextureRegionId, const std::string& extension = "", :ref:`TextureAtlas<doxid-class_e_e_1_1_graphics_1_1_texture_atlas>`* SearchInTextureAtlas = NULL)

Search for a pattern id. This will look for the :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` with the id passed, and it will try to find any pattern by the :ref:`TextureRegion <doxid-class_e_e_1_1_graphics_1_1_texture_region>` name.



.. rubric:: See also:

GetTextureRegionsByPattern

.. index:: pair: function; printResources
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a588439d6710791e9e01b59a94b799d1d:

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

	void printResources()

Prints all the resources name to the screen.

.. index:: pair: function; setPrintWarnings
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a1bcfa83843c5c1884e1bb173ab63ae46:

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

	void setPrintWarnings(const bool& warn)

Sets if the warnings for not finding a resource must be printed in screen.

.. index:: pair: function; getPrintWarnings
.. _doxid-class_e_e_1_1_graphics_1_1_texture_atlas_manager_1a2718801a10b1c8467b3f118797c5112d:

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

	const bool& getPrintWarnings() const



.. rubric:: Returns:

If warnings are being printed.