Blame src/hb-buffer-serialize.cc

Packit 874993
/*
Packit 874993
 * Copyright © 2012,2013  Google, Inc.
Packit 874993
 *
Packit 874993
 *  This is part of HarfBuzz, a text shaping library.
Packit 874993
 *
Packit 874993
 * Permission is hereby granted, without written agreement and without
Packit 874993
 * license or royalty fees, to use, copy, modify, and distribute this
Packit 874993
 * software and its documentation for any purpose, provided that the
Packit 874993
 * above copyright notice and the following two paragraphs appear in
Packit 874993
 * all copies of this software.
Packit 874993
 *
Packit 874993
 * IN NO EVENT SHALL THE COPYRIGHT HOLDER BE LIABLE TO ANY PARTY FOR
Packit 874993
 * DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES
Packit 874993
 * ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN
Packit 874993
 * IF THE COPYRIGHT HOLDER HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
Packit 874993
 * DAMAGE.
Packit 874993
 *
Packit 874993
 * THE COPYRIGHT HOLDER SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING,
Packit 874993
 * BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND
Packit 874993
 * FITNESS FOR A PARTICULAR PURPOSE.  THE SOFTWARE PROVIDED HEREUNDER IS
Packit 874993
 * ON AN "AS IS" BASIS, AND THE COPYRIGHT HOLDER HAS NO OBLIGATION TO
Packit 874993
 * PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
Packit 874993
 *
Packit 874993
 * Google Author(s): Behdad Esfahbod
Packit 874993
 */
Packit 874993
Packit 874993
#include "hb-buffer-private.hh"
Packit 874993
Packit 874993
Packit 874993
static const char *serialize_formats[] = {
Packit 874993
  "text",
Packit 874993
  "json",
Packit 874993
  NULL
Packit 874993
};
Packit 874993
Packit 874993
/**
Packit 874993
 * hb_buffer_serialize_list_formats:
Packit 874993
 *
Packit 874993
 * Returns a list of supported buffer serialization formats.
Packit 874993
 *
Packit 874993
 * Return value: (transfer none):
Packit 874993
 * A string array of buffer serialization formats. Should not be freed.
Packit 874993
 *
Packit 874993
 * Since: 0.9.7
Packit 874993
 **/
Packit 874993
const char **
Packit 874993
hb_buffer_serialize_list_formats (void)
Packit 874993
{
Packit 874993
  return serialize_formats;
Packit 874993
}
Packit 874993
Packit 874993
/**
Packit 874993
 * hb_buffer_serialize_format_from_string:
Packit 874993
 * @str: (array length=len) (element-type uint8_t): a string to parse
Packit 874993
 * @len: length of @str, or -1 if string is %NULL terminated
Packit 874993
 *
Packit 874993
 * Parses a string into an #hb_buffer_serialize_format_t. Does not check if
Packit 874993
 * @str is a valid buffer serialization format, use
Packit 874993
 * hb_buffer_serialize_list_formats() to get the list of supported formats.
Packit 874993
 *
Packit 874993
 * Return value: 
Packit 874993
 * The parsed #hb_buffer_serialize_format_t.
Packit 874993
 *
Packit 874993
 * Since: 0.9.7
Packit 874993
 **/
Packit 874993
hb_buffer_serialize_format_t
Packit 874993
hb_buffer_serialize_format_from_string (const char *str, int len)
Packit 874993
{
Packit 874993
  /* Upper-case it. */
Packit 874993
  return (hb_buffer_serialize_format_t) (hb_tag_from_string (str, len) & ~0x20202020u);
Packit 874993
}
Packit 874993
Packit 874993
/**
Packit 874993
 * hb_buffer_serialize_format_to_string:
Packit 874993
 * @format: an #hb_buffer_serialize_format_t to convert.
Packit 874993
 *
Packit 874993
 * Converts @format to the string corresponding it, or %NULL if it is not a valid
Packit 874993
 * #hb_buffer_serialize_format_t.
Packit 874993
 *
Packit 874993
 * Return value: (transfer none):
Packit 874993
 * A %NULL terminated string corresponding to @format. Should not be freed.
Packit 874993
 *
Packit 874993
 * Since: 0.9.7
Packit 874993
 **/
