Method Detail

• iLog

  public static int iLog​(int x)

  Deprecated.
  Returns ilog(x), which is the index of the highest set bit in x.

  See the Vorbis spec

  Parameters:

  x - the value of which the ilog should be calculated.

  Returns:

  ilog(x)

• readVorbisIdentificationHeader

  public static VorbisUtil.VorbisIdHeader readVorbisIdentificationHeader​(ParsableByteArray headerData)
                                                                  throws ParserException

  Deprecated.
  Reads a Vorbis identification header from headerData.

  See the Vorbis spec/Identification header

  Parameters:

  headerData - a ParsableByteArray wrapping the header data.

  Returns:

  a VorbisUtil.VorbisIdHeader with meta data.

  Throws:

  ParserException - thrown if invalid capture pattern is detected.

• readVorbisCommentHeader

  public static VorbisUtil.CommentHeader readVorbisCommentHeader​(ParsableByteArray headerData)
                                                          throws ParserException

  Deprecated.
  Reads a Vorbis comment header.

  See the Vorbis spec/Comment header

  Parameters:

  headerData - A ParsableByteArray wrapping the header data.

  Returns:

  A VorbisUtil.CommentHeader with all the comments.

  Throws:

  ParserException - If an error occurs parsing the comment header.

• readVorbisCommentHeader

  public static VorbisUtil.CommentHeader readVorbisCommentHeader​(ParsableByteArray headerData,
                                                                 boolean hasMetadataHeader,
                                                                 boolean hasFramingBit)
                                                          throws ParserException

  Deprecated.
  Reads a Vorbis comment header.

  The data provided may not contain the Vorbis metadata common header and the framing bit.

  See the Vorbis spec/Comment header

  Parameters:

  headerData - A ParsableByteArray wrapping the header data.

  hasMetadataHeader - Whether the headerData contains a Vorbis metadata common header preceding the comment header.

  hasFramingBit - Whether the headerData contains a framing bit.

  Returns:

  A VorbisUtil.CommentHeader with all the comments.

  Throws:

  ParserException - If an error occurs parsing the comment header.

• parseVorbisComments

  @Nullable
  public static Metadata parseVorbisComments​(List<String> vorbisComments)

  Deprecated.
  Builds a Metadata instance from a list of Vorbis Comments.

  METADATA_BLOCK_PICTURE comments will be transformed into PictureFrame entries. All others will be transformed into VorbisComment entries.

  Parameters:

  vorbisComments - The raw input of comments, as a key-value pair KEY=VAL.

  Returns:

  The fully parsed Metadata instance. Null if no vorbis comments could be parsed.

• verifyVorbisHeaderCapturePattern

  public static boolean verifyVorbisHeaderCapturePattern​(int headerType,
                                                         ParsableByteArray header,
                                                         boolean quiet)
                                                  throws ParserException

  Deprecated.
  Verifies whether the next bytes in header are a Vorbis header of the given headerType.

  Parameters:

  headerType - the type of the header expected.

  header - the alleged header bytes.

  quiet - if true no exceptions are thrown. Instead false is returned.

  Returns:

  the number of bytes read.

  Throws:

  ParserException - thrown if header type or capture pattern is not as expected.

• readVorbisModes

  public static VorbisUtil.Mode[] readVorbisModes​(ParsableByteArray headerData,
                                                  int channels)
                                           throws ParserException

  Deprecated.
  This method reads the modes which are located at the very end of the Vorbis setup header. 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 the Vorbis spec/Setup header

  Parameters:

  headerData - a ParsableByteArray containing setup header data.

  channels - the number of channels.

  Returns:

  an array of VorbisUtil.Modes.

  Throws:

  ParserException - thrown if bit stream is invalid.