Difference between revisions of "CreateScreenshot"

From The Official Visionaire Studio: Adventure Game Engine Wiki
(Redirected page to Global Command: createScreenshot)
 
(8 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<div class="toccolours mw-collapsible mw-collapsed tbl-ds">
+
#REDIRECT [[Global Command: createScreenshot]]
<span class="bold">Command History</span>
 
<div class="mw-collapsible-content">
 
<div class="alt-bg">Available since v3.7</div>
 
</div></div>
 
 
 
 
 
A user can create a screenshot to be used for the next save game or to save into an external folder as a .png file.
 
 
 
 
 
Syntax:
 
<syntaxhighlight>
 
createScreenshot("filename", {flags=1, clear})
 
</syntaxhighlight>
 
 
 
 
 
Example 1: basic save screenshot to x folder! (if a file with the same name exists: it will be automatically overwritten!)
 
<syntaxhighlight>
 
-- save to "screenshots" folder as "filename.png"!
 
createScreenshot("screenshots/filename.png")
 
</syntaxhighlight>
 
 
 
Example 2: save screenshot to x folder with both file name + time stamp!
 
<syntaxhighlight>
 
-- add this as an execute script action inside of a key input; change "filename to whatever you like!
 
 
 
-- save to "screenshots" folder as "filename_(date)_(time).png"!
 
local time = os.date("%Y-%m-%d_%Hh-%Mm-%Ss")
 
createScreenshot("screenshots/filename_" .. time .. ".png")
 
</syntaxhighlight>
 
 
 
Example 3: save screenshot to x folder with time stamp only!
 
<syntaxhighlight>
 
-- add this as an execute script action inside of a key input!
 
 
 
-- save to "screenshots" folder as "(date)_(time).png"!
 
local time = os.date("%Y-%m-%d_%Hh-%Mm-%Ss")
 
createScreenshot("screenshots/" .. time .. ".png")
 
</syntaxhighlight>
 
 
 
 
 
 
 
<span class="bold underline">Arguments</span>
 
 
 
<span class="bold">filename</span>: "string" <br/>
 
If specified the screenshot will be saved to the given path. Otherwise the screenshot will be used for the next savegame(s), as long as a new screenshot is created or the current screenshot is cleared. If a screenshot for a savegame was created before it will be overwritten by the new screenshot.
 
 
 
 
 
<span class="bold underline">Flags</span>
 
 
 
<span class="bold">clr/clear</span>: bool <br/>
 
If true the screenshot will be cleared. Default value is false. If the screenshot is cleared it will be generated automatically by the engine again, everytime the scene is changed from a playable scene to a menu.
 
 
 
 
 
<span class="bold underline">Return</span>
 
 
 
none
 
{{i18n|CreateScreenshot}}
 

Latest revision as of 13:23, 19 May 2023