Explorar o código

Merge pull request #76699 from MewPurPur/document-text-server-dummy

Max Hilbrunner %!s(int64=2) %!d(string=hai) anos
pai
achega
76599bed51
Modificáronse 1 ficheiros con 14 adicións e 0 borrados
  1. 14 0
      doc/classes/TextServerDummy.xml

+ 14 - 0
doc/classes/TextServerDummy.xml

@@ -1,8 +1,22 @@
 <?xml version="1.0" encoding="UTF-8" ?>
 <?xml version="1.0" encoding="UTF-8" ?>
 <class name="TextServerDummy" inherits="TextServerExtension" version="4.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
 <class name="TextServerDummy" inherits="TextServerExtension" version="4.1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="../class.xsd">
 	<brief_description>
 	<brief_description>
+		A dummy text server that can't render text or manage fonts.
 	</brief_description>
 	</brief_description>
 	<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>
 	</description>
 	<tutorials>
 	<tutorials>
 	</tutorials>
 	</tutorials>