Defines the coordinate system of a plot. More...

#import <CPTPlotSpace.h>

Inheritance diagram for CPTPlotSpace:

Collaboration diagram for CPTPlotSpace:

Public Instance Methods
(CGPoint)	- plotAreaViewPointForPlotPoint: `[implementation]`
	Converts a data point to plot area drawing coordinates. More...

(CGPoint)	- plotAreaViewPointForPlotPoint:numberOfCoordinates: `[implementation]`
	Converts a data point to plot area drawing coordinates. More...

(CGPoint)	- plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates: `[implementation]`
	Converts a data point to plot area drawing coordinates. More...

(nullable CPTNumberArray *)	- plotPointForPlotAreaViewPoint: `[implementation]`
	Converts a point given in plot area drawing coordinates to the data coordinate space. More...

(void)	- plotPoint:numberOfCoordinates:forPlotAreaViewPoint: `[implementation]`
	Converts a point given in plot area drawing coordinates to the data coordinate space. More...

(void)	- doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint: `[implementation]`
	Converts a point given in drawing coordinates to the data coordinate space. More...

(CGPoint)	- plotAreaViewPointForEvent: `[implementation]`
	Converts the interaction point of an OS event to plot area drawing coordinates. More...

(nullable CPTNumberArray *)	- plotPointForEvent: `[implementation]`
	Converts the interaction point of an OS event to the data coordinate space. More...

(void)	- plotPoint:numberOfCoordinates:forEvent: `[implementation]`
	Converts the interaction point of an OS event to the data coordinate space. More...

(void)	- doublePrecisionPlotPoint:numberOfCoordinates:forEvent: `[implementation]`
	Converts the interaction point of an OS event to the data coordinate space. More...

(void)	- setPlotRange:forCoordinate: `[implementation]`
	Sets the range of values for a given coordinate. More...

(nullable CPTPlotRange *)	- plotRangeForCoordinate: `[implementation]`
	Gets the range of values for a given coordinate. More...

(void)	- setScaleType:forCoordinate: `[implementation]`
	Sets the scale type for a given coordinate. More...

(CPTScaleType)	- scaleTypeForCoordinate: `[implementation]`
	Gets the scale type for a given coordinate. More...

(void)	- scaleToFitPlots: `[implementation]`
	Scales the plot ranges so that the plots just fit in the visible space. More...

(void)	- scaleToFitEntirePlots: `[implementation]`
	Scales the plot ranges so that the plots just fit in the visible space. More...

(void)	- scaleBy:aboutPoint: `[implementation]`
	Zooms the plot space equally in each dimension. More...

Categorical Data
(void)	- addCategory:forCoordinate:
	Add a new category name for the given coordinate. More...

(void)	- removeCategory:forCoordinate:
	Removes the named category for the given coordinate. More...

(void)	- insertCategory:forCoordinate:atIndex:
	Add a new category name for the given coordinate at the given index in the list of category names. More...

(void)	- setCategories:forCoordinate:
	Replace all category names for the given coordinate with the names in the supplied array. More...

(void)	- removeAllCategories
	Remove all categories for every coordinate. More...

(nonnull CPTStringArray *)	- categoriesForCoordinate:
	Returns a list of all category names for the given coordinate. More...

(nullable NSString *)	- categoryForCoordinate:atIndex:
	Returns the category name for the given coordinate at the given index in the list of category names. More...

(NSUInteger)	- indexOfCategory:forCoordinate:
	Returns the index of the given category name in the list of category names for the given coordinate. More...

Initialization
(nonnull instancetype)	- init
	Initializes a newly allocated CPTPlotSpace object. More...

(nullable instancetype)	- initWithCoder:
	Returns an object initialized from data in a given unarchiver. More...

User Interaction
(BOOL)	- pointingDeviceDownEvent:atPoint: `[implementation]`
	Informs the receiver that the user has pressed the mouse button. More...

(BOOL)	- pointingDeviceUpEvent:atPoint: `[implementation]`
	Informs the receiver that the user has released the mouse button. More...

(BOOL)	- pointingDeviceDraggedEvent:atPoint: `[implementation]`
	Informs the receiver that the user has moved the mouse with the button pressed. More...

