KLV : Key: L'identifiant de type (ou Universal Label)

La normalisation de la clef est définie dans la documentation SMPTE 298 : Universal Labels (UL) for Unique Identification of Digital Data.

En résumé : C'est une clef unique par type de KLV, mais pas unique par KLV : vous pouvez avoir plusieurs fois la même clef dans un MXF. Les exemples parfaits sont les KLV pour les frames : vous aurez plusieurs milliers de fois la même clef pour chaque KLV contenant une frame.

Un Universal Label (UL) a une certaine forme :

Représentation hexadécimale brute = 060e2b34020501010d01020101020400
Représentation au format SMPTE    = 060e2b34.02050101.0d010201.01020400

Il en existe énormément dont voici une poignée ci-dessous :

Comme on le constate, chaque Universal Label (UL) identifie un type de KLV.

On remarquera que l'entête (060e2b34) est toujours identique. Puis, après, et suivant le type du KLV, cela change un peu :-)

Après l'entête, tous les octets sont importants car ils sont comme des paramètres, des options ou des statuts du KLV. Pour être plus sincère, ce sont justes des identifiants pour chaque type de KLV, mais on essaye de respecter une certaine nomenclature pour certains afin de garder une cohérence, par exemple, les Partitions Packs qui possèdent plusieurs identifiants - dont la base est commune - qui permet de déterminer si c'est un Header, un Body ou un Footer, et pour spécifier si ces derniers sont complets ou incomplets, ouverts ou fermés, etc.

On va prendre notre exemple des Partition Packs et mettre en avant leurs différences :

Pour le cas des Partition Pack, vous remarquerez que seuls leurs avant-avant-derniers octets (en gras) changent, ils représentent respectivement :

• 02 : Header
• 03 : Body
• 04 : Footer

La valeur juste après (04) détermine le statut du Partition Pack : Avec 04, il est considéré comme Closed & Complete.

Chaque KLV a ses propres spécificités : Il faudra lire chaque documentation SMPTE pour comprendre et récolter ces précieux paramètres et ainsi identifier des Universal Labels pour chaque type de KLV (c'est comme des Pokemons).

Vous pouvez également récupérer un listing des différents Universal Labels auprès de ces registres, mais ils ne vous indiqueront pas à quoi correspondent chaque octet :

• https://registry.smpte-ra.org/apps/pages/published/
• https://registry.smpte-ra.org/view/published/published_registers/
• https://registry-page.isdcf.com/uls/
• Compilation des SMPTE Universal Labels de la RP224-2003 (attention, peut-être deprecated)

Nous allons voir en détail comment est composé un Universal Label (UL), l'intérieur d'une clef. Notez que savoir cela n'est pas essentiel et ne vous empêchera aucunement l'interprétation des données dans Value. C'est un bonus pour votre savoir.

L'intérieur de Key

Comme nous l'avons vu, après l'entête de la clef (060e2b34), chaque octet a une caractéristique propre.

Voici une représentation schématisée de l'intérieur du «K» d'un KLV :

La taille d'un Universal Label (UL) est de 16 octets et est subdivisible en 3 grandes parties :

• UL Header (2 octets)
• UL Designators (6 octets)
• Item Designator (8 octets)

Ce tableau permet de voir rapidement les différentes parties d'une clef :

Normalisée, les 4 premiers octets débuteront toujours par la séquence hexadécimale : 0x06,0x0e, 0x2b,0x34. C'est sa signature - et cela permet ainsi d'identifier rapidement ces KLV ¹.

Si vous regardez l'UL Header - 2 premiers octets : Object ID + UL Size - possède un format qui va vous paraître familier : nous débutons avec un identifiant puis une taille et on termine avec d'autres données... Oui, c'est bien le format KLV qui charpente aussi l'intérieur de la clef :-)

Ainsi, le second octet (UL Size) est la taille des données de Key : 0x0E représente 14 octets : cela correspond donc aux octets suivants : De SMPTE Designator au dernier Item Designator #8.

