This is a creatable class; more than one is allowed.
This class has the same security behavior as the ClipServer.
This class deserializes clip objects from a binary stream in TIFF format. The stream contents must have been previously obtained from ScanTools Plus Link and perhaps saved in a permanent store such as a database column or file.
A ClipReader session begins when the solution instantiates a ClipReader class and opens it on a stream or file. The application definition file name is an input to the Open method(s). Clips are read in a forward-only fashion. Note that there is no requirement that you read all clips at once. However clips must be read sequentially. There is no way to skip clips. Once you request a clip, you cannot go back without re-opening the object.
The end-of-stream is indicated when Read returns a null.
The ClipReader does not modify the stream contents but obviously changes the stream position.
The object caches the last read clip that has image data– this could be a whole page clip or a sparse clip. Subsequently, if a clip without image data is encountered, it is matched against the cached clip. If a match is found, the image for the current clip is realized off the cached clip. If a match is not found, the Read method emits a 1x1 image that serves as a place-holder.
WARNING: Do not access the stream until after the call to Close. Changing the stream contents and/or position could cause indeterminate behavior.
NOTE: The Data Services component also uses this class internally to service the RichTiff aggregate function.
Pseudo Code for ClipReader session:
Open
While Clip=Read() is not null
Do something with Clip
(Break out of this loop anytime desired)
Wend
Close
The alphabetic list of properties and methods is provided below. For complete details, see the topic specific to each property.
Methods | Description |
---|---|
Ends a ClipReader session. |
|
Begins a ClipReader session. |
|
Gets the next clip from the stream. |
Throws Permission Denied exception for un-trusted callers. Works as expected for trusted callers. Please note that an instance of ClipReader can be created regardless of the caller.
See Help on Help for additional information on using this help file. See Scantron Technical Support for additional information on technical support and training options. See the ScanTools Suite System Requirements for further details on hardware and software requirements. ScanTools is a suite of products; the specific information you want may appear in the help for a different module. If you don't find what you're looking for here, try one of the following:
|
Scantron Corporation
Customer Service (forms, products, and services): 1-800-SCANTRON (722-6876) Technical Support: 1-800-445-3141 |
|
Copyright © 1998-2012 Scantron Corporation. All rights reserved. Use permitted only under license. www.scantron.com. No part of the Help or user guides may be reproduced in any form, or by any means, without express permission from Scantron Corporation. LINKS TO THIRD PARTY SITES This help system may contain links to third party websites ("Linked Sites"). The Linked Sites are not under the control of Scantron and Scantron is not responsible for the content of any Linked Site, including without limitation any link contained in a Linked Site or any changes or modifications to a Linked Site. Scantron is not responsible for web casting or any other form of transmission received from any Linked Site. Scantron provides Users with the ability to link the Assessment System to the Linked Sites as a convenience to you, and the inclusion of any link does not imply endorsement by Scantron of the Linked Site or any association with its operators. |