Delete all Trailing spaces in code.
[reactos.git] / reactos / dll / 3rdparty / freetype / include / freetype / ftmac.h
index 3c6fafe..b534c75 100644 (file)
-/***************************************************************************/
-/*                                                                         */
-/*  ftmac.h                                                                */
-/*                                                                         */
-/*    Additional Mac-specific API.                                         */
-/*                                                                         */
-/*  Copyright 1996-2001, 2004, 2006, 2007 by                               */
-/*  Just van Rossum, David Turner, Robert Wilhelm, and Werner Lemberg.     */
-/*                                                                         */
-/*  This file is part of the FreeType project, and may only be used,       */
-/*  modified, and distributed under the terms of the FreeType project      */
-/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */
-/*  this file you indicate that you have read the license and              */
-/*  understand and accept it fully.                                        */
-/*                                                                         */
-/***************************************************************************/
-
-
-/***************************************************************************/
-/*                                                                         */
-/* NOTE: Include this file after <freetype/freetype.h> and after the       */
-/*       Mac-specific <Types.h> header (or any other Mac header that       */
-/*       includes <Types.h>); we use Handle type.                          */
-/*                                                                         */
-/***************************************************************************/
-
-
-#ifndef __FTMAC_H__
-#define __FTMAC_H__
-
-
-#include <ft2build.h>
-
-
-FT_BEGIN_HEADER
-
-
-/* gcc-3.4.1 and later can warn about functions tagged as deprecated */
-#ifndef FT_DEPRECATED_ATTRIBUTE
-#if defined(__GNUC__)                                               && \
-    ((__GNUC__ >= 4) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 1)))
-#define FT_DEPRECATED_ATTRIBUTE  __attribute__((deprecated))
-#else
-#define FT_DEPRECATED_ATTRIBUTE
-#endif
-#endif
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Section>                                                             */
-  /*    mac_specific                                                       */
-  /*                                                                       */
-  /* <Title>                                                               */
-  /*    Mac Specific Interface                                             */
-  /*                                                                       */
-  /* <Abstract>                                                            */
-  /*    Only available on the Macintosh.                                   */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    The following definitions are only available if FreeType is        */
-  /*    compiled on a Macintosh.                                           */
-  /*                                                                       */
-  /*************************************************************************/
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_New_Face_From_FOND                                              */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Create a new face object from a FOND resource.                     */
-  /*                                                                       */
-  /* <InOut>                                                               */
-  /*    library    :: A handle to the library resource.                    */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    fond       :: A FOND resource.                                     */
-  /*                                                                       */
-  /*    face_index :: Only supported for the -1 `sanity check' special     */
-  /*                  case.                                                */
-  /*                                                                       */
-  /* <Output>                                                              */
-  /*    aface      :: A handle to a new face object.                       */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  /* <Notes>                                                               */
-  /*    This function can be used to create @FT_Face objects from fonts    */
-  /*    that are installed in the system as follows.                       */
-  /*                                                                       */
-  /*    {                                                                  */
-  /*      fond = GetResource( 'FOND', fontName );                          */
-  /*      error = FT_New_Face_From_FOND( library, fond, 0, &face );        */
-  /*    }                                                                  */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_New_Face_From_FOND( FT_Library  library,
-                         Handle      fond,
-                         FT_Long     face_index,
-                         FT_Face    *aface );
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_GetFile_From_Mac_Name                                           */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Return an FSSpec for the disk file containing the named font.      */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    fontName   :: Mac OS name of the font (e.g., Times New Roman       */
-  /*                  Bold).                                               */
-  /*                                                                       */
-  /* <Output>                                                              */
-  /*    pathSpec   :: FSSpec to the file.  For passing to                  */
-  /*                  @FT_New_Face_From_FSSpec.                            */
-  /*                                                                       */
-  /*    face_index :: Index of the face.  For passing to                   */
-  /*                  @FT_New_Face_From_FSSpec.                            */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_GetFile_From_Mac_Name( const char*  fontName,
-                            FSSpec*      pathSpec,
-                            FT_Long*     face_index )
-                          FT_DEPRECATED_ATTRIBUTE;
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_GetFile_From_Mac_ATS_Name                                       */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Return an FSSpec for the disk file containing the named font.      */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    fontName   :: Mac OS name of the font in ATS framework.            */
-  /*                                                                       */
-  /* <Output>                                                              */
-  /*    pathSpec   :: FSSpec to the file. For passing to                   */
-  /*                  @FT_New_Face_From_FSSpec.                            */
-  /*                                                                       */
-  /*    face_index :: Index of the face. For passing to                    */
-  /*                  @FT_New_Face_From_FSSpec.                            */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_GetFile_From_Mac_ATS_Name( const char*  fontName,
-                                FSSpec*      pathSpec,
-                                FT_Long*     face_index )
-                              FT_DEPRECATED_ATTRIBUTE;
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_GetFilePath_From_Mac_ATS_Name                                   */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Return a pathname of the disk file and face index for given font   */
-  /*    name which is handled by ATS framework.                            */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    fontName    :: Mac OS name of the font in ATS framework.           */
-  /*                                                                       */
-  /* <Output>                                                              */
-  /*    path        :: Buffer to store pathname of the file.  For passing  */
-  /*                   to @FT_New_Face.  The client must allocate this     */
-  /*                   buffer before calling this function.                */
-  /*                                                                       */
-  /*    maxPathSize :: Lengths of the buffer `path' that client allocated. */
-  /*                                                                       */
-  /*    face_index  :: Index of the face.  For passing to @FT_New_Face.    */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_GetFilePath_From_Mac_ATS_Name( const char*  fontName,
-                                    UInt8*       path,
-                                    UInt32       maxPathSize,
-                                    FT_Long*     face_index );
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_New_Face_From_FSSpec                                            */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Create a new face object from a given resource and typeface index  */
-  /*    using an FSSpec to the font file.                                  */
-  /*                                                                       */
-  /* <InOut>                                                               */
-  /*    library    :: A handle to the library resource.                    */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    spec       :: FSSpec to the font file.                             */
-  /*                                                                       */
-  /*    face_index :: The index of the face within the resource.  The      */
-  /*                  first face has index 0.                              */
-  /* <Output>                                                              */
-  /*    aface      :: A handle to a new face object.                       */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  /* <Note>                                                                */
-  /*    @FT_New_Face_From_FSSpec is identical to @FT_New_Face except       */
-  /*    it accepts an FSSpec instead of a path.                            */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_New_Face_From_FSSpec( FT_Library     library,
-                           const FSSpec  *spec,
-                           FT_Long        face_index,
-                           FT_Face       *aface )
-                         FT_DEPRECATED_ATTRIBUTE;
-
-
-  /*************************************************************************/
-  /*                                                                       */
-  /* <Function>                                                            */
-  /*    FT_New_Face_From_FSRef                                             */
-  /*                                                                       */
-  /* <Description>                                                         */
-  /*    Create a new face object from a given resource and typeface index  */
-  /*    using an FSRef to the font file.                                   */
-  /*                                                                       */
-  /* <InOut>                                                               */
-  /*    library    :: A handle to the library resource.                    */
-  /*                                                                       */
-  /* <Input>                                                               */
-  /*    spec       :: FSRef to the font file.                              */
-  /*                                                                       */
-  /*    face_index :: The index of the face within the resource.  The      */
-  /*                  first face has index 0.                              */
-  /* <Output>                                                              */
-  /*    aface      :: A handle to a new face object.                       */
-  /*                                                                       */
-  /* <Return>                                                              */
-  /*    FreeType error code.  0 means success.                             */
-  /*                                                                       */
-  /* <Note>                                                                */
-  /*    @FT_New_Face_From_FSRef is identical to @FT_New_Face except        */
-  /*    it accepts an FSRef instead of a path.                             */
-  /*                                                                       */
-  FT_EXPORT( FT_Error )
-  FT_New_Face_From_FSRef( FT_Library    library,
-                          const FSRef  *ref,
-                          FT_Long       face_index,
-                          FT_Face      *aface )
-                        FT_DEPRECATED_ATTRIBUTE;
-
-  /* */
-
-
-FT_END_HEADER
-
-
-#endif /* __FTMAC_H__ */
-
-
-/* END */
+/***************************************************************************/\r
+/*                                                                         */\r
+/*  ftmac.h                                                                */\r
+/*                                                                         */\r
+/*    Additional Mac-specific API.                                         */\r
+/*                                                                         */\r
+/*  Copyright 1996-2001, 2004, 2006, 2007 by                               */\r
+/*  Just van Rossum, David Turner, Robert Wilhelm, and Werner Lemberg.     */\r
+/*                                                                         */\r
+/*  This file is part of the FreeType project, and may only be used,       */\r
+/*  modified, and distributed under the terms of the FreeType project      */\r
+/*  license, LICENSE.TXT.  By continuing to use, modify, or distribute     */\r
+/*  this file you indicate that you have read the license and              */\r
+/*  understand and accept it fully.                                        */\r
+/*                                                                         */\r
+/***************************************************************************/\r
+\r
+\r
+/***************************************************************************/\r
+/*                                                                         */\r
+/* NOTE: Include this file after <freetype/freetype.h> and after the       */\r
+/*       Mac-specific <Types.h> header (or any other Mac header that       */\r
+/*       includes <Types.h>); we use Handle type.                          */\r
+/*                                                                         */\r
+/***************************************************************************/\r
+\r
+\r
+#ifndef __FTMAC_H__\r
+#define __FTMAC_H__\r
+\r
+\r
+#include <ft2build.h>\r
+\r
+\r
+FT_BEGIN_HEADER\r
+\r
+\r
+/* gcc-3.4.1 and later can warn about functions tagged as deprecated */\r
+#ifndef FT_DEPRECATED_ATTRIBUTE\r
+#if defined(__GNUC__)                                               && \\r
+    ((__GNUC__ >= 4) || ((__GNUC__ == 3) && (__GNUC_MINOR__ >= 1)))\r
+#define FT_DEPRECATED_ATTRIBUTE  __attribute__((deprecated))\r
+#else\r
+#define FT_DEPRECATED_ATTRIBUTE\r
+#endif\r
+#endif\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Section>                                                             */\r
+  /*    mac_specific                                                       */\r
+  /*                                                                       */\r
+  /* <Title>                                                               */\r
+  /*    Mac Specific Interface                                             */\r
+  /*                                                                       */\r
+  /* <Abstract>                                                            */\r
+  /*    Only available on the Macintosh.                                   */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    The following definitions are only available if FreeType is        */\r
+  /*    compiled on a Macintosh.                                           */\r
+  /*                                                                       */\r
+  /*************************************************************************/\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_New_Face_From_FOND                                              */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Create a new face object from a FOND resource.                     */\r
+  /*                                                                       */\r
+  /* <InOut>                                                               */\r
+  /*    library    :: A handle to the library resource.                    */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    fond       :: A FOND resource.                                     */\r
+  /*                                                                       */\r
+  /*    face_index :: Only supported for the -1 `sanity check' special     */\r
+  /*                  case.                                                */\r
+  /*                                                                       */\r
+  /* <Output>                                                              */\r
+  /*    aface      :: A handle to a new face object.                       */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  /* <Notes>                                                               */\r
+  /*    This function can be used to create @FT_Face objects from fonts    */\r
+  /*    that are installed in the system as follows.                       */\r
+  /*                                                                       */\r
+  /*    {                                                                  */\r
+  /*      fond = GetResource( 'FOND', fontName );                          */\r
+  /*      error = FT_New_Face_From_FOND( library, fond, 0, &face );        */\r
+  /*    }                                                                  */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_New_Face_From_FOND( FT_Library  library,\r
+                         Handle      fond,\r
+                         FT_Long     face_index,\r
+                         FT_Face    *aface );\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_GetFile_From_Mac_Name                                           */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Return an FSSpec for the disk file containing the named font.      */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    fontName   :: Mac OS name of the font (e.g., Times New Roman       */\r
+  /*                  Bold).                                               */\r
+  /*                                                                       */\r
+  /* <Output>                                                              */\r
+  /*    pathSpec   :: FSSpec to the file.  For passing to                  */\r
+  /*                  @FT_New_Face_From_FSSpec.                            */\r
+  /*                                                                       */\r
+  /*    face_index :: Index of the face.  For passing to                   */\r
+  /*                  @FT_New_Face_From_FSSpec.                            */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_GetFile_From_Mac_Name( const char*  fontName,\r
+                            FSSpec*      pathSpec,\r
+                            FT_Long*     face_index )\r
+                          FT_DEPRECATED_ATTRIBUTE;\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_GetFile_From_Mac_ATS_Name                                       */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Return an FSSpec for the disk file containing the named font.      */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    fontName   :: Mac OS name of the font in ATS framework.            */\r
+  /*                                                                       */\r
+  /* <Output>                                                              */\r
+  /*    pathSpec   :: FSSpec to the file. For passing to                   */\r
+  /*                  @FT_New_Face_From_FSSpec.                            */\r
+  /*                                                                       */\r
+  /*    face_index :: Index of the face. For passing to                    */\r
+  /*                  @FT_New_Face_From_FSSpec.                            */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_GetFile_From_Mac_ATS_Name( const char*  fontName,\r
+                                FSSpec*      pathSpec,\r
+                                FT_Long*     face_index )\r
+                              FT_DEPRECATED_ATTRIBUTE;\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_GetFilePath_From_Mac_ATS_Name                                   */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Return a pathname of the disk file and face index for given font   */\r
+  /*    name which is handled by ATS framework.                            */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    fontName    :: Mac OS name of the font in ATS framework.           */\r
+  /*                                                                       */\r
+  /* <Output>                                                              */\r
+  /*    path        :: Buffer to store pathname of the file.  For passing  */\r
+  /*                   to @FT_New_Face.  The client must allocate this     */\r
+  /*                   buffer before calling this function.                */\r
+  /*                                                                       */\r
+  /*    maxPathSize :: Lengths of the buffer `path' that client allocated. */\r
+  /*                                                                       */\r
+  /*    face_index  :: Index of the face.  For passing to @FT_New_Face.    */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_GetFilePath_From_Mac_ATS_Name( const char*  fontName,\r
+                                    UInt8*       path,\r
+                                    UInt32       maxPathSize,\r
+                                    FT_Long*     face_index );\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_New_Face_From_FSSpec                                            */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Create a new face object from a given resource and typeface index  */\r
+  /*    using an FSSpec to the font file.                                  */\r
+  /*                                                                       */\r
+  /* <InOut>                                                               */\r
+  /*    library    :: A handle to the library resource.                    */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    spec       :: FSSpec to the font file.                             */\r
+  /*                                                                       */\r
+  /*    face_index :: The index of the face within the resource.  The      */\r
+  /*                  first face has index 0.                              */\r
+  /* <Output>                                                              */\r
+  /*    aface      :: A handle to a new face object.                       */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  /* <Note>                                                                */\r
+  /*    @FT_New_Face_From_FSSpec is identical to @FT_New_Face except       */\r
+  /*    it accepts an FSSpec instead of a path.                            */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_New_Face_From_FSSpec( FT_Library     library,\r
+                           const FSSpec  *spec,\r
+                           FT_Long        face_index,\r
+                           FT_Face       *aface )\r
+                         FT_DEPRECATED_ATTRIBUTE;\r
+\r
+\r
+  /*************************************************************************/\r
+  /*                                                                       */\r
+  /* <Function>                                                            */\r
+  /*    FT_New_Face_From_FSRef                                             */\r
+  /*                                                                       */\r
+  /* <Description>                                                         */\r
+  /*    Create a new face object from a given resource and typeface index  */\r
+  /*    using an FSRef to the font file.                                   */\r
+  /*                                                                       */\r
+  /* <InOut>                                                               */\r
+  /*    library    :: A handle to the library resource.                    */\r
+  /*                                                                       */\r
+  /* <Input>                                                               */\r
+  /*    spec       :: FSRef to the font file.                              */\r
+  /*                                                                       */\r
+  /*    face_index :: The index of the face within the resource.  The      */\r
+  /*                  first face has index 0.                              */\r
+  /* <Output>                                                              */\r
+  /*    aface      :: A handle to a new face object.                       */\r
+  /*                                                                       */\r
+  /* <Return>                                                              */\r
+  /*    FreeType error code.  0 means success.                             */\r
+  /*                                                                       */\r
+  /* <Note>                                                                */\r
+  /*    @FT_New_Face_From_FSRef is identical to @FT_New_Face except        */\r
+  /*    it accepts an FSRef instead of a path.                             */\r
+  /*                                                                       */\r
+  FT_EXPORT( FT_Error )\r
+  FT_New_Face_From_FSRef( FT_Library    library,\r
+                          const FSRef  *ref,\r
+                          FT_Long       face_index,\r
+                          FT_Face      *aface )\r
+                        FT_DEPRECATED_ATTRIBUTE;\r
+\r
+  /* */\r
+\r
+\r
+FT_END_HEADER\r
+\r
+\r
+#endif /* __FTMAC_H__ */\r
+\r
+\r
+/* END */\r