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.

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

Add missing values for DASH role scheme #1149

Closed
dudewheresmycode opened this issue Nov 27, 2022 · 4 comments · Fixed by #1390
Closed

Add missing values for DASH role scheme #1149

dudewheresmycode opened this issue Nov 27, 2022 · 4 comments · Fixed by #1390
Assignees
Labels
component: DASH The issue involves DASH output flag: spec compliance An issue with compliance to DASH, HLS, or other specs status: archived Archived and locked; will not be updated

Comments

@dudewheresmycode
Copy link

System info

Operating System: Debian GNU/Linux 11 (bullseye)
Shaka Packager Version: shaka-packager version v2.6.1-634af65-release

Issue and steps to reproduce the problem

I'm running into an issue setting the roles stream descriptor option for content containing descriptive audio tracks. The DASH spec specifically defines these as:

description - Textual or audio media component containing a textual description (intended for
audio synthesis) or an audio description describing a visual component.

From the shaka-packager docs, it appears it only supports a subset of the values outlined in the DASH specification:

Optional semicolon separated list of values for DASH Role element. The value should be one of: caption, subtitle, main, alternate, supplementary, commentary and dub. See DASH (ISO/IEC 23009-1) specification for details.

However, checking the DASH (ISO/IEC 23009-1) specification, section 5.8.5.5 DASH role scheme (Table 29), defines many more values for the roles:

  • caption
  • subtitle
  • main
  • alternate
  • supplementary
  • commentary
  • dub
  • description
  • sign
  • metadata
  • enhanced-audio-intelligibility
  • emergency

Packager Command:

shaka-packager \
in=./input.mp4,stream=video,init_segment=./video/video_init.mp4,segment_template=./video/video_$Number$.m4s \
in=./input.mp4,stream=audio,language=en,roles=main,init_segment=./audio/audio_main_init.mp4,segment_template=./audio/audio_main_$Number$.m4s \
in=./descriptive-audio.mp4,stream=audio,language=en,roles=description,init_segment=./audio/audio_desc_init.mp4,segment_template=./audio/audio_desc_$Number$.m4s \
--fragment_duration 6 --segment_duration 6 --generate_static_live_mpd --mpd_output ./manifest.mpd

Extra steps to reproduce the problem?
(1) include roles=description in DASH stream descriptor options

What is the expected result?
Generates a DASH manifest with a description role

What happens instead?
Shaka throws an error:

[1127/214613:ERROR:period.cc(208)] Unrecognized role 'description'
@dudewheresmycode
Copy link
Author

dudewheresmycode commented Nov 27, 2022

I see that support for description specifically was added in this commit, so I'm guessing this just hasn't made it into a release yet? Any chance you could tag a new release?

@dudewheresmycode
Copy link
Author

Just wanted to check in on this. Any chance we can get a new release tagged that contains this fix?

@dudewheresmycode
Copy link
Author

Just wanted to bump this again. Any chance we could get a new release tagged? The fix for this was merged nearly a year ago now.

@cosmin
Copy link
Contributor

cosmin commented Apr 26, 2024

version 3.0.x should contain anything that was previously merged, I'll look at adding any missing values

