br_resclass_find_cbfn
BrResClassFindHook()
328
, to be called when BrResClassFind()
328
or BrResClassFindMany()
328
fail to find any resource class.
(See fwproto.h
for a precise declaration)
typedef
br_resource_class * br_resclass_find_cbfn(const char *)
Find (when BrResClassFind()
fails)
Specification
Description:
An application defined call-back function used when CBFnResClassFind()
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
.