---
name: "mdraw_per_char_extents"
section: "3m17n"
platform: "linux"
package: "m17n-docs"
version: "1.8.4-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/mdraw_per_char_extents"
---

# mdraw\_per\_char\_extents(3m17n)

## NAME

mdraw\_per\_char\_extents -

## SYNOPSIS

void **mdraw\_per\_char\_extents** (**MFrame** \* *frame*, **MText** \* *mt*, **MDrawMetric** \* *array\_return*, **MDrawMetric** \* *overall\_return*)

## DESCRIPTION

Obtain per character dimension information. The **mdraw\_per\_char\_extents()** function computes the text dimension of each character in M-text **mt**. The faces given as text properties in **mt** and the default face of frame **frame** determine the fonts to draw the text. Each successive element in **array\_return** is set to the drawn metrics of successive characters, which is relative to the origin of the drawing, and a rectangle for each character in **mt**. The number of elements of **array\_return** must be equal to or greater than the number of characters in **mt**.

If pointer **overall\_return** is not `NULL`, this function also computes the extents of the overall text and stores the results in the members of the structure pointed to by **overall\_return**. \

## COPYRIGHT

Copyright (C) 2001 Information-technology Promotion Agency (IPA)\
 Copyright (C) 2001-2011 National Institute of Advanced Industrial Science and Technology (AIST)\
 Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License  \<http://www.gnu.org/licenses/fdl.html\>.
