From: <ai...@us...> - 2010-01-06 23:08:24
|
Revision: 10739 http://plplot.svn.sourceforge.net/plplot/?rev=10739&view=rev Author: airwin Date: 2010-01-06 23:08:17 +0000 (Wed, 06 Jan 2010) Log Message: ----------- Restore back to uncrustify comment style that somehow got changed by last commit. These changes are only whitespace. Modified Paths: -------------- trunk/src/plcore.c Modified: trunk/src/plcore.c =================================================================== --- trunk/src/plcore.c 2010-01-06 21:33:22 UTC (rev 10738) +++ trunk/src/plcore.c 2010-01-06 23:08:17 UTC (rev 10739) @@ -95,33 +95,33 @@ #include <errno.h> /*--------------------------------------------------------------------------*\ -* Driver Interface -* -* These routines are the low-level interface to the driver -- all calls to -* driver functions must pass through here. For implementing driver- -* specific functions, the escape function is provided. The command stream -* gets duplicated to the plot buffer here. -* -* All functions that result in graphics actually being plotted (rather than -* just a change of state) are filtered as necessary before being passed on. -* The default settings do not require any filtering, i.e. PLplot physical -* coordinates are the same as the device physical coordinates (currently -* this can't be changed anyway), and a global view equal to the entire page -* is used. -* -* The reason one wants to put view-specific filtering here is that if -* enabled, the plot buffer should receive the unfiltered data stream. This -* allows a specific view to be used from an interactive device (e.g. TCL/TK -* driver) but be restored to the full view at any time merely by -* reprocessing the contents of the plot buffer. -* -* The metafile, on the other hand, *should* be affected by changes in the -* view, since this is a crucial editing capability. It is recommended that -* the initial metafile be created without a restricted global view, and -* modification of the view done on a per-plot basis as desired during -* subsequent processing. -* -\*--------------------------------------------------------------------------*/ + * Driver Interface + * + * These routines are the low-level interface to the driver -- all calls to + * driver functions must pass through here. For implementing driver- + * specific functions, the escape function is provided. The command stream + * gets duplicated to the plot buffer here. + * + * All functions that result in graphics actually being plotted (rather than + * just a change of state) are filtered as necessary before being passed on. + * The default settings do not require any filtering, i.e. PLplot physical + * coordinates are the same as the device physical coordinates (currently + * this can't be changed anyway), and a global view equal to the entire page + * is used. + * + * The reason one wants to put view-specific filtering here is that if + * enabled, the plot buffer should receive the unfiltered data stream. This + * allows a specific view to be used from an interactive device (e.g. TCL/TK + * driver) but be restored to the full view at any time merely by + * reprocessing the contents of the plot buffer. + * + * The metafile, on the other hand, *should* be affected by changes in the + * view, since this is a crucial editing capability. It is recommended that + * the initial metafile be created without a restricted global view, and + * modification of the view done on a per-plot basis as desired during + * subsequent processing. + * + \*--------------------------------------------------------------------------*/ enum { AT_BOP, DRAWING, AT_EOP }; @@ -333,8 +333,8 @@ } /*--------------------------------------------------------------------------*\ -* Drawing commands. -\*--------------------------------------------------------------------------*/ + * Drawing commands. + \*--------------------------------------------------------------------------*/ /* Draw line between two points */ /* The plot buffer must be called first so it gets the unfiltered data */ @@ -506,17 +506,17 @@ */ /*--------------------------------------------------------------------------*\ -* int text2num( char *text, char end, PLUNICODE *num) -* char *text - pointer to the text to be parsed -* char end - end character (i.e. ')' or ']' to stop parsing -* PLUNICODE *num - pointer to an PLUNICODE to store the value -* -* Function takes a string, which can be either hex or decimal, -* and converts it into an PLUNICODE, stopping at either a null, -* or the character pointed to by 'end'. This implementation using -* the C library strtoul replaces the original brain-dead version -* and should be more robust to invalid control strings. -\*--------------------------------------------------------------------------*/ + * int text2num( char *text, char end, PLUNICODE *num) + * char *text - pointer to the text to be parsed + * char end - end character (i.e. ')' or ']' to stop parsing + * PLUNICODE *num - pointer to an PLUNICODE to store the value + * + * Function takes a string, which can be either hex or decimal, + * and converts it into an PLUNICODE, stopping at either a null, + * or the character pointed to by 'end'. This implementation using + * the C library strtoul replaces the original brain-dead version + * and should be more robust to invalid control strings. + \*--------------------------------------------------------------------------*/ int text2num( const char *text, char end, PLUNICODE *num ) { @@ -535,22 +535,22 @@ } /*--------------------------------------------------------------------------*\ -* int text2fci( char *text, unsigned char *hexdigit, unsigned char *hexpower) -* char *text - pointer to the text to be parsed -* unsigned char *hexdigit - pointer to hex value that is stored. -* unsigned char *hexpower - pointer to hex power (left shift) that is stored. -* -* Function takes a pointer to a string, which is looked up in a table -* to determine the corresponding FCI (font characterization integer) -* hex digit value and hex power (left shift). All matched strings -* start with "<" and end with the two characters "/>". -* If the lookup succeeds, hexdigit and hexpower are set to the appropriate -* values in the table, and the function returns the number of characters -* in text that are consumed by the matching string in the table lookup. -* -* If the lookup fails, hexdigit is set to 0, hexpower is set to and -* impossible value, and the function returns 0. -\*--------------------------------------------------------------------------*/ + * int text2fci( char *text, unsigned char *hexdigit, unsigned char *hexpower) + * char *text - pointer to the text to be parsed + * unsigned char *hexdigit - pointer to hex value that is stored. + * unsigned char *hexpower - pointer to hex power (left shift) that is stored. + * + * Function takes a pointer to a string, which is looked up in a table + * to determine the corresponding FCI (font characterization integer) + * hex digit value and hex power (left shift). All matched strings + * start with "<" and end with the two characters "/>". + * If the lookup succeeds, hexdigit and hexpower are set to the appropriate + * values in the table, and the function returns the number of characters + * in text that are consumed by the matching string in the table lookup. + * + * If the lookup fails, hexdigit is set to 0, hexpower is set to and + * impossible value, and the function returns 0. + \*--------------------------------------------------------------------------*/ int text2fci( const char *text, unsigned char *hexdigit, unsigned char *hexpower ) { @@ -1058,7 +1058,7 @@ idx = plhershey2unicode( ig + 527 ); i += 2; skip = 1; /* skip is set if we have copied something - * into the unicode table */ + * into the unicode table */ args.n_char = \ (PLUNICODE) hershey_to_unicode_lookup_table[idx].Unicode; @@ -1337,24 +1337,24 @@ } /*--------------------------------------------------------------------------*\ -* void difilt -* -* Driver interface filter -- passes all coordinates through a variety -* of filters. These include filters to change : -* -* - mapping of meta to physical coordinates -* - plot orientation -* - window into plot (zooms) -* - window into device (i.e set margins) -* -* The filters are applied in the order specified above. Because the -* orientation change comes first, subsequent window specifications affect -* the new coordinates (i.e. after a 90 degree flip, what was x is now y). -* This is the only way that makes sense from a graphical interface -* (e.g. TCL/TK driver). -* -* Where appropriate, the page clip limits are modified. -\*--------------------------------------------------------------------------*/ + * void difilt + * + * Driver interface filter -- passes all coordinates through a variety + * of filters. These include filters to change : + * + * - mapping of meta to physical coordinates + * - plot orientation + * - window into plot (zooms) + * - window into device (i.e set margins) + * + * The filters are applied in the order specified above. Because the + * orientation change comes first, subsequent window specifications affect + * the new coordinates (i.e. after a 90 degree flip, what was x is now y). + * This is the only way that makes sense from a graphical interface + * (e.g. TCL/TK driver). + * + * Where appropriate, the page clip limits are modified. + \*--------------------------------------------------------------------------*/ void difilt( PLINT *xscl, PLINT *yscl, PLINT npts, @@ -1488,11 +1488,11 @@ } /*--------------------------------------------------------------------------*\ -* void difilt_clip -* -* This provides the transformed text clipping region for the benefit of -* those drivers that render their own text. -\*--------------------------------------------------------------------------*/ + * void difilt_clip + * + * This provides the transformed text clipping region for the benefit of + * those drivers that render their own text. + \*--------------------------------------------------------------------------*/ void difilt_clip( PLINT *x_coords, PLINT *y_coords ) @@ -1516,11 +1516,11 @@ /*--------------------------------------------------------------------------*\ -* void pldi_ini -* -* Updates driver interface, making sure everything is in order. -* Even if filter is not being used, the defaults need to be set up. -\*--------------------------------------------------------------------------*/ + * void pldi_ini + * + * Updates driver interface, making sure everything is in order. + * Even if filter is not being used, the defaults need to be set up. + \*--------------------------------------------------------------------------*/ static void setdef_diplt() @@ -1572,13 +1572,13 @@ } /*--------------------------------------------------------------------------*\ -* void pldid2pc -* -* Converts input values from relative device coordinates to relative plot -* coordinates. This function must be called when selecting a plot window -* from a display driver, since the coordinates chosen by the user are -* necessarily device-specific. -\*--------------------------------------------------------------------------*/ + * void pldid2pc + * + * Converts input values from relative device coordinates to relative plot + * coordinates. This function must be called when selecting a plot window + * from a display driver, since the coordinates chosen by the user are + * necessarily device-specific. + \*--------------------------------------------------------------------------*/ void pldid2pc( PLFLT *xmin, PLFLT *ymin, PLFLT *xmax, PLFLT *ymax ) @@ -1620,11 +1620,11 @@ } /*--------------------------------------------------------------------------*\ -* void pldip2dc -* -* Converts input values from relative plot coordinates to relative -* device coordinates. -\*--------------------------------------------------------------------------*/ + * void pldip2dc + * + * Converts input values from relative plot coordinates to relative + * device coordinates. + \*--------------------------------------------------------------------------*/ void pldip2dc( PLFLT *xmin, PLFLT *ymin, PLFLT *xmax, PLFLT *ymax ) @@ -1666,10 +1666,10 @@ } /*--------------------------------------------------------------------------*\ -* void plsdiplt -* -* Set window into plot space -\*--------------------------------------------------------------------------*/ + * void plsdiplt + * + * Set window into plot space + \*--------------------------------------------------------------------------*/ void c_plsdiplt( PLFLT xmin, PLFLT ymin, PLFLT xmax, PLFLT ymax ) @@ -1690,10 +1690,10 @@ } /*--------------------------------------------------------------------------*\ -* void plsdiplz -* -* Set window into plot space incrementally (zoom) -\*--------------------------------------------------------------------------*/ + * void plsdiplz + * + * Set window into plot space incrementally (zoom) + \*--------------------------------------------------------------------------*/ void c_plsdiplz( PLFLT xmin, PLFLT ymin, PLFLT xmax, PLFLT ymax ) @@ -1710,15 +1710,15 @@ } /*--------------------------------------------------------------------------*\ -* void calc_diplt -* -* Calculate transformation coefficients to set window into plot space. -* -* Note: if driver has requested to handle these commands itself, we must -* send the appropriate escape command. If the driver succeeds it will -* cancel the filter operation. The command is deferred until this point -* to ensure that the driver has been initialized. -\*--------------------------------------------------------------------------*/ + * void calc_diplt + * + * Calculate transformation coefficients to set window into plot space. + * + * Note: if driver has requested to handle these commands itself, we must + * send the appropriate escape command. If the driver succeeds it will + * cancel the filter operation. The command is deferred until this point + * to ensure that the driver has been initialized. + \*--------------------------------------------------------------------------*/ static void calc_diplt( void ) @@ -1753,10 +1753,10 @@ } /*--------------------------------------------------------------------------*\ -* void plgdiplt -* -* Retrieve current window into plot space -\*--------------------------------------------------------------------------*/ + * void plgdiplt + * + * Retrieve current window into plot space + \*--------------------------------------------------------------------------*/ void c_plgdiplt( PLFLT *p_xmin, PLFLT *p_ymin, PLFLT *p_xmax, PLFLT *p_ymax ) @@ -1768,15 +1768,15 @@ } /*--------------------------------------------------------------------------*\ -* void plsdidev -* -* Set window into device space using margin, aspect ratio, and -* justification. If you want to just use the previous value for any of -* these, just pass in the magic value PL_NOTSET. -* -* It is unlikely that one should ever need to change the aspect ratio -* but it's in there for completeness. -\*--------------------------------------------------------------------------*/ + * void plsdidev + * + * Set window into device space using margin, aspect ratio, and + * justification. If you want to just use the previous value for any of + * these, just pass in the magic value PL_NOTSET. + * + * It is unlikely that one should ever need to change the aspect ratio + * but it's in there for completeness. + \*--------------------------------------------------------------------------*/ void c_plsdidev( PLFLT mar, PLFLT aspect, PLFLT jx, PLFLT jy ) @@ -1798,11 +1798,11 @@ } /*--------------------------------------------------------------------------*\ -* void calc_didev -* -* Calculate transformation coefficients to set window into device space. -* Calculates relative window bounds and calls plsdidxy to finish the job. -\*--------------------------------------------------------------------------*/ + * void calc_didev + * + * Calculate transformation coefficients to set window into device space. + * Calculates relative window bounds and calls plsdidxy to finish the job. + \*--------------------------------------------------------------------------*/ static void calc_didev( void ) @@ -1885,10 +1885,10 @@ } /*--------------------------------------------------------------------------*\ -* void plgdidev -* -* Retrieve current window into device space -\*--------------------------------------------------------------------------*/ + * void plgdidev + * + * Retrieve current window into device space + \*--------------------------------------------------------------------------*/ void c_plgdidev( PLFLT *p_mar, PLFLT *p_aspect, PLFLT *p_jx, PLFLT *p_jy ) @@ -1900,10 +1900,10 @@ } /*--------------------------------------------------------------------------*\ -* void plsdiori -* -* Set plot orientation, specifying rotation in units of pi/2. -\*--------------------------------------------------------------------------*/ + * void plsdiori + * + * Set plot orientation, specifying rotation in units of pi/2. + \*--------------------------------------------------------------------------*/ void c_plsdiori( PLFLT rot ) @@ -1921,11 +1921,11 @@ } /*--------------------------------------------------------------------------*\ -* void calc_diori -* -* Calculate transformation coefficients to arbitrarily orient plot. -* Preserve aspect ratios so the output doesn't suck. -\*--------------------------------------------------------------------------*/ + * void calc_diori + * + * Calculate transformation coefficients to arbitrarily orient plot. + * Preserve aspect ratios so the output doesn't suck. + \*--------------------------------------------------------------------------*/ static void calc_diori( void ) @@ -2016,10 +2016,10 @@ } /*--------------------------------------------------------------------------*\ -* void plgdiori -* -* Get plot orientation -\*--------------------------------------------------------------------------*/ + * void plgdiori + * + * Get plot orientation + \*--------------------------------------------------------------------------*/ void c_plgdiori( PLFLT *p_rot ) @@ -2028,13 +2028,13 @@ } /*--------------------------------------------------------------------------*\ -* void plsdimap -* -* Set up transformation from metafile coordinates. The size of the plot is -* scaled so as to preserve aspect ratio. This isn't intended to be a -* general-purpose facility just yet (not sure why the user would need it, -* for one). -\*--------------------------------------------------------------------------*/ + * void plsdimap + * + * Set up transformation from metafile coordinates. The size of the plot is + * scaled so as to preserve aspect ratio. This isn't intended to be a + * general-purpose facility just yet (not sure why the user would need it, + * for one). + \*--------------------------------------------------------------------------*/ void c_plsdimap( PLINT dimxmin, PLINT dimxmax, PLINT dimymin, PLINT dimymax, @@ -2052,13 +2052,13 @@ } /*--------------------------------------------------------------------------*\ -* void calc_dimap -* -* Set up transformation from metafile coordinates. The size of the plot is -* scaled so as to preserve aspect ratio. This isn't intended to be a -* general-purpose facility just yet (not sure why the user would need it, -* for one). -\*--------------------------------------------------------------------------*/ + * void calc_dimap + * + * Set up transformation from metafile coordinates. The size of the plot is + * scaled so as to preserve aspect ratio. This isn't intended to be a + * general-purpose facility just yet (not sure why the user would need it, + * for one). + \*--------------------------------------------------------------------------*/ static void calc_dimap() @@ -2101,10 +2101,10 @@ } /*--------------------------------------------------------------------------*\ -* void plflush() -* -* Flushes the output stream. Use sparingly, if at all. -\*--------------------------------------------------------------------------*/ + * void plflush() + * + * Flushes the output stream. Use sparingly, if at all. + \*--------------------------------------------------------------------------*/ void c_plflush( void ) @@ -2124,16 +2124,16 @@ } /*--------------------------------------------------------------------------*\ -* Startup routines. -\*--------------------------------------------------------------------------*/ + * Startup routines. + \*--------------------------------------------------------------------------*/ /*--------------------------------------------------------------------------*\ -* void pllib_init() -* -* Initialize library. Called internally by every startup routine. -* Everything you want to always be initialized before plinit() is called -* you should put here. E.g. dispatch table setup, rcfile read, etc. -\*--------------------------------------------------------------------------*/ + * void pllib_init() + * + * Initialize library. Called internally by every startup routine. + * Everything you want to always be initialized before plinit() is called + * you should put here. E.g. dispatch table setup, rcfile read, etc. + \*--------------------------------------------------------------------------*/ void pllib_init() @@ -2153,10 +2153,10 @@ } /*--------------------------------------------------------------------------*\ -* void plstar(nx, ny) -* -* Initialize PLplot, passing in the windows/page settings. -\*--------------------------------------------------------------------------*/ + * void plstar(nx, ny) + * + * Initialize PLplot, passing in the windows/page settings. + \*--------------------------------------------------------------------------*/ void c_plstar( PLINT nx, PLINT ny ) @@ -2172,10 +2172,10 @@ } /*--------------------------------------------------------------------------*\ -* void plstart(devname, nx, ny) -* -* Initialize PLplot, passing the device name and windows/page settings. -\*--------------------------------------------------------------------------*/ + * void plstart(devname, nx, ny) + * + * Initialize PLplot, passing the device name and windows/page settings. + \*--------------------------------------------------------------------------*/ void c_plstart( const char *devname, PLINT nx, PLINT ny ) @@ -2192,10 +2192,10 @@ } /*--------------------------------------------------------------------------*\ -* void plinit() -* -* Initializes PLplot, using preset or default options. -\*--------------------------------------------------------------------------*/ + * void plinit() + * + * Initializes PLplot, using preset or default options. + \*--------------------------------------------------------------------------*/ void c_plinit( void ) @@ -2356,10 +2356,10 @@ } /*--------------------------------------------------------------------------*\ -* void plend() -* -* End a plotting session for all open streams. -\*--------------------------------------------------------------------------*/ + * void plend() + * + * End a plotting session for all open streams. + \*--------------------------------------------------------------------------*/ void c_plend( void ) @@ -2411,12 +2411,12 @@ } /*--------------------------------------------------------------------------*\ -* void plend1() -* -* End a plotting session for the current stream only. After the stream is -* ended the memory associated with the stream's PLStream data structure is -* freed (for stream > 0), and the stream counter is set to 0 (the default). -\*--------------------------------------------------------------------------*/ + * void plend1() + * + * End a plotting session for the current stream only. After the stream is + * ended the memory associated with the stream's PLStream data structure is + * freed (for stream > 0), and the stream counter is set to 0 (the default). + \*--------------------------------------------------------------------------*/ void c_plend1( void ) @@ -2475,11 +2475,11 @@ } /*--------------------------------------------------------------------------*\ -* void plsstrm -* -* Set stream number. If the data structure for a new stream is -* unallocated, we allocate it here. -\*--------------------------------------------------------------------------*/ + * void plsstrm + * + * Set stream number. If the data structure for a new stream is + * unallocated, we allocate it here. + \*--------------------------------------------------------------------------*/ void c_plsstrm( PLINT strm ) @@ -2507,10 +2507,10 @@ } /*--------------------------------------------------------------------------*\ -* void plgstrm -* -* Get current stream number. -\*--------------------------------------------------------------------------*/ + * void plgstrm + * + * Get current stream number. + \*--------------------------------------------------------------------------*/ void c_plgstrm( PLINT *p_strm ) @@ -2519,17 +2519,17 @@ } /*--------------------------------------------------------------------------*\ -* void plmkstrm -* -* Creates a new stream and makes it the default. Differs from using -* plsstrm(), in that a free stream number is found, and returned. -* -* Unfortunately, I /have/ to start at stream 1 and work upward, since -* stream 0 is preallocated. One of the BIG flaws in the PLplot API is -* that no initial, library-opening call is required. So stream 0 must be -* preallocated, and there is no simple way of determining whether it is -* already in use or not. -\*--------------------------------------------------------------------------*/ + * void plmkstrm + * + * Creates a new stream and makes it the default. Differs from using + * plsstrm(), in that a free stream number is found, and returned. + * + * Unfortunately, I /have/ to start at stream 1 and work upward, since + * stream 0 is preallocated. One of the BIG flaws in the PLplot API is + * that no initial, library-opening call is required. So stream 0 must be + * preallocated, and there is no simple way of determining whether it is + * already in use or not. + \*--------------------------------------------------------------------------*/ void c_plmkstrm( PLINT *p_strm ) @@ -2556,20 +2556,20 @@ } /*--------------------------------------------------------------------------*\ -* void plstrm_init -* -* Does required startup initialization of a stream. Should be called right -* after creating one (for allocating extra memory, etc). Users shouldn't -* need to call this directly. -* -* This function can be called multiple times for a given stream, in which -* case only the first call produces any effect. For streams >= 1, which -* are created dynamically, this is called by the routine that allocates -* the stream. Stream 0, which is preallocated, is much harder to deal with -* because any of a number of different calls may be the first call to the -* library. This is handled by just calling plstrm_init() from every -* function that might be called first. Sucks, but it should work. -\*--------------------------------------------------------------------------*/ + * void plstrm_init + * + * Does required startup initialization of a stream. Should be called right + * after creating one (for allocating extra memory, etc). Users shouldn't + * need to call this directly. + * + * This function can be called multiple times for a given stream, in which + * case only the first call produces any effect. For streams >= 1, which + * are created dynamically, this is called by the routine that allocates + * the stream. Stream 0, which is preallocated, is much harder to deal with + * because any of a number of different calls may be the first call to the + * library. This is handled by just calling plstrm_init() from every + * function that might be called first. Sucks, but it should work. + \*--------------------------------------------------------------------------*/ void plstrm_init( void ) @@ -2589,10 +2589,10 @@ } /*--------------------------------------------------------------------------*\ -* pl_cpcolor -* -* Utility to copy one PLColor to another. -\*--------------------------------------------------------------------------*/ + * pl_cpcolor + * + * Utility to copy one PLColor to another. + \*--------------------------------------------------------------------------*/ void pl_cpcolor( PLColor *to, PLColor *from ) @@ -2604,18 +2604,18 @@ } /*--------------------------------------------------------------------------*\ -* void plcpstrm -* -* Copies state parameters from the reference stream to the current stream. -* Tell driver interface to map device coordinates unless flags == 1. -* -* This function is used for making save files of selected plots (e.g. -* from the TK driver). After initializing, you can get a copy of the -* current plot to the specified device by switching to this stream and -* issuing a plcpstrm() and a plreplot(), with calls to plbop() and -* pleop() as appropriate. The plot buffer must have previously been -* enabled (done automatically by some display drivers, such as X). -\*--------------------------------------------------------------------------*/ + * void plcpstrm + * + * Copies state parameters from the reference stream to the current stream. + * Tell driver interface to map device coordinates unless flags == 1. + * + * This function is used for making save files of selected plots (e.g. + * from the TK driver). After initializing, you can get a copy of the + * current plot to the specified device by switching to this stream and + * issuing a plcpstrm() and a plreplot(), with calls to plbop() and + * pleop() as appropriate. The plot buffer must have previously been + * enabled (done automatically by some display drivers, such as X). + \*--------------------------------------------------------------------------*/ void c_plcpstrm( PLINT iplsr, PLINT flags ) @@ -2713,25 +2713,25 @@ } /*--------------------------------------------------------------------------*\ -* pllib_devinit() -* -* Does preliminary setup of device driver. -* -* This function (previously plGetDev) used to be what is now shown as -* plSelectDev below. However, the situation is a bit more complicated now in -* the dynloadable drivers era. We now have to: -* -* 1) Make sure the dispatch table is initialized to the union of static -* drivers and available dynamic drivers (done from pllib_init now). -* 2) Allow the user to select the desired device. -* 3) Initialize the dispatch table entries for the selected device, in the -* case that it is a dynloadable driver that has not yet been loaded. -* -* Also made non-static, in order to allow some device calls to be made prior -* to calling plinit(). E.g. plframe needs to tell the X driver to create its -* internal data structure during widget construction time (using the escape -* function), but doesn't call plinit() until the plframe is actually mapped. -\*--------------------------------------------------------------------------*/ + * pllib_devinit() + * + * Does preliminary setup of device driver. + * + * This function (previously plGetDev) used to be what is now shown as + * plSelectDev below. However, the situation is a bit more complicated now in + * the dynloadable drivers era. We now have to: + * + * 1) Make sure the dispatch table is initialized to the union of static + * drivers and available dynamic drivers (done from pllib_init now). + * 2) Allow the user to select the desired device. + * 3) Initialize the dispatch table entries for the selected device, in the + * case that it is a dynloadable driver that has not yet been loaded. + * + * Also made non-static, in order to allow some device calls to be made prior + * to calling plinit(). E.g. plframe needs to tell the X driver to create its + * internal data structure during widget construction time (using the escape + * function), but doesn't call plinit() until the plframe is actually mapped. + \*--------------------------------------------------------------------------*/ void pllib_devinit() @@ -2824,10 +2824,10 @@ /*--------------------------------------------------------------------------*\ -* void plInitDispatchTable() -* -* ... -\*--------------------------------------------------------------------------*/ + * void plInitDispatchTable() + * + * ... + \*--------------------------------------------------------------------------*/ static int plDispatchSequencer( const void *p1, const void *p2 ) { @@ -3062,15 +3062,15 @@ } /*--------------------------------------------------------------------------*\ -* void plSelectDev() -* -* If the user has not already specified the output device, or the -* one specified is either: (a) not available, (b) "?", or (c) NULL, the -* user is prompted for it. -* -* Prompting quits after 10 unsuccessful tries in case the user has -* run the program in the background with insufficient input. -\*--------------------------------------------------------------------------*/ + * void plSelectDev() + * + * If the user has not already specified the output device, or the + * one specified is either: (a) not available, (b) "?", or (c) NULL, the + * user is prompted for it. + * + * Prompting quits after 10 unsuccessful tries in case the user has + * run the program in the background with insufficient input. + \*--------------------------------------------------------------------------*/ static void plSelectDev() @@ -3160,12 +3160,12 @@ } /*--------------------------------------------------------------------------*\ -* void plLoadDriver() -* -* Make sure the selected driver is loaded. Static drivers are already -* loaded, but if the user selected a dynamically loadable driver, we may -* have to take care of that now. -\*--------------------------------------------------------------------------*/ + * void plLoadDriver() + * + * Make sure the selected driver is loaded. Static drivers are already + * loaded, but if the user selected a dynamically loadable driver, we may + * have to take care of that now. + \*--------------------------------------------------------------------------*/ static void plLoadDriver( void ) @@ -3257,10 +3257,10 @@ } /*--------------------------------------------------------------------------*\ -* void plfontld() -* -* Load specified font set. -\*--------------------------------------------------------------------------*/ + * void plfontld() + * + * Load specified font set. + \*--------------------------------------------------------------------------*/ void c_plfontld( PLINT ifont ) @@ -3275,10 +3275,10 @@ } /*--------------------------------------------------------------------------*\ -* void plreplot() -* -* Replays contents of plot buffer to current device/file. -\*--------------------------------------------------------------------------*/ + * void plreplot() + * + * Replays contents of plot buffer to current device/file. + \*--------------------------------------------------------------------------*/ void c_plreplot( void ) @@ -3299,15 +3299,15 @@ } /*--------------------------------------------------------------------------*\ -* void plgFileDevs() -* -* Returns a list of file-oriented device names and their menu strings, -* for use in a graphical interface. The caller must allocate enough -* space for (*p_menustr) and (*p_devname) to hold a pointer for each -* device -- 20 or so is plenty. E.g. char *menustr[20]. The size of -* these arrays should be passed in *p_ndev, which, on exit, holds the -* number of devices actually present. -\*--------------------------------------------------------------------------*/ + * void plgFileDevs() + * + * Returns a list of file-oriented device names and their menu strings, + * for use in a graphical interface. The caller must allocate enough + * space for (*p_menustr) and (*p_devname) to hold a pointer for each + * device -- 20 or so is plenty. E.g. char *menustr[20]. The size of + * these arrays should be passed in *p_ndev, which, on exit, holds the + * number of devices actually present. + \*--------------------------------------------------------------------------*/ void plgFileDevs( const char ***p_menustr, const char ***p_devname, int *p_ndev ) @@ -3316,10 +3316,10 @@ } /*--------------------------------------------------------------------------*\ -* void plgDevs() -* -* Like plgFileDevs(), but returns names and menu strings for all devices. -\*--------------------------------------------------------------------------*/ + * void plgDevs() + * + * Like plgFileDevs(), but returns names and menu strings for all devices. + \*--------------------------------------------------------------------------*/ void plgDevs( const char ***p_menustr, const char ***p_devname, int *p_ndev ) @@ -3353,8 +3353,8 @@ } /*--------------------------------------------------------------------------*\ -* Various external access routines. -\*--------------------------------------------------------------------------*/ + * Various external access routines. + \*--------------------------------------------------------------------------*/ /* Get output device parameters. */ @@ -3738,13 +3738,13 @@ } /*--------------------------------------------------------------------------*\ -* These set/get information for family files, and may be called prior -* to plinit to set up the necessary parameters. Arguments: -* -* fam familying flag (boolean) -* num member number -* bmax maximum member size -\*--------------------------------------------------------------------------*/ + * These set/get information for family files, and may be called prior + * to plinit to set up the necessary parameters. Arguments: + * + * fam familying flag (boolean) + * num member number + * bmax maximum member size + \*--------------------------------------------------------------------------*/ /* Get family file parameters */ @@ -3781,9 +3781,9 @@ } /*--------------------------------------------------------------------------*\ -* Interface routines for axis labling parameters. -* See pldtik.c for more info. -\*--------------------------------------------------------------------------*/ + * Interface routines for axis labling parameters. + * See pldtik.c for more info. + \*--------------------------------------------------------------------------*/ /* Get x axis labeling parameters */ @@ -3889,8 +3889,8 @@ } /*--------------------------------------------------------------------------*\ -* These should not be called by the user. -\*--------------------------------------------------------------------------*/ + * These should not be called by the user. + \*--------------------------------------------------------------------------*/ /* Get x-y domain in world coordinates for 3d plots */ @@ -4015,11 +4015,11 @@ } /*--------------------------------------------------------------------------*\ -* void c_plscompression() -* -* Set compression. -* Has to be done before plinit. -\*--------------------------------------------------------------------------*/ + * void c_plscompression() + * + * Set compression. + * Has to be done before plinit. + \*--------------------------------------------------------------------------*/ void c_plscompression( PLINT compression ) @@ -4031,10 +4031,10 @@ } /*--------------------------------------------------------------------------*\ -* void c_plgcompression() -* -* Get compression -\*--------------------------------------------------------------------------*/ + * void c_plgcompression() + * + * Get compression + \*--------------------------------------------------------------------------*/ void c_plgcompression( PLINT *compression ) @@ -4044,14 +4044,14 @@ /*--------------------------------------------------------------------------*\ -* void plP_getinitdriverlist() -* -* Check to see if a driver/stream has been initialised -* Returns a space separated list of matches streams/drivers -* If more than one stream uses the same device, then the device name -* will be returned for each stream. -* Caller must allocate enough memory for "names" to hold the answer. -\*--------------------------------------------------------------------------*/ + * void plP_getinitdriverlist() + * + * Check to see if a driver/stream has been initialised + * Returns a space separated list of matches streams/drivers + * If more than one stream uses the same device, then the device name + * will be returned for each stream. + * Caller must allocate enough memory for "names" to hold the answer. + \*--------------------------------------------------------------------------*/ void plP_getinitdriverlist( char *names ) @@ -4077,12 +4077,12 @@ /*--------------------------------------------------------------------------*\ -* PLINT plP_checkdriverinit() -* -* Checks from a list of given drivers which ones have been initialised -* and returns the number of devices matching the list, or -1 if in error. -* Effectively returns the number of streams matching the given stream. -\*--------------------------------------------------------------------------*/ + * PLINT plP_checkdriverinit() + * + * Checks from a list of given drivers which ones have been initialised + * and returns the number of devices matching the list, or -1 if in error. + * Effectively returns the number of streams matching the given stream. + \*--------------------------------------------------------------------------*/ PLINT plP_checkdriverinit( char *names ) { @@ -4116,15 +4116,15 @@ /*--------------------------------------------------------------------------*\ -* plP_image -* -* Author: Alessandro Mirone, Nov 2001 -* -* Updated by Hezekiah Carty, Mar 2008. -* - Added support for pltr callback -* - Commented out the "dev_fastimg" rendering path -* -\*--------------------------------------------------------------------------*/ + * plP_image + * + * Author: Alessandro Mirone, Nov 2001 + * + * Updated by Hezekiah Carty, Mar 2008. + * - Added support for pltr callback + * - Commented out the "dev_fastimg" rendering path + * + \*--------------------------------------------------------------------------*/ void plP_image( PLFLT *z, PLINT nx, PLINT ny, PLFLT xmin, PLFLT ymin, PLFLT dx, PLFLT dy, This was sent by the SourceForge.net collaborative development platform, the world's largest Open Source development site. |