######################################################################

#
# v2.60b00 note: As of 2006 Aug 14, neither the export functionality
# nor the text of this document has been updated. v2.60b00 *should*
# provide similar export functionality to v2.51b1, as described below.
# Note however, that the newer information fields are not yet available
# and that the export functiionality of v2.60b00 has yet to be tested.
#
# Last Revised: 7 Aug 2004 for v2.51b1
#
# This is a sample "export format" file.
#
# Note: You must restart GSpot after changing a format
# file if you want the changes to take effect.
#
# 16 Aug: Updated for v2.51. Added interlace related fields.
#
# 7 Aug: added aspect ratio conversion related fields
#
# +-------------------------------------------------------------------
# | update: 19 July 2004
# | ----------------------
# | GSpot 2.5b7+ features a new, improved export function. The single
# | letter field names of previous versions have been replaced with
# | the names listed below. Note that each name now requires a pair of
# | "%" characters - one at the begining and one at the end.
# |
# | These versions of GSpot have a pair of selectable built-in generic
# | default formats. This file produces something similar (though a bit
# | nicer) than the second of those built-in formats ("info" style).
# |
# | To make it more usable, the new items are individual, they are no
# | longer tied to the display windows which group several different
# | items together. Furthermore, extraneous text has been eliminated,
# | in particular on all numeric items (e.g. "29.97", not "29.97 FPS").
# | This is more "spreadsheet friendly", and, of course, still allows
# | you to add the designations yourself in any way desired.
#
# -------
# A file such as this can be used to define the content and arrangement
# of exported data by selecting the "Custom, using the format file below"
# option in the Export Setup dialog.
#
# In this file, lines beginning with a "#" symbol, such as the lines you
# are reading, are ignored. All other text is reproduced exactly as
# typed, except for the special field names below; in that case the pair
# field name is replaced with actual data for the corresponding actual
# field. Field names are always surrounded by a pair of "%" characters.
#
# In addition to the field names, there are a handful of other "escape"
# codes, i.e. sequences of characters which are replaced with something
# else in the actual output. The only ones currently defined are "\r",
# "\n" and "\t" - these are described below as well. Note that you must
# include "\r\n" or "\n" codes if you expect your exported output to have
# more than one line per movie file examined. For example,
#
# Name: %FILE_NAME%
# Size: %FILE_LENGTH%
# Duration: %VIDEO_DURATION%
#
# comes out something like
#
# Name: MyMovie.aviLength: 1,234,567 bytesDuration: 00:37:12
#
# which is probably not what you want. The correct way to do it is
# something like:
#
# Name: %FILE_NAME% \r\n
# Size: %FILE_LENGTH% \r\n
# Duration: %VIDEO_DURATION% \r\n
#
# The advantage, though, is if for those who want single very lines, typically
# for export to a spreadsheet. e.g.:
#
# %FILE_NAME%\t%FILE_SIZE%\t%VIDEO_DURATION%
#
# can also be expressed
#
# %FILE_NAME%\t
# %FILE_SIZE%\t
# %VIDEO_DURATION%\t
#
# which is nice, especially if there are dozens of items involved

# Escape codes
# ============
# \r\n new line (for Windows/DOS text)
# \n new line (Unix style)
# \t tab character
#
# The field are shown below. They're no longer part of this comment,
# rather they comprise the actual format specifications should this
# file be specified as the format file:

--- File Information ---

