文档章节

OpenCascade Chinese Text Rendering

eryar
 eryar
发布于 2014/11/23 12:33
字数 1520
阅读 60
收藏 0

OpenCascade Chinese Text Rendering

eryar@163.com

Abstract. OpenCascade uses advanced text rendering powered by FTGL library. The FreeType provides vector text rendering, as a result the text can be rotated and zoomed without quality loss. FreeType also support unicode charset. The paper focus on the Chinese Text rendering. 

Key Words. OpenCascade, FreeType, Chinese Text, 中文汉字, Unicode

1. Introduction

OpenGL中并没有提供直接的文字绘制支持,一个通用的二维文字解决方案是使用glDrawPixels()来显示位图形式的字体,前提是用户已经预先生成了一系列的位置形式的文字字库,这也是很多早期计算机游戏的通用做法。使用位图来绘制文字的主要问题是不能控制显示过程中的图像走样。因为文字图像的大小总是一定的,缩放后变形比较明显;如果图像是根据视点实时地进行缩放,则势必消耗大量的系统资源。一个较好的解决方案就是使用纹理来表达矢量类型的文字。矢量文字的优点在于:每个字型都是使用数学公式来描述的,并使用光滑的曲线实现笔画之间的连接。因此,将矢量文字用纹理来表达的话,只要预先设置的纹理分辨率满足需求,那么对纹理面进行缩放或改变用户的视点时,都不会造成明显的文字失真变形。 

矢量文字的处理首推著名的开源跨平台开发库FreeType。这是一个专业的字体数据解析工具,可以解析TrueType, Type1等多种矢量字体格式,并通过统一的函数接口提供给用户程序使用。FreeType本身不包含文字排版和图形化显示的功能,因此可以直接将它解析字体文件的结果应用在OpenGL程序中。 

OpenCascade的文字显示就用到了FreeType库,将文字转换成了矢量图形,所以可以对其任意缩放,都不会影响其显示质量。且还支持Unicode的文字的显示,当然也包含中文的显示。本文主要介绍在OpenCascade中显示中文的注意事项,也介绍了OpenCascade中将文字转换成TopoDS_Shape的功能。 

2. Render Chinese Text

OpenCascade在Draw Test Harness中有关于显示文字的命令vdrawtext,显示文字效果如下图所示: 

wps_clip_image-19716

Figure 2.2 Text in Draw Test Harness 

实现上图的Tcl命令如下图所示: 

wps_clip_image-4179

Figure 2.2 Draw Text Tcl Command 

wps_clip_image-6580

Figure 2.3 vdrawtext command 

从vdrawtext命令中可以看出,最后一个参数就是关于多字节字符串的显示处理。输入如下命令来显示包含中文的字符串:

vdrawtext 你好OpenCascade 100  300 -400 000 255 255 0 0 000 1 50 1 SimSun 1 

显示结果如下所示: 

wps_clip_image-9941

Figure 2.4 Render Chinese Text by vdrawtext command 

由图可知,显示结果不正确。找到vdrawtext命令实现部分的源代码,实现代码在文件VeiwerTest_ObjectCommands.cxx中,修改其字符串转换算法后代码如下所示: 

