38 lines
1.6 KiB
C
38 lines
1.6 KiB
C
/** @file set_plot.h
|
|
* @brief Toolkit-independent plot interaction math shared by JNI and ctypes.
|
|
* Coordinates are doubles in the caller's units. No allocation or global state.
|
|
*/
|
|
#ifndef SET_PLOT_H
|
|
#define SET_PLOT_H
|
|
#include "pcan_abi.h"
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
enum set_plot_operation {
|
|
SET_PLOT_TRANSFORM = 0, /* x,y,w,h, zoomX,zoomY, panX,panY, focusX,focusY -> x,y,w,h */
|
|
SET_PLOT_AXIS = 1, /* deltaX,deltaY,slop -> 0=none, 1=X, 2=Y */
|
|
SET_PLOT_FRACTION = 2, /* value,low,high,inverted -> fraction (not clamped) */
|
|
SET_PLOT_VALUE = 3, /* fraction,low,high,inverted -> value (not clamped) */
|
|
SET_PLOT_DRAG = 4, /* initial,deltaPixels,length,low,high,inverted -> clamped value */
|
|
SET_PLOT_TICK_STEP = 5, /* range,lengthPixels -> nice step */
|
|
SET_PLOT_DELTA = 6, /* A,B,multiplier -> (B-A)*multiplier */
|
|
SET_PLOT_DB_DELTA = 7, /* A,B -> 20*log10(abs(B/A)); zero is invalid */
|
|
SET_PLOT_LIMITS = 8 /* xMin,xMax,yMin,yMax -> validated unchanged limits */
|
|
};
|
|
|
|
/** Version of this plot ABI, independently of the transport ABI (currently 2). */
|
|
PCAN_ABI_API uint32_t set_plot_abi_version(void);
|
|
/** Evaluates one operation. Returns output count, or 0 for invalid arguments.
|
|
* TRANSFORM rejects malformed viewports; invalid gesture values return the
|
|
* unchanged viewport. Zoom is restricted to 1..128, with focus anchoring.
|
|
* Screen fractions increase downwards; set inverted=1 for the Y value axis.
|
|
*/
|
|
PCAN_ABI_API size_t set_plot_eval(uint32_t operation, const double *input,
|
|
size_t count, double *output, size_t capacity);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
#endif
|