:orphan:

.. ****************************************************************************
.. CUI
..
.. The Advanced Framework for Simulation, Integration, and Modeling (AFSIM)
..
.. The use, dissemination or disclosure of data in this file is subject to
.. limitation or restriction. See accompanying README and LICENSE for details.
.. ****************************************************************************

WSF_INTERSECT_PROCESSOR
-----------------------

.. model:: processor WSF_INTERSECT_PROCESSOR

.. parsed-literal::

   processor <name> :model:`WSF_INTERSECT_PROCESSOR`
      :command:`processor` Commands ...
      :ref:`Platform_Part_Commands` ...

      define_offset_ ...
      intersect_mesh_ ...
   end_processor

Overview
========

:model:`WSF_INTERSECT_PROCESSOR` allows one to query a three-dimensional representation, called an intersection mesh, to
determine geometric information during a simulation.  These queries occur completely within the simulation so there is
no need to use a separate visual system.

Currently, the intersection processor is used to determine intersection geometry, occlusion, and material code for
high-energy-laser interactions with targets (see :model:`WSF_LASER_WEAPON` ).  This capability could be expanded in the
future, however, to incorporate other features such as LADAR image formation.  In order to enable these calculations,
the processor must be placed within the target's platform_type (or platform instance) definition; e.g.::

   // Example platform type for su-37
   // Once the intersect processor is defined,
   // One can make geometrical queries for intersection with
   // The target canopy and / or IRST.
   platform_type su-37 WSF_PLATFORM
      ...
      processor intersect WSF_INTERSECT_PROCESSOR
         define_offset CANOPY
            3.461642 m
            0.000184 m
            -0.943480 m
         define_offset IRST
            5.138014 m
            0.000005 m
            -0.629733 m
         intersect_mesh ../meshes/su37.imesh
      end_processor
      ...
   end_platform_type

:ref:`Contact<docs/contact_info:Support>` the development team about generating new intersection meshes.

Commands
========

.. command:: define_offset <string-value> <length-value> <length-value> <length-value> 
   
   Define the offset name and location on the intersection mesh associated with the target area of interest (see example
   above).

.. command:: intersect_mesh <string-value>
   
   Define the file for the intersection mesh associated with this processor.