static int VDrawText (Draw_Interpretor& di, Standard_Integer argc, const char** argv)
{
  // Check arguments
  if (argc < 14)
  {
    di<<"Error: "<<argv[0]<<" - invalid number of arguments\n";
    di<<"Usage: type help "<<argv[0]<<"\n";
    return 1; //TCL_ERROR
  }

  Handle(AIS_InteractiveContext) aContext = ViewerTest::GetAISContext();

  // Create 3D view if it doesn't exist
  if ( aContext.IsNull() )
  {
    ViewerTest::ViewerInit();
    aContext = ViewerTest::GetAISContext();
    if( aContext.IsNull() )
    {
      di << "Error: Cannot create a 3D view\n";
      return 1; //TCL_ERROR
    }
  }

  // Text position
  const Standard_Real X = Draw::Atof(argv[2]);
  const Standard_Real Y = Draw::Atof(argv[3]);
  const Standard_Real Z = Draw::Atof(argv[4]);
  const gp_Pnt pnt(X,Y,Z);

  // Text color
  const Quantity_Parameter R = Draw::Atof(argv[5])/255.;
  const Quantity_Parameter G = Draw::Atof(argv[6])/255.;
  const Quantity_Parameter B = Draw::Atof(argv[7])/255.;
  const Quantity_Color aColor( R, G, B, Quantity_TOC_RGB );

  // Text alignment
  const int hor_align = Draw::Atoi(argv[8]);
  const int ver_align = Draw::Atoi(argv[9]);

  // Text angle
  const Standard_Real angle = Draw::Atof(argv[10]);

  // Text zooming
  const Standard_Boolean zoom = Draw::Atoi(argv[11]);

  // Text height
  const Standard_Real height = Draw::Atof(argv[12]);

  // Text aspect
  const Font_FontAspect aspect = Font_FontAspect(Draw::Atoi(argv[13]));

  // Text font
  TCollection_AsciiString font;
  if(argc < 15)
    font.AssignCat("Courier");
  else
    font.AssignCat(argv[14]);

  // Text is multibyte
  const Standard_Boolean isMultibyte = (argc < 16)? Standard_False : (Draw::Atoi(argv[15]) != 0);

  // Read text string
  TCollection_ExtendedString name;
  if (isMultibyte)
  {
      /* eryar modified 20140817 11:11
    const char *str = argv[1];
    while ( *str || *(str+1)=='\x0A' || *(str+1)=='\x0B' || *(str+1)=='\x0C' || *(str+1)=='\x0D'
                 || *(str+1)=='\x07' || *(str+1)=='\x08' || *(str+1)=='\x09' )
    {
      unsigned short c1 = *str++;
      unsigned short c2 = *str++;
      if (!c2) break;
      name += (Standard_ExtCharacter)((c1 << 8) | c2);
    }
    */
      Resource_Unicode::ConvertGBToUnicode(argv[1], name);
  }
  else
  {
    name += argv[1];
  }

  if (name.Length())
  {
    Handle(MyTextClass) myT = new MyTextClass(name,pnt,aColor,hor_align,ver_align,angle,zoom,height,aspect,font.ToCString());
    aContext->Display(myT,Standard_True);
  }

  return 0;
}

主要当是多字节字符串,使用Resource_Unicode::ConvertGBToUnicode()函数来实现字符串转换,修改后仍输入前面的命令,可以显示中文字体了: 

wps_clip_image-23063

Figure 2.5 Render Chinese Text by vdrawtext command 

综上所述,结合Draw中的代码可知,要在OpenCascade中显示中文,需要注意以下几点: 

v 由于OpenCascade并没有提供直接显示文字的类,都需要从AIS_InteractiveObject派生一个文字显示类,并重载有关函数Compute(); 

v 字符串转换要使用Resource_Unicode::ConverteGBToUnicode()来将中文的字符串转换为Unicode字符串; 

v 一定要选择正确的中文字体,否则也是显示不正确的。 

wps_clip_image-27915

Figure 2.6 A Chinese Quote 

3. Convert Text to TopoDS_Shape

借助于TreeType库OpenCascade可以将文字转换成样条并生成TopoDS_Shape,即三维文字效果,相关的draw命令是text2brep,生成效果如下图所示: 

wps_clip_image-14323

Figure 3.1 3D Text in Draw Test Harness 

生成上述效果的Tcl脚本如下所示:

text2brep text2d eryar@163.com Times-Roman 18 bold composite=0 
prism text text2d 0 0 2 
vdisplay text 
vsetdispmode 1 
vfit 

  

4. Conclusion

OpenCascade使用FreeType来实现了文字的高质量的显示,因为是矢量图形,所以任意缩放不影响文字的质量。 

OpenCascade中显示中文时,需要注意字符串转换到Unicode时选择正确的转换函数,且要选择正确的字体格式,即中文字体,本文中仅以仿宋SimSun为例。 

OpenCascade还可将文字转换为TopoDS_Shape进而可以显示三维字体。 

