Merge "Add ECORE_IMF_CALLBACK_SELECTION_SET to IMFContext" into devel/master
[platform/core/uifw/dali-toolkit.git] / dali-toolkit / internal / text / visual-model-impl.h
1 #ifndef DALI_TOOLKIT_TEXT_VISUAL_MODEL_IMPL_H
2 #define DALI_TOOLKIT_TEXT_VISUAL_MODEL_IMPL_H
3
4 /*
5  * Copyright (c) 2022 Samsung Electronics Co., Ltd.
6  *
7  * Licensed under the Apache License, Version 2.0 (the "License");
8  * you may not use this file except in compliance with the License.
9  * You may obtain a copy of the License at
10  *
11  * http://www.apache.org/licenses/LICENSE-2.0
12  *
13  * Unless required by applicable law or agreed to in writing, software
14  * distributed under the License is distributed on an "AS IS" BASIS,
15  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16  * See the License for the specific language governing permissions and
17  * limitations under the License.
18  *
19  */
20
21 // EXTERNAL INCLUDES
22 #include <dali/public-api/common/dali-vector.h>
23 #include <dali/public-api/common/intrusive-ptr.h>
24 #include <dali/public-api/math/vector2.h>
25 #include <dali/public-api/math/vector4.h>
26 #include <dali/public-api/object/ref-object.h>
27
28 // INTERNAL INCLUDES
29 #include <dali-toolkit/internal/text/character-spacing-glyph-run.h>
30 #include <dali-toolkit/internal/text/color-run.h>
31 #include <dali-toolkit/internal/text/line-run.h>
32 #include <dali-toolkit/internal/text/strikethrough-glyph-run.h>
33 #include <dali-toolkit/internal/text/underlined-glyph-run.h>
34 #include <dali-toolkit/public-api/text/text-enumerations.h>
35
36 // DEVEL INCLUDES
37 #include <dali-toolkit/devel-api/text/text-enumerations-devel.h>
38
39 namespace Dali
40 {
41 namespace Toolkit
42 {
43 namespace Text
44 {
45 struct HyphenInfo
46 {
47   Vector<GlyphInfo> glyph;
48   Vector<Vector2>   position;
49   Vector<Length>    index;
50 };
51
52 class VisualModel;
53 typedef IntrusivePtr<VisualModel> VisualModelPtr;
54
55 /**
56  * @brief A visual text model contains layout specific information.
57  *
58  * This includes:
59  * - A series of glyphs in visual order i.e. after the bidirectional reordering.
60  * - The position of each glyph within a 2D bounding box.
61  */
62 class VisualModel : public RefObject
63 {
64 public:
65   /**
66    * @brief Create a new instance of a VisualModel.
67    *
68    * @return A pointer to a new VisualModel.
69    */
70   static VisualModelPtr New();
71
72   // Glyph interface.
73
74   /**
75    * @brief Creates the character to glyph conversion table.
76    *
77    * @pre The glyphs per character table needs to be created first.
78    *
79    * @param[in] startIndex The character from where the conversion table is created.
80    * @param[in] startGlyphIndex The glyph from where the conversion table is created.
81    * @param[in] numberOfCharacters The number of characters.
82    */
83   void CreateCharacterToGlyphTable(CharacterIndex startIndex,
84                                    GlyphIndex     startGlyphIndex,
85                                    Length         numberOfCharacters);
86
87   /**
88    * @brief Creates an array containing the number of glyphs per character.
89    *
90    * @param[in] startIndex The character from where the table is created.
91    * @param[in] startGlyphIndex The glyph from where the conversion table is created.
92    * @param[in] numberOfCharacters The number of characters.
93    */
94   void CreateGlyphsPerCharacterTable(CharacterIndex startIndex,
95                                      GlyphIndex     startGlyphIndex,
96                                      Length         numberOfCharacters);
97
98   /**
99    * @brief Retrieves glyphs in the given buffer.
100    *
101    * The size of the @p glyphs buffer needs to be big enough to copy the @p numberOfGlyphs.
102    * @param[out] glyphs Pointer to a buffer where the glyphs are copied.
103    * @param[in] glyphIndex Index to the first glyph.
104    * @param[in] numberOfGlyphs Number of glyphs to be copied.
105    */
106   void GetGlyphs(GlyphInfo* glyphs,
107                  GlyphIndex glyphIndex,
108                  Length     numberOfGlyphs) const;
109
110   // Position interface
111
112   /**
113    * @brief Retrieves the glyph positions.
114    *
115    * @pre The size of the @p positions buffer needs to be big enough to copy the @p numberOfGlyphs positions.
116    * @param[out] glyphPositions Pointer to a buffer where the glyph positions are copied.
117    * @param[in] glyphIndex Index to the first glyph position.
118    * @param[in] numberOfGlyphs The number of positions to be copied.
119    */
120   void GetGlyphPositions(Vector2*   glyphPositions,
121                          GlyphIndex glyphIndex,
122                          Length     numberOfGlyphs) const;
123
124   // Line interface.
125
126   /**
127    * @brief Retrieves the total number of lines.
128    *
129    * @return The number of lines.
130    */
131   Length GetTotalNumberOfLines() const;
132
133   /**
134    * @brief Retrieves the number of lines and the index to the first line where the given range of glyphs is laid out.
135    *
136    * @param[in] glyphIndex Index to the first glyph.
137    * @param[in] numberOfGlyphs The number of glyph.
138    * @param[out] firstLine Index to the line containing the glyph index.
139    * @param[out] numberOfLines The number of lines.
140    */
141   void GetNumberOfLines(GlyphIndex glyphIndex,
142                         Length     numberOfGlyphs,
143                         LineIndex& firstLine,
144                         Length&    numberOfLines) const;
145
146   /**
147    * @brief Retrieves the line index where the glyph is laid-out.
148    *
149    * @param[in] glyphIndex The glyph's index.
150    *
151    * @return The line index.
152    */
153   LineIndex GetLineOfGlyph(GlyphIndex glyphIndex);
154
155   /**
156    * @brief Retrieves the lines where the given range of glyphs is laid out.
157    *
158    * The size of the @p lines buffer needs to be big enough to copy the @p numberOfLines.
159    *
160    * @param[out] lines Pointer to a buffer where the lines are copied.
161    * @param[in] glyphIndex Index to the first glyphs of the range.
162    * @param[in] numberOfGlyphs Number of glyphs in the range.
163    */
164   void GetLinesOfGlyphRange(LineRun*   lines,
165                             GlyphIndex glyphIndex,
166                             Length     numberOfGlyphs) const;
167
168   /**
169    * @brief Retrieves the line index where the character is laid-out.
170    *
171    * @param[in] characterIndex The character's index.
172    *
173    * @return The line index.
174    */
175   LineIndex GetLineOfCharacter(CharacterIndex characterIndex);
176
177   // Underline runs
178
179   /**
180    * @brief Retrieves the underline runs.
181    *
182    * @param[out] underlineRuns Pointer to a buffer where the underline runs are copied.
183    * @param[in] index Index of the first underline run to be copied.
184    * @param[in] numberOfRuns Number of underline runs to be copied.
185    */
186   void GetUnderlineRuns(UnderlinedGlyphRun* underlineRuns,
187                         UnderlineRunIndex   index,
188                         Length              numberOfRuns) const;
189
190   // Size interface
191
192   /**
193    * @brief Sets the natural size.
194    *
195    * @param[in] size The text's natural size.
196    */
197   void SetNaturalSize(const Vector2& size);
198
199   /**
200    * @brief Retrieves the natural size.
201    *
202    * @return The text's natural size.
203    */
204   const Vector2& GetNaturalSize() const;
205
206   /**
207    * @brief Sets the text's layout size.
208    *
209    * @param[in] size The text's size.
210    */
211   void SetLayoutSize(const Vector2& size);
212
213   /**
214    * @brief Retrieves the text's layout size.
215    *
216    * @return The text's size.
217    */
218   const Vector2& GetLayoutSize() const;
219
220   /**
221    * @brief Set the text's color
222    *
223    * @param[in] textColor The text's color
224    */
225   void SetTextColor(const Vector4& textColor);
226
227   /**
228    * @brief Retrieve the text's color
229    *
230    * @return The text's color
231    */
232   const Vector4& GetTextColor() const;
233
234   /**
235    * @brief Sets the text's shadow offset.
236    *
237    * @param[in] shadowOffset The shadow offset, 0,0 indicates no shadow.
238    */
239   void SetShadowOffset(const Vector2& shadowOffset);
240
241   /**
242    * @brief Retrieves the text's shadow offset.
243    *
244    * @return The text's shadow offset, 0,0 indicates no shadow.
245    */
246   const Vector2& GetShadowOffset() const;
247
248   /**
249    * @brief Sets the text's shadow color.
250    *
251    * @param[in] shadowColor The shadow color.
252    */
253   void SetShadowColor(const Vector4& shadowColor);
254
255   /**
256    * @brief Retrieves the text's shadow color.
257    *
258    * @return The text's shadow color.
259    */
260   const Vector4& GetShadowColor() const;
261
262   /**
263    * @brief Set the shadow blur radius.
264    *
265    * @param[in] shadowBlurRadius The shadow blur radius, 0,0 indicates no blur.
266    */
267   void SetShadowBlurRadius(const float& shadowBlurRadius);
268
269   /**
270    * @brief Retrieve the shadow blur radius.
271    *
272    * @return The shadow blur radius.
273    */
274   const float& GetShadowBlurRadius() const;
275
276   /**
277    * @brief Sets the text's underline color.
278    *
279    * @param[in] color The text's underline color.
280    */
281   void SetUnderlineColor(const Vector4& color);
282
283   /**
284    * @brief Retrieves the text's underline color.
285    *
286    * @return The text's underline color.
287    */
288   const Vector4& GetUnderlineColor() const;
289
290   /**
291    * @brief Sets the text underline flag.
292    *
293    * @param[in] enabled true if underlined.
294    */
295   void SetUnderlineEnabled(bool enabled);
296
297   /**
298    * @brief Returns whether the text is underlined or not.
299    *
300    * @return underline state.
301    */
302   bool IsUnderlineEnabled() const;
303
304   /**
305    * @brief Clear the caches.
306    */
307   void ClearCaches();
308
309   /**
310    * @brief Set the override used for underline height, 0 indicates height will be come from font metrics
311    *
312    * @param[in] height The height in pixels of the underline
313    */
314   void SetUnderlineHeight(float height);
315
316   /**
317    * @brief Set the override used for underline type.
318    *
319    * @param[in] underlineType The type of the underline.
320    */
321   void SetUnderlineType(Text::Underline::Type type);
322
323   /**
324    * @brief Set the override used for the width of the dashes of the dashed underline.
325    *
326    * @param[in] width width of the dashes.
327    */
328   void SetDashedUnderlineWidth(float width);
329
330   /**
331    * @brief Set the override used for the gap between the dashes of the dashed underline.
332    *
333    * @param[in] gap gap between the dashes.
334    */
335   void SetDashedUnderlineGap(float gap);
336
337   /**
338    * @brief Retrieves the underline height override
339    *
340    * @return Returns the override height for an underline, 0 indicates that font metrics will determine the height
341    */
342   float GetUnderlineHeight() const;
343
344   /**
345    * @brief Retrieves the underline type override.
346    *
347    * @return Returns the override type for the underline.
348    */
349   Text::Underline::Type GetUnderlineType() const;
350
351   /**
352    * @brief Retrieves the dashed underline width.
353    *
354    * @return Returns the override width for the dashed underline.
355    */
356   float GetDashedUnderlineWidth() const;
357
358   /**
359    * @brief Retrieves the dashed underline gap.
360    *
361    * @return Returns the override gap for the dashed underline.
362    */
363   float GetDashedUnderlineGap() const;
364
365   /**
366    * @brief Retrieves the number of underline runs.
367    *
368    * @return The number of underline runs.
369    */
370   Length GetNumberOfUnderlineRuns() const;
371
372   /**
373    * @brief Set the outline color.
374    *
375    * @param[in] color color of outline.
376    */
377   void SetOutlineColor(const Vector4& color);
378
379   /**
380    * @brief Retrieve the outline color.
381    *
382    * @return The outline color.
383    */
384   const Vector4& GetOutlineColor() const;
385
386   /**
387    * @brief Set the outline width
388    *
389    * @param[in] width The width in pixels of the outline, 0 indicates no outline
390    */
391   void SetOutlineWidth(uint16_t width);
392
393   /**
394    * @brief Retrieves the width of an outline
395    *
396    * @return The width of the outline.
397    */
398   uint16_t GetOutlineWidth() const;
399
400   /**
401    * @brief Sets the text's background color.
402    *
403    * @param[in] color The text's background color.
404    */
405   void SetBackgroundColor(const Vector4& color);
406
407   /**
408    * @brief Retrieves the text's background color.
409    *
410    * @return The text's background color.
411    */
412   const Vector4& GetBackgroundColor() const;
413
414   /**
415    * @brief Sets whether the text has a background or not.
416    *
417    * @param[in] enabled true if the text has a background.
418    */
419   void SetBackgroundEnabled(bool enabled);
420
421   /**
422    * @brief Returns whether the text has a background or not.
423    *
424    * @return whether the text has a background or not.
425    */
426   bool IsBackgroundEnabled() const;
427
428   /**
429    * @brief Sets whether the text has a markup-processor or not.
430    *
431    * @param[in] enabled true if the text has a markup-processor.
432    */
433   void SetMarkupProcessorEnabled(bool enabled);
434
435   /**
436    * @brief Returns whether the text has a markup-processor or not.
437    *
438    * @return whether the text has a markup-processor or not.
439    */
440   bool IsMarkupProcessorEnabled() const;
441
442   /**
443    * @brief Sets ellipsis position
444    * @param[in] ellipsisPosition The ellipsis position for the text
445    */
446   void SetEllipsisPosition(Toolkit::DevelText::EllipsisPosition::Type ellipsisPosition);
447
448   /**
449    * @brief Retrieves ellipsis position for text.
450    *
451    * @return The ellipsis position.
452    */
453   Toolkit::DevelText::EllipsisPosition::Type GetEllipsisPosition() const;
454
455   /**
456    * @brief Enable or disable the text elide.
457    *
458    * @param[in] enabled Whether to enable the text elide.
459    */
460   void SetTextElideEnabled(bool enabled);
461
462   /**
463    * @brief Whether the text elide property is enabled.
464    *
465    * @return @e true if the text elide property is enabled, @e false otherwise.
466    */
467   bool IsTextElideEnabled() const;
468
469   /**
470    * @brief Sets the start index of laid-out glyphs.
471    *
472    * @param[in] startIndexOfElidedGlyphs The start index of laid-out glyphs.
473    */
474   void SetStartIndexOfElidedGlyphs(GlyphIndex startIndexOfElidedGlyphs);
475
476   /**
477    * @brief Sets the end index of elided glyphs.
478    *
479    * @param[in] endIndexOfElidedGlyphs The end index of elided glyphs.
480    */
481   void SetEndIndexOfElidedGlyphs(GlyphIndex endIndexOfElidedGlyphs);
482
483   /**
484    * @brief Sets the first middle index of elided glyphs, index before ellipsis of middle.
485    *
486    * @param[in] firstMiddleIndexOfElidedGlyphs The first middle index of elided glyphs, index before ellipsis of middle.
487    */
488   void SetFirstMiddleIndexOfElidedGlyphs(GlyphIndex firstMiddleIndexOfElidedGlyphs);
489
490   /**
491    * @brief Sets the second middle index of elided glyphs, index of ellipsis of middle.
492    *
493    * @param[in] secondMiddleIndexOfElidedGlyphs The second middle index of elided glyphs, index of ellipsis of middle.
494    */
495   void SetSecondMiddleIndexOfElidedGlyphs(GlyphIndex secondMiddleIndexOfElidedGlyphs);
496
497   /**
498    * @brief Retrieves the start index of laid-out glyphs.
499    *
500    * @return The start index of laid-out glyphs.
501    */
502   GlyphIndex GetStartIndexOfElidedGlyphs() const;
503
504   /**
505    * @brief Retrieves the end index of laid-out glyphs.
506    *
507    * @return The end index of laid-out glyphs.
508    */
509   GlyphIndex GetEndIndexOfElidedGlyphs() const;
510
511   /**
512    * @brief Retrieves the first middle index of elided glyphs, index before ellipsis of middle.
513    *
514    * @return The first middle index of elided glyphs, index before ellipsis of middle.
515    */
516   GlyphIndex GetFirstMiddleIndexOfElidedGlyphs() const;
517
518   /**
519    * @brief Retrieves the second middle index of elided glyphs, index of ellipsis of middle.
520    *
521    * @return The second middle index of elided glyphs, index of ellipsis of middle.
522    */
523   GlyphIndex GetSecondMiddleIndexOfElidedGlyphs() const;
524
525   /**
526    * @brief Sets the text's strikethrough color.
527    *
528    * @param[in] color The text's strikethrough color.
529    */
530   void SetStrikethroughColor(const Vector4& color);
531
532   /**
533    * @brief Retrieves the text's strikethrough color.
534    *
535    * @return The text's strikethrough color.
536    */
537   const Vector4& GetStrikethroughColor() const;
538
539   /**
540    * @brief Sets the text strikethrough flag.
541    *
542    * @param[in] enabled true if strikethrough.
543    */
544   void SetStrikethroughEnabled(bool enabled);
545
546   /**
547    * @brief Returns whether the text is strikethrough or not.
548    *
549    * @return strikethrough state.
550    */
551   bool IsStrikethroughEnabled() const;
552
553   /**
554    * @brief Set the override used for strikethrough height, 0 indicates height will be come from font metrics
555    *
556    * @param[in] height The height in pixels of the strikethrough
557    */
558   void SetStrikethroughHeight(float height);
559
560   /**
561    * @brief Retrieves the strikethrough height override
562    *
563    * @return Returns the override height for a strikethrough, 0 indicates that font metrics will determine the height
564    */
565   float GetStrikethroughHeight() const;
566   /**
567    * @brief Set the override used for character spacing.
568    *
569    * @note A positive value will make the characters far apart (expanded) and a negative value will bring them closer (condensed).
570    *
571    * @param[in] characterSpacing The character spacing.
572    */
573   void SetCharacterSpacing(float characterSpacing);
574
575   /**
576    * @brief Retrieves the characterSpacing.
577    *
578    * @note A positive value will make the characters far apart (expanded) and a negative value will bring them closer (condensed).
579    *
580    * @return Returns the characterSpacing.
581    */
582   const float GetCharacterSpacing() const;
583
584   /**
585    * @brief Retrieves the Glyphs to Characters Array.
586    *
587    * @return The GlyphsToCharacters.
588    */
589   const Vector<CharacterIndex>& GetGlyphsToCharacters() const;
590
591   /**
592    * @brief Retrieves the strikethrough runs.
593    *
594    * @param[out] strikethroughRuns Pointer to a buffer where the strikethrough runs are copied.
595    * @param[in] index Index of the first strikethrough run to be copied.
596    * @param[in] numberOfRuns Number of strikethrough runs to be copied.
597    */
598   void GetStrikethroughRuns(StrikethroughGlyphRun* strikethroughRuns,
599                             StrikethroughRunIndex  index,
600                             Length                 numberOfRuns) const;
601
602   /**
603    * @brief Retrieves the number of strikethrough runs.
604    *
605    * @return The number of strikethrough runs.
606    */
607   Length GetNumberOfStrikethroughRuns() const;
608
609   /**
610    * @brief Retrieves the number of character-spacing glyph runs.
611    *
612    * @return The number of character-spacing glyph runs.
613    */
614   Length GetNumberOfCharacterSpacingGlyphRuns() const;
615
616   /**
617    * @brief Retrieves the reference for character-spacing glyph runs.
618    *
619    * @return The reference for character-spacing glyph runs.
620    */
621   const Vector<CharacterSpacingGlyphRun>& GetCharacterSpacingGlyphRuns() const;
622
623 protected:
624   /**
625    * @brief A reference counted object may only be deleted by calling Unreference().
626    */
627   virtual ~VisualModel();
628
629 private:
630   /**
631    * @brief Private constructor.
632    */
633   VisualModel();
634
635   // Undefined
636   VisualModel(const VisualModel& handle);
637
638   // Undefined
639   VisualModel& operator=(const VisualModel& handle);
640
641 public:
642   Vector<GlyphInfo>                mGlyphs;                 ///< For each glyph, the font's id, glyph's index within the font and glyph's metrics.
643   Vector<CharacterIndex>           mGlyphsToCharacters;     ///< For each glyph, the index of the first character.
644   Vector<GlyphIndex>               mCharactersToGlyph;      ///< For each character, the index of the first glyph.
645   Vector<Length>                   mCharactersPerGlyph;     ///< For each glyph, the number of characters that form the glyph.
646   Vector<Length>                   mGlyphsPerCharacter;     ///< For each character, the number of glyphs that are shaped.
647   Vector<Vector2>                  mGlyphPositions;         ///< For each glyph, the position.
648   Vector<LineRun>                  mLines;                  ///< The laid out lines.
649   Vector<UnderlinedGlyphRun>       mUnderlineRuns;          ///< Runs of glyphs that are underlined.
650   Vector<Vector4>                  mColors;                 ///< Colors of the glyphs.
651   Vector<ColorIndex>               mColorIndices;           ///< Indices to the vector of colors for each glyphs.
652   Vector<Vector4>                  mBackgroundColors;       ///< Background colors of the glyphs.
653   Vector<ColorIndex>               mBackgroundColorIndices; ///< Indices to the vector of background colors for each glyphs.
654   Vector4                          mTextColor;              ///< The text color
655   Vector4                          mShadowColor;            ///< Color of drop shadow
656   Vector4                          mUnderlineColor;         ///< Color of underline
657   Vector4                          mOutlineColor;           ///< Color of outline
658   Vector4                          mBackgroundColor;        ///< Color of text background
659   Vector4                          mStrikethroughColor;     ///< Color of text background
660   Size                             mControlSize;            ///< The size of the UI control.
661   Vector2                          mShadowOffset;           ///< Offset for drop shadow, 0 indicates no shadow
662   float                            mUnderlineHeight;        ///< Fixed height for underline to override font metrics.
663   float                            mStrikethroughHeight;    ///< Fixed height for strikethrough to override font metrics.
664   Text::Underline::Type            mUnderlineType;          ///< The type of the underline.
665   float                            mDashedUnderlineWidth;   ///< The width of the dashes of the dashed underline.
666   float                            mDashedUnderlineGap;     ///< The gap between the dashes of the dashed underline.
667   float                            mShadowBlurRadius;       ///< Blur radius of shadow, 0 indicates no blur.
668   uint16_t                         mOutlineWidth;           ///< Width of outline.
669   Vector<StrikethroughGlyphRun>    mStrikethroughRuns;      ///< Runs of glyphs that have strikethrough.
670   Vector<CharacterSpacingGlyphRun> mCharacterSpacingRuns;   ///< Runs of glyphs that have character-spacing.
671
672 private:
673   Size mNaturalSize; ///< Size of the text with no line wrapping.
674   Size mLayoutSize;  ///< Size of the laid-out text considering the layout properties set.
675
676   // Caches to increase performance in some consecutive operations.
677   LineIndex mCachedLineIndex; ///< Used to increase performance in consecutive calls to GetLineOfGlyph() or GetLineOfCharacter() with consecutive glyphs or characters.
678
679   DevelText::EllipsisPosition::Type mEllipsisPosition;                ///< Where is the location the text elide
680   GlyphIndex                        mStartIndexOfElidedGlyphs;        ///< The start index of elided glyphs.
681   GlyphIndex                        mEndIndexOfElidedGlyphs;          ///< The end index of elided glyphs.
682   GlyphIndex                        mFirstMiddleIndexOfElidedGlyphs;  ///< The first end index of elided glyphs, index before ellipsis of middle.
683   GlyphIndex                        mSecondMiddleIndexOfElidedGlyphs; ///< The first end index of elided glyphs, index of ellipsis of middle.
684   bool                              mTextElideEnabled : 1;            ///< Whether the text's elide is enabled.
685
686 public:
687   bool       mUnderlineEnabled : 1;       ///< Underline enabled flag
688   bool       mUnderlineColorSet : 1;      ///< Has the underline color been explicitly set?
689   bool       mBackgroundEnabled : 1;      ///< Background enabled flag
690   bool       mMarkupProcessorEnabled : 1; ///< Markup-processor enabled flag
691   HyphenInfo mHyphen;                     ///< Contains hyphen glyph info & the character index to draw hyphen after.
692   bool       mStrikethroughEnabled : 1;   ///< Strikethrough enabled flag
693   float      mCharacterSpacing;           ///< Contains the value of the character spacing.
694 };
695
696 } // namespace Text
697
698 } // namespace Toolkit
699
700 } // namespace Dali
701
702 #endif // DALI_TOOLKIT_TEXT_VISUAL_MODEL_IMPL_H