.. _plugin-sensor-mradiancemeter:

Multi-radiance meter (:monosp:`mradiancemeter`)
-----------------------------------------------

.. pluginparameters::

 * - origins
   - |string|
   - Comma separated list of locations from which the sensors will be recording
     in world coordinates.
   - —

 * - directions
   - |string|
   - Comma separated list of directions in which the sensors are pointing in
     world coordinates.
   - —

This sensor plugin implements multiple radiance meters, as implemented in the
:monosp:`radiancemeter` plugin.

This sensor allows using the inherent parallelization of Mitsuba2, which is not
possible with the :monosp:`radiancemeter` due to its film size of 1x1.

The origin points and direction vectors for this sensor are specified as a list
of floating point values, where three subsequent values will be grouped into a
point or vector respectively.

The following snippet shows how to specify a :monosp:`mradiancemeter` with
two sensors, one located at (1, 0, 0) and pointing in the direction (-1, 0, 0),
the other located at (0, 1, 0) and pointing in the direction (0, -1, 0).

.. code-block:: xml

    <sensor version="2.0.0" type="mradiancemeter">
        <string name="origins" value="1, 0, 0, 0, 1, 0"/>
        <string name="directions" value="-1, 0, 0, 0, -1, 0"/>
        <film type="hdrfilm">
            <integer name="width" value="2"/>
            <integer name="height" value="1"/>
            <rfilter type="box"/>
        </film>
    </sensor>

.. code-block:: xml
    :name: sphere-meter

    <shape type="sphere">
        <sensor type="irradiancemeter">
            <!-- film -->
        </sensor>
    </shape>