综上所述,可知FreeType库的功能还是很强大的。 

5. References

1. 王锐,钱学雷,OpenSceneGraph三维渲染引擎设计与实践,清华大学出版社 

2. 在OpenCasCade的2D窗口中显示汉字的方法, 

http://www.cadcaecam.com/forum.php?mod=viewthread&tid=15444

3. OpenCascade Draw Test Harness code 

 

© 著作权归作者所有

eryar
粉丝 21
博文 127
码字总数 227012
作品 0
武汉
私信 提问
FreeCAD 0.16 发布,开源 CAD/CAE 工具

FreeCAD 0.16 发布了,FreeCAD是一个基于OpenCASCADE的开源CAD/CAE工具。 OpenCASCADE是一套开源的CAD/CAM/CAE几何模型核心,来自法国Matra Datavision公司,是著名的CAD软件EUCLID的开发平台...

oschina
2016/04/21
2.9K
2
Building OpenCascade on Windows with Visual Studio

Building OpenCascade on Windows with Visual Studio eryar@163.com 摘要Abstract:详细说明OpenCascade的编译配置过程,希望对你编译OpenCascacde有所帮助。本文内容来自OCCT的Overview文档...

eryar
2013/09/23
0
0
OpenCASCADE Make Primitives-Box

OpenCASCADE Make Primitives-Box eryar@163.com Abstract. By making a simple box to demonstrate the BRep data structure of the OpenCASCADE. The construction method is different fr......

eryar
2014/11/23
0
0
如何将openCASCADE和c++结合起来,哪位牛人能不能给我指点指点啊.

如何将openCASCADE和c++结合起来,哪位牛人能不能给我指点指点啊.我现在正想用openCASCADE和c++结合起来做一个像cad软件的东西。

chenchenxixi
2012/07/09
1K
2
FreeCAD 0.17Pre 发布,开源 CAD/CAE 工具

FreeCAD 0.17Pre 发布了。 FreeCAD是一个基于OpenCASCADE的开源CAD/CAE工具。 OpenCASCADE是一套开源的CAD/CAM/CAE几何模型核心,来自法国Matra Datavision公司,是著名的CAD软件EUCLID的开发...

达尔文
2016/10/10
2.3K
3

没有更多内容

加载失败,请刷新页面

加载更多

跨域的理解,以及解决方案!

/*什么是跨域? * 跨域的主要原因是浏览器的同源策略。 * =>>所谓的同源策略就是A网页设置的 Cookie,B网页不能打开,除非这两个网页"同源"。 * 什么是同源? * =>>同源就是协议相同、域名相同...

流年那么伤
5分钟前
0
0
Nginx配置try_fiels,php无法获取$_GET参数

平时开发都是用LNMP,新安装的虚拟机在配置nginx的rewrite的时候使用try_files命令。但是在写的时候配置成“try_files $uri $uri/ /index.php?q=args;”, 在PHP的web程序中,打印$_GET为空。...

叫我哀木涕
6分钟前
0
0
【原创】Microsoft Edge可以用localhost访问但无法用IP访问

Microsoft Edge可以用localhost和127.0.0.1访问但无法用本机IP访问, chrome ie都可以推测是edge的问题,网络是专用网络,防火墙也关了: 在edge里 按F12 以在控制台里看到这句 CONSOLE21301...

shzwork
6分钟前
0
0
Python利用数学方程式画4种不一样的心型图案

前言 下面这四个心型图案,是通过科学地计算,根据数学方程式生成的,虽然做的不是特别完美,但是基本的还是能实现的 第一个心型 结果图 第二心型 结果图 学习从来不是一个人的事情,要有个相互监...

A_裙232550246
6分钟前
0
0
微信带场景参数的二维码生成与使用?

微信公众号推广时,用户通过扫二维码关注公众号,需要统计用户是通过谁的二维码进行关注。 在用户扫码关注公众号时,二维码带上推广者的参数,在关注公众号后,获取到该推广者的参数。 目前有...

wxgzhgncj
7分钟前
0
0

没有更多内容

加载失败,请刷新页面

加载更多

返回顶部
顶部