PixTools for .NET Release Notes Contents - EMC Community Network

PixTools for .NET 

Release Notes 

Version 8.0 SP1 

Copyright © 2008 EMC Corporation. All rights reserved. No part of this document may be reproduced, 

photocopied, stored on a computer system or transmitted without the express written consent of EMC 

Corporation. 

Contents 

Upgrading your installation ....................................................................................................................... 1 

What’s new .................................................................................................................................................. 1 

PDF/A support ........................................................................................................................................ 1 

ThumbnailView improvements ............................................................................................................... 2 

File operations performance................................................................................................................... 4 

Additional support of hardware job separators....................................................................................... 4 

Backward compatibility improvements ................................................................................................... 4 

Resolved issues .......................................................................................................................................... 4

PixTools for .NET 8.0 SP1 


This document includes product release notes for the PixTools for .NET 8.0 SP1 release. 

Upgrading your installation 

When upgrading, always install a new release to your test environment first. Perform the following steps 

before installing: 

• Make a backup copy of your environments, including files that are related to jobs, workflows, and 

recognition results. 

• Install the new version of the product to a test environment first. 

What’s new 

The following enhancements have been added to this software release: 

PDF/A support 

This release includes support for the PDF/A-1b file format. PDF/A-1b (formally ISO 19005-1 Level B) 

ensures that the visual appearance of a document is preserved for the long term. PDF/A support is 

significant in Germany, EMEA, and other regions. 

Support for PDF/A is provided by a new PixFileType.Pdfa enumeration value. The following C# code 

sample demonstrates how you might use this value in context to open a PDF/A file: 

// 1. Create and configure the read file driver 

ReadFileDriver readFileDriver = new ReadFileDriver(); 

readFileDriver.OpenFile(@"C:\Test.bmp"); 

// 2. Create and configure the write file driver 

WriteFileDriver writeFileDriver = new WriteFileDriver(); 

// configure write file driver 

writeFileDriver.OpenFile(@"C:\Test.pdf", PixFileType.Pdfa, 

OpenFileMode.CreateAlways); 

writeFileDriver.ColorFormat = new ColorFormat(3, 8, PixPhotometric.Rgb); 

writeFileDriver.Compression.Value = PixCompression.Jpeg; 

writeFileDriver.InsertMode = PageInsertMode.Append; 

// Check file format 

Boolean isValidFormatFirst = 

WriteFileDriver.CheckFormat(writeFileDriver.FileType, 

writeFileDriver.ColorFormat, 

writeFileDriver.Compression.Value); 

// 3. Create and configure the pipe 

// create pipe process 

PipeProcess pipeProcess = new PipeProcess(); 

// Construct pipe from ScanDriver and WriteFileDriver 

pipeProcess.Construct(readFileDriver, writeFileDriver); 

// 4. Invoke pipe 

// Run pipe process and obtain PageSide object with images and 

// other data received from the pipe 

PageSide side = pipeProcess.Run(); 

// 5. Always dispose pipe 

pipeProcess.Dispose(); 

// File driver: close file 

readFileDriver.CloseFile(); 

writeFileDriver.CloseFile(); 

© EMC Corporation 1 28-Jan-08



ThumbnailView improvements 

The functionality and performance of the ThumbnailView control has been improved. The following 

features are new: 

Manual scrolling – 

The ThumbnailView.ScrollTo method has the following new overloads: 

• public void ScrollTo(ScrollOrientation orientation, ScrollType scrollType) 

• public void ScrollTo(ScrollOrientation orientation, ScrollType scrollType, 

Int32 multiplier) 

• public void ScrollTo(PixThumbnailNode thumbnailNode, ScrollVerticalAlign style) 

The orientation parameter lets you scroll the tree in different directions. The ScrollOrientation 

enumeration has the following possible values: 

• HorizontalScroll 

• VerticalScroll 

The scrollType and multiplier parameters let you set the amount to scroll by. The available 

scrollType parameter values are listed below. They have the same meanings that they do in the .NET 

Framework ScrollEventType enumeration; refer to the Visual Studio or MSDN documentation for 

further details. 

• LargeDecrement 

• LargeIncrement 

• SmallDecrement 

• SmallIncrement 

• First 

• Last 

The style parameter in the last overload allows you to set the position of the scrolled thumbnail. This 

determines where the node specified by the thumnbailNode parameter will be placed in relation to the 

