NAME

       mdraw_text_per_char_extents - Compute the text dimensions of each character of M-text.

SYNOPSIS

       int mdraw_text_per_char_extents (MFrame * frame, MText * mt, int from, int to,
       MDrawControl * control, MDrawMetric * ink_array_return, MDrawMetric *
       logical_array_return, int array_size, int * num_chars_return, MDrawMetric *
       overall_ink_return, MDrawMetric * overall_logical_return)

DESCRIPTION

       Compute the text dimensions of each character of M-text. The mdraw_text_per_char_extents()
       function computes the drawn metric of each character between from and to of M-text mt
       assuming that they are drawn on a window of frame frame using the
       mdraw_text_with_control() function with the drawing control object control.

       array_size specifies the size of ink_array_return and logical_array_return.  Each
       successive element of ink_array_return and logical_array_return are set to the drawn ink
       and logical metrics of successive characters respectively, relative to the drawing origin
       of the M-text. The number of elements of ink_array_return and logical_array_return that
       have been set is returned to num_chars_return.

       If array_size is too small to return all metrics, the function returns -1 and store the
       requested size in num_chars_return.  Otherwise, it returns zero.

       If pointer overall_ink_return and overall_logical_return are not NULL, this function also
       computes the metrics of the overall text and stores the results in the members of the
       structure pointed to by overall_ink_return and overall_logical_return.

       If control->two_dimensional is nonzero, this function computes only the metrics of
       characters in the first line.

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