Type: Mod
Name: ScreenShot Utility
Description: Takes screenshots ingame, it's really just that. With some rather useful utilities to position yourself or rename screenshots ingame etc.
Wiki page: Link
License: MIT
Version: 1.0.3
Release: 2015-07-23
Last Update: 2015-12-14
Tested-With-Factorio-Version: 0.12.27
Category: Helper, Convenience
Tags: User-Interface, Screenshots
License
License
Usage in modpacks: Always allowed, just send a PM to note me, no need to wait for confirmation.
Using code or other parts in other mods: Always allowed, just send a PM to note me, no need to wait for confirmation.
taking mod over when orphaned; anyone interested.
The MIT License (MIT)
Copyright (c) [2015] [Matjojo]
Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
Long description
Long description
Takes screenshots with the click of a button. You can edit the following parameters:
* Resolution (height and width)
* Zoom (you can do any 32-bit integer for this. but taking screenshots really big does make for some lag.)
* Show or no show the gui
* Show or not show the alt overlay
The name of the file is build of the following parts:
* "screenshot"
* *current game tick* (this to prevent overwriting of files)
* ".png"
The file location is printed in the chat after creation of the file, It will look as following:
"Screenshot saved to: "
"*Factorio folder*/script-output/*current game-tick*.png
How to use 'Position helper'
* Got to the position you want to take the screenshot at.
* Press 'update'
* The text boxes will have updated.
* If you are sure this is the position you want to take the screenshot at click save position.
* Then you can go to wherever you want to go to to edit the screenshot you are taking.
* Press 'Teleport' and see yourself be teleported to the same spot.
How to use 'offset picture'
* Type in the amount of tiles you want the picture to be offset from the player.
* you can now take screenshots. The Gui piece will disappear but the entered number will be remembered in session.
Pictures
Pictures When idle:
When editing settings.
Version history
Version history
Version 1.0.0 (25-10-2015): Release
Version 1.0.1 (28-10-2015): Fixed a bug where the gui wouldn't appear when the scenario had already
started
Version 1.0.2 (28/10/2015): Added a daytime button
Version 1.0.3 (03/11/2015): Added functions to help with player alignment and offset screenshots
Version 1.0.3 (14/12/2015): Added in session saving of "show gui" and "show alt overlay" buttons
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Tue Oct 27, 2015 2:46 am
by DOSorDIE
Its works only in a new game ... cant use it on a existing game.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Wed Oct 28, 2015 11:28 am
by matjojo
DOSorDIE wrote:Its works only in a new game ... can't use it on an existing game.
It works for me, what version of factorio are you using and what does it say?
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Wed Oct 28, 2015 1:16 pm
by MrDrummer
Which version is this intended for? It says it is tested with 0.12.10, yet is for 0.12.11+... I am that guy that has 50+ mods and does not want to update until I am done with my current world (or i manage to edit each one with the game -> script changes)
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Wed Oct 28, 2015 1:20 pm
by MrDrummer
DOSorDIE wrote:Its works only in a new game ... cant use it on a existing game.
I can confirm this is true.
I am using the one for 0.12.13, but modified it by changing script. to game.
EDIT:
How do i forcefully make the GUI appear?
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Wed Oct 28, 2015 1:50 pm
by matjojo
MrDrummer wrote:Which version is this intended for? It says it is tested with 0.12.10, yet is for 0.12.11+... I am that guy that has 50+ mods and does not want to update until I am done with my current world (or i manage to edit each one with the game -> script changes)
well, that is a mistake for me, I'm currently running and testing in 0.12.13, so that is compatible. I'll take a look at the not appearing thing
Cannot execute command. Error: [string "game.player.gui.top.add{type= "flow", name="S..."]:1: Gui element with name SSU_flow_main already present in the parent element
Either way, it works. Hope you resolve why it does not show the button on load.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Thu Oct 29, 2015 10:40 am
by matjojo
MrDrummer wrote:I should add that I did have a poke at the control file to test which command made it appear on load, so that may link to the error which says:
Cannot execute command. Error: [string "game.player.gui.top.add{type= "flow", name="S..."]:1: Gui element with name SSU_flow_main already present in the parent element
Either way, it works. Hope you resolve why it does not show the button on load.
I fixed it indeed, thanks for the wait
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Fri Oct 30, 2015 5:29 am
by Peter34
I want to take "serial" screenshots showing the gradual building of a setup, e.g. a 2x1/13/10 Boiler/Steam Engine setup, for use in the UnOfficial FAQ. But I don't want my character to be in the middle of the screenshot, I want him to be offset towards the corner of the screenshot (in my case I favour lower left corner).
So will you consider adding an offset functionality to your mod? I now know how to use the console now, thanks to help in this thread: https://forums.factorio.com/forum/vie ... 49&t=16935 ...but it'd still be nice to have a mod that handles things for me, including screenshot files not just overwriting each other but instead having unique names so that I can stay in-game as I take them all.
Actually, I don't usually need my character to be in the screenshots I take (since they're for teaching purposes). What I need is for each screenshot in a series (e.g. power01, power02 progressing up to power08 or power11 or whenever I'm done) to be of the exact same game world area. Currently, I accomplish this by building an L-shaped structure of Chests or Wall, and then wedging my character as thoroughly into the inner corner as I can, before taking each screenshot, so that they'll all be of the exact same pixel area, or at least close.
But some sort of "lock coords" functionality added to the screenshot mod would be nice, since that would quite possibly achieve perfect pixel accuracy/overlap whereas my manual method probably deviates by a few pixels now and then.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Fri Oct 30, 2015 2:25 pm
by matjojo
Peter34 wrote:I want to take "serial" screenshots showing the gradual building of a setup, e.g. a 2x1/13/10 Boiler/Steam Engine setup, for use in the UnOfficial FAQ. But I don't want my character to be in the middle of the screenshot, I want him to be offset towards the corner of the screenshot (in my case I favour lower left corner).
So will you consider adding an offset functionality to your mod? I now know how to use the console now, thanks to help in this thread: https://forums.factorio.com/forum/vie ... 49&t=16935 ...but it'd still be nice to have a mod that handles things for me, including screenshot files not just overwriting each other but instead having unique names so that I can stay in-game as I take them all.
Actually, I don't usually need my character to be in the screenshots I take (since they're for teaching purposes). What I need is for each screenshot in a series (e.g. power01, power02 progressing up to power08 or power11 or whenever I'm done) to be of the exact same game world area. Currently, I accomplish this by building an L-shaped structure of Chests or Wall, and then wedging my character as thoroughly into the inner corner as I can, before taking each screenshot, so that they'll all be of the exact same pixel area, or at least close.
But some sort of "lock coords" functionality added to the screenshot mod would be nice, since that would quite possibly achieve perfect pixel accuracy/overlap whereas my manual method probably deviates by a few pixels now and then.
I actually saw your thread when researching the usability of a screenshot-taking mod. So here we go:
Thanks for the interest in SSU.
* the screenshots taken in SSU will NEVER overwrite if taken in the same world. (reloading the world also won't stop this function.)
* Offset functionality is actually something I never thought about. sounds like a good idea. I'm going to take a look at the possibilities.
* I also am going to add custom naming usability, that way you won't be stuck to the current naming scheme of the current game tick. But it still will be there as backup.
* Lock coörds will be possible to do within one session, but between sessions this won't remember your position, whoever I might be able to let you type in coörds to 'lock' you in there every time you take a screenshot.
thanks for the suggestions.
matjojo
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Sat Oct 31, 2015 11:07 am
by Peter34
matjojo wrote:
* I also am going to add custom naming usability, that way you won't be stuck to the current naming scheme of the current game tick. But it still will be there as backup.
I don't actually think that's necessary. Being able to just take a whole bunch of screenshots at once is enough. In the file folder they'll be sortable by date stamp or by file name, and then the user can manually rename them.
I mean, sure, it'd be a neat functinality, but I'm just questioning whether it's worth the effort required to implement it.
matjojo wrote:
* Lock coörds will be possible to do within one session, but between sessions this won't remember your position, whoever I might be able to let you type in coörds to 'lock' you in there every time you take a screenshot.
Locked coordinates don't have to persist between sessions, that would be unnecessary. It's not needed for didactic screenshots.
Some players might want to take "evolution" screenshot series of their factories, always using the same coords over the course of dozens of hours of play time (spread over several sessions), but then I think it's reasonable to expect them to input the coords manually.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Sun Nov 01, 2015 1:17 pm
by matjojo
Peter34 wrote:
I mean, sure, it'd be a neat functionality, but I'm just questioning whether it's worth the effort required to implement it.
It was like 10 mins work to add renaming. so that's already done.
Peter34 wrote:
Locked coordinates don't have to persist between sessions, that would be unnecessary. It's not needed for didactic screenshots.
Some players might want to take "evolution" screenshot series of their factories, always using the same coords over the course of dozens of hours of play time (spread over several sessions), but then I think it's reasonable to expect them to input the coords manually.
yeah, that was also the gist of where I was going, it's almost done, expect the update to go out in the following week.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Thu Nov 12, 2015 6:03 am
by Peter34
Any progress on this?
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Tue Nov 17, 2015 6:20 pm
by matjojo
Peter34 wrote:Any progress on this?
The update has been out for a while, I don't really know what extra things to add. I you want anything to be added please do say!
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Thu Nov 19, 2015 6:11 pm
by Peter34
matjojo wrote:
Peter34 wrote:Any progress on this?
The update has been out for a while, I don't really know what extra things to add. I you want anything to be added please do say!
Sorry. I tend to look for new posts in such threads, to announce a new version (since that also bumps up the thread to the top of the date-sorted sub-forum list), instead of looking under version history, so when there is no new post, I assume there is no new version.
Will your current version work with Factorio 0.12.10?
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Sun Nov 22, 2015 8:14 pm
by matjojo
Peter34 wrote:
matjojo wrote:
Peter34 wrote:Any progress on this?
The update has been out for a while, I don't really know what extra things to add. I you want anything to be added please do say!
Sorry. I tend to look for new posts in such threads, to announce a new version (since that also bumps up the thread to the top of the date-sorted sub-forum list), instead of looking under version history, so when there is no new post, I assume there is no new version.
Will your current version work with Factorio 0.12.10?
sorry for that late reaction, Yes, I'll always be testing in a rather new version, especially with the big changes going around currently. That information will always avaliable in the OP too.
I also will be adding new versions with a post from now on if I roll out a new update.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Sat Dec 05, 2015 11:51 pm
by Reika
Is there hotkey functionality? I am trying to take a picture of a tooltip, which is impossible if the image is only taken upon manually clicking your GUI. Also, do the "show GUI" and "show alt" options have to reset every time I take an image? I want them on permanently.
Re: [MOD 0.12.11+] {SSU} ScreenShot Utility
Posted: Wed Dec 09, 2015 3:21 pm
by matjojo
Reika wrote:Is there hotkey functionality? I am trying to take a picture of a tooltip, which is impossible if the image is only taken upon manually clicking your GUI. Also, do the "show GUI" and "show alt" options have to reset every time I take an image? I want them on permanently.
You currently as a modder do not have the possibility to create hotkeys. I would've if I could, I just can't.
The options do not HAVE to reset every time, I'll see and find time to edit this so that they will stay in the same setting between taking pictures, although I cannot retain settings between sessions of playing, I sadly do not have a lot of time on my hands so I don't think I can update before the next week or so, still. I'll go as fast a possible.