PupSnap-2.6

Paint programs, vector editors, 3d modelers, animation editors, etc.
Message
Author
radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

PupSnap-2.6

#1 Post by radky »

PupSnap Screen Capture

Purpose and Base Features
PupSnap is a graphical user interface for Scrot (SCReenshOT) which is a command-line screen capture utility that uses the imlib2 library to acquire and save images.

Capture options
1 - Name: user choice (conventional name, current date, or automatic enumeration)
2 - Date: current date and time (date +%F_%R:%S)
3 - Delay: 0-60 seconds, or user choice
4 - Format: jpg, png, bmp, tiff
5 - JPG Quality: (10-100) higher values indicate lower JPG compression (larger file size) and higher image quality. In PupSnap, this option has no impact on BMP, PNG or TIFF images (see Setup Recommendations below).
6 - Size: select Default (original image size), or percent of the original image size (10-95), or standard pixel width (600px, 640px, 768px, 800px, 1024px, 1152px, 1280px, 1360px, 1366px, 1400px, 1440px, 1600px, 1680px, 1920px)
7 - Mode: full-screen, or interactively select a window or rectangular ROI

Post-capture options
1 - File Folder: user choice (the default save folder is /root/my-documents/images/)
2 - File Manager: ROX-Filer (if ROX is not available, PupSnap defaults to Thunar, PCManFM, SpaceFM or Xfe)
3 - Image Editor: defaultpaint, gimp, inkscape, mtpaint, LO-sdraw, OO-sdraw, xaralx
4 - Image Viewer: defaultimageviewer, fotoxx, geeqie, gpicview, gqview, gwenview, ristretto, viewnior, xnview
5 - Quick-view of captured image: automatic after capture, and on-demand at any time
6 - Image Hosting: upload screenshots (or any local image) to the imgur.com image hosting service

Setup Recommendations
Lossless file formats: BMP, PNG, TIFF
Lossless file compression means no image quality is lost when data is compressed and saved. As a general rule, with PupSnap (Scrot and the imlib2 library), you can ignore the Quality option when acquiring images in the BMP or TIFF formats. BMP images are saved with no compression, and TIFF images are saved with uniformly high compression at all Quality settings. The BMP format still enjoys widespread familiarity in the Microsoft Windows OS, while the TIFF format is popular with graphic artists and photographers, and has great utility in the publishing industry.

In PupSnap, the Quality setting of '0' is automatically applied when images are acquired in the PNG format. This default value overrides the other Quality settings for PNG images in Scrot, and approximates the maximum compression level of 9 in the GIMP and mtPaint graphic editors. Consequently, PupSnap provides PNG images of high (lossless) quality and convenient size (in kilobytes).

Lossy file format: JPG
Lossy file compression means some of the image quality is permanently lost when data in the JPG format is compressed and saved. Specifically, the JPG compression algorithm is very efficient and has the capacity to produce very small files (for web pages or email), but image quality degrades incrementally with each lower Quality setting (greater compression). Even at the maximum Quality setting of 100, there is moderate file compression and a slight loss of image quality. In most instances, depending on display requirements, Quality settings of 75-85 will produce compressed JPG images of acceptable quality and size, though lower values may be useful in some applications. Considering the limitations of the lossy JPG format, you may find the lossless PNG format is a better alternative for capturing screen images that retain high quality with data compression.

Caveats
1 - PupSnap supports a wide range of image editors and viewers. However, if your favorite graphics program is not included in the PupSnap support database, you can manually add the name of the executable to the appropriate combobox, with path or command switches if needed.

2 - Program access is by Puppy Menu->Graphic->PupSnap, or by the default Ctrl+Shift+S hotkey shortcut which is configured for IceWm, JWM, Openbox, Fluxbox, LXDE and LXPanel.

3 - Capture modes include full-screen, window and region (ROI). The window option can be selected with or without border decoration.

4 - The default image capture is full-size, but PupSnap also facilitates the acquisition of reduced-size images (thumbnails) which are available as a percentage of the original image size. Additionally, an array of pixel-options will capture images in standard screen sizes, or you can manually enter the desired pixel dimensions (width x height) in the Size option. For example, enter 200x0 to capture an image with a 200-pixel width. The '0' in the second field indicates the height of the captured image will be proportional to the selected width, and the aspect-ratio of the image is preserved automatically. For those who post images to the Puppy forum, the 800px option will automatically reduce a large screenshot to the maximum 800-pixel width which is forum compatible. However, many prefer a maximum width of 600 pixels to better comply with forum etiquette.

