Difference between revisions of "APE Tag Item"

From Hydrogenaudio Knowledgebase
Jump to: navigation, search
(temporary commit)
 
(Category:Metadata)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
An APE tag item is a value assigned by a key.  
 
An APE tag item is a value assigned by a key.  
  
Member of [[APEv2|APE Tag Version 2.0]]
+
Member of [[APEv2 specification|APE Tag Version 2.0]]
 +
 
  
 
''Note:''
 
''Note:''
  
*APE Tags Item Key are case sensitive.
+
*APE Tags [[APE key|Item Key]] are case sensitive.
*Nevertheless it is forbidden to use APE Tags Item Key which only differs in case.
+
*Nevertheless it is forbidden to use APE Tags [[APE key|Item Key]] which only differs in case.
 
*And nevertheless Tag readers are recommended to be case insensitive.
 
*And nevertheless Tag readers are recommended to be case insensitive.
*Every Tag Item Key can only occures (at most) once. It is not possible to transmit a Tag Key multiple time to change it contents.
+
*Every Tag [[APE key|Item Key]] can only occures (at most) once. It is not possible to transmit a Tag Key multiple time to change it contents.
 +
*Tags can be partially or complete repeated in the streaming format.<br>This is to make it possible to display artist and title if you missed the start of the transmission.<br>It is recommended to transmit very important information like artist / album / title every 2 minutes and additional 5...10 seconds before the end. Be careful and don't transmit these information too often or during passages with high bitrate demand to avoid unnecessary drop-outs.
 +
 
 +
 
 +
{| border="1" cellspacing="1"
 +
|width="230px"|
 +
Size of the [[APE Item Value|Item Value]], Bits  0...7 <br>
 +
Size of the [[APE Item Value|Item Value]], Bits  8...15 <br>
 +
Size of the [[APE Item Value|Item Value]], Bits 16...23 <br>
 +
Size of the [[APE Item Value|Item Value]], Bits 24...31
 +
|width="65px"|32 bits
 +
|width="300px"|Length ''len'' of the assigned value in bytes
 +
|-
 +
|
 +
[[Ape Tags Flags|Item Flags]], Bits  0...7 <br>
 +
[[Ape Tags Flags|Item Flags]], Bits  8...15 <br>
 +
[[Ape Tags Flags|Item Flags]], Bits 16...23 <br>
 +
[[Ape Tags Flags|Item Flags]], Bits 24...31
 +
||32 bits
 +
||Item flags
 +
|-
 +
|[[APE key|Item Key]]
 +
||m bytes
 +
||Item key, can contain ASCII characters from 0x20 (Space) up to 0x7E (Tilde)
 +
|-
 +
|0x00
 +
||1byte
 +
||Item key terminator
 +
|-
 +
|[[APE Item Value|Item Value]]
 +
||''len'' bytes
 +
||Item value, can be binary data or [[APEtag-UTF8|UTF-8]] string
 +
|}
  
  
*Tags can be partially or complete repeated in the streaming format.
+
[[Category:Metadata]]
:This is to make it possible to display artist and title if you missed the start of the transmission.
+
:It is recommended to transmit very important information like artist / album / title every 2 minutes and additional 5 . . . 10 seconds before the end. Be careful and don't transmit these information too often or during passages with high bitrate demand to avoid unnecessary drop-outs.
+

Latest revision as of 21:17, 11 September 2006

An APE tag item is a value assigned by a key.

Member of APE Tag Version 2.0


Note:

  • APE Tags Item Key are case sensitive.
  • Nevertheless it is forbidden to use APE Tags Item Key which only differs in case.
  • And nevertheless Tag readers are recommended to be case insensitive.
  • Every Tag Item Key can only occures (at most) once. It is not possible to transmit a Tag Key multiple time to change it contents.
  • Tags can be partially or complete repeated in the streaming format.
    This is to make it possible to display artist and title if you missed the start of the transmission.
    It is recommended to transmit very important information like artist / album / title every 2 minutes and additional 5...10 seconds before the end. Be careful and don't transmit these information too often or during passages with high bitrate demand to avoid unnecessary drop-outs.


Size of the Item Value, Bits 0...7
Size of the Item Value, Bits 8...15
Size of the Item Value, Bits 16...23
Size of the Item Value, Bits 24...31

32 bits Length len of the assigned value in bytes

Item Flags, Bits 0...7
Item Flags, Bits 8...15
Item Flags, Bits 16...23
Item Flags, Bits 24...31

32 bits Item flags
Item Key m bytes Item key, can contain ASCII characters from 0x20 (Space) up to 0x7E (Tilde)
0x00 1byte Item key terminator
Item Value len bytes Item value, can be binary data or UTF-8 string