b3dPickedZ

Returns Z coordinate of pick hit position from last pick operation (0.0 if no hit). Takes no parameters. Returns world Z position (Double) from g_lastPickResult.position.z. Reads result from last b3dCameraPick, b3dEntityPick, or b3dLinePick call. World-space Z coordinate of ray intersection.

This function retrieves hit Z position. Pick sequence: (1) Call b3dCameraPick/EntityPick/LinePick to perform ray-cast, (2) Call b3dPickedZ (and X/Y) to get hit position coordinates. Hit position: world-space coordinates where ray intersected entity surface (for sphere picks: point on sphere surface, for box picks: point on box face, for polygon picks: point on triangle). Use cases: (1) Impact effects (spawn bullet impact at picked position), (2) Decals (place decal at picked position), (3) Object placement (snap object to picked position), (4) Cursor projection (show 3D cursor at picked position), (5) Debug visualization (draw marker at hit point). Common pattern: if b3dPickedEntity() > 0 then hitX=b3dPickedX(), hitY=b3dPickedY(), hitZ=b3dPickedZ(), spawn impact effect. Typical usage: retrieve hit position after successful pick (entity > 0), use for spawning effects or placing objects. No hit: returns 0.0 if no entity picked (check b3dPickedEntity first), position is undefined if pick missed. Result storage: g_lastPickResult.position populated by pick functions with world-space hit point. Performance: O(1) read (simple global variable access, instant). Related: b3dPickedX/Y retrieve X and Y coordinates, b3dPickedEntity checks if hit occurred, b3dPickedNX/NY/NZ retrieve surface normal at hit point, b3dCameraPick/EntityPick/LinePick perform picking.