home *** CD-ROM | disk | FTP | other *** search
/ PC World 2006 October / PCWorld_2006-10_cd.bin / temacd / gspot / gspot260b00.exe / ExportFormat.txt next >
Text File  |  2006-08-14  |  10KB  |  180 lines
  1. ######################################################################
  2. #
  3. # v2.60b00 note: As of 2006 Aug 14, neither the export functionality
  4. # nor the text of this document has been updated. v2.60b00 *should*
  5. # provide similar export functionality to v2.51b1, as described below.
  6. # Note however, that the newer information fields are not yet available
  7. # and that the export functiionality of v2.60b00 has yet to be tested.
  8. #
  9. # Last Revised: 7 Aug 2004 for v2.51b1
  10. #
  11. # This is a sample "export format" file.
  12. #
  13. # Note: You must restart GSpot after changing a format
  14. #        file if you want the changes to take effect.
  15. #
  16. #  16 Aug: Updated for v2.51. Added interlace related fields.
  17. #
  18. #  7 Aug:  added aspect ratio conversion related fields
  19. #
  20. # +-------------------------------------------------------------------
  21. # | update: 19 July 2004
  22. # | ----------------------
  23. # | GSpot 2.5b7+ features a new, improved export function. The single
  24. # | letter field names of previous versions have been replaced with
  25. # | the names listed below. Note that each name now requires a pair of
  26. # | "%" characters - one at the begining and one at the end.
  27. # |
  28. # | These versions of GSpot have a pair of selectable built-in generic
  29. # | default formats. This file produces something similar (though a bit
  30. # | nicer) than the second of those built-in formats ("info" style).
  31. # |
  32. # | To make it more usable, the new items are individual, they are no
  33. # | longer tied to the display windows which group several different
  34. # | items together. Furthermore, extraneous text has been eliminated,
  35. # | in particular on all numeric items (e.g. "29.97", not "29.97 FPS").
  36. # | This is more "spreadsheet friendly", and, of course, still allows
  37. # | you to add the designations yourself in any way desired.
  38. #
  39. # -------
  40. # A file such as this can be used to define the content and arrangement
  41. # of exported data by selecting the "Custom, using the format file below"
  42. # option in the Export Setup dialog.
  43. #
  44. # In this file, lines beginning with a "#" symbol, such as the lines you
  45. # are reading, are ignored. All other text is reproduced exactly as
  46. # typed, except for the special field names below; in that case the pair
  47. # field name is replaced with actual data for the corresponding actual
  48. # field. Field names are always surrounded by a pair of "%" characters.
  49. #
  50. # In addition to the field names, there are a handful of other "escape"
  51. # codes, i.e. sequences of characters which are replaced with something
  52. # else in the actual output. The only ones currently defined are "\r",
  53. # "\n" and "\t" - these are described below as well. Note that you must
  54. # include "\r\n" or "\n" codes if you expect your exported output to have
  55. # more than one line per movie file examined. For example,
  56. #
  57. # Name:     %FILE_NAME%
  58. # Size:     %FILE_LENGTH%
  59. # Duration: %VIDEO_DURATION% 
  60. #
  61. # comes out something like
  62. #
  63. # Name:   MyMovie.aviLength: 1,234,567 bytesDuration: 00:37:12
  64. #
  65. # which is probably not what you want. The correct way to do it is
  66. # something like:
  67. #
  68. # Name:     %FILE_NAME%      \r\n
  69. # Size:     %FILE_LENGTH%    \r\n
  70. # Duration: %VIDEO_DURATION% \r\n
  71. #
  72. # The advantage, though, is if for those who want single very lines, typically
  73. # for export to a spreadsheet. e.g.:
  74. #
  75. # %FILE_NAME%\t%FILE_LENGTH%\t%VIDEO_DURATION%
  76. #
  77. # can also be expressed
  78. #
  79. # %FILE_NAME%\t
  80. # %FILE_LENGTH%\t
  81. # %VIDEO_DURATION%\t
  82. #
  83. # which is nice, especially if there are dozens of items involved
  84.  
  85. # Escape codes
  86. # ============
  87. # \r\n      new line (for Windows/DOS text)
  88. # \n        new line (Unix style)
  89. # \t        tab character
  90. #
  91. # The field  are shown below. They're no longer part of this comment,
  92. # rather they comprise the actual format specifications should this
  93. # file be specified as the format file:
  94.  
  95. --- File Information ---                                                        \r\n
  96. File Name:                                      %FILE_NAME%                     \r\n
  97. File Name (with full path):                     %FILE_NAME_WITH_PATH%           \r\n
  98. File Size (in bytes):                           %FILE_SIZE%                     \r\n
  99.                                                                                 \r\n
  100. --- Container Information ---                                                   \r\n
  101. Base Type (e.g "AVI"):                          %CONT_BASETYPE%                 \r\n
  102. Subtype (e.g "OpenDML"):                        %CONT_SUBTYPE%                  \r\n
  103. Interleave (in ms):                             %CONT_INTERLEAVE_TIME%          \r\n
  104. Preload (in ms):                                %CONT_INTERLEAVE_PRELOAD%       \r\n
  105. Audio alignment("split across interleaves"):    %CONT_INTERLEAVE_ALIGN%         \r\n
  106. Total System Bitrate (kbps):                    %CONT_TOTAL_BITRATE%            \r\n
  107. Bytes Missing (if any):                         %CONT_BYTES_MISSING%            \r\n
  108. Number of Audio Streams:                        %CONT_AUDIO_STREAM_COUNT%       \r\n
  109.                                                                                 \r\n
  110. --- Video Information ---                                                       \r\n
  111. Video Codec Type(e.g. "DIV3"):                  %VIDEO_CODEC_TYPE%              \r\n
  112. Video Codec Name(e.g. "DivX 3, Low-Motion"):    %VIDEO_CODEC_NAME%              \r\n
  113. Video Codec Status(e.g. "Codec Is Installed"):  %VIDEO_CODEC_STATUS%            \r\n
  114. Duration (hh:mm:ss):                            %VIDEO_DURATION%                \r\n
  115. Frame Count:                                    %VIDEO_FRAME_COUNT%             \r\n
  116. Frame Width (pixels):                           %VIDEO_SIZE_X%                  \r\n
  117. Frame Height (pixels):                          %VIDEO_SIZE_Y%                  \r\n
  118. Frame Aspect Ratio (e.g "1.3333"):              %VIDEO_ASPECT_DECIMAL%          \r\n
  119. Frame Aspect Ratio (e.g. "4:3"):                %VIDEO_ASPECT_FRAC%             \r\n
  120. Pixel Aspect Ratio ("SAR"):                     %VIDEO_SAR%                     \r\n
  121. Display Aspect Ratio ("DAR"):                   %VIDEO_DAR%                     \r\n
  122. Frames Per Second:                              %VIDEO_FPS%                     \r\n
  123. Video Bitrate (kbps):                           %VIDEO_BITRATE%                 \r\n
  124. MPEG-4 ("MPEG-4" or ""):                        %VIDEO_MPEG4%                   \r\n
  125. B-VOP ("B-VOP" or ""):                          %VIDEO_MPEG4_BVOP%              \r\n
  126. QPel ("QPel" or ""):                            %VIDEO_MPEG4_QPEL%              \r\n
  127. GMC ("GMC" or ""):                              %VIDEO_MPEG4_GMC%               \r\n
  128. H264 ("H264" or ""):                            %VIDEO_H264%                    \r\n
  129.                                                                                 \r\n
  130. MPEG-2 ("MPEG-2" or ""):                        %VIDEO_MPEG2%                   \r\n
  131. Interlaced ("I/L" or ""):                       %VIDEO_MPEG2_I_L%               \r\n
  132. Progressive ("Prog" or ""):                     %VIDEO_MPEG2_PROG%              \r\n
  133. Top Frame First ("TFF" or ""):                  %VIDEO_MPEG2_TFF%               \r\n
  134. Bottom Frame First ("BFF" or ""):               %VIDEO_MPEG2_BFF%               \r\n
  135. 3:2 Pulldown ("3:2" or ""):                     %VIDEO_MPEG2_3_2%               \r\n
  136. Picture-per-field ("PPF" or ""):                %VIDEO_MPEG2_PPF%               \r\n
  137.                                                                                 \r\n
  138.  - Aspect Ratio Related:                                                        \r\n
  139.                                                                                 \r\n
  140. Broadcast standard: "PAL" (else blank)          %VIDEO_ASPECT_TYPE_PAL%         \r\n
  141. Broadcast standard: "NTSC" (else blank)         %VIDEO_ASPECT_TYPE_NTSC%        \r\n
  142. src:"VCD", "SVCD", "CVD", or "DVD (else blank): %VIDEO_ASPECT_SOURCE_MATCH%     \r\n
  143. Instructions to convert to VCD,  first part:    %VIDEO_ASPECT_CONVERT_VCD_1%    \r\n
  144. Instructions to convert to VCD,  second part:   %VIDEO_ASPECT_CONVERT_VCD_2%    \r\n
  145. Instructions to convert to SVCD, first part:    %VIDEO_ASPECT_CONVERT_SVCD_1%   \r\n
  146. Instructions to convert to SVCD, second part:   %VIDEO_ASPECT_CONVERT_SVCD_2%   \r\n
  147. Instructions to convert to CVD,  first part:    %VIDEO_ASPECT_CONVERT_CVD_1%    \r\n
  148. Instructions to convert to CVD,  second part:   %VIDEO_ASPECT_CONVERT_CVD_2%    \r\n
  149. Instructions to convert to DVD,  first part:    %VIDEO_ASPECT_CONVERT_DVD_1%    \r\n
  150. Instructions to convert to DVD,  second part:   %VIDEO_ASPECT_CONVERT_DVD_2%    \r\n
  151. Instructions to convert to AVI,  first part:    %VIDEO_ASPECT_CONVERT_AVI_1%    \r\n
  152. Instructions to convert to AVI,  second part:   %VIDEO_ASPECT_CONVERT_AVI_2%    \r\n
  153.                                                                                 \r\n
  154. --- Audio Information ---                                                       \r\n
  155. MPEG Stream ID (e.g. "0xbd"):                   %AUDIO_MPEG_STREAM_ID%          \r\n
  156. MPEG VOB file Substream(e.g. "0x80"):           %AUDIO_MPEG_SUBSTREAM_ID%       \r\n
  157. Audio Codec (e.g. "AC3"):                       %AUDIO_CODEC%                   \r\n
  158. Audio Codec Status (e.g. "Codec Is Installed"): %AUDIO_CODEC_STATUS%            \r\n
  159. Audio Sample Rate (Hz):                         %AUDIO_SAMPLE_RATE%             \r\n
  160. Audio Bitrate(kbps):                            %AUDIO_BITRATE%                 \r\n
  161. Audio Bitrate Type ("CBR" or "VBR"):            %AUDIO_BITRATE_TYPE%            \r\n
  162. Audio Channel Count (e.g. "2" for stereo):      %AUDIO_CHANNEL_COUNT%           \r\n
  163.  
  164. # Note: The \r\n sequences are all "lined up" for clarity, but there is no need
  165. # to do so - in fact, this format creates a file with a lot of "trailing blanks"
  166. # which may not be particularly desireable. The alternative is something like:
  167. #
  168. # --- Audio Information ---\r\n
  169. # MPEG Stream ID (e.g. "0xbd"):                   %AUDIO_MPEG_STREAM_ID%\r\n
  170. # MPEG VOB file Substream(e.g. "0x80"):           %AUDIO_MPEG_SUBSTREAM_ID%\r\n
  171. #
  172. # etc.
  173. #
  174.  
  175. # Note: For audio, information from other streams is available by appending
  176. # "_2", "_3", or "_4" for streams 2, 3 and 4 respectively. The % char must
  177. # still be last, of course (e.g. "%AUDIO_BITRATE_3%", not "%AUDIO_BITRATE%_3").
  178. #
  179. # This is untested and may not be fully supported.
  180. #