plparseopts(3plplot) [debian man page]
PLPARSEOPTS(3plplot) PLplot API PLPARSEOPTS(3plplot) NAME
plparseopts - Parse command-line arguments SYNOPSIS
int plparseopts(p_argc, argv, mode) DESCRIPTION
Parse command-line arguments. plparseopts(3plplot) removes all recognized flags (decreasing argc accordingly), so that invalid input may be readily detected. It can also be used to process user command line flags. The user can merge an option table of type PLOptionTable into the internal option table info structure using plMergeOpts(3plplot). Or, the user can specify that ONLY the external table(s) be parsed by calling plClearOpts(3plplot) before plMergeOpts(3plplot). The default action taken by plparseopts(3plplot) is as follows: Returns with an error if an unrecognized option or badly formed option-value pair are encountered. Returns immediately (return code 0) when the first non-option command line argument is found. Returns with the return code of the option handler, if one was called. Deletes command line arguments from argv list as they are found, and decrements argc accordingly. Does not show "invisible" options in usage or help messages. Assumes the program name is contained in argv[0]. These behaviors may be controlled through the mode argument. Redacted form: General: plparseopts(argv, mode) Perl/PDL: Not available? This function is used in all of the examples. ARGUMENTS
p_argc (int *, input) pointer to number of arguments. argv (char **, input) Pointer to character array containing *p_argc command-line arguments. mode (PLINT, input) Parsing mode with the following possibilities: PL_PARSE_FULL(1) -- Full parsing of command line and all error messages enabled, including program exit when an error occurs. Anything on the command line that isn't recognized as a valid option or option argu- ment is flagged as an error. PL_PARSE_QUIET(2) -- Turns off all output except in the case of errors. PL_PARSE_NODELETE(4) -- Turns off deletion of processed arguments. PL_PARSE_SHOWALL(8) -- Show invisible options PL_PARSE_NOPROGRAM(32) -- Specified if argv[0] is NOT a pointer to the program name. PL_PARSE_NODASH(64) -- Set if leading dash is NOT required. PL_PARSE_SKIP(128) -- Set to quietly skip over any unrecognized arguments. AUTHORS
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere. SEE ALSO
PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLPARSEOPTS(3plplot)
Check Out this Related Man Page
PLSHADE(3plplot) PLplot API PLSHADE(3plplot) NAME
plshade - Shade individual region on the basis of value SYNOPSIS
plshade(a, nx, ny, defined, xmin, xmax, ymin, ymax, shade_min, shade_max, sh_cmap, sh_color, sh_width, min_color, min_width, max_color, max_width, fill, rectangular, pltr, pltr_data) DESCRIPTION
Shade individual region on the basis of value. Use plshades(3plplot) if you want to shade a number of regions using continuous colors. plshade(3plplot) is identical to plshade1(3plplot) except for the type of the first parameter. See plshade1(3plplot) for further discus- sion. Redacted form: General: plshade(a, defined, xmin, xmax, ymin, ymax, shade_min, shade_max, sh_cmap, sh_color, sh_width, min_color, min_width, max_color, max_width, fill, rectangular, pltr, pltr_data) Perl/PDL: Not available? This function is used in example 15. ARGUMENTS
a (PLFLT **, input) nx (PLINT, input) ny (PLINT, input) defined (PLINT (*) (PLFLT, PLFLT), input) xmin (PLFLT, input) xmax (PLFLT, input) ymin (PLFLT, input) ymax (PLFLT, input) shade_min (PLFLT, input) shade_max (PLFLT, input) sh_cmap (PLINT, input) sh_color (PLFLT, input) sh_width (PLINT, input) min_color (PLINT, input) min_width (PLINT, input) max_color (PLINT, input) max_width (PLINT, input) fill (void (*) (PLINT, PLFLT *, PLFLT *), input) rectangular (PLBOOL, input) pltr (void (*) (PLFLT, PLFLT, PLFLT *, PLFLT *, PLPointer) , input) pltr_data (PLPointer, input) AUTHORS
Geoffrey Furnish and Maurice LeBrun wrote and maintain PLplot. This man page was automatically generated from the DocBook source of the PLplot documentation, maintained by Alan W. Irwin and Rafael Laboissiere. SEE ALSO
PLplot documentation at http://plplot.sourceforge.net/resources. August, 2012 PLSHADE(3plplot)