Package com.irurueta.ar.sfm

Interface BaseTwoViewsSparseReconstructorListener<R extends BaseTwoViewsSparseReconstructor<?,?,?>>

Type Parameters:
R - type of re-constructor.
All Known Subinterfaces:
AbsoluteOrientationConstantVelocityModelSlamTwoViewsSparseReconstructorListener, AbsoluteOrientationSlamTwoViewsSparseReconstructorListener, BaseSlamTwoViewsSparseReconstructorListener<R>, ConstantVelocityModelSlamTwoViewsSparseReconstructorListener, KnownBaselineTwoViewsSparseReconstructorListener, SlamTwoViewsSparseReconstructorListener, TwoViewsSparseReconstructorListener
public interface BaseTwoViewsSparseReconstructorListener<R extends BaseTwoViewsSparseReconstructor<?,?,?>>
Listener to retrieve and store required data to compute a 3D reconstruction from sparse image point correspondences in two views.

  • Method Details

    • hasMoreViewsAvailable

      boolean hasMoreViewsAvailable(R reconstructor)
      Called to determine whether there are more views available to attempt to use for the reconstruction.
      Parameters:
      reconstructor - re-constructor raising this event.
      Returns:
      true if there are more views available, false otherwise.

    • onRequestSamplesForCurrentView

      void onRequestSamplesForCurrentView(R reconstructor, int viewId, List<Sample2D> samples)
      Called when samples containing points of interest for current view must be retrieved.
      Parameters:
      reconstructor - re-constructor raising this event.
      viewId - id of view where points will be used.
      samples - samples containing points of interest for current view to test.

    • onSamplesAccepted

      void onSamplesAccepted(R reconstructor, int viewId, List<Sample2D> samples)
      Called when requested samples have been accepted. This method can be used to determine whether samples can be stored or not.
      Parameters:
      reconstructor - re-constructor raising this event.
      viewId - id of view whose samples have been accepted.
      samples - accepted samples.

    • onSamplesRejected

      void onSamplesRejected(R reconstructor, int viewId, List<Sample2D> samples)
      Called when requested samples have been rejected. This method can be used to remove provided samples.
      Parameters:
      reconstructor - re-constructor raising this event.
      viewId - id of view whose samples have been rejected.
      samples - rejected samples.

    • onRequestMatches

      void onRequestMatches(R reconstructor, List<Sample2D> samples1, List<Sample2D> samples2, int viewId1, int viewId2, List<MatchedSamples> matches)
      Finds matches for provided samples.
      Parameters:
      reconstructor - re-constructor raising this event.
      samples1 - samples on first view.
      samples2 - samples on second view.
      viewId1 - id of first view.
      viewId2 - id of second view.
      matches - instance where matches must be stored.

    • onFundamentalMatrixEstimated

      void onFundamentalMatrixEstimated(R reconstructor, EstimatedFundamentalMatrix estimatedFundamentalMatrix)
      Called when a fundamental matrix relating two views has been estimated. This event can be used to store estimated fundamental matrix relating two views.
      Parameters:
      reconstructor - re-constructor raising this event.
      estimatedFundamentalMatrix - estimated fundamental matrix.

    • onCamerasEstimated

      void onCamerasEstimated(R reconstructor, int viewId1, int viewId2, EstimatedCamera camera1, EstimatedCamera camera2)
      Notifies when cameras for provided matched pair of views have been estimated. This event can be used to store points associated to such view.
      Parameters:
      reconstructor - re-constructor raising this event.
      viewId1 - id of first view.
      viewId2 - id of second view.
      camera1 - estimated camera for first view.
      camera2 - estimated camera for second view.

    • onReconstructedPointsEstimated

      void onReconstructedPointsEstimated(R reconstructor, List<MatchedSamples> matches, List<ReconstructedPoint3D> points)
      Called when reconstructed points have been estimated from a series of 2D matches. This event can be used to store reconstructed points and their associated data.
      Parameters:
      reconstructor - re-constructor raising this event.
      matches - 2D matches associated to estimated reconstructed points.
      points - reconstructed 3D points.

    • onStart

      void onStart(R reconstructor)
      Called when reconstruction starts.
      Parameters:
      reconstructor - re-constructor raising this event.

    • onFinish

      void onFinish(R reconstructor)
      Called when reconstruction stops.
      Parameters:
      reconstructor - re-constructor raising this event.

    • onCancel

      void onCancel(R reconstructor)
      Called when reconstruction is cancelled before it has finished.
      Parameters:
      reconstructor - re-constructor raising this event.

    • onFail

      void onFail(R reconstructor)
      Called when reconstruction fails.
      Parameters:
      reconstructor - re-constructor raising this event.