summaryrefslogtreecommitdiff
path: root/pango/pango-direction.h
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2018-12-11 18:52:01 -0500
committerMatthias Clasen <mclasen@redhat.com>2018-12-11 18:52:44 -0500
commit9fc788a6a6bde68cfeef7dbc4d55969638d82a4a (patch)
tree7d39c48cc260c09edb406d50c7280b52cbbdb707 /pango/pango-direction.h
parentc8793f5df3b63f76c37b04384eabd8c10e44cedc (diff)
downloadpango-9fc788a6a6bde68cfeef7dbc4d55969638d82a4a.tar.gz
Fix fallout from bidi deprecation
PangoDirection is still used in some public apis, so just keep it around. Closes: #339
Diffstat (limited to 'pango/pango-direction.h')
-rw-r--r--pango/pango-direction.h73
1 files changed, 73 insertions, 0 deletions
diff --git a/pango/pango-direction.h b/pango/pango-direction.h
new file mode 100644
index 00000000..6cbd5aa7
--- /dev/null
+++ b/pango/pango-direction.h
@@ -0,0 +1,73 @@
+/* Pango
+ * pango-direction.h: Unicode text direction
+ *
+ * Copyright (C) 2018 Matthias Clasen
+ *
+ * This library is free software; you can redistribute it and/or
+ * modify it under the terms of the GNU Library General Public
+ * License as published by the Free Software Foundation; either
+ * version 2 of the License, or (at your option) any later version.
+ *
+ * This library is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
+ * Library General Public License for more details.
+ *
+ * You should have received a copy of the GNU Library General Public
+ * License along with this library; if not, write to the
+ * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ */
+
+#ifndef __PANGO_DIRECTION_H__
+#define __PANGO_DIRECTION_H__
+
+#include <glib.h>
+
+G_BEGIN_DECLS
+
+/**
+ * PangoDirection:
+ * @PANGO_DIRECTION_LTR: A strong left-to-right direction
+ * @PANGO_DIRECTION_RTL: A strong right-to-left direction
+ * @PANGO_DIRECTION_TTB_LTR: Deprecated value; treated the
+ * same as %PANGO_DIRECTION_RTL.
+ * @PANGO_DIRECTION_TTB_RTL: Deprecated value; treated the
+ * same as %PANGO_DIRECTION_LTR
+ * @PANGO_DIRECTION_WEAK_LTR: A weak left-to-right direction
+ * @PANGO_DIRECTION_WEAK_RTL: A weak right-to-left direction
+ * @PANGO_DIRECTION_NEUTRAL: No direction specified
+ *
+ * The #PangoDirection type represents a direction in the
+ * Unicode bidirectional algorithm; not every value in this
+ * enumeration makes sense for every usage of #PangoDirection;
+ * for example, the return value of pango_unichar_direction()
+ * and pango_find_base_dir() cannot be %PANGO_DIRECTION_WEAK_LTR
+ * or %PANGO_DIRECTION_WEAK_RTL, since every character is either
+ * neutral or has a strong direction; on the other hand
+ * %PANGO_DIRECTION_NEUTRAL doesn't make sense to pass
+ * to pango_itemize_with_base_dir().
+ *
+ * The %PANGO_DIRECTION_TTB_LTR, %PANGO_DIRECTION_TTB_RTL
+ * values come from an earlier interpretation of this
+ * enumeration as the writing direction of a block of
+ * text and are no longer used; See #PangoGravity for how
+ * vertical text is handled in Pango.
+ *
+ * If you are interested in text direction, you should
+ * really use fribidi directly. PangoDirection is only
+ * retained because it is used in some public apis.
+ **/
+typedef enum {
+ PANGO_DIRECTION_LTR,
+ PANGO_DIRECTION_RTL,
+ PANGO_DIRECTION_TTB_LTR,
+ PANGO_DIRECTION_TTB_RTL,
+ PANGO_DIRECTION_WEAK_LTR,
+ PANGO_DIRECTION_WEAK_RTL,
+ PANGO_DIRECTION_NEUTRAL
+} PangoDirection;
+
+G_END_DECLS
+
+#endif /* __PANGO_DIRECTION_H__ */