BML - isir/greta GitHub Wiki

Table of Contents

BML:

Head

Element: <head></head>
Time Markers: start, attack, sustain, end
Attributes: id, lexeme (Shake, Nod or Tilt), repetition

The lexeme attribute is usefull when no references are given. Greta will thus match the first signal in the library using the given lexeme. 

<head end="2" id="p1_0" lexeme="nod" start="0">
	<description priority="1" type="gretabml">
		<reference>Nod_Big</reference>
		<intensity>1.000</intensity>
		<SPC.value>1.000</SPC.value>
		<TMP.value>0.400</TMP.value>
		<FLD.value>0.000</FLD.value>
		<PWR.value>0.000</PWR.value>
		<REP.value>0.000</REP.value>
		<OPN.value>0.000</OPN.value>
		<TEN.value>0.000</TEN.value>
	</description>
</head>

Gesture

The gestures have been extended in Greta with expressivity parameters. Therefore, when using a gesture in Greta, we are using the following extended BML description. 

<gesture id="g01" lexeme="performative=refuse_Ges_L" start="2" end="5">
	<description priority="1" type="gretabml">
		<reference>performative=refuse_Ges_L</reference>
		<intensity>1.000</intensity>
		<SPC.value>0.646</SPC.value>
		<TMP.value>-0.400</TMP.value>
		<FLD.value>0.000</FLD.value>
		<PWR.value>0.000</PWR.value>
		<REP.value>0.000</REP.value>
		<OPN.value>0.000</OPN.value>
		<TEN.value>0.000</TEN.value>
	</description>
</gesture>

Torso 

<greta:torso xmlns:greta="gretaNameSpace" end="10" id="torso1"
	lexeme="BackwardSagittalRightLateral" start="0.000">
	<description priority="1" type="gretabml">
		<reference>BackwardSagittalRightLateral</reference>
		<intensity>1.000</intensity>
		<SPC.value>0.000</SPC.value>
		<TMP.value>0.000</TMP.value>
		<FLD.value>0.000</FLD.value>
		<PWR.value>0.000</PWR.value>
		<REP.value>0.000</REP.value>
		<OPN.value>0.000</OPN.value>
		<TEN.value>0.000</TEN.value>
	</description>
</greta:torso>

Shoulders

Standard BML does not allow for defining shoulders movements. For this reason the tag shoulders has been added. The shoulders movement can defined along two axes.

NAMESPACE:
ELEMENT: <shoulders></shoulders>
SYNC POINTS: start, attackPeak, relax, end, Core extensions overshoot
ATTRIBUTES: id, lexeme, amount, repetition, side, sync attributes
CONTENTS: none 
<bml xmlns="http://www.bml-initiative.org/bml/bml-1.0" xmlns:ext="http://www.bml-initiative.org/bml/coreextensions-1.0" xmlns:greta="http://perso.telecom-paristech.fr/~pelachau/Greta/" character="Greta" id="bml1">
	<shoulder id="sh1" start="1.0" end="3.0" lexeme="up" side="both" amount="1">
	</shoulder>
</bml>
Example: Raise both arms for 2 seconds.

Attribute Details:

Attribute Type Use Default Description
lexeme closedSetItem required One of [UP|FRONT|BACK|SHAKE]
amount float 1 intensity
repetition int 1 number of repetitions for shake
side closedSetItem both One of [left|righ|both]

BML FileReader

This module is a SignalEmitter that reads a BML file and translate it into Signals.

⚠️ **GitHub.com Fallback** ⚠️