Packit 874993
const char *
Packit 874993
hb_buffer_serialize_format_to_string (hb_buffer_serialize_format_t format)
Packit 874993
{
Packit 874993
  switch (format)
Packit 874993
  {
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_TEXT:	return serialize_formats[0];
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_JSON:	return serialize_formats[1];
Packit 874993
    default:
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_INVALID:	return NULL;
Packit 874993
  }
Packit 874993
}
Packit 874993
Packit 874993
static unsigned int
Packit 874993
_hb_buffer_serialize_glyphs_json (hb_buffer_t *buffer,
Packit 874993
				  unsigned int start,
Packit 874993
				  unsigned int end,
Packit 874993
				  char *buf,
Packit 874993
				  unsigned int buf_size,
Packit 874993
				  unsigned int *buf_consumed,
Packit 874993
				  hb_font_t *font,
Packit 874993
				  hb_buffer_serialize_flags_t flags)
Packit 874993
{
Packit 874993
  hb_glyph_info_t *info = hb_buffer_get_glyph_infos (buffer, NULL);
Packit 874993
  hb_glyph_position_t *pos = (flags & HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS) ?
Packit 874993
			     NULL : hb_buffer_get_glyph_positions (buffer, NULL);
Packit 874993
Packit 874993
  *buf_consumed = 0;
Packit 874993
  for (unsigned int i = start; i < end; i++)
Packit 874993
  {
Packit 874993
    char b[1024];
Packit 874993
    char *p = b;
Packit 874993
Packit 874993
    /* In the following code, we know b is large enough that no overflow can happen. */
Packit 874993
Packit 874993
#define APPEND(s) HB_STMT_START { strcpy (p, s); p += strlen (s); } HB_STMT_END
Packit 874993
Packit 874993
    if (i)
Packit 874993
      *p++ = ',';
Packit 874993
Packit 874993
    *p++ = '{';
Packit 874993
Packit 874993
    APPEND ("\"g\":");
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES))
Packit 874993
    {
Packit 874993
      char g[128];
Packit 874993
      hb_font_glyph_to_string (font, info[i].codepoint, g, sizeof (g));
Packit 874993
      *p++ = '"';
Packit 874993
      for (char *q = g; *q; q++) {
Packit 874993
        if (*q == '"')
Packit 874993
	  *p++ = '\\';
Packit 874993
	*p++ = *q;
Packit 874993
      }
Packit 874993
      *p++ = '"';
Packit 874993
    }
Packit 874993
    else
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "%u", info[i].codepoint));
Packit 874993
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS)) {
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), ",\"cl\":%u", info[i].cluster));
Packit 874993
    }
Packit 874993
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS))
Packit 874993
    {
Packit 874993
      p += snprintf (p, ARRAY_LENGTH (b) - (p - b), ",\"dx\":%d,\"dy\":%d",
Packit 874993
		     pos[i].x_offset, pos[i].y_offset);
Packit 874993
      p += snprintf (p, ARRAY_LENGTH (b) - (p - b), ",\"ax\":%d,\"ay\":%d",
Packit 874993
		     pos[i].x_advance, pos[i].y_advance);
Packit 874993
    }
Packit 874993
Packit 874993
    if (flags & HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS)
Packit 874993
    {
Packit 874993
      hb_glyph_extents_t extents;
Packit 874993
      hb_font_get_glyph_extents(font, info[i].codepoint, &extents);
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), ",\"xb\":%d,\"yb\":%d",
Packit 874993
        extents.x_bearing, extents.y_bearing));
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), ",\"w\":%d,\"h\":%d",
Packit 874993
        extents.width, extents.height));
Packit 874993
    }
Packit 874993
Packit 874993
    *p++ = '}';
Packit 874993
Packit 874993
    unsigned int l = p - b;
Packit 874993
    if (buf_size > l)
Packit 874993
    {
Packit 874993
      memcpy (buf, b, l);
Packit 874993
      buf += l;
Packit 874993
      buf_size -= l;
Packit 874993
      *buf_consumed += l;
Packit 874993
      *buf = '\0';
Packit 874993
    } else
Packit 874993
      return i - start;
Packit 874993
  }
Packit 874993
Packit 874993
  return end - start;
Packit 874993
}
Packit 874993
Packit 874993
static unsigned int
Packit 874993
_hb_buffer_serialize_glyphs_text (hb_buffer_t *buffer,
Packit 874993
				  unsigned int start,
Packit 874993
				  unsigned int end,
Packit 874993
				  char *buf,
Packit 874993
				  unsigned int buf_size,
Packit 874993
				  unsigned int *buf_consumed,
Packit 874993
				  hb_font_t *font,
Packit 874993
				  hb_buffer_serialize_flags_t flags)
