//-
// ==========================================================================
// Copyright (C) 1995 - 2005 Alias Systems Corp. and/or its licensors.  All 
// rights reserved. 
// 
// The coded instructions, statements, computer programs, and/or related 
// material (collectively the "Data") in these files are provided by Alias 
// Systems Corp. ("Alias") and/or its licensors for the exclusive use of the 
// Customer (as defined in the Alias Software License Agreement that 
// accompanies this Alias software). Such Customer has the right to use, 
// modify, and incorporate the Data into other products and to distribute such 
// products for use by end-users.
//  
// THE DATA IS PROVIDED "AS IS".  ALIAS HEREBY DISCLAIMS ALL WARRANTIES 
// RELATING TO THE DATA, INCLUDING, WITHOUT LIMITATION, ANY AND ALL EXPRESS OR 
// IMPLIED WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND/OR FITNESS FOR A 
// PARTICULAR PURPOSE. IN NO EVENT SHALL ALIAS BE LIABLE FOR ANY DAMAGES 
// WHATSOEVER, WHETHER DIRECT, INDIRECT, SPECIAL, OR PUNITIVE, WHETHER IN AN 
// ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, OR IN EQUITY, 
// ARISING OUT OF ACCESS TO, USE OF, OR RELIANCE UPON THE DATA.
// ==========================================================================
//+

// DISCLAIMER: THIS PLUGIN IS PROVIDED AS IS.  IT IS NOT SUPPORTED BY

//            ALIAS, SO PLEASE USE AND MODIFY AT YOUR OWN RISK.

//

// PLUGIN NAME: closestPointOnCurve v1.0

// FILE: closestTangentUAndDistance.cpp

// DESCRIPTION: -Utility function definition, used by both the command and node.

//              -Please see readme.txt for full details.

// AUTHOR: QT

// REFERENCES: -This plugin's concept is based off of the "closestPointOnSurface" node.

//             -The MEL script AEclosestPointOnSurfaceTemplate.mel was referred to for

//              the AE template MEL script that accompanies the closestPointOnCurve node.

// LAST UPDATED: Oct. 13th, 2001.

// COMPILED AND TESTED ON: Maya 4.0 on Windows





// HEADER FILE:

#include "closestTangentUAndDistance.h"





// FUNCTION WHICH TAKES A SPECIFIED INPUT CURVE AND A WORLDSPACE POSITION, AND FINDS THE CLOSEST POSITION, NORMAL, TANGENT, PARAMETER-U AND CLOSEST-DISTANCE FROM THE CURVE:

void closestTangentUAndDistance(MDagPath curveDagPath, MPoint inPosition, MPoint &position, MVector &normal, MVector &tangent, double &paramU, double &distance, MObject theCurve)

{

   // FIND THE CLOSEST POSITION AND PARAMETER-U FROM THE INPUT POSITION:

   MFnNurbsCurve curveFn(curveDagPath);

   if (theCurve!=MObject::kNullObj)

      curveFn.setObject(theCurve);

   position = curveFn.closestPoint(inPosition, &paramU, 0.0, MSpace::kWorld);



   // FIND THE NORMAL, TANGENT AND DISTANCE FROM THE CLOSEST POINT:

   normal = curveFn.normal(paramU, MSpace::kWorld);

   tangent = curveFn.tangent(paramU, MSpace::kWorld);

   distance = curveFn.distanceToPoint(inPosition, MSpace::kWorld);

}