5 - PupSnap requires a file name for the captured image and gently reminds us if the Name entry box is blank.

6 - The default data for the Name entry box is the most recent prior capture. You can enter a new name for the next screen capture, or simply proceed with the acquisition and PupSnap will append a new name, with sequential enumeration — such as image-1 or image-2. If the file name selected in the entry box already exists in the current capture folder, PupSnap will not duplicate the name or overwrite the file, but will assign a new file name automatically, with enumeration.

7 - The Date option (date +%F_%R:%S) will assign the current date and time to the file name. When the Date checkbox is selected, PupSnap ignores the Name entry box. Conversely, when the checkbox is not selected (default mode), PupSnap ignores the Date option.

8 - When a capture option is selected, PupSnap will briefly close, conveniently excluding the GUI window from the captured image.

9 - When selecting a small capture region, start on the right side to avoid border artifacts.

10 - The optional 'Image Host' tab of PupSnap provides an intuitive interface for uploading screenshots (or any local image) to the popular imgur.com image hosting service. For screenshots, the image-file name and path are added automatically to the selection box of the Host tab. For local images, you can use the File-selector button, or drag-and-drop image files from ROX-Filer. If xclip or xsel are available, the uploaded image URL is sent automatically to the corresponding clipboard. Help resources and usage tips are available in the Imgur online FAQ. If desired, you can disable/remove this option by deselecting the 'Image Host' checkbox and restarting PupSnap.

Download
PupSnap-2.6 requires gtkdialog4 (0.7.21 or greater)

32-bit: For most Puppy derivatives
http://www.smokey01.com/radky/PupSnap-2 ... _32Bit.pet

64-bit: For Slacko64, Tahrpup64, Xenialpup64, Quirky/Easy OS
http://www.smokey01.com/radky/PupSnap-2 ... _64Bit.pet

Language support: Currently Spanish (gettext by vicmz)
If the NLS pet is required, please install before the main PupSnap pet.
http://www.smokey01.com/radky/PupSnap-2.4-NLS.pet

Main Interface
Image

PupMates
http://www.smokey01.com/radky/PupMates.html
Last edited by radky on Sat 23 Sep 2017, 03:14, edited 55 times in total.

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#2 Post by radky »

PupSnap-2.6
- Adjust user interface
- Add library support for screen capture in Slacko-7.x
- Add support for the new binary-detection heuristics of grep >= 2.21. Without this update, reduced-size screenshots may fail in Slacko-7 and other modern pups.
- Adjust compatibility with recent changes in Woof-CE

PupSnap-2.5.1
- Added support for jpg image format in Slacko-6.3.0.

PupSnap-2.5
- Added support for tahrpup64.
- Added support for Quirky April/April64/Wary64.
- Added support for Fatdog64 700.
- Bugfix: Folder selection without restarting PupSnap.
- Bugfix: Visualization of frame font with dark GTK themes.

PupSnap-2.4
- Internationalized (gettext by vicmz)
- Updated GUI with improved widget placement at all display resolutions.
- Updated icon set.
- Bugfix: failed detection of images in destination folder when most-recent image deleted.

PupSnap-2.3
- Improved datestamp when naming image files.
- Added support for Slacko64 (Note: support continues for Lighthouse64 and most 32Bit Puppies).
- Fatdog64 requires adding the imlib2 library from the FD64 package manager.

PupSnap-2.2.1
- Added support for spaces in directory names. (thanks greengeek)
- Removed the inconsistent xdialog folder selector. Added the gtkdialog folder selector.

PupSnap-2.2
- Added GUI support for the 96-dpi font metrics of Woof-built Puppies effective 2013-03-26.
- Improved GUI checkbox interaction when selecting capture modes (fullscreen, region, window, border).
- Converted combobox widget to comboboxentry.

PupSnap-2.1
- Restored functionality of the Image Host module by adding compatibility with the new Imgur API 3.

PupSnap-2.0
- New, intuitive interface with all capture options available on one tab.
- Added the option to send screenshots (or any local image) to the popular imgur.com image hosting service.

