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