Copyright: Copyright (c) 2003 Okino Computer Graphics, Inc.


Okino Bitmap Editor and Viewer
Okino Bitmap Editor, Viewer & Capture

This plug-in system is a general purpose image bitmap editor, bitmap viewer, video viewer and bitmap capture program. It allows every major 2D bitmap file format to be loaded, viewed, manipulated and re-saved in almost every major 2D bitmap file format. A wide range of multi-media video formats can also be played back, but not modified. Numerous image manipulation functions and operations are provided, as well as access to various image manipulation plug-ins.

This plug-in system also acts as an "image server" to the rest of the host Okino PolyTrans/NuGraf software. Thus, other aspects of the Okino software can call on this plug-in system to load in specific files (such as specific frames of a Flash, Quicktime or AVI file), or save them out to another file format.

NOTE: The bitmap editor is a modeless window. This means that you can keep this window open while working elsewhere in the main program. If you have dual monitors then you can move the bitmap editor over to the main window and it can remain open at all times. If you press the "X" button on the bitmap editor's toolbar, or press the normal Windows close tiny icon, then the bitmap editor will be hidden from view but not terminated; the editor can be unhidden by selecting it from the "Windows" main program menu.

Disclaimer: this Okino plug-in system was originally written to be a nice, easy to use, simple bitmap image viewer. It grew from this simple beginning into a general purpose bitmap image viewer, editor and image capture program. It was not meant to, nor does, compete with the capabilities and features of a dedicated bitmap editing and manipulation program. However, it does act as a major backbone to the overall Okino software.

Help File Contents

Features of this Program

Important Usage Concepts

Supported File Formats

Menu Descriptions

File Menu

Edit Menu

Image Menu

Color Menu

Video Menu

Help Menu

Keyboard function keys

Other Dialog Box Descriptions

Bitmap Editor Options

File Save and Load Options

Area Capture Options

New Canvas Options

Copyright © 1988-2003 Okino Computer Graphics, Inc.


Features of this Program
Features of this Editor, Viewer & Capture Program

File Format "Image Server"

Adds dozens of additional import/export 2D bitmap, Quicktime, DirectShow, video and Flash file formats as an "image server" to the rest of the main PolyTrans/NuGraf software. For example, the main NuGraf scanline/ray-trace renderer can accept 2D texture maps from any of the 2D bitmap, video or Flash input file formats supported by the editor plug-in.

Image Resizing and Manipulation Options

Flip, reverse, rotate (by any degree), shear, trim extraneous parts and resize.

Color Modification Controls

1.	Change colored images to Halftone, 8 Bit Gray Scale or reduce to any number of bits using color reduction.

2.	Change the Brightness, Contrast, Hue, Saturation, Gamma and Intensity.

3.	Compute color histograms and use them to equalize the image or change its contrast.

4.	Invert the image colors or fill the current image (or defined region) with a predefined color.

5.	Find the number of unique colors in an image.

6.	Solarize or make contours from the colors in an image.

Image Digital Filtering

Gradient, Laplacian, Sobel, Prewit, Shift & Difference and Line Segment digital filters can be applied to the image.

Image Effects

Multiple image effects are provided, each with multiple parameters and interactive preview via custom dialog boxes: Posterize, Mosaic, Average, Median, Sharpen, Add Noise, Emboss, Underlay, Edge Enhance, and Oilify.

Changes Per-Image or Per-Region

"Regions", such as rectangular, elliptical, curved, Bezier, etc. can be defined on the image. Image operations can then be applied to these regions instead of the whole image.

Extensive Bitmap Capture Capabilities

A hidden gem of this editor is its ability to capture bitmaps from a wide variety of useful sources on your computer.

•	A Window Area

•	The Active Window

•	The Active Window Client

•	The Window Under Cursor

•	The Full Screen

•	The Menu Under Cursor

•	The Window Object Under Cursor

•	The Mouse Cursor

•	The Wallpaper

•	From contents of .exe file (Dialog Tree) ...

•	From contents of .exe file (Dialog Tabbed View) ...

TWAIN-Compliant Capturing

•	A TWAIN compliant hosting mechanism is available which allows image to be captured from scanners, USB cameras and any other TWAIN compliant video source.

Modeless Windows Operation

•	The bitmap editor is a modeless window. This means that it can remain open at all times while working elsewhere in the main program. If you have dual monitors then you can move the bitmap editor over to the second monitor otherwise the main program will determine when to hide or resize the bitmap editor to keep it out of the way.

Multi-Media Video File Playback

•	Full support for viewing all Microsoft DirectShow and Apple Quicktime supported video and multi-media file formats.

•	Macromedia Flash viewing when Quicktime 6 or newer has been installed on the computer. Quicktime will convert the Flash (SWF) file to a QuickTime movie prior to playback.

Other Features

•	Full undo/redo mechanism allows image changes to be easily made and undone.

•	"Floaters" allow floating image areas (created by the region commands) to be placed over the main image.

•	A "magnifying" glass allows a rectangular region of the image to be zoomed interactively.

•	A "pan window" allows a large image to be navigated by moving a red rectangle in a smaller pan window.

•	Drag & drop 2D bitmap filenames from Windows Explorer, or from the Okino "Explore Mode" user interface to the bitmap editor to edit/view the files.


Supported File Formats
Supported Bitmap File Formats

This bitmap editor/viewer supports multiple sources of 2D bitmap file formats and multi-media vide formats. Some are read-only and some write-only.

1.	Okino supported bitmap file formats. Any 2D bitmap import and export file format normally supported by the stand-alone PolyTrans and NuGraf software applications are supported by this bitmap editor. Images imported from these converters will always be 24-bit RGB. Images exported to these file formats can be 1-bit to 32-bit, color mapped or true-color, depending on the options you select for each exporter. Please refer to the main PolyTrans or NuGraf help file for full explanation of these supported bitmap file formats.

2.	LEADTOOLS. These complement the existing Okino supported bitmap file formats. Descriptions are provided below.