PupSnap-1.8
-Revised user interface with improved access to options.
-Added 'sticky' persistence to the date and border checkboxes (checked/unchecked status persists until changed by the user).
-The option for reduced-size images (thumbnails) no longer requires a checkbox to enable/disable.
-Added standard-pixel options for the automatic reduction (or enlargement) of captured images.
-PNG images are now saved automatically with high 'lossless' quality and maximum file compression.
-The configurable 'Quality' option of PupSnap now applies to JPG images only.
-Added support for the ristretto image viewer.
-Added support for the pcmanfm and pcmanfm2 file managers.
-Restored support for the Libreoffice Draw and OpenOffice Draw image editors.

Version 1.6.3
-Added 0.1 second delay (full-screen acquisitions) to assure complete dismissal of the PupSnap GUI prior to capture. (thanks Jim1911)

Version 1.6.2
-Added support for non-root environment (fido).

Version 1.6.1
-Added '600px' Thumbnail option, which automatically reduces a large screenshot to a forum-compatible 600-pixel width. (thank you aarf)
-Improved HTML code in Help file. (thank you abushcrafter)

Version 1.6.
-Enhanced design of the PupSnap Setup GUI.
-Enhanced tooltip Help resources.
-Enhanced launch wrapper to allow automatic recovery from aborted PupSnap sessions.
-Added single-click access to file management (ROX-Filer, Thunar, Xfe).
-Added auto-refresh of the image viewer (Precludes multiple, overlapping instances of the default viewer).
-Added auto-detection of image deletion (Click the View button and PupSnap searches for the most recent screen capture. If that image has been deleted, the search continues for other images in the current folder).

Version 1.5.1
-Updated help resources with recommendations for acquiring optimal screenshots. (thank you Jim1911)
-Added support for 64-bit Puppy derivatives such as Fatdog64 (thank you Billtoo for providing 64-bit builds of Scrot and the associated support files)

Version 1.5
-Added option to apply current date and time to the image file name. (thank you abushcrafter)
-When a new name is not selected for the File Name entry box, the capture proceeds with automatic sequential naming of images. (thank you r1tz)
-The most recent capture is now the default entry for the File Name.

Version 1.4
-Improved access to reduced-size (thumbnail) image acquisitions.
-Bug fix: jpg images were not captured at optimal resolution.

Version 1.3
-Improved access to help resources. (thank you bigpup)
-Added a few new icons.
-PupSnap is now available with or without scrot-0.8 in the PET download. (thank you Jim1911)

Version 1.2
-The File Editor and File Viewer options will show only the applications that are currently installed. (thank you sc0ttman)
-Added single-instance launch wrapper.
-Improved detection of the active window manager in Lighthouse Pup. (thank you tazoc)

Version 1.1
-Added full support for Slackware-based Lighthouse Pup. (thank you tazoc)
-Added hotkey support for Fluxbox.
Last edited by radky on Sat 23 Sep 2017, 03:15, edited 25 times in total.

Jim1911
Posts: 2460
Joined: Mon 19 May 2008, 20:39
Location: Texas, USA

#3 Post by Jim1911 »

This is a great little snapshot utility that is simple to use and can easily capture a window or just a segment of the desktop. This results in a smaller file size. Most advanced capture utility I've seen for Puppy.

Thanks,
Jim

nooby
Posts: 10369
Joined: Sun 29 Jun 2008, 19:05
Location: SwedenEurope

#4 Post by nooby »

Thanks for providing it.
I use Google Search on Puppy Forum
not an ideal solution though

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#5 Post by radky »

Jim and nooby, I appreciate the positive feedback. The Scrot command-line capture utility has been around for years and is very capable, and most of those features are now quickly available in the PupSnap GUI. You can preset the output quality and dimensions of the captured image, all the way down to thumbnail graphics for use on webpages, and I think the ability to automatically send images to your favorite graphic editor is a feature that most will find useful.

Thanks,
radky

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#6 Post by radky »

PupSnap 1.1 now provides full support for Slackware-based Lighthouse Pup.
Thanks tazoc.

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#7 Post by radky »

When exiting PupSnap, please use the GUI Close button. Terminating by Alt+F4 or by clicking the X in the title bar will disrupt configuration settings.

Thanks

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#8 Post by radky »

