Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #893 from Kumataro:freetype2
* Support freetype2 * Before call pkg_search_module() check it is available. * If using libraries are unavailable, this module is shown in unavailable list. * using ocv_define_modules() insted of target_link_libraries(). * Fix inner indentation in C++ namespaces * Remove mImg from freetype2 and Create UserData class to refer in path drawing callbacks. * to split interface and implementation details. ( and to avoid 3rd headers in public headers) * PKG_CONFIG_FOUND is used instead of COMMAND okg_search_modules * Update Document using Doxygen * Add ocv_module_include_directories() * Do no put pixels over image boundaries. * Fix SIGSEGV (only valgrind) and missing text in top border line * Fix trailing whitespace. * Use Header File Macros * Fix CMP0023 warning in cmake * std::string to cv::String * Fix trailing whitespace * Change splitnumber from unsigned int to int to support python * ocv_include_directories() should be define before ocv_define_module() * Fix boundary problem in putTextBitmapBlend() * Fix to draw an outline glyph which are on the boundary of image. * Remove precomp.cpp * Fix CMakeLists.txt to right order. * Remove prototype definition of removed function. * Add CV_Assert() where FreeType and Harfbuzz are called * Add CV_Assert() to check InputOutputArray and line_type
- Loading branch information
Showing
6 changed files
with
772 additions
and
18 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,26 @@ | ||
set(the_description "FreeType module. It enables to draw strings with outlines and mono-bitmaps/gray-bitmaps.") | ||
|
||
if(PKG_CONFIG_FOUND) | ||
pkg_search_module(FREETYPE freetype2) | ||
pkg_search_module(HARFBUZZ harfbuzz) | ||
endif() | ||
|
||
if(NOT FREETYPE_FOUND) | ||
message(STATUS "freetype2: NO") | ||
else() | ||
message(STATUS "freetype2: YES") | ||
endif() | ||
|
||
if(NOT HARFBUZZ_FOUND) | ||
message(STATUS "harfbuzz: NO") | ||
else() | ||
message(STATUS "harfbuzz: YES") | ||
endif() | ||
|
||
|
||
if( FREETYPE_FOUND AND HARFBUZZ_FOUND ) | ||
ocv_define_module(freetype opencv_core opencv_imgproc PRIVATE_REQUIRED ${freetype2_LIBRARIES} ${harfbuzz_LIBRARIES} WRAP python) | ||
ocv_include_directories( ${FREETYPE_INCLUDE_DIRS} ${HARFBUZZ_INCLUDE_DIRS} ) | ||
else() | ||
ocv_module_disable(freetype) | ||
endif() |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,34 @@ | ||
FreeType Module | ||
=========== | ||
|
||
This FreeType module allows you to draw strings with outlines and bitmaps. | ||
|
||
Installation | ||
----------- | ||
harfbuzz is requested to convert UTF8 to gid(GlyphID). | ||
freetype library is requested to rasterize given gid. | ||
|
||
harfbuzz https://www.freedesktop.org/wiki/Software/HarfBuzz/ | ||
freetype https://www.freetype.org/ | ||
|
||
Usage | ||
----------- | ||
cv::freetype::FreeType2 ft2; | ||
ft2.loadFontData("your-font.ttf", 0); | ||
ft2.setSplitNumber( 4 ); // Bezier-line is splited by 4 segment. | ||
ft2.putText(src, .... ) | ||
|
||
Option | ||
------------ | ||
- 2nd argument of loadFontData is used if font file has many font data. | ||
- 3 drawing mode is available. | ||
-- outline mode is used if lineWidth is larger than 0. (like original putText) | ||
-- bitmap mode is used if lineWidth is less than 0. | ||
--- 1bit bitmap mode is used if lineStyle is 4 or 8. | ||
--- gray bitmap mode is used if lineStyle is 16. | ||
|
||
Future work | ||
------------ | ||
- test | ||
-- CJK and ... | ||
- RTL,LTR,TTB,BTT... |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,130 @@ | ||
/*M/////////////////////////////////////////////////////////////////////////////////////// | ||
// | ||
// IMPORTANT: READ BEFORE DOWNLOADING, COPYING, INSTALLING OR USING. | ||
// | ||
// By downloading, copying, installing or using the software you agree to this license. | ||
// If you do not agree to this license, do not download, install, | ||
// copy or use the software. | ||
// | ||
// | ||
// License Agreement | ||
// For Open Source Computer Vision Library | ||
// | ||
// Copyright (C) 2000-2008, Intel Corporation, all rights reserved. | ||
// Copyright (C) 2009-2012, Willow Garage Inc., all rights reserved. | ||
// Third party copyrights are property of their respective owners. | ||
// | ||
// Redistribution and use in source and binary forms, with or without modification, | ||
// are permitted provided that the following conditions are met: | ||
// | ||
// * Redistribution's of source code must retain the above copyright notice, | ||
// this list of conditions and the following disclaimer. | ||
// | ||
// * Redistribution's in binary form must reproduce the above copyright notice, | ||
// this list of conditions and the following disclaimer in the documentation | ||
// and/or other materials provided with the distribution. | ||
// | ||
// * The name of the copyright holders may not be used to endorse or promote products | ||
// derived from this software without specific prior written permission. | ||
// | ||
// This software is provided by the copyright holders and contributors "as is" and | ||
// any express or implied warranties, including, but not limited to, the implied | ||
// warranties of merchantability and fitness for a particular purpose are disclaimed. | ||
// In no event shall the Intel Corporation or contributors be liable for any direct, | ||
// indirect, incidental, special, exemplary, or consequential damages | ||
// (including, but not 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. | ||
// | ||
//M*/ | ||
//################################################################################ | ||
// | ||
// Created by Kumataro | ||
// | ||
//################################################################################ | ||
|
||
#ifndef _OPENCV_FREETYPE_H_ | ||
#define _OPENCV_FREETYPE_H_ | ||
#ifdef __cplusplus | ||
|
||
#include <opencv2/core.hpp> | ||
|
||
/** | ||
@defgroup freetype Drawing UTF-8 strings with freetype/harfbuzz | ||
This modules is to draw UTF-8 strings with freetype/harfbuzz. | ||
1. Install freetype2 and harfbuzz in your system. | ||
2. Create FreeType2 instance with createFreeType2() function. | ||
3. Load font file with loadFontData() function. | ||
4. Draw text with putText() function. | ||
- If thickness parameter is negative, drawing glyph is filled. | ||
- If thickness parameter is positive, drawing glyph is outlined with thickness. | ||
- If line_type parameter is 16(or CV_AA), drawing glyph is smooth. | ||
*/ | ||
|
||
namespace cv { | ||
namespace freetype { | ||
//! @addtogroup freetype | ||
//! @{ | ||
class CV_EXPORTS_W FreeType2 : public Algorithm | ||
{ | ||
public: | ||
/** @brief Load font data. | ||
The function loadFontData loads font data. | ||
@param fontFileName FontFile Name | ||
@param id face_index to select a font faces in a single file. | ||
*/ | ||
|
||
CV_WRAP virtual void loadFontData(String fontFileName, int id) = 0; | ||
|
||
/** @brief Set Split Number from Bezier-curve to line | ||
The function setSplitNumber set the number of split points from bezier-curve to line. | ||
If you want to draw large glyph, large is better. | ||
If you want to draw small glyph, small is better. | ||
@param num number of split points from bezier-curve to line | ||
*/ | ||
|
||
CV_WRAP virtual void setSplitNumber( int num ) = 0; | ||
|
||
/** @brief Draws a text string. | ||
The function putText renders the specified text string in the image. Symbols that cannot be rendered using the specified font are replaced by "Tofu" or non-drawn. | ||
@param img Image. | ||
@param text Text string to be drawn. | ||
@param org Bottom-left/Top-left corner of the text string in the image. | ||
@param fontHeight Drawing font size by pixel unit. | ||
@param color Text color. | ||
@param thickness Thickness of the lines used to draw a text when negative, the glyph is filled. Otherwise, the glyph is drawn with this thickness. | ||
@param line_type Line type. See the line for details. | ||
@param bottomLeftOrigin When true, the image data origin is at the bottom-left corner. Otherwise, it is at the top-left corner. | ||
*/ | ||
|
||
CV_WRAP virtual void putText( | ||
InputOutputArray img, const String& text, Point org, | ||
int fontHeight, Scalar color, | ||
int thickness, int line_type, bool bottomLeftOrigin | ||
) = 0; | ||
|
||
}; | ||
/** @brief Create FreeType2 Instance | ||
The function createFreeType2 create instance to draw UTF-8 strings. | ||
*/ | ||
CV_EXPORTS_W Ptr<FreeType2> createFreeType2(); | ||
|
||
//! @] | ||
} } // namespace freetype | ||
|
||
#endif | ||
#endif |
Oops, something went wrong.