OsSetProjectionParams

From OpenSimulator

(Difference between revisions)
Jump to: navigation, search
(Scripts improvement)
Line 4: Line 4:
 
|delay=0
 
|delay=0
 
|additional_info=This function was added in 0.7.2-post-fixes, linkset variant added 2019, April 18
 
|additional_info=This function was added in 0.7.2-post-fixes, linkset variant added 2019, April 18
−
|function_syntax= osSetProjectionParams(integer projection, key texture, float fov, float focus, float amb)<br />
+
|function_syntax= osSetProjectionParams(integer projection, key texture, float fov, float focus, float ambiance)<br />
−
osSetProjectionParams(integer linknumber, integer projection, key texture, float fov, float focus, float amb)<br />
+
osSetProjectionParams(integer linknumber, integer projection, key texture, float fov, float focus, float ambiance)<br />
−
osSetProjectionParams(key prim, integer projection, key texture, float fov, float focus, float amb)
+
osSetProjectionParams(key prim, integer projection, key texture, float fov, float focus, float ambiance)
 +
|description= Sets a prim projector parameters, argument projection is TRUE(1) or FALSE(0). The prim can be the host prim on first variant, a prim on the linkset or a prim with giving UUID.<br>
 +
In last case Threat level is high and controlled by Allow_osSetProjectionParams. The other cases have no threat level check. Note that you may need to set the prim light also.
 
|ossl_example=These examples will control the projection map in the host prim, a prim on the linkset and another prim identified by it's uuid.  
 
|ossl_example=These examples will control the projection map in the host prim, a prim on the linkset and another prim identified by it's uuid.  
−
<source lang="lsl">// Exemple of osSetProjectionParams control this prim
+
<source lang="lsl">
−
 
+
//
 +
// osSetProjectionParams Script Example
 +
// Author: djphil
 +
//
 +
 
// These variables correspond to the settings found in the "Features" tab of the build editor
 
// These variables correspond to the settings found in the "Features" tab of the build editor
−
float FOV = 1.5;        // Values 0.00 - 3.00
+
float fov = 1.5;        // Range 0.0 to 3.0
−
float Focus = 15.0;    // Values -20.00 - 20.00
+
float focus = 15.0;    // Range -20.0 to 20.0
−
float Ambiance = 0.4;  // Values 0.00 - 1.00
+
float ambiance = 0.4;  // Range 0.0 yp 1.0
  
−
// UUID of the texture to project
+
// Can be texture's name in object's inventory or the texture uuid
−
key Texture = "b4c6b075-4940-4270-bb10-d293fd6f8091";
+
key texture = "00000000-0000-2222-3333-100000001001";
  
−
integer Power;
+
integer power;
 +
 
 +
integer check_values()
 +
{
 +
    if (fov < 0.0 || fov > 3.0) return FALSE;
 +
    if (focus < -20.0 || focus > 20.0) return FALSE;
 +
    if (ambiance < 0.0 || ambiance > 1.0) return FALSE;
 +
    return TRUE;
 +
}
  
 
default
 
default
Line 24: Line 38:
 
     state_entry()
 
     state_entry()
 
     {
 
     {
−
         llSay(PUBLIC_CHANNEL, "Script running ...");
+
         if (check_values() == TRUE)
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Touch to see osSetProjectionParams usage.");
 +
            llSay(PUBLIC_CHANNEL, "fov: " + (string)fov);
 +
            llSay(PUBLIC_CHANNEL, "focus: " + (string)focus);
 +
            llSay(PUBLIC_CHANNEL, "ambiance: " + (string)ambiance);
 +
            llSay(PUBLIC_CHANNEL, "texture: " + (string)texture);
 +
        }
 +
 
 +
        else
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Invalid value(s) detected ...");
 +
        }
 
     }
 
     }
