XtraBox (ISO Parser 1.9.41.4 API)

java.lang.Object
- org.mp4parser.support.AbstractBox
- - org.mp4parser.boxes.microsoft.XtraBox

All Implemented Interfaces:

Box, ParsableBox
```
public class XtraBox
extends AbstractBox
```
4cc = ""Xtra""
Windows Media Xtra Box.
I can't find definitive documentation on this from Microsoft so it's cobbled together from various sources. Mostly ExifTool for Perl.
Various references: https://msdn.microsoft.com/en-us/library/windows/desktop/dd743066(v=vs.85).aspx https://metacpan.org/source/EXIFTOOL/Image-ExifTool-9.76/lib/Image/ExifTool/Microsoft.pm http://www.ventismedia.com/mantis/view.php?id=12017 http://www.hydrogenaudio.org/forums/index.php?showtopic=75123&st=250 http://www.mediamonkey.com/forum/viewtopic.php?f=1&t=76321 https://code.google.com/p/mp4v2/issues/detail?id=113

Author:

marwatk

Field Summary

Fields
Modifier and Type	Field and Description
`static int`	`MP4_XTRA_BT_FILETIME`
`static int`	`MP4_XTRA_BT_GUID`
`static int`	`MP4_XTRA_BT_INT64`
`static int`	`MP4_XTRA_BT_UNICODE`
`static java.lang.String`	`TYPE`

Fields inherited from class org.mp4parser.support.AbstractBox
content, type

Constructor Summary

Constructors
Constructor and Description

XtraBox()

XtraBox(java.lang.String type)

Constructors
Constructor and Description
`XtraBox()`
`XtraBox(java.lang.String type)`

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`void`	`_parseDetails(java.nio.ByteBuffer content)` Parse the box's fields and child boxes if any.
`java.lang.String[]`	`getAllTagNames()` Returns a list of the tag names present in this Xtra Box
`protected void`	`getContent(java.nio.ByteBuffer byteBuffer)` Write the box's content into the given `ByteBuffer`.
`protected long`	`getContentSize()` Get the box's content size without its header.
`java.util.Date`	`getFirstDateValue(java.lang.String name)` Returns the first Date value found for this tag
`java.lang.Long`	`getFirstLongValue(java.lang.String name)` Returns the first Long value found for this tag
`java.lang.String`	`getFirstStringValue(java.lang.String name)` Returns the first String value found for this tag
`java.lang.Object[]`	`getValues(java.lang.String name)` Returns an array of values for this tag.
`void`	`removeTag(java.lang.String name)` Removes specified tag (all values for that tag will be removed)
`void`	`setTagValue(java.lang.String name, java.util.Date date)` Removes and recreates tag using specified Date value
`void`	`setTagValue(java.lang.String name, long value)` Removes and recreates tag using specified Long value
`void`	`setTagValue(java.lang.String name, java.lang.String value)` Removes and recreates tag using specified String value
`void`	`setTagValues(java.lang.String name, java.lang.String[] values)` Removes and recreates tag using specified String values
`java.lang.String`	`toString()`

Methods inherited from class org.mp4parser.support.AbstractBox
getBox, getSize, getType, getUserType, isParsed, parse, parseDetails

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

- Field Detail
  - TYPE
```
public static final java.lang.String TYPE
```
    See Also:
    
    Constant Field Values
  - MP4_XTRA_BT_UNICODE
```
public static final int MP4_XTRA_BT_UNICODE
```
    See Also:
    
    Constant Field Values
  - MP4_XTRA_BT_INT64
```
public static final int MP4_XTRA_BT_INT64
```
    See Also:
    
    Constant Field Values
  - MP4_XTRA_BT_FILETIME
```
public static final int MP4_XTRA_BT_FILETIME
```
    See Also:
    
    Constant Field Values
  - MP4_XTRA_BT_GUID
