pango-coverage.h 2.9 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879
  1. /* Pango
  2. * pango-coverage.h: Coverage sets for fonts
  3. *
  4. * Copyright (C) 2000 Red Hat Software
  5. *
  6. * This library is free software; you can redistribute it and/or
  7. * modify it under the terms of the GNU Library General Public
  8. * License as published by the Free Software Foundation; either
  9. * version 2 of the License, or (at your option) any later version.
  10. *
  11. * This library is distributed in the hope that it will be useful,
  12. * but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
  14. * Library General Public License for more details.
  15. *
  16. * You should have received a copy of the GNU Library General Public
  17. * License along with this library; if not, write to the
  18. * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  19. * Boston, MA 02111-1307, USA.
  20. */
  21. #ifndef __PANGO_COVERAGE_H__
  22. #define __PANGO_COVERAGE_H__
  23. #include <glib.h>
  24. G_BEGIN_DECLS
  25. /**
  26. * PangoCoverage:
  27. *
  28. * The #PangoCoverage structure represents a map from Unicode characters
  29. * to #PangoCoverageLevel. It is an opaque structure with no public fields.
  30. */
  31. typedef struct _PangoCoverage PangoCoverage;
  32. /**
  33. * PangoCoverageLevel:
  34. * @PANGO_COVERAGE_NONE: The character is not representable with the font.
  35. * @PANGO_COVERAGE_FALLBACK: The character is represented in a way that may be
  36. * comprehensible but is not the correct graphical form.
  37. * For instance, a Hangul character represented as a
  38. * a sequence of Jamos, or a Latin transliteration of a Cyrillic word.
  39. * @PANGO_COVERAGE_APPROXIMATE: The character is represented as basically the correct
  40. * graphical form, but with a stylistic variant inappropriate for
  41. * the current script.
  42. * @PANGO_COVERAGE_EXACT: The character is represented as the correct graphical form.
  43. *
  44. * Used to indicate how well a font can represent a particular Unicode
  45. * character point for a particular script.
  46. */
  47. typedef enum {
  48. PANGO_COVERAGE_NONE,
  49. PANGO_COVERAGE_FALLBACK,
  50. PANGO_COVERAGE_APPROXIMATE,
  51. PANGO_COVERAGE_EXACT
  52. } PangoCoverageLevel;
  53. PangoCoverage * pango_coverage_new (void);
  54. PangoCoverage * pango_coverage_ref (PangoCoverage *coverage);
  55. void pango_coverage_unref (PangoCoverage *coverage);
  56. PangoCoverage * pango_coverage_copy (PangoCoverage *coverage);
  57. PangoCoverageLevel pango_coverage_get (PangoCoverage *coverage,
  58. int index_);
  59. void pango_coverage_set (PangoCoverage *coverage,
  60. int index_,
  61. PangoCoverageLevel level);
  62. void pango_coverage_max (PangoCoverage *coverage,
  63. PangoCoverage *other);
  64. void pango_coverage_to_bytes (PangoCoverage *coverage,
  65. guchar **bytes,
  66. int *n_bytes);
  67. PangoCoverage *pango_coverage_from_bytes (guchar *bytes,
  68. int n_bytes);
  69. G_END_DECLS
  70. #endif /* __PANGO_COVERAGE_H__ */