b3dSetMidHandleDetailTexture

Sets detail texture pivot to center (0.5, 0.5) for centered rotation/scaling. Takes entityHandle (mesh entity), textureHandle (detail texture to configure). Returns nothing. Convenience wrapper calling b3dSetHandleDetailTexture(entityHandle, textureHandle, 0.5, 0.5).

This function centers detail pivot. Centered pivot: sets detail texture pivot to (0.5, 0.5), middle of texture for balanced rotation/scaling, most common pivot for natural detail transformations, equivalent to manual b3dSetHandleDetailTexture(entityHandle, textureHandle, 0.5, 0.5). Layer identification: textureHandle identifies which detail layer to configure, searches material.detailTextureIndex[0-2] for matching handle, sets pivot for that specific layer only, no effect if textureHandle not found in material. Use cases: (1) Centered detail rotation (spinning overlays, rotating decals), (2) Centered detail scaling (pulsing detail layers, zoom effects), (3) Balanced detail transformations (rotation + scale from center), (4) Common default (natural pivot for most detail effects), (5) Convenience (simpler than manual 0.5, 0.5 entry). Common patterns: spinning detail decal = center pivot + rotate in loop, pulsing overlay = center pivot + animated scale, multi-layer animation = center all layers for balanced motion, UI detail effects = centered rotation for icons/badges. Typical usage: call after adding detail texture to entity, use before rotating or scaling detail texture, most common pivot choice for detail effects, saves typing compared to manual pivot setting, improves code readability. Implementation: simple wrapper calling b3dSetHandleDetailTexture(entityHandle, textureHandle, 0.5, 0.5), no additional logic or overhead, purely for convenience, equivalent functionality to manual setting. Why centered pivot: detail rotation around center keeps texture balanced, detail scaling from center grows/shrinks symmetrically, matches expectations for spinning/zooming effects, corner pivots only for special effects (hinges, specific features). Material targeting: affects same settings as b3dSetHandleDetailTexture, sets material.detailTextureRotationPivot[layer_index] to (0.5, 0.5), handles material override, surface-based meshes, loaded meshes, propagates via material dirty flag. Default behavior: without setting pivot, detail default is (0, 0), not ideal for rotation (spins around corner), b3dSetMidHandleDetailTexture fixes with one call, apply before first rotation/scale for expected behavior. Multi-layer support: can set different pivots for different detail layers, example: layer 0 centered, layer 1 corner, call function separately for each textureHandle, each layer independent. Examples: centered rotating overlay, spinning detail logo, zooming detail badge, pulsing detail indicator, balanced scaling effects, symmetric detail animations. Performance: same minimal cost as b3dSetHandleDetailTexture (wrapper call), negligible overhead (function call + field set), triggers material upload (once per frame if changing). Validation: inherits validation from b3dSetHandleDetailTexture, checks entity is valid mesh, searches for textureHandle in detail layers, no effect if texture not found. Alternative: manually calling b3dSetHandleDetailTexture(entity, texture, 0.5, 0.5), b3dSetMidHandleDetailTexture more readable, recommended for common centered case, reduces code clutter. Related: b3dSetHandleDetailTexture sets custom detail pivot (any UV coordinates), b3dSetMidHandleBaseTexture centers base texture pivot (base version), b3dRotateDetailTexture rotates detail around pivot (uses this pivot), b3dScaleDetailTexture scales detail from pivot (uses this pivot).