home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1999 April: Mac OS SDK / Dev.CD Apr 99 SDK1.toast / Development Kits / Text Encoding Converter 1.4.2 / Headers / TextEncodingPlugin.h < prev    next >
Encoding:
C/C++ Source or Header  |  1999-02-12  |  8.6 KB  |  231 lines  |  [TEXT/MPS ]
  1. /*
  2.      File:        TextEncodingPlugin.h
  3.  
  4.      Contains:    Required interface for Text Encoding Converter-Plugins
  5.  
  6.      Version:    Mac OS 8
  7.  
  8.      DRI:        Julio Gonzalez
  9.  
  10.      Copyright:    © 1996-1998 by Apple Computer, Inc., all rights reserved.
  11.  
  12.      Warning:    *** APPLE INTERNAL USE ONLY ***
  13.                  This file may contain unreleased API's
  14.  
  15.      BuildInfo:    Built by:            BuildGod
  16.                  With Interfacer:    3.0d8   (PowerPC native)
  17.                  From:                TextEncodingPlugin.i
  18.                      Revision:        19
  19.                      Dated:            5/4/98
  20.                      Last change by:    PKE
  21.                      Last comment:    Update includes: Add MacTypes.i, TextCommon.i.
  22.  
  23.      Bugs:        Report bugs to Radar component "System Interfaces", "Latest"
  24.                  List the version information (from above) in the Problem Description.
  25.  
  26. */
  27. #ifndef __TEXTENCODINGPLUGIN__
  28. #define __TEXTENCODINGPLUGIN__
  29.  
  30. #ifndef __MACTYPES__
  31. #include <MacTypes.h>
  32. #endif
  33. #ifndef __TEXTCOMMON__
  34. #include <TextCommon.h>
  35. #endif
  36. #ifndef __TEXTENCODINGCONVERTER__
  37. #include <TextEncodingConverter.h>
  38. #endif
  39.  
  40.  
  41.  
  42. #if PRAGMA_ONCE
  43. #pragma once
  44. #endif
  45.  
  46. #ifdef __cplusplus
  47. extern "C" {
  48. #endif
  49.  
  50. #if PRAGMA_IMPORT
  51. #pragma import on
  52. #endif
  53.  
  54. #if PRAGMA_STRUCT_ALIGN
  55.     #pragma options align=mac68k
  56. #elif PRAGMA_STRUCT_PACKPUSH
  57.     #pragma pack(push, 2)
  58. #elif PRAGMA_STRUCT_PACK
  59.     #pragma pack(2)
  60. #endif
  61.  
  62. /*
  63. ####################################################################################
  64.         Structs
  65. ####################################################################################
  66. */
  67.  
  68. struct TECBufferContextRec {
  69.     TextPtr                         textInputBuffer;
  70.     TextPtr                         textInputBufferEnd;
  71.     TextPtr                         textOutputBuffer;
  72.     TextPtr                         textOutputBufferEnd;
  73.  
  74.     TextEncodingRunPtr                 encodingInputBuffer;
  75.     TextEncodingRunPtr                 encodingInputBufferEnd;
  76.     TextEncodingRunPtr                 encodingOutputBuffer;
  77.     TextEncodingRunPtr                 encodingOutputBufferEnd;
  78.  
  79. };
  80. typedef struct TECBufferContextRec        TECBufferContextRec;
  81.  
  82. struct TECPluginStateRec {
  83.  
  84.     UInt8                             state1;
  85.     UInt8                             state2;
  86.     UInt8                             state3;
  87.     UInt8                             state4;
  88.  
  89.     UInt32                             longState1;
  90.     UInt32                             longState2;
  91.     UInt32                             longState3;
  92.     UInt32                             longState4;
  93.  
  94. };
  95. typedef struct TECPluginStateRec        TECPluginStateRec;
  96.  
  97. struct TECConverterContextRec {
  98.  
  99.                                                                 /* public - manipulated externally and by plugin*/
  100.     Ptr                             pluginRec;
  101.     TextEncoding                     sourceEncoding;
  102.     TextEncoding                     destEncoding;
  103.     UInt32                             reserved1;
  104.     UInt32                             reserved2;
  105.     TECBufferContextRec             bufferContext;
  106.                                                                 /* private - manipulated only within Plugin*/
  107.     UInt32                             contextRefCon;
  108.     ProcPtr                         conversionProc;
  109.     ProcPtr                         flushProc;
  110.     ProcPtr                         clearContextInfoProc;
  111.     UInt32                             options1;
  112.     UInt32                             options2;
  113.     TECPluginStateRec                 pluginState;
  114.  
  115. };
  116. typedef struct TECConverterContextRec    TECConverterContextRec;
  117.  
  118. struct TECSnifferContextRec {
  119.  
  120.                                                                 /* public - manipulated externally*/
  121.     Ptr                             pluginRec;
  122.     TextEncoding                     encoding;
  123.     ItemCount                         maxErrors;
  124.     ItemCount                         maxFeatures;
  125.     TextPtr                         textInputBuffer;
  126.     TextPtr                         textInputBufferEnd;
  127.     ItemCount                         numFeatures;
  128.     ItemCount                         numErrors;
  129.                                                                 /* private - manipulated only within Plugin*/
  130.     UInt32                             contextRefCon;
  131.     ProcPtr                         sniffProc;
  132.     ProcPtr                         clearContextInfoProc;
  133.     TECPluginStateRec                 pluginState;
  134. };
  135. typedef struct TECSnifferContextRec        TECSnifferContextRec;
  136. /*
  137.   ####################################################################################
  138.           Functional Messages
  139.   ####################################################################################
  140. */
  141. typedef CALLBACK_API_C( OSStatus , TECPluginNewEncodingConverterPtr )(TECObjectRef *newEncodingConverter, TECConverterContextRec *plugContext, TextEncoding inputEncoding, TextEncoding outputEncoding);
  142. typedef CALLBACK_API_C( OSStatus , TECPluginClearContextInfoPtr )(TECObjectRef encodingConverter, TECConverterContextRec *plugContext);
  143. typedef CALLBACK_API_C( OSStatus , TECPluginConvertTextEncodingPtr )(TECObjectRef encodingConverter, TECConverterContextRec *plugContext);
  144. typedef CALLBACK_API_C( OSStatus , TECPluginFlushConversionPtr )(TECObjectRef encodingConverter, TECConverterContextRec *plugContext);
  145. typedef CALLBACK_API_C( OSStatus , TECPluginDisposeEncodingConverterPtr )(TECObjectRef newEncodingConverter, TECConverterContextRec *plugContext);
  146. typedef CALLBACK_API_C( OSStatus , TECPluginNewEncodingSnifferPtr )(TECSnifferObjectRef *encodingSniffer, TECSnifferContextRec *snifContext, TextEncoding inputEncoding);
  147. typedef CALLBACK_API_C( OSStatus , TECPluginClearSnifferContextInfoPtr )(TECSnifferObjectRef encodingSniffer, TECSnifferContextRec *snifContext);
  148. typedef CALLBACK_API_C( OSStatus , TECPluginSniffTextEncodingPtr )(TECSnifferObjectRef encodingSniffer, TECSnifferContextRec *snifContext);
  149. typedef CALLBACK_API_C( OSStatus , TECPluginDisposeEncodingSnifferPtr )(TECSnifferObjectRef encodingSniffer, TECSnifferContextRec *snifContext);
  150. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountAvailableTextEncodingsPtr )(TextEncoding *availableEncodings, ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings);
  151. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountAvailableTextEncodingPairsPtr )(TECConversionInfo *availableEncodings, ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings);
  152. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountDestinationTextEncodingsPtr )(TextEncoding inputEncoding, TextEncoding *destinationEncodings, ItemCount maxDestinationEncodings, ItemCount *actualDestinationEncodings);
  153. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountSubTextEncodingsPtr )(TextEncoding inputEncoding, TextEncoding subEncodings[], ItemCount maxSubEncodings, ItemCount *actualSubEncodings);
  154. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountAvailableSniffersPtr )(TextEncoding *availableEncodings, ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings);
  155. typedef CALLBACK_API_C( OSStatus , TECPluginGetTextEncodingInternetNamePtr )(TextEncoding textEncoding, Str255 encodingName);
  156. typedef CALLBACK_API_C( OSStatus , TECPluginGetTextEncodingFromInternetNamePtr )(TextEncoding *textEncoding, ConstStr255Param encodingName);
  157. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountWebEncodingsPtr )(TextEncoding *availableEncodings, ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings);
  158. typedef CALLBACK_API_C( OSStatus , TECPluginGetCountMailEncodingsPtr )(TextEncoding *availableEncodings, ItemCount maxAvailableEncodings, ItemCount *actualAvailableEncodings);
  159. /*
  160.   ####################################################################################
  161.           Dispatch Table Definition
  162.   ####################################################################################
  163. */
  164.  
  165.  
  166. enum {
  167.     kTECPluginDispatchTableVersion1 = 0x00010000,                /* 1.0 through 1.0.3 releases*/
  168.     kTECPluginDispatchTableVersion1_1 = 0x00010001,                /* 1.1 releases*/
  169.     kTECPluginDispatchTableVersion1_2 = 0x00010002,                /* 1.2 releases*/
  170.     kTECPluginDispatchTableCurrentVersion = kTECPluginDispatchTableVersion1_2
  171. };
  172.  
  173.  
  174. struct TECPluginDispatchTable {
  175.  
  176.     TECPluginVersion                 version;
  177.     TECPluginVersion                 compatibleVersion;
  178.     TECPluginSignature                 PluginID;
  179.  
  180.     TECPluginNewEncodingConverterPtr  PluginNewEncodingConverter;
  181.     TECPluginClearContextInfoPtr     PluginClearContextInfo;
  182.     TECPluginConvertTextEncodingPtr  PluginConvertTextEncoding;
  183.     TECPluginFlushConversionPtr     PluginFlushConversion;
  184.     TECPluginDisposeEncodingConverterPtr  PluginDisposeEncodingConverter;
  185.  
  186.     TECPluginNewEncodingSnifferPtr     PluginNewEncodingSniffer;
  187.     TECPluginClearSnifferContextInfoPtr  PluginClearSnifferContextInfo;
  188.     TECPluginSniffTextEncodingPtr     PluginSniffTextEncoding;
  189.     TECPluginDisposeEncodingSnifferPtr  PluginDisposeEncodingSniffer;
  190.  
  191.     TECPluginGetCountAvailableTextEncodingsPtr  PluginGetCountAvailableTextEncodings;
  192.     TECPluginGetCountAvailableTextEncodingPairsPtr  PluginGetCountAvailableTextEncodingPairs;
  193.     TECPluginGetCountDestinationTextEncodingsPtr  PluginGetCountDestinationTextEncodings;
  194.     TECPluginGetCountSubTextEncodingsPtr  PluginGetCountSubTextEncodings;
  195.     TECPluginGetCountAvailableSniffersPtr  PluginGetCountAvailableSniffers;
  196.     TECPluginGetCountWebEncodingsPtr  PluginGetCountWebTextEncodings;
  197.     TECPluginGetCountMailEncodingsPtr  PluginGetCountMailTextEncodings;
  198.  
  199.     TECPluginGetTextEncodingInternetNamePtr  PluginGetTextEncodingInternetName;
  200.     TECPluginGetTextEncodingFromInternetNamePtr  PluginGetTextEncodingFromInternetName;
  201.  
  202. };
  203. typedef struct TECPluginDispatchTable    TECPluginDispatchTable;
  204.  
  205.  
  206.  
  207.  
  208.  
  209.  
  210.  
  211. #if PRAGMA_STRUCT_ALIGN
  212.     #pragma options align=reset
  213. #elif PRAGMA_STRUCT_PACKPUSH
  214.     #pragma pack(pop)
  215. #elif PRAGMA_STRUCT_PACK
  216.     #pragma pack()
  217. #endif
  218.  
  219. #ifdef PRAGMA_IMPORT_OFF
  220. #pragma import off
  221. #elif PRAGMA_IMPORT
  222. #pragma import reset
  223. #endif
  224.  
  225. #ifdef __cplusplus
  226. }
  227. #endif
  228.  
  229. #endif /* __TEXTENCODINGPLUGIN__ */
  230.  
  231.