###################################################################### # # 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_LENGTH%\t%VIDEO_DURATION% # # can also be expressed # # %FILE_NAME%\t # %FILE_LENGTH%\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 Frame Aspect Ratio (e.g "1.3333"): %VIDEO_ASPECT_DECIMAL% \r\n Frame Aspect Ratio (e.g. "4:3"): %VIDEO_ASPECT_FRAC% \r\n Pixel Aspect Ratio ("SAR"): %VIDEO_SAR% \r\n Display Aspect Ratio ("DAR"): %VIDEO_DAR% \r\n Frames Per Second: %VIDEO_FPS% \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 H264 ("H264" or ""): %VIDEO_H264% \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_3_2% \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_VCD_1% \r\n Instructions to convert to VCD, second part: %VIDEO_ASPECT_CONVERT_VCD_2% \r\n Instructions to convert to SVCD, first part: %VIDEO_ASPECT_CONVERT_SVCD_1% \r\n Instructions to convert to SVCD, second part: %VIDEO_ASPECT_CONVERT_SVCD_2% \r\n Instructions to convert to CVD, first part: %VIDEO_ASPECT_CONVERT_CVD_1% \r\n Instructions to convert to CVD, second part: %VIDEO_ASPECT_CONVERT_CVD_2% \r\n Instructions to convert to DVD, first part: %VIDEO_ASPECT_CONVERT_DVD_1% \r\n Instructions to convert to DVD, second part: %VIDEO_ASPECT_CONVERT_DVD_2% \r\n Instructions to convert to AVI, first part: %VIDEO_ASPECT_CONVERT_AVI_1% \r\n Instructions to convert to AVI, second part: %VIDEO_ASPECT_CONVERT_AVI_2% \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. #