^{ItemsDistribution 1.0}

The ItemsDistribution plugin allows to distribute objects on the set of a 3D room.
Each item is an instance. Each instance comes with an anchor associated to a list of positions.
The server randomly chooses one of the positions to place the object on the clients.
The object disappears on all the clients when one of them takes it (or passes over it). The object reappears on all the clients for a while (timeout).
An angle of rotation can be defined to animate the object when it is displayed on the clients.

Figure 1 : ItemsDistribution plugin interface

(1) : item name => name of the item (mesh) in the 3D scene. ATTENTION ! This name must absolutely correspond to the mesh name in the m3d file. It is essentiel to edit the concerned .m3d file to extract the right name :

(2) : M3d file => .m3d filename of the item

(3) : M3d texture file => texture of the item, deefined in the .m3d file

(4) : Scale => parameter used to resize the object in the 3D scene. (In % : < 100 to reduce and > 100 to enlarge the object)

(5) : Rotation delay => Used to apply a defined angle of rotation to the object for each step. Rotation delay parameter defines the duration between each step of rotation (in milliseconds (ms) ; mean value = 40).

(6) : Rotation angle => angle of rotation for each step of rotation (in SCOL angular units ; mean value = 1000).

(7) : Action distance => minimum distance from the item to the avatar, so that avatar can take the item. (Mean value = 60)

(8) : Item appearance timeout => time length before the object be back in the scene, after have been taken by an avatar. (In milliseconds)

• First of all, define the available positions of the item, using the menu "Positions"
  
• Move the camera to the choosen position and click on " AddCamPos ", then name explicitly this position.
  
• In the menu "Anchors", create an anchor for each item, name it explicitly and add positions related to it.
  
• In the menu "Instances", create an instance for each item. Each instance must be associated with the anchor which corresponds to it.
  
• When instance is created, editor can be opened by double-clicking on it.
  
• The instance editor allows to define its behavior parameters.