Documentation

Unity Engine

User Manual

Script Reference

Unity Engine

Project

Projects a vector onto another vector.
Read time 2 minutesLast updated 6 days ago

Definition

  • Type: Method
  • Namespace: UnityEngine
  • Assembly: UnityEngine.CoreModule

Project(Vector3, Vector3)

Projects a vector onto another vector.
public static Vector3 Project(Vector3 vector, Vector3 onNormal)

Parameters

vector

Vector3
The vector to project.

onNormal

Vector3
The vector to project onto. This vector doesn't need to be normalized.

Returns

Type

Description

Vector3The vector that results from the projection of 
vector
. This vector points in the same direction as 
onNormal
.

Remarks

The resulting projection is the amount of 
vector
that points in the same direction as 
onNormal
.
Vec3ProjectDiagram (Project)
Diagram showing a vector projected onto the vector 
onNormal
. The projected vector extends past 
onNormal
in the same direction because the magnitude of 
vector
in the direction of 
onNormal
is greater than the magnitude of 
onNormal
. The result points to the point along the infinite line in the direction of 
onNormal
that's closest to the point specified by 
vector
.
The function returns a zero vector if 
onNormal
is almost zero. 
onNormal
doesn't need to be a normalized vector.
You can use projection to work out the closest point along a line to a target vector. This information can be useful for moving or orienting items in the direction of a moving target.

Examples

using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{    void Slide(Transform target, Vector3 railDirection)    {        Vector3 heading = target.position - transform.position;        Vector3 force = Vector3.Project(heading, railDirection);        GetComponent<Rigidbody>().AddForce(force);    }}

Project(Vector3, Vector3)

Projects a vector onto another vector.
public static Vector3 Project(in Vector3 vector, in Vector3 onNormal)

Parameters

vector

Vector3
The vector to project.

onNormal

Vector3
The vector to project onto. This vector doesn't need to be normalized.

Returns

Type

Description

Vector3The vector that results from the projection of 
vector
. This vector points in the same direction as 
onNormal
.

Remarks

The resulting projection is the amount of 
vector
that points in the same direction as 
onNormal
.
Vec3ProjectDiagram (Project)
Diagram showing a vector projected onto the vector 
onNormal
. The projected vector extends past 
onNormal
in the same direction because the magnitude of 
vector
in the direction of 
onNormal
is greater than the magnitude of 
onNormal
. The result points to the point along the infinite line in the direction of 
onNormal
that's closest to the point specified by 
vector
.
The function returns a zero vector if 
onNormal
is almost zero. 
onNormal
doesn't need to be a normalized vector.
You can use projection to work out the closest point along a line to a target vector. This information can be useful for moving or orienting items in the direction of a moving target.

Examples

using UnityEngine;using System.Collections;public class ExampleClass : MonoBehaviour{    void Slide(Transform target, Vector3 railDirection)    {        Vector3 heading = target.position - transform.position;        Vector3 force = Vector3.Project(heading, railDirection);        GetComponent<Rigidbody>().AddForce(force);    }}