XtraBox (ISO Parser 1.1.21 API)

java.lang.Object
- com.googlecode.mp4parser.AbstractBox
- - com.googlecode.mp4parser.boxes.microsoft.XtraBox

All Implemented Interfaces:

Box
```
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 String`	`TYPE`

Fields inherited from class com.googlecode.mp4parser.AbstractBox
type

Constructor Summary

Constructors
Constructor and Description

XtraBox()

XtraBox(String type)

Constructors
Constructor and Description
`XtraBox()`
`XtraBox(String type)`

Method Summary

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

Methods inherited from class com.googlecode.mp4parser.AbstractBox
getBox, getOffset, getParent, getPath, getSize, getType, getUserType, isParsed, parse, parseDetails, setParent

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

- Field Detail
  - TYPE
```
public static final 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(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 String toString()
```
    Overrides:
    
    toString in class Object
  - _parseDetails
```
public void _parseDetails(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(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 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 String getFirstStringValue(String name)
```
    Returns the first String value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First String value found
  - getFirstDateValue
```
public Date getFirstDateValue(String name)
```
    Returns the first Date value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First Date value found
  - getFirstLongValue
```
public Long getFirstLongValue(String name)
```
    Returns the first Long value found for this tag
    
    Parameters:
    
    name - Tag name
    
    Returns:
    
    First long value found
  - getValues
```
public Object[] getValues(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(String name)
```
    Removes specified tag (all values for that tag will be removed)
    
    Parameters:
    
    name - Tag to remove
  - setTagValues
```
public void setTagValues(String name,
                         String[] values)
```
    Removes and recreates tag using specified String values
    
    Parameters:
    
    name - Tag name to replace
    
    values - New String values
  - setTagValue
```
public void setTagValue(String name,
                        String value)
```
    Removes and recreates tag using specified String value
    
    Parameters:
    
    name - Tag name to replace
    
    value - New String value
  - setTagValue
```
public void setTagValue(String name,
                        Date date)
```
    Removes and recreates tag using specified Date value
    
    Parameters:
    
    name - Tag name to replace
    
    date - New Date value
  - setTagValue
```
public void setTagValue(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 com.googlecode.mp4parser.AbstractBox

Constructor Summary

Method Summary

Methods inherited from class com.googlecode.mp4parser.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