Release Date: 1 February 2008
Namedt_calcxy - compute planar coordinates for a depiction
Generic Prototypedt_calcxy(dt_Handle) => dt_Boolean
C Prototype#include "dt_depict.h"
dt_Boolean dt_calcxy(dt_Handle depiction)
FORTRAN Prototypeinclude 'dt_f_depict.inc'
DescriptionSets atom coordinates and bond styles of the given depiction using an internal algorithm. The coordinates and styles are set according to the current attributes of the depiction and the underlying molecule or reaction. If any of these attributes change, the coordinates and styles ma become outdated. It is the programmers responsibility to recalculate them when necessary.
Atom coordinates that are specified with dt_setcoord(3) are preserved and only unspecified coordinates are set. There are two restrictions when partially specifying the layout: 1) all atoms with coordinates must be within the same substructure, and 2) ring systems must have all atoms or no atoms in the substructure. If the layout is partially specified and either of these two conditions are not met, then all atom coordinates are computed and set. In v4,82 and v4,83, the boolean "use_2d" Named Property for the depiction controlled whether or not specified coordinates are preserved. As of v4.9, dt_zerocoord(3) is used to "unspecified" atom coordinates.
Bond styles are determined by an implicit call to dt_setbondstyles(3).
Return ValueReturns the success (TRUE) or failure (FALSE) of the operation.
Related Topicsdt_alloc_conformation(3) dt_alloc_depiction(3) dt_depict(3) dt_getcoord(3) dt_project(3) dt_rotate(3) dt_scale(3) dt_setbondstyle(3) dt_setcoord(3) dt_setvisible(3) dt_translate(3) dt_zerocoord(3)