tdf#35301 offapi: add RubyPosition for filters.

RubyPosition describes the position of the ruby text
relative to the base text. ABOVE and BELOW were defined
in ODF, while INTER_CHARACTER is originated from CSS
to indicate the alignment used in traditional Chinese.
For INTER_CHARACTER, the ruby text is aligned vertically
on the right side of the base text, disregard of the
writing mode is horizontal or vertical.

Change-Id: I89224704c192adf9ebb94024d0f2b03f00880cf5
Reviewed-on: https://gerrit.libreoffice.org/48326Reviewed-by: Stephan Bergmann <sbergman@redhat.com>
Tested-by: Jenkins <ci@libreoffice.org>

offapi/UnoApi_offapi.mk

@@ -3718,6 +3718,7 @@ $(eval $(call gb_UnoApi_add_idlfiles,offapi,com/sun/star/text,\
 	ReferenceFieldSource \
 	RelOrientation \
 	RubyAdjust \
+	RubyPosition \
 	SectionFileLink \
 	SetVariableType \
 	SizeType \

offapi/com/sun/star/style/CharacterProperties.idl

@@ -268,6 +268,8 @@ published service CharacterProperties
 
     /** This optional property determines whether the ruby text is printed
         above/left or below/right of the text.
+       <p>This property is replaced by RubyPosition.</p>
+        @deprecated
      */
     [optional, property] boolean RubyIsAbove;
 
@@ -452,6 +454,12 @@ published service CharacterProperties
     */
     [optional, property] sequence<com::sun::star::beans::PropertyValue> CharInteropGrabBag;
 
+    /** This optional property determines the position of the ruby .
+        @see com::sun::star::text::RubyPosition
+        @since LibreOffice 6.1
+     */
+    [optional, property] short RubyPosition;
+
 };
 
 }; }; }; };

offapi/com/sun/star/text/RubyPosition.idl

+/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4; fill-column: 100 -*- */
+/*
+ * This file is part of the LibreOffice project.
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/.
+ */
+#ifndef __com_sun_star_text_RubyPosition_idl__
+#define __com_sun_star_text_RubyPosition_idl__
+
+
+
+ module com {  module sun {  module star {  module text {
+
+
+/** These constants define the position of ruby text.
+    @since LibreOffice 6.1
+ */
+constants RubyPosition
+{
+    /** ruby text should be above or on the right side of base text.
+     */
+    const short ABOVE = 0;
+    /** ruby text should be below or on the left side of base text.
+     */
+    const short BELOW = 1;
+    /** Vertically aligned on right side of the base text in horizontal mode.
+        <P>This is the same as ABOVE in vertical writing mode.</P>
+     */
+    const short INTER_CHARACTER = 2;
+};
+
+
+}; }; }; };
+
+#endif
+
+/* vim:set shiftwidth=4 softtabstop=4 expandtab cinoptions=b1,g0,N-s cinkeys+=0=break: */