NkV README
NkV is an image viewer for Windows.
Installation
Copy nkv.exe to a directory of your choice.
Uninstall
Delete nkv.exe, position and wallpaper.bmp if any. Nothing is written to the registry except for the wallpaper settings.
How to use
- Drop the file in the window to see the image
- Drop a folder in the window to see the first image file in the folder
- Right click on the window to display the menu
- Ctrl + right-click on the window while the image is displayed to display the context menu for that image file.
- If the image size is larger than the window size, dragging inside the window will scroll the image
- Use the mouse wheel to view the next or previous image in the same folder
- Files and folders can also be specified with command line arguments
- You can also read image data from standard input
For other functions and shortcut keys, refer to the menu displayed by right-clicking.
Supported formats
- Windows Bitmap 1/4/8/16/24 / 32bpp, RLE4, RLE8
- OS / 2 Bitmap 1/4/8 / 24bpp
- PNM (PBM, PGM, PPM)
- GIF (GDI + required)
- JPEG (GDI + required)
- PNG (GDI + required)
- TIFF (GDI + required)
GDI + is installed as standard on Windows XP and later.
Using the Susie plugin
You can use the Susie plugin to increase the supported formats. Place the Susie plugin in the same directory as nkv.exe or in the path specified by pluginsdir in the config file (see File section). You can explicitly specify which plugin to use using the pluginlist file (see File section).
The Susie plugin for archive files treats the archive file like a folder and displays the image files in the archive file.
If you have a Susie plugin that supports GIF, JPEG, PNG, TIFF, use the Susie plugin instead of GDI +.
You cannot use the Susie plug-in for images that does not support memory input.
The Susie plugin does not support Unicode. The image plug-in works in many cases because it is used for memory input, but the archive file plug-in cannot handle the file name in the archive file in Unicode.
When reading from standard input, Susie plugins that require a filename cannot be used.
If you use a plugin that causes problems when you pass an unsupported file to IsSupported (API to check if the file format is supported), specifying it in usepluginextinfo in config may improve it (File section). See config in).
If you cannot get the color depth (BPP) from the Susie plugin, the corresponding fields in the title bar and Image Information will be "?".
File[\s]
Find the file in the following location.
If the environment variable NKTOOLSPROF is not set Same directory as nkv.exe
If the environment variable NKTOOLSPROF is set % NKTOOLSPROF% \ nkv
config
Initial setting.
Background color (default: system window background color)
Scaling filter on / off (default: off)
Fit Image on / off (default: off)
Fit Large Image on / off (default: off) to fit the display size to the window only for images larger than the window
Window width at startup (default: 640) (* 1)
Window height at startup (default: 480) (* 1)
Hide / show window frame (default: off)
X coordinate of the upper left corner of the window at startup (default: value saved in the position file) (* 2)
Y coordinate in the upper left corner of the window at startup (default: value saved in the position file) (* 2)
Susie plugin directory (default: same directory as nkv.exe). If there is a pluginlist file, the specification is invalid. If you specify a relative path, it will be relative to the directory containing the config file.
Load in an existing window (default: off)
Grid size (in pixels) ( default: 8 )
- usepluginextinfo file [file ...]
Susie plugin that uses information on supported extensions (default: not specified). The plugin specified here is used only when the extension of the file to be read is included in the corresponding extension of the plugin (the supported extension is obtained by GetPluginInfo of the plugin API). This plugin will no longer be used when reading from standard input. Specify only the file name that does not include the plug-in path. You can specify multiple items by separating them with a space. The plugin specified here will display the corresponding extension in About Plugins.
- It is valid only when fitimage or fitlargeimage is on or started without specifying a file.
- If NkV is already running, the position of the newly launched NkV window will be the Windows default and the x, y specifications will be ignored.
If you want the windows to always be displayed in the same size and position, turn on fitimage or fitlargeimage and set x, y, w, h.
keymap
Key customization settings. See keymap-default for a setting example.
pluginlist
Plugin list. Describe in one file per line. If this file exists, it will use the plugins in the order written in the file.
position
Window position. Will be created automatically when finished
wallpaper.bmp
Select "Set As Wallpaper ..." from the menu and set it as wallpaper, and it will be created automatically.
Scaling filter
When Scale Filter is enabled, bilinear is used when the scaling ratio is 50% or more, and the area averaging method is used when the scaling ratio is less than 50%. The image data after decoding is always regarded as the sRGB color space, and processing is performed assuming sRGB gamma.
Save image
The image saved by Save As ... is an image converted to RGB 24bit or 8bit grayscale (always RGB 24bit if the save format is other than BMP) in the displayed size.
Text Information column of Image Information
When using GDI +, the following GDI + property tags that can be obtained are displayed.
- PropertyTagGpsLatitude
- PropertyTagGpsLongitude
- PropertyTagImageDescription
- PropertyTagEquipMake
- PropertyTagEquipModel
- PropertyTagOrientation
- PropertyTagSoftwareUsed
- PropertyTagDateTime
- PropertyTagArtist
- PropertyTagCopyright
- PropertyTagICCProfile (profile description)
When using the Susie plugin, the text information provided by the plugin (hInfo of the plugin API GetPictureInfo) is displayed.
Limitations
- The value displayed by Show Color Value is the RGB value after conversion to RGB 24-bit or 8-bit grayscale. It may differ from the RGB value of the actual data
- Archive files inside archive files cannot be expanded
- No consideration is given to the 256-color environment
- The Format: column of Image Information examines and displays the image format independently of the Susie plug-in. Only BMP, GIF, JPEG, PNG, PNM, TIFF are displayed.
- The grid is displayed in Show Gird only when the magnification is 100% or more.
Report a problem
Send it to
bug-XXXX@nk2.org (replace XXXX with nkv).
Copyright notice
Copyright (C) 1999-2019 Nobuyuki Honda
The Software is provided "as is" and without warranty of any kind, either explicit or implied. The author does not take any responsibility for any damage caused by using this software.
We allow everyone, including commercial applications, to use the Software for any purpose and to freely modify and redistribute it, subject to the following restrictions.
- You must not misrepresent the origin of this software. Do not claim that you created the original software. If you use the software within a product, we would appreciate it if you could acknowledge the product documentation, but it is not required.
- If you change the source, you must make it explicit. Do not misrepresent that it is the original software.
- You may not remove this display or change the content of the display from the source distribution.
This software is provided'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software.
Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions:
- The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required.
- Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software.
- This notice may not be removed or altered from any source distribution.