File content in vector.inc // vim: set ts=4 sw=4 tw=99 noet: // // AMX Mod X, based on AMX Mod by Aleksander Naszko ("OLO"). // Copyright (C) The AMX Mod X Development Team. // // This software is licensed under the GNU General Public License, version 3 or higher. // Additional exceptions apply. For full license details, see LICENSE.txt or visit: // https://alliedmods.net/amxmodx-license // // Vector Functions // #if defined _corevector_included #endinput #endif #define _corevector_included /** * Used for angle_vector() */ #define ANGLEVECTOR_FORWARD 1 #define ANGLEVECTOR_RIGHT 2 #define ANGLEVECTOR_UP 3 /** * Calculates the distance between two input vectors. * * @param origin1 The first vector * @param origin2 The second vector * * @return The distance between two input vectors */ native get_distance(const origin1[3], const origin2[3]); /** * Calculates the distance between two input float vectors. * * @param origin1 The first vector * @param origin2 The second vector * * @return The distance between two input vectors */ native Float:get_distance_f(const Float:Origin1[3], const Float:Origin2[3]); /** * Calculates velocity in the direction player is looking. * * @param iIndex Client index * @param iVelocity Multiply vRetValue length by this much * @param vRetValue Store the calculated velocity in this vector. * * @noreturn * @error If client is not connected or client index is not * within the range of 1 to MaxClients. */ native velocity_by_aim(iIndex, iVelocity, Float:vRetValue[3]); /** * Changes a vector into an angle vector. * * @param fVector Input vector * @param vReturn Output angle vector * * @noreturn */ native vector_to_angle(const Float:fVector[3], Float:vReturn[3]); /** * Changes an angle vector into a vector. * * @param vector Input angle vector * @param FRU One of the ANGLEVECTOR_* constants * @param ret Output vector * * @noreturn */ native angle_vector(const Float:vector[3], FRU, Float:ret[3]); /** * Calculates the length of a vector. * * @param vVector Input vector * * @return Length of the input vector */ native Float:vector_length(const Float:vVector[3]); /** * Calculates the distance between two vectors. * * @param vVector The first vector * @param vVector2 The second vector * * @return Distance between two input vectors */ native Float:vector_distance(const Float:vVector[3], const Float:vVector2[3]); /** * Converts an integer vector to a floating point vector. * * @param IVec Input integer vector * @param FVec Output float vector * * @noreturn */ stock IVecFVec(const IVec[3], Float:FVec[3]) { FVec[0] = float(IVec[0]); FVec[1] = float(IVec[1]); FVec[2] = float(IVec[2]); return 1; } /** * Converts a floating point vector into an integer vector. * * @param FVec Input float vector * @param IVec Output integer vector * * @noreturn */ stock FVecIVec(const Float:FVec[3], IVec[3]) { IVec[0] = floatround(FVec[0]); IVec[1] = floatround(FVec[1]); IVec[2] = floatround(FVec[2]); return 1; }