1     Definition 2     Functional Requirements 3     Syntax
4     Semantics 5    Conformance Testing 6     Performance Assessment

1      Definition

A Data Type including:

  1. Visual Data perceptible by a visual device or visible to a human when rendered.
  2. Descriptive Data regarding Sub-Types, Formats and Attributes of the Visual Data (optionally).

2      Functional Requirements

A Visual Object may include:

  1. The ID of a Virtual Space (M-Instance) where it is or is intended to be located.
  2. The ID of the Visual Object.
  3. The ID(s) of Parent Object(s) supporting two cases:
    1. The Parent Object has spawned two (or more) Objects.
    2. Two (or more) Parent Objects have merged into one.
  4. The Space-Time information of Parent Objects in an M-Instance.
  5. The Space-Time information of the Visual Data in an M-Instance.
  6. The Visual Data Qualifier.
  7. The Visual Data Annotations, including:
    1. Annotation
    2. Annotation Space-Time
    3. Process Action ID
  8. The Visual Object-specific Data:
    1. Visual Data Qualifier.
    2. Visual Data Annotation.
    3. Visual Data length in Bytes.
    4. Visual Data URI.

3      Syntax

https://schemas.mpai.community/OSD/V1.2/data/VisualObject.json

4      Semantics

Label Size Description
Header N1 Bytes Visual Object Header
– Standard-VisualObject 9 Bytes The characters “OSD-VIO-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.
VisualObjectID N5 Bytes Identifier of the Visual Object.
ParentVisualObjects[] N6 Bytes Identifier(s) of Parent Visual Objects.
– ParentVisualObjectID N7 Bytes Identifier of a Parent Visual Object.
ParentVisualDataSpaceTime N8 Bytes SpaceTime of a Parent Visual Object.
VisualDataSpace-Time N9 Bytes Space-Time info of Visual Data.
VisualDataQualifier N10 Bytes Qualifier of Visual Data.
VisualDataAnnotations[] N11 Bytes Annotations of Visual Data
– Annotation N12 Bytes ID of Annotation
– AnnotationSpaceTime N13 Bytes Where/when Annotation is attached.
– ProcessActionID N14 Bytes What is possible to do with the Annotation
VisualDataLength N15 Bytes Number of Bytes of Visual Data
VisualDataURI N16 Bytes URI of Data of Visual Data
DescrMetadata N17 Bytes Descriptive Metadata

5     Conformance Testing

A Data instance Conforms with Visual Object (OSD-VIO) V1.2 if:

  1. The Data validates against the Visual Object’s JSON Schema.
  2. All Data in the Visual Object’s JSON Schema
    1. Have the specified type
    2. Validate against their JSON Schemas
    3. Conform with their Data Qualifiers, if present.

6     Performance Assessment