0026769: Chinese letters are not translated
[occt.git] / src / Font / Font_BRepFont.cxx
1 // Created on: 2013-09-16
2 // Copyright (c) 2013-2014 OPEN CASCADE SAS
3 //
4 // This file is part of Open CASCADE Technology software library.
5 //
6 // This library is free software; you can redistribute it and/or modify it under
7 // the terms of the GNU Lesser General Public License version 2.1 as published
8 // by the Free Software Foundation, with special exception defined in the file
9 // OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
10 // distribution for complete text of the license and disclaimer of any warranty.
11 //
12 // Alternatively, this file may be used under the terms of Open CASCADE
13 // commercial license or contractual agreement.
14
15 #include <Font_BRepFont.hxx>
16
17 #include <BRep_Tool.hxx>
18 #include <BRepBuilderAPI_MakeFace.hxx>
19 #include <BRepBuilderAPI_MakeWire.hxx>
20 #include <BRepLib_MakeEdge.hxx>
21 #include <Font_TextFormatter.hxx>
22 #include <GCE2d_MakeSegment.hxx>
23 #include <GC_MakeSegment.hxx>
24 #include <Geom_BezierCurve.hxx>
25 #include <Geom_BSplineCurve.hxx>
26 #include <Geom2d_TrimmedCurve.hxx>
27 #include <Geom_Plane.hxx>
28 #include <Geom2d_BezierCurve.hxx>
29 #include <Geom2d_BSplineCurve.hxx>
30 #include <Geom2d_TrimmedCurve.hxx>
31 #include <Geom2d_Line.hxx>
32 #include <GeomAPI.hxx>
33 #include <GeomAdaptor_HSurface.hxx>
34 #include <GeomLib.hxx>
35 #include <gp_Pln.hxx>
36 #include <ShapeBuild_ReShape.hxx>
37 #include <ShapeFix_Edge.hxx>
38 #include <ShapeFix_Wire.hxx>
39 #include <TColGeom2d_HSequenceOfBoundedCurve.hxx>
40 #include <TCollection_AsciiString.hxx>
41 #include <TCollection_HAsciiString.hxx>
42 #include <TopExp.hxx>
43 #include <TopExp_Explorer.hxx>
44 #include <TopoDS.hxx>
45 #include <TopoDS_Compound.hxx>
46 #include <TopoDS_Vertex.hxx>
47
48 #include FT_OUTLINE_H
49
50
51 IMPLEMENT_STANDARD_RTTIEXT(Font_BRepFont,Font_FTFont)
52
53 namespace
54 {
55   // pre-defined font rendering options
56   static const unsigned int THE_FONT_SIZE      = 72;
57   static const unsigned int THE_RESOLUTION_DPI = 4800;
58
59   // compute scaling factor for specified font size
60   inline Standard_Real getScale (const Standard_Real theSize)
61   {
62     return theSize / Standard_Real(THE_FONT_SIZE) * 72.0 / Standard_Real(THE_RESOLUTION_DPI);
63   }
64
65 };
66
67 // =======================================================================
68 // function : Constructor
69 // purpose  :
70 // =======================================================================
71 Font_BRepFont::Font_BRepFont ()
72 : myPrecision  (Precision::Confusion()),
73   myScaleUnits (1.0),
74   myIsCompositeCurve (Standard_False),
75   my3Poles     (1, 3),
76   my4Poles     (1, 4)
77 {
78   init();
79 }
80
81 // =======================================================================
82 // function : init
83 // purpose  :
84 // =======================================================================
85 void Font_BRepFont::init()
86 {
87   mySurface        = new Geom_Plane (gp_Pln (gp::XOY()));
88   myCurve2dAdaptor = new Geom2dAdaptor_HCurve();
89   Handle(Adaptor3d_HSurface) aSurfAdaptor = new GeomAdaptor_HSurface (mySurface);
90   myCurvOnSurf.Load (aSurfAdaptor);
91
92   myFixer.FixWireMode()          = 1;
93   myFixer.FixOrientationMode()   = 1;
94   myFixer.FixSplitFaceMode()     = 1; // some glyphs might be composed from several faces
95   Handle(ShapeFix_Wire) aWireFixer = myFixer.FixWireTool();
96   aWireFixer->FixConnectedMode() = 1;
97   aWireFixer->ClosedWireMode()   = Standard_True;
98   Handle(ShapeBuild_ReShape) aContext = new ShapeBuild_ReShape();
99   myFixer.SetContext (aContext);
100 }
101
102 // =======================================================================
103 // function : Constructor
104 // purpose  :
105 // =======================================================================
106 Font_BRepFont::Font_BRepFont (const NCollection_String& theFontPath,
107                               const Standard_Real       theSize)
108 : myPrecision  (Precision::Confusion()),
109   myScaleUnits (1.0),
110   myIsCompositeCurve (Standard_False),
111   my3Poles     (1, 3),
112   my4Poles     (1, 4)
113 {
114   init();
115   if (theSize <= myPrecision * 100.0)
116   {
117     return;
118   }
119
120   myScaleUnits = getScale (theSize);
121   Font_FTFont::Init (theFontPath, THE_FONT_SIZE, THE_RESOLUTION_DPI);
122 }
123
124 // =======================================================================
125 // function : Constructor
126 // purpose  :
127 // =======================================================================
128 Font_BRepFont::Font_BRepFont (const NCollection_String& theFontName,
129                               const Font_FontAspect     theFontAspect,
130                               const Standard_Real       theSize)
131 : myPrecision  (Precision::Confusion()),
132   myScaleUnits (1.0),
133   myIsCompositeCurve (Standard_False),
134   my3Poles     (1, 3),
135   my4Poles     (1, 4)
136 {
137   init();
138   if (theSize <= myPrecision * 100.0)
139   {
140     return;
141   }
142
143   myScaleUnits = getScale (theSize);
144   Font_FTFont::Init (theFontName, theFontAspect, THE_FONT_SIZE, THE_RESOLUTION_DPI);
145 }
146
147 // =======================================================================
148 // function : Release
149 // purpose  :
150 // =======================================================================
151 void Font_BRepFont::Release()
152 {
153   myCache.Clear();
154   Font_FTFont::Release();
155 }
156
157 // =======================================================================
158 // function : SetCompositeCurveMode
159 // purpose  :
160 // =======================================================================
161 void Font_BRepFont::SetCompositeCurveMode (const Standard_Boolean theToConcatenate)
162 {
163   if (myIsCompositeCurve != theToConcatenate)
164   {
165     myIsCompositeCurve = theToConcatenate;
166     myCache.Clear();
167   }
168 }
169
170 // =======================================================================
171 // function : Init
172 // purpose  :
173 // =======================================================================
174 bool Font_BRepFont::Init (const NCollection_String& theFontPath,
175                           const Standard_Real       theSize)
176 {
177   if (theSize <= myPrecision * 100.0)
178   {
179     return false;
180   }
181
182   myScaleUnits = getScale (theSize);
183   return Font_FTFont::Init (theFontPath, THE_FONT_SIZE, THE_RESOLUTION_DPI);
184 }
185
186 // =======================================================================
187 // function : Init
188 // purpose  :
189 // =======================================================================
190 bool Font_BRepFont::Init (const NCollection_String& theFontName,
191                           const Font_FontAspect     theFontAspect,
192                           const Standard_Real       theSize)
193 {
194   if (theSize <= myPrecision * 100.0)
195   {
196     return false;
197   }
198
199   myScaleUnits = getScale (theSize);
200   return Font_FTFont::Init (theFontName, theFontAspect, THE_FONT_SIZE, THE_RESOLUTION_DPI);
201 }
202
203 // =======================================================================
204 // function : RenderGlyph
205 // purpose  :
206 // =======================================================================
207 TopoDS_Shape Font_BRepFont::RenderGlyph (const Standard_Utf32Char& theChar)
208 {
209   TopoDS_Shape aShape;
210   Standard_Mutex::Sentry aSentry (myMutex);
211   renderGlyph (theChar, aShape);
212   return aShape;
213 }
214
215 // =======================================================================
216 // function : to3d
217 // purpose  :
218 // =======================================================================
219 bool Font_BRepFont::to3d (const Handle(Geom2d_Curve)& theCurve2d,
220                           const GeomAbs_Shape        theContinuity,
221                           Handle(Geom_Curve)&        theCurve3d)
222 {
223   Standard_Real aMaxDeviation   = 0.0;
224   Standard_Real anAverDeviation = 0.0;
225   myCurve2dAdaptor->ChangeCurve2d().Load (theCurve2d);
226   const Handle(Adaptor2d_HCurve2d)& aCurve = myCurve2dAdaptor; // to avoid ambiguity
227   myCurvOnSurf.Load (aCurve);
228   GeomLib::BuildCurve3d (myPrecision, myCurvOnSurf,
229                          myCurve2dAdaptor->FirstParameter(), myCurve2dAdaptor->LastParameter(),
230                          theCurve3d, aMaxDeviation, anAverDeviation, theContinuity);
231   return !theCurve3d.IsNull();
232 }
233
234 // =======================================================================
235 // function : renderGlyph
236 // purpose  :
237 // =======================================================================
238 Standard_Boolean Font_BRepFont::renderGlyph (const Standard_Utf32Char theChar,
239                                              TopoDS_Shape&            theShape)
240 {
241   theShape.Nullify();
242   if (!loadGlyph (theChar)
243    || myFTFace->glyph->format != FT_GLYPH_FORMAT_OUTLINE)
244   {
245     return Standard_False;
246   }
247   else if (myCache.Find (theChar, theShape))
248   {
249     return !theShape.IsNull();
250   }
251
252   FT_Outline& anOutline = myFTFace->glyph->outline;
253
254   if (!anOutline.n_contours)
255     return Standard_False;
256
257   TopLoc_Location aLoc;
258   TopoDS_Face aFaceDraft;
259   myBuilder.MakeFace (aFaceDraft, mySurface, myPrecision);
260
261   // Get orientation is useless since it doesn't retrieve any in-font information and just computes orientation.
262   // Because it fails in some cases - leave this to ShapeFix.
263   //const FT_Orientation anOrient = FT_Outline_Get_Orientation (&anOutline);
264   for (short aContour = 0, aStartIndex = 0; aContour < anOutline.n_contours; ++aContour)
265   {
266     const FT_Vector* aPntList = &anOutline.points[aStartIndex];
267     const char* aTags      = &anOutline.tags[aStartIndex];
268     const short anEndIndex = anOutline.contours[aContour];
269     const short aPntsNb    = (anEndIndex - aStartIndex) + 1;
270     aStartIndex = anEndIndex + 1;
271     if (aPntsNb < 3)
272     {
273       // closed contour can not be constructed from < 3 points
274       continue;
275     }
276
277     BRepBuilderAPI_MakeWire aWireMaker;
278
279     gp_XY aPntPrev;
280     gp_XY aPntCurr = readFTVec (aPntList[aPntsNb - 1]);
281     gp_XY aPntNext = readFTVec (aPntList[0]);
282
283     Standard_Integer aLinePnts = (FT_CURVE_TAG(aTags[aPntsNb - 1]) == FT_Curve_Tag_On) ? 1 : 0;
284     gp_XY aPntLine1 = aPntCurr;
285
286     // see http://freetype.sourceforge.net/freetype2/docs/glyphs/glyphs-6.html
287     // for a full description of FreeType tags.
288     for (short aPntId = 0; aPntId < aPntsNb; ++aPntId)
289     {
290       aPntPrev = aPntCurr;
291       aPntCurr = aPntNext;
292       aPntNext = readFTVec (aPntList[(aPntId + 1) % aPntsNb]);
293
294       // process tags
295       if (FT_CURVE_TAG(aTags[aPntId]) == FT_Curve_Tag_On)
296       {
297         if (aLinePnts < 1)
298         {
299           aPntLine1 = aPntCurr;
300           aLinePnts = 1;
301           continue;
302         }
303
304         const gp_XY         aDirVec  = aPntCurr - aPntLine1;
305         const Standard_Real aLen     = aDirVec.Modulus();
306         if (aLen <= myPrecision)
307         {
308           aPntLine1 = aPntCurr;
309           aLinePnts = 1;
310           continue;
311         }
312
313         if (myIsCompositeCurve)
314         {
315           Handle(Geom2d_TrimmedCurve) aLine = GCE2d_MakeSegment (gp_Pnt2d (aPntLine1), gp_Pnt2d (aPntCurr));
316           myConcatMaker.Add (aLine, myPrecision);
317         }
318         else
319         {
320           Handle(Geom_Curve)  aCurve3d;
321           Handle(Geom2d_Line) aCurve2d = new Geom2d_Line (gp_Pnt2d (aPntLine1), gp_Dir2d (aDirVec));
322           if (to3d (aCurve2d, GeomAbs_C1, aCurve3d))
323           {
324             TopoDS_Edge anEdge = BRepLib_MakeEdge (aCurve3d, 0.0, aLen);
325             myBuilder.UpdateEdge (anEdge, aCurve2d, mySurface, aLoc, myPrecision);
326             aWireMaker.Add (anEdge);
327           }
328         }
329         aPntLine1 = aPntCurr;
330       }
331       else if (FT_CURVE_TAG(aTags[aPntId]) == FT_Curve_Tag_Conic)
332       {
333         aLinePnts = 0;
334         gp_XY aPntPrev2 = aPntPrev;
335         gp_XY aPntNext2 = aPntNext;
336
337         // previous point is either the real previous point (an "on" point),
338         // or the midpoint between the current one and the previous "conic off" point
339         if (FT_CURVE_TAG(aTags[(aPntId - 1 + aPntsNb) % aPntsNb]) == FT_Curve_Tag_Conic)
340         {
341           aPntPrev2 = (aPntCurr + aPntPrev) * 0.5;
342         }
343
344         // next point is either the real next point or the midpoint
345         if (FT_CURVE_TAG(aTags[(aPntId + 1) % aPntsNb]) == FT_Curve_Tag_Conic)
346         {
347           aPntNext2 = (aPntCurr + aPntNext) * 0.5;
348         }
349
350         my3Poles.SetValue (1, aPntPrev2);
351         my3Poles.SetValue (2, aPntCurr);
352         my3Poles.SetValue (3, aPntNext2);
353         Handle(Geom2d_BezierCurve) aBezierArc = new Geom2d_BezierCurve (my3Poles);
354         if (myIsCompositeCurve)
355         {
356           myConcatMaker.Add (aBezierArc, myPrecision);
357         }
358         else
359         {
360           Handle(Geom_Curve) aCurve3d;
361           if (to3d (aBezierArc, GeomAbs_C1, aCurve3d))
362           {
363             TopoDS_Edge anEdge = BRepLib_MakeEdge (aCurve3d);
364             myBuilder.UpdateEdge (anEdge, aBezierArc, mySurface, aLoc, myPrecision);
365             aWireMaker.Add (anEdge);
366           }
367         }
368       }
369       else if (FT_CURVE_TAG(aTags[aPntId])                 == FT_Curve_Tag_Cubic
370             && FT_CURVE_TAG(aTags[(aPntId + 1) % aPntsNb]) == FT_Curve_Tag_Cubic)
371       {
372         aLinePnts = 0;
373         my4Poles.SetValue (1, aPntPrev);
374         my4Poles.SetValue (2, aPntCurr);
375         my4Poles.SetValue (3, aPntNext);
376         my4Poles.SetValue (4, gp_Pnt2d(readFTVec (aPntList[(aPntId + 2) % aPntsNb])));
377         Handle(Geom2d_BezierCurve) aBezier = new Geom2d_BezierCurve (my4Poles);
378         if (myIsCompositeCurve)
379         {
380           myConcatMaker.Add (aBezier, myPrecision);
381         }
382         else
383         {
384           Handle(Geom_Curve) aCurve3d;
385           if (to3d (aBezier, GeomAbs_C1, aCurve3d))
386           {
387             TopoDS_Edge anEdge = BRepLib_MakeEdge (aCurve3d);
388             myBuilder.UpdateEdge (anEdge, aBezier, mySurface, aLoc, myPrecision);
389             aWireMaker.Add (anEdge);
390           }
391         }
392       }
393     }
394
395     if (myIsCompositeCurve)
396     {
397       Handle(Geom2d_BSplineCurve) aDraft2d = myConcatMaker.BSplineCurve();
398       if (aDraft2d.IsNull())
399       {
400         continue;
401       }
402
403       const gp_Pnt2d aFirstPnt = aDraft2d->StartPoint();
404       const gp_Pnt2d aLastPnt  = aDraft2d->EndPoint();
405       if (!aFirstPnt.IsEqual (aLastPnt, myPrecision))
406       {
407         Handle(Geom2d_TrimmedCurve) aLine = GCE2d_MakeSegment (aLastPnt, aFirstPnt);
408         myConcatMaker.Add (aLine, myPrecision);
409       }
410
411       Handle(Geom2d_BSplineCurve) aCurve2d = myConcatMaker.BSplineCurve();
412       Handle(Geom_Curve)          aCurve3d;
413       if (to3d (aCurve2d, GeomAbs_C0, aCurve3d))
414       {
415         TopoDS_Edge anEdge = BRepLib_MakeEdge (aCurve3d);
416         myBuilder.UpdateEdge (anEdge, aCurve2d, mySurface, aLoc, myPrecision);
417         aWireMaker.Add (anEdge);
418       }
419       myConcatMaker.Clear();
420     }
421     else
422     {
423       if (!aWireMaker.IsDone())
424       {
425         continue;
426       }
427
428       TopoDS_Vertex aFirstV, aLastV;
429       TopExp::Vertices (aWireMaker.Wire(), aFirstV, aLastV);
430       gp_Pnt aFirstPoint = BRep_Tool::Pnt (aFirstV);
431       gp_Pnt aLastPoint  = BRep_Tool::Pnt (aLastV);
432       if (!aFirstPoint.IsEqual (aLastPoint, myPrecision))
433       {
434         aWireMaker.Add (BRepLib_MakeEdge (aFirstV, aLastV));
435       }
436     }
437
438     if (!aWireMaker.IsDone())
439     {
440       continue;
441     }
442
443     TopoDS_Wire aWireDraft = aWireMaker.Wire();
444     //if (anOrient == FT_ORIENTATION_FILL_LEFT)
445     //{
446     // According to the TrueType specification, clockwise contours must be filled
447     aWireDraft.Reverse();
448     //}
449     myBuilder.Add (aFaceDraft, aWireDraft);
450   }
451
452   myFixer.Init (aFaceDraft);
453   myFixer.Perform();
454   theShape = myFixer.Result();
455   if (!theShape.IsNull()
456   &&  theShape.ShapeType() != TopAbs_FACE)
457   {
458     // shape fix can not fix orientation within the single call
459     TopoDS_Compound aComp;
460     myBuilder.MakeCompound (aComp);
461     for (TopExp_Explorer aFaceIter (theShape, TopAbs_FACE); aFaceIter.More(); aFaceIter.Next())
462     {
463       TopoDS_Face aFace = TopoDS::Face (aFaceIter.Current());
464       myFixer.Init (aFace);
465       myFixer.Perform();
466       myBuilder.Add (aComp, myFixer.Result());
467     }
468     theShape = aComp;
469   }
470
471   myCache.Bind (theChar, theShape);
472   return !theShape.IsNull();
473 }