File naming

From edgertronic high speed video camera
Revision as of 20:04, 19 April 2019 by Tfischer (talk | contribs) (File naming parameters)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

This feature is anticipated to be part of the 2.3 software release.

Software 2.2 and older file naming

File naming

Up through software revision 2.2, when a video was captured and saved, the file naming convention used was:


where &T is replaced with the seconds from the start of the computer epoc (Jan 1, 1970) GMT.

For multishot videos, the file naming convention was:


where &b is replaced with the multishot buffer number.

For selective save, the start and end frame are included in the filename:


A similar pattern is used for the metadata file:


Directory naming

The video files and metadata files were stored in the directory named DCIM. The directory can either be on the SD card, USB storage device, or network storage device. The camera creates the directory if it doesn't exist.

CAMAPI trigger() file naming

The CAMAPI trigger() method accepts an optional parameter to allow you to specify the filename at the time a software controlled trigger is used.

Software 2.499 and newer file naming

User specified file naming

A more flexible file naming scheme is supported in software revision 2.3. The request dictionary passed to the CAMAPI configure_camera() method supports the dictionary key requested_filename_pattern, allowing you to specify the filename pattern to be used. See the Software 2.2 compatibility section for a special format that can be used to maintain compatibility with previously released camera software.

If the configure_camera() requested dictionary parameter doesn't specify a file name pattern, then a pattern that compiles with the Design rules for Camera File system (DCF) is used. The default file naming pattern is:


where &c is a 5 digit number indicating the movie save count since the last factory reset.

The file is stored in a two-deep directory tree which follows the pattern DCIM/100EDGER. When the camera powers on, or the storage media is changed, the camera either uses an existing two-deep directory or creates a new one. The camera locates the ???EDGER directory that has the largest 3 digit number (such as 105EDGER). If there are more than 200 files in the selected directory, then the camera will create a new directory with the three digit number incremented by one beyond the largest directory number (e.g. the next directory would be 106EDGER). This algorithm follows the Design rules for Camera File system (DCF) specification.

File naming parameters

The following ampersand parameters can be included in the requested_filename_pattern entry in the requested settings dictionary that is passed to CAMAPI configure_camera() / run() methods. When the video file or associated metadata file is saved, the camera will substitute the actual value in place of the ampersand parameter.

Variable Camera Setting
&D Default version 2.2 naming scheme (described above)
&m Camera model - SC1 SC2X, etc.
&n Serial number
&b Multishot buffer
&d Trigger date (DD-MMM-YY)
&e Ending frame number where frame 0 is the trigger frame
&s Starting frame number where frame 0 is the trigger frame
&t Trigger time (HH-MM-SS)
&T Trigger time (seconds since Jan 1, 1970)

To keep from overwriting an existing files, once the above substitutions are done, if the created filename will overwrite an existing file, then an underscore and a letter is appended to make the filename unique.

CAMAPI file naming support

There are several ways CAMAPI supports user specified filenames, list in highest to lowest priority order:

  • selective_save() parameter
  • trigger() parameter
  • requested_filename_pattern key in dictionary passed to run()

The filename is determined at the time the camera starts saving the movie file and metadata file. If the user trims the video while saving, the filename might change if the ending video frame number is included in the filename.