###################################################################### # # 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: \r\n File Name (with full path): \r\n File Size (in bytes): \r\n \r\n --- Container Information --\r\n Base Type (e.g "AVI"): \r\n Subtype (e.g "OpenDML"): \r\n Interleave (in ms): \r\n Preload (in ms): \r\n Audio alignment("split across interleaves"): \r\n Total System Bitrate (kbps): \r\n Bytes Missing (if any): \r\n

%FILE_NAME% %FILE_NAME_WITH_PATH% %FILE_SIZE%

%CONT_BASETYPE% %CONT_SUBTYPE% %CONT_INTERLEAVE_TIME% %CONT_INTERLEAVE_PRELOAD% %CONT_INTERLEAVE_ALIGN% %CONT_TOTAL_BITRATE% %CONT_BYTES_MISSING%

Number of Audio Streams: \r\n \r\n --- Video Information --\r\n Video Codec Type(e.g. "DIV3"): \r\n Video Codec Name(e.g. "DivX 3, Low-Motion"): \r\n Video Codec Status(e.g. "Codec Is Installed"): \r\n Duration (hh:mm:ss): \r\n Frame Count: \r\n Frame Width (pixels): \r\n Frame Height (pixels): \r\n Storage Aspect Ratio("SAR")" \r\n Pixel Aspect Ratio ("PAR"): \r\n Display Aspect Ratio ("DAR"): \r\n Fields Per Second: \r\n Frames Per Second: \r\n Pics Per Second: \r\n Video Bitrate (kbps): \r\n MPEG-4 ("MPEG-4" or ""): \r\n B-VOP ("B-VOP" or ""): \r\n QPel ("QPel" or ""): \r\n GMC ("GMC" or ""): \r\n NVOP ("NVOP" or ""): \r\n H264 ("H264" or ""): \r\n Quality Factor (bits/pixel)/frame: \r\n \r\n MPEG-2 ("MPEG-2" or ""): \r\n Interlaced ("I/L" or ""): \r\n Progressive ("Prog" or ""): \r\n Top Frame First ("TFF" or ""): \r\n Bottom Frame First ("BFF" or ""): \r\n

%CONT_AUDIO_STREAM_COUNT%

%VIDEO_CODEC_TYPE% %VIDEO_CODEC_NAME% %VIDEO_CODEC_STATUS% %VIDEO_DURATION% %VIDEO_FRAME_COUNT% %VIDEO_SIZE_X% %VIDEO_SIZE_Y% %VIDEO_SAR% %VIDEO_PAR% %VIDEO_DAR% %VIDEO_FIELDS_PER_SEC% %VIDEO_FRAMES_PER_SEC% %VIDEO_PICS_PER_SEC% %VIDEO_BITRATE% %VIDEO_MPEG4% %VIDEO_MPEG4_BVOP% %VIDEO_MPEG4_QPEL% %VIDEO_MPEG4_GMC% %VIDEO_MPEG4_NVOP% %VIDEO_H264% %VIDEO_QF%"

%VIDEO_MPEG2% %VIDEO_MPEG2_I_L% %VIDEO_MPEG2_PROG% %VIDEO_MPEG2_TFF% %VIDEO_MPEG2_BFF%

3:2 Pulldown ("3:2" or ""): \r\n Picture-per-field ("PPF" or ""): \r\n \r\n --- Aspect Ratio Related --\r\n \r\n Broadcast standard: "PAL" (else blank) \r\n Broadcast standard: "NTSC" (else blank) \r\n src:"VCD", "SVCD", "CVD", or "DVD (else blank): \r\n Instructions to convert to VCD, first part: \r\n Instructions to convert to VCD, second part: \r\n Instructions to convert to SVCD, first part: \r\n Instructions to convert to SVCD, second part: \r\n Instructions to convert to CVD, first part: \r\n Instructions to convert to CVD, second part: \r\n Instructions to convert to DVD, first part: \r\n Instructions to convert to DVD, second part: \r\n Instructions to convert to AVI, first part: \r\n Instructions to convert to AVI, second part: \r\n \r\n --- Audio Information --\r\n MPEG Stream ID (e.g. "0xbd"): \r\n MPEG VOB file Substream(e.g. "0x80"): \r\n Audio Codec (e.g. "AC3"): \r\n Audio Codec Status (e.g. "Codec Is Installed"): \r\n Audio Sample Rate (Hz): \r\n Audio Bitrate(kbps): \r\n Audio Bitrate Type ("CBR" or "VBR"): \r\n Audio Channel Count (e.g. "2" for stereo): \r\n

%VIDEO_MPEG2_3X2% %VIDEO_MPEG2_PPF%

%VIDEO_ASPECT_TYPE_PAL% %VIDEO_ASPECT_TYPE_NTSC% %VIDEO_ASPECT_SOURCE_MATCH% %VIDEO_ASPECT_CONVERT_VCD1% %VIDEO_ASPECT_CONVERT_VCD2% %VIDEO_ASPECT_CONVERT_SVCD1% %VIDEO_ASPECT_CONVERT_SVCD2% %VIDEO_ASPECT_CONVERT_CVD1% %VIDEO_ASPECT_CONVERT_CVD2% %VIDEO_ASPECT_CONVERT_DVD1% %VIDEO_ASPECT_CONVERT_DVD2% %VIDEO_ASPECT_CONVERT_AVI1% %VIDEO_ASPECT_CONVERT_AVI2%

%AUDIO_MPEG_STREAM_ID% %AUDIO_MPEG_SUBSTREAM_ID% %AUDIO_CODEC% %AUDIO_CODEC_STATUS% %AUDIO_SAMPLE_RATE% %AUDIO_BITRATE% %AUDIO_BITRATE_TYPE% %AUDIO_CHANNEL_COUNT%

# 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"): MPEG VOB file Substream(e.g. "0x80"): etc.

%AUDIO_MPEG_STREAM_ID%\r\n %AUDIO_MPEG_SUBSTREAM_ID%\r\n

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.