home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 3 / PDCD_3.iso / pocketbk / developmen / opl3a / OPL.DBF (.txt)
Psion Database  |  1993-12-12  |  39KB  |  851 lines

  1. OPLDatabaseFile
  2. ROM::PSAPPLE.WDR
  3. Command
  4. Command:
  5. Command:
  6. Syntax:
  7. Purpose:
  8.  KEYWORDS:
  9.     bit        diam        gtext        opa
  10.     control    dir        io            sprite
  11.     conv        draw        key        statwin
  12.     data        error        lib            string
  13.     date        event        math        text
  14.     device    file        mem        time
  15.     dialog        font        menu        winm
  16. .ABS .IABS    _conv
  17. a=ABS(x)
  18. i&=IABS(x&)FReturn the absolute value of fp or int x (ABS) and long int x& (IABS).U
  19. .ADDR    _mem
  20. a%=ADDR(var)<Returns the address at which a variable is stored in memory.
  21. .ADJUSTALLOC    _mem!p%=ADJUSTALLOC(pcell%, off%, am%)iAdjusts allocated cell pcell% at offset off% by amount am%. A gap is opened if am%>0 and closed if am%<0.,p% = new cell pointer or 0 if out of memory.t
  22. .ALERT    _dialogwr%=ALERT(m1$, m2$, b1$, b2$, b3$)
  23. r%=ALERT(m1$, m2$, b1$, b2$)
  24. r%=ALERT(m1$, m2$, b1$)
  25. r%=ALERT(m1$, m2$)
  26. r%=ALERT(m1$)!Displays a simple "alert" dialog.
  27. m1$    Message for the 1st line
  28. m2$    Message for the 2nd line
  29. b1$    Text above Esc button
  30. b2$    Text above Enter button
  31. b3$    Text above Space button
  32. r%=    1    Esc is pressed
  33.         2    Enter is pressed
  34.         3    Space is pressed
  35. .ALLOC .REALLOC    _mem1pcell%=ALLOC(size%)
  36. pcell%=REALLOC(pcell%, size%)
  37. ALLOC allocates specified amount of memory returning pointer to the cell pcell%. REALLOC changes the size of previously allocated pcell% returning new pointer."Both return NULL if out of memory.P
  38. .APP. . .ENDA    _opa
  39. APP name
  40. . . .
  41. ENDA(Begins definition of an OPA called name.u
  42. .APPEND    _data
  43. APPEND_Appends a new blank record to the end of the current data file and makes it the current record.h
  44. .APPENDSPRITE    _spriteGAPPENDSPRITE time%, var bit$(), dx%, dy%
  45. APPENDSPRITE time%, var bit$()2Appends a single bitmap-set to the current sprite.-time%    "shatter speed" in 1/10ths of a second.Sbit$()    6 bitmap filenames or "" for no bitmap. Array elements represent bitmaps to:
  46.     1    set black
  47.     2    clear black
  48.     3    invert black
  49.     4    set grey
  50.     5    clear grey
  51.     6    invert greyk
  52. .ASC    _string _conv
  53. a%=ASC(a$)LReturns the ASCII character code of the first character of a$ or 0 if a$="".
  54.     .AT    _text    AT x%, y%
  55. Positions the text cursor.
  56. x%    text column (1 to 60)
  57. y%    text row (1 to 17))The ranges assume using the default font.J
  58. .BEEP
  59. BEEP time%, pitch%
  60. Sounds the buzzer.
  61. time%    in 1/32nds of a  second (max is 3840 = 2 minutes). If time%<0, BEEP first checks to see if the sound system is free and returns if it is. Otherwise, BEEP waits until the sound system is free.
  62. pitch%    512/(pitch%+1) kHz'freq=440*2**(n%/12),  n%=1 for middle A
  63. BEEP 5,300 sounds ok.D
  64. .BREAK    _control
  65. BREAK-Exits a DO ... UNTIL or WHILE ... ENDWH loop.
  66. .BUSY    _gtext6BUSY str$, c%, delay%
  67. BUSY str$, c%
  68. BUSY str$
  69. BUSY OFF
  70. Displays a "busy" message.!str$    the message (up to 19 chars)
  71. c%    corner position:   0 top left                        2 top right(  1 bottom left (default)    3 bottom right
  72. delay%    delay time in 
  73.  seconds
  74. .CACHE    _mem
  75. CACHE init%, max%
  76. CACHE ON/OFFICreates a procedure cache of  init% bytes that can grow up to max% bytes.MCACHE OFF disables the created cache that can be then re-enabled by CACHE ON.U
  77. .CACHEHDR    _mem
  78. CACHEHDR addr(hdr%())
  79. Fills 11-element array hdr%() with cache info that changes whenever a procedure is called. The elements of hdr%() (meaningful only if hdr%(10) is not 0) contain:
  80. 1    address of cache
  81. 2    number of cached procedures
  82. 3    max size of cache in bytes 4    current size of cache in byted
  83. 5    free bytes in cache36    total number of unused bytes in cached procedures77    offset from start of index to first free index record-8    ...to most recently used record (0 if none).9    ...to least recently used record (0 if none)%10    address of cache index (0 if none)
  84. 11    true if cacheing is ON-
  85. .CACHEREC    _mem
  86. CACHEREC addr(rec%()), off%
  87. Fills 18-element array rec%() with cache index record at offset off%. Info changes whenever procedure is called. Elements of rec%() contain:(1    offset to less recently used procedure(2    offset to more recently used procedure
  88. 3    usage count34    offset within cache to procedure frame descriptor$5    ...to translated code of procedure
  89. 6    ...to end of translated code#7    number of bytes used by procedure-8-15    procedure name, followed by private data
  90. 16    address of module name
  91. 17    address of cache index
  92. 18    true if cache is OND
  93. .CACHETIDY    _mem    CACHETIDY)Removes any unused procedures from cache.I
  94. .CALL$e%=CALL(s%, bx%, cx%, dx%, si%, di%)
  95. Makes operating system calls.
  96. .CHANGESPRITE    _spriteQCHANGESPRITE ix%, time%, var bit$(), dx%, dy%
  97. CHANGESPRITE ix%, time%, var bit$()aChanges the bitmap-set specified by ix% (starting with 1). See APPENDSPRITE for other parameters.J
  98. .CHR$    _string _conv
  99. a$=CHR$(x%))Returns the character with ASCII code x%.t
  100. .CLOSE    _data
  101. CLOSE`CLOSE closes the current data file. If the file is stored on a RAM media, it is also compressed.D
  102. .CLOSESPRITE    _sprite
  103. CLOSESPRITE id%
  104. Closes the sprite with ID id%.V
  105. .CLS    _text
  106. CLSFClears the contents of the text window and resets the cursor position.
  107. .CMD$    _opa
  108. c$=CMD$(x%)BReturns the command-line arguments passed when starting a program.
  109. x%    c$
  110.  1        Program full path name
  111.  2        File full path name
  112.  3        "C" (Create) or "O" (Open)
  113.  4        Alias information, if any
  114.  5        Applicaion name
  115. x%=2 to 5 is for OPAs only
  116. .COMPRESS    _data
  117. COMPRESS src$, dest$
  118. Copies data file src$ to another data file dest$. If the destintion file already exists, the records are appended. Supports wildcards.z
  119. .CONTINUE    _control
  120. CONTINUE]Makes a program immediately go to the test condition of DO ... UNTIL or WHILE ... ENDWH loop.y
  121. .COPY    _file
  122. COPY src$, dest$[Copies the file src$, which may be of any type, to the file dest$. Wildcards are supported.g
  123. .COUNT    _data
  124. c%=COUNTPReturns the number of records in the current data file (0 if the file is empty).A
  125. .CREATE .OPEN .OPENR    _dataVCREATE file$, log, f1, f2,...
  126. OPEN file$, log, f1, f2,...
  127. OPENR file$, log, f1, f2,...cCREATE creates a new data file. An existing one can be opened normally (OPEN) or read-only (OPENR).
  128. file$        data file name*log        logical file name log (A, B, C, or D))f1, f2...    names of data fields (up to 32)R
  129. .CREATESPRITE    _sprite
  130. id%=CREATESPRITE*Creates a sprite, returning the sprite ID.
  131. .CURSOR    _text _gtextcCURSOR ON/OFF
  132. CURSOR id%, asc%, width%, height%
  133. CURSOR id%, asc%, width%, height%, type%
  134. CURSOR id%gSwitches cursor on and off, specifies the cursor's shape and position relative to the baseline of text.
  135. id%    specifies a window
  136. asc%    font ascent - number of pixels (-128 to 127) by which the top of the cursor should be above the baseline (default: current font).
  137. width%    0 to 255 (default: 2)(height%    0 to 255 (default: current font)
  138. type%        1    obloid cursor
  139.             2    not flashing                4    grey
  140. #.DATETOSECS .SECSTODATE    _date _time}s&=DATETOSECS(yr%, mo%, dt%, hr%, min%, sec%)
  141. SECSTODATE s&, var yr%, var mo%, var dy%, var hr%, var mn%, var sc%, var yrday%-Convert between seconds and other time units.$s&            seconds since 00:00 on 1/1/1970
  142. yrday%    day in the year (1-366)q
  143. .DATIM$    _date _time    d$=DATIM$RReturns the current date and time as a string, such as "Sat 11 Dec 1993 10:14:30".l
  144. .DAY .MONTH .YEAR    _date
  145. d%=DAY
  146. m%=MONTH
  147. y%=YEAR
  148. Function:        returns:
  149. DAY            1-31
  150. MONTH        1-12
  151. YEAR            1900-2155
  152. .DAYNAME$ .MONTH$    _date
  153. d$=DAYNAME$(d%)
  154. m$=MONTH$(m%)6Convert d% to the day of the week or m% to month name.
  155. d%=    1 (MON) ... 7 (SUN)
  156. m%=    1 (Jan) ... 12 (Dec)R
  157. .DAYS    _date
  158. d&=DAYS(day%,month%,year%)*Returns the number of days since 1/1/1900.E
  159. .dBUTTONS    _dialogSdBUTTONS p1$, k1%, p2$, k2%, p3$, k3%
  160. dBUTTONS p1$, k1%, p2$, k2%
  161. dBUTTONS p1$, k1%:Defines up to 3 exit keys to go at the bottom of a dialog.
  162. p$        text above a button
  163. k%    keycode of the key, e.g., %A is the code for "A" (DIALOG returns keycodes for lowercase letters). Negative value defines a "cancel" key.
  164. .dCHOICE    _dialog
  165. dCHOICE var choice%, p$, list$(Defines a choice list to go in a dialog.Qchoice%    specifies the initial choice (starting with 1) and accomodates the result
  166. p$            prompt on the left side6list$        possible choices separated by commas ("Yes,No")
  167. .dDATE    _dialog _date
  168. dDATE var lg&, p$, min&, max&2Defines an edit box for a date, to go in a dialog.Xlg&    specifies the initial date (in days since 1/1/1900) and accomodates the result value
  169. p$        prompt on the left side
  170. min&    minimum value allowed
  171. max&    maximum value allowed
  172. .dEDIT    _dialog+dEDIT var str$, p$, len%
  173. dEDIT var str$, p$-Defines a string edit box, to go in a dialog.
  174. str