Difference between revisions of "LSL Protocol/Restrained Love Open Relay Group/camera"

From Second Life Wiki
Jump to navigation Jump to search
(Created page with "{{ ORG Restrained Life Relay Specs TOC }} = camera = STATUS: proposal version: 000 RECOMMENDED WITH: '''''vision''''' …")
 
Line 12: Line 12:
*!x-setcamera
*!x-setcamera
*!x-setcamera/clear
*!x-setcamera/clear
The purpose of this x-tension is to enable the relay to control the camera of the wearer. The following commands summarize the use of the camera generally used by RLV controllers.


==Description of !x-thirdview and !x-thirdview/clear==
==Description of !x-thirdview and !x-thirdview/clear==
Line 17: Line 19:
!x-thirdview forces the wearer of the relay to use mouselook mode. The interest of this command is to be able to force the wearer to use mouselook mode even in grid-wide mode.  
!x-thirdview forces the wearer of the relay to use mouselook mode. The interest of this command is to be able to force the wearer to use mouselook mode even in grid-wide mode.  


*The acknowledgment for !x-thirdview is either !x-thirdview,ok or !x-thirdview,ko, not @thirdview=add,ok or @thirdview=add,ko. Idem for !x-thirdview/clear.
*The acknowledgment for !x-thirdview is either !x-thirdview,ok or !x-thirdview,ko, not @thirdview=add,ok or @thirdview=add,ko.
*The acknowledgment for !x-thirdview/clear is either !x-thirdview/clear,ok or !x-thirdview/clear,ko, not @thirdview=add,ok or @thirdview=add,ko.


==Interaction with !x-vision==
==Interaction with !x-vision==
Line 25: Line 28:
==Description of !x-setcamera and !x-setcamera/clear==
==Description of !x-setcamera and !x-setcamera/clear==


The syntax of !x-setcamera follows the syntax of the LSL command llSetCameraParams(). So the syntax is  
This command requires for the script in the relay to have the PERMISSION_CONTROL_CAMERA. The syntax of !x-setcamera follows the syntax of the LSL command llSetCameraParams(). So the syntax is  


  !x-setcamera/INTEGER/FLOAT/FLOAT/FLOAT/FLOAT/INTEGER/VECTOR/FLOAT/FLOAT/VECTOR/FLOAT/INTEGER/FLOAT
  !x-setcamera/INTEGER/FLOAT/FLOAT/FLOAT/FLOAT/INTEGER/VECTOR/FLOAT/FLOAT/VECTOR/FLOAT/INTEGER/FLOAT


See http://lslwiki.net/lslwiki/wakka.php?wakka=llSetCameraParams for further details. When a parameter is the empty string, the default value must be used. So !x-setcamera/clear is equivalent to !x-setcamera/////////////. This command is a restriction, i.e. in ask mode, a permission must be granted. When several controllers send camera settings, a stack of settings is created and the last one is used. When the stack is empty, the wearer's camera goes back to default settings.
See http://lslwiki.net/lslwiki/wakka.php?wakka=llSetCameraParams for further details. When a parameter is the empty string, the default value must be used. So !x-setcamera/clear is equivalent to !x-setcamera/////////////. This command is a restriction, i.e. in ask mode, a permission must be granted. When several controllers send camera settings, a stack of settings is created and the last one is used. When the stack is empty, the wearer's camera goes back to default settings, i.e. llClearCameraParams() is executed.
 
==Description of !x-poscamera and !x-poscamera/clear==
 
This command requires for the script in the relay to have the PERMISSION_TRACK_CAMERA. The syntax of !x-poscamera is
!x-poscamera/FLOAT
It forces the wearer to keep the camera close to the avatar, the distance must not be greater than the float number given in parameter. The command !x-poscamera/0 is equivalent to !x-poscamera/clear. This command is a restriction, i.e. in ask mode, a permission must be granted. When several controllers send !x-poscamera, a stack of distances is created and the last one is used. When the stack is empty, the wearer's camera goes back to the default setting.

Revision as of 00:30, 22 July 2011

camera

STATUS: proposal

version: 000

RECOMMENDED WITH: vision

  • !x-thirdview, synonym of the Susan's relay command @thirdview=add/n
  • !x-thirdview/clear, synonym of the Susan's relay command @thirdview=rem/y
  • !x-setcamera
  • !x-setcamera/clear

The purpose of this x-tension is to enable the relay to control the camera of the wearer. The following commands summarize the use of the camera generally used by RLV controllers.

Description of !x-thirdview and !x-thirdview/clear

!x-thirdview forces the wearer of the relay to use mouselook mode. The interest of this command is to be able to force the wearer to use mouselook mode even in grid-wide mode.

  • The acknowledgment for !x-thirdview is either !x-thirdview,ok or !x-thirdview,ko, not @thirdview=add,ok or @thirdview=add,ko.
  • The acknowledgment for !x-thirdview/clear is either !x-thirdview/clear,ok or !x-thirdview/clear,ko, not @thirdview=add,ok or @thirdview=add,ko.

Interaction with !x-vision

When the wearer does not want to switch for mouselook mode, a blind command like !x-vision/<0'0'0>/1.0/TEXTURE_BLANK/1.0'1.0/0.0'0.0/0.0 will be executed by the relay itself until the wearer changes the mode.

Description of !x-setcamera and !x-setcamera/clear

This command requires for the script in the relay to have the PERMISSION_CONTROL_CAMERA. The syntax of !x-setcamera follows the syntax of the LSL command llSetCameraParams(). So the syntax is

!x-setcamera/INTEGER/FLOAT/FLOAT/FLOAT/FLOAT/INTEGER/VECTOR/FLOAT/FLOAT/VECTOR/FLOAT/INTEGER/FLOAT

See http://lslwiki.net/lslwiki/wakka.php?wakka=llSetCameraParams for further details. When a parameter is the empty string, the default value must be used. So !x-setcamera/clear is equivalent to !x-setcamera/////////////. This command is a restriction, i.e. in ask mode, a permission must be granted. When several controllers send camera settings, a stack of settings is created and the last one is used. When the stack is empty, the wearer's camera goes back to default settings, i.e. llClearCameraParams() is executed.

Description of !x-poscamera and !x-poscamera/clear

This command requires for the script in the relay to have the PERMISSION_TRACK_CAMERA. The syntax of !x-poscamera is

!x-poscamera/FLOAT

It forces the wearer to keep the camera close to the avatar, the distance must not be greater than the float number given in parameter. The command !x-poscamera/0 is equivalent to !x-poscamera/clear. This command is a restriction, i.e. in ask mode, a permission must be granted. When several controllers send !x-poscamera, a stack of distances is created and the last one is used. When the stack is empty, the wearer's camera goes back to the default setting.