Home » Archimedes archive » Micro User » MU 1992-02.adf » PD » Twilight/Parameters

Twilight/Parameters

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Micro User » MU 1992-02.adf » PD
Filename: Twilight/Parameters
Read OK:
File size: 0C4E bytes
Load address: 0000
Exec address: 0000
File contents
Twilight Programmers Reference Disc
Parameters


The parameters which are shown in the parameters pane are described by a
description in the effect. This area is created by the controldes program,
and is specified by a text file. Knowledge of the format of this area is not
necessary because of this, and it should not be assumed as it may change
(but not in an incompatable way) in the future. The format is not described
here.

There are five types of parameter you can use in an effect:
 value
 slider
 menu
 switch
 text

To see what they look like, look at the effects supplied with Twilight.

Each of these types is specified by a line in the text file given to
controldes begining with a ':'. Any other line is regarded as a comment. You
should be aware that there is no error checking on the input file. If you
put rubbish in, rubbish will come out.

In the syntaxs below, it should be obvious wether a string or a number is
expected. If not, look at some of the example description files. Strings do
not need to be enclosed by "s, but are terminated by a ','. No string should
be a null string. Use a ' ' instead.

The default value is always a number except for a text parameter.

Appending control description
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The controldes program is used to append this. It's syntax is:

  controldes <effect name> <code name> <textual description name>


end of description
~~~~~~~~~~~~~~~~~~
syntax:
:e

This shows the end of the text file. If it is omitted, it will be accepted,
but strange things may happen.


value
~~~~~
syntax:
:v <min>,<max>,<name>,<default>

This create a value icon where the user may type in a number. Use it where
the number of not expected to be changed (such as number of fish), or the
number matters. The value is kept within the limits specified.


slider
~~~~~~
syntax:
:s <name>,<first value>,<last value>,<start label>,<end label>,
   <units>,<default>

NOTE: only four sliders may be used. Any more may crash the control panel.

This creates a slider. Use when the number doesn't actually need to be
particually accurate.


menu
~~~~
syntax:
:m <title>,<entries>,<default entry>,<entry 1>,<entry 2>,etc...

NOTE: default entry is numbered from 1, but is passed to effect numbered
      from 0

NOTE: only four menus may be used. Any more may crash the control panel.

A menu with a displayer for choosing from a list of selections. A random
option is always nice to have.


switch
~~~~~~
syntax:
:w <name>,0|1

 0 - off by default
 1 - on by default

A switch. Returns 0 - off, non-0 on in parameter block.


text
~~~~
syntax:
:t <len>,<name>,<default text>

NOTE: If a text string is just one ' ' then a null string will be put in the
      icon. If a null string is entred in the icon, a string consiting of
      one ' ' will be passed to the effect.

A icon for entering text.



Format of the parameter block passed to the effect
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
This parameter block is block of words. Entries are in the order of the
parameters. Each entry is a value, except in the case of a text parameter,
where it is a pointer to a null terminiated string.

