   
   ** please read this file through for thorough information! ** 
   ** also, set (word_rap=off) in your editor.                ** 
   
1. description: 
   
   x265_infotool is a tool to extract the encoding parameters stored inside the
   SEI bitstream section of an h265/hevc encoded (raw) video file as produced by
   the x265.exe encoder. Use with videos encoded by x265 build 1.2.076 and later.
   
   this software is freeware, and works under windows xp (32-bit) and later.
   
2. usage: 
   
   simple operation. just drag and drop into x265_infotool an x265 encoded (raw) video.
   the left side pane will show the extracted parameters that the video was encoded with.
   the right side pane will show the same parameters but in a list view, vertically.
   the tool offers scrolling up/down capability of the list of parameters to see the 
   position of the parameter in the left pane window's jumbled parameter text.
   
3. advantage or purpose: 
   
   allows a different and interactive viewing perspective of the parameters, and helps to provide
   a flexible way to analyze, study and compare those parameters for other video projects.
   
   x265 infotool can only be used on the raw h265/hevc bitstream video's that were encoded by 
   the x265.exe encoder starting with build 1.2.076 and later. it does not read them from inside
   any other containers, such as mkv, mp4, ts, flv, etc., but may in a future update.
   
   as of version 0.1, x265 infotool can also read x264 encoded videos, as long as the videos are in raw
   bitstream format or the raw streams have been demuxed out of the container (mp4/mkv) that they are put
   in during the encoding done by the x264.exe encoder. 
   
   a) dragging a raw bitstream video file that either x264 or x265 encoded will import these encoders
   parameters from the SEI bitstream section and will display the parsed data into the two pane windows,
   b) while copying a selected area in an editor, webpage, or encoder's parameter input textbox field will
   parse that selection and display the results in the two pane windows.
   
   the whole parsing process for both parameter style 'normalizes' the parameters into a standard style
   in order to display them in one style format for viewing in the two pane windows. this helps to keep
   things consistant no matter what the parameter style, i.e., (--rd 2) vs (rd=2) vs (rd=2 / ref=1)
   
4. general notes: 
   
   the format for retrieving the x265 parameters (via drag & dropping files) is based on the ' ' token. 
   the format for inputing parameters (via pasting into x265 infotool) is based on the '--' token.
   when selecting parameters in an area from an external application, you should leave out the
   encoder exe tool and the input/output filenames. the filenames are usually in the front or back of the 
   parameter list. just don't include them during the select/copy process. following these directions
   will give you a clean parsed listing of the parameters for navigating through. (see sect 5)
   
5. warnings: 
   
     parameters that include a mxiture of single and double hyphen chars '-' and '--' will cause parsing
     problems later when the x265 intotool wants to recreate the parameters for pasting into an external
     editor or encoder parameter input field. note, it is the single '-' that causes problems.
   
6. functions and features: 
   
   left and right pane windows
     you can scroll up and down in the right pane window. this allows you to navigate the left pane
     parameters from that viewing perspective in order to see where specific parameters are located.
   
   menu bar
     file: n/a, future options
     edit: [copy] to clipboard, 
             the parameters in different format(s) (for pasting into external editors or parameter input fields of other encoders.)
           [paste in x264/x265 SEI parameters]
             this function is for pasting the x264 and x265 style parameters into x265 infotool for parsing
             into the two pane windows. for example, select/copy/paste the params (below) into x265 infotool.
             x264 style: cabac=1 / ref=16 / deblock=1:-1:-1 / analyse=0x3:0x133 / me=umh / subme=10 / psy=1 / psy_rd=1.00:0.15 / mixed_ref=1 / me_range=24 / chroma_me=1 / trellis=2 / 8x8dct=1 / cqm=0 / deadzone=21,11 / fast_pskip=1 / chroma_qp_offset=-3 / threads=12 / lookahead_threads=2 / sliced_threads=0 / nr=0 / decimate=1 / interlaced=bff / bluray_compat=0 / constrained_intra=0 / bframes=8 / b_pyramid=2 / b_adapt=2 / b_bias=0 / direct=3 / weightb=1 / open_gop=0 / weightp=0 / keyint=250 / keyint_min=25 / scenecut=40 / intra_refresh=0 / rc_lookahead=60 / rc=crf / mbtree=1 / crf=12.0 / qcomp=0.60 / qpmin=0 / qpmax=69 / qpstep=4 / ip_ratio=1.40 / aq=1:1.00
             x265 style: 32x32 fps=25000/1000 bitdepth=8 wpp ctu=16 tu-intra-depth=1 tu-inter-depth=1 me=1 subme=2 merange=57 no-rect no-amp max-merge=2 no-early-skip no-fast-cbf rdpenalty=0 no-tskip no-tskip-fast strong-intra-smoothing no-lossless no-cu-lossless no-constrained-intra open-gop interlace=0 keyint=250 min-keyint=25 scenecut=40 rc-lookahead=20 bframes=4 bframe-bias=0 b-adapt=2 ref=3 weightp no-weightb aq-mode=2 aq-strength=1.00 cbqpoffs=0 crqpoffs=0 rd=3 signhide lft sao sao-lcu-bounds=0 sao-lcu-opt=1 b-pyramid cutree rc=crf crf=28.0 qcomp=0.60 qpmin=0 qpmax=51 qpstep=4 ipratio=1.40 pbratio=1.30
     options: \options\sort (can sort/unsort the right pane parameter listing)
   
