vector2  rotate_x_to(vector2 direction, vector2 v)
                    
                    
                
            
                
                    
                    
                    
                        vector  rotate_x_to(vector direction, vector v)
                    
                    
                
            
                
                    
                    
                    
                        vector4  rotate_x_to(vector4 direction, vector4 v)
                    
                    
                
            
            
                direction
            
            
        
Direction to which a vector along the positive x-axis, e.g. (1,0,0), would be rotated. This does not need to be normalized.
            
                v
            
            
        
Vector to which to apply the rotation.
Applies to v, the rotation that would move (1,0), (1,0,0), or (1,0,0,0) to
direction most directly.
In the case of direction being (-1,0,0), there are multiple distinct
rotations that would move (1,0,0) to (-1,0,0) with a
half turn rotation, so one is chosen arbitrarily, negating v.x and v.z.
In 2D, there is only one distinct rotation that moves (1,0) to (-1,0),
equivalent to negating v.  In 4D, the rotation where v is negated
is also chosen.
This is used by functions like sample_direction_cone and sample_sphere_cone
to rotate the cone centre from (1,0,0) to a given direction vector.
| See also | |
| transform | |
| vector |