-#ifndef __DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H__
-#define __DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H__
+#ifndef DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H
+#define DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H
/*
- * Copyright (c) 2015 Samsung Electronics Co., Ltd.
+ * Copyright (c) 2016 Samsung Electronics Co., Ltd.
*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
// EXTERNAL INCLUDE
#include <dali/public-api/common/dali-vector.h>
#include <dali/public-api/math/vector2.h>
+#include <dali/public-api/actors/actor-enumerations.h>
// INTERNAL INCLUDE
+#include <dali-toolkit/public-api/text/text-enumerations.h>
#include <dali-toolkit/internal/text/line-run.h>
+#include <dali-toolkit/internal/text/metrics.h>
namespace Dali
{
-struct Vector2;
-
namespace Toolkit
{
namespace Text
{
-struct LayoutParameters;
+namespace Layout
+{
+
+struct Parameters;
/**
* @brief LayoutEngine is responsible for calculating the visual position of glyphs in layout.
*/
-class LayoutEngine
+class Engine
{
public:
- enum Layout
+ enum Type
{
SINGLE_LINE_BOX,
MULTI_LINE_BOX
};
- enum Alignment
- {
- ALIGN_BEGIN,
- ALIGN_CENTER,
- ALIGN_END
- };
-
/**
* @brief Create a new instance of a LayoutEngine.
*/
- LayoutEngine();
+ Engine();
/**
* @brief Virtual destructor.
*/
- ~LayoutEngine();
+ ~Engine();
+
+ /**
+ * @brief Provide the wrapper around FontClient used to get metrics
+ *
+ * @param[in] metrics Used to get metrics
+ */
+ void SetMetrics( MetricsPtr& metrics );
/**
* @brief Choose the required layout.
*
* @param[in] layout The required layout.
*/
- void SetLayout( Layout layout );
+ void SetLayout( Type layout );
/**
* @brief Query the required layout.
*
* @return The required layout.
*/
- unsigned int GetLayout() const;
+ Type GetLayout() const;
/**
- * @brief Choose the required line alignment.
+ * @brief Sets the width of the cursor.
*
- * @param[in] alignment The required alignment.
+ * @param[in] width The width of the cursor in pixels.
*/
- void SetAlignment( Alignment alignment );
+ void SetCursorWidth( int width );
/**
- * @brief Query the required line alignment.
+ * @brief Retrieves the width of the cursor.
*
- * @return The required alignment.
+ * @return The width of the cursor in pixels.
*/
- Alignment GetAlignment() const;
+ int GetCursorWidth() const;
/**
* @brief Store the visual position of glyphs in the VisualModel.
*
- * @param[in] layoutParameters The parameters needed to layout the text.
- * @param[out] glyphPositions The positions of all the glyphs.
- * @param[out] lines The laid-out lines.
- * @param[out] actualSize The size of the text after it has been laid-out.
+ * Builds the bidirectional info and reorders RTL lines.
+ *
+ * @param[in,out] layoutParameters The parameters needed to layout the text.
+ * @param[out] layoutSize The size of the text after it has been laid-out.
+ * @param[in] elideTextEnabled Whether the text elide is enabled.
+ * @param[in,out] isAutoScrollEnabled If the isAutoScrollEnabled is true and the height of the text exceeds the boundaries of the control the text is elided and the isAutoScrollEnabled is set to false to disable the autoscroll
*
* @return \e true if the text has been re-laid-out. \e false means the given width is too small to layout even a single character.
*/
- bool LayoutText( const LayoutParameters& layoutParameters,
- Vector<Vector2>& glyphPositions,
- Vector<LineRun>& lines,
- Size& actualSize );
+ bool LayoutText( Parameters& layoutParameters,
+ Size& layoutSize,
+ bool elideTextEnabled,
+ bool& isAutoScrollEnabled );
+
+ /**
+ * @brief Aligns the laid out lines.
+ *
+ * @param[in] size The size of the container where the text is laid-out.
+ * @param[in] startIndex Character index of the line from where the lines are aligned.
+ * @param[in] numberOfCharacters The number of characters.
+ * @param[in] horizontalAlignment The horizontal alignment.
+ * @param[in,out] lines The laid-out lines.
+ * @param[out] alignmentOffset The alignment offset.
+ * @param[in] layoutDirection The direction of the system language.
+ * @param[in] matchSystemLanguageDirection Whether match align for system language direction or not.
+ */
+ void Align( const Size& size,
+ CharacterIndex startIndex,
+ Length numberOfCharacters,
+ Text::HorizontalAlignment::Type horizontalAlignment,
+ Vector<LineRun>& lines,
+ float& alignmentOffset,
+ Dali::LayoutDirection::Type layoutDirection,
+ bool matchSystemLanguageDirection );
/**
- * @brief Re-lays out those lines with right to left characters.
+ * @brief Sets the default line spacing.
*
- * It doesn't change the phisical position of the glyphs in the model but sets their new position.
+ * @param[in] lineSpacing The line spacing.
+ */
+ void SetDefaultLineSpacing( float lineSpacing );
+
+ /**
+ * @brief Retrieves the default line spacing.
*
- * @param[in] layoutParameters The parameters needed to layout the text.
- * @param[in,out] glyphPositions The positions of all the glyphs.
+ * @return The line spacing.
*/
- void ReLayoutRightToLeftLines( const LayoutParameters& layoutParameters,
- Vector<Vector2>& glyphPositions );
+ float GetDefaultLineSpacing() const;
/**
- * @brief Aligns the laid out lines.
+ * @brief Sets the default line size.
*
- * @param[in] layoutParameters The parameters needed to layout the text.
- * @param[in] layoutSize The size of the laid out the text.
- * @param[in] lines The laid-out lines.
- * @param[in,out] glyphPositions The positions of all the glyphs.
+ * @param[in] lineSize The line size.
*/
- void Align( const LayoutParameters& layoutParameters,
- const Size& layoutSize,
- const Vector<LineRun>& lines,
- Vector<Vector2>& glyphPositions );
+ void SetDefaultLineSize( float lineSize );
+
+ /**
+ * @brief Retrieves the default line size.
+ *
+ * @return The line size.
+ */
+ float GetDefaultLineSize() const;
private:
// Undefined
- LayoutEngine( const LayoutEngine& handle );
+ Engine( const Engine& handle );
// Undefined
- LayoutEngine& operator=( const LayoutEngine& handle );
+ Engine& operator=( const Engine& handle );
private:
struct Impl;
Impl* mImpl;
};
+
+} // namespace Layout
+
} // namespace Text
} // namespace Toolkit
} // namespace Dali
-#endif // __DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H__
+#endif // DALI_TOOLKIT_TEXT_LAYOUT_ENGINE_H
projects / platform / core / uifw / dali-toolkit.git / blobdiff