Skip to content

Latest commit

 

History

History
473 lines (274 loc) · 10.4 KB

image.schema.md

File metadata and controls

473 lines (274 loc) · 10.4 KB

Image Schema

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

The Image class is for raster and vector image assets, including JPEG, PNG, SVG files

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

Schema Hierarchy

  • Image https://ns.adobe.com/xdm/assets/image

Image Example

{
  "repo:id": "urn:aaid:a:b:01234578-0123-ABCD-abcd-0123456789ab",
  "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": 768,
  "tiff:imageWidth": 1024,
  "xdm:aspectRatio": 1.3333333,
  "tiff:orientation": 1,
  "tiff:XResolution": {
    "tiff:numerator": 300,
    "tiff:denominator": 1
  }
}

Image Properties

Property Type Required Defined by
photoshop:ICCProfile string Optional Image (this schema)
photoshop:colorMode enum Optional Image (this schema)
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:XResolution object Optional Image (this schema)
tiff:YResolution object Optional Image (this schema)
tiff:imageLength integer Optional Simple Rectangular Area
tiff:imageWidth integer Optional Simple Rectangular Area
tiff:orientation integer Optional Image (this schema)
tiff:resolutionUnit enum Optional Image (this schema)
xdm:aspectRatio number Optional Simple Rectangular Area
* any Additional this schema allows additional properties

photoshop:ICCProfile

ICC Profile

The ICC color profile, such as AppleRGB, AdobeRGB1998.

photoshop:ICCProfile

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

photoshop:ICCProfile Type

string

photoshop:ICCProfile Known Values

Value Description
0 ColorMatchRGB
1 AppleRGB
2 AdobeRGB1998
3 JapanColor2002Newspaper
4 USSheetfedUncoated
5 JapanColor2001Uncoated
6 CoatedFOGRA27
7 UncoatedFOGRA29
8 USWebCoatedSWOP
9 JapanColor2001Coated
10 JapanWebCoated
11 WebCoatedFOGRA28
12 USWebUncoated
13 CoatedFOGRA39
14 USSheetfedCoated

photoshop:colorMode

Color Mode

The color mode or image mode determines how colors combine based on the number of channels in a color model. Different color modes result in different levels of color detail and file size. For instance, use CMYK color mode for images in a full-color print brochure, and use RGB color mode for images in web or e-mail to reduce file size while maintaining color integrity.

photoshop:colorMode

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

The value of this property must be equal to one of the known values below.

photoshop:colorMode Known Values

Value Description
0 Bitmap
1 Gray scale
2 Indexed color
3 RGB color
4 CMYK color
7 Multi-channel
8 Duotone
9 LAB color

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:XResolution

X-Resolution

Horizontal resolution in pixels per resolutionUnit.

tiff:XResolution

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

tiff:XResolution Type

object with following properties:

Property Type Required

tiff:YResolution

Y-Resolution

Vertical resolution in pixels per resolutionUnit.

tiff:YResolution

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

tiff:YResolution Type

object with following properties:

Property Type Required

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

tiff:orientation

Orientation

The orientation of the image. Following values are permitted:

  • 1 = Horizontal (normal)
  • 2 = Mirror horizontal
  • 3 = Rotate 180 degrees
  • 4 = Mirror vertical
  • 5 = Mirror horizontal and rotate 270 degrees clockwise
  • 6 = Rotate 90 degrees clockwise
  • 7 = Mirror horizontal and rotate 90 degrees clockwise
  • 8 = Rotate 270 degrees clockwise

tiff:orientation

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

tiff:orientation Type

integer

  • minimum value: 1
  • maximum value: 8

tiff:orientation Known Values

Value Description
1 Horizontal (normal)
2 Mirror horizontal
3 Rotate 180 degrees
4 Mirror vertical
5 Mirror horizontal and rotate 270 degrees clockwise
6 Rotate 90 degrees clockwise
7 Mirror horizontal and rotate 90 degrees clockwise
8 Rotate 270 degrees clockwise

tiff:resolutionUnit

Resolution Unit

Unit used for XResolution and YRresolution. Possible values are 2 (inches) and 3 (centimeters).

tiff:resolutionUnit

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

The value of this property must be equal to one of the known values below.

tiff:resolutionUnit Known Values

Value Description
2 inches
3 centimeters

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

Image Definitions

Property Type Group
tiff:denominator integer https://ns.adobe.com/xdm/assets/image#/definitions/rational
tiff:numerator integer https://ns.adobe.com/xdm/assets/image#/definitions/rational

tiff:denominator

Denominator

The denominator of a fraction

tiff:denominator

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

tiff:denominator Type

integer

tiff:numerator

Numerator

The numerator of a fraction

tiff:numerator

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

tiff:numerator Type

integer