Add support for shaping a substring to HarfBuzzShaper

third_party/WebKit/Source/platform/fonts/shaping/HarfBuzzShaper.h

 /*
  * Copyright (C) 2012 Google Inc. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are
  * met:
  *
  *     * Redistributions of source code must retain the above copyright
  * notice, this list of conditions and the following disclaimer.
  *     * Redistributions in binary form must reproduce the above
@@ skipping 13 matching lines @@
  * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  */
 
 #ifndef HarfBuzzShaper_h
 #define HarfBuzzShaper_h
 
+#include <hb.h>
+#include <unicode/uscript.h>
+#include <memory>
+#include "platform/fonts/shaping/RunSegmenter.h"
 #include "platform/fonts/shaping/ShapeResult.h"
 #include "platform/text/TextRun.h"
 #include "wtf/Allocator.h"
 #include "wtf/Deque.h"
 #include "wtf/Vector.h"
-#include <hb.h>
-#include <memory>
-#include <unicode/uscript.h>
 
 namespace blink {
 
 class Font;
 class SimpleFontData;
 class HarfBuzzShaper;
+struct HolesQueueItem;
 
 class PLATFORM_EXPORT HarfBuzzShaper final {
  public:
-  HarfBuzzShaper(const UChar*, unsigned length, TextDirection);
-  PassRefPtr<ShapeResult> shapeResult(const Font*) const;
+  HarfBuzzShaper(const UChar*, unsigned length);
+
+  // Shape a range, defined by the start and end parameters, of the string
+  // supplied to the constructor.
+  // The start and end positions should represent boundaries where a break may
+  // occur, such as at the beginning or end of lines or at element boundaries.
+  // If given arbitrary positions the results are not guaranteed to be correct.
+  // May be called multiple times; font and direction may vary between calls.
+  PassRefPtr<ShapeResult> shape(const Font*,
+                                TextDirection,
+                                unsigned start,
+                                unsigned end) const;
+
+  // Shape the entire string with a single font and direction.
+  // Equivalent to calling the range version with a start offset of zero and an
+  // end offset equal to the length.
+  PassRefPtr<ShapeResult> shape(const Font*, TextDirection) const;
+
   ~HarfBuzzShaper() {}
 
-  enum HolesQueueItemAction { HolesQueueNextFont, HolesQueueRange };
+ private:
+  using FeaturesVector = Vector<hb_feature_t, 6>;
 
-  struct HolesQueueItem {
-    DISALLOW_NEW_EXCEPT_PLACEMENT_NEW();
-    HolesQueueItemAction m_action;
-    unsigned m_startIndex;
-    unsigned m_numCharacters;
-    HolesQueueItem(HolesQueueItemAction action, unsigned start, unsigned num)
-        : m_action(action), m_startIndex(start), m_numCharacters(num){};
-  };
+  // Shapes a single seqment, as identified by the RunSegmenterRange parameter,
+  // one or more times taking font fallback into account. The start and end
+  // parameters are for the entire text run, not the segment, and are used to
+  // determine pre- and post-context for shaping.
+  void shapeSegment(ShapeResult*,
+                    Deque<HolesQueueItem>*,
+                    hb_buffer_t*,
+                    const Font*,
+                    TextDirection,
+                    FeaturesVector*,
+                    RunSegmenter::RunSegmenterRange,
+                    unsigned start,
+                    unsigned end) const;
 
- private:
   bool extractShapeResults(hb_buffer_t*,
                            ShapeResult*,
                            bool& fontCycleQueued,
                            Deque<HolesQueueItem>*,
                            const HolesQueueItem&,
                            const Font*,
+                           TextDirection,
                            const SimpleFontData*,
                            UScriptCode,
                            bool isLastResort) const;
-  bool collectFallbackHintChars(const Deque<HolesQueueItem>&,
+  bool collectFallbackHintChars(const Deque<HolesQueueItem>*,
                                 Vector<UChar32>& hint) const;
 
-  const UChar* m_normalizedBuffer;
-  unsigned m_normalizedBufferLength;
-  TextDirection m_textDirection;
+  const UChar* m_text;
+  unsigned m_textLength;
 };
 
 }  // namespace blink
 
 #endif  // HarfBuzzShaper_h