mySignaturePropagator.h

Go to the documentation of this file.

/*******************************************************************************
** Copyright (c) 2012 MAK Technologies, Inc.
** All rights reserved.
*******************************************************************************/

#pragma once

#include "vrfobjcore/visualSignaturePropagator.h"

const char MyPropagatorType[] = "my-signature-propagator";

class  MySignaturePropagator : public DtVisualSignaturePropagator
{
public:
   MySignaturePropagator(const DtSignaturePropagatorDescriptor* desc,
      DtPhysicalWorld* physicalWorld);

   virtual ~MySignaturePropagator();

   virtual void init();

   // This is the main entry point for any signature propagator.  
   // It takes an absolute signature, which is how "bright" the target entity is,
   // and translates that to an apparent signature, which is how bright the
   // target entity appears from a given vantage point.
   // A return value of 0 will guarantee that the entity cannot be seen.
   // Higher values will result in the target being easier to see.
   // The exact meaning of the returned apparent signatures is determined
   // by the sensor class that is using it.  For example, some sensors
   // may be more sensitive than others, but if they are all operating in the same
   // sensor domain, they will use the same propagator, but the more sensitive 
   // sensor will detect entities with a lower apparent signature than the other.
   virtual double calculateApparentSignature(double absoluteSignature,
      const DtSignaturePropagatorArgs& args, bool* dataAvailable = nullptr) const override;

   static DtSignaturePropagator* create(const DtSignaturePropagatorDescriptor* desc,
      DtPhysicalWorld* physicalWorld);
};