```
public static final int MP4_XTRA_BT_GUID
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - XtraBox
```
public XtraBox()
```
  - XtraBox
```
public XtraBox(java.lang.String type)
```
- Method Detail
  - getContentSize
```
protected long getContentSize()
```
    Description copied from class: AbstractBox
    
    Get the box's content size without its header. This must be the exact number of bytes that getContent(ByteBuffer) writes.
    
    Specified by:
    
    getContentSize in class AbstractBox
    
    Returns:
    
    Gets the box's content size in bytes
    
    See Also:
    
    AbstractBox.getContent(java.nio.ByteBuffer)
  - toString
```
public java.lang.String toString()
```
    Overrides:
    
    toString in class java.lang.Object
  - _parseDetails
```
public void _parseDetails(java.nio.ByteBuffer content)
```
    Description copied from class: AbstractBox
    
    Parse the box's fields and child boxes if any.
    
    Specified by:
    
    _parseDetails in class AbstractBox
    
    Parameters:
    
    content - the box's raw content beginning after the 4-cc field.
  - getContent
```
protected void getContent(java.nio.ByteBuffer byteBuffer)
```
    Description copied from class: AbstractBox
    
    Write the box's content into the given ByteBuffer. This must include flags and version in case of a full box. byteBuffer has been initialized with getSize() bytes.
    
    Specified by:
    
    getContent in class AbstractBox
    
    Parameters:
    
    byteBuffer - the sink for the box's content
  - getAllTagNames
```
public java.lang.String[] getAllTagNames()
```
    Returns a list of the tag names present in this Xtra Box
    
    Returns:
    
    Possibly empty (zero length) array of tag names present
  - getFirstStringValue
```
public java.lang.String getFirstStringValue(java.lang.String name)
```
    Returns the first String value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First String value found
  - getFirstDateValue
```
public java.util.Date getFirstDateValue(java.lang.String name)
```
    Returns the first Date value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First Date value found
  - getFirstLongValue
```
public java.lang.Long getFirstLongValue(java.lang.String name)
```
    Returns the first Long value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First long value found
  - getValues
```
public java.lang.Object[] getValues(java.lang.String name)
```
    Returns an array of values for this tag. Empty array when tag is not present
    
    Parameters:
    
    name - Tag name to retrieve
    
    Returns:
    
    Possibly empty array of values (possible types are String, Long, Date and byte[] )
  - removeTag
```
public void removeTag(java.lang.String name)
```
    Removes specified tag (all values for that tag will be removed)
    
    Parameters:
    
    name - Tag to remove
  - setTagValues
```
public void setTagValues(java.lang.String name,
                         java.lang.String[] values)
```
    Removes and recreates tag using specified String values
    
    Parameters:
    
    name - Tag name to replace
    
    values - New String values
  - setTagValue
```
public void setTagValue(java.lang.String name,
                        java.lang.String value)
```
    Removes and recreates tag using specified String value
    
    Parameters:
    
    name - Tag name to replace
    
    value - New String value
  - setTagValue
```
public void setTagValue(java.lang.String name,
                        java.util.Date date)
```
    Removes and recreates tag using specified Date value
    
    Parameters:
    
    name - Tag name to replace
    
    date - New Date value
  - setTagValue
```
public void setTagValue(java.lang.String name,
                        long value)
```
    Removes and recreates tag using specified Long value
    
    Parameters:
    
    name - Tag name to replace
    
    value - New Long value

Class XtraBox

4cc = ""Xtra""

Field Summary

Fields inherited from class org.mp4parser.support.AbstractBox

Constructor Summary

Method Summary

Methods inherited from class org.mp4parser.support.AbstractBox

Methods inherited from class java.lang.Object

Field Detail

TYPE

MP4_XTRA_BT_UNICODE

MP4_XTRA_BT_INT64

MP4_XTRA_BT_FILETIME

MP4_XTRA_BT_GUID

Constructor Detail

XtraBox

XtraBox

Method Detail

getContentSize

toString

_parseDetails

getContent

getAllTagNames

getFirstStringValue

getFirstDateValue

getFirstLongValue

getValues

removeTag

setTagValues

setTagValue

setTagValue

setTagValue