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

# mdraw\_coordinates\_position(3m17n)

## NAME

mdraw\_coordinates\_position -

## SYNOPSIS

int **mdraw\_coordinates\_position** (**MFrame** \* *frame*, **MText** \* *mt*, int *from*, int *to*, int *x\_offset*, int *y\_offset*, **MDrawControl** \* *control*)

## DESCRIPTION

Return the character position nearest to the coordinates. The **mdraw\_coordinates\_position()** function checks which character is to be drawn at coordinate (**x**, **y**) when the text between **from** and **to** of M-text **mt** is drawn at the coordinate (0, 0) using the **mdraw\_text\_with\_control()** function with the drawing control object **control**. Here, the character position means the number of characters that precede the character in question in **mt**, that is, the character position of the first character is 0.

**frame** is used only to get the default face information.

## RETURN VALUE

If the glyph image of a character covers coordinate (**x**, **y**), **mdraw\_coordinates\_position()** returns the character position of that character.\

If **y** is less than the minimum Y-coordinate of the drawn area, it returns **from**.\

If **y** is greater than the maximum Y-coordinate of the drawn area, it returns **to**.\

If **y** fits in with the drawn area but **x** is less than the minimum X-coordinate, it returns the character position of the first character drawn on the line **y**.\

If **y** fits in with the drawn area but **x** is greater than the maximum X-coordinate, it returns the character position of the last character drawn on the line **y**. \

## 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\>.