loliball/media3
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Remove @see tags with <a> tags

Browse Source 
These are not supported by Dackka

#minor-release

PiperOrigin-RevId: 513176533
This commit is contained in:
ibaker 2023-03-01 10:21:05 +00:00 committed by tonihei
parent cccc582595
commit c07cf3dc41
12 changed files with 59 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

8
libraries/common/src/main/java/androidx/media3/common/util/ColorParser.java
View File

@ -27,8 +27,12 @@ import java.util.regex.Pattern;
/**
* Parser for color expressions found in styling formats, e.g. TTML and CSS.
*
* @see <a href="https://w3c.github.io/webvtt/#styling">WebVTT CSS Styling</a>
* @see <a href="https://www.w3.org/TR/ttml2/">Timed Text Markup Language 2 (TTML2) - 10.3.5</a>
* <p>See also:
*
* <ul>
* <li><a href="https://w3c.github.io/webvtt/#styling">WebVTT CSS Styling</a>
* <li><a href="https://www.w3.org/TR/ttml2/">Timed Text Markup Language 2 (TTML2) - 10.3.5</a>
* </ul>
*/
@UnstableApi
public final class ColorParser {

8
libraries/exoplayer/src/main/java/androidx/media3/exoplayer/upstream/SlidingPercentile.java
View File

@ -30,8 +30,12 @@ import java.util.Comparator;
* rate observations. This is an alternative to sliding mean and exponential averaging which suffer
* from susceptibility to outliers and slow adaptation to step functions.
*
* @see <a href="http://en.wikipedia.org/wiki/Moving_average">Wiki: Moving average</a>
* @see <a href="http://en.wikipedia.org/wiki/Selection_algorithm">Wiki: Selection algorithm</a>
* <p>See the following Wikipedia articles:
*
* <ul>
* <li><a href="http://en.wikipedia.org/wiki/Moving_average">Moving average</a>
* <li><a href="http://en.wikipedia.org/wiki/Selection_algorithm">Selection algorithm</a>
* </ul>
*/
@UnstableApi
public class SlidingPercentile {

2
libraries/exoplayer_smoothstreaming/src/main/java/androidx/media3/exoplayer/smoothstreaming/manifest/SsManifest.java
View File

@ -34,7 +34,7 @@ import java.util.UUID;
/**
* Represents a SmoothStreaming manifest.
*
* @see <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
* <p>See the <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
* Streaming Client Manifest Format</a>
*/
@UnstableApi

2
libraries/exoplayer_smoothstreaming/src/main/java/androidx/media3/exoplayer/smoothstreaming/manifest/SsManifestParser.java
View File

@ -51,7 +51,7 @@ import org.xmlpull.v1.XmlPullParserFactory;
/**
* Parses SmoothStreaming client manifests.
*
* @see <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
* <p>See the <a href="http://msdn.microsoft.com/en-us/library/ee673436(v=vs.90).aspx">IIS Smooth
* Streaming Client Manifest Format</a>
*/
@UnstableApi

12
libraries/extractor/src/main/java/androidx/media3/extractor/FlacStreamMetadata.java
View File

@ -33,14 +33,18 @@ import java.util.List;
/**
* Holder for FLAC metadata.
*
* @see <a href="https://xiph.org/flac/format.html#metadata_block_streaminfo">FLAC format
* <p>See the following spec references:
*
* <ul>
* <li><a href="https://xiph.org/flac/format.html#metadata_block_streaminfo">FLAC format
* METADATA_BLOCK_STREAMINFO</a>
* @see <a href="https://xiph.org/flac/format.html#metadata_block_seektable">FLAC format
* <li><a href="https://xiph.org/flac/format.html#metadata_block_seektable">FLAC format
* METADATA_BLOCK_SEEKTABLE</a>
* @see <a href="https://xiph.org/flac/format.html#metadata_block_vorbis_comment">FLAC format
* <li><a href="https://xiph.org/flac/format.html#metadata_block_vorbis_comment">FLAC format
* METADATA_BLOCK_VORBIS_COMMENT</a>
* @see <a href="https://xiph.org/flac/format.html#metadata_block_picture">FLAC format
* <li><a href="https://xiph.org/flac/format.html#metadata_block_picture">FLAC format
* METADATA_BLOCK_PICTURE</a>
* </ul>
*/
@UnstableApi
public final class FlacStreamMetadata {

4
libraries/extractor/src/main/java/androidx/media3/extractor/VorbisBitArray.java
View File

@ -23,8 +23,8 @@ import androidx.media3.common.util.UnstableApi;
/**
* Wraps a byte array, providing methods that allow it to be read as a Vorbis bitstream.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-360002">Vorbis bitpacking
* specification</a>
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-360002">Vorbis
* bitpacking specification</a>
*/
@UnstableApi
public final class VorbisBitArray {

20
libraries/extractor/src/main/java/androidx/media3/extractor/VorbisUtil.java
View File

@ -52,7 +52,7 @@ public final class VorbisUtil {
/**
* Vorbis identification header.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
* spec/Identification header</a>
*/
public static final class VorbisIdHeader {
@ -135,8 +135,9 @@ public final class VorbisUtil {
/**
* Returns ilog(x), which is the index of the highest set bit in {@code x}.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-1190009.2.1">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-1190009.2.1">Vorbis
* spec</a>
*
* @param x the value of which the ilog should be calculated.
* @return ilog(x)
*/
@ -152,8 +153,9 @@ public final class VorbisUtil {
/**
* Reads a Vorbis identification header from {@code headerData}.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-630004.2.2">Vorbis
* spec/Identification header</a>
*
* @param headerData a {@link ParsableByteArray} wrapping the header data.
* @return a {@link VorbisUtil.VorbisIdHeader} with meta data.
* @throws ParserException thrown if invalid capture pattern is detected.
@ -202,8 +204,9 @@ public final class VorbisUtil {
/**
* Reads a Vorbis comment header.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
* spec/Comment header</a>
*
* @param headerData A {@link ParsableByteArray} wrapping the header data.
* @return A {@link VorbisUtil.CommentHeader} with all the comments.
* @throws ParserException If an error occurs parsing the comment header.
@ -219,8 +222,9 @@ public final class VorbisUtil {
*
* <p>The data provided may not contain the Vorbis metadata common header and the framing bit.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-640004.2.3">Vorbis
* spec/Comment header</a>
*
* @param headerData A {@link ParsableByteArray} wrapping the header data.
* @param hasMetadataHeader Whether the {@code headerData} contains a Vorbis metadata common
* header preceding the comment header.
@ -349,8 +353,9 @@ public final class VorbisUtil {
* That's why we need to partially decode or at least read the entire setup header to know where
* to start reading the modes.
*
* @see <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-650004.2.4">Vorbis
* <p>See the <a href="https://www.xiph.org/vorbis/doc/Vorbis_I_spec.html#x1-650004.2.4">Vorbis
* spec/Setup header</a>
*
* @param headerData a {@link ParsableByteArray} containing setup header data.
* @param channels the number of channels.
* @return an array of {@link Mode}s.
@ -592,7 +597,8 @@ public final class VorbisUtil {
}
/**
* @see <a href="http://svn.xiph.org/trunk/vorbis/lib/sharedbook.c">_book_maptype1_quantvals</a>
* See the <a
* href="http://svn.xiph.org/trunk/vorbis/lib/sharedbook.c">_book_maptype1_quantvals</a>
*/
private static long mapType1QuantValues(long entries, long dimension) {
return (long) Math.floor(Math.pow(entries, 1.d / dimension));

2
libraries/extractor/src/main/java/androidx/media3/extractor/text/ttml/TtmlDecoder.java
View File

@ -65,7 +65,7 @@ import org.xmlpull.v1.XmlPullParserFactory;
* <li>cell-resolution
* </ul>
*
* @see <a href="http://www.w3.org/TR/ttaf1-dfxp/">TTML specification</a>
* <p>See the <a href="http://www.w3.org/TR/ttaf1-dfxp/">TTML specification</a>
*/
@UnstableApi
public final class TtmlDecoder extends SimpleSubtitleDecoder {

6
libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttCssStyle.java
View File

@ -36,10 +36,10 @@ import java.util.HashSet;
import java.util.Set;
/**
* Style object of a Css style block in a Webvtt file.
* Style object of a CSS style block in a WebVTT file.
*
* @see <a href="https://w3c.github.io/webvtt/#applying-css-properties">W3C specification - Apply
* CSS properties</a>
* <p>See the <a href="https://w3c.github.io/webvtt/#applying-css-properties">Apply CSS properties
* section of the W3C specification</a>
*/
@UnstableApi
public final class WebvttCssStyle {

2
libraries/extractor/src/main/java/androidx/media3/extractor/text/webvtt/WebvttDecoder.java
View File

@ -29,7 +29,7 @@ import java.util.List;
/**
* A {@link SimpleSubtitleDecoder} for WebVTT.
*
* @see <a href="http://dev.w3.org/html5/webvtt">WebVTT specification</a>
* <p>See the <a href="http://dev.w3.org/html5/webvtt">WebVTT specification</a>.
*/
@UnstableApi
public final class WebvttDecoder extends SimpleSubtitleDecoder {

11
libraries/extractor/src/test/java/androidx/media3/extractor/text/ttml/TtmlDecoderTest.java
View File

@ -112,14 +112,11 @@ public final class TtmlDecoderTest {
* Regression test for devices on JellyBean where some named colors are not correctly defined on
* framework level. Tests that <i>lime</i> resolves to <code>#FF00FF00</code> not <code>#00FF00
* </code>.
*
* @throws IOException thrown if reading subtitle file fails.
* @see <a
* href="https://github.com/android/platform_frameworks_base/blob/jb-mr2-release/graphics/java/android/graphics/Color.java#L414">
* JellyBean Color</a> <a
* href="https://github.com/android/platform_frameworks_base/blob/kitkat-mr2.2-release/graphics/java/android/graphics/Color.java#L414">
* Kitkat Color</a>
*/
// JellyBean Color:
// https://github.com/android/platform_frameworks_base/blob/jb-mr2-release/graphics/java/android/graphics/Color.java#L414
// KitKat Color:
// https://github.com/android/platform_frameworks_base/blob/kitkat-mr2.2-release/graphics/java/android/graphics/Color.java#L414
@Test
public void lime() throws IOException, SubtitleDecoderException {
TtmlSubtitle subtitle = getSubtitle(INLINE_ATTRIBUTES_TTML_FILE);

2
libraries/transformer/src/main/java/androidx/media3/transformer/MssimCalculator.java
View File

@ -23,7 +23,7 @@ import static java.lang.Math.pow;
*
* <p>MSSIM divides the image into windows, calculates SSIM of each, then returns the average.
*
* @see <a href=https://ece.uwaterloo.ca/~z70wang/publications/ssim.pdf>The SSIM paper</a>.
* <p>See <a href=https://ece.uwaterloo.ca/~z70wang/publications/ssim.pdf>the SSIM paper</a>.
*/
/* package */ final class MssimCalculator {
// Referred to as 'L' in the SSIM paper, this constant defines the maximum pixel values. The