Daylight v4.9
Release Date: 1 February 2008


dt_alloc_depiction - allocate a new depiction object

Generic Prototype

dt_alloc_depiction(dt_Handle) => dt_Handle

C Prototype

#include "dt_depict.h"

dt_Handle dt_alloc_depiction(dt_Handle object)

FORTRAN Prototype

include ''

integer*4 dt_f_alloc_depiction(object)

integer*4 object


Allocates a new depiction object for the given molecule or reaction. All (x, y) coordinates of the new depiction are set to 0. The isomeric, compressed, and schematic attributes are initialized to FALSE.

Note that there is no theoretical limit to the number of depictions which may be created for a single molecule or reaction.

Each depiction has 'object' as its base object (see dt_base(3)). If the base object is deallocated or modified, the depiction object will automatically be deallocated and its handle will be revoked.

Return Value

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

Related Topics

dt_alloc_conformation(3) dt_base(3) dt_calcxy(3)