IPLab For Macintosh Version 3.6 User’s Guide rev January 22, 2002 Scanalytics, Inc. 8550 Lee Highway, Suite 400 Fairfax, VA 22031 Tel: 703-208-2230 Fax: 703-208-1960 Email: [email protected] © Scanalytics, Inc., 1997 - 2002 All Rights Reserved. Cover picture – Self Portrait of Leonardo da Vinci (1452-1519), Windsor 12579r Software License Agreement This is a legal agreement between you, the end user, and Scanalytics. The term “SOFTWARE” as used in this license agreement includes the IPLab for Macintosh program, Camera Controls, Optional Extensions, Libraries, Scripts and all accompanying documentation. CAREFULLY READ THE FOLLOWING TERMS AND CONDITIONS BEFORE USING THIS SOFTWARE. OPENING THIS PACKAGE OF THE SOFTWARE, OR ANY DOWNLOADING, REPRODUCTION, COPYING, OR OTHER USE OF THE SOFTWARE BY YOU WILL CONSTITUTE ACCEPTANCE BY YOU OF THE TERMS AND CONDITIONS HEREIN. LICENSE You, the user, acknowledge that the SOFTWARE is the sole and exclusive property of Scanalytics, Incorporated. You have the right to use the SOFTWARE as outlined in, and limited by, this agreement. This SOFTWARE may only be used on a single terminal connected to a single computer (i.e. CPU). You may transfer the SOFTWARE from one computer to another provided that the SOFTWARE is used only on one computer at one time. You may not modify, translate, adapt, reverse engineer, decompile, disassemble, or create derivative works based upon this SOFTWARE. You agree to use your best efforts and take all reasonable steps to protect all aspects of the SOFTWARE from unauthorized reproduction, publication, disclosure, or distribution. COPYRIGHT Scanalytics, Incorporated owns all rights regarding the SOFTWARE, including the copyright. The SOFTWARE is valuable property of Scanalytics, Incorporated and the look and feel of the SOFTWARE are protected by the copyright laws of the United States and other countries. Under the copyright laws, the SOFTWARE, manuals, and product designs may not be copied, in whole or in part, via any means mechanical, electronic or otherwise, without the written consent of Scanalytics, Incorporated, except to make backup copies of the SOFTWARE, or to transfer the SOFTWARE to a hard disk. This exception does not allow copies to be made for other users. Under the law, copying includes translation to any other language or format. Unauthorized use of or copying of the SOFTWARE or the accompanying written material is an infringement of the copyright belonging to Scanalytics, Incorporated. Such infringement subjects the violator to civil and criminal penalties. LIMITATIONS ON WARRANTY AND LIABILITY If physical defects are discovered in the original media on which the SOFTWARE is distributed, Scanalytics, Incorporated will replace the media at no charge to you within a period of 90 days from the date of purchase. You must return the defective item(s) to Scanalytics, Incorporated. Scanalytics, Incorporated will replace the materials free of charge, provided you have previously returned your product registration card to Scanalytics, Incorporated. This warranty will be void if you have in any way modified the SOFTWARE, if you are in breach of this agreement, or if failure of the magnetic media has resulted from accident, abuse, or misapplication. The remedy for breach of this warranty shall be limited to replacement and shall not encompass any other damages. THESE REMEDIES ARE NOT AVAILABLE OUTSIDE OF THE UNITED STATES OF AMERICA. Other than the limited warranty described above, Scanalytics, Incorporated makes no warranty or representation, either express or implied, with respect to this SOFTWARE, its quality, performance, merchantability, or fitness for any particular purpose. In no event will Scanalytics, Incorporated or anyone else involved in the creation, production, or delivery of the SOFTWARE be liable for direct, indirect, special, incidental, or consequential damages resulting from any defect in the SOFTWARE. In particular, but without limiting the generality of the foregoing, Scanalytics, Incorporated shall have no liability for any damage to programs or data used with Scanalytics, Incorporated products, including the costs of recovering such programs or data. The warranty and remedies set forth above are exclusive and in lieu of all others, oral or written, express or implied. No dealer, agent, or employee of Scanalytics, Incorporated is authorized to make any modification, extension, or addition to this warranty. This warranty gives you specified legal rights. You may have additional rights which vary from state to state. UPDATE POLICY In order to obtain updates of these programs, you must complete the registration card and return it to Scanalytics. If Scanalytics has not received your Registration Card, Scanalytics is under no obligation to make any updates available to you. All updates provided to you shall become part of the material governed by the terms of this agreement. IPLab is a trademark of Scanalytics, Incorporated. Macintosh is a trademark of Apple Computer, Inc. Table Of Contents 1 Must-Read Section: Getting Started.................................................. 1 1.1 What Equipment You Need.........................................................................................................1 1.2 Setting Up IPLab..........................................................................................................................2 1.3 Allocating More Memory to IPLab.............................................................................................3 2 Must-Read Section: Quick-start with the IPLab Interface............... 5 2.1 #1: The Menu Bar .......................................................................................................................6 2.2 #2: The Image Window...............................................................................................................9 2.2.1 #2a: The Image .....................................................................................................9 2.2.2 #2b: The Region of Interest (ROI).....................................................................11 2.2.3 #2c & 2d: Segment and Drawing Overlays ........................................................13 2.3 #3-6: The Tools Window..........................................................................................................14 2.4 #3: The ROI Tools.....................................................................................................................15 2.4.1 ROIs in Text Windows........................................................................................16 2.4.2 Moving and Resizing ROIs .................................................................................16 2.4.3 Scripting the ROI Tools.......................................................................................16 2.5 #4: The Drawing Tools .............................................................................................................16 2.5.1 Scripting the Drawing Tools ...............................................................................20 2.6 #5: The Segment Tools .............................................................................................................20 2.6.1 Scripting the Segment Tools ...............................................................................24 2.7 #6: The Image Tools .................................................................................................................24 2.7.1 Scripting the Image Tools ...................................................................................26 2.8 #7: The FKeys (Function Keys) Palette ...................................................................................26 2.9 #8: The Status Palette................................................................................................................27 2.10 #9: The Variables Window .......................................................................................................28 3 Tutorials............................................................................................ 29 3.1 Tutorial 1: Getting Started .........................................................................................................29 3.1.1 Start IPLab and Open an Image ..........................................................................29 3.1.2 The Status palette.................................................................................................31 3.1.3 Using the ROI and Image Tools..........................................................................32 3.1.4 Using Segment and Drawing Tools ....................................................................35 3.2 Tutorial 2: Image Enhancement.................................................................................................37 3.2.1 Overview of the Enhance Menu..........................................................................37 3.2.2 Contrast Enhancement.........................................................................................38 3.2.3 Filtering................................................................................................................50 3.2.4 Color Image Filtering ..........................................................................................51 3.2.5 Geometric Operations..........................................................................................54 3.2.6 Adjusting the size of the image...........................................................................55