note 101550 deleted from function.pdf-begin-page-ext by danbrown

Note Submitter: brad219 at gmail dot com ---- Just spent about 15 minutes trying to figure out what can be placed in the "optlist". I don't have the full list of possible options, but I've found this in the source code for PDFlib-Lite ('pc_optparse.h'). It only really describes the syntax though. Hope it's helpful to somebody besides myself: /* * Optlist * ------- * An optlist is a string containing pairs of the form * "optionname optionvalue(s)". The separator characters * are "\f\n\r\t\v =". * * There are options of different types (see pdc_opttype): * * Boolean (pdc_booleanlist) * Strings (pdc_stringlist) * Keywords (pdc_keywordlist) * Integers (pdc_integerlist) * Floats (pdc_floatlist) * Doubles (pdc_doublelist) * Scalars (pdc_scalarlist) * Unichars (pdc_unicharlist) * Polylinelist (pdc_polylinelist) * Handles (pdc_colorhandle ...) * * An option can have one or more values. Boolean options can be * provided without any value. If an option has more than one value, * then these values have to be set in braces. Examples: * * dasharray {11 22 33} * * Strings with white spaces have to be set in braces too. * Examples: * * fullname {Ludwig Wittgenstein} * composers {{Gustav Mahler}} * comment {} * * The allowed option names and the limitations of their values * must be defined in an array of enumeration type pdc_defopt * (see below). Such an option definition specifies (in brackets * the member name in the pdc_defopt struct) * * - the name of the option (name) * - the type of the option (type) * - value restrictions by bit flags (flags) * - the minimal and maximal permitted number of values * (minnum, maxnum) * - the minimal and maximal permitted value, or string * length resp. (minval, maxval) * - the permitted keywords in a keyword list (is required) or * the permitted integer numbers in a integer list (is optional), * resp. (keylist) * * Remarks: * * - minnum = maxnum = 1: The program expects a single value, * otherwise an array. If an array consists of only one value * the braces can be omitted - but not in the case of strings * with white spaces (see example above). * - Boolean options have the values "true" or "false". A shorter * equivalent notation is "name" or "noname". for "name true" * or "name false", resp. * - White spaces in strings can be forbidden by the flag * PDC_OPT_NOSPACES. * - It's only possible to specify a single number interval (minval, * maxval) which must contain the number. The flag PDC_OPT_NOZERO * can forbid zero additionally. * - Keywords will always be converted to integer numbers (keycodes) * according to the specified pdc_keyconn array. * - It is possible to specify keywords for integers, floats and * doubles additionally by an optional keylist entry. For integers * it is possible to specify the allowed integer values by an optional * keylist and by the flag PDC_OPT_INTLIST. * - If more than one keyword is permitted, then the flag * PDC_OPT_BUILDOR decides, whether a bit pattern must be * built by or-ing the single keycodes or not.