7. how-to's:
   
     note, there are two methods to send parameters into x265 infotool for processing: drag/drop and pasting 
   
     7a.1 to add x264 or x265 cmd line encoding style parameters into x265 infotool for processing 
     7a.2 select by highlighting a set of parameters from an editor, or from a webpage forum topic. 
     7a.3 here are some example parameters (cmd line parameter, and x264/x265 SEI styles) to process through x265 infotool.
     7a.4 x264 --bitrate 8000 --preset veryslow --tune film --bluray-compat --fps 60000/1001 --vbv-maxrate 40000 --vbv-bufsize 30000 --level 4.1 --keyint 60 --open-gop --slices 4 --colorprim "bt709" --transfer "bt709" --colormatrix "bt709" --sar 1:1 --pass 1 -o out.264 input.mp4
     7a.5 x264 --preset faster --pass 1 --bitrate 1320 --stats "01.stats" --tff --sar 12:11 -y --output NUL "01.avs"
     7a.6 x265 32x32 fps=25000/1000 bitdepth=8 wpp ctu=16 tu-intra-depth=1 tu-inter-depth=1 me=1 subme=2 merange=57 no-rect no-amp max-merge=2 no-early-skip no-fast-cbf rdpenalty=0 no-tskip no-tskip-fast strong-intra-smoothing no-lossless no-cu-lossless no-constrained-intra open-gop interlace=0 keyint=250 min-keyint=25 scenecut=40 rc-lookahead=20 bframes=4 bframe-bias=0 b-adapt=2 ref=3 weightp no-weightb aq-mode=2 aq-strength=1.00 cbqpoffs=0 crqpoffs=0 rd=3 signhide lft sao sao-lcu-bounds=0 sao-lcu-opt=1 b-pyramid cutree rc=crf crf=28.0 qcomp=0.60 qpmin=0 qpmax=51 qpstep=4 ipratio=1.40 pbratio=1.30
     7a.7 x264 cabac=1 / ref=16 / deblock=1:-1:-1 / analyse=0x3:0x133 / me=umh / subme=10 / psy=1 / psy_rd=1.00:0.15 / mixed_ref=1 / me_range=24 / chroma_me=1 / trellis=2 / 8x8dct=1 / cqm=0 / deadzone=21,11 / fast_pskip=1 / chroma_qp_offset=-3 / threads=12 / lookahead_threads=2 / sliced_threads=0 / nr=0 / decimate=1 / interlaced=bff / bluray_compat=0 / constrained_intra=0 / bframes=8 / b_pyramid=2 / b_adapt=2 / b_bias=0 / direct=3 / weightb=1 / open_gop=0 / weightp=0 / keyint=250 / keyint_min=25 / scenecut=40 / intra_refresh=0 / rc_lookahead=60 / rc=crf / mbtree=1 / crf=12.0 / qcomp=0.60 / qpmin=0 / qpmax=69 / qpstep=4 / ip_ratio=1.40 / aq=1:1.00
   
     **                                                                          **
     ** remember to leave out any filenames when copy/pasting into x265 infotool **
     ** or read sect 5                                                           ** 
     **                                                                          **
   
     to read the parameters stored in the SEI section of a x264/x265 raw bitstream 
     7b.1 locate and drag/drop a video file encoded by x264/x265 into x265 infotool. 
     7b.2 be sure the video was encoded raw and not packaged inside a container like mp4 or mkv, otherwise, they will not be read.
   
     the above two methods should produce a parsed listing in the left and right pane windows.
     from that point on, you can scroll up/down through the list to review the parameters.
     should you decide that you want to copy the parameters somewhere else, then..
   
     to copy the contents of the parsed listing for pasting into another application,
     editor, encoder parameter input field, or excel..
     7c.1 go the menu bar and
     7c.2 click on [Edit] and
     7c.3 select one of the options for the type of copy output you want to send to your application.
     7c.4 text will copy in notepad format, (rd=2), (ref=1), ... 
     7c.5 excel will copy in a tab-delimited output, (rd 2), (ref 1), ... 
     7c.6 param will copy in a cmd line parameter output, (--rd 2), (--ref 1), ... 
   
     you can also sort and unsort the right pane windows listing
     7d.1 go to menu bar and
     7d.2 click on [Options] and
     7d.3 select Sort List -- this adds a check-mark to that setting
     7d.4 selecting it again unsorts the listing and also unchecks setting.
   
     note, the sorting and unsorting carries over in subsequent drag/drop or pasting of new parameters.
   
     you can also search for parameters
     7e.1 once a parameter list is in view, 
     7e.2 menu\options\sort -- set to sort
     7e.3 and press the first letter of the parameter name.
   
