FrozenNorth.Gpmf 1.0.0

Gpmf

Extracts GPMF data from MP4 files.

API

FrozenNorth.Gpmf

/// <summary>
/// Loads the GPMF items from an MP4 file.
/// </summary>
/// <param name="fileName">Full path and file name.</param>
/// <returns>List of GPMF items.</returns>
public static GpmfItems LoadMP4(string fileName)

/// <summary>
/// Gets the device name from a list of GPMF items.
/// </summary>
/// <param name="gpmfItems">List of GPMF items to search through.</param>
/// <param name="defaultName">Default device name if one isn't found.</param>
/// <returns>Device name.</returns>
public static string GetDeviceName(GpmfItems gpmfItems, string defaultName = "GoPro")

/// <summary>
/// Gets a Gpx object representing the GPS items within a list of GPMF items.
/// </summary>
/// <param name="gpmfItems">List of GPMF items to search through.</param>
/// <returns>Gpx object.</returns>
public static Gpx.Gpx GetGpx(GpmfItems gpmfItems)

Classes

FrozenNorth.Gpmf

Gpmf
GpmfItem
GpmfItems

Usage

using FFmpeg.AutoGen;
using FrozenNorth.Gpx;
using FrozenNorth.Gpmf;

// get the file names
string videoFileName = ...
string gpxFileName = Path.ChangeExtension(videoFileName, "gpx");

// configure FFMPEG
Assembly assembly = Assembly.GetExecutingAssembly();
ffmpeg.RootPath = Path.Combine(Path.GetDirectoryName(assembly.Location), "FFmpeg");

// get the GPMF items
GpmfItems gpmfItems = Gpmf.LoadMP4(videoFileName);

// get the GPS items as a GPX object
Gpx gpx = Gpmf.GetGpx(gpmfItems);

// save the GPX object to a file
if (gpx.Tracks.Count > 0)
{
    Version version = assembly.GetName().Version;
    gpx.Creator = "ExtractGPX " + version.ToString((version.Revision != 0) ? 3 : 2);
    gpx.Tracks[0].Name = Path.GetFileName(videoFileName);
    GpxWriter.Save(gpx, gpxFileName);
}
else
{
    Console.WriteLine("ERROR: No GPS data found in MP4 file.");
}

Attributions

This project uses the following NuGet packages:

• FFmpeg.AutoGen
• FrozenNorth.Gpx

The icon is from the IconMarketPK package on FlatIcon.

License

MIT License

Copyright © 2023 Shawn Baker