Difference between revisions of "LlCollisionSound"
Jump to navigation
Jump to search
m |
|||
| (16 intermediate revisions by 5 users not shown) | |||
| Line 1: | Line 1: | ||
{{LSL_Function | {{LSL_Function | ||
|inject-2={{LSL_Function/inventory|impact_sound|uuid=true|type=sound|volume=impact_volume|empty=*}} | |||
|func_id=160|func_sleep=0.0|func_energy=10.0 | |func_id=160|func_sleep=0.0|func_energy=10.0 | ||
|func=llCollisionSound | |func=llCollisionSound | ||
|p1_type=string|p1_name=impact_sound | |p1_type=string|p1_name=impact_sound | ||
|p2_type=float|p2_name=impact_volume | |p2_type=float|p2_name=impact_volume | ||
|func_footnote=If | |func_footnote=If {{LSLP|impact_sound}} is an empty string then the collision sound is suppressed.<br/> | ||
|func_desc=Suppress default collision sounds, replace default impact sounds with | If {{LSLP|impact_volume}} is set to zero the collision particles are suppressed. | ||
|func_desc=Suppress default collision sounds, replace default impact sounds with {{LSLP|impact_sound}} at the volume {{LSLP|impact_volume}} | |||
|return_text | |return_text | ||
|spec | |spec | ||
|caveats | |caveats=*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). | ||
|constants | |constants | ||
|examples | |examples=<source lang="lsl2">//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); | |||
} | |||
}</source> | |||
|helpers | |helpers | ||
|also_functions | |also_functions= | ||
|also_events | {{LSL DefineRow||[[llCollisionFilter]]|}} | ||
{{LSL DefineRow||[[llCollisionSprite]]|}} | |||
|also_events= | |||
{{LSL DefineRow||[[collision_start]]|}} | |||
{{LSL DefineRow||[[collision]]|}} | |||
{{LSL DefineRow||[[collision_end]]|}} | |||
|also_articles | |also_articles | ||
|also_tests | |also_tests | ||
| Line 21: | Line 38: | ||
|cat1=Collision | |cat1=Collision | ||
|cat2=Sound | |cat2=Sound | ||
|cat3 | |cat3=Object | ||
|cat4 | |cat4 | ||
|history={{LSL Added|0.2.0|remote=http://secondlife.wikia.com/wiki/Version_0.2.0}} | |||
}} | }} | ||
Latest revision as of 23:30, 21 January 2015
| LSL Portal | Functions | Events | Types | Operators | Constants | Flow Control | Script Library | Categorized Library | Tutorials |
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
- llCollisionSound Added in SL 0.2.0[1]
Footnotes
- ^ 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 ); |