home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 January / Chip_2004-01_cd1.bin / zkuste / svcd2 / download / submux / WinSubMux.exe / WinSubMux / README.TXT < prev    next >
Encoding:
Text File  |  2002-05-21  |  4.9 KB  |  149 lines
  1. WinSubMux 0.2.0.2
  2. by New Age
  3. May 21st, 2002
  4.  
  5. Please _READ_ this file before sending me any questions!
  6.  
  7. WinSubMux@mailbox.hu
  8.  
  9. This program is freeware. Use at your own risk.
  10.  
  11. Source code is NOT available.
  12.  
  13.  
  14. Benefits
  15. ~~~~~~~~
  16.  
  17. * it has a GUI however it can be started with command line parameters (WinXP Themes support!)
  18.  
  19. * multiplex all streams in one step
  20.  
  21. * it is fast! 
  22.   (on a Celeron 900, 512MB ram, with very old Quantum HDDs it takes about 
  23.    a) 3-4 minutes to multiplex a 800MB MPEG2 file if the input and output
  24.       mpeg files are on the same HDD
  25.    b) it is less than a minute to multiplex a 800MB MPEG2 file if the 
  26.       input and output files are on two different HDDs)
  27.  
  28. * a lot of fixed bugs of SUBMUX, eg.:
  29.     'underline problem': 
  30.             a lot of subtitles appear on screen underlined
  31.     'disappearing subtitles': 
  32.             if the subtitle image was too small sometimes it doesn't appear on screen
  33.     'corrupted audio/video frames:'
  34.             playing sub-multiplexed files without subs -> some frames were corrupted
  35.  
  36. * preview subtitles after load
  37.  
  38. * SVCD(MPEG2) preview on Preview Tab trough D2V (DVD2AVI Project File) file format
  39.   [MPEG2DEC.DLL is needed!]
  40.  
  41. * easily timeshift subtitles on preview tab (align subtitle time to movie frame) 
  42.  
  43. * subtitle bitmap palette modification
  44.  
  45. * can handle large subtitle images
  46.  
  47. * save SUB file and/or bitmaps
  48.  
  49. * SVCD file-scan: get some information about your mpeg file (subs, audio, video)
  50.  
  51.  
  52. Command line parameters
  53. ~~~~~~~~~~~~~~~~~~~~~~~
  54.  
  55. The program can be started from command line (batch file) with these parameters:
  56.  
  57. WinSubMux.exe [-v <level>] [-l <logfile>] <in.mpg> [ subtitle options ] <first_script.sub> <out.mpg> [ [subtitle options] [other_script.sub] ... ]
  58.  
  59. -v <level>    verbosity(debug) level (default 1)
  60. -l <logfile>    write debug log into a file
  61.  
  62. subtitle options: MUST be BEFORE .SUB filenames!!!
  63. -s <stream>    Substream ID of the subtitle (0..3) (default 0)
  64. -C        make CVD subtitles (if not specified SVCD subtitles are default)
  65.  
  66. Examples:
  67.     To insert SVCD style subtitles into Stream #2; debug level = 3
  68.     WinSubMux.exe -v 3 INPUT.MPG -s 2 SUBTITLES.SUB OUTPUT.MPG
  69.  
  70.     To insert SVCD style subtitles into Stream #0 and CVD style subtitles into Stream #1
  71.     WinSubMux.exe INPUT.MPG -s 0 SUB_SVCD.SUB OUTPUT.MPG -s 1 -C SUB_CVD.SUB
  72.  
  73. ! Because of backward compatibility with older versions of WinSubMux and 
  74.   with submux the first subtitle-script MUST be between the two mpeg files 
  75.   (input, output) as it is described above !
  76.  
  77. The subtitle image format
  78. ~~~~~~~~~~~~~~~~~~~~~~~~~
  79.  
  80. It must be in "Windows Bitmap 16 color (4bit) or 256 color (8bit)" format 
  81. and ONLY the first four color can be used as #00 for background and #01, 
  82. #02, #03 for anything. If other colors are used the program uses the 
  83. AND '3' operation to calculate the color index:
  84. subtitle_color_index = bmp_color_index AND 3. 
  85. So #04 becomes #00, #05 becomes #01, #06 becomes #02, etc.
  86.  
  87. The subtitle script file format
  88. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  89.  
  90. The file format is similar to "PHILIPS SVCD DESIGNER 1.5 - 2.0 SUBTITLES FILE"
  91. file format but it must contain ONLY the '[LIST]' section without the '[LIST]'
  92. section identifier. Eg.:
  93.  
  94. ENG_000001.bmp 01:45:10:11 01:45:14:15 296 068 211 464
  95.  
  96. or
  97.  
  98. ENG_000001.bmp 01:45:10:11 01:45:14:15 296 068 211 464 0 255 255 255
  99.  
  100. where the columns are:
  101.  
  102. IMAGEFILE STARTTIME ENDTIME WIDTH HEIGHT X Y T0 T1 T2 T3 
  103.  
  104. IMAGEFILE: filename of the subtitle picture without path 
  105.            (the pictures and the script file MUST BE in the same directory!)
  106. STARTTIME, ENDTTIME: Hour:Minute:Second:Hundredthsecond
  107. WIDTH, HEIGHT: width, height of the bitmap
  108. X,Y: X,Y position (on the movie) of the lower upper corner of the subtitle image
  109. T0, T1, T2, T3: is the contrast (or transparency) value of the #0, #1, #2, #3 colors
  110.                 0 means fully transparent
  111.         255 means fully non transparent
  112. ***
  113. BE CAREFUL don't make subtitles with zero or negative duration they will be skipped.
  114. (eg: SubRip 0.97b puts '00:00:00,00' time to the last subtitle ENDTIME)
  115.  
  116.  
  117. Future plans
  118. ~~~~~~~~~~~~
  119.  
  120. * bug fixing
  121. * subtitle extraction from mpeg2 files (like vob2sub)
  122. * non transparent subtitle backround support
  123. * multilanguage support
  124. * direct mpeg2 preview (open mpeg2 files not d2v files)
  125.  
  126.  
  127. Known bugs
  128. ~~~~~~~~~~
  129.  
  130. * MPEG Analizing does not work correctly with MPEG1 files
  131. * mpeg files with RIFF header (*.DAT files) works very slowly
  132.     --> Convert to true mpeg file with 'cdxa2mpeg.exe' (part of VCDImager)
  133.  
  134.  
  135. System requirements 
  136. ~~~~~~~~~~~~~~~~~~~
  137.  
  138. * IBM PC compatible computer
  139. * Processor: at least Pentium Pro compatible
  140. * Operating system: Windows 9x/Me/NT/2000/XP
  141.  
  142.  
  143.  
  144. --------------------------------------------------------------------------
  145.  
  146. MPEG2DEC.DLL is under GNU GENERAL PUBLIC LICENSE (GPL)
  147.  
  148. --------------------------------------------------------------------------
  149.