@cosmin cosmin self-assigned this Apr 26, 2024
@cosmin cosmin added this to the v3.1 milestone Apr 26, 2024
@cosmin cosmin added flag: spec compliance An issue with compliance to DASH, HLS, or other specs component: DASH The issue involves DASH output labels Apr 26, 2024
@github-actions github-actions bot removed this from the v3.1 milestone Apr 26, 2024
cosmin added a commit that referenced this issue Apr 30, 2024
@github-actions github-actions bot added the status: archived Archived and locked; will not be updated label Jun 29, 2024
@github-actions github-actions bot locked as resolved and limited conversation to collaborators Jun 29, 2024
SteveR-PMP added a commit to SteveR-PMP/shaka-packager that referenced this issue Aug 28, 2024
…ovi 8.1 (shaka-project#35)

* fix: BaseURL missing when MPD base path is empty (shaka-project#1380)

The check for `!mpd_dir.empty()` is not needed because MakePathRelative
handles the case where the parent path is empty. As a result of this
check the base url, segment url, or segment template URLs were all
missing in cases where the mpd output was in the current working
directory.

Fixes shaka-project#1378

* chore(main): release 3.0.4 (shaka-project#1377)

:robot: I have created a release *beep* *boop*
---


## [3.0.4](shaka-project/shaka-packager@v3.0.3...v3.0.4) (2024-03-27)


### Bug Fixes

* BaseURL missing when MPD base path is empty ([shaka-project#1380](shaka-project#1380)) ([90c3c3f](shaka-project@90c3c3f)), closes [shaka-project#1378](shaka-project#1378)
* Fix NPM binary selection on ARM Macs ([shaka-project#1376](shaka-project#1376)) ([733af91](shaka-project@733af91)), closes [shaka-project#1375](shaka-project#1375)

---
This PR was generated with [Release Please](https://github.com/googleapis/release-please). See [documentation](https://github.com/googleapis/release-please#release-please).

* build: turn on integration tests in ctest by default (shaka-project#1381)

They can still be skipped by passing `-DSKIP_INTEGRATION_TESTS=ON` for
the build configuration. Fix integration tests so they run correctly when building out of tree.

Use FindPython3 in CMake to fix build and integration tests on Windows.

* feat: teletext formatting (shaka-project#1384)

This PR adds parsing of teletext styling, and rendering of the styling
in output TTML and WebVTT subtitle tracks.

Beyond unit tests, I've used the sample
https://drive.google.com/file/d/19ZYsoeUfH85gEilQkaAdLbPhC4CxhDEh/view?usp=sharing
which has rather advanced subtitling with two separate rows at the same
time, where one is left aligned and another is right aligned. This
necessitates two parallel cues to be rendered. It also has some colored
text.

Solve shaka-project#1335.

## parse teletext styling and formatting

Extend the teletext parser to parse the teletext styling and formatting.
This includes translating rows into regions, calculating alignment
from start and stop position of the text, and extracting text and
background colors.

The colors are limited to full lines.
Both lines and regions are propagated in the TextSample structures.
This is because the number of lines may differ from different sources.
For teletext, there are 24 rows, but they are essentially always
used with double height, so the number of output lines is 12
from 0 to 11.
There are also corresponding regions are denoted "ttx_R",
where R is an integer row number. A renderer can use either
the line number or the region ID to render the text.

## ttml generation for teletext to EBU-TT-D

Add support to render teletext input in EBU-TT-D (IMSC-1) format.
This includes appropriate regions ttx_0 to ttx_11 signalled
in the TextSamples, alignment and text and background colors.

The general TTML output has been changed to always include
metadata, layout, and styling nodes, even if they are empty.

EBU-TT-D is detected by the presence of "ttx_?" regions in the
samples. If detected, extra TTML elements will be added and
the EBU-TT-D linePadding used as well.

Appropriate styles for background and text colors are generated
depending on the color and backgroundColor attributes in the
text fragments.

## adapt WebVTT output to teletext TextSample.

Teletext input generates both a region with prefix ttx_
and a floating point line number (e.g. 9.5) in the
range 0 to 11.5 (due to input 0-23 as double lines).

The output is adopted to drop such regions
and convert the line number to an integer
since the standard only used floats for percent
values but not for plain line numbers.

* feat: add missing DASH roles from ISO/IEC 23009-1 section 5.8.5.5 (shaka-project#1390)



Fixes shaka-project#1149

---------

Co-authored-by: Joey Parrish <[email protected]>

* docs: Fix missing graphviz outputs in generated docs (shaka-project#1392)

Fixes shaka-project#1388

* feat: get start number from muxer and specify initial sequence number (shaka-project#879)

Set the start number in representation to the segment index that is sent by muxer.

With this enhancement, you can now specify the initial sequence number
to be used on the generated segments when calling the packager.
With the old implementation, it was always starting with "1".

---------

Co-authored-by: Cosmin Stejerean <[email protected]>

* refactor: merge Period::ProtectedAdaptationSetMap  into AdaptationSet (shaka-project#844)



---------

Co-authored-by: Cosmin Stejerean <[email protected]>

* chore(main): release 3.1.0 (shaka-project#1391)

:robot: I have created a release *beep* *boop*
---


##
[3.1.0](shaka-project/shaka-packager@v3.0.4...v3.1.0)
(2024-05-03)


### Features

* add missing DASH roles from ISO/IEC 23009-1 section 5.8.5.5
([shaka-project#1390](shaka-project#1390))
([fe885b3](shaka-project@fe885b3))
* get start number from muxer and specify initial sequence number
([shaka-project#879](shaka-project#879))
([bb104fe](shaka-project@bb104fe))
* teletext formatting
([shaka-project#1384](shaka-project#1384))
([4b5e80d](shaka-project@4b5e80d))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

* fix: adaptation set IDs were referenced by lowest representation ID  (shaka-project#1394)

After change to add forced command line ordering adaptation set IDs in
places were referenced by their sort index (the minimum representation
index they contained).

Instead always refer to adaptation sets by their own ID, and use the
index only as an optional sort key.

Fixes shaka-project#1393

* docs: document --enable_entitlement_license option for Widevine (shaka-project#1399)

The option was never covered to the widevine docs when it was added,
requiring someone to read the source code or the --help to discover this
option.

Fixes shaka-project#983

* fix: escape media URLs in MPD (shaka-project#1395)

Currently `media_info.media_file_url()` is not escaped when placed into
MPD for things like BaseURL. This for example breaks when trying to us a
file name that contains special characters like &. Since these are
supposed to be URLs let's URL encode them.

Fixes shaka-project#1107

---------

Co-authored-by: Joey Parrish <[email protected]>

* fix: set yuv full range flag to 1 for VP9 with sRGB (shaka-project#1398)

If color_space is VPX_COLOR_SPACE_SRGB, the specs says that color_range
should be 1 i.e. yuv_full_range = true. 

However, yuv_full_range was initialized as false and wasn't set in the branch for color_space
is VPX_COLOR_SPACE_SRGB.

Fixes shaka-project#990

---------

Co-authored-by: Joey Parrish <[email protected]>

* feat: support Dolby Vision profile 8.x (HEVC) and 10.x (AV1) in HLS and DASH  (shaka-project#1396)

Support Dolby Vision profile 8.1, 8.2, 8.4, 10.1, 10.4 signaling in HLS
and DASH.

Adds new option `--use_dovi_supplemental_codecs` (off by default) to use
SUPPLEMENTAL-CODECS in HLS and `scte214:supplementalCodecs` and
`scte214:supplementalProfiles` for DASH.

To maintain compatibility with existing players the current behavior of
using two entries in the manifest remains the default. This will be
changed in a future version where `use_dovi_supplemental_codecs` will
become on by default.

Adds Dolby Vision compatible brands, 'db1p', 'db2g', 'db4g', 'db4h',
'dby1' based on https://mp4ra.org/#/brands

---------

Co-authored-by: Xingzhao Yun <[email protected]>

* chore(main): release 3.2.0 (shaka-project#1400)

:robot: I have created a release *beep* *boop*
---


##
[3.2.0](shaka-project/shaka-packager@v3.1.0...v3.2.0)
(2024-05-11)


### Features

* support Dolby Vision profile 8.x (HEVC) and 10.x (AV1) in HLS and DASH
([shaka-project#1396](shaka-project#1396))
([a99cfe0](shaka-project@a99cfe0))


### Bug Fixes

* adaptation set IDs were referenced by lowest representation ID
([shaka-project#1394](shaka-project#1394))
([94db9c9](shaka-project@94db9c9)),
closes
[shaka-project#1393](shaka-project#1393)
* escape media URLs in MPD
([shaka-project#1395](shaka-project#1395))
([98b44d0](shaka-project@98b44d0))
* set yuv full range flag to 1 for VP9 with sRGB
([shaka-project#1398](shaka-project#1398))
([f6f60e5](shaka-project@f6f60e5))

---
This PR was generated with [Release
Please](https://github.com/googleapis/release-please). See
[documentation](https://github.com/googleapis/release-please#release-please).

* lint

---------

Co-authored-by: Cosmin Stejerean <[email protected]>
Co-authored-by: Shaka Bot <[email protected]>
Co-authored-by: Torbjörn Einarson <[email protected]>
Co-authored-by: Joey Parrish <[email protected]>
Co-authored-by: sr90 <[email protected]>
Co-authored-by: Cosmin Stejerean <[email protected]>
Co-authored-by: Xingzhao Yun <[email protected]>
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
component: DASH The issue involves DASH output flag: spec compliance An issue with compliance to DASH, HLS, or other specs status: archived Archived and locked; will not be updated
Projects
None yet
Development

Successfully merging a pull request may close this issue.

2 participants