Packit 874993
{
Packit 874993
  hb_glyph_info_t *info = hb_buffer_get_glyph_infos (buffer, NULL);
Packit 874993
  hb_glyph_position_t *pos = (flags & HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS) ?
Packit 874993
			     NULL : hb_buffer_get_glyph_positions (buffer, NULL);
Packit 874993
Packit 874993
  *buf_consumed = 0;
Packit 874993
  for (unsigned int i = start; i < end; i++)
Packit 874993
  {
Packit 874993
    char b[1024];
Packit 874993
    char *p = b;
Packit 874993
Packit 874993
    /* In the following code, we know b is large enough that no overflow can happen. */
Packit 874993
Packit 874993
    if (i)
Packit 874993
      *p++ = '|';
Packit 874993
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES))
Packit 874993
    {
Packit 874993
      hb_font_glyph_to_string (font, info[i].codepoint, p, 128);
Packit 874993
      p += strlen (p);
Packit 874993
    }
Packit 874993
    else
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "%u", info[i].codepoint));
Packit 874993
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS)) {
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "=%u", info[i].cluster));
Packit 874993
    }
Packit 874993
Packit 874993
    if (!(flags & HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS))
Packit 874993
    {
Packit 874993
      if (pos[i].x_offset || pos[i].y_offset)
Packit 874993
	p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "@%d,%d", pos[i].x_offset, pos[i].y_offset));
Packit 874993
Packit 874993
      *p++ = '+';
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "%d", pos[i].x_advance));
Packit 874993
      if (pos[i].y_advance)
Packit 874993
	p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), ",%d", pos[i].y_advance));
Packit 874993
    }
Packit 874993
Packit 874993
    if (flags & HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS)
Packit 874993
    {
Packit 874993
      hb_glyph_extents_t extents;
Packit 874993
      hb_font_get_glyph_extents(font, info[i].codepoint, &extents);
Packit 874993
      p += MAX (0, snprintf (p, ARRAY_LENGTH (b) - (p - b), "<%d,%d,%d,%d>", extents.x_bearing, extents.y_bearing, extents.width, extents.height));
Packit 874993
    }
Packit 874993
Packit 874993
    unsigned int l = p - b;
Packit 874993
    if (buf_size > l)
Packit 874993
    {
Packit 874993
      memcpy (buf, b, l);
Packit 874993
      buf += l;
Packit 874993
      buf_size -= l;
Packit 874993
      *buf_consumed += l;
Packit 874993
      *buf = '\0';
Packit 874993
    } else
Packit 874993
      return i - start;
Packit 874993
  }
Packit 874993
Packit 874993
  return end - start;