3.	Microsoft DirectShow. These importers are used to view multi-media video formats such as AVI and MPEG.

•	Video: AVI, MPEG-1

•	Audio: .wav, .mpa, .mp2, .mp3, .au, .aif, .aiff, .snd

•	MIDI: .mid, .midi, .rmi

4.	Apple Quicktime. These importers are used to view multi-media video formats such as Quicktime Movies., audio, Macromedia Flash and various bitmap formats:

•	Video: QuickTime Movies (.qt, .mov, .mtv)

•	MPEG 1, 2, 4. MPEG-2 and -4 are optional components of QuickTime.

•	Macromedia Flash (SWF)

•	Audio formats: .wav,.mp3,.au,.aif,.aiff,.snd,.sf2

•	Image formats: .bmp, .dib, .gif ,.jpg, .jpeg, .mac, .pntg, .psd, .pict, .pic, .pct ,.png, .qtif,.qif, .qti, .sgi, .tga, .tif, .tiff, .fpx

LEADTOOLS Bitmap Import/Export Converter Descriptions

The following is a description of the 2D bitmap import/export converters supported via the LEADTOOLS libraries. This list is non-definitive and may contain discrepancies. Some file formats may not be included in this program if licensing changes with the LEADTOOLS libraries.

AFP, AFP Format

•	The AFP format is part of IBM's document imaging system. It is a raster format, created to add enhanced formatting and indexing capabilities to documents for print applications in finance, retail, insurance and other industries. LEAD provides support for the user to open MODCA/PTOCA or AFP/PTOCA documents.

•	The default extension used by this format is: AFP.

•	This file format does not support stamps or Lossless JPEG compression, but it does support multi-page files.

•	For AFP files, you can read the following bits per pixel: 24.

ANI, Windows Animated Cursor

•	ANI is an animated cursor (animated mouse pointer). This file format is used for reading and storing Windows Animated Cursors. The LEADTOOLS filter does not support transparency information within these files.

•	Multipage ANI files will have an icon on each page.

•	For ANI files, you can read and write the following bits per pixel: 1, 4, 8, 24.

BMP, BMP Formats

•	Windows Bitmap (BMP). This is a file format created by Microsoft. Some BMP images are compressed with an RLE-type compression.

o	You can read and write the following bits per pixel, without RLE compression: 1, 4, 8, 16, 24, 32.

o	You can read and write the following bits per pixel, with RLE compression: 4, 8.

•	OS/2 Bitmap (OS/2 BMP). These are files created on an OS/2 operating system. LEADTOOLS supports both 1.x and 2.x formats.

o	You can read and write the following bits per pixel, without RLE compression: 1, 4, 8, 24.

o	You can read (but not write) the following bits per pixel, with RLE compression: 4, 8.

CMP, Lead 1-Bit Format

•	LEAD 1BIT is a proprietary 1-bit LEAD compressed format that has better compression and performance than other 1-bit formats.

•	You can read and write files in this format.

CUT, Dr Halo

•	Dr. Halo files are device-independent images. The image is stored in one file (.CUT) and the palette is stored in a separate file (PAL). If the image has no corresponding .PAL file, it is considered a grayscale image.

•	For CUT files, you can read and write the following bits per pixel: 8.

EPS, PostScript Raster Images (No Vector Data) (Encapsulated PostScript).

•	These files are used primarily on PostScript printers. These printers usually offer more variety of fonts and higher resolution than standard laser printers. EPS files will work on any PostScript compatible printer and any end-user application that supports placement of EPS files in its work space.

•	The image that you read from an EPS file can be either a PostScript raster image or an embedded TIFF image. The image that you write to an EPS file is always a PostScript raster image.

•	For a PostScript raster image, you can read the following bits per pixel: 1, 8, 24.

•	For an embedded TIFF image, you can read the following bits per pixel: 1, 4, 8, 16, 24, 32.

•	You can write only an 8-bit PostScript raster image, which is grayscale.

Exif Formats (embedded TIFF or JPEG)

•	Exif is a standard for image files created with digital cameras and other input devices. The standard is set by the Japan Electronic Industry Development Association, and formally it is called the Digital Still Camera Image File Format Standard.

•	Exif files contain either uncompressed TIFF images or compressed JPEG images.

•	LEADTOOLS reads and writes the following Exif formats:

o	TIFF. This is a tag-based file format designed to promote universal interchanges of digital image data. You can save any image size.

•	You can read and write 24 bits per pixel.

o	JPEG. This is the JPEG format with YUV 4:2:2 sampling. You can save any image size.

•	You can read and write 24 bits per pixel. (Grayscale is not supported.)

FLC, Flic Animation

•	The Flic file is an animation file created by Autodesk. This file supports image data but not audio data.

•	The frames of this file can be of 8bpp image data. The maximum number of frames is 4000.

•	This file has two versions. The FLI file types support 320 X 200 images with a maximum of 64 colors per image. The FLC file types support up to 64k X 64k images with 256 colors per image.

•	For FLI files, you can read the following bits per pixel: 8.

•	For FLC files, you can read and write the following bits per pixel: 8.

GEM, GEM Image

•	These files are native to the Graphical Environment Manager developed by Digital Research. LEADTOOLS supports reading and writing of this 1-bit B&W format.

ICO and CUR, Icons And Cursors

•	Windows Icon (ICO). This is a multi-page file format for storing one or more Windows icons. The background color when you read these images is always black. The size when you write these images can be no larger than 255-by-255 pixels. (Neither the width nor height can be greater than 255.)

o	You can read and write 1, 4, 8, 16, 24, and 32-bit, single-page or multi-page files.

•	Windows Cursor (CUR). This is a file format for storing Windows cursors (mouse pointers). LEADTOOLS does not load or save transparency information in these files. The size when you write these images should be exactly 32-by-32 pixels.

o	You can read and write 1, 4, 8, and 24-bit, single-page or multi-page files.

IFF, Interchange File Format

•	IFF is a general purpose data storage format that can associate and store multiple types of data.

