b3dPickedY

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

This function retrieves hit Y position. Pick sequence: (1) Call b3dCameraPick/EntityPick/LinePick to perform ray-cast, (2) Call b3dPickedY (and X/Z) 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). Y-axis convention: returned value in user space (+Y up), hit position calculated in world coordinates. 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, check height), (4) Cursor projection (show 3D cursor at picked position), (5) Terrain height (get terrain height at picked position). 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/Z retrieve X and Z coordinates, b3dPickedEntity checks if hit occurred, b3dPickedNX/NY/NZ retrieve surface normal at hit point, b3dCameraPick/EntityPick/LinePick perform picking.