# TFormPoint x#, y#, z#, source_entity, dest_entity

# Parameters

x#, y#, z# = coordinates of a point in 3d space source_entity = handle of source entity, or 0 for 3d world dest_entity = handle of destination entity, or 0 for 3d world

# Description

Transforms between coordinate systems. After using TFormPoint the new coordinates can be read with TFormedX(), TFormedY() and TFormedZ(). See EntityX() for details about local coordinates. Consider a sphere built with CreateSphere(). The 'north pole' is at (0,1,0). At first, local and global coordinates are the same. As the sphere is moved, turned and scaled the global coordinates of the point change. But it is always at (0,1,0) in the sphere's local space.

# Example

; TFormPoint example Graphics3D 640, 480 s = CreateSphere() ; center at (0,0,0) north pole at (0,1,0) MoveEntity s, 1,2,3 ; center at (1,2,3) north pole at (1,2+1,3) ScaleEntity s, 10,10,10 ; center at (1,2,3) north pole at (1,2+10,3) ; Now verify that the north pole is at (1,12,3) in the 3d world TFormPoint 0,1,0, s,0 ; north pole transformed from sphere to world message$ = "North pole is at ( " message = message + TFormedX() + ", " + TFormedY() + ", " + TFormedZ() + " )" Text 180, 200, message Flip WaitKey() End

Index
Click here to view the latest version of this page online