•	IFF reads RLE, and non-compressed images.

•	IFF writes only RLE compressed images.

•	For IFF files, you can read and write the following bits per pixel: 1 - 8, 24.

ITG and CIT, Intergraph Format

•	Intergraph is a monochrome bitmap format developed by Intergraph. LEADTOOLS supports the RLE and CIT versions of this file format.

•	The default extensions used by this format are: ITG and CIT.

•	This file format does not support stamps or Lossless JPEG compression. For this file format, LEAD supports CCITT G4 and RLE compression.

•	Currently LEAD writes only the ITG format.

•	For ITG and CIT files, you can read the following bits per pixel: 1.

•	For ITG files, you can write the following bits per pixel: 1.

FPX, Kodak FlashPix

•	The FlashPix file format was developed through the combined efforts of Eastman Kodak Company, Microsoft Corporation, Hewlett-Packard Company, and Live Picture Inc. It combines the best features of existing formats with object orientation to make the use of digital color images easier.

•	A FlashPix file may consist of several "pages" where each "page" has storage for a source image, non-image data in the form of comments, transform data, and a stamp or thumbnail. Each image is stored as an entire multi-resolution hierarchy where each resolution in the hierarchy differs from the next highest resolution by a factor of 2 in the x dimension and in the y dimension.

•	You can read and write the following bits per pixel: 8, 24.

MAC, MacPaint

•	These Macintosh Paint files are commonly used for monochrome clip art. LEADTOOLS supports reading and writing of this 1-bit B&W format.

MSP, Microsoft Paint

•	These files from early versions of Windows are used for black-and-white drawings and clip art. LEADTOOLS supports reading and writing of this 1-bit B&W format.

PCD, Kodak PhotoCD

•	This is a common high-resolution format for images on CD-ROM. An image file can contain one or more physical resolutions, with fixed dimensions. You can choose which resolution to load, and thus control the size of the resulting bitmap.

•	You can read the following bits per pixel: 8, 24.

•	You cannot write PhotoCD files. They are read-only.

PCT, PICT, Macintosh

•	PCT is the format used for Macintosh QuickDraw pictures.

•	LEADTOOLS supports version 1 and 2 of PCT.

•	For PCT files, you can read and write the following bits per pixel: 1, 4, 8, 16, 24.

CLP, Microsoft Windows Clipboard

•	CLP stands for Microsoft Windows Clipboard. This file format is used to store the contents of the clipboard to disk. The clipboard is an area of memory shared by the Windows operating system, and it is a simple mechanism for exchanging data between applications.

•	For CLP files, you can read and write the following bits per pixel: 1, 4, 8, 24.

PCX and DCX, Zsoft

•	LEADTOOLS reads and writes the following PCX formats:

o	PCX. This is a file format created by ZSoft. This format compresses its image data with the RLE type compression.

o	DCX. This is a multipage PCX format that enables a file to contain more than one image. It is handled the same as a regular PCX file, except for the multipage feature.

•	For PCX and DCX files, you can read and write the following bits per pixel: 1, 4, 8, 24.

PSD, Photoshop 3.0 Format

•	Photoshop 3.0 (PSD) is the format produced by the Adobe Photoshop graphics editor.

•	For PSD files, you can read and write the following bits per pixel: 1, 8, and 24.

•	You can also read and write layers to this file with the following bits per pixel: 8 (GrayScale), 24, and 32.

PBM, Portable Bitmap Utilities

•	The Portable Bitmap Utilities consists of Portable Greymap Utilities (PGM), Portable Pixmap Utilities (PPM), and Portable Anymap Utilities (PNM). Their source is the UNIX environment.

•	For PBM files, you can read and write the following bits per pixel: 1.

•	For PGM files, you can read and write the following bits per pixel: 8 (Grayscale).

•	For PPM files, you can read and write the following bits per pixel: 24.

PNG, Portable Network Graphics Format

•	PNG (Portable Network Graphics) is a replacement for the GIF format. It is a full-featured (non-LZW) compressed format intended for widespread use without legal restraints.

•	You can read the following bits per pixel: 1, 4, 8, 16, 24, 32.

•	You can write the following bits per pixel: 1, 4, 8, 24.

•	LEADTOOLS supports reading (but not writing) interlaced PNG files.

PTK, Presentation Text Object Content Architecture

•	The Presentation Text Object Content Architecture (PTOCA) is the data object used in document processing environments fro representing text, which has been prepared for presentation. Each file contains one or more pages of text and is always included as part of a document in a MODCA file. Each page may reference a PTOCA Overlay, which is merged with the text as a background.

•	There is no default extension.

•	This format originated at IBM.

•	This file format does not support QFactor, progressive loads and saves, stamps or Lossless JPEG compression, but it does support multi-page files.

•	For PTK files, you can read the following bits per pixel: 24.

•	LEAD does not save PTK files.

SCT, Scitex Continuous Tone Format

•	The Scitex Continuous Tone file format was developed by Scitex and is used for high-end image processing. The SCT/CT files are used primarily to store CMY and CMYK color space for the image. For saving the SCT file format, LEAD saves it as CMY instead of CMYK. This maintains the image quality, since the conversion from RGB to CMYK will result in some loss of data.

•	The default extensions used by this format are: SCT and CT.

•	This file format does not support progressive loads and saves, multi-page files, stamps, or Lossless JPEG compression.

•	For SCT/CT files, you can read the following bits per pixel: 24, 32.

•	For SCT/CT files, you can write the following bits per pixel: 24.

SGI, Silicon Graphics Image Format

•	The SGI file formats was developed at Silicon Graphics, and is used for black and white, gray-scale and color images. LEADTOOLS supports both uncompressed SGI and RLE compressed SGI.

•	For SGI files, you can read and write the following bits per pixel: 8, 24, 32.

SMP Format

•	The SMP file contains a 1-bit raster bitmap. It may be uncompressed, compressed using CCITT Group 3 or compressed using CCITT Group 4.

•	The default extension is .SMP.

