CPTScatterPlot.h

Go to the documentation of this file.

#import "CPTDefinitions.h"
#import "CPTLimitBand.h"
#import "CPTPlot.h"
#import "CPTPlotSymbol.h"
 
 
@class CPTLineStyle;
@class CPTScatterPlot;
@class CPTFill;
 
typedef NSString *CPTScatterPlotBinding cpt_swift_struct;
 
extern CPTScatterPlotBinding __nonnull const CPTScatterPlotBindingXValues;
extern CPTScatterPlotBinding __nonnull const CPTScatterPlotBindingYValues;
extern CPTScatterPlotBinding __nonnull const CPTScatterPlotBindingPlotSymbols;
 
typedef NS_ENUM (NSInteger, CPTScatterPlotField) {
    CPTScatterPlotFieldX, 
    CPTScatterPlotFieldY  
};
 
typedef NS_ENUM (NSInteger, CPTScatterPlotInterpolation) {
    CPTScatterPlotInterpolationLinear,    
    CPTScatterPlotInterpolationStepped,   
    CPTScatterPlotInterpolationHistogram, 
    CPTScatterPlotInterpolationCurved     
};
 
typedef NS_ENUM (NSInteger, CPTScatterPlotCurvedInterpolationOption) {
    CPTScatterPlotCurvedInterpolationNormal,                
    CPTScatterPlotCurvedInterpolationCatmullRomUniform,     
    CPTScatterPlotCurvedInterpolationCatmullRomCentripetal, 
    CPTScatterPlotCurvedInterpolationCatmullRomChordal,     
    CPTScatterPlotCurvedInterpolationCatmullCustomAlpha,    
    CPTScatterPlotCurvedInterpolationHermiteCubic           
};
 
typedef NS_ENUM (NSInteger, CPTScatterPlotHistogramOption) {
    CPTScatterPlotHistogramNormal,     
    CPTScatterPlotHistogramSkipFirst,  
    CPTScatterPlotHistogramSkipSecond, 
    CPTScatterPlotHistogramOptionCount 
};
 
#pragma mark -
 
@protocol CPTScatterPlotDataSource<CPTPlotDataSource>
 
@optional
 
 
-(nullable CPTPlotSymbolArray *)symbolsForScatterPlot:(nonnull CPTScatterPlot *)plot recordIndexRange:(NSRange)indexRange;
 
-(nullable CPTPlotSymbol *)symbolForScatterPlot:(nonnull CPTScatterPlot *)plot recordIndex:(NSUInteger)idx;
 
 
@end
 
#pragma mark -
 
@protocol CPTScatterPlotDelegate<CPTPlotDelegate>
 
@optional
 
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolWasSelectedAtRecordIndex:(NSUInteger)idx;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolWasSelectedAtRecordIndex:(NSUInteger)idx withEvent:(nonnull CPTNativeEvent *)event;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolTouchDownAtRecordIndex:(NSUInteger)idx;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolTouchDownAtRecordIndex:(NSUInteger)idx withEvent:(nonnull CPTNativeEvent *)event;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolTouchUpAtRecordIndex:(NSUInteger)idx;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot plotSymbolTouchUpAtRecordIndex:(NSUInteger)idx withEvent:(nonnull CPTNativeEvent *)event;
 
 
 
-(void)scatterPlotDataLineWasSelected:(nonnull CPTScatterPlot *)plot;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot dataLineWasSelectedWithEvent:(nonnull CPTNativeEvent *)event;
 
-(void)scatterPlotDataLineTouchDown:(nonnull CPTScatterPlot *)plot;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot dataLineTouchDownWithEvent:(nonnull CPTNativeEvent *)event;
 
-(void)scatterPlotDataLineTouchUp:(nonnull CPTScatterPlot *)plot;
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot dataLineTouchUpWithEvent:(nonnull CPTNativeEvent *)event;
 
 
 
-(void)scatterPlot:(nonnull CPTScatterPlot *)plot prepareForDrawingPlotLine:(nonnull CGPathRef)dataLinePath inContext:(nonnull CGContextRef)context;
 
 
@end
 
#pragma mark -
 
@interface CPTScatterPlot : CPTPlot
 
@property (nonatomic, readwrite, strong, nullable) NSNumber *areaBaseValue;
@property (nonatomic, readwrite, strong, nullable) NSNumber *areaBaseValue2;
@property (nonatomic, readwrite, assign) CPTScatterPlotInterpolation interpolation;
@property (nonatomic, readwrite, assign) CPTScatterPlotHistogramOption histogramOption;
@property (nonatomic, readwrite, assign) CPTScatterPlotCurvedInterpolationOption curvedInterpolationOption;
@property (nonatomic, readwrite, assign) CGFloat curvedInterpolationCustomAlpha;
 
@property (nonatomic, readonly, nullable) CPTLimitBandArray *areaFillBands;
 
@property (nonatomic, readwrite, copy, nullable) CPTLineStyle *dataLineStyle;
@property (nonatomic, readwrite, copy, nullable) CPTPlotSymbol *plotSymbol;
@property (nonatomic, readwrite, copy, nullable) CPTFill *areaFill;
@property (nonatomic, readwrite, copy, nullable) CPTFill *areaFill2;
 
@property (nonatomic, readonly, nonnull) CGPathRef newDataLinePath;
 
@property (nonatomic, readwrite, assign) CGFloat plotSymbolMarginForHitDetection;
@property (nonatomic, readwrite, assign) CGFloat plotLineMarginForHitDetection;
@property (nonatomic, readwrite, assign) BOOL allowSimultaneousSymbolAndPlotSelection;
 
-(NSUInteger)indexOfVisiblePointClosestToPlotAreaPoint:(CGPoint)viewPoint;
-(CGPoint)plotAreaPointOfVisiblePointAtIndex:(NSUInteger)idx;
 
-(nullable CPTPlotSymbol *)plotSymbolForRecordIndex:(NSUInteger)idx;
-(void)reloadPlotSymbols;
-(void)reloadPlotSymbolsInIndexRange:(NSRange)indexRange;
 
-(void)addAreaFillBand:(nullable CPTLimitBand *)limitBand;
-(void)removeAreaFillBand:(nullable CPTLimitBand *)limitBand;
 
@end