Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document rotation #326

Merged
merged 2 commits into from
Jul 22, 2019
Merged

Document rotation #326

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
653cb68
move cropping to subsection of image presentation section
dericed Jul 12, 2019
e656a5a
draft a section on image rotation
dericed Jul 12, 2019
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 13 additions & 1 deletion notes.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,10 +38,22 @@ Encryption can also be layered within Matroska. This means that two completely d

Encryption information is stored in the `ContentEncodings Element` under the `ContentEncryption Element`.

# Image cropping
# Image Presentation

## Cropping

The `PixelCrop Elements` (`PixelCropTop`, `PixelCropBottom`, `PixelCropRight` and `PixelCropLeft`) indicate when and by how much encoded videos frames SHOULD be cropped for display. These Elements allow edges of the frame that are not intended for display, such as the sprockets of a full-frame film scan or the VANC area of a digitized analog videotape, to be stored but hidden. `PixelCropTop` and `PixelCropBottom` store an integer of how many rows of pixels SHOULD be cropped from the top and bottom of the image (respectively). `PixelCropLeft` and `PixelCropRight` store an integer of how many columns of pixels SHOULD be cropped from the left and right of the image (respectively). For example, a pillar-boxed video that stores a 1440x1080 visual image within the center of a padded 1920x1080 encoded image MAY set both `PixelCropLeft` and `PixelCropRight` to `240`, so that a `Matroska Player` SHOULD crop off 240 columns of pixels from the left and right of the encoded image to present the image with the pillar-boxes hidden.

## Rotation

The ProjectionPoseRoll Element (see (#projectionposeroll-element)) can be used to indicate that the image from the associated video track SHOULD be rotated for presentation. For instance, the following representation of the Projection Element (#projection-element)) and the ProjectionPoseRoll Element represents a video track where the image SHOULD be presentation with a 90 degree counter-clockwise rotation.

```xml
<Projection>
<ProjectionPoseRoll>90</ProjectionPoseRoll>
</ProjectionPoseRoll>
```

# Matroska versioning

The `EBML Header` of each Matroska document informs the reading application on what version of Matroska to expect. The `Elements` within `EBML Header` with jurisdiction over this information are `DocTypeVersion` and `DocTypeReadVersion`.
Expand Down