Differences between revisions 15 and 16
Revision 15 as of 2008-08-14 16:21:07
Size: 3048
Comment:
Revision 16 as of 2008-08-14 16:21:51
Size: 2722
Comment:
Deletions are marked like this. Additions are marked like this.
Line 32: Line 32:

---- /!\ '''Edit conflict - other version:''' ----
Line 35: Line 33:

---- /!\ '''Edit conflict - your version:''' ----
{{{#!python

---- /!\ '''End of edit conflict''' ----
Line 47: Line 40:
---- /!\ '''Edit conflict - other version:''' ----
Line 49: Line 41:

---- /!\ '''Edit conflict - your version:''' ----
{{{#!python

---- /!\ '''End of edit conflict''' ----

Compiling EMAN2 with FTGL support

To compile EMAN2 with FTGL support set ENABLE_FTGL to ON in cmake setup.

Using FTGL in python in EMAN2

Programmers have to create an instance of an EMFTGL object, for instance as a member variable:

   1 self.font_renderer = EMFTGL()
   2 self.font_renderer.set_face_size(16)
   3 self.font_renderer.set_using_display_lists(True)
   4 self.font_renderer.set_depth(32) # only applicable if font mode is EXTRUDE
   5 self.font_renderer.set_font_mode(FTGLFontMode.TEXTURE) # or EXTRUDE, PIXMAP, BITMAP, POLYGON or OUTLINE
   6 #self.font_renderer.set_font_file_name("/usr/share/fonts/dejavu/DejaVuSerif-Bold.ttf")

A platform independent solution to getting a font renderer is available and is the recommended approach

   1 from EMAN2 import get_3d_font_renderer
   2 self.font_renderer = get_3d_font_renderer()
   3 self.font_renderer.set_face_size(16) # etc

Note that the EMFTGL has default values for all of its parameters and that in general you want to limit the number of times you call the setter functions, because they cause FTGL to regenerate an FTFont class and this is not a trivial expense. However the EMFTGL uses a cache so any FTFonts (which are characterized by face size, depth, display list use, mode, and font file) which have previously been created will automatically be reused (if parameters match).

The EMFTGL cache is not static. This is related to OpenGL contexts and display lists...

Then to render text use a command similar to the following in your paint function:

   1 glPushMatrix() # FTGL does transformations - must push
   2 self.font_renderer.render_string("Important Information")
   3 glPopMatrix()

To get the bounding box of the string use:

   1 bbox = self.font_renderer.bounding_box("Important Information")

If you want to rotate the font as though it is centered on the origin you might use


/!\ Edit conflict - other version:


   1 ---- /!\ '''Edit conflict - your version:''' ----
   2 {{{#!python
   3 
   4 ---- /!\ '''End of edit conflict''' ----
   5 message = "Important Information"
   6 rotation = 45
   7 rot_axis = [1,0,0]
   8 bbox = self.font_renderer.bounding_box(message)
   9 
  10 glPushMatrix()
  11 glTranslate(-(bbox[0]-bbox[3])/2,-(bbox[1]-bbox[4])/2,-(bbox[2]-bbox[5])/2)
  12 glRotate(rotation,*rot_axis)
  13 glTranslate((bbox[0]-bbox[3])/2,(bbox[1]-bbox[4])/2,(bbox[2]-bbox[5])/2)
  14 self.font_renderer.render_string(message)
  15 glPopMatrix()

Recommendations

TEXTURE fonts are probably the most versatile types. They are fast, antialiased, and can be transformed just like any OpenGL primitive. See http://ftgl.sourceforge.net/docs/html/ftgl-tutorial.html

Eman2UsingFTGL (last edited 2022-02-18 00:29:09 by TunayDurmaz)