<- Go to ToC ProcessActions->

1 Definition 2 Functional Requirements 3 Syntax 4 Semantics

1 Definition

The Action of a User requesting a Location Service to modify the characteristics of an Item:
1. Resize the Item by Rx, Ry, Rz along the Item’s axes, if an Item with Visual properties.
2. Modify the Personal Status (if a Persona).
3. Modify the attributes of:
3.1 A Light Source: SourceType, ColourInfo, Intensity
3.2 An Audio Source: SourceType
3.3 A Basic Visual or 3D Object: Mass, Gravity Property, Texture
4. Modify the perceptibility status of  an Item to all Users having Rights to perceive the Item and to the User having Rights to the Item.
5. Grant Rights to the MM-PropertyChanged Item based on Model Rights.

2 Functional Requirements

The Convert Process Action includes:

In the request

– The Item whose Data is to be MM-PropertyChanged.

– The M-Location where the Item to be MM-PropertyChanged is MM-Embedded.

– One or more of:

– The Item’s  Rx, Ry, Rz resize factors along the Item’s axes.

– Personal Status to be displayed by a Persona.

– One of more of:

– A Light Source’s SourceType, ColourInfo, and Intensity.

– An Audio Source’s Diffuseness, Directional Patterns, Shape, and Size.

– An Object’s Audio Characteristics: Reflectivity, Reverberation, Diffusion, and Absorption.

– A Basic Visual Object’s or Basic 3D Object’s Mass, Gravity Property, and Texture.

– Change an Object’s perceptibility status.

– The Model Rights to the MM-PropertyChanged Item.

– A Transaction if requested by the Location Service Service.

In the response

– The Converted Item.

– The Rights per the Model Rights if request is successful.

– The Process receiving the Converted Item.

3 Syntax

https://schemas.mpai.community/MMM4/V2.1/data/MMPropertyChange.json

4 Semantics

Label Size Description
Header N1 Bytes Convert Process Action Header
– Standard-MMPropertyChangePA 9 Bytes The characters “MMM-MPP-V”
– Version N2 Bytes Major version – 1 or 2 characters
– Dot-separator 1 Byte The character “.”
– Subversion N3 Bytes Minor version – 1 or 2 characters
MInstanceID N4 Bytes Identifier of M-Instance.
MEnvironmentID N5 Bytes Identifier of M-Environment.
MMPropCngPAData N6 Bytes Data included in the Convert Process Action.
– Time N7 Bytes Time of PA request emission and Time of PA request execution.
– S-Complements N8 Bytes Source Complements.
  – Nil ItemID N9 Bytes Item to be MM-PropertyChanged.
  – At MLocationID
 N10 Bytes M-Location where the Item is MM-Embedded.
  – With ResizeFactors N11 Bytes The Item’s  Rx, Ry, Rz resize factors along the Item’s axes.
  – With PersonalStatus N12 Bytes Personal Status to be displayed by the Item if Persona.
  – With LightSourceType N13 Bytes Source Type, Colour Info, and Intensity.
  – With AudioSourceType N14 Bytes Reflectivity, Reverberation, Diffusion, and Absorption.
  – With AudioObjChar N15 Bytes Reflectivity, Reverberation, Diffusion, and Absorption.
  – With   MassGravityTexture N16 Bytes Mass, Affected by Gravity, Texture Map.
  – With PerceptStatus
 N17 Bytes Boolean: 0 if object is imperceptible, 1 if otherwise.
  – With ModelRights N18 Bytes Rights requested to the MM-PropertyChanged Item.
  – With Transaction N19 Bytes Transaction made to Location Service if requested.
– D-Complements N20 Bytes Destination Complements.
  – Nil ItemID N21 Bytes Item MM-PropertyChanged.
  – With Rights N22 Bytes Actual Rights based on Model Rights if PA Request is accepted.
  – At ProcessID N23 Bytes The Process receiving the MM-PropertyChanged Item.
– ErrorMessage N24 Bytes Set of Error Messages.
  – FaultyPA N25 Bytes Faulty Request.
  – IncID N26 Bytes Incorrect ID.
  – InsRights N27 Bytes Insufficient Rights.
  – MLocOOR N28 Bytes M-Location out of range.
DescMetadata N29 Bytes Descriptive Metadata

<- Go to ToC ProcessActions->