−
+
 
 
     touch_start(integer number)  
 
     touch_start(integer number)  
 
     {
 
     {
−
         Power =! Power;
+
         power = !power;
−
         osSetPrimitiveParams(llGetKey(),[PRIM_POINT_LIGHT, Power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
+
         osSetPrimitiveParams(llGetKey(),[PRIM_POINT_LIGHT, power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
−
         osSetProjectionParams(Power, Texture, FOV, Focus, Ambiance);
+
         osSetProjectionParams(power, texture, fov, focus, ambiance);
 
     }
 
     }
−
}</source>
+
}
−
 
+
</source>
−
<source lang="lsl">// Exemple of osSetProjectionParams control the prim with link number 2
+
'''With a link number:'''
−
 
+
<source lang="lsl">
 +
//
 +
// osSetProjectionParams Script Example
 +
// Author: djphil
 +
//
 +
 
// These variables correspond to the settings found in the "Features" tab of the build editor
 
// These variables correspond to the settings found in the "Features" tab of the build editor
−
float FOV = 1.5;        // Values 0.00 - 3.00
+
float fov = 1.5;        // Range 0.0 to 3.0
−
float Focus = 15.0;    // Values -20.00 - 20.00
+
float focus = 15.0;    // Range -20.0 to 20.0
−
float Ambiance = 0.4;  // Values 0.00 - 1.00
+
float ambiance = 0.4;  // Range 0.0 yp 1.0
  
−
// UUID of the texture to project
+
// uuid of other primitive that we want to control
−
key Texture = "b4c6b075-4940-4270-bb10-d293fd6f8091";
+
key target = "8c68368f-3a10-4473-abb3-f4e91a42013e";
  
−
// Link number of prim that we want to control
+
// Can be texture's name in object's inventory or the texture uuid
−
integer Link = 2;
+
key texture = "00000000-0000-2222-3333-100000001001";
  
−
integer Power;
+
integer power;
  
−
default
+
integer check_values()
 
{
 
{
−
     state_entry()
+
     if (fov < 0.0 || fov > 3.0) return FALSE;
−
    {
+
     if (focus < -20.0 || focus > 20.0) return FALSE;
−
        llSay(PUBLIC_CHANNEL, "Script running ...");
+
    if (ambiance < 0.0 || ambiance > 1.0) return FALSE;
−
     }
+
    return TRUE;
−
+
}
−
    touch_start(integer number)
+
−
    {
+
−
        Power =! Power;
+
−
        llSetLinkPrimitiveParamsFast(Link, [PRIM_POINT_LIGHT, Power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
+
−
        osSetProjectionParams(Link, Power, Texture, FOV, Focus, Ambiance);
+
−
    }
+
−
}</source>
+
−
 
+
−
<source lang="lsl">// Exemple of osSetProjectionParams control the remote prim
+
−
 
+
−
// These variables correspond to the settings found in the "Features" tab of the build editor
+
−
float FOV = 1.5;        // Values 0.00 - 3.00
+
−
float Focus = 15.0;    // Values -20.00 - 20.00
+
−
float Ambiance = 0.4;   // Values 0.00 - 1.00
+
−
 
+
−
// UUID of the texture to project
+
−
key Texture = "b4c6b075-4940-4270-bb10-d293fd6f8091";
+
−
 
+
−
// UUID of other prim that we want to control
+
−
key Remote = "1721c368-e468-46da-bcae-0bdd3e647a2b";
+
−
 
+
−
integer Power;
+
  
 
default
 
default
Line 84: Line 93:
 
     state_entry()
 
     state_entry()
 
     {
 
     {
−
         llSay(PUBLIC_CHANNEL, "Script running ...");
+
         if (check_values() == TRUE)
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Touch to see osSetProjectionParams usage.");
 +
            llSay(PUBLIC_CHANNEL, "fov: " + (string)fov);
 +
            llSay(PUBLIC_CHANNEL, "focus: " + (string)focus);
 +
            llSay(PUBLIC_CHANNEL, "ambiance: " + (string)ambiance);
 +
            llSay(PUBLIC_CHANNEL, "target: " + (string)target);
 +
            llSay(PUBLIC_CHANNEL, "texture: " + (string)texture);
 +
        }
 +
 
 +
        else
 +
        {
 +
            llSay(PUBLIC_CHANNEL, "Invalid value(s) detected ...");
 +
        }
 
     }
 
     }
−
+
 
 
     touch_start(integer number)  
 
     touch_start(integer number)  
 
     {
 
     {
−
         Power =! Power;
+
         power = !power;
−
         osSetPrimitiveParams(Remote,[PRIM_POINT_LIGHT, Power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
+
         osSetPrimitiveParams(target,[PRIM_POINT_LIGHT, power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
−
         osSetProjectionParams(Remote, Power, Texture, FOV, Focus, Ambiance);
+
         osSetProjectionParams(target, power, texture, fov, focus, ambiance);
 
     }
 
     }
−
}</source>
+
}
−
 
+
</source>
−
|description= Sets a prim projector parameters, argument projection is TRUE(1) or FALSE(0). The prim can be the host prim on first variant, a prim on the linkset or a prim with giving UUID. In last case Threat level is high and controlled by Allow_osSetProjectionParams. The other cases have no threat level check. Note that you may need to set the prim light also.
+
|additional_info=
−
|
+
 
}}
 
}}

Revision as of 02:44, 22 December 2020

Languages Languages: 

En.png English

osSetProjectionParams(integer projection, key texture, float fov, float focus, float ambiance)

osSetProjectionParams(integer linknumber, integer projection, key texture, float fov, float focus, float ambiance)
osSetProjectionParams(key prim, integer projection, key texture, float fov, float focus, float ambiance)

Sets a prim projector parameters, argument projection is TRUE(1) or FALSE(0). The prim can be the host prim on first variant, a prim on the linkset or a prim with giving UUID.

In last case Threat level is high and controlled by Allow_osSetProjectionParams. The other cases have no threat level check. Note that you may need to set the prim light also.

Threat Level No threat level specified
Permissions No permissions specified
Extra Delay 0 seconds
Example(s)
These examples will control the projection map in the host prim, a prim on the linkset and another prim identified by it's uuid. 
//
// osSetProjectionParams Script Example
// Author: djphil
//
 
// These variables correspond to the settings found in the "Features" tab of the build editor
float fov = 1.5;        // Range 0.0 to 3.0
float focus = 15.0;     // Range -20.0 to 20.0
float ambiance = 0.4;   // Range 0.0 yp 1.0
 
// Can be texture's name in object's inventory or the texture uuid
key texture = "00000000-0000-2222-3333-100000001001";
 
integer power;
 
integer check_values()
{
    if (fov < 0.0 || fov > 3.0) return FALSE;
    if (focus < -20.0 || focus > 20.0) return FALSE;
    if (ambiance < 0.0 || ambiance > 1.0) return FALSE;
    return TRUE;
}
 
default
{
    state_entry()
    {
        if (check_values() == TRUE)
        {
            llSay(PUBLIC_CHANNEL, "Touch to see osSetProjectionParams usage.");
            llSay(PUBLIC_CHANNEL, "fov: " + (string)fov);
            llSay(PUBLIC_CHANNEL, "focus: " + (string)focus);
            llSay(PUBLIC_CHANNEL, "ambiance: " + (string)ambiance);
            llSay(PUBLIC_CHANNEL, "texture: " + (string)texture);
        }
 
        else
        {
            llSay(PUBLIC_CHANNEL, "Invalid value(s) detected ...");
        }
    }
 
    touch_start(integer number) 
    {
        power = !power;
        osSetPrimitiveParams(llGetKey(),[PRIM_POINT_LIGHT, power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
        osSetProjectionParams(power, texture, fov, focus, ambiance);
    }
}

With a link number: 

//
// osSetProjectionParams Script Example
// Author: djphil
//
 
// These variables correspond to the settings found in the "Features" tab of the build editor
float fov = 1.5;        // Range 0.0 to 3.0
float focus = 15.0;     // Range -20.0 to 20.0
float ambiance = 0.4;   // Range 0.0 yp 1.0
 
// uuid of other primitive that we want to control
key target = "8c68368f-3a10-4473-abb3-f4e91a42013e";
 
// Can be texture's name in object's inventory or the texture uuid
key texture = "00000000-0000-2222-3333-100000001001";
 
integer power;
 
integer check_values()
{
    if (fov < 0.0 || fov > 3.0) return FALSE;
    if (focus < -20.0 || focus > 20.0) return FALSE;
    if (ambiance < 0.0 || ambiance > 1.0) return FALSE;
    return TRUE;
}
 
default
{
    state_entry()
    {
        if (check_values() == TRUE)
        {
            llSay(PUBLIC_CHANNEL, "Touch to see osSetProjectionParams usage.");
            llSay(PUBLIC_CHANNEL, "fov: " + (string)fov);
            llSay(PUBLIC_CHANNEL, "focus: " + (string)focus);
            llSay(PUBLIC_CHANNEL, "ambiance: " + (string)ambiance);
            llSay(PUBLIC_CHANNEL, "target: " + (string)target);
            llSay(PUBLIC_CHANNEL, "texture: " + (string)texture);
        }
 
        else
        {
            llSay(PUBLIC_CHANNEL, "Invalid value(s) detected ...");
        }
    }
 
    touch_start(integer number) 
    {
        power = !power;
        osSetPrimitiveParams(target,[PRIM_POINT_LIGHT, power, <1.0, 1.0, 1.0>, 1.0, 5.0, 0.5]);
        osSetProjectionParams(target, power, texture, fov, focus, ambiance);
    }
}


Retrieved from "http://opensimulator.org/index.php?title=OsSetProjectionParams&oldid=50463"
Personal tools
General
About This Wiki