•	This format was created by Xionics and is used in PixEdit for Techsoft.

•	This file format does not support QFactor, progressive loads and saves, multi-page files, stamps or Lossless JPEG compression.

•	For SMP files, you can read the following bits per pixel: 1.

•	LEAD does not save SMP files.

RAS, Sun Raster Files

•	SUN Raster (RAS) is a format native to Sun UNIX platforms.

•	For RAS files, you can read and write the following bits per pixel: 1, 4, 8, 24, 32.

TIFF, Without LZW Compression

•	LEADTOOLS reads and writes several TIFF formats that do not use LZW compression.

•	TIFF is a tag-based file format designed to promote universal interchanges of digital image data. Because TIFF files do not have a single way to store image data, there are many versions of TIFF. LEADTOOLS supports the most common TIFF formats. The usual file extension is TIFF for single-image files, and MPT for multipage files (which can contain many images).

•	LEADTOOLS can read and write TIFF files that use RGB, CMYK, or YCbCr color space. LEADTOOLS can also read and write files with PackBits compression.

•	LEADTOOLS can also read and write files with Lossless JPEG compression for 8, 12, and 16-bit grayscale and 24-bit color spacing.

•	LEADTOOLS can also read and write files with CMP compression for 8-bit grayscale and 24-bit color.

•	You can read the following bits per pixel, without regard for the color space: 1, 2, 3, 4, 5, 6, 7, 8, 16, 24, 32.

•	You can write the following bits per pixel, with RGB color space: 1, 2, 3, 4, 5, 6, 7, 8, 16, 24, 32..

•	You can write the following bits per pixel, with CMYK color space: 24, 32.

•	You can write the following bits per pixel, with YCbCr color space: 24.

TGA, Truevision TARGA Format

•	Truevision TGA (TARGA) is a file format created by Truevision Inc. LEADTOOLS supports all uncompressed and RLE compressed TGA file formats.

•	For TGA files, you can read and write the following bits per pixel in either uncompressed or RLE compressed form: 8, 16, 24, 32.

WBMP, Wireless Bitmap Format

•	The Wireless Bitmap file format is a 1-bit format used to send graphical information to a variety of handsets. It is terminal independent and describes only graphical information.

•	For Wireless Bitmap files, you can read the following bits per pixel: 1.

•	For Wireless Bitmap files, you can write the following bits per pixel: 1.

XWD, X Windows Dump

•	XWD stands for X Window dump. This file format is used to store and restore screen window images. Two versions of this file exist, the X10 window dump and the X11 window dump. These versions differ slightly in the format of the data (i.e. headers and bits per pixel).

•	The version X10 XWD file cannot have more than 8bpp image data.

•	For the version X10 XWD files, you can read and write the following bits per pixel: 1, 4, 8.

•	For the version X11 XWD files, you can read and write the following bits per pixel: 1, 4, 8, 16. 24, 32.

XPM, XPicMap Format

•	XPM files are used to store X Window PixMap information to disk. They are capable of storing black-and-white, grayscale, and color images. XPM stores image data in the form of ASCII text formatted as a standard C character string array.

•	For XPM files, you can read and write the following bits per pixel: 1, 8, 24.


Important Usage Concepts

"Bits per Pixel"

Bitmap images can be stored with different "bits per pixel". The more bits, the more colors that can generally be represented by the image. Common formats used by the built-in import/export converters are:

24-bits (RGB). Each red/green/blue (RGB) channel has 8 bits, or 256 shades. In total 16 million colors can be represented at each pixel. This is a very common format.

32-bits (RGBA). This is the same as 24-bit RGB images except that another "alpha channel" of 8 bits has been appended to each pixel. The alpha channel can be used for different purposes, one of which is as a "matte" that defines which areas of the image has valid data and which areas do not; this matte channel can be used to composite one image over top of another.

16-bits. Each red/green/blue (RGB) channel has 5 bits, or 256 shades, with one bit left over. In total roughly 32000 colors can be represented at each pixel. This is a less common layout.

8-bits color mapped. Each pixel is a single 8-bit value (one byte) which indexes into a common palette of 256 colors or 256 levels of gray. If an appropriate palette of colors is chosen this 8-bit format can produce good images as those represented by 24-bit images.

8-bits grayscale. Each pixel is a single 8-bit value (one byte) which represents 256 levels of gray (black to white transitions). If converted to RGB format, each red, green and blue pixel component will have the same intensity values.

4-bits. Each pixel is a single 4-bit value (half byte) which indexes into a common palette of 16 colors or 16 levels of gray.

1-bit. This is referred to as a B&W image, bitonal or 2 color image. Each bit can represent black or white, or the single bit can index into a 2 color palette. This format is most commonly used to represent B&W images.

Selection Areas

All operations which affect the colors in an image can either be applied to the entire image or to a selected sub-region.

To apply the image operation to a sub-region, select one of the "Region Selection" options from the Edit Menu. For example, you can select a rectangular region so that only that specific region gets modified during an image operation.

The following image shows an arbitrary region defined by using the "Free hand" region menu item:

Floaters

The bitmap manipulation engine used as the basis for this bitmap editor uses the concept of "Floaters". These are bitmap images that float on top of your base (originally loaded) image. For example, you could define a rectangular region then do "Edit/Copy as Floater" then "Edit/Paste as Floater" to paste this rectangular region back into the bitmap editor as a floating image.

File Drag & Drop

If you wish to view an image whose name is listed in Windows Explorer, or inside Okino's "Explore Mode" user interface lister, then drag & drop the filename on top of the bitmap viewer window. If you drag & drop a 3D file instead then the bitmap viewer will be hidden and the 3D file will be imported into the main NuGraf/PolyTrans software itself.


File Menu

Open...

Open and load and image from disk, replacing the current image shown on the editor. You will be prompted with a dialog box to select the desired bitmap import converter, as shown here.

Save As...

Save out the current image to a disk based file. You will be prompted with a dialog box to select the desired bitmap export converter, as shown here.