\r\n
File Name: %FILE_NAME%
\r\n
File Name (with full path): %FILE_NAME_WITH_PATH%
\r\n
File Size (in bytes): %FILE_SIZE%
\r\n
\r
\n
--- Container Information ---
\r\n
Base Type (e.g "AVI"): %CONT_BASETYPE%
\r\n
Subtype (e.g "OpenDML"): %CONT_SUBTYPE%
\r\n
Interleave (in ms): %CONT_INTERLEAVE_TIME%
\r\n
Preload (in ms): %CONT_INTERLEAVE_PRELOAD%
\r\n
Audio alignment("split across interleaves"): %CONT_INTERLEAVE_ALIGN%
\r\n
Total System Bitrate (kbps): %CONT_TOTAL_BITRATE%
\r\n
Bytes Missing (if any): %CONT_BYTES_MISSING%
\r\n
Number of Audio Streams: %CONT_AUDIO_STREAM_COUNT%
\r\n
\r
\n
--- Video Information ---
\r\n
Video Codec Type(e.g. "DIV3"): %VIDEO_CODEC_TYPE%
\r\n
Video Codec Name(e.g. "DivX 3, Low-Motion"): %VIDEO_CODEC_NAME%
\r\n
Video Codec Status(e.g. "Codec Is Installed"): %VIDEO_CODEC_STATUS%
\r\n
Duration (hh:mm:ss): %VIDEO_DURATION%
\r\n
Frame Count: %VIDEO_FRAME_COUNT%
\r\n
Frame Width (pixels): %VIDEO_SIZE_X%
\r\n
Frame Height (pixels): %VIDEO_SIZE_Y%
\r\n
Storage Aspect Ratio("SAR")" %VIDEO_SAR%
\r\n
Pixel Aspect Ratio ("PAR"): %VIDEO_PAR%
\r\n
Display Aspect Ratio ("DAR"): %VIDEO_DAR%
\r\n
Fields Per Second: %VIDEO_FIELDS_PER_SEC%
\r\n
Frames Per Second: %VIDEO_FRAMES_PER_SEC%
\r\n
Pics Per Second: %VIDEO_PICS_PER_SEC%
\r\n
Video Bitrate (kbps): %VIDEO_BITRATE%
\r\n
MPEG-4 ("MPEG-4" or ""): %VIDEO_MPEG4%
\r\n
B-VOP ("B-VOP" or ""): %VIDEO_MPEG4_BVOP%
\r\n
QPel ("QPel" or ""): %VIDEO_MPEG4_QPEL%
\r\n
GMC ("GMC" or ""): %VIDEO_MPEG4_GMC%
\r\n
NVOP ("NVOP" or ""): %VIDEO_MPEG4_NVOP%
\r\n
H264 ("H264" or ""): %VIDEO_H264%
\r\n
Quality Factor (bits/pixel)/frame: %VIDEO_QF%"
\r\n
\r
\n
MPEG-2 ("MPEG-2" or ""): %VIDEO_MPEG2%
\r\n
Interlaced ("I/L" or ""): %VIDEO_MPEG2_I_L%
\r\n
Progressive ("Prog" or ""): %VIDEO_MPEG2_PROG%
\r\n
Top Frame First ("TFF" or ""): %VIDEO_MPEG2_TFF%
\r\n
Bottom Frame First ("BFF" or ""): %VIDEO_MPEG2_BFF%
\r\n
3:2 Pulldown ("3:2" or ""): %VIDEO_MPEG2_3X2%
\r\n
Picture-per-field ("PPF" or ""): %VIDEO_MPEG2_PPF%
\r\n
\r
\n
--- Aspect Ratio Related ---
\r\n
\r
\n
Broadcast standard: "PAL" (else blank) %VIDEO_ASPECT_TYPE_PAL%
\r\n
Broadcast standard: "NTSC" (else blank) %VIDEO_ASPECT_TYPE_NTSC%
\r\n
src:"VCD", "SVCD", "CVD", or "DVD (else blank): %VIDEO_ASPECT_SOURCE_MATCH%
\r\n
Instructions to convert to VCD, first part: %VIDEO_ASPECT_CONVERT_VCD1%
\r\n
Instructions to convert to VCD, second part: %VIDEO_ASPECT_CONVERT_VCD2%
\r\n
Instructions to convert to SVCD, first part: %VIDEO_ASPECT_CONVERT_SVCD1%
\r\n
Instructions to convert to SVCD, second part: %VIDEO_ASPECT_CONVERT_SVCD2%
\r\n
Instructions to convert to CVD, first part: %VIDEO_ASPECT_CONVERT_CVD1%
\r\n
Instructions to convert to CVD, second part: %VIDEO_ASPECT_CONVERT_CVD2%
\r\n
Instructions to convert to DVD, first part: %VIDEO_ASPECT_CONVERT_DVD1%
\r\n
Instructions to convert to DVD, second part: %VIDEO_ASPECT_CONVERT_DVD2%
\r\n
Instructions to convert to AVI, first part: %VIDEO_ASPECT_CONVERT_AVI1%
\r\n
Instructions to convert to AVI, second part: %VIDEO_ASPECT_CONVERT_AVI2%
\r\n
\r
\n
--- Audio Information ---
\r\n
MPEG Stream ID (e.g. "0xbd"): %AUDIO_MPEG_STREAM_ID%
\r\n
MPEG VOB file Substream(e.g. "0x80"): %AUDIO_MPEG_SUBSTREAM_ID%
\r\n
Audio Codec (e.g. "AC3"): %AUDIO_CODEC%
\r\n
Audio Codec Status (e.g. "Codec Is Installed"): %AUDIO_CODEC_STATUS%
\r\n
Audio Sample Rate (Hz): %AUDIO_SAMPLE_RATE%
\r\n
Audio Bitrate(kbps): %AUDIO_BITRATE%
\r\n
Audio Bitrate Type ("CBR" or "VBR"): %AUDIO_BITRATE_TYPE%
\r\n
Audio Channel Count (e.g. "2" for stereo): %AUDIO_CHANNEL_COUNT%
\r\n

# Note: The \r\n sequences are all "lined up" for clarity, but there is no need
# to do so - in fact, this format creates a file with a lot of "trailing blanks"
# which may not be particularly desireable. The alternative is something like:
#
# --- Audio Information ---\r\n
# MPEG Stream ID (e.g. "0xbd"): %AUDIO_MPEG_STREAM_ID%\r\n
# MPEG VOB file Substream(e.g. "0x80"): %AUDIO_MPEG_SUBSTREAM_ID%\r\n
#
# etc.
#

# Note: For audio, information from other streams is available by appending

# "_2", "_3", or "_4" for streams 2, 3 and 4 respectively. The % char must
# still be last, of course (e.g. "%AUDIO_BITRATE_3%", not "%AUDIO_BITRATE%_3").
#
# This is untested and may not be fully supported.
#