Daylight v4.9
Release Date: 1 February 2008

Name

dt_getcoord - retrieve the coordinates of an object

Generic Prototype

dt_getcoord(dt_Handle, dt_Handle, dt_Real *, dt_Real *, dt_Real *)
=> dt_Boolean

C Prototype

#include "dt_depict.h"

dt_Boolean dt_getcoord(dt_Handle object, dt_Handle atom, dt_Real *x, dt_Real *y, dt_Real *z)

FORTRAN Prototype

include 'dt_f_depict.inc'

logical dt_f_getcoord(object, atom, x, y, z)

integer*4 object
integer*4 atom
real*4 x
real*4 y
real*4 z

Description

Gets the (x,y) or (x,y,z) coordinates of an atom in the depiction or conformation 'object'. If 'object' is a depiction, z is not altered, but must be present.

Return Value

Returns the success (TRUE) or failure (FALSE) of the operation. x, y, and z are return values.

Related Topics

dt_calcxy(3) dt_project(3) dt_rotate(3) dt_scale(3) dt_setcoord(3) dt_translate(3) dt_zerocoord(3)