New Canvas…

This deletes the current image seen on the bitmap editor and replaces it with one which has the dimensions and color depth as selected by a dialog box.

Clear Canvas

This clears and deletes the current image shown on the bitmap editor. You will be given a choice to save the current image to disk if it has been modified.

Show Error List

Show Last Error

These allow any error messages from the internal bitmap manipulation engine and import/export bitmap converters to be viewed.

Acquire Image (via TWAIN)...

This allows an image to be acquired (captured) from a TWAIN compliant image capture device, such as a scanner or USB camera.

Capture Sub-Menu

The Capture menu contains a very powerful set of functions that will allow you to capture images from your computer or to extract resources from .exe files contained on disk.

Stop Capture

This will stop/abort the current capture operation once you invoke one of the following capture options.

Window Area

This allows you to capture a rectangular area of any window. See the Area Capture Options dialog box for description of the various controlling options. Select this option, show your desired window content, press the special capture key (normally F11), click down the left mouse button and drag out a rectangular region. After you release the left mouse button the rectangular area will be copied into the bitmap editor.

Active Window

This allows you to capture a full window including its title. Select this option, show your desired window and then press the special capture key (normally F11).

Active Window Client

This is the same as above except that only the interior client area of the window is captured (no title area).

Window Under Cursor

This allows you to capture a full window that is clicked under a cursor. Select this option, show your desired window, press the special capture key (normally F11) and then click the mouse on the desired window to capture.

Full Screen

This allows you to capture the full screen. Select this option and press the special capture key (normally F11).

Menu Under Cursor

This allows you to capture a menu located under a mouse cursor. Select this option, move the mouse into the desired menu and press the special capture key (normally F11). After you release the left mouse button the menu will be copied into the bitmap editor.

Window Object Under Cursor

This allows you to capture the window object under the cursor, such as windows, toolbars, bitmaps, etc. Select this option, move the mouse over the desired window element (it will be outlined in black) and press the special capture key (normally F11). After you release the left mouse button the window element will be copied into the bitmap editor.

Draw Cursor

This is the cursor to use while you are selecting the Window object. It turns into this cursor after you have started the capture operation (F11 key).

Border Width

This is the width of the black border which is used to highlight the Window object under the mouse.

Invert Selected Object

If enabled, this will invert the colors of the Windows object while the mouse is hovering on top of it.

Mouse Cursor

This allows you to capture the current mouse cursor. Select this option, show the desired mouse cursor and press the special capture key (normally F11). After you release the left mouse button the desired mouse cursor image will be copied into the bitmap editor.

Wallpaper

This allows you to capture the current desktop wallpaper. Select this option and press the special capture key (normally F11). After you release the left mouse button the desktop's wallpaper will be copied into the bitmap editor.

From contents of .exe file (Dialog Tree) ...

From contents of .exe file (Dialog Tabbed View) ...

These allow bitmaps and other resources to be extracted from an .exe file contained on disk. You will be prompted to select an executable file (.exe) and then will be shown either a tree control or a tabbed view window showing all the resources contained in that file (bitmaps, icons, etc). One of these can then be copied into the bitmap editor.

Start Capture Immediately

Normally you will select one of the capture options listed above then press the F11 key to invoke the capture command. However, if you enable the "Start Capture Immediately" then the capture operation will start right away after you select one of the capture commands listed above. For example, if you enable "Start Capture Immediately" and then select "Full Screen", a full screen capture will be taken and displayed in the edit buffer without any further interaction.

Capture Options ...

This causes the main capture options dialog box to be shown:

Hotkey

This is the key that you will need to press to start the capture operation. F11 is the default.

Delay (0 to 60 sec)

This is the time that will pass between the time you press the hotkey (F11) and the time when the capture operation will occur.

Repeat

This determines how many times you wish to repeat the capture operation.

Interval (0 to 60 sec)

And this is the time that should pass between each repeat operation of the capture.

Cancel Key (ESC)

This is the key to abort/stop the capture operation. ESC is the default key.

Captured Cursor

This combo box determines if the mouse should be captured in the final capture image. If the mouse cursor with the "X" through it is selected then the mouse will not be captured.

Delay Cursor

During the delay period (see "Delay" above), the mouse will turn into this cursor temporarily.

Print

This allows the current image to be printed. If you need additional control over the print operation (or you need to set up your destination printer) then select the "Print" or "Print Setup" commands from the main NuGraf/PolyTrans menus instead of from the bitmap editor's File menu.

Hide Bitmap Viewer

This hides the bitmap viewer and allows you to continue working in the main PolyTrans/NuGraf software application. To show the bitmap editor again, select the "Bitmap Editor" option from the main NuGraf/PolyTrans "Window" menu.


Edit Menu

Undo

This will cause the last bitmap image operation to be undone. It will step backwards to the last image shown prior to the last image operation.

Redo

This will "step forward" again after an Undo operation (it is the "Undo" of the last Undo operation). If you want to undo the last undo operation, and hence "step forward" again, then select this option.

Copy

If a valid bitmap image exists inside the editor then this option will copy it to the clipboard as a DIB and DDB bitmap, with an optional palette.

Paste

If a valid bitmap image exists on the clipboard then this menu item will allow you to paste it into the current bitmap editor. It will override the existing image.

Copy a Floater

This is similar to the "Copy" command except that it only copies the current floater image to the clipboard and not the main image.

Paste As Floater

This is similar to the "Paste" command except it pastes the image as a "Floater" image and does not overwrite the main image.

Region Selection

Regions are very important when you wish to apply an image operation only to a sub-set of the main image. All image operations can either be applied to the entire image or to sub-segments by defining a "region". The following types of regions can be created:

Rectangle

A rectangular region will be defined. Click down the left mouse button and drag out a rectangular region.

Triangle

A triangular region will be defined. Click down the left mouse button and drag out a triangular region.

Rounded Rectangle

A rounded rectangular region will be defined. Click down the left mouse button and drag out a rounded rectangular region.

Ellipse

