Daylight v4.9
Release Date: 1 February 2008


dt_alloc_conformation - allocate a new conformation object

Generic Prototype

dt_alloc_conformation(dt_Handle) => dt_Handle

C Prototype

#include "dt_depict.h"

dt_Handle dt_alloc_conformation(dt_Handle object)

FORTRAN Prototype

include ''

integer*4 dt_f_alloc_conformation(object)

integer*4 object


Allocates a new conformation object for the given molecule or reaction. All (x, y, z) coordinates of the new conformation are set to 0. Note that there is no theoretical limit to the number of conformations which may be created for a single molecule or reaction.

Each conformation has 'object' as its base object (see dt_base(3)). If the base object is deallocated, the conformation object will automatically be deallocated and its handle will be revoked. Unlike depictions, conformation objects are NOT deallocated when their base objects are modified.

Return Value

Returns the handle of a new conformation object, or NULL_OB if 'object' is not a molecule or reaction object.

Related Topics

dt_alloc_depiction(3) dt_base(3)