From 708a3b3db82650a9657d0f8f7c2e4d4fb02ca32e Mon Sep 17 00:00:00 2001
From: kobewi <kobewi4e@gmail.com>
Date: Wed, 4 May 2022 02:11:07 +0200
Subject: [PATCH] Improve Viewport.get_texture() description

---
 doc/classes/Viewport.xml | 17 ++++++-----------
 1 file changed, 6 insertions(+), 11 deletions(-)

diff --git a/doc/classes/Viewport.xml b/doc/classes/Viewport.xml
index ce466b2d0f4..148c6d70643 100644
--- a/doc/classes/Viewport.xml
+++ b/doc/classes/Viewport.xml
@@ -75,17 +75,12 @@
 			<return type="ViewportTexture" />
 			<description>
 				Returns the viewport's texture.
-				[b]Note:[/b] Due to the way OpenGL works, the resulting [ViewportTexture] is flipped vertically. You can use [method Image.flip_y] on the result of [method Texture2D.get_image] to flip it back, for example:
-				[codeblocks]
-				[gdscript]
-				var img = get_viewport().get_texture().get_image()
-				img.flip_y()
-				[/gdscript]
-				[csharp]
-				Image img = GetViewport().GetTexture().GetImage();
-				img.FlipY();
-				[/csharp]
-				[/codeblocks]
+				[b]Note:[/b] When trying to store the current texture (e.g. in a file), it might be completely black or outdated if used too early, especially when used in e.g. [method Node._ready]. To make sure the texture you get is correct, you can await [signal RenderingServer.frame_post_draw] signal.
+				[codeblock]
+				func _ready():
+				    await RenderingServer.frame_post_draw
+				    $Viewport.get_texture().get_image().save_png("user://Screenshot.png")
+				[/codeblock]
 			</description>
 		</method>
 		<method name="get_viewport_rid" qualifiers="const">