(BOOL)	- pointingDeviceCancelledEvent: `[implementation]`
	Informs the receiver that tracking of mouse moves has been cancelled for any reason. More...

(BOOL)	- scrollWheelEvent:fromPoint:toPoint: `[implementation]`
	Informs the receiver that the user has moved the scroll wheel. More...

Coordinate Space Conversions
(CGPoint)	- plotAreaViewPointForPlotPoint:

(CGPoint)	- plotAreaViewPointForPlotPoint:numberOfCoordinates:

(CGPoint)	- plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates:

(nullable CPTNumberArray *)	- plotPointForPlotAreaViewPoint:

(void)	- plotPoint:numberOfCoordinates:forPlotAreaViewPoint:

(void)	- doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint:

(CGPoint)	- plotAreaViewPointForEvent:

(nullable CPTNumberArray *)	- plotPointForEvent:

(void)	- plotPoint:numberOfCoordinates:forEvent:

(void)	- doublePrecisionPlotPoint:numberOfCoordinates:forEvent:

Coordinate Range
(void)	- setPlotRange:forCoordinate:

(nullable CPTPlotRange *)	- plotRangeForCoordinate:

Scale Types
(void)	- setScaleType:forCoordinate:

(CPTScaleType)	- scaleTypeForCoordinate:

Adjusting Ranges
(void)	- scaleToFitPlots:

(void)	- scaleToFitPlots:forCoordinate:
	Scales the plot range for the given coordinate so that the plots just fit in the visible space. More...

(void)	- scaleToFitEntirePlots:

(void)	- scaleToFitEntirePlots:forCoordinate:
	Scales the plot range for the given coordinate so that the plots just fit in the visible space. More...

(void)	- scaleBy:aboutPoint:

Public Instance Methods inherited from NSObject
(Class)	- classForCoder

(id)	- copy

(void)	- dealloc

(void)	- finalize

(id)	- init

(id)	- mutableCopy

Public Instance Methods inherited from <NSObject>
(NSString *)	- description

(NSUInteger)	- hash

(BOOL)	- isEqual:

Public Instance Methods inherited from <NSKeyValueBindingCreation>
(NSArray *)	- exposedBindings

(Class)	- valueClassForBinding:

(void)	- bind:toObject:withKeyPath:options:

(NSArray *)	- optionDescriptionsForBinding:

(NSDictionary *)	- infoForBinding:

(void)	- unbind:

User Interaction
Public Instance Methods inherited from <NSCoding>
(id)	- initWithCoder:

(void)	- encodeWithCoder:

Properties
id< NSCopying, NSCoding, NSObject >	identifier
	An object used to identify the plot in collections. More...

BOOL	allowsUserInteraction
	Determines whether user can interactively change plot range and/or zoom. More...

BOOL	isDragging
	Returns YES when the user is actively dragging the plot space. More...

CPTGraph *	graph
	The graph of the space. More...

id< CPTPlotSpaceDelegate >	delegate
	The plot space delegate. More...

NSUInteger	numberOfCoordinates
	The number of coordinate values that determine a point in the plot space. More...

Additional Inherited Members
Public Class Methods inherited from NSObject
(id)	+ alloc

(Class)	+ class

(void)	+ initialize

(void)	+ load

(id)	+ new

Public Class Methods inherited from <NSKeyValueBindingCreation>
(void)	+ exposeBinding:

Public Class Methods inherited from <NSSecureCoding>
(BOOL)	+ supportsSecureCoding:

Detailed Description

Defines the coordinate system of a plot.

A plot space determines the mapping between data coordinates and device coordinates in the plot area.

Method Documentation

◆ addCategory:forCoordinate:

- (void) addCategory:	(nonnull NSString *)	category
forCoordinate:	(CPTCoordinate)	coordinate

Add a new category name for the given coordinate.

Category names must be unique for each coordinate. Adding the same name more than once has no effect.

Parameters

category	The category name.
coordinate	The axis coordinate.

◆ categoriesForCoordinate:

- (nonnull CPTStringArray *) categoriesForCoordinate: (CPTCoordinate) coordinate