An elliptical region will be defined. Click down the left mouse button and drag out an elliptical region.

Free Hand

A free hand drawn region will be defined. Click and hold the left mouse button down to draw the region interactively.

Polygon

A n-sided polygonal region will be defined. Click the left mouse button multiple times to define the polygonal region. Double click the left mouse button to create the last point and stop the drawing operation.

Curve

A curve-based region will be defined. Click the left mouse button multiple times to define the curved region. Double click the left mouse button to create the last curve point and stop the drawing operation.

Bezier

A Bezier-curved based region will be defined. Click the left mouse button multiple times to define the Bezier curve region. Double click the left mouse button to create the last curve point and stop the drawing operation.

Cancel Region

If a region is currently defined and active, then this menu item can be pressed to cancel the current region.

Magnifying Glass

This will enable a magnifying glass to be turned on/off. It magnifies regions under the cursor.

Show Pan Window

This shows the Pan extra window. It allows you to navigate inside a larger image based on the small preview image.

General Preferences...

This shows the File Save and Load Options dialog box.

Image Display Preferences

The following commands allow the intensity, contrast and gamma of the displayed image to be modified. NOTE: it only affects the display of the image and not the image itself.

Display Intensity...

This controls the intensity of the displayed image.

Display Contrast...

This controls the contrast of the displayed image.

Display Gamma...

And this controls the gamma of the red, green and blue channels of the image.


Image Menu

The Image Menu contains operations which affect the size and shape of the image itself.

Resize...

This dialog box allows the image's X and Y resolution to be changed through up sampling or down sampling, and/or its DPI resolution to be affected.

Flip

This flips the image in the vertical direction, mirroring the image along the middle horizontal line.

Reverse

This reverses the image in the horizontal direction, mirroring the image along the middle vertical line.

Rotate

90 Clockwise

180 Clockwise

270 Clockwise

These rotate the current image 90, 180 and 270 degrees.

Any Angle...

This brings up a dialog box which allows you to rotate any image by an arbitrary number. If you enable the "resize" checkbox then the rotated image will be resized so that it fits within the original image's bounding region.

Shear...

This allows the image to be sheared (skewed) in the horizontal or vertical directions.

Auto Trim...

This option allows extraneous border regions of scanned bitmaps to be automatically deleted. For example, the edges of a scanned document may be all black for which this dialog box can easily remove the edges. If a pixel value is less than or equal to the threshold value then that row and column will be removed, from outside-in.

Add Bitmaps…

Adds or averages one or more bitmap images in with the current image.

Underlay...

Combines two bitmaps so that one appears to be an underlying texture for the other.

Filters

Blur

Average...

This function can be used to remove uniform and Gaussian noise, but there is more blurring of the image than with the median filter. You control the strength of the function by specifying the size of the neighborhood (the surrounding pixels used for calculating the arithmetic mean).

Gaussian Filter…

Smooths or blurs an image by applying a Gaussian filter to the specified bitmap.

Motion Blur…

Applies a filter, which creates the illusion of movement in an image.

Effects

Contour...

This enhances the color in an image by emphasizing its edges. This uses a thinning and approximation algorithm to detect lines and color gradients in an image.

Edge Enhance

This enhances the edges of an image by applying a Laplacian filter to the image and then combining the output with the original image.

Emboss…

Applies an emboss effect to a bitmap, letting you specify the depth and direction of the effect.

Mosaic...

Imposes a mosaic effect on the class object’s bitmap by dividing the bitmap into tiles of a specified size, and changing the color of all pixels in each tile to the average color of pixels within the tile.

Posterize...

Imposes a poster effect on the bitmap by quantizing the bitmap's colors to a specified number of color levels per plane. For example, two levels means two of red, two of green, and two of blue.

Oilify...

Applies an oil-painting effect to the bitmap. You control the effect by specifying the size of the neighborhood that is used for calculating the pixel value. You increase the size of the neighborhood in order to decrease the amount of detail in the resulting image.

Solarize...

Applies an effect to the bitmap that mimics the accidental exposure of photographic film to light. It does so by inverting all color data with an intensity value greater than or equal to the threshold that you specify.

Noise

Add Noise...

Adds random pixels to a bitmap, letting you specify the percentage of coverage and the color plane.

Median...

This is an effective general function for removing salt-and-pepper noise from any kind of image. You control the strength of the function by specifying the size of the neighborhood (the surrounding pixels used for calculating the median value). This function causes minimal blurring of the image.

Sharpen

Sharpen...

This increases or decreases the sharpness of the bitmap.

Unsharp Mask

This function is actually considered a sharpening function. It creates a blurred copy of the original class object's bitmap, where the amount of blurring depends on the specified Radius. The function then determines the difference between each pixel value of the original bitmap and the corresponding pixel value of the blurred bitmap. If the difference is greater than the value in the Threshold parameter, then the difference between the pixel values is multiplied by the value in the Amount parameter and added to the original pixel value. If the difference between the pixel values is less than the threshold value, the original pixel value is not changed.

Using the YUV color space decreases the processing time.

Spatial Filters

The following sub-menu options allow image filtering (dsp) algorithms to be applied to the image.

Gradient...

Detects edges using a Gradient directional filter. All pixels not on the detected edges are changed to black. Choose the appropriate value for the direction of the effect. North and South filters will find horizontal edges, East and West filters will find vertical edges, etc.

Laplacian...

Applies Laplacian line detection. There are three omni-directional filters and three bi-directional ones. All pixels not on the detected lines are changed to black.

Sobel

Applies Sobel edge detection. All pixels not on the detected edges are changed to black. (The usage is the same as Prewitt, but the algorithm is different.) Choose the appropriate value for horizontal or vertical detection.

Prewit

Applies Prewitt edge detection. All pixels not on the detected edges are changed to black. (The usage is the same as Sobel, but the algorithm is different). Choose the appropriate value for horizontal or vertical detection.

Shift & Difference

Applies shift-and-difference edge detection. All pixels not on the detected edges are changed to black. Choose the appropriate value for diagonal, horizontal, or vertical detection.

