Synopsis

PDX_MSGT gdx_LinearApproxText(long option, const GDX_APPROX_PARAMS *approx_params, const char *text, MTH_3DPNT origin, double width, double height, double rotang, double sltang, int font, int mirror_code, int dir_code, GDX_MATRIX matrix, int model, MDA_COUNT *num_gdx_approx, MDA_PTR **gdx_approx_ptrs)

Purpose

Linear approximate text

Description

Perform linear approximation on text. The result is a GDX linear approximation entity created in a specified model. The GDX linear approximation entity will be a GDX_POLYLINE. In general, if the approximation method is GDX_TOLERANCE, then the approximation involves iterative procedures that work until the requested tolerance is realized.

Input

option

Options (not used)

approx_params

The linear approximation parameters or NULL. If NULL is used, then the default linear approximation parameters are used. See the gdx_InitApproxParams manual page for information on how to set these values.

text

Text string to approximate

origin

Origin of text

width

Width

height

Height

rotang

rotation angle

sltang

angle

font

font

mirror_code

whether to mirror the text

dir_code

direction code is facing

matrix

matrix to apply to text

model

The model to create the approximation entity in

Output

num_gdx_approx

The count of GDX linear approximation entities

gdx_approx_ptrs

The linear approximation entity structure database pointers.

Tolerances

      MODEL_SPACE_PNT_TOL
      PARM_SPACE_PNT_TOL
      ANGLE_TOL
      ZERO_TOL
      CONVERGE_TOL
      KNOT_TOL
      PNT_PROJ_TOL
      PARALLEL_LINES_TOL
      COLLINEAR_TOL
      COPLANAR_TOL
      .fi

Return

      GDX_NOERR
      GDX_LINAPPROXNODATA
      GDX_INVALIDMODEL
      GDX_INVALIDENTITYTYPE
      Low level error return
      .fi