Instance Property

stageTransition

The transition value for the stage of a pressure gesture event of type NSEventTypePressure.

Declaration

@property(readonly) CGFloat stageTransition;

Discussion

This property is specifically intended to provide a value for the transition animation between the stages of a pressure gesture event.

Gesture events of type NSEventTypePressure go through stages, and transitions occur between these stages. This property indicates a transition value between the current stage and the next or prior stage.

This value is distinct from pressure. It immediately resets to 0 as soon as a stage transition occurs. However, this value does not then immediately begin to fluctuate. The value only starts to change as a new stage begins to approach. It then continues to rise or fall throughout the transition, until that new stage is reached.

As pressure increases for the gesture and a new stage approaches, this property provides a value between 0 and 1, indicating the approach of the next stage. When pressure is reduced for the gesture and a new stage is approached, this property provides a value between 0 and -1, indicating the approach of the current stage’s release.

See Also

Getting Pressure Information

pressure

A value from 0.0 through 1.0 indicating the degree of pressure applied to an appropriate input device.

stage

A value of 0, 1, or 2, indicating the stage of a gesture event of type NSEventTypePressure.

pressureBehavior

The pressure behavior and progression for an event of type NSEventTypePressure.

NSPressureBehavior

These constants describe the behavior and progression of a pressure gesture.