Version 1.2. See main post.
Last edited by radky on Sat 12 Feb 2011, 17:35, edited 1 time in total.

User avatar
ttuuxxx
Posts: 11171
Joined: Sat 05 May 2007, 10:00
Location: Ontario Canada,Sydney Australia
Contact:

#9 Post by ttuuxxx »

Looks a lot like a Pup-Shots knockoff http://www.murga-linux.com/puppy/viewto ... 1aa12925e4
even follows the same order of processes. Oh well reinventing the wheel I guess, lol
ttuuxxx
http://audio.online-convert.com/ <-- excellent site
http://samples.mplayerhq.hu/A-codecs/ <-- Codec Test Files
http://html5games.com/ <-- excellent HTML5 games :)

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#10 Post by radky »

ttuuxxx wrote:Looks a lot like a Pup-Shots knockoff...even follows the same order of processes. Oh well reinventing the wheel I guess, lol
ttuuxxx
Hi ttuuxxx,

Your Pup-Shots program is a fine utility and you have done a great job in providing a very nice graphical interface for the scrot capture utility. However, the underlying command structure is quite different in Pup-Shots and PupSnap. The only similarity is that both programs use scrot and the imlib2 library to capture a screen image. That said, I have enjoyed your program, and I’m sure many others find it equally useful. Hopefully, the Puppy community will find a place for both Pup-Shots and PupSnap.

Thanks for your thoughts, :)
radky

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

PupSnap-1.3

#11 Post by radky »

Version 1.3. See main post.
-Improved access to help resources.
-Added a few new icons.
-PupSnap is now available with or without scrot-0.8 in the PET download.

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

Updated PupSnap-1.3

#12 Post by radky »

PupSnap-1.3 uploaded to the forum on 2/12/2011 has an error in the GUI display at higher global screen dpi settings. This error has been corrected for both pets in the upload of 2/13/2011. The version number has not changed. Those who downloaded yesterday may want to retrieve the updated version.

Thanks

User avatar
abushcrafter
Posts: 1418
Joined: Fri 30 Oct 2009, 16:57
Location: England
Contact:

#13 Post by abushcrafter »

Thanks this is very nice. At first I thought Pup-Shots was better but I have found that I like this one more.

I have a customised "jwmrc-personal". PupShap puts the hotkey in a comment. So of course it does not work. I would also recommend changing the hotkey to using a "win/super/hyper/meta" key or changing it to use the "Print Screen" key.

Here is the part of my "jwmrc-personal" config that PupSnap puts the hotkey in:

Code: Select all

	<!-- The move mode (outline or opaque) -->
	<MoveMode>outline</MoveMode>

	<!-- The resize mode (outline or opaque) -->
	<ResizeMode>outline</ResizeMode>


	<!-- Key bindings -->

	<!-- The mask of "H" is for the Win/Super key. -->
<!-- Disabled due to bug in Wary 500.
	<Key mask="H" key="m">exec:pmount</Key>
	<Key mask="H" key="f">exec:rox --dir="/"</Key>
	<Key mask="H" key="t">exec:rxvt</Key>
	<Key mask="H" key="r">exec:gmrun</Key>
	<Key mask="H" key="s">exec:sleep 1 && xset dpms force off</Key>

	<Key mask="H" key="Up">exec:amixer set Master 5%+</Key>
	<Key mask="H" key="Down">exec:amixer set Master 5%-</Key>
	<Key mask="H" key="q">exec:amixer set Master toggle</Key>
<Key mask="CS" key="s">exec:PupSnap</Key>

	<Key mask="H" key="d">showdesktop</Key>
 -->
	<Key mask="ACS" key="d">showdesktop</Key>

	<Key key="XF86AudioRaiseVolume">exec:amixer set Master 5%+</Key>
I do like the error sound feature.