Packit 874993
}
Packit 874993
Packit 874993
/**
Packit 874993
 * hb_buffer_serialize_glyphs:
Packit 874993
 * @buffer: an #hb_buffer_t buffer.
Packit 874993
 * @start: the first item in @buffer to serialize.
Packit 874993
 * @end: the last item in @buffer to serialize.
Packit 874993
 * @buf: (out) (array length=buf_size) (element-type uint8_t): output string to
Packit 874993
 *       write serialized buffer into.
Packit 874993
 * @buf_size: the size of @buf.
Packit 874993
 * @buf_consumed: (out) (allow-none): if not %NULL, will be set to the number of byes written into @buf.
Packit 874993
 * @font: (allow-none): the #hb_font_t used to shape this buffer, needed to
Packit 874993
 *        read glyph names and extents. If %NULL, and empty font will be used.
Packit 874993
 * @format: the #hb_buffer_serialize_format_t to use for formatting the output.
Packit 874993
 * @flags: the #hb_buffer_serialize_flags_t that control what glyph properties
Packit 874993
 *         to serialize.
Packit 874993
 *
Packit 874993
 * Serializes @buffer into a textual representation of its glyph content,
Packit 874993
 * useful for showing the contents of the buffer, for example during debugging.
Packit 874993
 * There are currently two supported serialization formats:
Packit 874993
 *
Packit 874993
 * ## text
Packit 874993
 * A human-readable, plain text format.
Packit 874993
 * The serialized glyphs will look something like:
Packit 874993
 *
Packit 874993
 * ```
Packit 874993
 * [uni0651=0@518,0+0|uni0628=0+1897]
Packit 874993
 * ```
Packit 874993
 * - The serialized glyphs are delimited with `[` and `]`.
Packit 874993
 * - Glyphs are separated with `|`
Packit 874993
 * - Each glyph starts with glyph name, or glyph index if
Packit 874993
 *   #HB_BUFFER_SERIALIZE_FLAG_NO_GLYPH_NAMES flag is set. Then,
Packit 874993
 *   - If #HB_BUFFER_SERIALIZE_FLAG_NO_CLUSTERS is not set, `=` then #hb_glyph_info_t.cluster.
Packit 874993
 *   - If #HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS is not set, the #hb_glyph_position_t in the format:
Packit 874993
 *     - If both #hb_glyph_position_t.x_offset and #hb_glyph_position_t.y_offset are not 0, `@x_offset,y_offset`. Then,
Packit 874993
 *     - `+x_advance`, then `,y_advance` if #hb_glyph_position_t.y_advance is not 0. Then,
Packit 874993
 *   - If #HB_BUFFER_SERIALIZE_FLAG_GLYPH_EXTENTS is set, the
Packit 874993
 *     #hb_glyph_extents_t in the format
Packit 874993
 *     `<x_bearing,y_bearing,width,height>`
Packit 874993
 *
Packit 874993
 * ## json
Packit 874993
 * TODO.
Packit 874993
 *
Packit 874993
 * Return value: 
Packit 874993
 * The number of serialized items.
Packit 874993
 *
Packit 874993
 * Since: 0.9.7
Packit 874993
 **/
Packit 874993
unsigned int
Packit 874993
hb_buffer_serialize_glyphs (hb_buffer_t *buffer,
Packit 874993
			    unsigned int start,
Packit 874993
			    unsigned int end,
Packit 874993
			    char *buf,
Packit 874993
			    unsigned int buf_size,
Packit 874993
			    unsigned int *buf_consumed,
Packit 874993
			    hb_font_t *font,
Packit 874993
			    hb_buffer_serialize_format_t format,
Packit 874993
			    hb_buffer_serialize_flags_t flags)
Packit 874993
{
Packit 874993
  assert (start <= end && end <= buffer->len);
Packit 874993
Packit 874993
  unsigned int sconsumed;
Packit 874993
  if (!buf_consumed)
Packit 874993
    buf_consumed = &sconsumed;
Packit 874993
  *buf_consumed = 0;
Packit 874993
  if (buf_size)
Packit 874993
    *buf = '\0';
Packit 874993
Packit 874993
  assert ((!buffer->len && buffer->content_type == HB_BUFFER_CONTENT_TYPE_INVALID) ||
Packit 874993
	  buffer->content_type == HB_BUFFER_CONTENT_TYPE_GLYPHS);
Packit 874993
Packit 874993
  if (!buffer->have_positions)
Packit 874993
    flags |= HB_BUFFER_SERIALIZE_FLAG_NO_POSITIONS;
Packit 874993
Packit 874993
  if (unlikely (start == end))
Packit 874993
    return 0;
Packit 874993
Packit 874993
  if (!font)
Packit 874993
    font = hb_font_get_empty ();
Packit 874993
Packit 874993
  switch (format)
Packit 874993
  {
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_TEXT:
Packit 874993
      return _hb_buffer_serialize_glyphs_text (buffer, start, end,
Packit 874993
					       buf, buf_size, buf_consumed,
Packit 874993
					       font, flags);
Packit 874993
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_JSON:
Packit 874993
      return _hb_buffer_serialize_glyphs_json (buffer, start, end,
Packit 874993
					       buf, buf_size, buf_consumed,
Packit 874993
					       font, flags);
Packit 874993
Packit 874993
    default:
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_INVALID:
Packit 874993
      return 0;
Packit 874993
Packit 874993
  }
Packit 874993
}
Packit 874993
Packit 874993
Packit 874993
static hb_bool_t
Packit 874993
parse_uint (const char *pp, const char *end, uint32_t *pv)
Packit 874993
{
Packit 874993
  char buf[32];
Packit 874993
  unsigned int len = MIN (ARRAY_LENGTH (buf) - 1, (unsigned int) (end - pp));
Packit 874993
  strncpy (buf, pp, len);
Packit 874993
  buf[len] = '\0';
Packit 874993
Packit 874993
  char *p = buf;
Packit 874993
  char *pend = p;
Packit 874993
  uint32_t v;
Packit 874993
Packit 874993
  errno = 0;
Packit 874993
  v = strtol (p, &pend, 10);
Packit 874993
  if (errno || p == pend || pend - p != end - pp)
Packit 874993
    return false;
Packit 874993
Packit 874993
  *pv = v;
Packit 874993
  return true;
Packit 874993
}
Packit 874993
Packit 874993
static hb_bool_t
Packit 874993
parse_int (const char *pp, const char *end, int32_t *pv)
Packit 874993
{
Packit 874993
  char buf[32];
Packit 874993
  unsigned int len = MIN (ARRAY_LENGTH (buf) - 1, (unsigned int) (end - pp));
Packit 874993
  strncpy (buf, pp, len);
Packit 874993
  buf[len] = '\0';
Packit 874993
Packit 874993
  char *p = buf;
Packit 874993
  char *pend = p;
Packit 874993
  int32_t v;
Packit 874993
Packit 874993
  errno = 0;
Packit 874993
  v = strtol (p, &pend, 10);
Packit 874993
  if (errno || p == pend || pend - p != end - pp)
Packit 874993
    return false;
Packit 874993
Packit 874993
  *pv = v;
Packit 874993
  return true;
Packit 874993
}
Packit 874993
Packit 874993
#include "hb-buffer-deserialize-json.hh"
Packit 874993
#include "hb-buffer-deserialize-text.hh"
Packit 874993
Packit 874993
/**
Packit 874993
 * hb_buffer_deserialize_glyphs:
Packit 874993
 * @buffer: an #hb_buffer_t buffer.
Packit 874993
 * @buf: (array length=buf_len):
Packit 874993
 * @buf_len: 
Packit 874993
 * @end_ptr: (out):
Packit 874993
 * @font: 
Packit 874993
 * @format: 
Packit 874993
 *
Packit 874993
 * 
Packit 874993
 *
Packit 874993
 * Return value: 
Packit 874993
 *
Packit 874993
 * Since: 0.9.7
Packit 874993
 **/
