Name

---

    PROJECTIVE_MAPPING_MATRIX

Purpose

---

    This function will compute the projective transformation matrix
    to allow the conversion between two sets of quadrilateral
    vertices, one set being considered the image and the other being
    considered the map. The determined transformation, mappingMatrix,
    can be subsequently used to convert a homogenous map coordinate [u,v]
    to a homogenous image coordinate [x,y] according to the following
    expression
    [x, y, 1] = TRANSPOSE( NORMH( mappingMatrix ## TRANSPOSE( [u, v, 1] ) ) )

Category

---

    GENERAL.

Calling Sequence

---

    result = PROJECTIVE_MAPPING_MATRIX( imageX, imageY, mapX, mapY )

Inputs

---

    imageX
      A 4-element vector containing the x coordinates of the vertices
      defining the quadritalteral on the image to be transformed.
    imageY
      A 4-element vector containing the y coordinates of the vertices
      defining the quadritalteral on the image to be transformed.
    mapX
      A 4-element vector containing the x coordinates of the vertices
      defining the quadritalteral on the map to serve as a target for
      the transform.
    mapY
      A 4-element vector containing the y coordinates of the vertices
      defining the quadritalteral on the map to serve as a target for
      the transform.

Keyword Parametrs

---

    None.
  :ERROR CHECKING:
    None.

Side Effects

---

    None.

Requires

---

    None.

Modification History

---

    Written by: Carl Salvaggio
    January, 2012 Original code
   

Disclaimer

---

    This source code is provided "as is" and without warranties as to performance
    or merchantability. The author and/or distributors of this source code may
    have made statements about this source code. Any such statements do not
    constitute warranties and shall not be relied on by the user in deciding
    whether to use this source code.
    This source code is provided without any express or implied warranties
    whatsoever. Because of the diversity of conditions and hardware under which
    this source code may be used, no warranty of fitness for a particular purpose
    is offered. The user is advised to test the source code thoroughly before
    relying on it. The user must assume the entire risk of using the source code.