Daylight v4.9
Release Date: 1 February 2008

Name

dt_setcoord - specify the coordinates of an object

Generic Prototype

dt_setcoord(dt_Handle, dt_Handle, dt_Real, dt_Real, dt_Real) => dt_Boolean

C Prototype

#include "dt_depict.h"

dt_Boolean dt_setcoord(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_setcoord(object, atom, x, y, z)

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

Description

Sets the (x,y) or (x,y,z) coordinates of an atom in the depiction or conformation 'object'. If 'object' is a depiction, z is ignored, but must be present. To "unset" coordinates, call dt_zerocoord(3).

This routine can be used in conjuction with dt_calcxy() to control the layout of a depiction.

Return Value

Returns the success (TRUE) or failure (FALSE) of the operation.

Related Topics

dt_alloc_conformation(3) dt_alloc_depiction(3) dt_calcxy(3) dt_depict(3) dt_getcoord(3) dt_project(3) dt_rotate(3) dt_scale(3) dt_translate(3) dt_zerocoord(3)