<?xml version="1.0"?>
<!DOCTYPE module SYSTEM "vace_module_v1_2.dtd">

<!-- Example: Face Recognition -->
<!--
For the semantics of each attribute values, please refer to the
documentation in Module Template, 'vace_module_v1_2.xml'.
-->

<module>

<module_description
	name="face"
	version="3.0"
	producer="Carnegie Mellon University"
	locator=""
	functionality="face recognition"
	other_tags="e.g., thumbnail icon for types of processing, etc."
/>

<module_input>
<!--
Description:
The image input to this face module is specified in two different ways.
1. An input video is provided.  The two input images are specified
   by the 'keyframe' elements.  This is shown in the first 'input' element,
   which has an 'input_id=1'.
2. The second method provides the two images directly, as shown in the
   second and third 'input' elements.
Although either one of these methods is sufficient to indicate which images
are used for face recognition, we provide both here to demonstrate the
use of the 'input' element.
-->
<!--
Notes:
1. 'media_name' uses the filename of the video
2. Range specification can be in either or both of time and frame;
   in this example, only frame is being used.
-->
	<input
		media_type="video"
		media_format="mpeg1"
		media_name="sample1.mpg"
		media_locator="\\VideoServer\vace\video\sample1.mpg"
		input_id="1"
		frame_range="0:20020"
		frame_rate="29.97"
	>
		<keyframe
			frame_order="1"
			frame_offset="77"
		/>
		<keyframe
			frame_order="2"
			frame_offset="110"
		/>
	</input>
	<input
		media_type="image"
		media_format="jpeg"
		media_name="sample1_1.jpg"
		media_locator="\\VideoServer\vace\image\sample1_1.jpg"
		input_id="2"
		frame_range="77:77"
	>
	</input>
	<input
		media_type="image"
		media_format="jpeg"
		media_name="sample1_2.jpg"
		media_locator="\\VideoServer\vace\image\sample1_2.jpg"
		input_id="3"
		frame_range="110:110"
	>
	</input>
</module_input>

<module_output>
<!--
Description:
Only one face (indicated as the first object, 'object_id=1')
is identified from the second image, which has two references:
1) frame_range="110:110"
2) input_reference="3" (added in version 1.2)
-->
	<object			
		object_type="face"
		object_id="1"
		indexed_text=""
		label_text=""
		frame_range="110:110"
		keyframe_frame="110"
		bounding_box="30 40 130 140"
		input_reference="3"
	/>
</module_output>

<processing_status date_processed="June 20, 2001" exit_status="0" />

</module>

