Skip to content

Latest commit

 

History

History
178 lines (104 loc) · 8.98 KB

Using.md

File metadata and controls

178 lines (104 loc) · 8.98 KB

How use QGIS FMV

For the use of the QGIS FMV plugin you must have the requirements previously installed.

Once you have them, click on the icon that will appear in QGIS, to open the manager.

Table of Contents

Video Manager

From the manager, you can open and manage your play list. To add a video, (if the video is already MISB compliant) simply click on File -> Open Video File and select a video file from the dialog window to add it to the play list.

Multiplexor

If your video is not MISB compliant, you will have to create it via the Multiplexor. To do this you will need the telemetry file that corresponds to the video. This file can be found in your Ground Control Station (phone or tablets) file folder.

  • The folder path will look similar to this: Pixel 3 XL\DJI\Dji.go.v4\FlightRecords
  • The file you need will look like this: DJIFlightRecord_2018-10-25_[10-34-38]

Convert it to .csv using the CsvView tool Simply open the telemetry file in CsvView and save it out as a .csv file.

Other way to create it is, go to DJI Flight Log Viewer site, import the .txt and click in the Download Verbose CSV option.

Once this is done you can use the Multiplexor to create a MISB compliant video.

From the manager simpy click on File -> Create MISB File, select the video and the corresponding telemetry file. There is an option to modify the Horizontal and Vertical Fields of View if necessary.

Note: The FOV are crucial for correct corner points calculation, so have a look at your DJI manual to get the correct numbers.

Note: If you have more than one video recorded in a flight, the Multiplxor tool needs to identify each recodring event. Simply select Extract Recordings Then select the corresponsing recording to the video as it was captured. Ex: If you started and stopped the video 3 times over the course of one flight and want to use the second one. The Multiplexor tool will find three Recordings. Chose the matching one, the second one.

Once all information has been provided select the Create MISB button. It will load the new file into the Video Manager.

IMPORTANT: This only works with DJI data for now

If you want to play a video after adding it to the play list, double-click on any video in the manager and the player will be opened playing the selected video. For playing another video, it is not necessary to close the player, just click on a different video and it will be played.

If you want to remove it from the list, click on the selected video, click on the mouse right button hover on row that you want and then on Remove fron list.

Video Player

The player is the plugin core and the most important part.

General Tools

The options offered are the following:

  • Filters: This option applies the selected filter on the video in real time.

  • Frames: This option extracts the current frame, all the frames of the video or capture current georeferenced frame. To do it, you have to select one of these options and to select the destination directory; then, a background process will start that will store the current frame or all the video frames in this folder.

  • Metadata: This option opens a dock, where you can see the information extracted from the video.This dock can move where we want.

If we want to save the information about the current frame we can do it in a .csv file or in a more elaborated report in .pdf. For them, simply click on Save and select option.

  • Conversion: This option allows to convert the video into a different format. To do it, you have to select the corresponding extension in the save dialog window.

  • Video information: This option allows to save the video information in json format o to show the information in a dialog window.

  • Plot: This option allows to show or save the information about the audio or video channels.If the video has no audio, the audio options are disabled.

  • Map: This option centers the map on the platform, footprint or target.If we deactivate any of the options, the centering is free for the user.

  • Record: This option extracts parts of the video and store them in the destination directory.

  • Mosaic: This option extracts all the georeferenced frames in real time and adds them to the canvas in a new group. While the button is checked its function is performed.

  • Cursor Coordinates: This option allows you to see the cursor coordinates in WGS84 or MGRS (Military Grid Reference System).

The player also offers the typical options such as stop, rewind, fast-forward, go to the first or last frame and volume controller.

If we want to hide these options, simply click on and If we right click on the video we can see a menu, with the options that we see in the following image.

Utils Toolbar

The utility bar offers us tools to interact with the video. This bar can hide it if we right click and unchecking the option "Utils Toolbar".

If on the contrary we want to leave it but we don't like where it is, we can move it where we want,

The options offered are the following:

  • Magnifying Glass: This option zooms the part of the video in which the magnifying glass is located. To use it, we can left click on the video or if we want to move it fluidly,, we must keep pressing the left click and move the mouse. We can change its shape between circle and square.

  • Draw Polygon: This option allows you to draw a polygon on the video. This drawing will be drawn on the canvas too. We can erase the last drawing or all.

  • Draw Point: This option allows you to draw a point on the video. This drawing will be drawn on the canvas too. We can erase the last drawing or all.

  • Draw Polyline: This option allows you to draw a polyline on the video. This drawing will be drawn on the canvas too. We can erase the last drawing or all.

  • Measure Distance: This option allows us to measure the distance in meters over the video.

  • Measure Area: This option allows us to measure the area in square meters and square kilometers over the video.

  • Censure: This option allows you to draw a black area on the video. This drawing will be drawn on the canvas too. We can erase the last drawing or all.

  • Stamp: This option allows us to put the "Confidential" mark on the video.

  • Object Tracking: This option allows us to make a rectangle on the video and follow an object. The trajectory of the object followed is painted on the canvas.

Customize Plugin

In this option we can modify the parameters of the magnifying glass and the drawing parameters. To access this menu we must right click and select the option Options.

And magnifying glass options tab, And drawings options tab,

These values are saved in the general configuration of QGIS,so if you want to return to the original colors of the plugin, you must select Default color.

Shortcuts

Some options are also available through keyboard shortcuts and clicking on the mouse right button on the video.

Shortcut Keys Description
Alt+F Open FMV
Alt+A Show about
Ctrl+T show metadata/telemetry dock
Ctrl+R Record Video
Ctrl+M Create mosaic from video
Ctrl+Q Capture Current Frame
Ctrl+U Mute/Unmute
Ctrl+A Extract All Frames
Ctrl+Shift+P Save metadata/telemetry as PDF
Ctrl+Shift+C Save metadata/telemetry as CSV
Ctrl+Left Start Of Media
Left Rewind
Ctrl+S Stop
Ctrl+P Play/Pause
Right Forward
Ctrl+Right End Of Media
Ctrl+L Repeat

Enjoy!