00000000  54 77 69 6c 69 67 68 74  20 50 72 6f 67 72 61 6d  |Twilight Program|
00000010  6d 65 72 73 20 52 65 66  65 72 65 6e 63 65 20 44  |mers Reference D|
00000020  69 73 63 0a 50 61 72 61  6d 65 74 65 72 73 0a 0a  |isc.Parameters..|
00000030  0a 54 68 65 20 70 61 72  61 6d 65 74 65 72 73 20  |.The parameters |
00000040  77 68 69 63 68 20 61 72  65 20 73 68 6f 77 6e 20  |which are shown |
00000050  69 6e 20 74 68 65 20 70  61 72 61 6d 65 74 65 72  |in the parameter|
00000060  73 20 70 61 6e 65 20 61  72 65 20 64 65 73 63 72  |s pane are descr|
00000070  69 62 65 64 20 62 79 20  61 0a 64 65 73 63 72 69  |ibed by a.descri|
00000080  70 74 69 6f 6e 20 69 6e  20 74 68 65 20 65 66 66  |ption in the eff|
00000090  65 63 74 2e 20 54 68 69  73 20 61 72 65 61 20 69  |ect. This area i|
000000a0  73 20 63 72 65 61 74 65  64 20 62 79 20 74 68 65  |s created by the|
000000b0  20 63 6f 6e 74 72 6f 6c  64 65 73 20 70 72 6f 67  | controldes prog|
000000c0  72 61 6d 2c 0a 61 6e 64  20 69 73 20 73 70 65 63  |ram,.and is spec|
000000d0  69 66 69 65 64 20 62 79  20 61 20 74 65 78 74 20  |ified by a text |
000000e0  66 69 6c 65 2e 20 4b 6e  6f 77 6c 65 64 67 65 20  |file. Knowledge |
000000f0  6f 66 20 74 68 65 20 66  6f 72 6d 61 74 20 6f 66  |of the format of|
00000100  20 74 68 69 73 20 61 72  65 61 20 69 73 20 6e 6f  | this area is no|
00000110  74 0a 6e 65 63 65 73 73  61 72 79 20 62 65 63 61  |t.necessary beca|
00000120  75 73 65 20 6f 66 20 74  68 69 73 2c 20 61 6e 64  |use of this, and|
00000130  20 69 74 20 73 68 6f 75  6c 64 20 6e 6f 74 20 62  | it should not b|
00000140  65 20 61 73 73 75 6d 65  64 20 61 73 20 69 74 20  |e assumed as it |
00000150  6d 61 79 20 63 68 61 6e  67 65 0a 28 62 75 74 20  |may change.(but |
00000160  6e 6f 74 20 69 6e 20 61  6e 20 69 6e 63 6f 6d 70  |not in an incomp|
00000170  61 74 61 62 6c 65 20 77  61 79 29 20 69 6e 20 74  |atable way) in t|
00000180  68 65 20 66 75 74 75 72  65 2e 20 54 68 65 20 66  |he future. The f|
00000190  6f 72 6d 61 74 20 69 73  20 6e 6f 74 20 64 65 73  |ormat is not des|
000001a0  63 72 69 62 65 64 0a 68  65 72 65 2e 0a 0a 54 68  |cribed.here...Th|
000001b0  65 72 65 20 61 72 65 20  66 69 76 65 20 74 79 70  |ere are five typ|
000001c0  65 73 20 6f 66 20 70 61  72 61 6d 65 74 65 72 20  |es of parameter |
000001d0  79 6f 75 20 63 61 6e 20  75 73 65 20 69 6e 20 61  |you can use in a|
000001e0  6e 20 65 66 66 65 63 74  3a 0a 20 76 61 6c 75 65  |n effect:. value|
000001f0  0a 20 73 6c 69 64 65 72  0a 20 6d 65 6e 75 0a 20  |. slider. menu. |
00000200  73 77 69 74 63 68 0a 20  74 65 78 74 0a 0a 54 6f  |switch. text..To|
00000210  20 73 65 65 20 77 68 61  74 20 74 68 65 79 20 6c  | see what they l|
00000220  6f 6f 6b 20 6c 69 6b 65  2c 20 6c 6f 6f 6b 20 61  |ook like, look a|
00000230  74 20 74 68 65 20 65 66  66 65 63 74 73 20 73 75  |t the effects su|
00000240  70 70 6c 69 65 64 20 77  69 74 68 20 54 77 69 6c  |pplied with Twil|
00000250  69 67 68 74 2e 0a 0a 45  61 63 68 20 6f 66 20 74  |ight...Each of t|
00000260  68 65 73 65 20 74 79 70  65 73 20 69 73 20 73 70  |hese types is sp|
00000270  65 63 69 66 69 65 64 20  62 79 20 61 20 6c 69 6e  |ecified by a lin|
00000280  65 20 69 6e 20 74 68 65  20 74 65 78 74 20 66 69  |e in the text fi|
00000290  6c 65 20 67 69 76 65 6e  20 74 6f 0a 63 6f 6e 74  |le given to.cont|
000002a0  72 6f 6c 64 65 73 20 62  65 67 69 6e 69 6e 67 20  |roldes begining |
000002b0  77 69 74 68 20 61 20 27  3a 27 2e 20 41 6e 79 20  |with a ':'. Any |
000002c0  6f 74 68 65 72 20 6c 69  6e 65 20 69 73 20 72 65  |other line is re|
000002d0  67 61 72 64 65 64 20 61  73 20 61 20 63 6f 6d 6d  |garded as a comm|
000002e0  65 6e 74 2e 20 59 6f 75  0a 73 68 6f 75 6c 64 20  |ent. You.should |
000002f0  62 65 20 61 77 61 72 65  20 74 68 61 74 20 74 68  |be aware that th|
00000300  65 72 65 20 69 73 20 6e  6f 20 65 72 72 6f 72 20  |ere is no error |
00000310  63 68 65 63 6b 69 6e 67  20 6f 6e 20 74 68 65 20  |checking on the |
00000320  69 6e 70 75 74 20 66 69  6c 65 2e 20 49 66 20 79  |input file. If y|
00000330  6f 75 0a 70 75 74 20 72  75 62 62 69 73 68 20 69  |ou.put rubbish i|
00000340  6e 2c 20 72 75 62 62 69  73 68 20 77 69 6c 6c 20  |n, rubbish will |
00000350  63 6f 6d 65 20 6f 75 74  2e 0a 0a 49 6e 20 74 68  |come out...In th|
00000360  65 20 73 79 6e 74 61 78  73 20 62 65 6c 6f 77 2c  |e syntaxs below,|
00000370  20 69 74 20 73 68 6f 75  6c 64 20 62 65 20 6f 62  | it should be ob|
00000380  76 69 6f 75 73 20 77 65  74 68 65 72 20 61 20 73  |vious wether a s|
00000390  74 72 69 6e 67 20 6f 72  20 61 20 6e 75 6d 62 65  |tring or a numbe|
000003a0  72 20 69 73 0a 65 78 70  65 63 74 65 64 2e 20 49  |r is.expected. I|
000003b0  66 20 6e 6f 74 2c 20 6c  6f 6f 6b 20 61 74 20 73  |f not, look at s|
000003c0  6f 6d 65 20 6f 66 20 74  68 65 20 65 78 61 6d 70  |ome of the examp|
000003d0  6c 65 20 64 65 73 63 72  69 70 74 69 6f 6e 20 66  |le description f|
000003e0  69 6c 65 73 2e 20 53 74  72 69 6e 67 73 20 64 6f  |iles. Strings do|
000003f0  0a 6e 6f 74 20 6e 65 65  64 20 74 6f 20 62 65 20  |.not need to be |
00000400  65 6e 63 6c 6f 73 65 64  20 62 79 20 22 73 2c 20  |enclosed by "s, |
00000410  62 75 74 20 61 72 65 20  74 65 72 6d 69 6e 61 74  |but are terminat|
00000420  65 64 20 62 79 20 61 20  27 2c 27 2e 20 4e 6f 20  |ed by a ','. No |
00000430  73 74 72 69 6e 67 20 73  68 6f 75 6c 64 0a 62 65  |string should.be|
00000440  20 61 20 6e 75 6c 6c 20  73 74 72 69 6e 67 2e 20  | a null string. |
00000450  55 73 65 20 61 20 27 20  27 20 69 6e 73 74 65 61  |Use a ' ' instea|
00000460  64 2e 0a 0a 54 68 65 20  64 65 66 61 75 6c 74 20  |d...The default |
00000470  76 61 6c 75 65 20 69 73  20 61 6c 77 61 79 73 20  |value is always |
00000480  61 20 6e 75 6d 62 65 72  20 65 78 63 65 70 74 20  |a number except |
00000490  66 6f 72 20 61 20 74 65  78 74 20 70 61 72 61 6d  |for a text param|
000004a0  65 74 65 72 2e 0a 0a 41  70 70 65 6e 64 69 6e 67  |eter...Appending|
000004b0  20 63 6f 6e 74 72 6f 6c  20 64 65 73 63 72 69 70  | control descrip|
000004c0  74 69 6f 6e 0a 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |tion.~~~~~~~~~~~|
000004d0  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
000004e0  7e 7e 0a 54 68 65 20 63  6f 6e 74 72 6f 6c 64 65  |~~.The controlde|
000004f0  73 20 70 72 6f 67 72 61  6d 20 69 73 20 75 73 65  |s program is use|
00000500  64 20 74 6f 20 61 70 70  65 6e 64 20 74 68 69 73  |d to append this|
00000510  2e 20 49 74 27 73 20 73  79 6e 74 61 78 20 69 73  |. It's syntax is|
00000520  3a 0a 0a 20 20 63 6f 6e  74 72 6f 6c 64 65 73 20  |:..  controldes |
00000530  3c 65 66 66 65 63 74 20  6e 61 6d 65 3e 20 3c 63  |<effect name> <c|
00000540  6f 64 65 20 6e 61 6d 65  3e 20 3c 74 65 78 74 75  |ode name> <textu|
00000550  61 6c 20 64 65 73 63 72  69 70 74 69 6f 6e 20 6e  |al description n|
00000560  61 6d 65 3e 0a 0a 0a 65  6e 64 20 6f 66 20 64 65  |ame>...end of de|
00000570  73 63 72 69 70 74 69 6f  6e 0a 7e 7e 7e 7e 7e 7e  |scription.~~~~~~|
00000580  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 0a 73 79 6e  |~~~~~~~~~~~~.syn|
00000590  74 61 78 3a 0a 3a 65 0a  0a 54 68 69 73 20 73 68  |tax:.:e..This sh|
000005a0  6f 77 73 20 74 68 65 20  65 6e 64 20 6f 66 20 74  |ows the end of t|
000005b0  68 65 20 74 65 78 74 20  66 69 6c 65 2e 20 49 66  |he text file. If|
000005c0  20 69 74 20 69 73 20 6f  6d 69 74 74 65 64 2c 20  | it is omitted, |
000005d0  69 74 20 77 69 6c 6c 20  62 65 20 61 63 63 65 70  |it will be accep|
000005e0  74 65 64 2c 0a 62 75 74  20 73 74 72 61 6e 67 65  |ted,.but strange|
000005f0  20 74 68 69 6e 67 73 20  6d 61 79 20 68 61 70 70  | things may happ|
00000600  65 6e 2e 0a 0a 0a 76 61  6c 75 65 0a 7e 7e 7e 7e  |en....value.~~~~|
00000610  7e 0a 73 79 6e 74 61 78  3a 0a 3a 76 20 3c 6d 69  |~.syntax:.:v <mi|
00000620  6e 3e 2c 3c 6d 61 78 3e  2c 3c 6e 61 6d 65 3e 2c  |n>,<max>,<name>,|
00000630  3c 64 65 66 61 75 6c 74  3e 0a 0a 54 68 69 73 20  |<default>..This |
00000640  63 72 65 61 74 65 20 61  20 76 61 6c 75 65 20 69  |create a value i|
00000650  63 6f 6e 20 77 68 65 72  65 20 74 68 65 20 75 73  |con where the us|
00000660  65 72 20 6d 61 79 20 74  79 70 65 20 69 6e 20 61  |er may type in a|
00000670  20 6e 75 6d 62 65 72 2e  20 55 73 65 20 69 74 20  | number. Use it |
00000680  77 68 65 72 65 0a 74 68  65 20 6e 75 6d 62 65 72  |where.the number|
00000690  20 6f 66 20 6e 6f 74 20  65 78 70 65 63 74 65 64  | of not expected|
000006a0  20 74 6f 20 62 65 20 63  68 61 6e 67 65 64 20 28  | to be changed (|
000006b0  73 75 63 68 20 61 73 20  6e 75 6d 62 65 72 20 6f  |such as number o|
000006c0  66 20 66 69 73 68 29 2c  20 6f 72 20 74 68 65 0a  |f fish), or the.|
000006d0  6e 75 6d 62 65 72 20 6d  61 74 74 65 72 73 2e 20  |number matters. |
000006e0  54 68 65 20 76 61 6c 75  65 20 69 73 20 6b 65 70  |The value is kep|
000006f0  74 20 77 69 74 68 69 6e  20 74 68 65 20 6c 69 6d  |t within the lim|
00000700  69 74 73 20 73 70 65 63  69 66 69 65 64 2e 0a 0a  |its specified...|
00000710  0a 73 6c 69 64 65 72 0a  7e 7e 7e 7e 7e 7e 0a 73  |.slider.~~~~~~.s|
00000720  79 6e 74 61 78 3a 0a 3a  73 20 3c 6e 61 6d 65 3e  |yntax:.:s <name>|
00000730  2c 3c 66 69 72 73 74 20  76 61 6c 75 65 3e 2c 3c  |,<first value>,<|
00000740  6c 61 73 74 20 76 61 6c  75 65 3e 2c 3c 73 74 61  |last value>,<sta|
00000750  72 74 20 6c 61 62 65 6c  3e 2c 3c 65 6e 64 20 6c  |rt label>,<end l|
00000760  61 62 65 6c 3e 2c 0a 20  20 20 3c 75 6e 69 74 73  |abel>,.   <units|
00000770  3e 2c 3c 64 65 66 61 75  6c 74 3e 0a 0a 4e 4f 54  |>,<default>..NOT|
00000780  45 3a 20 6f 6e 6c 79 20  66 6f 75 72 20 73 6c 69  |E: only four sli|
00000790  64 65 72 73 20 6d 61 79  20 62 65 20 75 73 65 64  |ders may be used|
000007a0  2e 20 41 6e 79 20 6d 6f  72 65 20 6d 61 79 20 63  |. Any more may c|
000007b0  72 61 73 68 20 74 68 65  20 63 6f 6e 74 72 6f 6c  |rash the control|
000007c0  20 70 61 6e 65 6c 2e 0a  0a 54 68 69 73 20 63 72  | panel...This cr|
000007d0  65 61 74 65 73 20 61 20  73 6c 69 64 65 72 2e 20  |eates a slider. |
000007e0  55 73 65 20 77 68 65 6e  20 74 68 65 20 6e 75 6d  |Use when the num|
000007f0  62 65 72 20 64 6f 65 73  6e 27 74 20 61 63 74 75  |ber doesn't actu|
00000800  61 6c 6c 79 20 6e 65 65  64 20 74 6f 20 62 65 0a  |ally need to be.|
00000810  70 61 72 74 69 63 75 61  6c 6c 79 20 61 63 63 75  |particually accu|
00000820  72 61 74 65 2e 0a 0a 0a  6d 65 6e 75 0a 7e 7e 7e  |rate....menu.~~~|
00000830  7e 0a 73 79 6e 74 61 78  3a 0a 3a 6d 20 3c 74 69  |~.syntax:.:m <ti|
00000840  74 6c 65 3e 2c 3c 65 6e  74 72 69 65 73 3e 2c 3c  |tle>,<entries>,<|
00000850  64 65 66 61 75 6c 74 20  65 6e 74 72 79 3e 2c 3c  |default entry>,<|
00000860  65 6e 74 72 79 20 31 3e  2c 3c 65 6e 74 72 79 20  |entry 1>,<entry |
00000870  32 3e 2c 65 74 63 2e 2e  2e 0a 0a 4e 4f 54 45 3a  |2>,etc.....NOTE:|
00000880  20 64 65 66 61 75 6c 74  20 65 6e 74 72 79 20 69  | default entry i|
00000890  73 20 6e 75 6d 62 65 72  65 64 20 66 72 6f 6d 20  |s numbered from |
000008a0  31 2c 20 62 75 74 20 69  73 20 70 61 73 73 65 64  |1, but is passed|
000008b0  20 74 6f 20 65 66 66 65  63 74 20 6e 75 6d 62 65  | to effect numbe|
000008c0  72 65 64 0a 20 20 20 20  20 20 66 72 6f 6d 20 30  |red.      from 0|
000008d0  0a 0a 4e 4f 54 45 3a 20  6f 6e 6c 79 20 66 6f 75  |..NOTE: only fou|
000008e0  72 20 6d 65 6e 75 73 20  6d 61 79 20 62 65 20 75  |r menus may be u|
000008f0  73 65 64 2e 20 41 6e 79  20 6d 6f 72 65 20 6d 61  |sed. Any more ma|
00000900  79 20 63 72 61 73 68 20  74 68 65 20 63 6f 6e 74  |y crash the cont|
00000910  72 6f 6c 20 70 61 6e 65  6c 2e 0a 0a 41 20 6d 65  |rol panel...A me|
00000920  6e 75 20 77 69 74 68 20  61 20 64 69 73 70 6c 61  |nu with a displa|
00000930  79 65 72 20 66 6f 72 20  63 68 6f 6f 73 69 6e 67  |yer for choosing|
00000940  20 66 72 6f 6d 20 61 20  6c 69 73 74 20 6f 66 20  | from a list of |
00000950  73 65 6c 65 63 74 69 6f  6e 73 2e 20 41 20 72 61  |selections. A ra|
00000960  6e 64 6f 6d 0a 6f 70 74  69 6f 6e 20 69 73 20 61  |ndom.option is a|
00000970  6c 77 61 79 73 20 6e 69  63 65 20 74 6f 20 68 61  |lways nice to ha|
00000980  76 65 2e 0a 0a 0a 73 77  69 74 63 68 0a 7e 7e 7e  |ve....switch.~~~|
00000990  7e 7e 7e 0a 73 79 6e 74  61 78 3a 0a 3a 77 20 3c  |~~~.syntax:.:w <|
000009a0  6e 61 6d 65 3e 2c 30 7c  31 0a 0a 20 30 20 2d 20  |name>,0|1.. 0 - |
000009b0  6f 66 66 20 62 79 20 64  65 66 61 75 6c 74 0a 20  |off by default. |
000009c0  31 20 2d 20 6f 6e 20 62  79 20 64 65 66 61 75 6c  |1 - on by defaul|
000009d0  74 0a 0a 41 20 73 77 69  74 63 68 2e 20 52 65 74  |t..A switch. Ret|
000009e0  75 72 6e 73 20 30 20 2d  20 6f 66 66 2c 20 6e 6f  |urns 0 - off, no|
000009f0  6e 2d 30 20 6f 6e 20 69  6e 20 70 61 72 61 6d 65  |n-0 on in parame|
00000a00  74 65 72 20 62 6c 6f 63  6b 2e 0a 0a 0a 74 65 78  |ter block....tex|
00000a10  74 0a 7e 7e 7e 7e 0a 73  79 6e 74 61 78 3a 0a 3a  |t.~~~~.syntax:.:|
00000a20  74 20 3c 6c 65 6e 3e 2c  3c 6e 61 6d 65 3e 2c 3c  |t <len>,<name>,<|
00000a30  64 65 66 61 75 6c 74 20  74 65 78 74 3e 0a 0a 4e  |default text>..N|
00000a40  4f 54 45 3a 20 49 66 20  61 20 74 65 78 74 20 73  |OTE: If a text s|
00000a50  74 72 69 6e 67 20 69 73  20 6a 75 73 74 20 6f 6e  |tring is just on|
00000a60  65 20 27 20 27 20 74 68  65 6e 20 61 20 6e 75 6c  |e ' ' then a nul|
00000a70  6c 20 73 74 72 69 6e 67  20 77 69 6c 6c 20 62 65  |l string will be|
00000a80  20 70 75 74 20 69 6e 20  74 68 65 0a 20 20 20 20  | put in the.    |
00000a90  20 20 69 63 6f 6e 2e 20  49 66 20 61 20 6e 75 6c  |  icon. If a nul|
00000aa0  6c 20 73 74 72 69 6e 67  20 69 73 20 65 6e 74 72  |l string is entr|
00000ab0  65 64 20 69 6e 20 74 68  65 20 69 63 6f 6e 2c 20  |ed in the icon, |
00000ac0  61 20 73 74 72 69 6e 67  20 63 6f 6e 73 69 74 69  |a string consiti|
00000ad0  6e 67 20 6f 66 0a 20 20  20 20 20 20 6f 6e 65 20  |ng of.      one |
00000ae0  27 20 27 20 77 69 6c 6c  20 62 65 20 70 61 73 73  |' ' will be pass|
00000af0  65 64 20 74 6f 20 74 68  65 20 65 66 66 65 63 74  |ed to the effect|
00000b00  2e 0a 0a 41 20 69 63 6f  6e 20 66 6f 72 20 65 6e  |...A icon for en|
00000b10  74 65 72 69 6e 67 20 74  65 78 74 2e 0a 0a 0a 0a  |tering text.....|
00000b20  46 6f 72 6d 61 74 20 6f  66 20 74 68 65 20 70 61  |Format of the pa|
00000b30  72 61 6d 65 74 65 72 20  62 6c 6f 63 6b 20 70 61  |rameter block pa|
00000b40  73 73 65 64 20 74 6f 20  74 68 65 20 65 66 66 65  |ssed to the effe|
00000b50  63 74 0a 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |ct.~~~~~~~~~~~~~|
00000b60  7e 7e 7e 7e 7e 7e 7e 7e  7e 7e 7e 7e 7e 7e 7e 7e  |~~~~~~~~~~~~~~~~|
*
00000b80  7e 7e 7e 7e 7e 0a 54 68  69 73 20 70 61 72 61 6d  |~~~~~.This param|
00000b90  65 74 65 72 20 62 6c 6f  63 6b 20 69 73 20 62 6c  |eter block is bl|
00000ba0  6f 63 6b 20 6f 66 20 77  6f 72 64 73 2e 20 45 6e  |ock of words. En|
00000bb0  74 72 69 65 73 20 61 72  65 20 69 6e 20 74 68 65  |tries are in the|
00000bc0  20 6f 72 64 65 72 20 6f  66 20 74 68 65 0a 70 61  | order of the.pa|
00000bd0  72 61 6d 65 74 65 72 73  2e 20 45 61 63 68 20 65  |rameters. Each e|
00000be0  6e 74 72 79 20 69 73 20  61 20 76 61 6c 75 65 2c  |ntry is a value,|
00000bf0  20 65 78 63 65 70 74 20  69 6e 20 74 68 65 20 63  | except in the c|
00000c00  61 73 65 20 6f 66 20 61  20 74 65 78 74 20 70 61  |ase of a text pa|
00000c10  72 61 6d 65 74 65 72 2c  0a 77 68 65 72 65 20 69  |rameter,.where i|
00000c20  74 20 69 73 20 61 20 70  6f 69 6e 74 65 72 20 74  |t is a pointer t|
00000c30  6f 20 61 20 6e 75 6c 6c  20 74 65 72 6d 69 6e 69  |o a null termini|
00000c40  61 74 65 64 20 73 74 72  69 6e 67 2e 0a 0a        |ated string...|
00000c4e