Difference between revisions of "UUID2Channel"
m (Page formatting. A little naming consistancy. Commentary still needs cleanup?) |
m (Added a few links as well as a category) |
||
(2 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
[[Category:LSL Examples]] | |||
== Description == | == Description == | ||
Varying functions to convert a Key (UUID) to an Integer, for use as a [[:Category:LSL_Chat|LSL Chat]] Channel. | Varying functions to convert a Key ([[UUID]]) to an [[Integer]], for use as a [[:Category:LSL_Chat|LSL Chat]] Channel. | ||
== Method 1 - Simple == | == Method 1 - Simple == | ||
Well, I've figured out a more effective way of using the UUID2Channel method, you know. | Well, I've figured out a more effective way of using the {{mono|UUID2Channel}} method, you know. | ||
The one where you put a hexadecimal prefix | The one where you put a hexadecimal prefix in front of a person's UUID. Always generates | ||
negative integers, for safety. | negative integers, for safety. | ||
< | <syntaxhighlight lang="lsl2"> | ||
// Project Neox was here. | // Project Neox was here. | ||
// Web Gearbox was here too | // Web Gearbox was here too | ||
Line 16: | Line 17: | ||
return 0x80000000 | (integer)("0x"+(string)ID); | return 0x80000000 | (integer)("0x"+(string)ID); | ||
} | } | ||
</ | </syntaxhighlight> | ||
==== Improvement - App Key ==== | ==== Improvement - App Key ==== | ||
Line 26: | Line 27: | ||
As such you shouldn't really use the above function directly for channel IDs, if everyone did, it would negate the entire point of the function, the version below allows you to supply a random constant number to push the allocations around so we're not going to see same-user collisions between applications. | As such you shouldn't really use the above function directly for channel IDs, if everyone did, it would negate the entire point of the function, the version below allows you to supply a random constant number to push the allocations around so we're not going to see same-user collisions between applications. | ||
< | <syntaxhighlight lang="lsl2"> | ||
// modified channel generator to include per-application key, preventing cross-application collisions | // modified channel generator to include per-application key, preventing cross-application collisions | ||
// - Iain Maltz | // - Iain Maltz | ||
Line 33: | Line 34: | ||
return 0x80000000 | ((integer)("0x"+(string)ID) ^ App); | return 0x80000000 | ((integer)("0x"+(string)ID) ^ App); | ||
} | } | ||
</ | </syntaxhighlight> | ||
== Method 2 - Defined Base/Range == | == Method 2 - Defined Base/Range == | ||
< | <syntaxhighlight lang="lsl2"> | ||
// # Base/Range-Method Channel Generator. | // # Base/Range-Method Channel Generator. | ||
// > Allows for limiting the channel-band spread to only the amount needed for the application. | // > Allows for limiting the channel-band spread to only the amount needed for the application. | ||
Line 49: | Line 50: | ||
return (viBase+(viMult*(((integer)("0x"+(string)vkID)&0x7FFFFFFF)%viRange))); | return (viBase+(viMult*(((integer)("0x"+(string)vkID)&0x7FFFFFFF)%viRange))); | ||
} | } | ||
</ | </syntaxhighlight> |
Latest revision as of 17:31, 15 December 2022
Description
Varying functions to convert a Key (UUID) to an Integer, for use as a LSL Chat Channel.
Method 1 - Simple
Well, I've figured out a more effective way of using the UUID2Channel method, you know. The one where you put a hexadecimal prefix in front of a person's UUID. Always generates negative integers, for safety.
// Project Neox was here.
// Web Gearbox was here too
integer Key2Chan(key ID) {
return 0x80000000 | (integer)("0x"+(string)ID);
}
Improvement - App Key
This generates a unique channel ID from the input key, but also XOR's it with another value, this value should be application specific.
I encountered an issue where one of the commonly used combat meters (Gorean Meter I think) is using the exact function above to generate its personal channel numbers, and starts complaining - loudly (shouts) - if you put other data on the same channel (user is flooding their own channels!).
As such you shouldn't really use the above function directly for channel IDs, if everyone did, it would negate the entire point of the function, the version below allows you to supply a random constant number to push the allocations around so we're not going to see same-user collisions between applications.
// modified channel generator to include per-application key, preventing cross-application collisions
// - Iain Maltz
integer Key2AppChan(key ID, integer App) {
return 0x80000000 | ((integer)("0x"+(string)ID) ^ App);
}
Method 2 - Defined Base/Range
// # Base/Range-Method Channel Generator.
// > Allows for limiting the channel-band spread to only the amount needed for the application.
// - Faust Vollmar
integer uiKey2Range(key vkID, integer viBase, integer viRange)
{// # Result will be added or subtracted dependent on viBase being positive or negative, for intuitive results.
// > Example: -56000/1000 will result in -56000 to -56999, whereas 56000/1000 will result in 56000 to 56999
integer viMult = 1;
if( viBase < 0 ) { viMult = -1; }
return (viBase+(viMult*(((integer)("0x"+(string)vkID)&0x7FFFFFFF)%viRange)));
}