CD Actual 15

home *** CD-ROM | disk | FTP | other *** search

/ CD Actual 15 / CDACTUAL15.iso / cdactual / program / basic / PICULATE.ZIP / PICULATE.TXT < prev

Wrap

Text File | 1992-08-31 | 30.5 KB | 1,737 lines

TABLE OF CONTENTS ■───────────────────────────────────────────────────────────────■ CHAPTER 1 Introduction to PICKULATOR Licensing Installation Cabling requirements Host settings Terminal definition CHAPTER 2 PICKULATOR Basics Getting started Entry and Exit Using PICKULATOR routines Syntax and conventions CHAPTER 3 Graphics Reference TCL verbs Basic subroutines CHAPTER 4 Mouse Reference TCL verbs Basic subroutines CHAPTER 5 Files and Definitions GRAPH-FILE BUTTONS CHARS CHARS,0X CHARS,1X CHAPTER 6 Bundled Graphic Charts Bar graph chart Pie graph chart Printing charts to the printer CHAPTER 7 Full Screen Editor Accessing the editor Using the editor ■───────────────────────────────────────────────────────────────■ CONTENTS 1 TABLE OF CONTENTS ■───────────────────────────────────────────────────────────────■ APPENDIX A Programming Examples - Graphics Operation PAINT.TEST LINE.TEST DRAW.TEST CIRCLE.TEST COLOR.TEST APPENDIX B Programming Examples - Mouse Operation APPENDIX C Error Messages APPENDIX D Support APPENDIX E Trademarks INDEX ■───────────────────────────────────────────────────────────────■ CONTENTS 2 CHAPTER 1 - INTRODUCTION TO PICKULATOR ■───────────────────────────────────────────────────────────────■ LICENSING INSTALLATION CABLING REQUIREMENTS HOST SETTINGS TERMINAL DEFINITION ■───────────────────────────────────────────────────────────────■ INTRODUCTION 3 CHAPTER 1 - LICENSING ■───────────────────────────────────────────────────────────────■ IMPORTANT-PLEASE READ CAREFULLY BEFORE OPENING THE SEALED DISK PACKAGE(S). NOTIFICATION OF COPYRIGHT This software program package ("SOFTWARE") is a proprietary product of MULTISYSTEMS DEVELOPMENT INC. ("MSDINC") and is protected by copyright laws and international treaty. You must treat the software like any other copyrighted material, except that you may either make one copy of the software solely for backup or archival purposes, or you may place the software on a single hard disk, provided that you keep the original software solely for backup or archival purposes. Copyright laws prohibit making additional copies of the software for any other reason. You may no copy the written materials accompanying the software. ■───────────────────────────────────────────────────────────────■ SOFTWARE LICENSE AGREEMENT Read this license agreement carefully before opening the sealed disk package. This agreement is a legal contract between you, the end user, and MULTISYSTEMS DEVELOPMENT INC. governing your use of the software. Opening the sealed disk package indicates your acceptance of this agreement. This agreement shall also be binding on any subsequent, authorized licensee. If you do not wish to agree to the terms of this agreement, promptly return the complete software program package, with the disk package(s) unopened, to the dealer from whom you obtained this product. You will receive a full refund provided (i) you return the full software package, and (ii) the disk package(s) are unopened. If you have any questions concerning this agreement, contact MULTISYSTEMS DEVELOPMENT INC., Attn. NEW PRODUCT SERVICES, 2437 Bay Area Blvd. #177, Houston, Texas, 77058, or call (713) 326-4820. LICENSE 1. MSDINC grants you the right to use one copy of the SOFTWARE on a single user-user computer, or on a single terminal or workstation of a multi-user computer. Each workstation or terminal on a multi- user computer or network must be seperatly licensed by MSDINC. If the software package contains more than one tupe of media, you are licensed to use only a single set of media for your single-user computer, terminal or workstation; you are not licensed to use the other sets of media. 2. You may not sublicense, rent or lease the SOFTWARE, but you may permanently transfer your license to use the SOFTWARE package, including the title page of the manual, and by simultaneously ■───────────────────────────────────────────────────────────────■ LICENSING 4 CHAPTER 1 - LICENSING ■───────────────────────────────────────────────────────────────■ destroying all copies of the SOFTWARE and accompanying materials in your possesion. Such transfer terminates your license to use the SOFTWARE. The new recipient of the SOFTWARE and accompanying materials accepts this Agreement and is licensed under the terms of this Agreement upon initially using the SOFTWARE. 3 MSDINC further grants you the right to make a backup/archival copy of the software media as set forth in the Notification of Copyright, above. You may not decompile, disassemble, reverse engineer, copy, transfer, or otherwise use the SOFTWARE except as stated in this Agreement. LIMITED WARRANTY/LIMITATION OF REMEDIES MSDINC will replace, at no charge, defective media that are returned within 90 days of the original date of purchase. MSDINC warrants that the SOFTWARE will perform in substantial compliance with the written materials accompanying the SOFTWARE. If you report, in writing, a significant defect to MSDINC, and MSDINC is unable to correct it within 90 days of the date that you report the defect, you may return the SOFTWARE and accompanying materials, and MSDINC will refund the purchase price. By opening the sealed disk package, you agree that the only remedy available to you will be a refund of the purchase price of this software program package. SUCH WARRANTIES ARE IN LIEU OF OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE WITH RESPECT TO THE SOFTWARE AND THE ACCOMPANYING WRITTEN MATERIALS. IN NO EVENT WILL MSDINC BE LIABLE TO YOU FOR DAMAGES ARISING OUT OF YOUR USE OF OR INABILITY TO USE THE PROGRAM, EVEN IF MSDINC OR AN AUTHORIZED REPRESENTATIVE HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. MSDINC WILL NOT BE LIABLE FOR ANY SUCH CLAIM BY ANY OTHER PARTY. This limited warranty gives you specific legal rights. Some states provide other rights, and some states do not allow excluding or limiting implied warranties or limiting liability for incidental or consequential damages. As a result, the above limitations and/or exclusions may not apply to you. Futhermore, some jurisdictions have statutory consumer provisions which may supercede this section of the Agreement. GENERAL If any provision of this Agreement shall be unlawful, void, or for any reason unenforceable, then that provision shall be deemed severable from this Agreement and shall not affect the validity and ■───────────────────────────────────────────────────────────────■ LICENSING 5 CHAPTER 1 - LICENSING ■───────────────────────────────────────────────────────────────■ enforceability of the remaining provisions of this Agreement. This Agreement is governed by the laws of the State of Texas. U.S. GOVERNMENT RESTRICTED RIGHTS The SOFTWARE and accompanying materials are provided with Restricted Rights. Use, duplication, or disclosure by the Government is subject to restrictions as set forth in subparagraph (b)(3)(ii) of The Rights in Technical Data and Computer Software clause at 242.227-7013. Contractor/manufacturer is MULTISYSTEMS DEVELOPMENT INC., 2437 Bay Area Blvd. #177, Houston, Texas, 77058. ■───────────────────────────────────────────────────────────────■ LICENSING 6 CHAPTER 1 - INSTALLATION - Computer Workstation ■───────────────────────────────────────────────────────────────■ Put the diskette labeled PICKULATOR WORKSTATION in the appropriate drive. Change the drive specification to the drive that contains this diskette. EXAMPLE - Diskette in Drive B C>b: B> If you will be running your workstation from a floppy drive, execute the following steps: B>installf If you will be running your workstation from a Hard Disk, execute the following steps: B>installh Once either of the above procedures is executed the workstation installation will be complete. ■───────────────────────────────────────────────────────────────■ INSTALLATION 7 CHAPTER 1 - INSTALLATION - Host Computer - R83 Implementation ■───────────────────────────────────────────────────────────────■ Put the diskette labeled PICKULATOR HOST PROGRAMS in the appropriate drive. Attach the tape ro the drive that contains this diskette. EXAMPLE - Diskette in Drive B >SET-FLOPPY (S,B >T-ATT To install the HOST PROGRAMS to the PICK machine execute the following steps: >T-LOAD MD >PK-INSTALL The above instructions will restore an account called PICKULATOR which contains files, functions and subroutines used by both the host and the workstation. ■───────────────────────────────────────────────────────────────■ R83 INSTALLATION 8 CHAPTER 1 - INSTALLATION - ULTIMATE Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ ULTIMATE INSTALLATION 9 CHAPTER 1 - INSTALLATION - GENERAL AUTOMATION Implemenatation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ GENERAL AUTOMATION INSTALLATION 10 CHAPTER 1 - INSTALLATION - NCR ADDS Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ NCR ADDS INSTALLATION 11 CHAPTER 1 - INSTALLATION - SEQUOIA Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ SEQUOIA INSTALLATION 12 CHAPTER 1 - INSTALLATION - PRIME INFORMATION Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ PRIME INFORMATION INSTALLATION 13 CHAPTER 1 - INSTALLATION - MONOLITH Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ MONOLITH INSTALLATION 14 CHAPTER 1 - INSTALLATION - UNIVERSE Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ UNIVERSE INSTALLATION 15 CHAPTER 1 - INSTALLATION - ADVANCED PICK Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ ADVANCED PICK INSTALLATION 16 CHAPTER 1 - INSTALLATION - ADVANCED PICK/UNIX Implementation ■───────────────────────────────────────────────────────────────■ ■───────────────────────────────────────────────────────────────■ ADVANCED PICK/UNIX INSTALLATION 17 CHAPTER 1 - CABLING REQUIREMENTS ■───────────────────────────────────────────────────────────────■ CABLING DIRECT CONNECTIONS The following pinout is required to connect your PICKULATOR workstation to your host computer. DB25 (25pin serial connection, required on both host and workstation.) 1■────────────■1 2■──────┐ ┌──■2 ┌──┼──┘ 3■───┘ └─────■3 4■─┐ ┌─■4 5■─┘ └─■5 6■─┐ ┌─■6 7■─┼────────┼─■7 8■─┤ ├─■8 20■─┘ └─■20 ■───────────────────────────────────────────────────────────────■ CABLING 18 CHAPTER 1 - HOST SETTINGS ■───────────────────────────────────────────────────────────────■ In order for your PICKULATOR workstation to "talk" with the host computer some basic settings are required. Baud Rate = 19200 Parity = N Data Bits = 8 Stop Bits = 1 Protocol = None In addition to these settings the TERM settings should be adjusted as follows: >TERM 79,24,0,0 This sets your PICKULATOR workstation for the appropriate display definition. ** NOTE ** You should update the DICT ACC item if applicable on your machine to make these settings active on the port that your PICKULATOR workstation is connected to so that the settings will be implemented each time that you logon to your HOST computer. ■───────────────────────────────────────────────────────────────■ SETTINGS 19 CHAPTER 1 - TERMINAL DEFINITION ■───────────────────────────────────────────────────────────────■ In order for your PICKULATOR workstation to function properly the appropriate terminal definition should be selected. There is no choice on the type of terminal definition. However the terminal definition NAME and CODE are left up to you to decide. Terminal Definitions available Definitions are included for the host computers listed below. If your computer is not listed, please make a modem available for dialup and call (713) 326-4820 and a support representative will create the appropriate definition for you. EXISTING TERMINAL DEFINITIONS R83 GENERAL AUTOMATION ULTIMATE PRIME To utilize an existing terminal definition, log into the SYSPROG account, and execute the following instructions. >SET-FILE PICKULATOR PK-TERMDEF >COPY QFILE PK-R83 (PK-manufacturer id) TO:(CURSOR (file where terminal definitions are stored) Once these instructions have been completed, you may edit the TERM TYPE or the ITEM ID for the terminal definition. ** CAUTION ** Any other changes to this item can and will cause failure of your PICKULATOR workstation. Upon completion of the desired changes, you must initialize the terminal definition prior to using it. ** NOTE ** Remember the TERM TYPE, it will be required to make any of your PICKULATOR programs function properly. ■───────────────────────────────────────────────────────────────■ TERMINAL DEFINITION 20 CHAPTER 2 - PICKULATOR BASICS ■───────────────────────────────────────────────────────────────■ GETTING STARTED ENTRY AND EXIT DOS SHELL USING PICKULATOR ROUTINES SYNTAX AND CONVENTIONS ■───────────────────────────────────────────────────────────────■ BASICS 21 CHAPTER 2 - GETTING STARTED ■───────────────────────────────────────────────────────────────■ If you were successful in the installation procedure of both the host and workstation portions, you are ready to get started. To get an idea of the kinds of things that you will be able to do with your PICKULATOR workstation, see APPENDIX A, Programming Examples - Graphics Operation and APPENDIX B, Programming Examples - Mouse Operation. These examples are fully functional and contain the source code, so that you can further understand how to produce graphic screens and utilize mouse operations using PICK basic and your PICK host computer. The main feature of your PICKULATOR workstation is that all of the data resides on your PICK host, and all of the programs that you create are written using the PICK basic language. This allows you to create graphic images and utilize mouse operations that were heretofore only available to DOS programmers and end-users. In addition, the programs that you write are your programs, you can produce and offer for sale programs that have PICKULATOR specific subroutines and functions as a portion of your programs. The PICKULATOR System package is required on each individual PICK Host to enable the PICKULATOR Workstation. The PICKULATOR Workstation package is required to enable your programs to run on individual ports. Your PICKULATOR system is in its most basic form an interpreter between your PICK host and your PICKULATOR workstation. The Workstation package allows interpretation of graphics and mouse operations and makes them available to your PICK host and your PICK programs. ** NOTE ** Be sure to see Chapter 7 - Bundled Graphic Charts, included with the PICKULATOR System package, which allows you to generate both Bar Graph and Pie Graph charts from your PICK database. There is no programming required to use these charts, they are fully functional programs, the only thing you need to add is data! ■───────────────────────────────────────────────────────────────■ GETTING STARTED 22 CHAPTER 2 - ENTRY AND EXIT ■───────────────────────────────────────────────────────────────■ To gain access to your PICK host from your PICKULATOR workstation, execute the following instruction from the drive specified in the workstation implementation section. EXAMPLE B>PKEMULAT Once this instruction has been issued a screen simular to the following should be displayed: ┌───────────────────────────────────────────────────────────────┐ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ Pickulator - (c)1991 Multisystems Development Inc. │ └───────────────────────────────────────────────────────────────┘ To exit the emulation, simply press the ALT key, hold it down and press Q. Use this option when you have completed use of the emulation program. To enter DOS, simply press the ALT key, hold it down and press D. Use this option when you want to temporarily go into DOS and return to the emulation program. When you have completed work in DOS type EXIT and press return to gain re-entry into the emulation program. ■───────────────────────────────────────────────────────────────■ ENTRY AND EXIT 23 CHAPTER 2 - USING PICKULATOR ROUTINES ■───────────────────────────────────────────────────────────────■ There are 2 ways to access the features of your PICKULATOR workstation. The first way is through FUNCTIONS, and the other is through SUBROUTINES. Functions should be used at the TCL (Terminal Control Language) level, the other should be used when writing basic routines. The difference between the two options is, Functions return error messages to the display. Subroutines return error messages through subroutine arguments which are not displayed. EXAMPLE - Turn the Mouse ON 1 FUNCTION >MOUSE-ON Mouse Enabled. 2 SUBROUTINE 001 CALL MOUSE("ON",MSG) In the first example MOUSE-ON is keyed at TCL and the message "Mouse Enabled." is displayed. In the second example the subroutine MOUSE is called with the first argument begin "ON" and the variable MSG would contain 1 signifying that the mouse has been enabled. The reason for having FUNCTIONS and SUBROUTINES is, you do not want error messages coded inside basic programs to be displayed; however you do want error messages from FUNCTIONS executed at TCL to be displayed. In many cases where a basic SUBROUTINE command is documented, there is a corresponding FUNCTION for that same command. ■───────────────────────────────────────────────────────────────■ USING PICKULATOR ROUTINES 24 CHAPTER 2 - SYNTAX AND CONVENTIONS ■───────────────────────────────────────────────────────────────■ SUBROUTINES Basic subroutines are very simple to utilize CALL PROGNAME(argument,[argument],,,,) PROGNAME - The name of the subroutine being called. argument - When specified alone, must be present [argument] - When specified with brackets is optional; however the argument must be in the call, otherwise a basic error related to the mismatch of arguments will occur FUNCTIONS TCL functions also are simple to utilize >FUNCNAME opt1 (keyword) [opt2] etc... (addopt1,[addopt2] etc... FUNCNAME - The name of the function being executed. opt1 - This option is required (keyword) - This is a keyword identifier ie. (BY, WITH etc...) [opt2] - This option is not required, if not desired, omit (addopt1 - This additional option is required ([addopt2] - This additional option is not required, if not desired omit ■───────────────────────────────────────────────────────────────■ SYNTAX AND CONVENTIONS 25 CHAPTER 3 - GRAPHICS REFERENCE ■───────────────────────────────────────────────────────────────■ Basic Subroutines .CIRCLE .COLOR .DRAW .GET .PAINT .PALETTE .PCOPY .PRESET .PSET .PMAP .POINT .PUT .SCREEN .VIEW .VIEWPRINT .WIDTH .WINDOW TCL Verbs .COLOR .PALETTE .SCREEN .WIDTH ■───────────────────────────────────────────────────────────────■ REFERENCE 26 CHAPTER 3 - GRAPHICS REFERENCE ■───────────────────────────────────────────────────────────────■ CIRCLE Statement Purpose: Draws a circle on the screen with center (x,y) and radius (r). SYNTAX Subroutine: .CIRCLE(xpos,ypos,radius,[color,[start,end],[aspect]]) Function: Not Available ■───────────────────────────────────────────────────────────────■ DEFINITION xpos,ypos - These are the coordinates (in pixels) of the center of the circle. radius - The radius (major axis) of the circle in points color - A numeric value that chooses a color attribute from the current palette setting start,end - These are angles in radians and can range from -2*PI to 2*pi, where PI=3.141593 aspect - A numeric expression ■───────────────────────────────────────────────────────────────■ CIRCLE 27 CHAPTER 3 - GRAPHICS REFERENCE ■───────────────────────────────────────────────────────────────■ CIRCLE Statement - Continued EXPLANATION start and end specify where the drawing of the circle will begin and end. The angles are positioned in the standard mathamatical way, with 0 to the right and going counterclockwise. If the start or end of the angle is negative (-0 is not allowed), the circle is connected to the center point with a line, and the angles are treated as if they were positive (this is not the same as adding 2*PI). The start angle can be greater or less than the end angle. aspect affects the ratio of the x-radius to the y-radius. The default for aspect varys (5/6, 5/12 etc..) with the SCREEN mode enabled prior to the use of the CIRCLE statement. If aspect is less than 1, then radius is the x-radius. That is, the radius is measured in points in the horizontal direction. If aspect is greater than 1, then radius is the radius. In many cases, an aspect of 1 results in nicer-looking circles under certain SCREEN modes. It also causes the circle to be drawn somewhat faster. ■───────────────────────────────────────────────────────────────■ CIRCLE 28 CHAPTER 5 - FILES AND DEFINITIONS ■───────────────────────────────────────────────────────────────■ GRAPH-FILE BUTTONS CHARS CHARS,0X CHARS,1X ■───────────────────────────────────────────────────────────────■ FILES AND DEFINITIONS 99 CHAPTER 5 - FILES AND DEFINITIONS ■───────────────────────────────────────────────────────────────■ GRAPH-FILE The GRAPH-FILE is a file used to build and display both bar and pie type graphs. The information in this section only defines and explains the use of this file and not the use of the programs themselves. For further information on the programs, see CHAPTER 6 - Bundled Graphics Charts. DICT, GRAPH-FILE The following information identifies and explains the information contained in the dictionary of the GRAPH-FILE. DICT, GRAPH-FILE COLOR.XREF This item contains a cross reference of COLOR NAMEs matched with COLOR NUMBERs. When using the GRAPH-FILE item to produce a graph, and you wish to select the colors for the graph, then you will need to insert either COLOR NAMEs or COLOR NUMBERs to identify them. It would be better to use the COLOR NUMBERs rather than the COLOR NAMEs for the most efficient use of the file item; however, this option is left to the user rather than to the maker of the software. The structure of this item is as follows: ITEM KEY=COLOR.XREF 001 COLOR NAMEs, multivalued 002 COLOR NUMBERs, multivalued EXAMPLE 001 RED]BLUE]YELLOW]GREEN]PINK]WHITE]HIGHWHITE 002 1]2]3]4]5]6]7 In the above example, you can see that it is left up to the user to identify the names of the colors that are desired. In one of the later appendices, one can find the color numbers associated with the color name to determine how to create this item. ■───────────────────────────────────────────────────────────────■ GRAPH-FILE 99 CHAPTER 5 - FILES AND DEFINITIONS ■───────────────────────────────────────────────────────────────■ GRAPH-FILE continued DICT, GRAPH-FILE DEFAULT.COLORS This item contains a list of default colors to use when they are not previously selected in the GRAPH-FILE item to be displayed. The format of the item is the same as an item setup to display a graph, with the exception that there is no data in the item, only COLOR NAMES or COLOR NUMBERS. ITEM KEY=DEFAULT.COLORS 001 002 003 004 005 006 007 15 008 15 009 15 010 1 011 7 012 15 The example above shows the colors that are already setup when you receive your software. Notice that attributes one through six are NULL and seven through twelve contain numbers. The following information describes the effect of the COLOR NUMBERS to the graph when it is displayed. 007 - Heading Color 008 - Vertical Color 009 - Horizontal Color 010 - Background Color 011 - Default Text Color 012 - Outline Color ** NOTE ** All colors are optional and can be either the name of the color or the COLOR NUMBER. ■───────────────────────────────────────────────────────────────■ GRAPH-FILE 99 CHAPTER 5 - FILES AND DEFINITIONS ■───────────────────────────────────────────────────────────────■ GRAPH-FILE continued The contents of the GRAPH-FILE are very simple and easy to use. Data is the only requirement to make use of the PIE and/or BAR type charts. The following information defines and explains the data required in the GRAPH-FILE. ITEM KEY=User Defined 001 Headings ;Multivalued (x3 max) 002 reserved 003 Horizontal Name 004 Element Values ;Multivalued ;Subvalue a "1" in this attribute, signifies to pull a piece of the PIE when using a PIE type chart. 005 Element Text ;Multivalued 006 Element Colors ;Multivalued 007 Heading Color 008 Vertical Color 009 Horizontal Color 010 Background Color 011 Default Text Color 012 Outline Color ■───────────────────────────────────────────────────────────────■ GRAPH-FILE 99