About the AGV file video georeferencing tags

A video layer's display is positioned on the globe using the georeferencing information defined inside the AGV file. For video layers that access a file or folder of frames, this will define the surrounds inside which the video will play. For custom DLL video layers, it will provide an initial location to zoom to if you choose to zoom to the layer's extent.

There are three options for defining a video layer's georeferencing details:

A rotated bounding box

This georeferencing option is designed for videos that are rectangular because they point directly down at the surface of the globe. This is often the case for GIS analysis results that have been exported to a video. The AGV file will identify this video source by containing the connection information inside these XML tags: <VideoGeoReferencing ProjectionType="Ortho"> and </VideoGeoReferencing>, as shown in the example XML text below.

The georeferencing details will be contained by the tags: <OrthoGraphicLocation> and <\OrthoGraphicLocation>.

You will also need to define the following:

The gray outline shows the x,y coordinates, the blue arrow shows the rotation angle, and the dot in the center of the box is the rotation pivot point. The solid green box is the extent of the video layer when it is displayed in ArcGlobe.

Example

The following is an example rotated bounding box video projection:

<VideoGeoReferencing ProjectionType="Ortho">
 <OrthoGraphicLocation>
	 <North>38.0</North>
  <East>-120.0</East>
  <West>-123.0</West>
  <South>37.0</South>
  <Rotation>45.0</Rotation>
 </OrthoGraphicLocation>
 </VideoGeoReferencing>

Two 3D points

This georeferencing option is designed for videos where the camera's location and the centerpoint of where it is aimed are known. This information is often defined for traffic cameras or security videos. The AGV file will contain this kind of georeferencing information inside these XML tags: <VideoGeoReferencing ProjectionType="Camera"> and </VideoGeoReferencing>, as shown in the example XML text below.

The information for this method of video georeferencing is defined in four sections:

The top green circle is the CameraPosition point, and the red circle is the FrameCenterPosition point.Positive angles will roll the camera to the right, and negative angles will roll the camera to the left.

Example

The following is an example of two 3D points video projection:

<VideoGeoReferencing ProjectionType="Camera">
 <CameraFOVAngle>55</CameraFOVAngle>
 <CameraPosition>
  <Longitude>-75.16949951808976</Longitude>
  <Latitude>39.958137211454</Latitude>
  <Elevation>42.0</Elevation>
 </CameraPosition>
 <FrameCenterPosition>
  <Longitude>-75.16949951808976</Longitude>
  <Latitude>39.958137211454</Latitude>
  <Elevation>3.85</Elevation>
 </FrameCenterPosition>
 <Roll>10</Roll>
</VideoGeoReferencing>

One 3D point and angles

This georeferencing option is designed for videos where the camera's location, and the azimuth (compass bearing) and tilt of the camera, is known. This information is often defined for traffic cameras or security videos. This option is also useful for videos that have very minimal georeferencing details because these values can often be deduced through trial and error. The AGV file will contain this kind of georeferencing information inside these XML tags: <VideoGeoReferencing ProjectionType="Camera"> and </VideoGeoReferencing>, as shown in the example XML tags below.

The information for this method of video georeferencing is defined in three sections, including six types of tag values:

Example

<VideoProjectionType="Camera">
 <Camera>
 <FOVAngle>55.0</FOVAngle>
 <CameraPosition>
  <Longitude>-117.194374</Longitude>
  <Latitude>34.056886</Latitude>
  <Elevation>405.0</Elevation>
 </CameraPosition>
 <Heading>45.0</Heading>
 <Tilt>45.0</Tilt>
 <Range>30.0</Range>
 <Roll>0.0</Roll>
</Camera>

Related Topics

3/5/2014