Packit 874993
hb_bool_t
Packit 874993
hb_buffer_deserialize_glyphs (hb_buffer_t *buffer,
Packit 874993
			      const char *buf,
Packit 874993
			      int buf_len, /* -1 means nul-terminated */
Packit 874993
			      const char **end_ptr, /* May be NULL */
Packit 874993
			      hb_font_t *font, /* May be NULL */
Packit 874993
			      hb_buffer_serialize_format_t format)
Packit 874993
{
Packit 874993
  const char *end;
Packit 874993
  if (!end_ptr)
Packit 874993
    end_ptr = &end;
Packit 874993
  *end_ptr = buf;
Packit 874993
Packit 874993
  assert ((!buffer->len && buffer->content_type == HB_BUFFER_CONTENT_TYPE_INVALID) ||
Packit 874993
	  buffer->content_type == HB_BUFFER_CONTENT_TYPE_GLYPHS);
Packit 874993
Packit 874993
  if (buf_len == -1)
Packit 874993
    buf_len = strlen (buf);
Packit 874993
Packit 874993
  if (!buf_len)
Packit 874993
  {
Packit 874993
    *end_ptr = buf;
Packit 874993
    return false;
Packit 874993
  }
Packit 874993
Packit 874993
  hb_buffer_set_content_type (buffer, HB_BUFFER_CONTENT_TYPE_GLYPHS);
Packit 874993
Packit 874993
  if (!font)
Packit 874993
    font = hb_font_get_empty ();
Packit 874993
Packit 874993
  switch (format)
Packit 874993
  {
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_TEXT:
Packit 874993
      return _hb_buffer_deserialize_glyphs_text (buffer,
Packit 874993
						 buf, buf_len, end_ptr,
Packit 874993
						 font);
Packit 874993
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_JSON:
Packit 874993
      return _hb_buffer_deserialize_glyphs_json (buffer,
Packit 874993
						 buf, buf_len, end_ptr,
Packit 874993
						 font);
Packit 874993
Packit 874993
    default:
Packit 874993
    case HB_BUFFER_SERIALIZE_FORMAT_INVALID:
Packit 874993
      return false;
Packit 874993
Packit 874993
  }
Packit 874993
}