/*
* tkoGraph.h --
*
* This file constructs the basic functionality of the
* rbc commands.
*
* Copyright (c) 2001 BLT was created by George Howlett.
* Copyright (c) 2009 RBC was created by Samuel Green, Nicholas Hudson, Stanton Sievers, Jarrod Stormo
* Copyright (c) 2018 Rene Zaumseil
* See the file "license.terms" for information on usage and redistribution of
* this file, and for a DISCLAIMER OF ALL WARRANTIES.
*/
#ifndef _TKOGRAPH_H
#define _TKOGRAPH_H
#include "tkoWidget.h"
/*
* For C++ compilers, use extern "C"
*/
#ifdef __cplusplus
extern "C" {
#endif
/*
* Used standard values
*/
#define RBC_NORMAL_BG_MONO "white"
#define RBC_NORMAL_FG_MONO "black"
#define RBC_ACTIVE_BG_MONO "black"
#define RBC_ACTIVE_FG_MONO "white"
#define RBC_SELECT_BG_MONO "black"
#define RBC_SELECT_FG_MONO "black"
#define RBC_SELECT_BORDERWIDTH "2"
#define RBC_BORDERWIDTH "2"
#define RBC_FONT "TkDefaultFont 10"
#define RBC_FONT_HUGE "TkDefaultFontArial 16"
#define RBC_FONT_LARGE "TkDefaultFontArial 12"
#define RBC_FONT_SMALL "TkDefaultFontArial 8"
#define RBC_NORMAL_BACKGROUND "gray85"
#define RBC_NORMAL_FOREGROUND "black"
#define RBC_ACTIVE_BACKGROUND "gray64"
#define RBC_ACTIVE_FOREGROUND "black"
#define RBC_SELECT_BACKGROUND "lightblue1"
#define RBC_SELECT_FOREGROUND "black"
#define RBC_INDICATOR_COLOR "maroon"
#define RBC_OP_LINEAR_SEARCH 1
#define RBC_OP_BINARY_SEARCH 0
#define RBC_STATIC_STRING_SPACE 150
#define RBC_NS_SEARCH_NONE (0)
#define RBC_NS_SEARCH_CURRENT (1<<0)
#define RBC_NS_SEARCH_GLOBAL (1<<1)
#define RBC_NS_SEARCH_BOTH (RBC_NS_SEARCH_GLOBAL | RBC_NS_SEARCH_CURRENT)
/* Recognize "min", "max", and "++end" as valid indices */
#define RBC_INDEX_SPECIAL (1<<0)
/* Also recognize a range of indices separated by a colon */
#define RBC_INDEX_COLON (1<<1)
/* Verify that the specified index or range of indices are within limits */
#define RBC_INDEX_CHECK (1<<2)
#define RBC_INDEX_ALL_FLAGS (RBC_INDEX_SPECIAL | RBC_INDEX_COLON | RBC_INDEX_CHECK)
#define RBC_SPECIAL_INDEX -2
/* The data of the vector has changed. Update the min and max limits when they are needed */
#define RBC_UPDATE_RANGE (1<<9)
#define RBC_COLOR_NONE (XColor *)0
#define RBC_COLOR_DEFAULT (XColor *)1
#define RBC_COLOR_ALLOW_DEFAULTS 1
#define RBC_STATE_NORMAL 0
#define RBC_STATE_ACTIVE (1<<0)
#define RBC_STATE_DISABLED (1<<1)
#define RBC_STATE_EMPHASIS (1<<2)
#define RBC_ROTATE_0 0
#define RBC_ROTATE_90 1
#define RBC_ROTATE_180 2
#define RBC_ROTATE_270 3
#define RBC_SEARCH_X 0
#define RBC_SEARCH_Y 1
#define RBC_SEARCH_BOTH 2
#define RBC_SHOW_NONE 0
#define RBC_SHOW_X 1
#define RBC_SHOW_Y 2
#define RBC_SHOW_BOTH 3
#define RBC_SEARCH_POINTS 0 /* Search for closest data point. */
#define RBC_SEARCH_TRACES 1 /* Search for closest point on trace.
* Interpolate the connecting line segments
* if necessary. */
#define RBC_SEARCH_AUTO 2 /* Automatically determine whether to search
* for data points or traces. Look for
* traces if the linewidth is > 0 and if
* there is more than one data point. */
#define RBC_ELEM_ACTIVE (1<<8) /* Non-zero indicates that the element
* should be drawn in its active
* foreground and background
* colors. */
#define RBC_ACTIVE_PENDING (1<<7)
#define RBC_LABEL_ACTIVE (1<<9) /* Non-zero indicates that the
* element's entry in the legend
* should be drawn in its active
* foreground and background
* colors. */
#define RBC_SCALE_SYMBOL (1<<10)
#define RBC_SWITCH_ARGV_ONLY (1<<0)
#define RBC_SWITCH_OBJV_ONLY (1<<0)
#define RBC_SWITCH_ARGV_PARTIAL (1<<1)
#define RBC_SWITCH_OBJV_PARTIAL (1<<1)
/*
* Possible flag values for RbcSwitchSpec structures. Any bits at
* or above RBC_SWITCH_USER_BIT may be used by clients for selecting
* certain entries.
*/
#define RBC_SWITCH_NULL_OK (1<<0)
#define RBC_SWITCH_DONT_SET_DEFAULT (1<<3)
#define RBC_SWITCH_SPECIFIED (1<<4)
#define RBC_SWITCH_USER_BIT (1<<8)
/*
* Bit flags definitions:
*
* All kinds of state information kept here. All these
* things happen when the window is available to draw into
* (DisplayGraph). Need the window width and height before
* we can calculate graph layout (i.e. the screen coordinates
* of the axes, elements, titles, etc). But we want to do this
* only when we have to, not every time the graph is redrawn.
*
* Same goes for maintaining a pixmap to double buffer graph
* elements. Need to mark when the pixmap needs to updated.
*
*
* MAP_ITEM Indicates that the element/marker/axis
* configuration has changed such that
* its layout of the item (i.e. its
* position in the graph window) needs
* to be recalculated.
*
* MAP_ALL Indicates that the layout of the axes and
* all elements and markers and the graph need
* to be recalculated. Otherwise, the layout
* of only those markers and elements that
* have changed will be reset.
*
* GET_AXIS_GEOMETRY Indicates that the size of the axes needs
* to be recalculated.
*
* RESET_AXES Flag to call to RbcResetAxes routine.
* This routine recalculates the scale offset
* (used for mapping coordinates) of each axis.
* If an axis limit has changed, then it sets
* flags to re-layout and redraw the entire
* graph. This needs to happend before the axis
* can compute transformations between graph and
* screen coordinates.
*
* LAYOUT_NEEDED
*
* REDRAW_BACKING_STORE If set, redraw all elements into the pixmap
* used for buffering elements.
*
* REDRAW_PENDING Non-zero means a DoWhenIdle handler has
* already been queued to redraw this window.
*
* DRAW_LEGEND Non-zero means redraw the legend. If this is
* the only DRAW_* flag, the legend display
* routine is called instead of the graph
* display routine.
*
* DRAW_MARGINS Indicates that the margins bordering
* the plotting area need to be redrawn.
* The possible reasons are:
*
* 1) an axis configuration changed
* 2) an axis limit changed
* 3) titles have changed
* 4) window was resized.
*
* GRAPH_FOCUS
*/
#define RBC_MAP_ITEM (1<<0) /* 0x0001 */
#define RBC_MAP_ALL (1<<1) /* 0x0002 */
#define RBC_GET_AXIS_GEOMETRY (1<<2) /* 0x0004 */
#define RBC_RESET_AXES (1<<3) /* 0x0008 */
#define RBC_LAYOUT_NEEDED (1<<4) /* 0x0010 */
#define RBC_REDRAW_PENDING (1<<8) /* 0x0100 */
#define RBC_DRAW_LEGEND (1<<9) /* 0x0200 */
#define RBC_DRAW_MARGINS (1<<10) /* 0x0400 */
#define RBC_REDRAW_BACKING_STORE (1<<11) /* 0x0800 */
#define RBC_GRAPH_FOCUS (1<<12) /* 0x1000 */
#define RBC_DATA_CHANGED (1<<13) /* 0x2000 */
#define RBC_GRAPH_DELETED (1<<15) /* 0x8000 */
#define RBC_MAP_WORLD (RBC_MAP_ALL|RBC_RESET_AXES|RBC_GET_AXIS_GEOMETRY)
#define RBC_REDRAW_WORLD (RBC_DRAW_MARGINS | RBC_DRAW_LEGEND)
#define RBC_RESET_WORLD (RBC_REDRAW_WORLD | RBC_MAP_WORLD)
/* Legend */
#define RBC_LEGEND_RIGHT (1<<0) /* Right margin */
#define RBC_LEGEND_LEFT (1<<1) /* Left margin */
#define RBC_LEGEND_BOTTOM (1<<2) /* Bottom margin */
#define RBC_LEGEND_TOP (1<<3) /* Top margin, below the graph title. */
#define RBC_LEGEND_PLOT (1<<4) /* Plot area */
#define RBC_LEGEND_XY (1<<5) /* Screen coordinates in the plotting
* area. */
#define RBC_LEGEND_WINDOW (1<<6) /* External window. */
#define RBC_LEGEND_IN_MARGIN \
(RBC_LEGEND_RIGHT | RBC_LEGEND_LEFT | RBC_LEGEND_BOTTOM | RBC_LEGEND_TOP)
#define RBC_LEGEND_IN_PLOT (RBC_LEGEND_PLOT | RBC_LEGEND_XY)
#define RBC_MARKER_UNDER 1 /* Draw markers designated to lie underneath
* elements, grids, legend, etc. */
#define RBC_MARKER_ABOVE 0 /* Draw markers designated to rest above
* elements, grids, legend, etc. */
/*
* Mask values used to selectively enable GRAPH or BARCHART entries in
* the various configuration specs.
*/
#define RBC_GRAPH (TK_CONFIG_USER_BIT << 1)
#define RBC_STRIPCHART (TK_CONFIG_USER_BIT << 2)
#define RBC_BARCHART (TK_CONFIG_USER_BIT << 3)
#define RBC_LINE_GRAPHS (RBC_GRAPH | RBC_STRIPCHART)
#define RBC_ALL_GRAPHS (RBC_GRAPH | RBC_BARCHART | RBC_STRIPCHART)
#define RBC_PEN_DELETE_PENDING (1<<0)
#define RBC_ACTIVE_PEN (TK_CONFIG_USER_BIT << 6)
#define RBC_NORMAL_PEN (TK_CONFIG_USER_BIT << 7)
#define RBC_ALL_PENS (RBC_NORMAL_PEN | RBC_ACTIVE_PEN)
#define RBC_MARGIN_NONE -1
#define RBC_MARGIN_BOTTOM 0
#define RBC_MARGIN_LEFT 1
#define RBC_MARGIN_TOP 2
#define RBC_MARGIN_RIGHT 3
/* forward references, defined later */
typedef struct RbcGraph RbcGraph;
typedef struct RbcElement RbcElement;
typedef struct RbcLegend RbcLegend;
typedef struct RbcBindTable RbcBindTable;
typedef struct RbcChainLink RbcChainLink;
typedef struct RbcTileClient *RbcTile; /* Opaque type for tiles */
typedef struct RbcPsToken RbcPsToken;
typedef struct RbcPen RbcPen;
typedef struct RbcMarker RbcMarker;
typedef struct RbcCrosshairs RbcCrosshairs;
typedef struct RbcParseValue RbcParseValue;
/*
* RbcPad --
*
* Specifies vertical and horizontal padding.
*
* Padding can be specified on a per side basis. The fields
* side1 and side2 refer to the opposite sides, either
* horizontally or vertically.
*
* side1 side2
* ----- -----
* x | left right
* y | top bottom
*/
typedef struct {
short int side1;
short int side2;
} RbcPad;
/*
* RbcTextFragment --
*/
typedef struct {
char *text; /* Text to be displayed */
short int x, y; /* X-Y offset of the baseline from the
* upper-left corner of the bbox. */
short int sx, sy; /* See rbcWinUtil.c */
short int count; /* Number of bytes in text. The actual
* character count may differ because of
* multi-byte UTF encodings. */
short int width; /* Width of segment in pixels. This
* information is used to draw
* PostScript strings the same width
* as X. */
} RbcTextFragment;
/*
* RbcTextLayout --
*/
typedef struct {
int nFrags; /* # fragments of text */
short int width, height; /* Dimensions of text bounding box */
RbcTextFragment fragArr[1]; /* Information about each fragment of text */
} RbcTextLayout;
/*
* RbcShadow --
*/
typedef struct {
XColor *color;
int offset;
} RbcShadow;
/*
* RbcTextStyle --
*
* Represents a convenient structure to hold text attributes
* which determine how a text string is to be displayed on the
* window, or drawn with PostScript commands. The alternative
* is to pass lots of parameters to the drawing and printing
* routines. This seems like a more efficient and less cumbersome
* way of passing parameters.
*/
typedef struct {
unsigned int state; /* If non-zero, indicates to draw text
* in the active color */
short int width, height; /* Extents of text */
XColor *color; /* Normal color */
XColor *activeColor; /* Active color */
Tk_Font font; /* Font to use to draw text */
Tk_3DBorder border; /* Background color of text. This is also
* used for drawing disabled text. */
RbcShadow shadow; /* Drop shadow color and offset */
Tk_Justify justify; /* Justification of the text string. This
* only matters if the text is composed
* of multiple lines. */
GC gc; /* GC used to draw the text */
double theta; /* Rotation of text in degrees. */
Tk_Anchor anchor; /* Indicates how the text is anchored around
* its x and y coordinates. */
RbcPad padX, padY; /* # pixels padding of around text region */
short int leader; /* # pixels spacing between lines of text */
} RbcTextStyle;
/*
*
*/
typedef ClientData(
RbcBindPickProc) (
ClientData clientData,
int x,
int y,
ClientData * contextPtr);
/*
* RbcBindTable --
*
* Binding structure information:
*/
typedef struct RbcBindTable {
unsigned int flags;
Tk_BindingTable bindingTable; /* Table of all bindings currently defined.
* NULL means that no bindings exist, so the
* table hasn't been created. Each "object"
* used for this table is either a Tk_Uid for
* a tag or the address of an item named by
* id. */
ClientData currentItem; /* The item currently containing the mouse
* pointer, or NULL if none. */
ClientData currentContext; /* One word indicating what kind of object
* was picked. */
ClientData newItem; /* The item that is about to become the
* current one, or NULL. This field is
* used to detect deletions of the new
* current item pointer that occur during
* Leave processing of the previous current
* tab. */
ClientData newContext; /* One-word indicating what kind of object
* was just picked. */
ClientData focusItem;
ClientData focusContext;
XEvent pickEvent; /* The event upon which the current choice
* of the current tab is based. Must be saved
* so that if the current item is deleted,
* we can pick another. */
int activePick; /* The pick event has been initialized so
* that we can repick it */
int state; /* Last known modifier state. Used to
* defer picking a new current object
* while buttons are down. */
ClientData clientData;
Tk_Window tkwin;
RbcBindPickProc *pickProc; /* Routine to report the item the mouse is
* currently over. */
} RbcBindTable;
/*
* RbcChainLink --
*
* A RbcChainLink is the container structure for the RbcChain.
*/
typedef struct RbcChainLink {
RbcChainLink *prevPtr; /* Link to the previous link */
RbcChainLink *nextPtr; /* Link to the next link */
ClientData clientData; /* Pointer to the data object */
} RbcChainLink;
typedef int (
RbcChainCompareProc) (
RbcChainLink ** l1PtrPtr,
RbcChainLink ** l2PtrPtr);
/*
* RbcChain --
*
* A RbcChain is a doubly chained list structure.
*/
typedef struct {
RbcChainLink *headPtr; /* Pointer to first element in chain */
RbcChainLink *tailPtr; /* Pointer to last element in chain */
int nLinks; /* Number of elements in chain */
} RbcChain;
/*
* Rbc_Vector --
*/
typedef struct {
double *valueArr; /* Array of values (possibly malloc-ed) */
int numValues; /* Number of values in the array */
int arraySize; /* Size of the allocated space */
double min, max; /* Minimum and maximum values in the vector */
} Rbc_Vector;
/*
* RbcVectorInterpData --
*/
typedef struct {
Tcl_HashTable vectorTable; /* Table of vectors */
Tcl_HashTable mathProcTable; /* Table of vector math functions */
Tcl_HashTable indexProcTable;
Tcl_Interp *interp;
unsigned int nextId;
} RbcVectorInterpData;
/*
* RbcVectorObject --
*
* A vector is an array of double precision values. It can be
* accessed through a Tcl command, a Tcl array variable, or C
* API. The storage for the array points initially to a
* statically allocated buffer, but to malloc-ed memory if more
* is necessary.
*
* Vectors can be shared by several clients (for example, two
* different graph widgets). The data is shared. When a client
* wants to use a vector, it allocates a vector identifier, which
* identifies the client. Clients use this ID to specify a
* callback routine to be invoked whenever the vector is modified
* or destroyed. Whenever the vector is updated or destroyed,
* each client is notified of the change by their callback
* routine.
*/
typedef struct {
/*
* If you change these fields, make sure you change the definition
* of RbcVector in rbcVector.h too.
*/
double *valueArr; /* Array of values (malloc-ed) */
int length; /* Current number of values in the array. */
int size; /* Maximum number of values that can be stored
* in the value array. */
double min, max; /* Minimum and maximum values in the vector */
/* The following fields are local to this module */
char *name; /* The namespace-qualified name of the vector command.
* It points to the hash key allocated for the
* entry in the vector hash table. */
RbcVectorInterpData *dataPtr;
Tcl_Interp *interp; /* Interpreter associated with the vector */
Tcl_HashEntry *hashPtr; /* If non-NULL, pointer in a hash table to
* track the vectors in use. */
Tcl_FreeProc *freeProc; /* Address of procedure to call to
* release storage for the value
* array, Optionally can be one of the
* following: TCL_STATIC, TCL_DYNAMIC,
* or TCL_VOLATILE. */
char *arrayName; /* The namespace-qualified name of the
* Tcl array variable
* mapped to the vector
* (malloc'ed). If NULL, indicates
* that the vector isn't mapped to any variable */
int offset; /* Offset from zero of the vector's
* starting index */
Tcl_Command cmdToken; /* Token for vector's Tcl command. */
RbcChain *chainPtr; /* List of clients using this vector */
int notifyFlags; /* Notification flags. See definitions
* below */
int varFlags; /* Indicate if the variable is global,
* namespace, or local */
int freeOnUnset; /* For backward compatibility only: If
* non-zero, free the vector when its
* variable is unset. */
int flush;
int first, last; /* Selected region of vector. This is used
* mostly for the math routines */
} RbcVectorObject;
typedef struct RbcVectorIdStruct *RbcVectorId;
/*
* RbcVectorNotify --
*/
typedef enum {
RBC_VECTOR_NOTIFY_UPDATE = 1, /* The vector's values has been updated */
RBC_VECTOR_NOTIFY_DESTROY /* The vector has been destroyed and the client
* should no longer use its data (calling
* Rbc_FreeVectorId) */
} RbcVectorNotify;
typedef void (
RbcVectorChangedProc) (
Tcl_Interp * interp,
ClientData clientData,
RbcVectorNotify notify);
typedef double (
Rbc_VectorIndexProc) (
Rbc_Vector * vecPtr);
/*
* RbcParseValue --
*
* The following data structure is used by various parsing
* procedures to hold information about where to store the
* results of parsing (e.g. the substituted contents of a quoted
* argument, or the result of a nested command). At any given
* time, the space available for output is fixed, but a procedure
* may be called to expand the space available if the current
* space runs out.
*/
typedef struct RbcParseValue {
char *buffer; /* Address of first character in
* output buffer. */
char *next; /* Place to store next character in
* output buffer. */
char *end; /* Address of the last usable character
* in the buffer. */
void (
*expandProc) (
RbcParseValue * pvPtr,
int needed);
/* Procedure to call when space runs out;
* it will make more space. */
ClientData clientData; /* Arbitrary information for use of
* expandProc. */
} RbcParseValue;
/*
* RbcParseVector --
*/
typedef struct {
RbcVectorObject *vPtr;
char staticSpace[RBC_STATIC_STRING_SPACE];
RbcParseValue pv; /* Used to hold a string value, if any. */
} RbcParseVector;
/*
* RbcOp --
*
* Generic function prototype of CmdOptions.
*/
typedef int (
*RbcOp) (
);
/*
* RbcOpSpec --
*
* Structure to specify a set of operations for a Tcl command.
* This is passed to the RbcGetOp procedure to look
* for a function pointer associated with the operation name.
*/
typedef struct {
const char *name; /* Name of operation */
int minChars; /* Minimum # characters to disambiguate */
RbcOp proc;
int minArgs; /* Minimum # args required */
int maxArgs; /* Maximum # args required */
const char *usage; /* Usage message */
} RbcOpSpec;
/*
* RbcOpIndex --
*/
typedef enum {
RBC_OP_ARG0, /* Op is the first argument. */
RBC_OP_ARG1, /* Op is the second argument. */
RBC_OP_ARG2, /* Op is the third argument. */
RBC_OP_ARG3, /* Op is the fourth argument. */
RBC_OP_ARG4 /* Op is the fifth argument. */
} RbcOpIndex;
typedef int (
QSortCompareProc) (
const void *,
const void *);
/*
* RbcDashes --
*
* List of dash values (maximum 11 based upon PostScript limit).
*/
typedef struct {
char values[12];
int offset;
} RbcDashes;
#define RbcLineIsDashed(d) ((d).values[0] != 0)
/*
* RbcPoint2D --
*
* 2-D coordinate.
*/
typedef struct {
double x;
double y;
} RbcPoint2D;
/*
* RbcPoint3D --
*
* 3-D coordinate.
*/
typedef struct {
double x;
double y;
double z;
} RbcPoint3D;
/*
* RbcSegment2D --
*
* 2-D line segment.
*/
typedef struct {
RbcPoint2D p; /* First end point of the segment. */
RbcPoint2D q; /* Last end point of the segment. */
} RbcSegment2D;
/*
* RbcDim2D --
*
* 2-D dimension.
*/
typedef struct {
short int width;
short int height;
} RbcDim2D;
/*
* RbcRegion2D --
*
* 2-D region. Used to copy parts of images.
*/
typedef struct {
int left;
int right;
int top;
int bottom;
} RbcRegion2D;
/*
* RbcExtents2D --
*/
typedef struct {
double left;
double right;
double top;
double bottom;
} RbcExtents2D;
/*
* RbcExtents3D --
*/
typedef struct {
double left;
double right;
double top;
double bottom;
double front;
double back;
} RbcExtents3D;
/* int RbcPointInRegion(RbcRegion2D e, int x, int y) */
#define RbcPointInRegion(e,x,y) \
(((x) <= (e)->right) && ((x) >= (e)->left) && \
((y) <= (e)->bottom) && ((y) >= (e)->top))
/*
* RbcColorPair --
*
* Holds a pair of foreground, background colors.
*/
typedef struct {
XColor *fgColor, *bgColor;
} RbcColorPair;
typedef void (
RbcTileChangedProc) (
ClientData clientData,
RbcTile tile);
/*
* RbcPix32 --
*
* A union representing either a pixel as a RGB triplet or a
* single word value.
*/
typedef union {
unsigned int value; /* Lookup table address */
struct RGBA {
unsigned char red; /* Red intensity 0..255 */
unsigned char green; /* Green intensity 0.255 */
unsigned char blue; /* Blue intensity 0..255 */
unsigned char alpha; /* Alpha-channel for compositing. 0..255 */
} rgba;
unsigned char channel[4];
} RbcPix32;
/*
* RbcColorImage --
*
* The structure below represents a color image. Each pixel
* occupies a 32-bit word of memory: one byte for each of the
* red, green, and blue color intensities, and another for
* alpha-channel image compositing (e.g. transparency).
*/
typedef struct RbcColorImage {
int width; /* Dimensions of the image */
int height; /* Dimensions of the image */
RbcPix32 *bits; /* Array of pixels representing the image. */
} RbcColorImage;
/*
* ResampleFilterProc --
*
* A function implementing a 1-D filter.
*/
typedef double (
ResampleFilterProc) (
double value);
/*
* RbcFilter2D --
*
* Defines a convolution mask for a 2-D filter. Used to smooth or
* enhance images.
*/
typedef struct {
double support; /* Radius of filter */
double sum, scale; /* Sum of kernel */
double *kernel; /* Array of values (malloc-ed) representing
* the discrete 2-D filter. */
} RbcFilter2D;
/*
* RbcPsColorMode --
*/
typedef enum {
PS_MODE_MONOCHROME, /* Only black and white. */
PS_MODE_GREYSCALE, /* Color converted to greyscale. */
PS_MODE_COLOR /* Full color */
} RbcPsColorMode;
/*
* RbcPsToken --
*/
typedef struct RbcPsToken {
Tcl_Interp *interp; /* Interpreter to report errors to. */
Tk_Window tkwin; /* Tk_Window used to get font and color
* information */
Tcl_DString dString; /* Dynamic string used to contain the
* PostScript generated. */
char *fontVarName; /* Name of a Tcl array variable to convert
* X font names to PostScript fonts. */
char *colorVarName; /* Name of a Tcl array variable to convert
* X color names to PostScript. */
RbcPsColorMode colorMode; /* Mode: color or greyscale */
/*
* Utility space for building strings. Currently used to create
* PostScript output for the "postscript" command.
*/
char scratchArr[BUFSIZ * 2];
} RbcPsToken;
/*
* RbxAxisRange --
*
* Designates a range of values by a minimum and maximum limit.
*/
typedef struct {
double min;
double max;
double range;
double scale;
} RbcAxisRange;
/*
* RbcTicks --
*
* Structure containing information where the ticks (major or
* minor) will be displayed on the graph.
*/
typedef struct {
int nTicks; /* # of ticks on axis */
double values[1]; /* Array of tick values (malloc-ed). */
} RbcTicks;
/*
* RbcTickSweep --
*
* Structure containing information where the ticks (major or
* minor) will be displayed on the graph.
*/
typedef struct {
double initial; /* Initial value */
double step; /* Size of interval */
int nSteps; /* Number of intervals. */
} RbcTickSweep;
/*
* RbcAxis --
*
* Structure contains options controlling how the axis will be
* displayed.
*/
typedef struct {
char *name; /* Identifier to refer the element.
* Used in the "insert", "delete", or
* "show", commands. */
Tk_Uid classUid; /* Type of axis. */
RbcGraph *graphPtr; /* Graph widget of element */
unsigned int flags; /* Set bit field definitions below */
/*
* AXIS_DRAWN Axis is designated as a logical axis
* AXIS_DIRTY
*
* AXIS_CONFIG_MAJOR User specified major ticks.
* AXIS_CONFIG_MINOR User specified minor ticks.
*/
char **tags;
const char *detail;
int deletePending; /* Indicates that the axis was
* scheduled for deletion. The actual
* deletion may be deferred until the
* axis is no longer in use. */
int refCount; /* Number of elements referencing this
* axis. */
Tcl_HashEntry *hashPtr; /* Points to axis entry in hash
* table. Used to quickly remove axis
* entries. */
int logScale; /* If non-zero, scale the axis values
* logarithmically. */
int hidden; /* If non-zero, don't display the
* axis title, ticks, or line. */
int showTicks; /* If non-zero, display tick marks and
* labels. */
int descending; /* If non-zero, display the range of
* values on the axis in descending
* order, from high to low. */
int looseMin, looseMax; /* If non-zero, axis range extends to
* the outer major ticks, otherwise at
* the limits of the data values. This
* is overriddened by setting the -min
* and -max options. */
char *title; /* Title of the axis. */
RbcTextStyle titleTextStyle; /* Text attributes (color, font,
* rotation, etc.) of the axis
* title. */
int titleAlternate; /* Indicates whether to position the
* title above/left of the axis. */
RbcPoint2D titlePos; /* Position of the title */
unsigned short int titleWidth, titleHeight;
int lineWidth; /* Width of lines representing axis
* (including ticks). If zero, then
* no axis lines or ticks are
* drawn. */
const char **limitsFormats; /* One or two strings of sprintf-like
* formats describing how to display
* virtual axis limits. If NULL,
* display no limits. */
int nFormats;
RbcTextStyle limitsTextStyle; /* Text attributes (color, font,
* rotation, etc.) of the limits. */
double windowSize; /* Size of a sliding window of values
* used to scale the axis automatically
* as new data values are added. The axis
* will always display the latest values
* in this range. */
double shiftBy; /* Shift maximum by this interval. */
int tickLength; /* Length of major ticks in pixels */
RbcTextStyle tickTextStyle; /* Text attributes (color, font, rotation,
* etc.) for labels at each major tick. */
char *formatCmd; /* Specifies a Tcl command, to be invoked
* by the axis whenever it has to generate
* tick labels. */
char *scrollCmdPrefix;
int scrollUnits;
double min, max; /* The actual axis range. */
double reqMin, reqMax; /* Requested axis bounds. Consult the
* axisPtr->flags field for
* AXIS_CONFIG_MIN and AXIS_CONFIG_MAX
* to see if the requested bound have
* been set. They override the
* computed range of the axis
* (determined by auto-scaling). */
double scrollMin, scrollMax; /* Defines the scrolling reqion of the axis.
* Normally the region is determined from
* the data limits. If specified, these
* values override the data-range. */
RbcAxisRange valueRange; /* Range of data values of elements mapped
* to this axis. This is used to auto-scale
* the axis in "tight" mode. */
RbcAxisRange axisRange; /* Smallest and largest major tick values
* for the axis. The tick values lie outside
* the range of data values. This is used to
* auto-scale the axis in "loose" mode. */
double prevMin, prevMax;
double reqStep; /* If > 0.0, overrides the computed major
* tick interval. Otherwise a stepsize
* is automatically calculated, based
* upon the range of elements mapped to the
* axis. The default value is 0.0. */
double tickZoom; /* If > 0.0, overrides the computed major
* tick interval. Otherwise a stepsize
* is automatically calculated, based
* upon the range of elements mapped to the
* axis. The default value is 0.0. */
GC tickGC; /* Graphics context for axis and tick labels */
RbcTicks *t1Ptr; /* Array of major tick positions. May be
* set by the user or generated from the
* major sweep below. */
RbcTicks *t2Ptr; /* Array of minor tick positions. May be
* set by the user or generated from the
* minor sweep below. */
RbcTickSweep minorSweep, majorSweep;
int reqNumMinorTicks; /* If non-zero, represents the
* requested the number of minor ticks
* to be uniformally displayed along
* each major tick. */
int labelOffset; /* If non-zero, indicates that the tick
* label should be offset to sit in the
* middle of the next interval. */
/* The following fields are specific to logical axes */
RbcChainLink *linkPtr; /* Axis link in margin list. */
RbcChain *chainPtr;
short int width, height; /* Extents of axis */
RbcSegment2D *segments; /* Array of line segments representing
* the major and minor ticks, but also
* the axis line itself. The segment
* coordinates are relative to the
* axis. */
int nSegments; /* Number of segments in the above array. */
RbcChain *tickLabels; /* Contains major tick label strings
* and their offsets along the axis. */
RbcRegion2D region;
Tk_3DBorder border;
int borderWidth;
int relief;
} RbcAxis;
/*
* RbcAxis2D --
*
* The pair of axes mapping a point onto the graph.
*/
typedef struct {
RbcAxis *x;
RbcAxis *y;
} RbcAxis2D;
/*
* RbcElemWeight --
*
* Designates a range of values by a minimum and maximum limit.
*/
typedef struct {
double min;
double max;
double range;
} RbcElemWeight;
/*
* RbcPenStyle --
*
* An element has one or more vectors plus several attributes, such as
* line style, thickness, color, and symbol type. It has an
* identifier which distinguishes it among the list of all elements.
*/
typedef struct {
RbcElemWeight weight; /* Weight range where this pen is valid. */
RbcPen *penPtr; /* Pen to use. */
RbcSegment2D *xErrorBars; /* Point to start of this pen's X-error bar
* segments in the element's array. */
RbcSegment2D *yErrorBars; /* Point to start of this pen's Y-error bar
* segments in the element's array. */
int xErrorBarCnt; /* # of error bars for this pen. */
int yErrorBarCnt; /* # of error bars for this pen. */
int errorBarCapWidth; /* Length of the cap ends on each
* error bar. */
int symbolSize; /* Size of the pen's symbol scaled to
* the current graph size. */
} RbcPenStyle;
typedef struct {
int halo; /* Maximal distance a candidate point
* can be from the sample window
* coordinate */
int mode; /* Indicates whether to find the closest
* data point or the closest point on the
* trace by interpolating the line segments.
* Can also be SEARCH_AUTO, indicating to
* choose how to search.*/
int x, y; /* Screen coordinates of test point */
int along; /* Indicates to let search run along a
* particular axis: x, y, or both. */
/* Output */
RbcElement *elemPtr; /* Name of the closest element */
RbcPoint2D point; /* Graph coordinates of closest point */
int index; /* Index of closest data point */
double dist; /* Distance in screen coordinates */
} RbcClosestSearch;
typedef void (
RbcElementDrawProc) (
RbcGraph * graphPtr,
Drawable drawable,
RbcElement * elemPtr);
typedef void (
RbcElementToPostScriptProc) (
RbcGraph * graphPtr,
RbcPsToken * psToken,
RbcElement * elemPtr);
typedef void (
RbcElementDestroyProc) (
RbcGraph * graphPtr,
RbcElement * elemPtr);
typedef int (
RbcElementConfigProc) (
RbcGraph * graphPtr,
RbcElement * elemPtr);
typedef void (
RbcElementMapProc) (
RbcGraph * graphPtr,
RbcElement * elemPtr);
typedef void (
RbcElementExtentsProc) (
RbcElement * elemPtr,
RbcExtents2D * extsPtr);
typedef void (
RbcElementClosestProc) (
RbcGraph * graphPtr,
RbcElement * elemPtr,
RbcClosestSearch * searchPtr);
typedef void (
RbcElementDrawSymbolProc) (
RbcGraph * graphPtr,
Drawable drawable,
RbcElement * elemPtr,
int x,
int y,
int symbolSize);
typedef void (
RbcElementSymbolToPostScriptProc) (
RbcGraph * graphPtr,
RbcPsToken * psToken,
RbcElement * elemPtr,
double x,
double y,
int symSize);
/*
* RbcElementProcs --
*/
typedef struct {
RbcElementClosestProc *closestProc;
RbcElementConfigProc *configProc;
RbcElementDestroyProc *destroyProc;
RbcElementDrawProc *drawActiveProc;
RbcElementDrawProc *drawNormalProc;
RbcElementDrawSymbolProc *drawSymbolProc;
RbcElementExtentsProc *extentsProc;
RbcElementToPostScriptProc *printActiveProc;
RbcElementToPostScriptProc *printNormalProc;
RbcElementSymbolToPostScriptProc *printSymbolProc;
RbcElementMapProc *mapProc;
} RbcElementProcs;
/*
* RbcElemVector --
*
* The data structure below contains information pertaining to a line
* vector. It consists of an array of floating point data values and
* for convenience, the number and minimum/maximum values.
*/
typedef struct {
Rbc_Vector *vecPtr;
double *valueArr;
int nValues;
int arraySize;
double min, max;
RbcVectorId clientId; /* If non-NULL, a client token identifying the
* external vector. */
RbcElement *elemPtr; /* Element associated with vector. */
} RbcElemVector;
/*
* RbcElement --
*/
typedef struct RbcElement {
char *name; /* Identifier to refer the element.
* Used in the "insert", "delete", or
* "show", commands. */
Tk_Uid classUid; /* Type of element */
RbcGraph *graphPtr; /* Graph widget of element */
unsigned int flags; /* Indicates if the entire element is
* active, or if coordinates need to
* be calculated */
char **tags;
int hidden; /* If non-zero, don't display the element. */
Tcl_HashEntry *hashPtr;
char *label; /* Label displayed in legend */
int labelRelief; /* Relief of label in legend. */
RbcAxis2D axes; /* X-axis and Y-axis mapping the element */
RbcElemVector x, y, w; /* Contains array of floating point
* graph coordinate values. Also holds
* min/max and the number of
* coordinates */
RbcElemVector xError; /* Relative/symmetric X error values. */
RbcElemVector yError; /* Relative/symmetric Y error values. */
RbcElemVector xHigh, xLow; /* Absolute/asymmetric X-coordinate high/low
* error values. */
RbcElemVector yHigh, yLow; /* Absolute/asymmetric Y-coordinate high/low
* error values. */
int *activeIndices; /* Array of indices (malloc-ed) which
* indicate which data points are
* active (drawn with "active"
* colors). */
int nActiveIndices; /* Number of active data points.
* Special case: if nActiveIndices < 0
* and the active bit is set in
* "flags", then all data points are
* drawn active. */
RbcElementProcs *procsPtr;
Tk_ConfigSpec *specsPtr; /* Configuration specifications. */
RbcSegment2D *xErrorBars; /* Point to start of this pen's X-error bar
* segments in the element's array. */
RbcSegment2D *yErrorBars; /* Point to start of this pen's Y-error bar
* segments in the element's array. */
int xErrorBarCnt; /* # of error bars for this pen. */
int yErrorBarCnt; /* # of error bars for this pen. */
int *xErrorToData; /* Maps error bar segments back to the data
* point. */
int *yErrorToData; /* Maps error bar segments back to the data
* point. */
int errorBarCapWidth; /* Length of cap on error bars */
RbcPen *activePenPtr; /* Standard Pens */
RbcPen *normalPenPtr;
RbcChain *palette; /* Palette of pens. */
/* Symbol scaling */
int scaleSymbols; /* If non-zero, the symbols will scale
* in size as the graph is zoomed
* in/out. */
double xRange, yRange; /* Initial X-axis and Y-axis ranges:
* used to scale the size of element's
* symbol. */
int state;
} RbcElement;
/*
* RbcFreqInfo --
*/
typedef struct {
int freq; /* Number of occurrences of x-coordinate */
RbcAxis2D axes; /* Indicates which x and y axis are mapped to
* the x-value */
double sum; /* Sum of the ordinates of each duplicate
* abscissa */
int count;
double lastY;
} RbcFreqInfo;
/*
* RbcBarMode --
*
* Bar elements are displayed according to their x-y coordinates.
* If two bars have the same abscissa (x-coordinate), the bar
* segments will be drawn according to one of the following
* modes:
*/
typedef enum {
MODE_INFRONT, /* Each successive segment is drawn in
* front of the previous. */
MODE_STACKED, /* Each successive segment is drawn
* stacked above the previous. */
MODE_ALIGNED, /* Each successive segment is drawn
* aligned to the previous from
* right-to-left. */
MODE_OVERLAP /* Like "aligned", each successive segment
* is drawn from right-to-left. In addition
* the segments will overlap each other
* by a small amount */
} RbcBarMode;
typedef RbcPen *(
PenCreateProc) (
void);
typedef int (
PenConfigureProc) (
RbcGraph * graphPtr,
RbcPen * penPtr);
typedef void (
PenDestroyProc) (
RbcGraph * graphPtr,
RbcPen * penPtr);
/*
* RbcPen --
*/
typedef struct RbcPen {
char *name; /* Pen style identifier. If NULL pen
* was statically allocated. */
Tk_Uid classUid; /* Type of pen */
char *typeId; /* String token identifying the type of pen */
unsigned int flags; /* Indicates if the pen element is active or
* normal */
int refCount; /* Reference count for elements using
* this pen. */
Tcl_HashEntry *hashPtr;
Tk_ConfigSpec *configSpecs; /* Configuration specifications */
PenConfigureProc *configProc;
PenDestroyProc *destroyProc;
} RbcPen;
/*
* RbcPostScript --
*
* Structure contains information specific to the outputting of
* PostScript commands to print the graph.
*
*/
typedef struct {
/* User configurable fields */
int decorations; /* If non-zero, print graph with
* color background and 3D borders */
int reqWidth, reqHeight; /* If greater than zero, represents the
* requested dimensions of the printed graph */
int reqPaperWidth;
int reqPaperHeight; /* Requested dimensions for the PostScript
* page. Can constrain the size of the graph
* if the graph (plus padding) is larger than
* the size of the page. */
RbcPad padX, padY; /* Requested padding on the exterior of the
* graph. This forms the bounding box for
* the page. */
RbcPsColorMode colorMode; /* Selects the color mode for PostScript page
* (0=monochrome, 1=greyscale, 2=color) */
char *colorVarName; /* If non-NULL, is the name of a Tcl array
* variable containing X to PostScript color
* translations */
char *fontVarName; /* If non-NULL, is the name of a Tcl array
* variable containing X to PostScript font
* translations */
int landscape; /* If non-zero, orient the page 90 degrees */
int center; /* If non-zero, center the graph on the page */
int maxpect; /* If non-zero, indicates to scale the graph
* so that it fills the page (maintaining the
* aspect ratio of the graph) */
int addPreview; /* If non-zero, generate a preview image and
* add it to the PostScript output */
int footer; /* If non-zero, a footer with the title, date
* and user will be added to the PostScript
* output outside of the bounding box. */
int previewFormat; /* Format of EPS preview:
* PS_PREVIEW_WMF, PS_PREVIEW_EPSI, or
* PS_PREVIEW_TIFF. */
/* Computed fields */
int left, bottom; /* Bounding box of PostScript plot. */
int right, top;
double pageScale; /* Scale of page. Set if "-maxpect" option
* is set, otherwise 1.0. */
} RbcPostScript;
/*
* RbcGrid --
*
* Contains attributes of describing how to draw grids (at major
* ticks) in the graph. Grids may be mapped to either/both x and
* y axis.
*/
typedef struct {
GC gc; /* Graphics context for the grid. */
RbcAxis2D axes;
int hidden; /* If non-zero, grid isn't displayed. */
int minorGrid; /* If non-zero, draw grid line for minor
* axis ticks too */
RbcDashes dashes; /* Dashstyle of the grid. This represents
* an array of alternatingly drawn pixel
* values. */
int lineWidth; /* Width of the grid lines */
XColor *colorPtr; /* Color of the grid lines */
struct GridSegments {
RbcSegment2D *segments; /* Array of line segments representing the
* x or y grid lines */
int nSegments; /* # of axis segments. */
} x,
y;
} RbcGrid;
/*
* RbcMargin --
*/
typedef struct {
short int width, height; /* Extents of the margin */
short int axesOffset;
short int axesTitleLength; /* Width of the widest title to be shown.
* Multiple titles are displayed in
* another margin. This is the minimum
* space requirement. */
unsigned int nAxes; /* Number of axes to be displayed */
RbcChain *axes; /* Extra axes associated with this margin */
char *varName; /* If non-NULL, name of variable to be
* updated when the margin size changes */
int reqSize; /* Requested size of margin */
int site; /* Indicates where margin is located:
* left/right/top/bottom. */
} RbcMargin;
/*
* RbcGraph --
*
* Top level structure containing everything pertaining to
* the graph.
*/
typedef struct RbcGraph {
Tk_Window *win;
Tcl_Object object;
Tcl_Interp *interp; /* Interpreter associated with graph */
Display *display; /* Display containing widget; needed,
* among other things, to release
* resources after tkwin has already gone
* away. */
unsigned int flags; /* Flags; see below for definitions. */
Tk_Cursor cursor;
int inset; /* Sum of focus highlight and 3-D
* border. Indicates how far to
* offset the graph from outside
* edge of the window. */
int borderWidth; /* Width of the exterior border */
int relief; /* Relief of the exterior border */
Tk_3DBorder border; /* 3-D border used to delineate the plot
* surface and outer edge of window */
int highlightWidth; /* Width in pixels of highlight to draw
* around widget when it has the focus.
* <= 0 means don't draw a highlight. */
XColor *highlightBgColor; /* Color for drawing traversal highlight
* area when highlight is off. */
XColor *highlightColor; /* Color for drawing traversal highlight. */
char *title;
short int titleX, titleY;
RbcTextStyle titleTextStyle; /* Graph title */
char *takeFocus;
int reqWidth, reqHeight; /* Requested size of graph window */
int width, height; /* Size of graph window or PostScript
* page */
Tcl_HashTable penTable; /* Table of pens */
struct Component {
Tcl_HashTable table; /* Hash table of ids. */
RbcChain *displayList; /* Display list. */
Tcl_HashTable tagTable; /* Table of bind tags. */
} elements,
markers,
axes;
Tk_Uid classUid; /* Default element type */
const char *chartStyle; /* one of line, bar or strip */
RbcBindTable *bindTable;
int nextMarkerId; /* Tracks next marker identifier available */
RbcChain *axisChain[4]; /* Chain of axes for each of the
* margins. They're separate from the
* margin structures to make it easier
* to invert the X-Y axes by simply
* switching chain pointers.
*/
RbcMargin margins[4];
RbcPostScript *postscript; /* PostScript options: see rbcGrPS.c */
RbcLegend *legend; /* Legend information: see rbcGrLegd.c */
RbcCrosshairs *crosshairs; /* Crosshairs information: see rbcGrHairs.c */
RbcGrid *gridPtr; /* Grid attribute information */
int halo; /* Maximum distance allowed between points
* when searching for a point */
int inverted; /* If non-zero, indicates the x and y axis
* positions should be inverted. */
RbcTile tile;
GC drawGC; /* Used for drawing on the margins. This
* includes the axis lines */
GC fillGC; /* Used to fill the background of the
* margins. The fill is governed by
* the background color or the tiled
* pixmap. */
int plotBorderWidth; /* Width of interior 3-D border. */
int plotRelief; /* 3-d effect: TK_RELIEF_RAISED etc. */
XColor *plotBg; /* Color of plotting surface */
GC plotFillGC; /* Used to fill the plotting area with a
* solid background color. The fill color
* is stored in "plotBg". */
/* If non-zero, force plot to conform to aspect ratio W/H */
double aspect;
short int left, right; /* Coordinates of plot bbox */
short int top, bottom;
RbcPad padX; /* Vertical padding for plotarea */
int vRange, vOffset; /* Vertical axis range and offset from the
* left side of the graph window. Used to
* transform coordinates to vertical
* axes. */
RbcPad padY; /* Horizontal padding for plotarea */
int hRange, hOffset; /* Horizontal axis range and offset from
* the top of the graph window. Used to
* transform horizontal axes */
double vScale, hScale;
int doubleBuffer; /* If non-zero, draw the graph into a pixmap
* first to reduce flashing. */
int backingStore; /* If non-zero, cache elements by drawing
* them into a pixmap */
Pixmap backPixmap; /* Pixmap used to cache elements
* displayed. If *backingStore* is
* non-zero, each element is drawn
* into this pixmap before it is
* copied onto the screen. The pixmap
* then acts as a cache (only the
* pixmap is redisplayed if the none
* of elements have changed). This is
* done so that markers can be redrawn
* quickly over elements without
* redrawing each element. */
int backWidth, backHeight; /* Size of element backing store pixmap. */
/*
* barchart specific information
*/
double baseline; /* Baseline from bar chart. */
double barWidth; /* Default width of each bar in graph units.
* The default width is 1.0 units. */
RbcBarMode mode; /* Mode describing how to display bars
* with the same x-coordinates. Mode can
* be "stack", "align", or "normal" */
RbcFreqInfo *freqArr; /* Contains information about duplicate
* x-values in bar elements (malloc-ed).
* This information can also be accessed
* by the frequency hash table */
Tcl_HashTable freqTable; /* */
int nStacks; /* Number of entries in frequency array.
* If zero, indicates nothing special needs
* to be done for "stack" or "align" modes */
} RbcGraph;
typedef ClientData(
MakeTagProc) (
RbcGraph * graphPtr,
const char *tagName);
typedef int (
RbcSwitchParseProc) (
ClientData clientData,
Tcl_Interp * interp,
char *switchName,
char *value,
char *record,
int offset);
typedef void (
RbcSwitchFreeProc) (
char *ptr);
/*
* RbcSwitchCustom --
*/
typedef struct {
RbcSwitchParseProc *parseProc; /* Procedure to parse a switch value
* and store it in its converted
* form in the data record. */
RbcSwitchFreeProc *freeProc; /* Procedure to free a switch. */
ClientData clientData; /* Arbitrary one-word value
* used by switch parser,
* passed to parseProc. */
} RbcSwitchCustom;
/*
* Type values for RbcSwitchSpec structures. See the user
* documentation for details.
*/
typedef enum {
RBC_SWITCH_BOOLEAN, RBC_SWITCH_INT, RBC_SWITCH_INT_POSITIVE,
RBC_SWITCH_INT_NONNEGATIVE, RBC_SWITCH_DOUBLE, RBC_SWITCH_STRING,
RBC_SWITCH_LIST, RBC_SWITCH_FLAG, RBC_SWITCH_VALUE, RBC_SWITCH_CUSTOM,
RBC_SWITCH_END
} RbcSwitchTypes;
typedef struct {
RbcSwitchTypes type; /* Type of option, such as RBC_SWITCH_DOUBLE;
* see definitions above. Last option in
* table must have type RBC_SWITCH_END. */
const char *switchName; /* Switch used to specify option in argv.
* NULL means this spec is part of a group. */
int offset; /* Where in widget record to store value;
* use RbcOffset macro to generate values
* for this. */
int flags; /* Any combination of the values defined
* below. */
RbcSwitchCustom *customPtr; /* If type is RBC_SWITCH_CUSTOM then this is
* a pointer to info about how to parse and
* print the option. Otherwise it is
* irrelevant. */
int value;
} RbcSwitchSpec;
/*
* RbcResampleFilter --
*
* Contains information about a 1-D filter (its support and
* the procedure implementing the filter).
*/
typedef struct {
const char *name; /* Name of the filter */
ResampleFilterProc *proc; /* 1-D filter procedure. */
double support; /* Width of 1-D filter */
} RbcResampleFilter;
/*
* Data declarations:
*/
extern double rbcNaN;
extern RbcResampleFilter *rbcBoxFilterPtr; /* The ubiquitous box filter */
extern Tk_Uid rbcBarElementUid;
extern Tk_Uid rbcLineElementUid;
extern Tk_Uid rbcStripElementUid;
extern Tk_Uid rbcLineMarkerUid;
extern Tk_Uid rbcBitmapMarkerUid;
extern Tk_Uid rbcImageMarkerUid;
extern Tk_Uid rbcTextMarkerUid;
extern Tk_Uid rbcPolygonMarkerUid;
extern Tk_Uid rbcWindowMarkerUid;
extern Tk_Uid rbcXAxisUid;
extern Tk_Uid rbcYAxisUid;
/*
* Inline function declarations:
*/
/* int RbcNumberOfPoints(RbcAxis2D e); */
#define RbcNumberOfPoints(e) MIN((e)->x.nValues, (e)->y.nValues)
/* int RbcLineWidth(int w); */
#define RbcLineWidth(w) (((w) > 1) ? (w) : 0)
/* int RbcPadding(RbcPad w); */
#define RbcPadding(x) ((x).side1 + (x).side2)
/* ClientData RbcGetCurrentItem(RbcBindTable *bindPtr); */
#define RbcGetCurrentItem(bindPtr) ((bindPtr)->currentItem)
/* */
/* ClientData RbcGetBindingData(RbcBindTable *bindPtr); */
#define RbcGetBindingData(bindPtr) ((bindPtr)->clientData)
/* int RbcChainGetLength(RbcChain *c); */
#define RbcChainGetLength(c) (((c) == NULL) ? 0 : (c)->nLinks)
/* RbcChainLink *RbcChainFirstLink(RbcChain *c); */
#define RbcChainFirstLink(c) (((c) == NULL) ? NULL : (c)->headPtr)
/* */
/* RbcChainLink *RbcChainLastLink(RbcChain *c); */
#define RbcChainLastLink(c) (((c) == NULL) ? NULL : (c)->tailPtr)
/* RbcChainLink *RbcChainPrevLink(RbcChainLink *l); */
#define RbcChainPrevLink(l) ((l)->prevPtr)
/* RbcChainLink *RbcChainNextLink(RbcChainLink *l); */
#define RbcChainNextLink(l) ((l)->nextPtr)
/* ClientData RbcChainGetValue(RbcChainLink *l); */
#define RbcChainGetValue(l) ((l)->clientData)
/* void RbcChainSetValue(RbcChainLink *l, ClientData value); */
#define RbcChainSetValue(l, value) ((l)->clientData = (ClientData)(value))
/*
* Function declarations:
*/
/* rbcBind.c */
MODULE_SCOPE int RbcConfigureBindings(
Tcl_Interp * interp,
RbcBindTable * table,
ClientData item,
int argc,
const char **argv);
MODULE_SCOPE int RbcConfigureBindingsFromObj(
Tcl_Interp * interp,
RbcBindTable * table,
ClientData item,
int objc,
Tcl_Obj * const *objv);
MODULE_SCOPE RbcBindTable *RbcCreateBindingTable(
Tcl_Interp * interp,
Tk_Window tkwin,
ClientData clientData,
RbcBindPickProc * pickProc);
MODULE_SCOPE void RbcDestroyBindingTable(
RbcBindTable * table);
MODULE_SCOPE void RbcPickCurrentItem(
RbcBindTable * table);
MODULE_SCOPE void RbcDeleteBindings(
RbcBindTable * table,
ClientData object);
MODULE_SCOPE void RbcMoveBindingTable(
RbcBindTable * table,
Tk_Window tkwin);
/* rbcChain,c */
MODULE_SCOPE RbcChain *RbcChainCreate(
);
MODULE_SCOPE void RbcChainInit(
RbcChain * chainPtr);
MODULE_SCOPE void RbcChainLinkAfter(
RbcChain * chainPtr,
RbcChainLink * linkPtr,
RbcChainLink * afterLinkPtr);
MODULE_SCOPE void RbcChainLinkBefore(
RbcChain * chainPtr,
RbcChainLink * linkPtr,
RbcChainLink * beforeLinkPtr);
MODULE_SCOPE RbcChainLink *RbcChainNewLink(
void);
MODULE_SCOPE void RbcChainReset(
RbcChain * chainPtr);
MODULE_SCOPE void RbcChainDestroy(
RbcChain * chainPtr);
MODULE_SCOPE void RbcChainUnlinkLink(
RbcChain * chainPtr,
RbcChainLink * linkPtr);
MODULE_SCOPE void RbcChainDeleteLink(
RbcChain * chainPtr,
RbcChainLink * linkPtr);
MODULE_SCOPE RbcChainLink *RbcChainAppend(
RbcChain * chainPtr,
ClientData clientData);
MODULE_SCOPE RbcChainLink *RbcChainPrepend(
RbcChain * chainPtr,
ClientData clientData);
MODULE_SCOPE RbcChainLink *RbcChainAllocLink(
unsigned int size);
/* rbcConfig.c */
MODULE_SCOPE int RbcGraphOptionSetPad(
Tcl_Interp * interp,
Tcl_Object object,
Tcl_Obj * value,
RbcPad * address);
MODULE_SCOPE int RbcGraphOptionSetShadow(
Tcl_Interp * interp,
Tcl_Object object,
Tcl_Obj * value,
RbcShadow * shadow);
MODULE_SCOPE int RbcGraphOptionSetTile(
Tcl_Interp * interp,
Tcl_Object object,
Tcl_Obj * value,
RbcTile * tile);
MODULE_SCOPE int RbcGetPixels(
Tcl_Interp * interp,
Tk_Window tkwin,
const char *string,
int check,
int *valuePtr);
MODULE_SCOPE int RbcConfigModified(
Tk_ConfigSpec * specs,
...);
MODULE_SCOPE int RbcConfigureWidgetComponent(
Tcl_Interp * interp,
Tk_Window tkwin,
const char *name,
const char *class,
const Tk_ConfigSpec * specs,
int argc,
const char **argv,
char *widgRec,
int flags);
/* rbcGraph.c */
MODULE_SCOPE RbcGraph *RbcGraphFromObject(
Tcl_Object object);
MODULE_SCOPE void RbcEventuallyRedrawGraph(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcGraphInstCmdProc(
ClientData clientData,
Tcl_Interp * interp,
int argc,
const char *argv[]);
MODULE_SCOPE void RbcLayoutGraph(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDrawGraph(
RbcGraph * graphPtr,
Drawable drawable,
int backingStore);
MODULE_SCOPE RbcGraph *RbcGetGraphFromWindowData(
Tk_Window tkwin);
MODULE_SCOPE int RbcGraphType(
RbcGraph * graphPtr);
/* rbcGrAxis.c */
MODULE_SCOPE double RbcInvHMap(
RbcGraph * graphPtr,
RbcAxis * axisPtr,
double x);
MODULE_SCOPE double RbcInvVMap(
RbcGraph * graphPtr,
RbcAxis * axisPtr,
double x);
MODULE_SCOPE double RbcHMap(
RbcGraph * graphPtr,
RbcAxis * axisPtr,
double x);
MODULE_SCOPE double RbcVMap(
RbcGraph * graphPtr,
RbcAxis * axisPtr,
double y);
MODULE_SCOPE RbcPoint2D RbcMap2D(
RbcGraph * graphPtr,
double x,
double y,
RbcAxis2D * pairPtr);
MODULE_SCOPE RbcPoint2D RbcInvMap2D(
RbcGraph * graphPtr,
double x,
double y,
RbcAxis2D * pairPtr);
MODULE_SCOPE void RbcResetAxes(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcGetAxisSegments(
RbcGraph * graphPtr,
RbcAxis * axisPtr,
RbcSegment2D ** segPtrPtr,
int *nSegmentsPtr);
MODULE_SCOPE void RbcLayoutMargins(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDestroyAxes(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcDefaultAxes(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcVirtualAxisOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
MODULE_SCOPE int RbcAxisOp(
RbcGraph * graphPtr,
int margin,
int argc,
const char **argv);
MODULE_SCOPE void RbcMapAxes(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDrawAxes(
RbcGraph * graphPtr,
Drawable drawable);
MODULE_SCOPE void RbcAxesToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken);
MODULE_SCOPE void RbcDrawAxisLimits(
RbcGraph * graphPtr,
Drawable drawable);
MODULE_SCOPE void RbcAxisLimitsToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken);
MODULE_SCOPE RbcAxis *RbcGetFirstAxis(
RbcChain * chainPtr);
MODULE_SCOPE RbcAxis *RbcNearestAxis(
RbcGraph * graphPtr,
int x,
int y);
MODULE_SCOPE ClientData RbcMakeAxisTag(
RbcGraph * graphPtr,
const char *tagName);
/* rbcGrBar.c */
MODULE_SCOPE RbcPen *RbcBarPen(
const char *penName);
MODULE_SCOPE RbcElement *RbcBarElement(
RbcGraph * graphPtr,
const char *name,
Tk_Uid type);
MODULE_SCOPE void RbcInitFreqTable(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcComputeStacks(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcResetStacks(
RbcGraph * graphPtr);
/* rbcGrElem.c */
MODULE_SCOPE double RbcFindElemVectorMinimum(
RbcElemVector * vecPtr,
double minLimit);
MODULE_SCOPE void RbcFreePalette(
RbcGraph * graphPtr,
RbcChain * palette);
MODULE_SCOPE int RbcStringToStyles(
ClientData clientData,
Tcl_Interp * interp,
Tk_Window tkwin,
const char *string,
char *widgRec,
int offset);
MODULE_SCOPE const char *RbcStylesToString(
ClientData clientData,
Tk_Window tkwin,
char *widgRec,
int offset,
Tcl_FreeProc ** freeProcPtr);
MODULE_SCOPE RbcPenStyle **RbcStyleMap(
RbcElement * elemPtr);
MODULE_SCOPE void RbcMapErrorBars(
RbcGraph * graphPtr,
RbcElement * elemPtr,
RbcPenStyle ** dataToStyle);
MODULE_SCOPE void RbcDestroyElements(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcMapElements(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDrawElements(
RbcGraph * graphPtr,
Drawable drawable);
MODULE_SCOPE void RbcDrawActiveElements(
RbcGraph * graphPtr,
Drawable drawable);
MODULE_SCOPE void RbcElementsToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken);
MODULE_SCOPE void RbcActiveElementsToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken);
MODULE_SCOPE int RbcGraphUpdateNeeded(
RbcGraph * graphPtr);
MODULE_SCOPE ClientData RbcMakeElementTag(
RbcGraph * graphPtr,
const char *tagName);
MODULE_SCOPE int RbcElementOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv,
Tk_Uid classUid);
/* rbcGrGrid.c */
MODULE_SCOPE void RbcMapGrid(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDrawGrid(
RbcGraph * graphPtr,
Drawable drawable);
MODULE_SCOPE void RbcGridToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken);
MODULE_SCOPE void RbcDestroyGrid(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcCreateGrid(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcGridOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
/* rbcGrHairs.c */
MODULE_SCOPE void RbcConfigureCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcEnableCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDisableCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcUpdateCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDestroyCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcCreateCrosshairs(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcCrosshairsOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
/* rbcGrLegd.c */
MODULE_SCOPE void RbcMapLegend(
RbcLegend * legendPtr,
int width,
int height);
MODULE_SCOPE void RbcDrawLegend(
RbcLegend * legendPtr,
Drawable drawable);
MODULE_SCOPE void RbcLegendToPostScript(
RbcLegend * legendPtr,
RbcPsToken * psToken);
MODULE_SCOPE void RbcDestroyLegend(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcCreateLegend(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcLegendOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
MODULE_SCOPE int RbcLegendSite(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendWidth(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendHeight(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendIsHidden(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendIsRaised(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendX(
RbcLegend * legendPtr);
MODULE_SCOPE int RbcLegendY(
RbcLegend * legendPtr);
MODULE_SCOPE void RbcLegendRemoveElement(
RbcLegend * legendPtr,
RbcElement * elemPtr);
/* rbcGrLine.c */
MODULE_SCOPE RbcPen *RbcLinePen(
const char *penName);
MODULE_SCOPE RbcElement *RbcLineElement(
RbcGraph * graphPtr,
const char *name,
Tk_Uid classUid);
/* rbcGrMarker.c */
MODULE_SCOPE ClientData RbcMakeMarkerTag(
RbcGraph * graphPtr,
const char *tagName);
MODULE_SCOPE int RbcMarkerOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
MODULE_SCOPE void RbcMarkersToPostScript(
RbcGraph * graphPtr,
RbcPsToken * psToken,
int under);
MODULE_SCOPE void RbcDrawMarkers(
RbcGraph * graphPtr,
Drawable drawable,
int under);
MODULE_SCOPE void RbcMapMarkers(
RbcGraph * graphPtr);
MODULE_SCOPE void RbcDestroyMarkers(
RbcGraph * graphPtr);
MODULE_SCOPE RbcMarker *RbcNearestMarker(
RbcGraph * graphPtr,
int x,
int y,
int under);
/* rbcGrMisc.c */
MODULE_SCOPE int RbcGetXY(
Tcl_Interp * interp,
Tk_Window tkwin,
const char *string,
int *x,
int *y);
MODULE_SCOPE void RbcFreeColorPair(
RbcColorPair * pairPtr);
MODULE_SCOPE int RbcPointInSegments(
RbcPoint2D * samplePtr,
RbcSegment2D * segments,
int nSegments,
double halo);
MODULE_SCOPE int RbcPointInPolygon(
RbcPoint2D * samplePtr,
RbcPoint2D * screenPts,
int nScreenPts);
MODULE_SCOPE int RbcRegionInPolygon(
RbcExtents2D * extsPtr,
RbcPoint2D * points,
int nPoints,
int enclosed);
MODULE_SCOPE void RbcGraphExtents(
RbcGraph * graphPtr,
RbcExtents2D * extsPtr);
MODULE_SCOPE int RbcLineRectClip(
RbcExtents2D * extsPtr,
RbcPoint2D * p,
RbcPoint2D * q);
MODULE_SCOPE int RbcPolyRectClip(
RbcExtents2D * extsPtr,
RbcPoint2D * inputPts,
int nInputPts,
RbcPoint2D * outputPts);
MODULE_SCOPE RbcPoint2D RbcGetProjection(
int x,
int y,
RbcPoint2D * p,
RbcPoint2D * q);
MODULE_SCOPE int RbcAdjustViewport(
int offset,
int worldSize,
int windowSize,
int scrollUnits,
int scrollMode);
MODULE_SCOPE int RbcGetScrollInfo(
Tcl_Interp * interp,
int argc,
char **argv,
int *offsetPtr,
int worldSize,
int windowSize,
int scrollUnits,
int scrollMode);
MODULE_SCOPE int RbcGetScrollInfoFromObj(
Tcl_Interp * interp,
int objc,
Tcl_Obj * const *objv,
int *offsetPtr,
int worldSize,
int windowSize,
int scrollUnits,
int scrollMode);
MODULE_SCOPE void RbcUpdateScrollbar(
Tcl_Interp * interp,
char *scrollCmd,
double firstFract,
double lastFract);
MODULE_SCOPE GC RbcGetPrivateGCFromDrawable(
Display * display,
Drawable drawable,
unsigned long gcMask,
XGCValues * valuePtr);
MODULE_SCOPE GC RbcGetPrivateGC(
Tk_Window tkwin,
unsigned long gcMask,
XGCValues * valuePtr);
MODULE_SCOPE void RbcFreePrivateGC(
Display * display,
GC gc);
MODULE_SCOPE void RbcSetDashes(
Display * display,
GC gc,
RbcDashes * dashesPtr);
MODULE_SCOPE int RbcSimplifyLine(
RbcPoint2D * origPts,
int low,
int high,
double tolerance,
int indices[]);
MODULE_SCOPE void RbcDraw2DSegments(
Display * display,
Drawable drawable,
GC gc,
RbcSegment2D * segments,
int nSegments);
MODULE_SCOPE int RbcMaxRequestSize(
Display * display,
unsigned int elemSize);
/* rbcPen.c */
MODULE_SCOPE void RbcFreePen(
RbcGraph * graphPtr,
RbcPen * penPtr);
MODULE_SCOPE RbcPen *RbcCreatePen(
RbcGraph * graphPtr,
const char *penName,
Tk_Uid classUid,
int nOpts,
const char **options);
MODULE_SCOPE int RbcGetPen(
RbcGraph * graphPtr,
const char *name,
Tk_Uid classUid,
RbcPen ** penPtrPtr);
MODULE_SCOPE void RbcDestroyPens(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcPenOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char **argv);
/* rbcGrPs.c */
MODULE_SCOPE void RbcDestroyPostScript(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcCreatePostScript(
RbcGraph * graphPtr);
MODULE_SCOPE int RbcPostScriptOp(
RbcGraph * graphPtr,
Tcl_Interp * interp,
int argc,
const char *argv[]);
/* rbcImage.c */
MODULE_SCOPE RbcColorImage *RbcCreateColorImage(
int width,
int height);
MODULE_SCOPE void RbcFreeColorImage(
RbcColorImage * image);
MODULE_SCOPE void RbcGammaCorrectColorImage(
RbcColorImage * src,
double newGamma);
MODULE_SCOPE void RbcColorImageToGreyscale(
RbcColorImage * image);
MODULE_SCOPE void RbcColorImageToPhoto(
Tcl_Interp * interp,
RbcColorImage * image,
Tk_PhotoHandle photo);
MODULE_SCOPE RbcColorImage *RbcPhotoRegionToColorImage(
Tk_PhotoHandle photo,
int x,
int y,
int width,
int height);
MODULE_SCOPE RbcColorImage *RbcPhotoToColorImage(
Tk_PhotoHandle photo);
MODULE_SCOPE int RbcGetResampleFilter(
Tcl_Interp * interp,
char *filterName,
RbcResampleFilter ** filterPtrPtr);
MODULE_SCOPE RbcColorImage *RbcResampleColorImage(
RbcColorImage * image,
int destWidth,
int destHeight,
RbcResampleFilter * horzFilterPtr,
RbcResampleFilter * vertFilterPtr);
MODULE_SCOPE void RbcResamplePhoto(
Tcl_Interp * interp,
Tk_PhotoHandle srcPhoto,
int x,
int y,
int width,
int height,
Tk_PhotoHandle destPhoto,
RbcResampleFilter * horzFilterPtr,
RbcResampleFilter * vertFilterPtr);
MODULE_SCOPE void RbcResizePhoto(
Tcl_Interp * interp,
Tk_PhotoHandle srcPhoto,
int x,
int y,
int width,
int height,
Tk_PhotoHandle destPhoto);
MODULE_SCOPE RbcColorImage *RbcResizeColorImage(
RbcColorImage * src,
int x,
int y,
int width,
int height,
int destWidth,
int destHeight);
MODULE_SCOPE RbcColorImage *RbcResizeColorSubimage(
RbcColorImage * src,
int x,
int y,
int width,
int height,
int destWidth,
int destHeight);
MODULE_SCOPE RbcColorImage *RbcConvolveColorImage(
RbcColorImage * srcImage,
RbcFilter2D * filter);
MODULE_SCOPE int RbcSnapPhoto(
Tcl_Interp * interp,
Tk_Window tkwin,
Drawable drawable,
int x,
int y,
int width,
int height,
int destWidth,
int destHeight,
const char *photoName,
double inputGamma);
MODULE_SCOPE RbcColorImage *RbcRotateColorImage(
RbcColorImage * image,
double theta);
MODULE_SCOPE int RbcQuantizeColorImage(
RbcColorImage * src,
RbcColorImage * dest,
int nColors);
MODULE_SCOPE RbcRegion2D *RbcSetRegion(
int x,
int y,
int width,
int height,
RbcRegion2D * regionPtr);
MODULE_SCOPE Tk_Image RbcCreateTemporaryImage(
Tcl_Interp * interp,
Tk_Window tkwin,
ClientData clientData);
MODULE_SCOPE int RbcDestroyTemporaryImage(
Tcl_Interp * interp,
Tk_Image tkImage);
MODULE_SCOPE const char *RbcNameOfImage(
Tk_Image tkImage);
MODULE_SCOPE int RbcImageIsDeleted(
Tk_Image tkImage);
/* rbcParse.c */
MODULE_SCOPE void RbcExpandParseValue(
RbcParseValue * parsePtr,
int needed);
MODULE_SCOPE int RbcParseNestedCmd(
Tcl_Interp * interp,
char *string,
int flags,
char **termPtr,
RbcParseValue * parsePtr);
MODULE_SCOPE int RbcParseBraces(
Tcl_Interp * interp,
char *string,
char **termPtr,
RbcParseValue * parsePtr);
MODULE_SCOPE int RbcParseQuotes(
Tcl_Interp * interp,
char *string,
int termChar,
int flags,
char **termPtr,
RbcParseValue * parsePtr);
/* rbcPs.c */
MODULE_SCOPE RbcPsToken *RbcGetPsToken(
Tcl_Interp * interp,
Tk_Window tkwin);
MODULE_SCOPE void RbcReleasePsToken(
RbcPsToken * psToken);
MODULE_SCOPE char *RbcPostScriptFromToken(
RbcPsToken * psToken);
MODULE_SCOPE char *RbcScratchBufferFromToken(
RbcPsToken * psToken);
MODULE_SCOPE void RbcAppendToPostScript(
RbcPsToken * psToken,
...);
MODULE_SCOPE void RbcFormatToPostScript(
RbcPsToken * psToken,
...);
MODULE_SCOPE void RbcBackgroundToPostScript(
RbcPsToken * psToken,
XColor * colorPtr);
MODULE_SCOPE void RbcForegroundToPostScript(
RbcPsToken * psToken,
XColor * colorPtr);
MODULE_SCOPE void RbcBitmapDataToPostScript(
RbcPsToken * psToken,
Display * display,
Pixmap bitmap,
int width,
int height);
MODULE_SCOPE int RbcColorImageToPsData(
RbcColorImage * image,
int nComponents,
Tcl_DString * resultPtr,
const char *prefix);
MODULE_SCOPE void RbcClearBackgroundToPostScript(
RbcPsToken * psToken);
MODULE_SCOPE void RbcLineWidthToPostScript(
RbcPsToken * psToken,
int lineWidth);
MODULE_SCOPE void RbcLineDashesToPostScript(
RbcPsToken * psToken,
RbcDashes * dashesPtr);
MODULE_SCOPE void RbcLineAttributesToPostScript(
RbcPsToken * psToken,
XColor * colorPtr,
int lineWidth,
RbcDashes * dashesPtr,
int capStyle,
int joinStyle);
MODULE_SCOPE void RbcRectangleToPostScript(
RbcPsToken * psToken,
double x,
double y,
int width,
int height);
MODULE_SCOPE void RbcRegionToPostScript(
RbcPsToken * psToken,
double x,
double y,
int width,
int height);
MODULE_SCOPE void RbcPathToPostScript(
RbcPsToken * psToken,
RbcPoint2D * screenPts,
int nScreenPts);
MODULE_SCOPE void RbcPolygonToPostScript(
RbcPsToken * psToken,
RbcPoint2D * screenPts,
int nScreenPts);
MODULE_SCOPE void RbcSegmentsToPostScript(
RbcPsToken * psToken,
XSegment * segArr,
int nSegs);
MODULE_SCOPE void RbcRectanglesToPostScript(
RbcPsToken * psToken,
XRectangle * rectArr,
int nRects);
MODULE_SCOPE void RbcDraw3DRectangleToPostScript(
RbcPsToken * psToken,
Tk_3DBorder border,
double x,
double y,
int width,
int height,
int borderWidth,
int relief);
MODULE_SCOPE void RbcFill3DRectangleToPostScript(
RbcPsToken * psToken,
Tk_3DBorder border,
double x,
double y,
int width,
int height,
int borderWidth,
int relief);
MODULE_SCOPE void RbcStippleToPostScript(
RbcPsToken * psToken,
Display * display,
Pixmap bitmap);
MODULE_SCOPE void RbcColorImageToPostScript(
RbcPsToken * psToken,
RbcColorImage * image,
double x,
double y);
MODULE_SCOPE void RbcWindowToPostScript(
RbcPsToken * psToken,
Tk_Window tkwin,
double x,
double y);
MODULE_SCOPE void RbcPhotoToPostScript(
RbcPsToken * psToken,
Tk_PhotoHandle photoToken,
double x,
double y);
MODULE_SCOPE void RbcFontToPostScript(
RbcPsToken * psToken,
Tk_Font font);
MODULE_SCOPE void RbcTextToPostScript(
RbcPsToken * psToken,
char *string,
RbcTextStyle * attrPtr,
double x,
double y);
MODULE_SCOPE void RbcLineToPostScript(
RbcPsToken * psToken,
XPoint * pointArr,
int nPoints);
MODULE_SCOPE void RbcBitmapToPostScript(
RbcPsToken * psToken,
Display * display,
Pixmap bitmap,
double scaleX,
double scaleY);
MODULE_SCOPE void Rbc2DSegmentsToPostScript(
RbcPsToken * psToken,
RbcSegment2D * segments,
int nSegments);
/* rbcSpline.c */
MODULE_SCOPE int RbcQuadraticSpline(
RbcPoint2D * origPts,
int nOrigPts,
RbcPoint2D * intpPts,
int nIntpPts);
MODULE_SCOPE int RbcNaturalSpline(
RbcPoint2D * origPts,
int nOrigPts,
RbcPoint2D * intpPts,
int nIntpPts);
MODULE_SCOPE int RbcSplineInit(
Tcl_Interp * interp);
MODULE_SCOPE int RbcNaturalParametricSpline(
RbcPoint2D * origPts,
int nOrigPts,
RbcExtents2D * extsPtr,
int isClosed,
RbcPoint2D * intpPts,
int nIntpPts);
MODULE_SCOPE int RbcCatromParametricSpline(
RbcPoint2D * origPts,
int nOrigPts,
RbcPoint2D * intpPts,
int nIntpPts);
/* rbcSwitch.c */
MODULE_SCOPE int RbcProcessSwitches(
Tcl_Interp * interp,
RbcSwitchSpec * specs,
int argc,
const char **argv,
char *record,
int flags);
MODULE_SCOPE int RbcProcessObjSwitches(
Tcl_Interp * interp,
RbcSwitchSpec * specPtr,
int objc,
Tcl_Obj * const *objv,
char *record,
int flags);
MODULE_SCOPE void RbcFreeSwitches(
RbcSwitchSpec * specs,
char *record,
int flags);
MODULE_SCOPE int RbcSwitchChanged(
RbcSwitchSpec * specs,
...);
/* rbcText.c */
MODULE_SCOPE RbcTextLayout *RbcGetTextLayout(
char *string,
RbcTextStyle * stylePtr);
MODULE_SCOPE void RbcGetTextExtents(
RbcTextStyle * stylePtr,
char *text,
int *widthPtr,
int *heightPtr);
MODULE_SCOPE void RbcGetBoundingBox(
int width,
int height,
double theta,
double *widthPtr,
double *heightPtr,
RbcPoint2D * points);
MODULE_SCOPE void RbcTranslateAnchor(
int x,
int y,
int width,
int height,
Tk_Anchor anchor,
int *transXPtr,
int *transYPtr);
MODULE_SCOPE RbcPoint2D RbcTranslatePoint(
RbcPoint2D * pointPtr,
int width,
int height,
Tk_Anchor anchor);
MODULE_SCOPE void RbcInitTextStyle(
RbcTextStyle * stylePtr);
MODULE_SCOPE void RbcSetDrawTextStyle(
RbcTextStyle * stylePtr,
Tk_Font font,
GC gc,
XColor * normalColor,
XColor * activeColor,
XColor * shadowColor,
double theta,
Tk_Anchor anchor,
Tk_Justify justify,
int leader,
int shadowOffset);
MODULE_SCOPE void RbcSetPrintTextStyle(
RbcTextStyle * stylePtr,
Tk_Font font,
XColor * fgColor,
XColor * bgColor,
XColor * shadowColor,
double theta,
Tk_Anchor anchor,
Tk_Justify justify,
int leader,
int shadowOffset);
MODULE_SCOPE void RbcDrawTextLayout(
Tk_Window tkwin,
Drawable drawable,
RbcTextLayout * textPtr,
RbcTextStyle * stylePtr,
int x,
int y);
MODULE_SCOPE void RbcDrawText2(
Tk_Window tkwin,
Drawable drawable,
char *string,
RbcTextStyle * stylePtr,
int x,
int y,
RbcDim2D * dimPtr);
MODULE_SCOPE void RbcDrawText(
Tk_Window tkwin,
Drawable drawable,
char *string,
RbcTextStyle * stylePtr,
int x,
int y);
MODULE_SCOPE GC RbcGetBitmapGC(
Tk_Window tkwin);
MODULE_SCOPE void RbcResetTextStyle(
Tk_Window tkwin,
RbcTextStyle * stylePtr);
MODULE_SCOPE void RbcFreeTextStyle(
Display * display,
RbcTextStyle * stylePtr);
/* rbcTile.c */
MODULE_SCOPE int RbcGetTile(
Tcl_Interp * interp,
Tk_Window tkwin,
const char *imageName,
RbcTile * tilePtr);
MODULE_SCOPE void RbcFreeTile(
RbcTile tile);
MODULE_SCOPE const char *RbcNameOfTile(
RbcTile tile);
Pixmap RbcPixmapOfTile(
RbcTile tile);
MODULE_SCOPE void RbcSizeOfTile(
RbcTile tile,
int *widthPtr,
int *heightPtr);
MODULE_SCOPE void RbcSetTileChangedProc(
RbcTile tile,
RbcTileChangedProc * changeProc,
ClientData clientData);
MODULE_SCOPE void RbcSetTileOrigin(
Tk_Window tkwin,
RbcTile tile,
int x,
int y);
MODULE_SCOPE void RbcSetTSOrigin(
Tk_Window tkwin,
RbcTile tile,
int x,
int y);
MODULE_SCOPE void RbcTilePolygon(
Tk_Window tkwin,
Drawable drawable,
RbcTile tile,
XPoint * pointArr,
int nPoints);
MODULE_SCOPE void RbcTileRectangle(
Tk_Window tkwin,
Drawable drawable,
RbcTile tile,
int x,
int y,
unsigned int width,
unsigned int height);
MODULE_SCOPE void RbcTileRectangles(
Tk_Window tkwin,
Drawable drawable,
RbcTile tile,
XRectangle * rectArr,
int nRects);
/* rbcUtil.c */
MODULE_SCOPE void *RbcCalloc(
unsigned int nElem,
size_t size);
MODULE_SCOPE char *RbcStrdup(
const char *ptr);
MODULE_SCOPE RbcOp RbcGetOp(
Tcl_Interp * interp,
int nSpecs,
RbcOpSpec * specArr,
int operPos,
int argc,
const char **argv,
int flags);
MODULE_SCOPE RbcOp RbcGetOpFromObj(
Tcl_Interp * interp,
int nSpecs,
RbcOpSpec * specArr,
int operPos,
int objc,
Tcl_Obj * const *objv,
int flags);
/* rbcVecMath.c */
MODULE_SCOPE void RbcVectorInstallMathFunctions(
Tcl_HashTable * tablePtr);
MODULE_SCOPE void RbcVectorInstallSpecialIndices(
Tcl_HashTable * tablePtr);
MODULE_SCOPE double RbcVecMin(
Rbc_Vector * vecPtr);
MODULE_SCOPE double RbcVecMax(
Rbc_Vector * vecPtr);
MODULE_SCOPE int RbcExprVector(
Tcl_Interp * interp,
char *string,
Rbc_Vector * vecPtr);
/* rbcVecObjCmd.c */
MODULE_SCOPE int RbcAppendOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcArithOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcBinreadOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcClearOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcDeleteOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcDupOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcExprOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcIndexOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcLengthOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcMergeOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcNormalizeOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcOffsetOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcPopulateOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcRandomOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcRangeOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcSearchOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcSeqOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcSetOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcSortOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcSplitOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int RbcVariableOp(
RbcVectorObject * vPtr,
Tcl_Interp * interp,
int objc,
Tcl_Obj * const objv[]);
MODULE_SCOPE int *RbcVectorSortIndex(
RbcVectorObject ** vPtrPtr,
int nVectors);
/* rbcVector.c */
MODULE_SCOPE double Rbcdrand48(
void);
MODULE_SCOPE RbcVectorInterpData *RbcVectorGetInterpData(
Tcl_Interp * interp);
MODULE_SCOPE RbcVectorObject *RbcVectorNew(
RbcVectorInterpData * dataPtr);
MODULE_SCOPE RbcVectorObject *RbcVectorCreate(
RbcVectorInterpData * dataPtr,
const char *vecName,
const char *cmdName,
const char *varName,
int *newPtr);
MODULE_SCOPE void Rbc_VectorFree(
RbcVectorObject * vPtr);
MODULE_SCOPE int RbcVectorDuplicate(
RbcVectorObject * destPtr,
RbcVectorObject * srcPtr);
MODULE_SCOPE void RbcVectorFlushCache(
RbcVectorObject * vPtr);
MODULE_SCOPE int RbcVectorMapVariable(
Tcl_Interp * interp,
RbcVectorObject * vPtr,
const char *name);
MODULE_SCOPE int RbcVectorReset(
RbcVectorObject * vPtr,
double *valueArr,
int length,
int size,
Tcl_FreeProc * freeProc);
MODULE_SCOPE int RbcVectorNotifyPending(
RbcVectorId clientId);
MODULE_SCOPE int RbcVectorChangeLength(
RbcVectorObject * vPtr,
int length);
MODULE_SCOPE int RbcVectorLookupName(
RbcVectorInterpData * dataPtr,
const char *vecName,
RbcVectorObject ** vPtrPtr);
MODULE_SCOPE void RbcVectorUpdateRange(
RbcVectorObject * vPtr);
MODULE_SCOPE int RbcVectorGetIndex(
Tcl_Interp * interp,
RbcVectorObject * vPtr,
const char *string,
int *indexPtr,
int flags,
Rbc_VectorIndexProc ** procPtrPtr);
MODULE_SCOPE int RbcVectorGetIndexRange(
Tcl_Interp * interp,
RbcVectorObject * vPtr,
const char *string,
int flags,
Rbc_VectorIndexProc ** procPtrPtr);
RbcVectorObject *RbcVectorParseElement(
Tcl_Interp * interp,
RbcVectorInterpData * dataPtr,
const char *start,
char **endPtr,
int flags);
MODULE_SCOPE void RbcVectorUpdateClients(
RbcVectorObject * vPtr);
MODULE_SCOPE Tcl_Obj *RbcGetValues(
RbcVectorObject * vPtr,
int first,
int last);
MODULE_SCOPE void RbcReplicateValue(
RbcVectorObject * vPtr,
int first,
int last,
double value);
MODULE_SCOPE int RbcGetDouble(
Tcl_Interp * interp,
Tcl_Obj * objPtr,
double *valuePtr);
MODULE_SCOPE void Rbc_FreeVectorId(
RbcVectorId clientId);
MODULE_SCOPE int Rbc_GetVectorById(
Tcl_Interp * interp,
RbcVectorId clientId,
Rbc_Vector ** vecPtrPtr);
MODULE_SCOPE int Rbc_VectorExists(
Tcl_Interp * interp,
const char *vecName);
MODULE_SCOPE RbcVectorId RbcAllocVectorId(
Tcl_Interp * interp,
const char *vecName);
MODULE_SCOPE void Rbc_SetVectorChangedProc(
RbcVectorId clientId,
RbcVectorChangedProc * proc,
ClientData clientData);
MODULE_SCOPE char *Rbc_NameOfVectorId(
RbcVectorId clientId);
MODULE_SCOPE int Rbc_GetVector(
Tcl_Interp * interp,
const char *vecName,
Rbc_Vector ** vecPtrPtr);
MODULE_SCOPE int RbcCreateVector2(
Tcl_Interp * interp,
const char *vecName,
const char *cmdName,
const char *varName,
int initialSize,
Rbc_Vector ** vecPtrPtr);
MODULE_SCOPE int Rbc_CreateVector(
Tcl_Interp * interp,
const char *vecName,
int size,
Rbc_Vector ** vecPtrPtr);
MODULE_SCOPE int Rbc_ResizeVector(
Rbc_Vector * vecPtr,
int nValues);
MODULE_SCOPE char *RbcNameOfVector(
Rbc_Vector * vecPtr);
MODULE_SCOPE int Rbc_ResetVector(
Rbc_Vector * vecPtr,
double *dataArr,
int nValues,
int arraySize,
Tcl_FreeProc * freeProc);
/* rbcWindow.c */
MODULE_SCOPE Tk_Window RbcFindChild(
Tk_Window parent,
char *name);
MODULE_SCOPE void RbcSetWindowInstanceData(
Tk_Window tkwin,
ClientData instanceData);
MODULE_SCOPE ClientData RbcGetWindowInstanceData(
Tk_Window tkwin);
MODULE_SCOPE void RbcDeleteWindowInstanceData(
Tk_Window tkwin);
/* rbcWinImage.c rbcUnixImage.c */
MODULE_SCOPE RbcColorImage *RbcDrawableToColorImage(
Tk_Window tkwin,
Drawable drawable,
int x,
int y,
int width,
int height,
double inputGamma);
MODULE_SCOPE Pixmap RbcPhotoImageMask(
Tk_Window tkwin,
Tk_PhotoImageBlock src);
MODULE_SCOPE Pixmap RbcRotateBitmap(
Tk_Window tkwin,
Pixmap bitmap,
int width,
int height,
double theta,
int *widthPtr,
int *heightPtr);
MODULE_SCOPE Pixmap RbcScaleBitmap(
Tk_Window tkwin,
Pixmap srcBitmap,
int srcWidth,
int srcHeight,
int scaledWidth,
int scaledHeight);
MODULE_SCOPE Pixmap RbcScaleRotateBitmapRegion(
Tk_Window tkwin,
Pixmap srcBitmap,
unsigned int srcWidth,
unsigned int srcHeight,
int regionX,
int regionY,
unsigned int regionWidth,
unsigned int regionHeight,
unsigned int virtWidth,
unsigned int virtHeight,
double theta);
/* Windows */
#ifdef _WIN32
#include "tkoRbcWin.h"
#endif
#ifndef _WIN32
#define PurifyPrintf printf
#endif /* _WIN32 */
#ifndef TRUE
#define TRUE 1
#endif
#ifndef FALSE
#define FALSE 0
#endif
/*
* end block for C++
*/
#ifdef __cplusplus
}
#endif
#endif /* _TKOGRAPH_H */
/* vim: set ts=4 sw=4 sts=4 ff=unix et : */
Home
Timeline
Branches
Tags
Forum
Tickets
Download
Wiki