The Standard in Industrial Automation and Scientific Components for Real-Time Applications Plot Pack Manual Version 2.1.2 Version 2.1.2.0 [08/26/02 2:27 PM] Plot Pack Manual This page intentionally left blank ii Iocomp Components – Plot Pack Manual Copyright Author Patrick Carroll Technical Reviewer Todd Oster Proofreader Cyrus Edson Copyright Copyright 1998-2002 Iocomp Software Incorporated. All rights reserved. Portions of the software described in this document copyright Microsoft Corporation, Borland Corporation, and Linus Torvalds. All Rights Reserved. No part of this publication may be reproduced, stored in a retrieval system or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without written permission from the publisher. Except for the limited warranty as described in the End User License Agreement, the information and material contained in this book are provided “As Is” without warranty of any kind, express or implied, including without limitation any warranty concerning the accuracy, adequacy, or completeness of such information or material or the results to be obtained from using such information or material contained within this manual or documentation. Neither Iocomp Software nor the author shall be responsible for any claims attributable to errors, omissions, or other inaccuracies in the information or material contained in this book, and in no event shall Iocomp Software or the author be liable for direct, indirect, special, incidental, or consequential damages arising out of the use of such information or material. Some states do not allow limitations of duration of any implied warranty, so the above limitations may not apply to you. Trademarks Iocomp and the Iocomp Logo are registered trademarks of Iocomp Software Incorporated. Microsoft, Visual Basic, Visual C++, Visual FoxPro, Windows, Microsoft Office, and ActiveX are trademarks or registered trademarks of Microsoft Corporation. Borland, Delphi, Kylix, C++ Builder, VCL, and CLX are trademarks or registered trademarks of the Borland Corporation. Linux is a registered trademark of Linus Torvalds. All other names, products, or marks are trademarks or registered trademarks of their respective companies. Initial Printing 03/2001 Manufactured in the United States of America Iocomp Components – Plot Pack Manual iii Table of Contents Table of Contents PLOT PACK MANUAL........................................................................................................................... I COPYRIGHT ......................................................................................................................................... III TABLE OF CONTENTS........................................................................................................................IV CHAPTER 1 - INTRODUCTION........................................................................................................... 1 SAMPLE CODE CONVENTIONS................................................................................................................... 1 VISUAL C++ SPECIAL COMPILER NOTE.................................................................................................... 1 BORLAND DELPHI, KYLIX, AND C++ BUILDER SPECIAL COMPILER NOTE ............................................... 2 COMPONENT NAMING CONVENTIONS ....................................................................................................... 3 SOURCE CODE UNIT NAMING CONVENTIONS ........................................................................................... 3 CHAPTER 2 - DECIDING WHICH COMPONENT TO USE............................................................ 4 IPLOT ........................................................................................................................................................ 5 Properties (ActiveX) ............................................................................................................................. 6 Properties (VCL/CLX).......................................................................................................................... 6 Depreciated Properties......................................................................................................................... 6 Methods (ActiveX) ................................................................................................................................ 6 Methods (VCL/CLX)............................................................................................................................. 8 Depreciated Methods (VCL)................................................................................................................. 8 Events.................................................................................................................................................... 9 IXYPLOT .................................................................................................................................................. 9 Properties (ActiveX) ........................................................................................................................... 10 Properties (VCL/CLX)........................................................................................................................ 11 Depreciated Properties....................................................................................................................... 11 Methods (ActiveX) .............................................................................................................................. 12 Methods (VCL/CLX)........................................................................................................................... 13 Depreciated Methods (VCL)............................................................................................................... 13 Events.................................................................................................................................................. 14 CHAPTER 3 - OVERALL THEORY...................................................................................................15 GENERIC EXAMPLE:................................................................................................................................ 16 SPECIFIC EXAMPLES: ..............................................................................................................................16 PLOT OBJECTS ........................................................................................................................................ 17 Plot Object Index................................................................................................................................ 17 Plot Object Name................................................................................................................................ 18 Get Plot Object Index By Name.......................................................................................................... 18 Get Plot Object Name by Index .......................................................................................................... 18 CHAPTER 4 - AXES .............................................................................................................................. 19 SPAN ....................................................................................................................................................... 20 MIN AND MAX ........................................................................................................................................ 20 ROTATED AXES....................................................................................................................................... 20 LABEL FORMATS..................................................................................................................................... 21 REVERSE SCALES.................................................................................................................................... 21 iv Iocomp Components – Plot Pack Manual Table of Contents SCALE TYPES .......................................................................................................................................... 22 Linear ................................................................................................................................................. 22 Logarithmic Base 10........................................................................................................................... 22 LABELSEPARATION................................................................................................................................. 22 LABELSMARGIN...................................................................................................................................... 23 LABELSMINLENGTH ............................................................................................................................... 23 LABELSMINLENGTHAUTOADJUST ......................................................................................................... 24 STACKINGENDSMARGIN......................................................................................................................... 24 TRACKING............................................................................................................................................... 25 USER INTERFACE ...................................................................................................................................