Voici un tableau descriptif de chaque octet de l'Universal Label (UL) :

• Le Category Designator permet de connaître rapidement le type de données que nous aurons dans la partie Value, pour faire rapide sur les principales catégories :

  • Dictionnaries sont les données brutes
  • Groups (Sets ou Packs) sont les données structurées
    

  Voici un tableau récapitulatif des différentes Category Designator (5) accompagné du suivant, le Registry Designator (6), qui permet d'être plus précis sur le type de données (en vert, les principaux éléments que nous aurons dans un MXF de DCP) :

  	Category Designator (5)	Registry Designator (6)
  Dictionnaries	0x01	Données brutes
  	0x01	0x01	Metadata Dictionary
  	0x01	0x02	Essence Dictionary
  	0x01	0x03	Control Dictionary
  	0x01	0x04	Types Dictionary
  Groups (Sets ou Packs)	0x02	Données structurées
  	0x02	0x01	Universal Set
  	0x02	0x02	Global Set
  	0x02	0x03	Local Set
  	0x02	0x13	Local Set
  	0x02	0x53	Local Set
  	0x02	0x04	Variable Length Pack
  	0x02	0x05	Defined Length Pack
  	0x02	0x06	Reservé / Interdit
  Wrappers & Containers	0x03
  	0x03	0x01	Simple Wrapper & Container
  	0x03	0x02	Complex Wrapper & Container
  SMPTE Labels	0x04		Non utilisé comme clef de KLV
  Registered Private Information	0x05
  Reserved	0x06
  ...	...
  Reserved	0x7E

• Le Registry Designator identifie le registre spécifique dans une catégorie spécifique (par exemple, "Essence Dictionary" qui est une sous-catégorie dans "Dictionaries"). Voir le tableau juste au-dessus pour voir les différents Registry Designator.

  Vous aurez remarqué la présence de plusieurs Local Sets avec trois Registry Designator différents. De base dans la norme KLV (2004), Local Set a un code de Registry Designator à 0x03. Dans la norme MXF (2011), les différents types de KLV compatibles avec le type Local Sets portent les codes de Registry Designator 0x53 ou 0x13.

  Le pourquoi de ces différents Registry Designator pour Local Set ? On va pas trop s'attarder dessus car nous le verrons dans la partie MXF : KLV : Values - Local Sets ainsi que dans les notes ² mais pour résumer rapidement cela aura un impact sur les données stockées dans la partie Value. Seul le dernier Local Set 0x53 est utile pour nous : c'est le Registry Designator pour les types de KLV des MXF DCP.

  A noter que nous avons le même type de comportement avec le Registry Designator de Variable-Length Pack mais que nous n'aurons qu'un Registry Designator à 0x04 ³

• Le Structure Designator identifie le variant dans le Registry Designator. Selon la norme, il est utilisé comme un simili-numéro de version majeur (Major number), allant de 0x01 à 0x7F. Dans la quasi-majorité, cette valeur sera toujours à 0x01.

• Le Version Number donne la version de l'Item Designator (donc de la suite)

• Le Item Designator (ou Universal-Set Designator) est l'identifiant unique pour cet item dans sa catégorie, il est sur les 8 derniers octets ⁴ de notre Universal Label. Nous verrons ce passage plus en détail dans la section "Les types de KLV".

Revoyons une dernière fois ce schéma de Key :

Maintenant que vous connaissez tout ceci, vous pouvez le ranger quelque part.

Hormis de savoir à quoi correspondent Category et Registry pour connaitre rapidement le type de données, cela n'aura pas beaucoup d'impact - ou presque - sur votre façon de traiter les données : ces informations essentielles seront disponibles dans chaque norme décrivant la donnée et comment la traiter :)

Gardez juste en tête que un identifiant = Universal Label (UL) = un type de données.

Voyons maintenant la partie Length d'un KLV

Notes