<- tb9:locations|Locations ^ tb9:start|Toolbox9 Software ^ tb9:global_logic|Global Logic ->
====== Resource Files ======

Resource files allow you to enhance the consoles user interaction and experience using international character sets or pictures.

<WRAP center round info 80%>
**Note**\\  **Toolbox v9.1.0 & Fw 9.1.0 or higher:** Toolbox allows a maximum of 70 MB of resource files in total and a maximum of 70 files. So there are, for example, 70 resource files with 1 MB per file possible or 1 resource file with 70 MB. A ''Character Set'' counts as file, too.\\
**Toolbox v9.0.x & Fw 9.0.x:** Toolbox allows a maximum of 50 MB of resource files in total and a maximum of 50 files. So there are, for example, 50 resource files with 1 MB per file possible or 1 resource file with 50 MB.
</WRAP>

<WRAP center round info 80%>
**Note**\\  Bigger resource files will slow down config transfer to the device and refreshing of TFT displays. Make sure to remove unused resource files in order to speed up configuration. 
</WRAP>

<WRAP center round info 80%>
**Note**\\  Changes in any resource file will cause a complete re-transmission of the resource file to the device. Sending your config to the device and refreshing TFT displays may take longer than usual.
</WRAP>

''Resource Usage'': informs you of the current resource memory usage and possible amount of resource files left.

===== Character Set =====

<WRAP center round info 80%>
**Note**\\  International character sets and UTF-8 encoding require **Toolbox v9.1.0 & FW 9.1.0 or higher**.
</WRAP>

It is possible to add international, UTF-8 encoded characters to your device's TFT displays and Web Apps, for example in label elements or channel names. This can help the user to interact easier with the console and enhance your workflow.

The default character set that is already contained within the firmware already contains support for 582 languages / 237 regions as well as emoji support. Additional character sets are added as described below. 

For a full list of all languages and additional character sets currently supported by DHD devices, see [[installation:language-support]]. If your language is not supported, please to contact us and request it. 

To add an addidional character set:

  * Click ''Select'' in the ''Character Set'' row in the ''Media Management'' section.
  * To view and download additional character sets, Toolbox requires connection to the internet. Click ''OK'' to proceed.

[{{ :tb9:tb9-internet-request.png?600&nolink |//Internet connection request. Confirm with ''Yes'' to download the list of additional character sets.//}}]

  * Toolbox will now connect to DHD audio servers and download a catalog of available additional character sets. Character sets are not downloaded yet.
  * Click on an additional character set from the list and click ''select''.

[{{ :tb9:tb9-character-catalog.png?700&nolink |//Additional character set selection//}}]

  * Toolbox will now start downloading the additional character set and add it to the resource file.
  * After the download was successful, internet connection is not required anymore.

If **no internet connection** is available, Toolbox will display an error message. Consider the following:

  * Try to transfer toolbox and your config file to another computer with internet access.
  * Check if host ''cdn.dhd.audio'' is reachable.
  * Ask your DHD distributor to add the additional character set to your config file.

[{{ :tb9:tb9-no-internet.png?600&nolink |//Error message: no internet connection available//}}]

To remove an additional character set: click ''Remove'' in the ''Character Set'' row in the ''Media Management'' section.

You can enter UTF-8 special characters in your labels using Toolbox. You can also change labels on the console using the TFT onscreen keyboard, Ember+ or [[webapps:labels]]. TFT onscreen keyboard does only contain selected UTF-8 characters and emojis.

<WRAP center round important 80%>
**Important**\\  Adding character sets requires Toolbox to have an active internet connection. Character set will be downloaded from DHD servers. This is only required
</WRAP>

<WRAP center round important 80%>
**Important**\\  OLED displays of 52/MX, 52/RX and 52/SX modules do not support UTF-8 encoding. Only ASCII characters will be displayed. Unsupported characters will be displayed as ''¿''.
</WRAP>

<WRAP center round important 80%>
**Important**\\  Some UTF-8 characters require additional characters for controlling their appearance, this defined in IETF UTF-8 RFC. This means that using special characters such as, for example, emojis, could reduce the amount of available length in labels. \\
**Example:** A channel name with one emoji inside will have a maximum length of 15 characters.
</WRAP>

<WRAP center round info 80%>
**Note**\\  It is only possible to add one additional character set.
</WRAP>


===== Pictures =====


Individual pictures can be imported to use them as TFT background and TFT graphics. The Picture file format is ''.png''. Alpha channel (transparency) is supported.

To add a resource file do following:

  * Click ''Add'', the Windows Explorer opens. Navigate to the designated file and open it.
  * The image is attached to your config file.
  * In the ''Label'' box, enter a distinctive name.
  * You can use the image now at ''<Device>/Views''. There is a ''Picture'' element available or you can choose it as ''Background Image'' on the view options tab. See [[tb9:TFT_view_creation|TFT View Creation and Design]] for further information on editing views.

If, for example your company's logo changes and is used in many TFT Views, you can use the ''Replace'' function. You can replace the attached file without changing its properties. 

**Toolbox v9.1.3 and higher:** To export a resource file as PNG, you can use the ''Export'' button.

[{{ tb9_resourcefiles.png?1000&nolink |//Adding Resource Files//}}]

=== TFT Display Resolutions ===

For usage as background image, please note the screen resolutions of your TFT hardware.

<WRAP center round important 80%>
**Important**\\  Make sure your image files have a maximum resolution of your TFTs maximum resolution as in the list below.
</WRAP>

^Type^Module Name^Resolution^Ratio^
|52-4018|TFT/Touch Display, 7" IPS|800x480|5:3|
|52-4010, 52-4012|10.1" Multitouch IPS TFT Display|1280x800|16:10|
|52-4510|10.1" TFT Display for housing|1280x800|16:10|
|52-5620, 52-5614|SX2|1280x800|16:10|
|52-5820, 52-5810 (upper 10" TFT Display)|RX2|1280x800|16:10|
|52-5810 (lower 7" TFT Display)|RX2|480x800|3:5|
|52-1156|TX 10.1" Multitouch Mixer|1280x800|16:10| 
|52-1114|52/DX|1280x800|16:10|

<WRAP center round important 80%>
**Important**\\  
Individual pictures can be used only with DSP cores including a microSD-card (52-744xA with 52-7450A Controller, 52-744xA with 52-7456A Controller, 52-7403C, 52-7402C, 52-7400C, 52-7420A, 52-7423A, 52-7424A, 52-7410A, 52-1804C, 52-1801C, 52-1810A, 52-1830A or later revisions).\\
\\
Individual pictures are **not** supported by TFT displays 52-4017 and 52-4015.
</WRAP>