BRender Technical Reference Manual:4 Data Structures (Alphabetical Reference):br_resclass_find_cbfn
Next|Prev|Up
The Call-Back Function
Specification
CBFnResClassFind()

br_resclass_find_cbfn


The Call-Back Function

This type defines a function, registered with BrResClassFindHook()
328, to be called when BrResClassFind()328 or BrResClassFindMany()328 fail to find any resource class.

(See fwproto.h for a precise declaration)

The typedef

br_resource_class * br_resclass_find_cbfn(const char *) Find (when BrResClassFind() fails)

Specification


CBFnResClassFind()

Description:
An application defined call-back function used when BrResClassFind()
328 or BrResClassFindMany()328 fail.

Declaration:
br_resource_class* BR_CALLBACK CBFnResClassFind(const char* name)

Arguments:
const char * name

The search pattern supplied to BrResClassFind()328 or BrResClassFindMany()328 that did not match any resource class.

Preconditions:
BRender has completed initialisation. No resource class has an identifier that successfully matches the search pattern.

Effects:
Application defined.

Result:
br_resource_class *

Either return an existing resource class that is deemed appropriate for the search pattern, or Null if there isn't one. This value will be returned by BrResClassFind()328 or BrResClassFindMany()328.

Remarks:
This could either be used to supply a default resource or to create a resource class. If some resource classes were created on demand, then this function could search another list of available resource classes (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 resource class.

See Also:
BrResClassFind()328, BrResClassFindMany()328, BrResClassFindHook()328.



Generated with CERN WebMaker