DetachTextCelCCB

Releases text-related resources, retaining rendered pixels.

Synopsis

CCB * DetachTextCelCCB (TextCel *tCel)

Description

Releases resources required for rendering new text into a cel, but retains pixels already rendered. In addition to freeing resources, this function removes the reference to the FontDescriptor. You can safely unload a font after calling this function, and still retain text you've already rendered for drawing to the screen later when needed.

Use DeleteCel() or DeleteCelList() to dispose of the CCB and cel data buffer when you no longer need them. You cannot use DeleteTextCel() on the cel after calling this function, since the TextCel structure has been discarded.

Arguments

tCel: Pointer to a TextCel structure.

Return Value

CCB: CCB for which resources were released.

Associated Files

lib3do.lib, textlib.h