Release Date: 1 February 2008
Namedt_setorient - specify the orient attribute of a depiction
Generic Prototypedt_setorient(dt_Handle, dt_Integer) => dt_Boolean
C Prototype#include "dt_depict.h"
dt_Boolean dt_setorient(dt_Handle depiction, dt_Integer value)
FORTRAN Prototypeinclude 'dt_f_depict.inc'
logical dt_f_setorient(depiction, value)
DescriptionSets the value of the orient attribute of the depiction to 'value'. Valid values are DX_ORIENT_NONE, DX_ORIENT_AUTO, and DX_ORIENT_WILD.
Performs no orientation of the depiction.DX_ORIENT_AUTO
Performs automatic portrait/landscape orientation of the depiction. (Operates like pre-4.4 versions).DX_ORIENT_WILD
Uses the special atoms [*-1] and [*-2] to orient the depiction from left to right. The depiction is oriented by finding two "wildcard" atoms (the SMILES "*", i.e. atomic number zero), one with a charge of -1, and one with charge -2. The depiction is oriented then so that an imaginary line drawn between [*-1] and [*-2] is horizontal, [*-1] is to the left, and [*-2] to the right. Then, the atom that is farthest from this imaginary line is found; if it is below the line, the depiction is flipped around the line, orienting the picture so that the largest portion is above the imaginary line.
Return ValueReturns the success (TRUE) or failure (FALSE) of the operation.
Related Topicsdt_alloc_depiction(3) dt_orient(3)