Add features to your video in FMV

Available with Image Analyst license.

Note:

This tutorial requires ArcGIS Pro3.0+ and the ArcGIS Image Analyst extension for ArcGIS Pro. If you don't have either ArcGIS Pro 3.0+ or the Image Analystextension, get a free 21-day trial.

As part of the ArcGIS Image Analyst extension, Full Motion Video lets you view and exploit geospatially enabled video in ArcGIS Pro. This tutorial focuses on using the FMV player in ArcGIS Pro to add points in the video player display or on the map. Learn more about all the capabilities of FMV.

In this tutorial, you'll learn how to create features by marking every point at which a vehicle passes a semi-trailer truck (a "big rig") as it travels along a highway near Cheyenne, Wyoming. The truck is carrying an important load and we want to be sure it is being transported safely. When you add a video to your ArcGIS Pro project and you have the Image Analyst extension, tabs and interactive windows automatically open so you can interact with your video data directly in your project.

If you haven't already done so, familiarize yourself with the tools and options available for visualizing and exporting from the video. Learn how to work with the video player.

Before you get started, download and unzip a sample video to use with the tutorial.

Open the video

Add the video to a project in ArcGIS Pro.

1. Start ArcGIS Pro. If necessary, sign in with your ArcGIS Online or ArcGIS Enterprise credentials.

   If you have a Named User license, you must sign in to use ArcGIS Pro. If you are already signed in, your username will appear in the upper right corner of the ArcGIS Pro window.

   If you have a Single Use or Concurrent Use license, you don't need to sign in to use ArcGIS Pro as a desktop-only application. You do need to sign in with ArcGIS Online or ArcGIS Enterprise credentials to share content to your portal or to access content from a portal. For example, you need to sign in to open the project package for this tutorial.

2. When theArcGIS Pro app opens, click Settings > Licensing.

   The Licensing page appears.

3. Under Esri Extensions, find Image Analyst and confirm that under Licensed it says Yes. If it says No and you have a Named User license, check with your ArcGIS Online or ArcGIS Enterprise administrator to activate the license. If you have a Single Use license, see how to authorize an extension. Once you have reviewed licenses, click the back arrow in the top left corner to return to the landing page.
4. Select Map under the Blank Templates list to create a new project with the map template. In the Name box, type FMV Player and click OK.

   The project opens with the World Topographic basemap loaded in the map display.

5. Click the Inserttab on the ribbon above the map view. Click Add Folder and browse to the location where you downloaded the tutorial data. Select the FMV_Tutorial folder and click OK.
6. From the Catalog pane, expand Folders > FMV_Tutorial > Videos folder to see the different video files listed in the folder.
   If you do not see either the Contents or Catalog panes, click the View tab on the ribbon and choose the panes or windows you would like to see in your project.
7. Drag and drop the Truck.ts file into the Contents pane of the project.
   Three things will change in your project:

   • The Truck video will be added to the Contents pane under Standalone Videos.
   • The video player will automatically open and load the Truck video.
   • A new contextual tab set appears in the ribbon with two tabs named Standalone Video and Player. Each has a set of tools to work with the video data you added to the project.

Working with point graphics in the video

The video player tools allow you to create and display point, polyline, and polygon annotations on the video and the map. The Display features tool allows you to display features from the associated map on the video. It is important when creating features, that you pay attention to Z-Value Rules.

1. Click the play button on the video player. Watch the video and see that there are a few times when cars pass the truck.

   If the video player is too small, you can resize the player while docked, or right click the Truck tab and click Float to view the video player in its own window. Right click the Truck tab again and click Dock to return the player to its initial location.

2. Click Jump to Start to move the video time slider back to the beginning of the video.
3. Click Zoom to Video to make sure your map will display the extent of the video.
4. On the color picker, which determines the color of the video footprint on the map, select a distinctive color.
5. On the video player toolbar, click the Create and Display Annotations drop-down arrow and select Annotate Point.

   The Create Features pane appears, and the Create and Display Annotations button is highlighted on the toolbar when activated.