ThumbnailView control after scrolling is complete. The following are the possible values of the 

ScrollVerticalAlign enumeration: 

• Top 

• First 

• Last 

Automatic scrolling – 

The following new method was added to provide automatic scrolling functionality. This method scrolls the 

tree when the mouse pointer moves outside of the control’s boundaries: 

• ThumbnailView.ScrollIfNeeded(Point mouseLocation) 

Scrolling input handler – 

An input handler for scrolling has been added to the ThumbnailView control: 

• AutoScrollInputHandler 

The following C# sample code demonstrates how to implement this handler so that scrolling occurs if the 

mouse leaves the control boundaries during a drag-and-drop operation: 

// Creation 

AutoScrollInputHandler autoScrollHandler = new AutoScrollInputHandler(); 

autoScrollHandler.Subscribe(thumbnailView); 

... 



// On drag and drop operation start 

autoScrollHandler.Enable = true; 


... 

// On drag and drop operation stop 

autoScrollHandler.Enable = false; 

Input handler managers – 

A new abstract class named ViewInputHandlersManager was added to simplify working with input 

handlers. The following non-abstract classes are derived from it: 

• PixViewInputHandlersManager 

• ThumbnailViewInputHandlersManager 

These classes contain methods that are useful for managing multiple input handlers. 

The following C# sample code demonstrates the use of ThumbnailViewInputHandlersManager to 

quickly enable and disable an AutoScrollInputHandler: 

// Creation 

ThumbnailViewInputHandlersManager handlers = new 

ThumbnailViewInputHandlersManager(thumbnailView); 

handlers.Add (); 

... 

// When drag and drop operation starts 

handlers.Get.Enable = true; 

... 

// When drag and drop operation stops 

handlers.Get.Enable = false; 

New display mode – 

The following new display mode was added to allow you to automatically place the most recently scanned 

image within the viewable part of the control: 

• ThumbnailViewFlags.EnableAutoScrollDuringAdding 

When this flag is used and a new image is scanned, the control automatically scrolls so that the new 

image is centered in the view. 

PageUp/PageDown result nodes – 

The following new ThumbnailView methods allow you to determine which nodes are 1 page away 

(PageUp or PageDown) from a specified node. You can use them to retrieve and pre-process the nodes 

that will be displayed if the user scrolls by a page. 

• PixThumbnailNode GetPageUpNode(PixThumbnailNode node) 

• PixThumbnailNode GetPageDownNode(PixThumbnailNode node) 

Performance improvements – 

ThumbnailView was tuned to improve performance. 

New samples – 

The “ThumbnailDragnDrop” sample project contains new examples of using the following input handlers: 

• KeyboardInputHandler 

• DragnDropInputHandler 




File operation performance 

Load and save operations on images were tuned to improve performance. 

Additional support of hardware job separators 

Hardware job separator functionality has been improved for better stability and broader scanner support. 

Backward compatibility improvements 

PixTools for .NET 8.0 contains PICN*.DLL files. If these are installed to the Windows SYSTEM32 folder 

(not recommended), they might break the backward compatibility of some existing applications. In this 

release, most of the PICN*.DLL files were replaced with PIXN*.DLL files. You must now redistribute the 

files from the first list below, rather than the second. 

New files to redistribute: 

(Note that there is one PICN*.DLL file, named PICN20.DLL. You must distribute both PICN20.DLL and 

PICN20.DLL.) 

• PIXN1020.DLL 





• PICN20.DLL 

Old files that have been replaced by the above list: 





Resolved issues 

The following issues have been resolved in this software release: 

Issue # Component Description 

PTN-1400 PixTools.PixScan ScanDriversManager.AvailableScanners returns duplicated 

items. 

PTN-1401 PixTools.ThumbnailView Thumbnail throws exception in mouse event handlers. 

PTN-1406 PixTools.PixScan Exception with message "PixTools/View no data im page" is 

thrown by method PipeProcess.Run in case HW Separator 

detection is configured. 

PTN-1413 PixTools.Annotation First arrow of double-arrowed line annotation has incorrect 

direction. 

PTN-1421 PixTools.ThumbnailView ThumbnailView: Scalar node can be collapsed. 

PTN-1424 PixTools.View Some JPEG files that have an Exif marker are displayed 

incorrectly.

PixTools for .NET Release Notes Contents - EMC Community Network

You also want an ePaper? Increase the reach of your titles

Delete template?

Save as template?