Line Segment

Applies line segment line detection. You can use this filter to find line discontinuities in an image. All pixels not on the detected line segments are changed to black. Choose the appropriate value for horizontal, vertical, left-to-right diagonal, or right-to-left diagonal detection.

Color Histogram…

This shows the distribution of energy in the image, in the red, green and blue channels. Let's take the red channel as an example. The height of the spectrum at the left side is the number of "0" values in the entire image, in the red channel (zero intensity red), whereas the height of the spectrum at the right side is the number of "255" values in the entire image, in the red channel (full intensity red).

In order example below the mean average of the red energy is situated around the "120" value (47% of full intensity = 120/255). The peak intensity is at value 87 (34% of full intensity) for which there are 5106 pixels in the image which attain this red intensity value.

Color Resolution...

This allows the number of bits in an image to be changed. Support from 1-bit through to 32-bits is provided.

It is especially useful for dropping an image down to B&W (1 bit) resolution for which there are a good number of dithering methods to select from: Floyd Stein, Stucki, Burkes, Sierra, Stevenson Arce, Jarvis, Ordered and Clustered.

In addition, the image's color space can be forced into a specific palette of colors: Fixed, Optimized, Windows Identity, SVGA, Uniform and Microsoft Internet Explorer.


Color Menu

The Color Menu contains operations which affect the colors of an image.

Brightness...

Contrast...

Hue...

Saturation...

These allow the brightness, contrast, hue and saturation of the image to be interactively changed.

Gamma...

This allows gamma correction to be applied to an image. The human eye and television monitors have a non-linear intensity curve, and thus this function can be used to apply a gamma curve to an image to compensate for this non-linear perception. It is common, however, to store images with a gamma of 1.0 (no gamma correction) and only let the monitor or viewing program modify the image's gamma correction on the fly as it is being displayed.

Use this dialog to change the brightness of image pixels, mostly in the mid-range of intensities. Black and white pixels remain fixed, while pixels that originally have a mid-range brightness value will change the most.

Intensity

Detect...

Intensity levels range from 0 to 255 for each color plane (red, green, and blue). This dialog box processes each plane separately. If a RGB value falls within the intensity range specified by the sliders then it's intensity value is raised to 255, and if it falls outside the range specified by the sliders it's intensity is lowered to 0.

In other words, modify the slides to the range of min/max intensities that you wish to detect in the image. If such intensities exist then they will be converted to full intensities upon completion, otherwise they will be set to 0.

Stretch

This function improves the contrast of a flat image, while preserving the original number of different intensity values. Other contrast functions, where you specify the increase, can lose values at the top and bottom of the scale. This function, instead, sets the lowest intensity value to 0 and the highest to 255, then remaps the original values proportionally. If the original values already range from 0 to 255, this function has no effect.

Histogram

These functions modify the constrast in an image by first computing a histogram of the pixels in the image (the distribution of each intensity in the image).

Equalize

This linearizes the number of pixels in the bitmap, based on the YUV  color space.  This can be used to bring out the detail in dark areas of an image.

Contrast...

This increases or decreases the contrast of the bitmap using a histogram to determine the median brightness. This function finds the median brightness of the image; then brightens the pixels with values above the median and darkens the pixels with values below the median.

Balance Colors…

This allows the colors from the original image to be redistributed between the red, green and blue channels of the new image. For example, if the original image was heavily tinted towards the reds then this dialog box can be used to cause the high red content to smear into greens and blues in the new image.

Let's examine the first row of type-in boxes from the following dialog box, which represents "Old Red". Each type-in box specifies how the red color in the original image is to be re-distributed to the red, green and blue components in the new image. For example, if we set the 3 type-in boxes on one row to 80%, 20%, 30% then 80% of the original red colors would end up in the same locations of the new image, 20% of the original red would be mixed in with the green channel of the new image, and 30% of the original red would be mixed in with the blue channel of the new image.

Swap Colors…

This allows specific channels of the image to be swapped with each other, such as the red channel with the blue channel.

Colored Gray…

This converts the image to grayscale, then allows the RGB components to be further modified such as for cases where you might want to make the image look sepia toned (for which the image is tinted towards the blues or browns).

The red-factor, green-factor and blue-factor determine how the original red/green/blue colors of the source image are to be weighted together to form the grayscale image. In general you should keep these values set to (30%, 59%, 11%).

The RedGray, GreenGray and BlueGray determine how much of the red, green and blue channels of the original RGB image will be weighted against the final grayscale image. These allow the final grayscale image to be "tinted" with a percentage of the original image. Setting them to 0% will cause the final image to remain gray.

8 Bit Gray Scale

Converts a 1-, 4-, 8-, 16-, 24-, or 32-bit bitmap to an 8-bit grayscale bitmap.

Halftone...

Converts a bitmap with any resolution to a halftoned bitmap, with a specified pattern rotation. A halftoned bitmap is a 1-bit bitmap that has been dithered for black and white printing or display. It can process the whole image or a region of the image.

Invert

This inverts each color channel of the image to create a "negative" effect.

Fill...

This fills the entire image, or the area defined by a region, with a fixed color.

Unique Colors...

This counts and displays the number of unique colors in the current image.


Video Menu

The video menu contains controls used for displaying multi-media video files, such as those from AVI files, DirectShow files, Quicktime movie files and Flash files.

Play, Pause, Stop

These menu items start, stop or pause the video stream.

Volume

This sets the volume of the video playback to discreet levels.

Zoom Factor: Half-Size, Normal, Double Size

This allows the video resolution to be cut in half, set to normal full resolution, or doubled in size for playback.

Video Properties

This displays a dialog box which shows the properties of the currently loaded movie.


Help Menu

Contents...

This shows the help file you are currently reading.

Okino Bitmap Editor...

This describes the current version and copyright of the Okino Bitmap Editor.


Key Mappings
Keyboard Function Keys

