summaryrefslogtreecommitdiff
path: root/doc/classes/TextServerDummy.xml
blob: 7bf8738499a61b64052833a2319dfec2df74cdc6 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?xml version="1.0" encoding="UTF-8" ?>
<class name="TextServerDummy" inherits="TextServerExtension" version="4.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
	<brief_description>
		A dummy text server that can't render text or manage fonts.
	</brief_description>
	<description>
		A dummy [TextServer] interface that doesn't do anything. Useful for freeing up memory when rendering text is not needed, as text servers are resource-intensive. It can also be used for performance comparisons in complex GUIs to check the impact of text rendering.
		A dummy text server is always available at the start of a project. Here's how to access it:
		[codeblock]
		var dummy_text_server = TextServerManager.find_interface("Dummy")
		if dummy_text_server != null:
		    TextServerManager.set_primary_interface(dummy_text_server)
		    # If the other text servers are unneeded, they can be removed:
		    for i in TextServerManager.get_interface_count():
		        var text_server = TextServerManager.get_interface(i)
		        if text_server != dummy_text_server:
		            TextServerManager.remove_interface(text_server)
		[/codeblock]
		The command line argument [code]--text-driver Dummy[/code] (case-sensitive) can be used to force the "Dummy" [TextServer] on any project.
	</description>
	<tutorials>
	</tutorials>
</class>