Re: [ft-devel] Relevance of new API FT_Get_Module_Flags ?

[David Turner]

Hi everyone,

I just removed FT_Get_Module_Flags, it is now replaced by a new API
named FT_Get_TrueType_Engine_Type. documentation is below.

I guess It will be part of the next release candidate

Regards,

- David Turner
- The FreeType Project  (www.freetype.org)

-------------------------- cut here -------------------------------------
 /**
  * @enum: FT_TrueTypeEngineType
  *
  * @description:
  *    a list of values describing which kind of truetype bytecode
  *    engine is implemented in a given FT_Library instance. It is used
  *    by the @FT_Get_TrueType_Engine_Type function
  *
  * @values:
  *    FT_TRUETYPE_ENGINE_TYPE_NONE ::
  *      the library doesn't implement any kind of bytecode interpreter
  *
  *    FT_TRUETYPE_ENGINE_TYPE_UNPATENTED ::
  *      the library implements a bytecode interpreter that doesn't
  *      support the patented operations of the TrueType virtual machine.
  *
  *      this interpreter can only be used to load certain Asian fonts
  *      from Dynalabs. It will produce crap output for any other font.
  *      see @
  *
  *   FT_TRUETYPE_ENGINE_TYPE_PATENTED ::
  *      the library implements a bytecode interpreter that covers
  *      the full instruction set of the TrueType virtual machine.
  *      Better check your legal department for license compliance !!
  *
  * @since: 2.2
  */
  typedef enum
  {
    FT_TRUETYPE_ENGINE_TYPE_NONE = 0,
    FT_TRUETYPE_ENGINE_TYPE_UNPATENTED,
    FT_TRUETYPE_ENGINE_TYPE_PATENTED

  } FT_TrueTypeEngineType;


 /**
  * @func: FT_Get_TrueType_Engine_Type
  *
  * @description:
  *   this function returns a @FT_TrueTypeEngineType value to indicates
  *   which level of the TrueType virtual machine a given library instance
  *   supports.
  *
  * @input:
  *   library :: a library instance
  *
  * @return:
  *   a value indicating which level is supported
  *
  * @since: 2.2
  */
  FT_EXPORT( FT_TrueTypeEngineType )
  FT_Get_TrueType_Engine_Type( FT_Library  library );
-------------------------- end of cut -----------------------------------




Huw D M Davies a écrit :

On Tue, Feb 21, 2006 at 07:03:15AM +0100, Werner LEMBERG wrote:
  

Could someone tell me the relevance of the new public API named
FT_Get_Module_Flags that was introduced in the current CVS ?
          

This might be answered best by Owen -- he has requested that
feature, and he also provided the patch.

        

If this function's purpose is to determine wether the bytecode
interpreter is activated in a given FreeType build, I'd rather
like to see a specific API that returns a boolean, or an enum,
instead of asking users to understand our specific flags (which
we may need to change in the future, btw)
          

This is OK with me.  Owen?
        

Wasn't me... maybe it was George?
      

Ah, sorry, it was Huw.
    

Yes it was me.  Its purpose was exactly that, to determine whether the
bytecode interpreter is enabled in a given build.  A specific API that
returns either a bool or an enum would be fine.

Huw.



_______________________________________________
Freetype-devel mailing list
address@hidden
http://lists.nongnu.org/mailman/listinfo/freetype-devel