Personal View site logo

User Tools

Site Tools


streamparser-jap

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

streamparser-jap [2012/04/30 13:29]
bkmcwd created
streamparser-jap [2012/05/06 13:10] (current)
bkmcwd [StreamParser 2.6]
Line 1: Line 1:
-====== StreamParser 2.======+====== StreamParser 2.======
  
  
  
 StreamParserはパナソニックのGシリーズ一眼専用のビデオファイル分析ソフトです。 StreamParserはパナソニックのGシリーズ一眼専用のビデオファイル分析ソフトです。
 +  * Windows専用
 +  * 対応ファイルはAVC(”.MTS”)のみ。
 +本ソフトを本格的に使いこなすには、MPEGやH.264といった各種規格に関する知識が必要ですが、たとえ少々意味がわからなくても、StreamParserの吐き出すログはパッチの開発者及びテスターにとって非常に役に立つものなので、ぜひ使ってみてください。
 +  * ダウンロードはこちらから:[[http://www.personal-view.com/talks/discussion/comment/52530#Comment_52530]]
 +
 ===== インストール ===== ===== インストール =====
  
  
-StreamParser is compatible with Microsoft Windows only.  StreamParser installation consists of the following steps: 
   - 新しいバージョンのStreamParserをインストールする前に、コントロールパネルの「アンインストール機能」を使って旧バージョンをアンインストールします。コントロールパネル上では、StreamParserは「GH13 Stream Parser」と表示されます。   - 新しいバージョンのStreamParserをインストールする前に、コントロールパネルの「アンインストール機能」を使って旧バージョンをアンインストールします。コントロールパネル上では、StreamParserは「GH13 Stream Parser」と表示されます。
-  - Create a temporary folder for Installation.  This can be located anywhere. +  - インストール用の一時フォルダを準備します。置き場所はどこでも構いません。 
-  - UnZip the contents of the “StreamParserInstall.zip” archive into the temporary folder. +  - StreamParserInstall.zip」を解凍した中身を、作成した一時フォルダの中に置きます。 
-  - Execute “Setup.exe” by double clicking on it.  StreamParser requires the .NET runtime.  If not present on your computer, the installation program will automatically download it from Microsoft. +  - Setup.exe」ファイルをダブルクリックして実行します。※.NET runtimeが必要です。お使いのコンピュータにすでに導入されていなければ、自動的にMicrosoftからインストール・プログラムがダウンロードされます。 
-  - After installation is complete StreamParser will be started.  If everything appears OK the temporary installation folder can be deleted.+  - インストールが終わると、StreamParserが起動します。うまくインストールされたら、インストール用の一時フォルダは削除してかまいません。
  
-===== The Main StreamParser Application =====+===== StreamParser本体機能について =====
  
 +=== 【分析対象ファイルの読み込み】 ===
  
-Before opening files with StreamParser copy them to your computer’s hard disk.  There are two ways to start a StreamParser session.  Selecting “File>Open” from the menu will cause an entire video stream file to be opened and analyzed.  Alternatively, one can select “File>Quick Test” which will only open and analyze the first ten seconds of a video stream file (by default; the number of seconds can be changed by selecting “Configuration>Configure Quick Test”).  Large files can take a very long time to analyze and unless there is a specific need to analyze the entire file using “Quick Test” is advised. 
  
-StreamParser starts up in “Frames Mode, which contains the most commonly used tools.+ 
 +StreamParserにファイルを読み込んでスタートするには次の2通りの方法があります。 
 +※ StreamParserでAVCファイル(***.MTS”)を開く前に、必ずコピーを取っておきましょう。 
 + 
 +== *「File」→「Open」: == 
 + 
 + 
 + ビデオファイル全体を読み込んで分析する。 
 + 
 +== *「File」→「Quick Test」 == 
 + 
 + ビデオファイルの最初の10秒を読み込んで分析する。 
 + (※デフォルトは10秒ですが「Configuration」→「Configure Quick Test」で読み込む尺を変更可能) 
 + 
 +大きなファイルの場合、分析に長い時間を要します。もし特にファイル全体を分析する必要がなければ、「Quick Test」で開くことを推奨します。 
 + 
 +=== 【フレームモード】 === 
 + 
 + 
 +StreamParserには、「フレームモード」と「タイムモード」という2つのモードがあります。 
 + 
 +  * フレームモードでは、ストリームを個々のフレームに分割して分析します。
  
 {{ http://www.personal-view.com/talks/uploads/FileUpload/4d/a70d0fa95e0289a1954cc86ac0f3b5.jpg }} {{ http://www.personal-view.com/talks/uploads/FileUpload/4d/a70d0fa95e0289a1954cc86ac0f3b5.jpg }}
    
-The StreamParser Frames Mode window consists of several components: +== A. ストリームデータパネル == 
-  * //__A__.// Stream Data panel.  This breaks a stream down into frames.  The first column shows frame number in display order.  The GOP.Frame column shows the frame number in GOP.Frame format.  Offset is the starting address of the frame in the MTS file.  Length is the amount of data in the frame.  Type indicates frame type (IPB, or A).  Audio (A) frames are only shown if the “Include Audio” checkbox above the Stream Frames graph has been checked.  Clicking on column headers will cause data to be sorted according to the selected column+ 
-  * //__B__.// Sel.  Pressing this synchronizes the Frame Data Panel with the Stream Frames graph.  The first frame in the Stream Data Panel is set to the first frame shown in the Stream Frames graph+ここでは一連のビデオデータが個々のフレームに分割されます。 
-  * //__C__.// Frame Data panel.  This breaks down a frame selected in the Stream Data panel into Transport Stream (TS) packets.  “Packet” shows the packet number relative to the beginning of the selected frame.   “Offset” is the starting address of the packet in the MTS file.  “E”, ”S”, and “P” are TS header flags. “PID” is the TS Packet ID.  “SC”, “AF”, and “CC” are TS header flags.  “Type” is the packet type – “VID” for video and “AUD” for audio.  “Abs Packet” is the absolute packet number (i.e. relative to the beginning of the file).  The number next to “Frame Data” is the selected frame number.  Clicking on column headers will cause data to be sorted according to the selected column+ 
-  * //__D__.// Pressing this will start up the media player.  The media player is explained in more detail below+表1列目:GOPフレームフォーマットにおけるフレームナンバー 
-  * //__E__.// Packet Data.  This shows hex data for a packet selected in the Frame Data panel.  The numbers next to “Packet Data” are Packet/Abs Packet number for the selected packet+ 
-  * //__F__.// Similar to item B, above; except the first column in the Stream Frames graph is set to the selected frame in the Stream Data panel+表3列目「Offset」:MTSファイルの該当フレームの開始アドレス 
-  * //__G__.// This slider determines how many columns are displayed in the Stream Frames graph; it is used to zoom the graph in or out+ 
-  * //__H__.// The Stream Frames graph.  Depending on which “Include” checkboxes are selected videoaudio, or both frame types are plotted.  The graph can be set to display frame size in bytes or bits. +表4列目「Length」:そのフレームに含まれるデータ量 
-  * //__I__.// Displays the contents of the Information panel (J) in a bigger window+ 
-  * //__J__.// Information panel.  This contains information about the Stream, the selected frame and packet+表5列目「Type」:フレームタイプ(IPB、又はA) 
-  * //__K__.// This puts StreamParser into Time mode.+ 
 +※ A(Audio)フレームは、ストリームフレームグラフ(H)のすぐ上の「Include Audio」チェックボックスがオンの場合にのみ表示されます。 
 + 
 +※ 各列の見出し部分をクリックすると、該当項目の数値の昇順(降順)で表の並び替えが行われる。 
 +== B「選択」ボタン == 
 + 
 +フレームデータパネル(C)とストリームフレームグラフ(H)の表示を同期させるボタン。 
 +ストリームデータパネル(A)の最初のフレームがグラフの最初のフレームになります。 
 +== Cフレームデータパネル == 
 + 
 +ストリームデータパネルで選んだフレームをTS(Transport Stream)パケット単位で分割します。 
 +表1列目「Packet」:選択フレームの冒頭からのパケットナンバー 
 + 
 +表2列目「Offset」:MTSファイルにおけるそのパケットの開始アドレス 
 + 
 +表3〜5列目「E」「S」「P」:TSのヘッダーフラグ 
 + 
 +表6列目「PID」:TSのパケットID 
 + 
 +表7〜9列目「SC」「AF」「CC」:TSのヘッダーフラグ 
 + 
 +表10列目「Type」:パケットタイプ。「VID」:ビデオ、「AUD」:音声 
 + 
 +表11列目「Abs Packet」:(ファイル冒頭からの)完全パケットナンバー 
 + 
 +表冒頭の「Frame Data」横の()内の数値は選択されたフレームナンバーを示します。 
 +各列の見出し部分をクリックすると、該当項目の数値の昇順(降順)で表の並び替えが行われる。 
 +== D「ファイルストリーム開始」ボタン == 
 + 
 +このボタンを押すことによって、「メディアプレーヤー」が起動します。メディアプレーヤーの詳細については下で説明します。 
 +== Eパケットデータ == 
 + 
 +フレームデータパネルで選択されたフレームの16進法データが表示されます。 
 +表題の「Packet Data」横の()内の数値は、選択フレームの「Packet」値/「Abs Packet」値を示す。 
 + 
 +== F「選択」ボタン == 
 + 
 +Bの「選択」ボタンと近いですが、ストリームデータパネルで選択されたフレームがストリーム・フレームグラフの1列目としてセットされます。 
 +== Gスライダー == 
 + 
 +このスライダーを動かすことで、グラフに表示される列数(=フレーム数)の数を変更できます。グラフの拡大縮小用。 
 +== Hストリームファイルグラフ == 
 + 
 +グラフ上部右の「Include」チェックボックスで「video」と「audio」のどちらがオンになっているかに応じて、選択されたストリームにおける、フレーム毎のサイズのデータがプロットされます。 
 +グラフで表わされるフレームサイズの単位は「bytes」か「bits」かを選べるようになっています。 
 +== I「情報パネル拡大表示」ボタン == 
 + 
 +情報パネル(J)の内容を大きい別ウィンドウで表示する。 
 +== J. 情報パネル == 
 + 
 +ストリーム、選択されたフレームとパケットの情報を示します。 
 + 
 +== K「タイムモードに変更」ボタン == 
 + 
 +ストリームパーサーをタイムモードに変更する。 
 + 
 +=== 【タイムモード】 === 
 + 
 + 
 +  * ストリームを時間単位で分割して分析します。 
 +※ ウィンドウ構成はフレームモードとほぼ同じなので、相違点のみ解説します。
  
 {{ http://www.personal-view.com/talks/uploads/FileUpload/49/44350d5dcaf109a4002da6720e73e6.jpg }} {{ http://www.personal-view.com/talks/uploads/FileUpload/49/44350d5dcaf109a4002da6720e73e6.jpg }}
  
-The StreamParser Time Mode window is similar to Frames Mode except instead of data being broken into frames it is divided by time slices.  The components that differ from Frames Mode are: +== Aフレームデータパネル ==
-  * //__A__.// Frame Data.  In Time Mode “frames” are actually time slices (typically 0.092-0.096 seconds).  As such a time slice can contain different types of packets – video, audio, timing, parameter sets, etc…  Unlike Frames Mode, Time Mode shows all packet types, not just video or audio. +
-  * //__B__.// The stream Frames graph shows the amount of data contained in each time slice. +
-  * //__C__.// This is a smoothing function (averaging) for the graph’s running bitrate line.+
  
-When “Open Stream Player” is pressed in Frames Mode a Windows Media Player window is opened in the Frame Data panel The player can be detached and displayed in a separate window When a stream is played a frame marker in the Stream Frames graph follows along.  Also shown in the figure below is the window presented when “Show Big Information Panel” is pressed.+タイムモードでは「フレーム」は実際の時間単位(一般的に0.092 – 0.096秒)で分割された時間を表す。このような時間分割においてはタイプの異なった複数のパケットが含まれます(ビデオ、音声、タイミング、パラメータセットetc)。 
 +フレームモードと違い、タイムモードはすべてのパケットタイプを示します。単純にビデオまたは音声だけではありません。 
 +== Bストリームフレームグラフ == 
 + 
 +各時間単にに含まれるデータ量を示します。 
 +== C. 「スムージング」ボタン == 
 + 
 +グラフのビットレートライン(線グラフ)を平滑化します。 
 + 
 +=== 【ファイルストリーム再生機能】 === 
 + 
 + 
 +フレームモードで「ファイルストリーム開始」ボタン(D)がクリックされると、フレームデータパネル内に「Windowsメディアプレーヤー」が表示されます。 
 +このプレーヤーは別ウィンドウに分離して表示することもできます(detachボタン)。ストリームが再生されると、それに応じてストリーム・フレーム・グラフのマーカーが付随して動くようになっています。  【情報パネル】 
 + 
 +“Show Big Information Panel”ボタンを押すと情報パネルが開きます。ビットレート、各タイプのフレームサイズの最小、最大、平均の確認に便利です。
  
 {{ http://www.personal-view.com/talks/uploads/FileUpload/f2/b3dca59ccb0a7a7bdc3b71e4a8ebb5.jpg }} {{ http://www.personal-view.com/talks/uploads/FileUpload/f2/b3dca59ccb0a7a7bdc3b71e4a8ebb5.jpg }}
    
-A short-form report suitable for posting on forums can be generated by selecting the “File>Generate Snapshot Report” menu item.  The Snapshot Report can be saved as an image.  Depending on StreamParser’s current operating mode (Frames or Time) one of two reports will be generated.  The graph contained in the Snapshot Report is a copy of the currently displayed graph in the StreamParser main window.+=== 【 StreamParserスナップショット作成機能 】 === 
 + 
 + 
 +フォーラム等に分析結果を投稿するための情報を一覧にまとめた簡易フォーム(=スナップショット)を作成する機能もあります。 
 +File」→「Generate Snapshot Report」 
 +このスナップショットはイメージファイルとして保存することができます。StreamParserによる検証データは他のテスターにとってとても有用なので、使用したセッティング名と合わせてフォーラムに投稿すると喜ばれます。
  
 {{ http://www.personal-view.com/talks/uploads/FileUpload/0e/4bd9ba0f7eff3df3af668ba1a17e79.jpg }} {{ http://www.personal-view.com/talks/uploads/FileUpload/0e/4bd9ba0f7eff3df3af668ba1a17e79.jpg }}
Line 54: Line 156:
 {{ http://www.personal-view.com/talks/uploads/FileUpload/c2/09ae3b7aeea2eca97c1f489d7bbbbc.jpg }} {{ http://www.personal-view.com/talks/uploads/FileUpload/c2/09ae3b7aeea2eca97c1f489d7bbbbc.jpg }}
  
-Additional miscellaneous menu options allow the user to check MTS file integrity (“Tools>Check Stream File”), select camera model (“Configuration> Camera”), select slow computer operation (“Configuration>Slow Computer”), and interpret hacked GH1 1080p25 files (“Configure>Interpret GH1 1080i60 as Hacked 1080p25”). +=== 【その他の機能】 ===
-===== The JM-SP Decoder =====+
  
  
 +その他のメニューオプションでも色々なことができます。
  
-StreamParser analyzes data at the Transport Stream (TS) level.  The JM-SP decoder analyzes data at the H.264 Elementary Stream level, offering details about video encoding parameters and results.  With the JM-SP decoder details are provided about quantization levels, scaling tables, skipped frames, and much more.  The JM-SP decoder is based on the H.264 reference codec and as such is a good tool to test streams for validity.+  * ItemMTSファイルの整合性チェック機能(「Tools」→「Check Stream File」) 
 +  * カメラ機種選択(「Configuration」→「Camera」) 
 +  * コンピューターの性能が遅い場合の対応(「Configuration」→「Slow Computer」) 
 +  * GH1のハッキングによる1080p25読み取り機能(「Configure」→「Interpret GH1 1080i60 as Hacked 1080p25」)
  
-==== Configuration ====+===== JM-SP Decoderについて =====
  
  
-The JM-SP decoder is configured by clicking on the “Configuration>Configure JM-SP Decoder“menu item.  The parameters are as follows: 
  
-  * //__Number of Frames to Decode__.//  The default is 100.  This determines how many frames will be decoded.  If set to zero, all frames will be decoded. +JM-SP Decoderは、AVCファイル(.MTS)のビデオ部分のみ(エレメンタリーストリームファイル.264)を取り出し、エンコードされたビデオを各パラメータによって詳細に画質分析できるツールです。
-  * //__Produce Trace File__.//  This parameter configures the M-SP decoder to produce a trace file (“xxx.txt”) containing a great deal of H.264 header data.  Normally, this is unchecked as there is not typically a need to examine such detail and the JM-SP decoder takes a long time to produce the file. +
-  * //__Force 32-bit Decoder__.//  StreamParser is delivered with both 32 and 64-bit versions of the JM-SP decoder.  This option forces the 32-bit decoder to be used even under 64-bit Windows.+
  
-==== Use ====+==== 【設定】 ==== 
 + 
 + 
 +JM-SP Decoderは「Configuration」→「Configure JM-SP Decoder」メニューによって設定変更できます。 
 + 
 +  * //__「デコードフレーム数」__.//  デフォルトは100。デコードするフレーム数を決定します。この数値を「0」に設定すると、全てのフレームがデコードされますが、長いクリップだと時間がかかります。 
 +  * //__「トレースファイル作成」__.//  大量のH.264ヘッダデータを示すトレースファイル作成機能。通常はチェックする必要はありません。 
 +  * //__「32bitデコーダ強制」__.//  StreamParserには、32bit/64bit用の2つのJM-SP Decoderが搭載されています。このオプションにチェックを入れると、Win64bit環境においても32bit用のデーコーダーを使うようになります。 
 +==== 【使用方法】 ====
  
  
Line 81: Line 191:
 The log file contains quite a bit of useful data to help determine how well a video clip has been encoded.  The items shown for each frame are: The log file contains quite a bit of useful data to help determine how well a video clip has been encoded.  The items shown for each frame are:
  
-  * //__Frame__.//  This is the frame number in display order (the same as used in StreamParser)+== 「フレーム」== 
-  * //__Type__.//  This indicates the frame type (IDRIPB).  Note that with interlaced video each displayed frame actually consists of two slices.  For example, an interlaced frame will show as an “I | P” frame because it is actually an slice for the top half and a slice for the bottom+フレームナンバー(StreamParserで表示されるのと同じです) 
-  * //__QP__.//  This is the general QP setting for the entire slice (in the case of the GH2, the entire frame). +== 「タイプ」== 
-  * //__Min__.// This is the lowest QP setting used in any macroblock in the frame.  The H.264 codec uses the frame QP setting as a base and each macroblock can modify the QP setting using an offset value unique to that macroblock+フレームタイプ(IDRIPB) 
-  * //__Max__.// This is the highest QP setting used in any macroblock in the frame+注)インターレース映像に関しては表示された個々のフレームは実際には2つのフィールドが1枚の画面(フレーム)となって表示されています。例えば、1つのインターレース・フレームは「IP」などと表示される。これは、実際にはフレームを構成する2フィールドのうち、半分が「I」で、もう半分が「P」であることを意味しています。 
-  * //__Range__.//  This value is Max minus Min and shows the range for QP values.  With test charts, a high range value indicates potential problems, as test charts (with high detail across the entire image) should be encoded with fairly consistent QP values for all macroblocks (a range of 5, or less).  Real world subjects, on the other hand, can vary quite a bit.  Even with real world subjects, however, a range of twenty or more is usually not good.  A high value for Range will often indicate macroblocking in I frames (which are often propagated to subsequent B and P frames)+== 「QP」== 
-  * //__DC__.// This is the lowest effective QP value used for DC coefficients in the frame calculated by combining QP with the Quantization Scaling Matrix.  A DC value below 4 is wasted in 8-bit codecs and just results in extra processing and no gain in quality.  If values below 4 appear it is probably appropriate to raise the Q parameter value (or lower the AQ value) until no value under 4 appears+フレームごとの基準QP値 (in the case of the GH2, the entire frame). 
-  * //__Skipped__.//  This is the number of skipped (not encoded) macroblocks in a frame.  Low numbers are acceptable.  High numbers with test charts (more than 50) indicate problems.  The most common reason this happens is when the codec runs out of bandwidth and starts skipping frames to compensate.  With real world subjects skipped frames occur normally in very low detail areas, such as sky.   A high value for Skipped typically will indicate stuttering in motion, or macroblocking+== 「Min」(最少QP値)== 
-  //__QST-High__.//  If an asterisk appears here the codec has switched to fall-back mode to avoid crashing and is using very low detail (T4) Quantization Scaling Tables.  This should rarely happen and only when panning across extremely detailed subjects using a high shutter speed.+フレーム内の各マクロブロックにおけるQPの最小値 
 +※ H.264コーデックにおける圧縮では、フレームの基準QPを基本として、そこから派生したオフセット値が各マクロブロック単位で使われるため、そこに最大値、最少値の幅が発生することになります。 
 +== 「Max」(最大QP値)== 
 +フレーム内の各マクロブロックにおけるQPの最大値。 
 +== 「Range」(QPの幅)== 
 +Max(最大QP)- Min(最少QP) 
 +QP値のレンジ(幅)を示す。 
 +テストチャートの場合は、このレンジが高いと潜在的な問題があることを示しています。というのは、テストチャート(高精細なディティールが画面全体に広く分布している)のような幾何学的な規則性のあるものは、本来すべてのマクロブロックで一定のQP値(レンジは5以下)でエンコードされるはずだからです。 
 + 
 +一方、実写映像では事情が異なり、絵柄によってはレンジが大きくなるケースは大いにあり得ます。しかし、大きすぎるレンジ(20かそれ以上)は一般的には良くありません。レンジが高い値を示すのは、しばしばIフレームにおいてブロックノイズが出ていることを表しています(そしてそれは続くPやBフレームにも伝搬します)。 
 +== 「DC」== 
 +フレームにおけるDCT係数として使われるもっとも効果的な最低QP値を示す。この値はQPと量子化マトリクスを結合することにより計算されます。4を下回るDC値は、8bitコーデックでは無駄に消費され、エンコード時間が増えるばかりで画質向上は期待できません。もしDC値が4を切った場合は、QP値の設定が低すぎるので、DC値が4を上回るようになるまでPTool設定でQP値を引き上げる(またはAQ値を下げる)のが望ましい。 
 +== 「スキップ」== 
 +1つのフレーム内のマクロブロックのうちスキップされた(エンコードされなかった)マクロブロックの数を示す。 
 +低い値なら問題ありません。逆にテストチャートで高い値(50以上)を示す場合は問題があることを表しています。この現象の一般的な原因は、コーデックがその帯域幅を超過していることであり、その代償としてフレーム自体のエンコードがスキップ(=コマ落ち)し始めることにつながります。 
 +実写映像では、通常「空」のような変化の少ない一様な場所で起こることが多い。この「スキップ」の値が高いことは、動きがカクカクしたり、ブロックノイズが出ることを示しています。 
 +== 「QST-High== 
 +この欄に*(アスタリスク)マークがついていたら、コーデックがフォールバックモードに入ったことを意味します。フォールバックモードとは、コーデックが機器のクラッシュを避けるために一番低精細な量子化スケーリングテーブル(T4)を用いることです。フォールバックモードに入ることは希ですが、非常に高精細な被写体を速いシャッタースピードでパンしたときなどに起こります。
      
-Under normal circumstances the information contained in the JM-SP decoder log should be sufficient to evaluate how well video has been encoded and make changes to settings parameters in response.  The trace feature can be turned to produce a trace file that contains much more information.  The trace file, however, is fairly cryptic (being in H.264 header syntax) and can take a very long time to produce.+通常、JM-SP Decoderのログに表示されるデータは、ビデオのエンコード画質を評価し、それに応じてPToolでの設定パラメータを変更する用途にとって、必要にして充分なものです。「設定」メニューの「トレースファイル作成」機能では、より多くの情報を含むトレースファイルを生成することができます。でも、このトレースファイルはかなり暗号めいた難解なものであり(H264ヘッダsyntax)、生成にはかなり長い時間がかかります。
streamparser-jap.1335792597.txt.gz · Last modified: 2012/04/30 13:29 by bkmcwd