25.1 Creation

Empty fz_text objects can be created using the fz_new_text call:

/* 
   fz_new_text: Create a new empty fz_text object. 
 
   Throws exception on failure to allocate. 
*/ 
fz_text *fz_new_text(fz_context *ctx);

Additional references can be taken/released in the usual manner:

/* 
   fz_keep_text: Add a reference to an fz_text. 
 
   text: text object to keep a reference to. 
 
   Return the same text pointer. 
*/ 
fz_text *fz_keep_text(fz_context *ctx, const fz_text *text); 
 
/* 
   fz_drop_text: Drop a reference to the object, freeing 
   if if is the last one. 
 
   text: Object to drop the reference to. 
*/ 
void fz_drop_text(fz_context *ctx, const fz_text *text);