br_pick3d_cbfn
BrScenePick3D()
82
. It is called for each model actor in an actor hierarchy whose bounds intersect a given bounds with respect to a particular actor's co-ordinate space.
typedef
fwproto.h
for a precise declaration)
int br_pick3d_cbfn(br_actor*, const br_model*, const br_material*, const br_matrix34*, const br_bounds*, void*) 3D pick
BrScenePick3D()
82
.
For a function that calls a call-back for each model actor whose bounds intersect a ray from view-point through a particular screen pixel, see BrScenePick3D()
82.
br_pick2d_cbfn
268
for a similar 2D call-back.
See br_model_custom_cbfn
247 for details of functions (used from within rendering call-backs) that can convert model co-ordinates into screen co-ordinates, e.g.
BrPointToScreenXY()
251.
Specification
Description:
An application defined call-back function that is called by CBFnPick3D()
BrScenePick3D()
82. It is called for each model actor whose bounds intersect a given bounds with respect to a particular actor's co-ordinate space (see
BrScenePick3D()
82).
Declaration:
int BR_CALLBACK CBFnPick3D(br_actor* a, const br_model* model, const br_material* material, const br_matrix34* transform, const br_bounds* bounds, void* arg)
Arguments:
br_actor * a
Pointer to model actor whose model bounds intersect the specified bounds.
const br_model * model
Pointer to model whose bounds intersect the pick ray.
const br_material * material
Pointer to the default material attributed to the model actor that may be used by the model (may be an inherited material).
const br_matrix34 * transform
A pointer to a matrix transforming the intersecting actor's model co-ordinates into the co-ordinate space of the reference actor (as supplied to BrScenePick3D()
82).
const br_bounds * bounds
A pointer to the original bounds (in the reference actor's co-ordinate space).
void * arg
The corresponding value specified in the call of BrScenePick3D()
82
that invoked this call-back.
Preconditions: BRender has completed initialisation. A model's bounds intersect the bounds in the reference actor's co-ordinate space.
Effects: Behaviour is up to the application.
Example: Possible uses include:
br_model_custom_cbfn
247
, br_renderbounds_cbfn
307
, br_pick2d_cbfn
268
.