LlSetCameraParams

Template:Needs Translation/LSL/de Template:Needs Translation/LSL/es Template:Needs Translation/LSL/el Template:Needs Translation/LSL/he Template:Needs Translation/LSL/it Template:Needs Translation/LSL/ko Template:Needs Translation/LSL/nl Template:Needs Translation/LSL/hu Template:Needs Translation/LSL/no Template:Needs Translation/LSL/da Template:Needs Translation/LSL/sv Template:Needs Translation/LSL/tr Template:Needs Translation/LSL/pl Template:Needs Translation/LSL/pt Template:Needs Translation/LSL/ru Template:Needs Translation/LSL/th Template:Needs Translation/LSL/uk Template:Needs Translation/LSL/zh-Hans Template:Needs Translation/LSL/zh-Hant

/LSL

SetCameraParams

llSetCameraParams

Summary

Function: llSetCameraParams( list rules );

313	Function ID
0.0	Forced Delay
10.0	Energy

Sets multiple camera parameters at once.

• list

rules

–

Format is [ rule1, data1, rule2, data2 . . . rulen, datan ]

To run this function the script must request the PERMISSION_CONTROL_CAMERA permission with llRequestPermissions.

Rule		Parameter	Default	Value Range	Description
CAMERA_ACTIVE	12	integer isActive	FALSE	TRUE or FALSE	Turns on or off scripted control of the camera.
CAMERA_BEHINDNESS_ANGLE	8	float degrees	10.0	0 to 180	Sets the angle in degrees within which the camera is not constrained by changes in target rotation.
CAMERA_BEHINDNESS_LAG	9	float seconds	0.0	0 to 3	Sets how strongly the camera is forced to stay behind the target if outside of behindness angle.
CAMERA_DISTANCE	7	float meters	3.0	0.5 to 50	Sets how far away the camera wants to be from its target.
CAMERA_FOCUS	17	vector position	n/a	n/a	Sets camera focus (target position) in region coordinates.
CAMERA_FOCUS_LAG	6	float seconds	0.1	0 to 3	How much the camera lags as it tries to aim towards the target.
CAMERA_FOCUS_LOCKED	22	integer isLocked	FALSE	TRUE or FALSE	Locks the camera focus so it will not move.
CAMERA_FOCUS_OFFSET	1	vector meters	<0.0,0.0,0.0>	<-10,-10,-10> to <10,10,10>	Adjusts the camera focus position relative to the target.
CAMERA_FOCUS_THRESHOLD	11	float meters	1.0	0 to 4	Sets the radius of a sphere around the camera's target position within which its focus is not affected by target motion.
CAMERA_PITCH	0	float degrees	0.0	-45 to 80	Adjusts the angular amount that the camera aims straight ahead vs. straight down, maintaining the same distance; analogous to 'incidence'."
CAMERA_POSITION	13	vector position	n/a	n/a	Sets camera position in region coordinates.
CAMERA_POSITION_LAG	5	float seconds	0.1	0 to 3	How much the camera lags as it tries to move towards its 'ideal' position.
CAMERA_POSITION_LOCKED	21	integer isLocked	FALSE	TRUE or FALSE	Locks the camera position so it will not move.
CAMERA_POSITION_THRESHOLD	10	float meters	1.0	0 to 4	Sets the radius of a sphere around the camera's ideal position within which it is not affected by target motion.

Caveats

Permissions

Do not depend upon the auto-grant status of permissions. Always use the run_time_permissions event. If the script lacks the permission PERMISSION_CONTROL_CAMERA, the script will shout an error on DEBUG_CHANNEL and the operation fails (but the script continues to run). The PERMISSION_CONTROL_CAMERA permission is automatically revoked when the avatar stands up from or detaches the object, and any scripted camera parameters are automatically cleared.