8. change log
   
   v0.6, 2014-08-02 sat 
   fix: flickery display in both pane windows during drag/drop of files.
   fix: enhanced the [sort] routine so that the last selected parameter is restored.
   fix: enhanced, also remembers last param across drag/drop of new files.
   add: option: [Copy Rt Pane as SEI parameter], ie, (cabac=1 / ref=3 / deblock=1:-1:-1 / ..) 
   add: search feature. see readme (sect 7 [7e.1])
   add: status details: ie, sort status; param count; last parameter; build version; (but not x264 yet)
   
   v0.5, 2014-07-29 tue
   fix: caption bar title and filename (was left off in v0.4)
   fix: enhanced the [paste in x264/x265 SEI parameters] function.
   add: \options\sort (can sort/unsort the right pane listing)
   add: can read x264 SEI parameters as well. (see sect 3)
   updated: readme to include section bookmarks and also several how-to's.
            see updates made to sections (3, 5, 6, and 7 and 8) 
   
   v0.4, 2014-07-20 sun
   fix: menu\edit [paste in parameters], ie, copy/pasting of x264 or x265 parameters, ie [--rd 2 --ref 3 --preset fast ...]
        (note: params must start with no leading spaces in order to work properly.
         example, a user has selected an area to copy to the clipboard and wants to paste into x265 infotool: 
         bad:  ' --rd 2 --ref 3 --preset fast '
         bad:  ' rd 2 --ref 3 --preset fast'
         bad:  'rd 2 --ref 3 --preset fast'
         good: '--rd 2 --ref 3 --preset fast'
         good: '--rd 2 --ref 3 --preset fast --wpp'
         good: '--wpp --rd 2 --ref 3 --preset fast ')
   add: readme file
   
   v0.3, 2014-07-17 thur
   add: option to copy right pane text clipboard as excel
   add: option to copy right pane text clipboard as cmd line parameter
   add: paste in parameters from other cmd lines: but needs work  
   
   v0.2, 2014-07-16 wed
   fix: tool now opens in center of desktop/window screen.
   fix: scroller/highlight to last position when selected.
   fix: when tool is launched, first selection is now highlighted.
   fix: name change in the tools caption, now reads: x265_infotool
   add: options to copy left or right pane text to clipboard
   
   v0.1, 2014-07-15 tue
   birth of x265_infotool.
   