HB:   ビットマッププロットセクション
------------------------------------

HB: セクションは、(x,y) 座標にカラーのビットマップを描きます。 ビットマップの形は、長方形で幅と高さが定義できます。 他のプログラムで出力される3次元パース図などをpsに変換するのに 用います。長方形のビットマップの他に、任意の形のカラー領域も 定義できます。また、全体をクリッピングするパスも定義できます。

.. _基本スタイル-4:

基本スタイル
~~~~~~~~~~~~

ビットマッププロットセクションは、4つのサブセクションを持っています。 基本スタイルは、

.. container:: minipage angel-doublebox

   ::

      HB: CLIP NOCLIP LINE NOLINE C( c ) CB( cb ) HSB RGB T Z
      FRAME:
         x1   y1
         x2   y2
         ...   ...
         ...   ...
      CLIP:
         x1   y1
         x2   y2
         ...   ...
         ...   ...
      PATH: C( cp )
         x1   y1
         x2   y2
         ...   ...
         ...   ...
      BMAP: WIDTH = w   HIGHT = h
         x1   y1   c1   c2   c3
         x2   y2   c1   c2   c3
         ...   ...   ...   ...   ...
         ...   ...   ...   ...   ...

| 

FRAME:, CLIP:, PATH:, BMAP: のサブセクションは、省略可能です。 ただし、CLIP:, PATH:, BMAP: の何れかひとつは、少なくとも一回は 含まれなければなりません。FRAME:, CLIP: の各サブセクションは、複数回の 定義は許されません。 FRAME:, CLIP: で定義されるパスで、ビットマップがクリッピング されます。FRAME: の方が、CLIP: より上位のクリッピングパスです。 PATH:, BMAP: は、何回定義されてもかまいません。 PATH: は、領域と色を変えるたびに、BMAP: は、ビットマップの大きさを 変えるたびに定義する必要があります。 挿画する時は、PATH: を描き、次にBMAP:を常に上書きで描きます。

ビットマッププロットパラメーター
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. container:: center

   .. table:: ビットマッププロットパラメーター

      +--------------------------+--------------------------------------------------------------------+
      | パラメーター             |       説明                                                         |
      +==========================+====================================================================+
      | ``CLIP``                 | ``CLIP:`` で定義されるパスをクリッピングする                       |
      +--------------------------+--------------------------------------------------------------------+
      | ``NOCLIP``               | (default) ``CLIP:`` で定義されるパスをクリッピングしない           |
      +--------------------------+--------------------------------------------------------------------+
      | ``LINE``                 | ``CLIP:`` で定義されるパスを挿画する                               |
      +--------------------------+--------------------------------------------------------------------+
      | ``NOLINE``               | (default) ``CLIP:`` で定義されるパスを挿画しない                   |
      +--------------------------+--------------------------------------------------------------------+
      | ``C(`` :math:`c` ``)``   | クリッピングパスの色を :math:`c` [#c]_ とします (D=e)              |
      +--------------------------+--------------------------------------------------------------------+
      | ``CB(`` :math:`cb` ``)`` | クリッピングパスの領域の色を :math:`cb` `[1] <#c>`_ とします (D=w) |
      +--------------------------+--------------------------------------------------------------------+
      | ``T``                    | .. container:: minipage                                            |
      |                          |                                                                    |
      |                          |    クリッピングパスの線の太さをデフォルトを基準に太くします。      |
      |                          |    ``TTT`` の様に繰り返すと順に太くなります。                      |
      +--------------------------+--------------------------------------------------------------------+
      | ``Z``                    | .. container:: minipage                                            |
      |                          |                                                                    |
      |                          |    クリッピングパスの線の太さをデフォルトを基準に細くします。      |
      |                          |    ``ZZZ`` の様に繰り返すと順に細くなります。                      |
      +--------------------------+--------------------------------------------------------------------+
      | ``HSB``                  | (default) BMAP: の色をHSBの値で定義します。                        |
      +--------------------------+--------------------------------------------------------------------+
      | ``RGB``                  | BMAP: の色をRGBの値で定義します。                                  |
      +--------------------------+--------------------------------------------------------------------+
      | ``C(`` :math:`cp` ``)``  | PATH: の領域の色を :math:`cp` `[1] <#c>`_ とします。               |
      +--------------------------+--------------------------------------------------------------------+
      | ``WIDTH =`` :math:`w`    | ビットマップの幅を\ :math:`w`\ (cm)とします。                      |
      +--------------------------+--------------------------------------------------------------------+
      | ``HIGHT =`` :math:`h`    | ビットマップの高さを\ :math:`h`\ (cm)とします。                    |
      +--------------------------+--------------------------------------------------------------------+

.. [#c] 色の定義の仕方は、ラインパラメーターのところで解説します。

ビットマッププロットの例題
~~~~~~~~~~~~~~~~~~~~~~~~~~

PHITS で計算した3dパース図の簡単な結果を以下に示します。 ビットマッププロットの利用は、他のプログラムの出力を利用するもので いろいろなアイデアで使ってもらいたいと考えております。

.. figure:: assets/dshow5.png
   :name: fig-ref-2-17
   :width: 336.8pt
   :align: center
   :class: responsive-figure

   ビットマッププロットの例題