• Camera control currently (server 1.38) only supported for attachments and objects on which you are sitting. An attempt otherwise will result in an error being shouted on DEBUG_CHANNEL.
• Scripted camera parameters will not set for the agent if the last controls they used were their camera controls. Manual camera control will override set parameters too.
• A CAMERA_FOCUS_OFFSET of <0, 0, 0> will always look at the same position as returned by llGetPos() for the avatar
  • When seated, this is also the position of "Avatar Center" when hover height is 0
  • When standing, this has a shape-dependent z-offset from "Avatar Center". (currently investigating Tapple Gao (talk))

All Issues ~ Search JIRA for related Bugs

Examples

You can either set the camera in region relative coordinates or you can make the camera follow your avatar.

Region relative coordinates, an example:

lookAtMe( integer perms )
{
    if ( perms & PERMISSION_CONTROL_CAMERA )
    {
        vector camPos = llGetPos() + (relCamP * llGetRot() * turnOnChair) ;
        vector camFocus = llGetPos() ;
        llClearCameraParams(); // reset camera to default
        llSetCameraParams([
            CAMERA_ACTIVE, 1, // 1 is active, 0 is inactive
            CAMERA_FOCUS, camFocus, // region relative position
            CAMERA_FOCUS_LOCKED, TRUE, // (TRUE or FALSE)
            CAMERA_POSITION, camPos, // region relative position
            CAMERA_POSITION_LOCKED, TRUE // (TRUE or FALSE)
        ]);
    }
}

Note that Focus and Position are both locked. This first example makes the camera look at camFocus from camPos.

Camera follow avatar, an example:

lookAtMe( integer perms )
{
    if ( perms & PERMISSION_CONTROL_CAMERA )
    {
        llClearCameraParams(); // reset camera to default
        llSetCameraParams([
            CAMERA_ACTIVE, 1, // 1 is active, 0 is inactive
            CAMERA_BEHINDNESS_ANGLE, 30.0, // (0 to 180) degrees
            CAMERA_BEHINDNESS_LAG, 0.0, // (0 to 3) seconds
            CAMERA_DISTANCE, 10.0, // ( 0.5 to 10) meters
          //CAMERA_FOCUS, <0,0,5>, // region relative position
            CAMERA_FOCUS_LAG, 0.05 , // (0 to 3) seconds
            CAMERA_FOCUS_LOCKED, FALSE, // (TRUE or FALSE)
            CAMERA_FOCUS_THRESHOLD, 0.0, // (0 to 4) meters
            CAMERA_PITCH, 10.0, // (-45 to 80) degrees
          //CAMERA_POSITION, <0,0,0>, // region relative position
            CAMERA_POSITION_LAG, 0.0, // (0 to 3) seconds
            CAMERA_POSITION_LOCKED, FALSE, // (TRUE or FALSE)
            CAMERA_POSITION_THRESHOLD, 0.0, // (0 to 4) meters
            CAMERA_FOCUS_OFFSET, <2.0, 0.0, 0.0> // <-10,-10,-10> to <10,10,10> meters
        ]);
    }
}

Note that in this second example Focus and Position are NOT locked and not even set. This is appropriate for making the camera follow a pilot on a vehicle.

See Also

Events

•

run_time_permissions

–

Permission receiving event

Functions

•	llGetPermissions	–	Get the permissions granted
•	llGetPermissionsKey	–	Get the agent who granted permissions
•	llRequestPermissions	–	Request permissions
•	llClearCameraParams
•	llGetCameraPos
•	llGetCameraRot

Articles

•	Script permissions
•	FollowCam

Deep Notes

All Issues

~ Search JIRA for related Issues

		SCR-325	A		Damping Parameters for llSetCameraParams()
		SCR-326	A		CAMERA_FOCUS_TARGET and CAMERA_POSITION_TARGET parameters for llSetCameraParams()
		SCR-327	A		Improvements to llSetCameraParams()

Tests

•

llSetCameraParams Test

Signature
function void llSetCameraParams( list rules );