This table describes the current keyboard accelerators. The '^' character means that you have to hold down the 'Ctrl' key along with the second key.

Key	Function
^C	Copy to clipboard
Ctrl+Insert	Copy to clipboard
^V	Paste from clipboard
Shift+Insert	Paste from clipboard
^O	Open new file
^S	Save current image to disk
^Z	Undo the last operation
ALT+Backspace	Undo the last operation
ALT+Z	Re-do the last operation
^F	Zoom the window to the extents of the entire image
^W	Zoom to the horizontal extents of the image
^H	Zoom to the vertical extents of the image
ALT+S	Zoom to original resolution of the image
^R	Start the rectangular region extents mode
^Q	Cancel the current region
Shift+DEL	Close current image


Bitmap Editor Options

Maximum Level of Undo/Redo

This sets the maximum number of undo steps for images. It defaults to 10. Internally a stack of 10 images is kept and thus you can step backwards up to 10 times or step forward once. The "redo" buffer basically undoes the last Undo operation.

Accept Drag & Drop Files

If enabled, files can be dropped from Windows Explorer or Okino's Explore Mode user interface over top of the bitmap editor, and the image will be automatically loaded if this option is enabled.

Default Zoom Factor

This is the zoom factor for the "Zoom" toolbar command. Every time you click the image it will be zoomed in or out by this factor. The default is 1.3 and the minimum value is 1.0.

Fit Mode for Newly Loaded Images

Fit to Window

When a new image is loaded it will be zoomed so that the whole image can be seen.

Show 1:1 Actual Pixels

When a new image is loaded it will be zoomed so that the window shows the image at its actual 1:1 pixel resolution.

Magnify Tool Options

The magnification tool is available by selecting its menu item from the main "Edit" menu. This tool provides an interactive rectangular magnifying region.

Magnification Window Width

Magnification Window Height

This is the width and height of the region.

Zoom Factor

This is the default magnification level. The default is 400%.

Startup Editor Window Type and Position

The "Type" combo box specifies which type of window will be created to hold the multi-media editor. The primary types are MDI document (full screen within the MDI client space), floating, docked, or docked to tab (expanded/collapsed). You are free to pick and choose whichever method you wish. For a full explanation, with visual queues, please press the "Help" button located to the right of the "Type" combo box in this section; it will show the help from the main PolyTrans or NuGraf help file about MDI document and docking windows.

The "Docking position" combo box specifies the edge of the main program's workspace where docking or expandable/collapsible windows will be automatically docked.


File Save and Load Options

When you press the File Load or File Save buttons, this dialog box appears. It allows you to select which 2D bitmap import/export sub-library you wish to use. The Okino Bitmap Editor uses the Okino converters, the LEADTOOLS converters, the Microsoft DirectShow filters and the Apple Quicktime filters. Due to overlap in all of the supported file formats you are being given a chance here to select which sub-set of converters to use.

By default you should always select the Okino converters unless you wish to view video movies in which case you would select Microsoft for AVI or MPEG-1 movies, and Apple Quicktime for .mov Movie files, .swf Flash files or MPEG-4 files (MPEG-4 is an optional paid component of Quicktime).

When saving out files, you can save bitmap images (not movies) to the Okino or LEADTOOLS converters.

If Any Item Is Grayed Out

•	If the Microsoft DirectShow text is grayed out then you need to visit the Microsoft WEB site and download the newest DirectX runtime installer for your machine. DirectX v8.1 or newer is required.

http://www.microsoft.com/windows/directx/downloads/default.asp

•	If the Apple Quicktime text is grayed out then you need to visit the Apple WEB site and download the newest Quicktime runtime installer for your machine. Quicktime v6 or newer is required.

http://www.apple.com/quicktime/download


Area Capture Options

This dialog box contains the options which control area captures.

General Options

Area Type

This defines which area type will be used to capture the screen area. To finish with the polygon tool double click the left mouse button.

Draw Line Style

This is the line style to use when drawing the capture region.

Fill Pattern

When the captured area does not fill the entire rectangular bitmap image (such as odd shaped captured regions), then this pattern is used to fill the background.

Draw Cursor

This is the cursor to use while the capture region is being interactively drawn. It can only be selected when the "Use Cross-Lines Cursor" option is disabled.

Ellipse Width & Height

Width and height of the ellipse used when drawing a rounded rectangle. Default is 100.

Include Cursor in Captured Area

If enabled then the cursor's image will be captured along with the bitmap image.

Use Cross-Lines Cursor

If enabled then cross-hairs will be drawn while the capture region is being interactively drawn.

Show Draw Cursor

If enabled then the cursor will be shown while the capture region is being interactively drawn.

Enable Keyboard

This allows the Ctrl, Shift,+,- keys to aid in the capture operation.

•	(+/-) are used for zooming in/out in the info window.

•	Ctrl key: If the area is a rectangle, round rectangle or ellipse, pressing CTRL key will center the drawing.

•	Shift key: If the area is a rectangle, round rectangle or ellipse, pressing SHIFT key will draw regular shapes (that is Ellipse becomes a circle , Rectangle becomes a Square, etc.).

Info Window Options

Once the area capture operation has begun a small info window will appear which shows the X and Y cursor location and the current width and height of the drawn capture region. These options control what is shown on this info window and its size.

Colors

These define the various colors used to interactively draw the capture region.


New Document Options
New Canvas Options

This dialog box is shown when a new canvas (an empty bitmap) is created.

Predefined Image Sizes

This combo box allows you to select from a number of predefined image sizes.

Width & Height

These type-in boxes set the X and Y image resolution.

DPI Resolution

This type-in box specifies the DPI (dots per inch) resolution. This is typically 72 for screen based images. The DPI setting is typically only important if you are going to print the image or use it in page layout. The DPI setting describes how large the image will appear in print.

Color Depth

This combo box specifies the color depth. 8 bits provides a grayscale image, 24 bits provides a full color RGB image (this is the typical setting) and 32 bits provides a RGB image plus alpha channel.

Fill Color

This is the color to fill the image initially.