`br_table_find_cbfn`

The Call-Back Function

This type defines a function, registered with BrTableFindHook()293, to be called when BrTableFind()292 or BrTableFindMany()293 fail to find any table.

The `typedef`

(See fwproto.h for a precise declaration)

br_pixelmap* br_table_find_cbfn(const char*) Find (when BrTableFind() fails)

Specification

`CBFnTableFind()`

Description:

An application defined call-back function used when BrTableFind()292 or BrTableFindMany()293 fail.

Declaration:

br_pixelmap* BR_CALLBACK CBFnTableFind(const char* name)

Arguments:

const char * name

The search pattern supplied to BrTableFind()292 or BrTableFindMany()293 that did not match any table.

Preconditions:

BRender has completed initialisation. No table has an identifier that successfully matches the search pattern.

Effects:

Application defined.

Result:

br_pixelmap *

Either return an existing table that is deemed appropriate for the search pattern, or Null if there isn't one. This value will be returned by BrTableFind()292 or BrTableFindMany()293.

Remarks:

This could either be used to supply a default table or to create a table. If tables were created on demand, then this function could search another list of available tables (but not yet created) and see if the pattern matched any of them, if it did, one of them could be registered and returned. Note that there is no way to supply more than one table.

br_table_find_cbfn

The Call-Back Function

The typedef

Specification

CBFnTableFind()

`br_table_find_cbfn`

The `typedef`

`CBFnTableFind()`