#ifndef _Font_BRepFont_H__
#define _Font_BRepFont_H__
-#include <Adaptor3d_CurveOnSurface.hxx>
-#include <BRep_Builder.hxx>
-#include <Font_FTFont.hxx>
-#include <Font_TextFormatter.hxx>
-#include <Geom2dAdaptor_HCurve.hxx>
-#include <Geom2dConvert_CompCurveToBSplineCurve.hxx>
-#include <gp_Ax3.hxx>
-#include <gp_XY.hxx>
-#include <gp_XYZ.hxx>
-#include <NCollection_DataMap.hxx>
-#include <NCollection_String.hxx>
-#include <Standard_Mutex.hxx>
-#include <TColgp_Array1OfPnt2d.hxx>
-#include <TopoDS_Shape.hxx>
-#include <TopoDS_Face.hxx>
-#include <TopTools_SequenceOfShape.hxx>
+#include <StdPrs_BRepFont.hxx>
-DEFINE_STANDARD_HANDLE(Font_BRepFont, Font_FTFont)
-
-//! This tool provides basic services for rendering of vectorized text glyphs as BRep shapes.
-//! Single instance initialize single font for sequential glyphs rendering with implicit caching of already rendered glyphs.
-//! Thus position of each glyph in the text is specified by shape location.
-//!
-//! Please notice that this implementation uses mutex for thread-safety access,
-//! thus may lead to performance penalties in case of concurrent access.
-//! Although caching should eliminate this issue after rendering of sufficient number of glyphs.
-class Font_BRepFont : protected Font_FTFont
-{
- DEFINE_STANDARD_RTTIEXT(Font_BRepFont, Font_FTFont)
-public:
-
- //! Empty constructor
- Standard_EXPORT Font_BRepFont();
-
- //! Constructor with initialization.
- //! @param theFontPath FULL path to the font
- //! @param theSize the face size in model units
- //! @param theFaceId face id within the file (0 by default)
- Standard_EXPORT Font_BRepFont (const NCollection_String& theFontPath,
- const Standard_Real theSize,
- const Standard_Integer theFaceId = 0);
-
- //! Constructor with initialization.
- //! @param theFontName the font name
- //! @param theFontAspect the font style
- //! @param theSize the face size in model units
- //! @param theStrictLevel search strict level for using aliases and fallback
- Standard_EXPORT Font_BRepFont (const NCollection_String& theFontName,
- const Font_FontAspect theFontAspect,
- const Standard_Real theSize,
- const Font_StrictLevel theStrictLevel = Font_StrictLevel_Any);
-
- //! Release currently loaded font.
- Standard_EXPORT virtual void Release() Standard_OVERRIDE;
-
- //! Initialize the font.
- //! @param theFontPath FULL path to the font
- //! @param theSize the face size in model units
- //! @param theFaceId face id within the file (0 by default)
- //! @return true on success
- Standard_EXPORT bool Init (const NCollection_String& theFontPath,
- const Standard_Real theSize,
- const Standard_Integer theFaceId);
-
- //! Find (using Font_FontMgr) and initialize the font from the given name.
- //! Please take into account that size is specified NOT in typography points (pt.).
- //! If you need to specify size in points, value should be converted.
- //! Formula for pt. -> m conversion:
- //! aSizeMeters = 0.0254 * theSizePt / 72.0
- //! @param theFontName the font name
- //! @param theFontAspect the font style
- //! @param theSize the face size in model units
- //! @param theStrictLevel search strict level for using aliases and fallback
- //! @return true on success
- Standard_EXPORT bool FindAndInit (const TCollection_AsciiString& theFontName,
- const Font_FontAspect theFontAspect,
- const Standard_Real theSize,
- const Font_StrictLevel theStrictLevel = Font_StrictLevel_Any);
-
- //! Render single glyph as TopoDS_Shape.
- //! @param theChar glyph identifier
- //! @return rendered glyph within cache, might be NULL shape
- Standard_EXPORT TopoDS_Shape RenderGlyph (const Standard_Utf32Char& theChar);
-
- //! Setup glyph geometry construction mode.
- //! By default algorithm creates independent TopoDS_Edge
- //! for each original curve in the glyph (line segment or Bezie curve).
- //! Algorithm might optionally create composite BSpline curve for each contour
- //! which reduces memory footprint but limits curve class to C0.
- //! Notice that altering this flag clears currently accumulated cache!
- Standard_EXPORT void SetCompositeCurveMode (const Standard_Boolean theToConcatenate);
-
- //! Setup glyph scaling along X-axis.
- //! By default glyphs are not scaled (scaling factor = 1.0)
- void SetWidthScaling (const float theScaleFactor)
- {
- myWidthScaling = theScaleFactor;
- }
-
-public:
-
- //! @return vertical distance from the horizontal baseline to the highest character coordinate.
- Standard_Real Ascender() const
- {
- return myScaleUnits * Standard_Real(Font_FTFont::Ascender());
- }
-
- //! @return vertical distance from the horizontal baseline to the lowest character coordinate.
- Standard_Real Descender() const
- {
- return myScaleUnits * Standard_Real(Font_FTFont::Descender());
- }
-
- //! @return default line spacing (the baseline-to-baseline distance).
- Standard_Real LineSpacing() const
- {
- return myScaleUnits * Standard_Real(Font_FTFont::LineSpacing());
- }
-
- //! Configured point size
- Standard_Real PointSize() const
- {
- return myScaleUnits * Standard_Real(Font_FTFont::PointSize());
- }
-
- //! Compute advance to the next character with kerning applied when applicable.
- //! Assuming text rendered horizontally.
- Standard_Real AdvanceX (const Standard_Utf32Char theUCharNext)
- {
- return myScaleUnits * Standard_Real(Font_FTFont::AdvanceX (theUCharNext));
- }
-
- //! Compute advance to the next character with kerning applied when applicable.
- //! Assuming text rendered horizontally.
- Standard_Real AdvanceX (const Standard_Utf32Char theUChar,
- const Standard_Utf32Char theUCharNext)
- {
- return myScaleUnits * Standard_Real(Font_FTFont::AdvanceX (theUChar, theUCharNext));
- }
-
- //! Compute advance to the next character with kerning applied when applicable.
- //! Assuming text rendered vertically.
- Standard_Real AdvanceY (const Standard_Utf32Char theUCharNext)
- {
- return myScaleUnits * Standard_Real(Font_FTFont::AdvanceY (theUCharNext));
- }
-
- //! Compute advance to the next character with kerning applied when applicable.
- //! Assuming text rendered vertically.
- Standard_Real AdvanceY (const Standard_Utf32Char theUChar,
- const Standard_Utf32Char theUCharNext)
- {
- return myScaleUnits * Standard_Real(Font_FTFont::AdvanceY (theUChar, theUCharNext));
- }
-
- //! Returns scaling factor for current font size.
- Standard_Real Scale() const
- {
- return myScaleUnits;
- }
-
- //! Returns mutex.
- Standard_Mutex& Mutex()
- {
- return myMutex;
- }
-
-public:
-
- //! Find (using Font_FontMgr) and initialize the font from the given name.
- //! Alias for FindAndInit() for backward compatibility.
- bool Init (const NCollection_String& theFontName,
- const Font_FontAspect theFontAspect,
- const Standard_Real theSize)
- {
- return FindAndInit (theFontName.ToCString(), theFontAspect, theSize, Font_StrictLevel_Any);
- }
-
-protected:
-
- //! Render single glyph as TopoDS_Shape. This method does not lock the mutex.
- //! @param theChar glyph identifier
- //! @param theShape rendered glyph within cache, might be NULL shape
- //! @return true if glyph's geometry is available
- Standard_EXPORT Standard_Boolean renderGlyph (const Standard_Utf32Char theChar,
- TopoDS_Shape& theShape);
-
-private:
-
- //! Initialize class fields
- void init();
-
- //! Auxiliary method to create 3D curve
- bool to3d (const Handle(Geom2d_Curve)& theCurve2d,
- const GeomAbs_Shape theContinuity,
- Handle(Geom_Curve)& theCurve3d);
-
- //! Auxiliary method for creation faces from sequence of wires.
- //! Splits to few faces (if it is needed) and updates orientation of wires.
- Standard_Boolean buildFaces (const NCollection_Sequence<TopoDS_Wire>& theWires,
- TopoDS_Shape& theRes);
-
- //! Hide visibility.
- using Font_FTFont::FindAndCreate;
-
-protected: //! @name Protected fields
-
- NCollection_DataMap<Standard_Utf32Char, TopoDS_Shape>
- myCache; //!< glyphs cache
- Standard_Mutex myMutex; //!< lock for thread-safety
- Handle(Geom_Surface) mySurface; //!< surface to place glyphs on to
- Standard_Real myPrecision; //!< algorithm precision
- Standard_Real myScaleUnits; //!< scale font rendering units into model units
- Standard_Boolean myIsCompositeCurve; //!< flag to merge C1 curves of each contour into single C0 curve, OFF by default
-
-protected: //! @name Shared temporary variables for glyph construction
-
- Adaptor3d_CurveOnSurface myCurvOnSurf;
- Handle(Geom2dAdaptor_HCurve) myCurve2dAdaptor;
- Geom2dConvert_CompCurveToBSplineCurve myConcatMaker;
- TColgp_Array1OfPnt2d my3Poles;
- TColgp_Array1OfPnt2d my4Poles;
- BRep_Builder myBuilder;
-
-};
+//! Alias for porting from old name.
+typedef StdPrs_BRepFont Font_BRepFont;
#endif // _Font_BRepFont_H__
projects / occt.git / blobdiff