.. index:: pair: class; EE::UI::UISystemIconTheme
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme:

class EE::UI::UISystemIconTheme
===============================

.. toctree::
	:hidden:

	struct_EE_UI_UISystemIconTheme_Request.rst

Overview
~~~~~~~~

Icons provided by the platform, loaded asynchronously. :ref:`More...<details-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme>`


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

	#include <uisystemicontheme.hpp>
	
	class UISystemIconTheme: public std::enable_shared_from_this< UISystemIconTheme > {
	public:
		// structs
	
		struct :ref:`Request<doxid-struct_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1_1_request>`;

		// construction
	
		:target:`~UISystemIconTheme<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a022d80b51bdbd727a79e505e47bbf1e8>`();

		// methods
	
		static std::shared_ptr<UISystemIconTheme> :ref:`New<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a187321f094a114ee29b7facbb4baf08e>`(:ref:`Executor<doxid-class_e_e_1_1_executor>`& worker, :ref:`Executor<doxid-class_e_e_1_1_executor>`& ui, const std::string& themeName = {});
		:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* :ref:`getIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a98b7130175ec78347ff9cbfc6f513925>`(const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr);
		:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* :ref:`getFileIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1af1342dc37a2c1ef0049e426faa5baea5>`(const std::string& fileName, bool isDirectory, const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr);
		:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* :ref:`getPathIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a701a8bf7701f41b3e09654528d3ee863>`(const std::string& path, const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr);
		const std::string& :ref:`getThemeName<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a68273b2abeb60014aba5bc1158c1ea9c>`() const;
		void :ref:`setOnIconsLoaded<doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a6f1416efcc91f7144e3e5be0b147ade2>`(std::function<void()> callback);
	};
.. _details-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme:

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

Icons provided by the platform, loaded asynchronously.

* Linux and BSD: the user's freedesktop.org icon theme (Icon Theme Specification).

* Windows: the shell's icons (file types, special folders and stock icons).

* macOS: NSWorkspace icons.

Icons are returned immediately. Finding, reading and rasterizing them happens on the worker executor; until an icon's image is ready it shows its fallback icon (or nothing). Textures are created on the :ref:`UI <doxid-namespace_e_e_1_1_u_i>` executor, which then calls the icons-loaded callback so views can redraw. Loaded icons are cached for the life of the theme.

Both executors must outlive the work they were given (shut the worker down first, as a ThreadPool member declared after the :ref:`UI <doxid-namespace_e_e_1_1_u_i>` executor does). Methods are :ref:`UI <doxid-namespace_e_e_1_1_u_i>` thread only.

Methods
-------

.. index:: pair: function; New
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a187321f094a114ee29b7facbb4baf08e:

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

	static std::shared_ptr<UISystemIconTheme> New(:ref:`Executor<doxid-class_e_e_1_1_executor>`& worker, :ref:`Executor<doxid-class_e_e_1_1_executor>`& ui, const std::string& themeName = {})



.. rubric:: Parameters:

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

	*
		- worker

		- Where lookups, file reads and rasterization run (e.g. a ThreadPool).

	*
		- ui

		- The thread that owns the graphics context (e.g. a MainThreadExecutor).

	*
		- themeName

		- Freedesktop theme to use; empty detects the user's (Linux and BSD only). Detection and indexing start right away on the worker.

.. index:: pair: function; getIcon
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a98b7130175ec78347ff9cbfc6f513925:

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

	:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* getIcon(const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr)

Icon for standard (freedesktop) icon names, tried in order: "folder", "user-home", "folder-documents", "user-trash", "drive-harddisk", "drive-removable-media", "network-server", "text-x-generic"... Windows and macOS map these names to their own special folder and stock icons. The returned icon is owned by the theme.

.. index:: pair: function; getFileIcon
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1af1342dc37a2c1ef0049e426faa5baea5:

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

	:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* getFileIcon(const std::string& fileName, bool isDirectory, const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr)

Icon for a file or folder type. On Linux and BSD names are the freedesktop names of its MIME type (most specific first); Windows and macOS use the type of the file name's extension.

.. index:: pair: function; getPathIcon
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a701a8bf7701f41b3e09654528d3ee863:

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

	:ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* getPathIcon(const std::string& path, const std::vector<std::string>& names, :ref:`UIIcon<doxid-class_e_e_1_1_u_i_1_1_u_i_icon>`* fallback = nullptr)

Icon of a local path as the platform shows it (special folders, drives): Windows and macOS ask the shell for that path; Linux and BSD use names.

.. index:: pair: function; getThemeName
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a68273b2abeb60014aba5bc1158c1ea9c:

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

	const std::string& getThemeName() const

The freedesktop theme in use, once detected (empty before, and on Windows and macOS).

.. index:: pair: function; setOnIconsLoaded
.. _doxid-class_e_e_1_1_u_i_1_1_u_i_system_icon_theme_1a6f1416efcc91f7144e3e5be0b147ade2:

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

	void setOnIconsLoaded(std::function<void()> callback)

Called on the :ref:`UI <doxid-namespace_e_e_1_1_u_i>` thread after icons received images (coalesced): redraw the views that show them.