EAAS/NFV>> nsu>> 返回
项目作者： Senketsu

项目描述 ：
Simple screenshot library & cli tool made in Nim
高级语言： Nim
项目地址: git://github.com/Senketsu/nsu.git
创建时间： 2015-12-12T00:37:42Z
项目社区：https://github.com/Senketsu/nsu
开源协议：MIT License
下载


Nim Screenshot Utility (nsu)

This library/tool was made for Pomf It !

Contents

About:

Nsu is very simple and small screenshot library / tool with very basic functionality.
Its was made as replacement of external tool dependancy for pomfit (‘scrot’).

This library is crossplatform (Windows & Linux).
On Windows it was implemented through the old win32 api.
On Linux based systems, it was implemented through the x11 api.
OSX support not planned unless someone donates a macbook.

Note: You can compile this library to cmd line tool.

Requirements:

  • Nim compiler and nimble package manager. *(preferably nim 0.18.0 and up)
  • For compiling, this library depends on x11 oldwinapi and png Nimble packages.
  • For runtime, libpng and zlib.

Installation:

Nimble:

Run nimble install nsu. Nimble will install both binary and library for you.

Manual:

You can build nsu as standalone tool, a lesser(?) brother of scrot.
Use nimble to install x11 oldwinapi png packages.

  1. git clone https://github.com/Senketsu/nsu.git
  2. cd ./nsu
  3. nim c nsu.nim

Copy or symlink the binary into your /usr/local/bin directory.

Troubleshooting:

Compiling issues:
Please make sure you are using Nim >=0.18.0
If you are using older Nim compilers (0.17.x and below), please compile with ‘-d:deprecated’
(and update your build system)
Windows & libPNG
You might have issues with libpng as the wrapper is more up to date then the libraries Nim is shipped with.
(as of April 01 2018 | Nim 0.18.0)
If you have up to date libraries from another source or you build them yourself, good on you !

Usage:

binary

  1. Usage: nsu [options] .. [filename]
  2.   Options with no arguments or group of options with only one having argument,
  3.    can be put in one section.
  4.    e.g: nsu -acd:5
  5.    (Takes active window screenshot with countdown of 5 seconds.)
  7. Options: [arguments]
  8.   -h, --help         Shows this help screen
  9.   -v, --version         Will print current version information.
  10.   -s, --select         Lets you choose area or window to capture.
  11.   -a, --active         Will capture active window screenshot.
  12.   -f, --full         Will capture full screen.
  13.   -d, --delay [num]     Will delay capturing by given number of seconds.
  14.   -c, --count         Will show textual countdown of the delay.
  15.   -p, --path [text]     Will use given path to save ss into.
  17. Example:
  18.   nsu -fcd:5 -p:/home/senketsu/Pictures nsu_test.png
  19.   This will countdown from 5 seconds to capture full screen
  20.     and save it into my Pictures folder with the name nsu_test.

library

Simply include nsu into your project and use these calls.
Every call returns file path to newly made screenshot or empty string if it fails.

The main procedure

proc nsu_take_ss*(mode: NsuMode, fileName: string = "", savePath: string = "", delay:int = 0, countDown: bool = false): string =

  • @mode - NsuMode for screenshot [FULL, AREA,ACTIVE_WIN, SELECT_WIN]
  • @fileName - user specified filename (optional)
  • @savePath - user specified path to save into (optional)
  • @delay - Delay in seconds (useful only for FULL or ACTIVE_WIN mode screen shot) (optional) [max 15sec]
  • @countDown - To output countdow into stdout

Or you can call the convenience procs

proc nsu_active_win_ss*(fileName,savePath: string = "",delay: int = 0): string =

  • Convenience proc for active window screenshot. Optional fileName, savePath, delay parameters.

proc nsu_select_win_ss*(fileName,savePath: string = "",delay: int = 0): string =

  • Convenience proc for selected window screenshot. Optional fileName, savePath, delay parameters.

proc nsu_area_ss*(fileName,savePath: string = "",delay: int = 0): string =

  • Convenience proc for area(or selected window) screenshot. Optional fileName, savePath, delay parameters.

proc nsu_full_ss*(fileName,savePath: string = "",delay: int = 0): string =

  • Convenience proc to full screenshot. Optional fileName, savePath, delay parameters.

Contact