6. In the Create Features pane select the Driving template.
7. Click Play , then click on a car whenever it passes the truck in the video player.

   You can pause the video, rewind or fast-forward, or you can digitize a point while the video plays. Each time you click in the video, a point with the driving symbol is generated in both the video and on the map display. Turn off Create and Display Annotations when you're done.

8. If you want to restart, you can delete all the existing graphics from the map and video display by clicking the Remove Graphics button .
9. When finished, manually zoom to the full extent of the video in the map viewer and see the points you have added to the map. Using the time slider, manually navigate to the frame where the point was added in the video. You'll see that the points you added are visible in both the video and on the map.

Annotate PolylineAnnotate PolygonCreate and Display Annotations

Convert the graphics to features and synchronize

To use your points for future analysis, the graphics are saved as features in a file geodatabase named FMVAnnotations.

1. Click on the video in the Contents pane.
2. Click the Standalone Videos tab, then click Configure Workspace in the Manage group.

   The Configure Full Motion Video Workspace pane appears.

3. The default geodatabase and export folders for metadata, images, PowerPoint slides, and videos are all listed in the Configure Full Motion Video Workspace pane. Check through each one to familiarize yourself with the locations. Click OK.
4. With your point graphics still in the map and video, click the Save Graphics button at the top of the video player.

   A new layer is added to your Contents pane with the name FMV_Truck. It is a point feature class, symbolized with the same color that was given to the graphics.

   1. In the Catalog pane, navigate to the location of the default geodatabase listed in the Configure Workspace window. See that the new feature class has been stored in this geodatabase.
5. In the Contents pane, right-click on the FMV_Truck layer and select Symbology.
   1. In the Symbology pane, click the symbol to open the Format Point Symbol page. Make sure you are looking at the Gallery tab.
   2. In the Search bar, type cross and hit Enter.
   3. Select Cross 1 and click the Properties tab in the Format Point Symbol page.
   4. Change the Color to Electron Gold. You can hover your mouse over the colors to see the name (Electron Gold is a bright orange).
   5. Click Apply and close the Symbology pane.
6. In the video player, click Go to beginning to start the video at the beginning. Then click the Sync Graphics button to display the features that are on your map so that they display in the video. Click Play.

   Adding new point graphics to the map and clicking Save Graphics again will append the new features to the existing feature class. To create a new feature class for graphics, rename the existing feature class. The new feature class will have the name FMV_[video name].

Digitize features in the video

In addition to adding and converting point graphics in the video player, you can perform full feature editing tasks in the video.

1. In the Catalog pane, right-click on the project geodatabase and select New > Feature Class.
2. Type "LotMarkers" as the Name and set the Feature Class Type to Polygon. Click Finish.
3. Drag the LotMarkers feature class into the map to add it to your project.
4. On the Edit tab, in the Features group, select Create.
5. In the Truck video, use the time slider to go to 01:36. Here, the truck is driving past a parking lot on the opposite side of the highway.
   1. Click Play and watch for a few seconds.
   2. As the truck progresses, you can see multiple diamond patterns to the right of the yellow line in the parking area.
   3. Hit Pause with some of the diamond shapes visible in the video player.
   4. Use your mouse's scroll wheel if necessary to zoom in on some of the diamonds.
   5. Click the Zoom to Frame button in the video player to update your map to the current frame.
6. In the Create Features pane, select the LotMarkers template and choose the Polygon option for digitizing features.
   1. Digitize on top of the video in the video player to outline one of the diamonds.
   2. Double-click to finish the sketch. You'll see the feature appear on your map.
   3. Digitize two more diamonds.
   4. Click the Sync Graphics button to see your features appear in the video itself.
7. On the Edit tab, click Save to save your edits. Close the ArcGIS Pro project.

Visualizing and adding features to video data is only possible when you are working with an FMV-compliant video file with all the required metadata. If you have an archived video stream and an associated metadata file, you can combine them using the Video Multiplexer tool and use the resulting video file in FMV workflows. See related tutorials below to find out more about what you can do with Full Motion Video in ArcGIS Pro.