Skip to content

Latest commit

 

History

History
322 lines (184 loc) · 7.66 KB

video.schema.md

File metadata and controls

322 lines (184 loc) · 7.66 KB

Video Schema

https://ns.adobe.com/xdm/assets/video

The video class is for video assets, i.e. assets that consist of moving pictures and, optionally, sound.

Abstract Extensible Status Identifiable Custom Properties Additional Properties Defined In
Can be instantiated Yes Experimental No Forbidden Permitted assets/video.schema.json

Schema Hierarchy

  • Video https://ns.adobe.com/xdm/assets/video

Video Examples

{
  "repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ac",
  "xmp:createDate": "2017-09-26T15:52:25+00:00",
  "repo:createDate": "2017-09-26T15:52:25+00:00",
  "xdm:repositoryCreatedBy": "lars",
  "xmp:modifyDate": "2017-09-26T15:52:25+00:00",
  "repo:modifyDate": "2017-09-26T15:52:25+00:00",
  "xdm:repositoryLastModifiedBy": "2017-09-26T15:52:25+00:00",
  "repo:version": "15",
  "repo:size": 1632418,
  "xdm:path": "here",
  "repo:etag": "15",
  "tiff:imageLength": 2160,
  "tiff:imageWidth": 3840,
  "xdm:aspectRatio": 1.77777777778,
  "xdm:extent": 11700000,
  "xdm:videoFrameRate": "NTSC"
}
{
  "repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ad",
  "xmp:createDate": "2017-09-26T15:52:25+00:00",
  "repo:createDate": "2017-09-26T15:52:25+00:00",
  "xdm:repositoryCreatedBy": "lars",
  "xmp:modifyDate": "2017-09-26T15:52:25+00:00",
  "repo:modifyDate": "2017-09-26T15:52:25+00:00",
  "xdm:repositoryLastModifiedBy": "2017-09-26T15:52:25+00:00",
  "repo:version": "15",
  "repo:size": 1632418,
  "xdm:path": "here",
  "repo:etag": "15",
  "tiff:imageLength": 2160,
  "tiff:imageWidth": 3840,
  "xdm:aspectRatio": 1.77777777778,
  "xdm:extent": 10920000,
  "xdm:videoFrameRate": "f48s1"
}

Video Properties

Property Type Required Defined by
repo:createdBy string Optional Asset
repo:etag string Required Asset
repo:id string Required Asset
repo:modifiedBy string Optional Asset
repo:size integer Required Asset
repo:version string Required Asset
tiff:imageLength integer Optional Simple Rectangular Area
tiff:imageWidth integer Optional Simple Rectangular Area
xdm:aspectRatio number Optional Simple Rectangular Area
xdm:extent integer Optional Video (this schema)
xmpDM:videoFrameRate string Optional Video (this schema)
* any Additional this schema allows additional properties

repo:createdBy

ID of the user who initiated the action that caused the resource to be created in the repository.

repo:createdBy

  • is optional
  • type: string
  • defined in Asset

repo:createdBy Type

string

repo:etag

ETag

An ETag is an HTTP response header returned by an HTTP/1.1 compliant web server used to determine change in content of a resource at a given URL.

repo:etag

  • is required
  • type: string
  • defined in Asset

repo:etag Type

string

repo:id

A unique identifier given to every addressable asset in a given repository.

repo:id

  • is required
  • type: string
  • defined in Asset

repo:id Type

string

repo:id Example

"urn:aaid:sc:US:6dc33479-13ca-4b19-b25d-c805eff8a69e"

repo:modifiedBy

ID of the user who initiated the action that most recently caused the resource to be modified in the repository.

repo:modifiedBy

  • is optional
  • type: string
  • defined in Asset

repo:modifiedBy Type

string

repo:size

Size

Size of the asset in bytes.

repo:size

  • is required
  • type: integer
  • defined in Asset

repo:size Type

integer

  • minimum value: 0

repo:version

The version ID of the piece of content. It will be generated both on explicit and implicit save or upload.

repo:version

  • is required
  • type: string
  • defined in Asset

repo:version Type

string

tiff:imageLength

Length

Height in pixels. To maintain continuity with the XMP and TIFF standards, the height of an image or video is specified in the property imageLength. The duration of the video (also commonly called length) is specified in the property extent.

tiff:imageLength

tiff:imageLength Type

integer

  • minimum value: 0

tiff:imageWidth

Width

Width in pixels.

tiff:imageWidth

tiff:imageWidth Type

integer

  • minimum value: 0

xdm:aspectRatio

Aspect Ratio

Describes the proportional relationship between the width and the height. To determine the aspect ratio, divide width by height. Media that have an aspect ratio smaller than one are in landscape format, media that have an aspect ratio greater than one are in portrait format.

xdm:aspectRatio

xdm:aspectRatio Type

number

  • minimum value: 0

xdm:extent

Duration

The duration of the video in milliseconds. This property is inspired by dc:extent. However, dc:extent does not specify units. core:extent is always an integer and describes the duration in milliseconds.

xdm:extent

  • is optional
  • type: integer
  • defined in this schema

xdm:extent Type

integer

xmpDM:videoFrameRate

Frame Rate

The video frame rate in frames per second (FPS). Predefined values include: -24 -NTSC -PAL Other values must include f and the integer value of the frame rate. Optionally, s and the integer value of the rate basis may be included.

These examples show common video and audio frame rates:

  • Film at 24 fps (frame rate = 24, rate basis = 1): f24
  • Speech-to-text in milliseconds (frame rate = 1000, rate basis = 1): f1000
  • NTSC at 29.97 fps (frame rate = 30000, rate basis = 1001): f30000s1001.

xmpDM:videoFrameRate

  • is optional
  • type: string
  • defined in this schema

xmpDM:videoFrameRate Type

string

All instances must conform to this regular expression (test examples here):

((f\d+(s\d+)?)|PAL|NTSC|24)