Function

SecTransformFindByName

Finds a member of a transform group by its name.

Declaration

SecTransformRef SecTransformFindByName(SecGroupTransformRef transform, CFStringRef name);

Parameters

transform

The transform group to be searched.

name

The name of the transform to be found.

Return Value

The transform group member, or NULL if the member was not found.

Discussion

When a transform instance is created you give it a unique name. This name can be used to find that instance in a group. While it is possible to use the SecTransformSetAttribute function to change a transform's name after creating it, this is not recommended because doing so causes the SecTransformFindByName function to misbehave.

See Also

Transform Groups

SecTransformCreateGroupTransform

Creates an object that acts as a container for a set of connected transforms.

SecGroupTransformRef

A Core Foundation type that represents a container holding a group of transforms.

SecGroupTransformGetTypeID

Returns the Core Foundation type ID for a transform group container.