Merge pull request #976 from MihailRis/screenshot-function

add gui.screenshot function

doc/en/scripting/builtins/libgui.md

@@ -61,6 +61,12 @@ gui.set_active_frame(
     -- Used for custom projection (e.g., in 3D)
     [optional] cursorLocator: function() -> number, number
 )
+
+-- Creates a screenshot of a frame as a Canvas object if the frame ID is specified, or the entire window if nil.
+gui.screenshot(
+    -- ID of the frame created via gui.create_frame
+    [optional] frameId: str
+) -> Canvas | nil
 ```
 
 ## Markup

doc/ru/scripting/builtins/libgui.md

@@ -69,6 +69,12 @@ gui.set_active_frame(
     -- Используется для пользовательской проекции (например в 3D)
     [опционально] cursorLocator: function() -> number, number
 )
+
+-- Создаёт снимок фрейма в виде объекта Canvas если указан id фрейма, или всего окна, в случае nil.
+gui.screenshot(
+    -- id фрейма, созданного через gui.create_frame
+    [опционально] frameId: str
+) -> Canvas | nil
 ```
 
 ## Разметка