b3dPickedEntity

Returns picked entity handle from last pick operation (0=no hit). Takes no parameters. Returns entity handle (Int) from g_lastPickResult.entity, or 0 if no entity picked. Reads result from last b3dCameraPick, b3dEntityPick, or b3dLinePick call. Simple getter for picked entity.

This function retrieves pick result. Pick sequence: (1) Call b3dCameraPick (screen picking), b3dEntityPick (forward ray), or b3dLinePick (arbitrary ray), (2) Call b3dPickedEntity to get entity handle, (3) If result > 0 then entity was hit, if result = 0 then no hit. Result storage: g_lastPickResult is global variable reset at start of each pick operation (starts as all zeros), populated with closest hit if any entity intersected ray, remains as zeros if no intersection. Use cases: (1) Mouse clicking (check which object clicked), (2) Shooting (check which enemy hit), (3) Interaction (check which object player looking at), (4) Selection (check which object under cursor), (5) Trigger detection (check if ray hit trigger volume). Common pattern: b3dCameraPick(cam, mouseX, mouseY), entity=b3dPickedEntity(), if entity > 0 then handle click on entity. Typical usage: call after every pick operation to determine if anything was hit, use entity handle for game logic (damage, selection, interaction). No hit: returns 0 if ray missed all entities, ray hit only non-pickable entities (pickMode=0 and not enabled), or invalid pick parameters. Multiple picks: each pick operation resets g_lastPickResult (only stores most recent pick result), don't mix results from different pick calls. Performance: O(1) read (simple global variable access, instant). Related: b3dPickedX/Y/Z retrieve hit position, b3dPickedNX/NY/NZ retrieve surface normal, b3dPickedTime retrieves distance along ray, b3dCameraPick/EntityPick/LinePick perform picking.