Returns a list of all category names for the given coordinate.

Parameters

coordinate The axis coordinate.

Returns: An array of category names.

◆ categoryForCoordinate:atIndex:

- (nullable NSString *) categoryForCoordinate:	(CPTCoordinate)	coordinate
atIndex:	(NSUInteger)	idx

Returns the category name for the given coordinate at the given index in the list of category names.

Parameters

coordinate	The axis coordinate.
idx	The index in the list of category names.

Returns: The category name.

◆ doublePrecisionPlotPoint:numberOfCoordinates:forEvent: [1/2]

- (void) doublePrecisionPlotPoint:	(nonnull double *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count
forEvent:	(nonnull CPTNativeEvent *__unused)	event

implementation

Converts the interaction point of an OS event to the data coordinate space.

Parameters

plotPoint	A c-style array of data point coordinates (as `double` values).
count	The number of coordinate values in the `plotPoint` array.
event	The event.

Provided by category CPTPlotSpace(AbstractMethods).

◆ doublePrecisionPlotPoint:numberOfCoordinates:forEvent: [2/2]

- (void) doublePrecisionPlotPoint:	(nonnull double *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count
forEvent:	(nonnull CPTNativeEvent *)	event

Provided by category CPTPlotSpace(AbstractMethods).

◆ doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint: [1/2]

- (void) doublePrecisionPlotPoint:	(nonnull double *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count
forPlotAreaViewPoint:	(CGPoint __unused)	point

implementation

Converts a point given in drawing coordinates to the data coordinate space.

Parameters

plotPoint	A c-style array of data point coordinates (as `double` values).
count	The number of coordinate values in the `plotPoint` array.
point	The drawing coordinates of the data point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint: [2/2]

- (void) doublePrecisionPlotPoint:	(nonnull double *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count
forPlotAreaViewPoint:	(CGPoint)	point

Provided by category CPTPlotSpace(AbstractMethods).

◆ indexOfCategory:forCoordinate:

- (NSUInteger) indexOfCategory:	(nonnull NSString *)	category
forCoordinate:	(CPTCoordinate)	coordinate

Returns the index of the given category name in the list of category names for the given coordinate.

Parameters

category	The category name.
coordinate	The axis coordinate.

Returns: The category index.

◆ init

- (nonnull instancetype) init

Initializes a newly allocated CPTPlotSpace object.

The initialized object will have the following properties:

Returns: The initialized object.

Reimplemented in CPTXYPlotSpace.

◆ initWithCoder:

- (nullable instancetype) initWithCoder: (nonnull NSCoder *) coder

Returns an object initialized from data in a given unarchiver.

Parameters

coder An unarchiver object.

Returns: An object initialized from data in a given unarchiver.

◆ insertCategory:forCoordinate:atIndex:

- (void) insertCategory:	(nonnull NSString *)	category
forCoordinate:	(CPTCoordinate)	coordinate
atIndex:	(NSUInteger)	idx

Add a new category name for the given coordinate at the given index in the list of category names.

Category names must be unique for each coordinate. Adding the same name more than once has no effect.

Parameters

category	The category name.
coordinate	The axis coordinate.
idx	The index in the list of category names.

◆ plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates: [1/2]

- (CGPoint) plotAreaViewPointForDoublePrecisionPlotPoint:	(nonnull double *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count

implementation

Converts a data point to plot area drawing coordinates.

Parameters

plotPoint	A c-style array of data point coordinates (as `double` values).
count	The number of coordinate values in the `plotPoint` array.

Returns: The drawing coordinates of the data point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates: [2/2]

- (CGPoint) plotAreaViewPointForDoublePrecisionPlotPoint:	(nonnull double *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForEvent: [1/2]

- (CGPoint) plotAreaViewPointForEvent: (nonnull CPTNativeEvent *__unused) event

implementation

Converts the interaction point of an OS event to plot area drawing coordinates.

Parameters

event The event.

Returns: The drawing coordinates of the point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForEvent: [2/2]

- (CGPoint) plotAreaViewPointForEvent: (nonnull CPTNativeEvent *) event

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForPlotPoint: [1/2]

- (CGPoint) plotAreaViewPointForPlotPoint: (nonnull CPTNumberArray *cpt_unused) plotPoint

implementation

Converts a data point to plot area drawing coordinates.

Parameters

plotPoint An array of data point coordinates (as NSNumber values).

Returns: The drawing coordinates of the data point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForPlotPoint: [2/2]

- (CGPoint) plotAreaViewPointForPlotPoint: (nonnull CPTNumberArray *) plotPoint

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForPlotPoint:numberOfCoordinates: [1/2]

- (CGPoint) plotAreaViewPointForPlotPoint:	(nonnull NSDecimal *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count

implementation

Converts a data point to plot area drawing coordinates.

Parameters

plotPoint	A c-style array of data point coordinates (as NSDecimal structs).
count	The number of coordinate values in the `plotPoint` array.

Returns: The drawing coordinates of the data point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotAreaViewPointForPlotPoint:numberOfCoordinates: [2/2]

- (CGPoint) plotAreaViewPointForPlotPoint:	(nonnull NSDecimal *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPoint:numberOfCoordinates:forEvent: [1/2]

- (void) plotPoint:	(nonnull NSDecimal *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count
forEvent:	(nonnull CPTNativeEvent *__unused)	event

implementation

Converts the interaction point of an OS event to the data coordinate space.

Parameters

plotPoint	A c-style array of data point coordinates (as NSDecimal structs).
count	The number of coordinate values in the `plotPoint` array.
event	The event.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPoint:numberOfCoordinates:forEvent: [2/2]

- (void) plotPoint:	(nonnull NSDecimal *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count
forEvent:	(nonnull CPTNativeEvent *)	event

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPoint:numberOfCoordinates:forPlotAreaViewPoint: [1/2]

- (void) plotPoint:	(nonnull NSDecimal *__unused)	plotPoint
numberOfCoordinates:	(NSUInteger cpt_unused)	count
forPlotAreaViewPoint:	(CGPoint __unused)	point

implementation

Converts a point given in plot area drawing coordinates to the data coordinate space.

Parameters

plotPoint	A c-style array of data point coordinates (as NSDecimal structs).
count	The number of coordinate values in the `plotPoint` array.
point	The drawing coordinates of the data point.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPoint:numberOfCoordinates:forPlotAreaViewPoint: [2/2]

- (void) plotPoint:	(nonnull NSDecimal *)	plotPoint
numberOfCoordinates:	(NSUInteger)	count
forPlotAreaViewPoint:	(CGPoint)	point

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPointForEvent: [1/2]

- (nullable CPTNumberArray *) plotPointForEvent: (nonnull CPTNativeEvent *__unused) event

implementation

Converts the interaction point of an OS event to the data coordinate space.

Parameters

event The event.

Returns: An array of data point coordinates (as NSNumber values).

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPointForEvent: [2/2]

- (nullable CPTNumberArray *) plotPointForEvent: (nonnull CPTNativeEvent *) event

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPointForPlotAreaViewPoint: [1/2]

- (nullable CPTNumberArray *) plotPointForPlotAreaViewPoint: (CGPoint __unused) point

implementation

Converts a point given in plot area drawing coordinates to the data coordinate space.

Parameters

point The drawing coordinates of the data point.

Returns: An array of data point coordinates (as NSNumber values).

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotPointForPlotAreaViewPoint: [2/2]

- (nullable CPTNumberArray *) plotPointForPlotAreaViewPoint: (CGPoint) point

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotRangeForCoordinate: [1/2]

- (nullable CPTPlotRange *) plotRangeForCoordinate: (CPTCoordinate __unused) coordinate

implementation

Gets the range of values for a given coordinate.

Parameters

coordinate The axis coordinate.

Returns: The range of values.

Provided by category CPTPlotSpace(AbstractMethods).

◆ plotRangeForCoordinate: [2/2]

- (nullable CPTPlotRange *) plotRangeForCoordinate: (CPTCoordinate) coordinate

Provided by category CPTPlotSpace(AbstractMethods).

◆ pointingDeviceCancelledEvent:

- (BOOL) pointingDeviceCancelledEvent: (nonnull CPTNativeEvent *) event

implementation

Informs the receiver that tracking of mouse moves has been cancelled for any reason.

If the receiver does not have a delegate, this method always returns NO. Otherwise, the -plotSpace:shouldHandlePointingDeviceCancelledEvent: delegate method is called. If it returns NO, this method returns YES to indicate that the event has been handled and no further processing should occur.

Parameters

event The OS event.

Returns: Whether the event was handled or not.

Reimplemented from <CPTResponder>.

◆ pointingDeviceDownEvent:atPoint:

- (BOOL) pointingDeviceDownEvent:	(nonnull CPTNativeEvent *)	event
atPoint:	(CGPoint)	interactionPoint

implementation

Informs the receiver that the user has pressed the mouse button.

If the receiver does not have a delegate, this method always returns NO. Otherwise, the -plotSpace:shouldHandlePointingDeviceDownEvent:atPoint: delegate method is called. If it returns NO, this method returns YES to indicate that the event has been handled and no further processing should occur.

Parameters

event	The OS event.
interactionPoint	The coordinates of the interaction.

Returns: Whether the event was handled or not.

Reimplemented from <CPTResponder>.

Reimplemented in CPTXYPlotSpace.

◆ pointingDeviceDraggedEvent:atPoint:

- (BOOL) pointingDeviceDraggedEvent:	(nonnull CPTNativeEvent *)	event
atPoint:	(CGPoint)	interactionPoint

implementation

Informs the receiver that the user has moved the mouse with the button pressed.

If the receiver does not have a delegate, this method always returns NO. Otherwise, the -plotSpace:shouldHandlePointingDeviceDraggedEvent:atPoint: delegate method is called. If it returns NO, this method returns YES to indicate that the event has been handled and no further processing should occur.

Parameters

event	The OS event.
interactionPoint	The coordinates of the interaction.

Returns: Whether the event was handled or not.

Reimplemented from <CPTResponder>.

Reimplemented in CPTXYPlotSpace.

◆ pointingDeviceUpEvent:atPoint:

- (BOOL) pointingDeviceUpEvent:	(nonnull CPTNativeEvent *)	event
atPoint:	(CGPoint)	interactionPoint

implementation

Informs the receiver that the user has released the mouse button.

If the receiver does not have a delegate , this method always returns NO. Otherwise, the -plotSpace:shouldHandlePointingDeviceUpEvent:atPoint: delegate method is called. If it returns NO, this method returns YES to indicate that the event has been handled and no further processing should occur.

Parameters

event	The OS event.
interactionPoint	The coordinates of the interaction.

Returns: Whether the event was handled or not.

Reimplemented from <CPTResponder>.

Reimplemented in CPTXYPlotSpace.

◆ removeAllCategories

- (void) removeAllCategories

Remove all categories for every coordinate.

◆ removeCategory:forCoordinate:

- (void) removeCategory:	(nonnull NSString *)	category
forCoordinate:	(CPTCoordinate)	coordinate

Removes the named category for the given coordinate.

Parameters

category	The category name.
coordinate	The axis coordinate.

◆ scaleBy:aboutPoint: [1/2]

- (void) scaleBy:	(CGFloat __unused)	interactionScale
aboutPoint:	(CGPoint __unused)	interactionPoint

implementation

Zooms the plot space equally in each dimension.

Parameters

interactionScale	The scaling factor. One (`1`) gives no scaling.
interactionPoint	The plot area view point about which the scaling occurs.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleBy:aboutPoint: [2/2]

- (void) scaleBy:	(CGFloat)	interactionScale
aboutPoint:	(CGPoint)	interactionPoint

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitEntirePlots: [1/2]

- (void) scaleToFitEntirePlots: (nullable CPTPlotArray *__unused) plots

implementation

Scales the plot ranges so that the plots just fit in the visible space.

Parameters

plots An array of the plots that have to fit in the visible area.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitEntirePlots: [2/2]

- (void) scaleToFitEntirePlots: (nullable CPTPlotArray *) plots

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitEntirePlots:forCoordinate:

- (void) scaleToFitEntirePlots:	(nullable CPTPlotArray *)	plots
forCoordinate:	(CPTCoordinate)	coordinate

Scales the plot range for the given coordinate so that the plots just fit in the visible space.

Parameters

plots	An array of the plots that have to fit in the visible area.
coordinate	The axis coordinate.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitPlots: [1/2]

- (void) scaleToFitPlots: (nullable CPTPlotArray *__unused) plots

implementation

Scales the plot ranges so that the plots just fit in the visible space.

Parameters

plots An array of the plots that have to fit in the visible area.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitPlots: [2/2]

- (void) scaleToFitPlots: (nullable CPTPlotArray *) plots

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleToFitPlots:forCoordinate:

- (void) scaleToFitPlots:	(nullable CPTPlotArray *)	plots
forCoordinate:	(CPTCoordinate)	coordinate

Scales the plot range for the given coordinate so that the plots just fit in the visible space.

Parameters

plots	An array of the plots that have to fit in the visible area.
coordinate	The axis coordinate.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleTypeForCoordinate: [1/2]

- (CPTScaleType) scaleTypeForCoordinate: (CPTCoordinate __unused) coordinate

implementation

Gets the scale type for a given coordinate.

Parameters

coordinate The axis coordinate.

Returns: The scale type.

Provided by category CPTPlotSpace(AbstractMethods).

◆ scaleTypeForCoordinate: [2/2]

- (CPTScaleType) scaleTypeForCoordinate: (CPTCoordinate) coordinate

Provided by category CPTPlotSpace(AbstractMethods).

◆ scrollWheelEvent:fromPoint:toPoint:

- (BOOL) scrollWheelEvent:	(nonnull CPTNativeEvent *)	event
fromPoint:	(CGPoint)	fromPoint
toPoint:	(CGPoint)	toPoint

implementation

Informs the receiver that the user has moved the scroll wheel.

If the receiver does not have a delegate, this method always returns NO. Otherwise, the -plotSpace:shouldHandleScrollWheelEvent:fromPoint:toPoint: delegate method is called. If it returns NO, this method returns YES to indicate that the event has been handled and no further processing should occur.

Parameters

event	The OS event.
fromPoint	The starting coordinates of the interaction.
toPoint	The ending coordinates of the interaction.

Returns: Whether the event was handled or not.

Reimplemented from <CPTResponder>.

Reimplemented in CPTXYPlotSpace.

◆ setCategories:forCoordinate:

- (void) setCategories:	(nullable CPTStringArray *)	newCategories
forCoordinate:	(CPTCoordinate)	coordinate

Replace all category names for the given coordinate with the names in the supplied array.

Parameters

newCategories	An array of category names.
coordinate	The axis coordinate.

◆ setPlotRange:forCoordinate: [1/2]

- (void) setPlotRange:	(nonnull CPTPlotRange *__unused)	newRange
forCoordinate:	(CPTCoordinate __unused)	coordinate

implementation

Sets the range of values for a given coordinate.

Parameters

newRange	The new plot range.
coordinate	The axis coordinate.

Provided by category CPTPlotSpace(AbstractMethods).

◆ setPlotRange:forCoordinate: [2/2]

- (void) setPlotRange:	(nonnull CPTPlotRange *)	newRange
forCoordinate:	(CPTCoordinate)	coordinate

Provided by category CPTPlotSpace(AbstractMethods).

◆ setScaleType:forCoordinate: [1/2]

- (void) setScaleType:	(CPTScaleType __unused)	newType
forCoordinate:	(CPTCoordinate __unused)	coordinate

implementation

Sets the scale type for a given coordinate.

Parameters

newType	The new scale type.
coordinate	The axis coordinate.

Provided by category CPTPlotSpace(AbstractMethods).

◆ setScaleType:forCoordinate: [2/2]

- (void) setScaleType:	(CPTScaleType)	newType
forCoordinate:	(CPTCoordinate)	coordinate

Provided by category CPTPlotSpace(AbstractMethods).

Property Documentation

◆ allowsUserInteraction

- (BOOL) allowsUserInteraction

readwritenonatomicassign

Determines whether user can interactively change plot range and/or zoom.

◆ delegate

- (nullable id< CPTPlotSpaceDelegate >) delegate

readwritenonatomicweak

The plot space delegate.

◆ graph

- (nullable CPTGraph *) graph

readwritenonatomicweak

The graph of the space.

◆ identifier

- (nullable id< NSCopying, NSCoding, NSObject >) identifier

readwritenonatomiccopy

An object used to identify the plot in collections.

◆ isDragging

- (BOOL) isDragging

readnonatomicassign

Returns YES when the user is actively dragging the plot space.

◆ numberOfCoordinates

- (NSUInteger) numberOfCoordinates

readnonatomicassign

The number of coordinate values that determine a point in the plot space.

The documentation for this class was generated from the following files:

Source/CPTPlotSpace.h
Source/CPTPlotSpace.m

Public Instance Methods

Properties

Additional Inherited Members

Detailed Description

Method Documentation

◆ addCategory:forCoordinate:

◆ categoriesForCoordinate:

◆ categoryForCoordinate:atIndex:

◆ doublePrecisionPlotPoint:numberOfCoordinates:forEvent: [1/2]

◆ doublePrecisionPlotPoint:numberOfCoordinates:forEvent: [2/2]

◆ doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint: [1/2]

◆ doublePrecisionPlotPoint:numberOfCoordinates:forPlotAreaViewPoint: [2/2]

◆ indexOfCategory:forCoordinate:

◆ init

◆ initWithCoder:

◆ insertCategory:forCoordinate:atIndex:

◆ plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates: [1/2]

◆ plotAreaViewPointForDoublePrecisionPlotPoint:numberOfCoordinates: [2/2]

◆ plotAreaViewPointForEvent: [1/2]

◆ plotAreaViewPointForEvent: [2/2]

◆ plotAreaViewPointForPlotPoint: [1/2]

◆ plotAreaViewPointForPlotPoint: [2/2]

◆ plotAreaViewPointForPlotPoint:numberOfCoordinates: [1/2]

◆ plotAreaViewPointForPlotPoint:numberOfCoordinates: [2/2]

◆ plotPoint:numberOfCoordinates:forEvent: [1/2]

◆ plotPoint:numberOfCoordinates:forEvent: [2/2]

◆ plotPoint:numberOfCoordinates:forPlotAreaViewPoint: [1/2]

◆ plotPoint:numberOfCoordinates:forPlotAreaViewPoint: [2/2]

◆ plotPointForEvent: [1/2]

◆ plotPointForEvent: [2/2]

◆ plotPointForPlotAreaViewPoint: [1/2]

◆ plotPointForPlotAreaViewPoint: [2/2]

◆ plotRangeForCoordinate: [1/2]

◆ plotRangeForCoordinate: [2/2]

◆ pointingDeviceCancelledEvent:

◆ pointingDeviceDownEvent:atPoint:

◆ pointingDeviceDraggedEvent:atPoint:

◆ pointingDeviceUpEvent:atPoint:

◆ removeAllCategories

◆ removeCategory:forCoordinate:

◆ scaleBy:aboutPoint: [1/2]

◆ scaleBy:aboutPoint: [2/2]

◆ scaleToFitEntirePlots: [1/2]

◆ scaleToFitEntirePlots: [2/2]

◆ scaleToFitEntirePlots:forCoordinate:

◆ scaleToFitPlots: [1/2]

◆ scaleToFitPlots: [2/2]

◆ scaleToFitPlots:forCoordinate:

◆ scaleTypeForCoordinate: [1/2]

◆ scaleTypeForCoordinate: [2/2]

◆ scrollWheelEvent:fromPoint:toPoint:

◆ setCategories:forCoordinate:

◆ setPlotRange:forCoordinate: [1/2]

◆ setPlotRange:forCoordinate: [2/2]

◆ setScaleType:forCoordinate: [1/2]

◆ setScaleType:forCoordinate: [2/2]

Property Documentation

◆ allowsUserInteraction

◆ delegate

◆ graph

◆ identifier

◆ isDragging

◆ numberOfCoordinates