diff options
author | Matthias Clasen <mclasen@redhat.com> | 2018-12-11 18:52:01 -0500 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2018-12-11 18:52:44 -0500 |
commit | 9fc788a6a6bde68cfeef7dbc4d55969638d82a4a (patch) | |
tree | 7d39c48cc260c09edb406d50c7280b52cbbdb707 /pango/pango-direction.h | |
parent | c8793f5df3b63f76c37b04384eabd8c10e44cedc (diff) | |
download | pango-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.h | 73 |
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__ */ |