Which puppy version was the Scot binary compiled on?
[url=http://www.adobe.com/flashplatform/]adobe flash is rubbish![/url]
My Quote:"Humans are stupid, though some are clever but stupid." http://www.dependent.de/media/audio/mp3/System_Syn_Heres_to_You.zip http://www.systemsyn.com/

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#14 Post by radky »

abushcrafter wrote:I have a customised "jwmrc-personal". PupSnap puts the hotkey in a comment. So of course it does not work. I would also recommend changing the hotkey to using a "win/super/hyper/meta" key or changing it to use the "Print Screen" key.
Hi abushcrafter,

Thanks for your comments and helpful suggestions. The current default ‘Ctrl+Shift+S’ keyboard shortcut in PupSnap is one that does not interfere with the hotkeys of other common programs, and is configured to install automatically in IceWM, JWM, Fluxbox, LXPanel and Openbox. Of course, such automation assumes a relatively standard configuration file in each panel or window manager. Custom configurations, as in your example of a jwmrc-personal file with commented code, may exclude the key binding from the command sequence.

I really like the idea of linking the keyboard shortcut to a "win/super/hyper/meta" key, or to the standard "Print Screen" key. However, with the initial installation I did not want to automatically add a hotkey sequence that potentially could overwrite the keyboard shortcut of another program — such as a screen capture utility which is already linked by keycode="111" to the “Print Screen
Last edited by radky on Mon 21 Feb 2011, 03:23, edited 2 times in total.

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#15 Post by radky »

duplicate

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

PupSnap-1.4

#16 Post by radky »

Version 1.4. See main post.
-Improved access to reduced-size (thumbnail) image acquisitions.
-Bug fix: jpg images were not captured at optimal resolution in prior versions. Please update to PupSnap-1.4.

User avatar
r1tz
Posts: 162
Joined: Thu 09 Sep 2010, 05:19
Location: In #puppylinux (IRC)

#17 Post by r1tz »

I like this.

cp /usr/local/PupSnap/pupsnap2.rc /usr/local/PupSnap/pupsnap.rc

will easily solve the conf problem.

I found typing in file name every time troublesome so i did this

Code: Select all

if [ "$FILENAME"= "" ]
then
FILENAME=picture
fi

num=1
while [ -f "$FOLDERNAME""$FILENAME"."$FILETYPE" ]
do
FILENAME="$(echo picture"$num")"
let num=num+1
done

Jim1911
Posts: 2460
Joined: Mon 19 May 2008, 20:39
Location: Texas, USA

#18 Post by Jim1911 »

r1tz wrote:I like this.

cp /usr/local/PupSnap/pupsnap2.rc /usr/local/PupSnap/pupsnap.rc

will easily solve the conf problem.

I found typing in file name every time troublesome so i did this

Code: Select all

if [ "$FILENAME"= "" ]
then
FILENAME=picture
fi

num=1
while [ -f "$FOLDERNAME""$FILENAME"."$FILETYPE" ]
do
FILENAME="$(echo picture"$num")"
let num=num+1
done
Good idea, but I don't know where to add the code. Adding it to the bottom of /usr/local/PupSnap/pupsnap.rc did nothing.

Thanks,
Jim

radky
Posts: 977
Joined: Mon 03 May 2010, 03:13

#19 Post by radky »

r1tz wrote:I like this.

cp /usr/local/PupSnap/pupsnap2.rc /usr/local/PupSnap/pupsnap.rc

will easily solve the conf problem.

I found typing in file name every time troublesome so i did this

Code: Select all

if [ "$FILENAME"= "" ]
then
FILENAME=picture
fi

num=1
while [ -f "$FOLDERNAME""$FILENAME"."$FILETYPE" ]
do
FILENAME="$(echo picture"$num")"
let num=num+1
done
Hi r1tz,

Thanks for the suggestion. I'll see what I can do. :)

User avatar
abushcrafter
Posts: 1418
Joined: Fri 30 Oct 2009, 16:57
Location: England
Contact:

#20 Post by abushcrafter »

Some recommendations and bugs:
  • If one forgets to enter file name and has the thumbnail check box ticked. It does not remember that the thumbnail check box is ticked.
  • Please use a "&" at the end of the error sound command. I have one that is a few secs long.
  • What about the default location being "/tmp"?
  • Change window title to "PupShots" from "PS".
  • "Help" tab be renamed to "About/Help/Config".
  • Default image format of PNG instead of JPG.
  • Option to use Date & Time for file name. Here is a date command you can use:

    Code: Select all

    date +%F_%R:%S
[url=http://www.adobe.com/flashplatform/]adobe flash is rubbish![/url]
My Quote:"Humans are stupid, though some are clever but stupid." http://www.dependent.de/media/audio/mp3/System_Syn_Heres_to_You.zip http://www.systemsyn.com/

Post Reply