# Synopsis

PDX_MSGT dxcr_Text(long option, MDA_PTR orig_ptr, double *xyzloc, double height, char *text, double rang, double xscale, double oang, char *tstyle, int tflag, int hjust, int vjust, double *xyzaln, int model, MDA_PTR *dxf_text_ptr)

# Purpose

Create a DXF Text.

# Description

A DXF Text entity is created for the given data.

The orig_ptr argument should contain the database pointer of the entity that the new entity was created from (usually this should be obtained by the calling routine via mda_GetOrigDbptr) or MDA_NULL_PTR. See the mda_intro man page for more information about predecessor entities. The insertion point, xyzloc, is the lower left point for the text. This is not the point around which the text is centered, middles, etc. It is literally the lower left point for the text. The center, middle, etc point is kept in xyzaln. hjust contains the value indicating the manner in which the text is justified. By default the text is left justified. The constants are: DXCR_TEXT_JUST_LEFT, DXCR_TEXT_JUST_CENTER, DXCR_TEXT_JUST_RIGHT, DXCR_TEXT_JUST_ALIGNED, DXCR_TEXT_JUST_MIDDLE, DXCR_TEXT_JUST_FIT @vjust indicates the vertical alignment of the text. By default it is along the baseline. The constants are: DXCR_TEXT_VALIGN_BASELINE, DXCR_TEXT_VALIGN_BOTTOM, DXCR_TEXT_VALIGN_MIDDLE, DXCR_TEXT_VALIGN_TOP @tflag is a bit-coded flag indicating special generation for the text. By default it is left to right, and right-side up. The two other possibilities are backward and upside-down. The options to be used are: DXCR_TEXT_GEN_BACKWARD, DXCR_TEXT_GEN_UPSIDEDOWN

# Input

## option

Options (not used)

## orig_ptr

The original entities orig_ptr as obtained from the mda_GetOrigDbptr call, or MDA_NULL_PTR

## xyzloc

Insertion point

## height

Height

## text

Text value

## rang

Rotation angle

## xscale

X-scale factor

## oang

Obliquing angle

## tstyle

Text table style name

## tflag

Text flag

## hjust

Horizontal justification

## vjust

Vertical justification

## xyzaln

Alignment point

## model

DXF model number

# Output

## dxf_text_ptr

Entity pointer of the DXF Text

# Return

          DXCR_NOERR
          Low level error return
          .fi