Core Animation Function Reference

Overview

Functions by Task

Timing Functions

• CACurrentMediaTime

Transform Functions

• CATransform3DIsIdentity
• CATransform3DEqualToTransform
• CATransform3DMakeTranslation
• CATransform3DMakeScale
• CATransform3DMakeRotation
• CATransform3DTranslate
• CATransform3DScale
• CATransform3DRotate
• CATransform3DConcat
• CATransform3DInvert
• CATransform3DMakeAffineTransform
• CATransform3DIsAffine
• CATransform3DGetAffineTransform

Functions

CACurrentMediaTime

Returns the current absolute time, in seconds.

CFTimeInterval CACurrentMediaTime (void);

CATransform3DConcat

Concatenate 'b' to 'a' and return the result: t' = a * b.

CATransform3D CATransform3DConcat (CATransform3D a, CATransform3D b);

CATransform3DEqualToTransform

Returns a Boolean value that indicates whether the two transforms are exactly equal.

bool CATransform3DEqualToTransform (CATransform3D a, CATransform3D b);

CATransform3DGetAffineTransform

Returns the affine transform represented by 't'. If 't' can not be exactly represented as an affine transform the returned value is undefined.

CGAffineTransform CATransform3DGetAffineTransform (CATransform3D t);

CATransform3DInvert

Invert 't' and return the result. Returns the original matrix if 't' has no inverse.

CATransform3D CATransform3DInvert (CATransform3D t);

CATransform3DIsAffine

Returns true if 't' can be exactly represented by an affine transform.

bool CATransform3DIsAffine (CATransform3D t);

CATransform3DIsIdentity

Returns a Boolean value that indicates whether the transform is the identity transform.

bool CATransform3DIsIdentity (CATransform3D t);

CATransform3DMakeAffineTransform

Return a transform with the same effect as affine transform 'm'.

CATransform3D CATransform3DMakeAffineTransform (CGAffineTransform m)

CATransform3DMakeRotation

Returns a transform that rotates by 'angle' radians about the vector '(x, y, z)'. If the vector has length zero the identity transform is returned.

CATransform3D CATransform3DMakeRotation (CGFloat angle, CGFloat x, CGFloat y, CGFloat z);

CATransform3DMakeScale

Returns a transform that scales by `(sx, sy, sz)': * t' = [sx 0 0 0; 0 sy 0 0; 0 0 sz 0; 0 0 0 1].

CATransform3D CATransform3DMakeScale (CGFloat sx, CGFloat sy,
   CGFloat sz);

CATransform3DMakeTranslation

Returns a transform that translates by '(tx, ty, tz)'. t' = [1 0 0 0; 0 1 0 0; 0 0 1 0; tx ty tz 1].

CATransform3D CATransform3DMakeTranslation (CGFloat tx, CGFloat ty, CGFloat tz)

CATransform3DRotate

Rotate 't' by 'angle' radians about the vector '(x, y, z)' and return the result. If the vector has zero length the behavior is undefined: t' = rotation(angle, x, y, z) * t.

CATransform3D CATransform3DRotate (CATransform3D t, CGFloat angle, CGFloat x, CGFloat y, CGFloat z)

CATransform3DScale

Scale 't' by '(sx, sy, sz)' and return the result: t' = scale(sx, sy, sz) * t.

CATransform3D CATransform3DScale (CATransform3D t, CGFloat sx, CGFloat sy, CGFloat sz)

CATransform3DTranslate

Translate 't' by '(tx, ty, tz)' and return the result: t' = translate(tx, ty, tz) * t.

CATransform3D CATransform3DTranslate (CATransform3D t, CGFloat tx, CGFloat ty, CGFloat tz);