llCollisionSound

From Second Life Wiki
(Redirected from Llcollisionsound)
Jump to navigation Jump to search

Summary

Function: llCollisionSound( string impact_sound, float impact_volume );
0.0 Forced Delay
10.0 Energy

Suppress default collision sounds, replace default impact sounds with impact_sound at the volume impact_volume

• string impact_sound a sound in the inventory of the prim this script is in, a UUID of a sound or an empty string
• float impact_volume between 0.0 (silent) and 1.0 (loud) (0.0 <= impact_volume <= 1.0)

If impact_sound is an empty string then the collision sound is suppressed.
If impact_volume is set to zero the collision particles are suppressed.

Caveats

  • If impact_sound is not an empty string and...
    • impact_sound is missing from the prim's inventory and it is not a UUID or it is not a sound then an error is shouted on DEBUG_CHANNEL.
  • If impact_sound is a UUID then there are no new asset permissions consequences for the object.
    • The resulting object develops no new usage restrictions that might have occurred if the asset had been placed in the prims inventory.
  • If this function is used to suppress collision sounds, NO sound will be generated even if the suppressed object collides with an unsuppressed object (there will be no sound from the unsuppressed object either).

Examples

//Play Sound When Collision Occurs With Other Object Or An AGENT
//Creator: TonyH Wrangler

string sound = "ed124764-705d-d497-167a-182cd9fa2e6c"; //uuid or name of item in inventory

default
{
    state_entry()
    {
        llCollisionSound(sound, 1.0);
    }
}

See Also

Events

•  collision_start
•  collision
•  collision_end

Functions

•  llCollisionFilter
•  llCollisionSprite

Deep Notes

History

Footnotes

  1. ^ Early release notes were not very accurate or thorough, they sometimes included information about features added in previous releases or failed to include information about features added in that release.

Signature

function void llCollisionSound( string impact_sound, float impact_volume );