Team Fortress 2 Source Code as on 22/4/2020
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

3621 lines
132 KiB

  1. /*
  2. File: ImageCodec.h
  3. Contains: QuickTime Interfaces.
  4. Version: QuickTime 7.3
  5. Copyright: (c) 2007 (c) 1990-2007 by Apple Inc., all rights reserved
  6. Bugs?: For bug reports, consult the following page on
  7. the World Wide Web:
  8. http://developer.apple.com/bugreporter/
  9. */
  10. #ifndef __IMAGECODEC__
  11. #define __IMAGECODEC__
  12. #ifndef __MACTYPES__
  13. #include <MacTypes.h>
  14. #endif
  15. #ifndef __QUICKDRAW__
  16. #include <Quickdraw.h>
  17. #endif
  18. #ifndef __COMPONENTS__
  19. #include <Components.h>
  20. #endif
  21. #ifndef __IMAGECOMPRESSION__
  22. #include <ImageCompression.h>
  23. #endif
  24. #ifndef __MOVIES__
  25. #include <Movies.h>
  26. #endif
  27. #if PRAGMA_ONCE
  28. #pragma once
  29. #endif
  30. #ifdef __cplusplus
  31. extern "C" {
  32. #endif
  33. #if PRAGMA_IMPORT
  34. #pragma import on
  35. #endif
  36. #if PRAGMA_STRUCT_ALIGN
  37. #pragma options align=mac68k
  38. #elif PRAGMA_STRUCT_PACKPUSH
  39. #pragma pack(push, 2)
  40. #elif PRAGMA_STRUCT_PACK
  41. #pragma pack(2)
  42. #endif
  43. /* QuickTime is not available to 64-bit clients */
  44. #if !__LP64__
  45. /*
  46. The following GX types were previously in GXTypes.h, but that header
  47. is not available in any Mac OS X framework.
  48. */
  49. struct gxPoint {
  50. Fixed x;
  51. Fixed y;
  52. };
  53. typedef struct gxPoint gxPoint;
  54. struct gxPath {
  55. long vectors;
  56. long controlBits[1];
  57. gxPoint vector[1];
  58. };
  59. typedef struct gxPath gxPath;
  60. struct gxPaths {
  61. long contours;
  62. gxPath contour[1];
  63. };
  64. typedef struct gxPaths gxPaths;
  65. /* codec capabilities flags */
  66. enum {
  67. codecCanScale = 1L << 0,
  68. codecCanMask = 1L << 1,
  69. codecCanMatte = 1L << 2,
  70. codecCanTransform = 1L << 3,
  71. codecCanTransferMode = 1L << 4,
  72. codecCanCopyPrev = 1L << 5,
  73. codecCanSpool = 1L << 6,
  74. codecCanClipVertical = 1L << 7,
  75. codecCanClipRectangular = 1L << 8,
  76. codecCanRemapColor = 1L << 9,
  77. codecCanFastDither = 1L << 10,
  78. codecCanSrcExtract = 1L << 11,
  79. codecCanCopyPrevComp = 1L << 12,
  80. codecCanAsync = 1L << 13,
  81. codecCanMakeMask = 1L << 14,
  82. codecCanShift = 1L << 15,
  83. codecCanAsyncWhen = 1L << 16,
  84. codecCanShieldCursor = 1L << 17,
  85. codecCanManagePrevBuffer = 1L << 18,
  86. codecHasVolatileBuffer = 1L << 19, /* codec requires redraw after window movement */
  87. codecWantsRegionMask = 1L << 20,
  88. codecImageBufferIsOnScreen = 1L << 21, /* old def of codec using overlay surface, = ( codecIsDirectToScreenOnly | codecUsesOverlaySurface | codecImageBufferIsOverlaySurface | codecSrcMustBeImageBuffer ) */
  89. codecWantsDestinationPixels = 1L << 22,
  90. codecWantsSpecialScaling = 1L << 23,
  91. codecHandlesInputs = 1L << 24,
  92. codecCanDoIndirectSurface = 1L << 25, /* codec can handle indirect surface (GDI) */
  93. codecIsSequenceSensitive = 1L << 26,
  94. codecRequiresOffscreen = 1L << 27,
  95. codecRequiresMaskBits = 1L << 28,
  96. codecCanRemapResolution = 1L << 29,
  97. codecIsDirectToScreenOnly = 1L << 30, /* codec can only decompress data to the screen */
  98. codecCanLockSurface = 1L << 31 /* codec can lock destination surface, icm doesn't lock for you */
  99. };
  100. /* codec capabilities flags2 */
  101. enum {
  102. codecUsesOverlaySurface = 1L << 0, /* codec uses overlay surface */
  103. codecImageBufferIsOverlaySurface = 1L << 1, /* codec image buffer is overlay surface, the bits in the buffer are on the screen */
  104. codecSrcMustBeImageBuffer = 1L << 2, /* codec can only source data from an image buffer */
  105. codecImageBufferIsInAGPMemory = 1L << 4, /* codec image buffer is in AGP space, byte writes are OK */
  106. codecImageBufferIsInPCIMemory = 1L << 5, /* codec image buffer is across a PCI bus; byte writes are bad */
  107. codecImageBufferMemoryFlagsValid = 1L << 6, /* set by ImageCodecNewImageBufferMemory/NewImageGWorld to indicate that it set the AGP/PCI flags (supported in QuickTime 6.0 and later) */
  108. codecDrawsHigherQualityScaled = 1L << 7, /* codec will draw higher-quality image if it performs scaling (eg, wipe effect with border) */
  109. codecSupportsOutOfOrderDisplayTimes = 1L << 8, /* codec supports frames queued in one order for display in a different order, eg, IPB content */
  110. codecSupportsScheduledBackwardsPlaybackWithDifferenceFrames = 1L << 9 /* codec can use additional buffers to minimise redecoding during backwards playback */
  111. };
  112. struct CodecCapabilities {
  113. long flags;
  114. short wantedPixelSize;
  115. short extendWidth;
  116. short extendHeight;
  117. short bandMin;
  118. short bandInc;
  119. short pad;
  120. unsigned long time;
  121. long flags2; /* field new in QuickTime 4.0 */
  122. };
  123. typedef struct CodecCapabilities CodecCapabilities;
  124. /* codec condition flags */
  125. enum {
  126. codecConditionFirstBand = 1L << 0,
  127. codecConditionLastBand = 1L << 1,
  128. codecConditionFirstFrame = 1L << 2,
  129. codecConditionNewDepth = 1L << 3,
  130. codecConditionNewTransform = 1L << 4,
  131. codecConditionNewSrcRect = 1L << 5,
  132. codecConditionNewMask = 1L << 6,
  133. codecConditionNewMatte = 1L << 7,
  134. codecConditionNewTransferMode = 1L << 8,
  135. codecConditionNewClut = 1L << 9,
  136. codecConditionNewAccuracy = 1L << 10,
  137. codecConditionNewDestination = 1L << 11,
  138. codecConditionFirstScreen = 1L << 12,
  139. codecConditionDoCursor = 1L << 13,
  140. codecConditionCatchUpDiff = 1L << 14,
  141. codecConditionMaskMayBeChanged = 1L << 15,
  142. codecConditionToBuffer = 1L << 16,
  143. codecConditionCodecChangedMask = 1L << 31
  144. };
  145. enum {
  146. codecInfoResourceType = FOUR_CHAR_CODE('cdci'), /* codec info resource type */
  147. codecInterfaceVersion = 2 /* high word returned in component GetVersion */
  148. };
  149. struct CDSequenceDataSourceQueueEntry {
  150. void * nextBusy;
  151. long descSeed;
  152. Handle dataDesc;
  153. void * data;
  154. long dataSize;
  155. long useCount;
  156. TimeValue frameTime;
  157. TimeValue frameDuration;
  158. TimeValue timeScale;
  159. };
  160. typedef struct CDSequenceDataSourceQueueEntry CDSequenceDataSourceQueueEntry;
  161. typedef CDSequenceDataSourceQueueEntry * CDSequenceDataSourceQueueEntryPtr;
  162. struct CDSequenceDataSource {
  163. long recordSize;
  164. void * next;
  165. ImageSequence seqID;
  166. ImageSequenceDataSource sourceID;
  167. OSType sourceType;
  168. long sourceInputNumber;
  169. void * dataPtr;
  170. Handle dataDescription;
  171. long changeSeed;
  172. ICMConvertDataFormatUPP transferProc;
  173. void * transferRefcon;
  174. long dataSize;
  175. /* fields available in QT 3 and later */
  176. QHdrPtr dataQueue; /* queue of CDSequenceDataSourceQueueEntry structures*/
  177. void * originalDataPtr;
  178. long originalDataSize;
  179. Handle originalDataDescription;
  180. long originalDataDescriptionSeed;
  181. };
  182. typedef struct CDSequenceDataSource CDSequenceDataSource;
  183. typedef CDSequenceDataSource * CDSequenceDataSourcePtr;
  184. struct ICMFrameTimeInfo {
  185. wide startTime;
  186. long scale;
  187. long duration;
  188. };
  189. typedef struct ICMFrameTimeInfo ICMFrameTimeInfo;
  190. typedef ICMFrameTimeInfo * ICMFrameTimeInfoPtr;
  191. struct CodecCompressParams {
  192. ImageSequence sequenceID; /* precompress,bandcompress */
  193. ImageDescriptionHandle imageDescription; /* precompress,bandcompress */
  194. Ptr data;
  195. long bufferSize;
  196. long frameNumber;
  197. long startLine;
  198. long stopLine;
  199. long conditionFlags;
  200. CodecFlags callerFlags;
  201. CodecCapabilities * capabilities; /* precompress,bandcompress */
  202. ICMProgressProcRecord progressProcRecord;
  203. ICMCompletionProcRecord completionProcRecord;
  204. ICMFlushProcRecord flushProcRecord;
  205. PixMap srcPixMap; /* precompress,bandcompress */
  206. PixMap prevPixMap;
  207. CodecQ spatialQuality;
  208. CodecQ temporalQuality;
  209. Fixed similarity;
  210. DataRateParamsPtr dataRateParams;
  211. long reserved;
  212. /* The following fields only exist for QuickTime 2.1 and greater */
  213. UInt16 majorSourceChangeSeed;
  214. UInt16 minorSourceChangeSeed;
  215. CDSequenceDataSourcePtr sourceData;
  216. /* The following fields only exist for QuickTime 2.5 and greater */
  217. long preferredPacketSizeInBytes;
  218. /* The following fields only exist for QuickTime 3.0 and greater */
  219. long requestedBufferWidth; /* must set codecWantsSpecialScaling to indicate this field is valid*/
  220. long requestedBufferHeight; /* must set codecWantsSpecialScaling to indicate this field is valid*/
  221. /* The following fields only exist for QuickTime 4.0 and greater */
  222. OSType wantedSourcePixelType;
  223. /* The following fields only exist for QuickTime 5.0 and greater */
  224. long compressedDataSize; /* if nonzero, this overrides (*imageDescription)->dataSize*/
  225. UInt32 taskWeight; /* preferred weight for MP tasks implementing this operation*/
  226. OSType taskName; /* preferred name (type) for MP tasks implementing this operation*/
  227. };
  228. typedef struct CodecCompressParams CodecCompressParams;
  229. struct CodecDecompressParams {
  230. ImageSequence sequenceID; /* predecompress,banddecompress */
  231. ImageDescriptionHandle imageDescription; /* predecompress,banddecompress */
  232. Ptr data;
  233. long bufferSize;
  234. long frameNumber;
  235. long startLine;
  236. long stopLine;
  237. long conditionFlags;
  238. CodecFlags callerFlags;
  239. CodecCapabilities * capabilities; /* predecompress,banddecompress */
  240. ICMProgressProcRecord progressProcRecord;
  241. ICMCompletionProcRecord completionProcRecord;
  242. ICMDataProcRecord dataProcRecord;
  243. CGrafPtr port; /* predecompress,banddecompress */
  244. PixMap dstPixMap; /* predecompress,banddecompress */
  245. BitMapPtr maskBits;
  246. PixMapPtr mattePixMap;
  247. Rect srcRect; /* predecompress,banddecompress */
  248. MatrixRecord * matrix; /* predecompress,banddecompress */
  249. CodecQ accuracy; /* predecompress,banddecompress */
  250. short transferMode; /* predecompress,banddecompress */
  251. ICMFrameTimePtr frameTime; /* banddecompress */
  252. long reserved[1];
  253. /* The following fields only exist for QuickTime 2.0 and greater */
  254. SInt8 matrixFlags; /* high bit set if 2x resize */
  255. SInt8 matrixType;
  256. Rect dstRect; /* only valid for simple transforms */
  257. /* The following fields only exist for QuickTime 2.1 and greater */
  258. UInt16 majorSourceChangeSeed;
  259. UInt16 minorSourceChangeSeed;
  260. CDSequenceDataSourcePtr sourceData;
  261. RgnHandle maskRegion;
  262. /* The following fields only exist for QuickTime 2.5 and greater */
  263. OSType ** wantedDestinationPixelTypes; /* Handle to 0-terminated list of OSTypes */
  264. long screenFloodMethod;
  265. long screenFloodValue;
  266. short preferredOffscreenPixelSize;
  267. /* The following fields only exist for QuickTime 3.0 and greater */
  268. ICMFrameTimeInfoPtr syncFrameTime; /* banddecompress */
  269. Boolean needUpdateOnTimeChange; /* banddecompress */
  270. Boolean enableBlackLining;
  271. Boolean needUpdateOnSourceChange; /* band decompress */
  272. Boolean pad;
  273. long unused;
  274. CGrafPtr finalDestinationPort;
  275. long requestedBufferWidth; /* must set codecWantsSpecialScaling to indicate this field is valid*/
  276. long requestedBufferHeight; /* must set codecWantsSpecialScaling to indicate this field is valid*/
  277. /* The following fields only exist for QuickTime 4.0 and greater */
  278. Rect displayableAreaOfRequestedBuffer; /* set in predecompress*/
  279. Boolean requestedSingleField;
  280. Boolean needUpdateOnNextIdle;
  281. Boolean pad2[2];
  282. Fixed bufferGammaLevel;
  283. /* The following fields only exist for QuickTime 5.0 and greater */
  284. UInt32 taskWeight; /* preferred weight for MP tasks implementing this operation*/
  285. OSType taskName; /* preferred name (type) for MP tasks implementing this operation*/
  286. /* The following fields only exist for QuickTime 6.0 and greater */
  287. Boolean pad3;
  288. UInt8 destinationBufferMemoryPreference; /* a codec's PreDecompress/Preflight call can set this to express a preference about what kind of memory its destination buffer should go into. no guarantees.*/
  289. UInt8 codecBufferMemoryPreference; /* may indicate preferred kind of memory that NewImageGWorld/NewImageBufferMemory should create its buffer in, if applicable.*/
  290. Boolean onlyUseCodecIfItIsInUserPreferredCodecList; /* set to prevent this codec from being used unless it is in the userPreferredCodec list*/
  291. QTMediaContextID mediaContextID;
  292. /* The following fields only exist for QuickTime 6.5 and greater */
  293. UInt8 deinterlaceRequest; /* set by the ICM before PreDecompress/Preflight */
  294. UInt8 deinterlaceAnswer; /* codec should set this in PreDecompress/Preflight if it will satisfy the deinterlaceRequest */
  295. /* The following fields only exist for QuickTime 7.0 and greater */
  296. UInt8 pad4[2];
  297. long reserved2;
  298. UInt32 reserved3;
  299. long reserved4;
  300. void * reserved5;
  301. void * reserved6;
  302. void * reserved7;
  303. void * reserved8;
  304. };
  305. typedef struct CodecDecompressParams CodecDecompressParams;
  306. enum {
  307. matrixFlagScale2x = 1L << 7,
  308. matrixFlagScale1x = 1L << 6,
  309. matrixFlagScaleHalf = 1L << 5
  310. };
  311. enum {
  312. kScreenFloodMethodNone = 0,
  313. kScreenFloodMethodKeyColor = 1,
  314. kScreenFloodMethodAlpha = 2
  315. };
  316. enum {
  317. kFlushLastQueuedFrame = 0,
  318. kFlushFirstQueuedFrame = 1
  319. };
  320. enum {
  321. kNewImageGWorldErase = 1L << 0
  322. };
  323. /* values for destinationBufferMemoryPreference and codecBufferMemoryPreference */
  324. enum {
  325. kICMImageBufferNoPreference = 0,
  326. kICMImageBufferPreferMainMemory = 1,
  327. kICMImageBufferPreferVideoMemory = 2
  328. };
  329. /* values for deinterlaceRequest and deinterlaceAnswer */
  330. enum {
  331. kICMNoDeinterlacing = 0,
  332. kICMDeinterlaceFields = 1
  333. };
  334. typedef CALLBACK_API( void , ImageCodecTimeTriggerProcPtr )(void * refcon);
  335. typedef CALLBACK_API( void , ImageCodecDrawBandCompleteProcPtr )(void *refcon, ComponentResult drawBandResult, UInt32 drawBandCompleteFlags);
  336. typedef STACK_UPP_TYPE(ImageCodecTimeTriggerProcPtr) ImageCodecTimeTriggerUPP;
  337. typedef STACK_UPP_TYPE(ImageCodecDrawBandCompleteProcPtr) ImageCodecDrawBandCompleteUPP;
  338. /*
  339. * NewImageCodecTimeTriggerUPP()
  340. *
  341. * Availability:
  342. * Non-Carbon CFM: available as macro/inline
  343. * CarbonLib: in CarbonLib 1.0.2 and later
  344. * Mac OS X: in version 10.0 and later
  345. */
  346. EXTERN_API_C( ImageCodecTimeTriggerUPP )
  347. NewImageCodecTimeTriggerUPP(ImageCodecTimeTriggerProcPtr userRoutine);
  348. #if !OPAQUE_UPP_TYPES
  349. enum { uppImageCodecTimeTriggerProcInfo = 0x000000C0 }; /* pascal no_return_value Func(4_bytes) */
  350. #ifdef __cplusplus
  351. inline DEFINE_API_C(ImageCodecTimeTriggerUPP) NewImageCodecTimeTriggerUPP(ImageCodecTimeTriggerProcPtr userRoutine) { return (ImageCodecTimeTriggerUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecTimeTriggerProcInfo, GetCurrentArchitecture()); }
  352. #else
  353. #define NewImageCodecTimeTriggerUPP(userRoutine) (ImageCodecTimeTriggerUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecTimeTriggerProcInfo, GetCurrentArchitecture())
  354. #endif
  355. #endif
  356. /*
  357. * NewImageCodecDrawBandCompleteUPP()
  358. *
  359. * Availability:
  360. * Non-Carbon CFM: available as macro/inline
  361. * CarbonLib: in CarbonLib 1.3 and later
  362. * Mac OS X: in version 10.0 and later
  363. */
  364. EXTERN_API_C( ImageCodecDrawBandCompleteUPP )
  365. NewImageCodecDrawBandCompleteUPP(ImageCodecDrawBandCompleteProcPtr userRoutine);
  366. #if !OPAQUE_UPP_TYPES
  367. enum { uppImageCodecDrawBandCompleteProcInfo = 0x00000FC0 }; /* pascal no_return_value Func(4_bytes, 4_bytes, 4_bytes) */
  368. #ifdef __cplusplus
  369. inline DEFINE_API_C(ImageCodecDrawBandCompleteUPP) NewImageCodecDrawBandCompleteUPP(ImageCodecDrawBandCompleteProcPtr userRoutine) { return (ImageCodecDrawBandCompleteUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecDrawBandCompleteProcInfo, GetCurrentArchitecture()); }
  370. #else
  371. #define NewImageCodecDrawBandCompleteUPP(userRoutine) (ImageCodecDrawBandCompleteUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecDrawBandCompleteProcInfo, GetCurrentArchitecture())
  372. #endif
  373. #endif
  374. /*
  375. * DisposeImageCodecTimeTriggerUPP()
  376. *
  377. * Availability:
  378. * Non-Carbon CFM: available as macro/inline
  379. * CarbonLib: in CarbonLib 1.0.2 and later
  380. * Mac OS X: in version 10.0 and later
  381. */
  382. EXTERN_API_C( void )
  383. DisposeImageCodecTimeTriggerUPP(ImageCodecTimeTriggerUPP userUPP);
  384. #if !OPAQUE_UPP_TYPES
  385. #ifdef __cplusplus
  386. inline DEFINE_API_C(void) DisposeImageCodecTimeTriggerUPP(ImageCodecTimeTriggerUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
  387. #else
  388. #define DisposeImageCodecTimeTriggerUPP(userUPP) DisposeRoutineDescriptor(userUPP)
  389. #endif
  390. #endif
  391. /*
  392. * DisposeImageCodecDrawBandCompleteUPP()
  393. *
  394. * Availability:
  395. * Non-Carbon CFM: available as macro/inline
  396. * CarbonLib: in CarbonLib 1.3 and later
  397. * Mac OS X: in version 10.0 and later
  398. */
  399. EXTERN_API_C( void )
  400. DisposeImageCodecDrawBandCompleteUPP(ImageCodecDrawBandCompleteUPP userUPP);
  401. #if !OPAQUE_UPP_TYPES
  402. #ifdef __cplusplus
  403. inline DEFINE_API_C(void) DisposeImageCodecDrawBandCompleteUPP(ImageCodecDrawBandCompleteUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
  404. #else
  405. #define DisposeImageCodecDrawBandCompleteUPP(userUPP) DisposeRoutineDescriptor(userUPP)
  406. #endif
  407. #endif
  408. /*
  409. * InvokeImageCodecTimeTriggerUPP()
  410. *
  411. * Availability:
  412. * Non-Carbon CFM: available as macro/inline
  413. * CarbonLib: in CarbonLib 1.0.2 and later
  414. * Mac OS X: in version 10.0 and later
  415. */
  416. EXTERN_API_C( void )
  417. InvokeImageCodecTimeTriggerUPP(
  418. void * refcon,
  419. ImageCodecTimeTriggerUPP userUPP);
  420. #if !OPAQUE_UPP_TYPES
  421. #ifdef __cplusplus
  422. inline DEFINE_API_C(void) InvokeImageCodecTimeTriggerUPP(void * refcon, ImageCodecTimeTriggerUPP userUPP) { CALL_ONE_PARAMETER_UPP(userUPP, uppImageCodecTimeTriggerProcInfo, refcon); }
  423. #else
  424. #define InvokeImageCodecTimeTriggerUPP(refcon, userUPP) CALL_ONE_PARAMETER_UPP((userUPP), uppImageCodecTimeTriggerProcInfo, (refcon))
  425. #endif
  426. #endif
  427. /*
  428. * InvokeImageCodecDrawBandCompleteUPP()
  429. *
  430. * Availability:
  431. * Non-Carbon CFM: available as macro/inline
  432. * CarbonLib: in CarbonLib 1.3 and later
  433. * Mac OS X: in version 10.0 and later
  434. */
  435. EXTERN_API_C( void )
  436. InvokeImageCodecDrawBandCompleteUPP(
  437. void * refcon,
  438. ComponentResult drawBandResult,
  439. UInt32 drawBandCompleteFlags,
  440. ImageCodecDrawBandCompleteUPP userUPP);
  441. #if !OPAQUE_UPP_TYPES
  442. #ifdef __cplusplus
  443. inline DEFINE_API_C(void) InvokeImageCodecDrawBandCompleteUPP(void * refcon, ComponentResult drawBandResult, UInt32 drawBandCompleteFlags, ImageCodecDrawBandCompleteUPP userUPP) { CALL_THREE_PARAMETER_UPP(userUPP, uppImageCodecDrawBandCompleteProcInfo, refcon, drawBandResult, drawBandCompleteFlags); }
  444. #else
  445. #define InvokeImageCodecDrawBandCompleteUPP(refcon, drawBandResult, drawBandCompleteFlags, userUPP) CALL_THREE_PARAMETER_UPP((userUPP), uppImageCodecDrawBandCompleteProcInfo, (refcon), (drawBandResult), (drawBandCompleteFlags))
  446. #endif
  447. #endif
  448. #if CALL_NOT_IN_CARBON || OLDROUTINENAMES
  449. /* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
  450. #define NewImageCodecTimeTriggerProc(userRoutine) NewImageCodecTimeTriggerUPP(userRoutine)
  451. #define NewImageCodecDrawBandCompleteProc(userRoutine) NewImageCodecDrawBandCompleteUPP(userRoutine)
  452. #define CallImageCodecTimeTriggerProc(userRoutine, refcon) InvokeImageCodecTimeTriggerUPP(refcon, userRoutine)
  453. #define CallImageCodecDrawBandCompleteProc(userRoutine, refcon, drawBandResult, drawBandCompleteFlags) InvokeImageCodecDrawBandCompleteUPP(refcon, drawBandResult, drawBandCompleteFlags, userRoutine)
  454. #endif /* CALL_NOT_IN_CARBON */
  455. struct ImageSubCodecDecompressCapabilities {
  456. long recordSize; /* sizeof(ImageSubCodecDecompressCapabilities)*/
  457. long decompressRecordSize; /* size of your codec's decompress record*/
  458. Boolean canAsync; /* default true*/
  459. UInt8 pad0;
  460. /* The following field only exists for QuickTime 4.1 and greater */
  461. UInt16 suggestedQueueSize;
  462. /* The following field only exists for QuickTime 4.0 and greater */
  463. Boolean canProvideTrigger;
  464. /* The following fields only exist for QuickTime 5.0 and greater */
  465. Boolean subCodecFlushesScreen; /* only used on Mac OS X*/
  466. Boolean subCodecCallsDrawBandComplete;
  467. UInt8 pad2[1];
  468. /* The following fields only exist for QuickTime 5.0.1 and greater */
  469. Boolean isChildCodec; /* set by base codec before calling Initialize*/
  470. UInt8 reserved1;
  471. UInt8 pad4[1];
  472. /* The following fields only exist for QuickTime 7.0 and greater */
  473. Boolean subCodecIsMultiBufferAware; /* set if subcodec always draws using ImageSubCodecDecompressRecord.baseAddr/rowBytes passed to ImageCodecDrawBand, and always writes every pixel in the buffer*/
  474. Boolean subCodecSupportsOutOfOrderDisplayTimes;
  475. Boolean subCodecSupportsScheduledBackwardsPlaybackWithDifferenceFrames;
  476. Boolean subCodecNeedsHelpReportingNonDisplayableFrames;
  477. Boolean baseCodecShouldCallDecodeBandForAllFrames;
  478. UInt8 pad5[2];
  479. Boolean subCodecSupportsDrawInDecodeOrder; /* indicates that it's okay for the subcodec to get a single DrawBand call for each frame in decode order even when frames need reordering. (This will only happen when other circumstances allow it.)*/
  480. Boolean subCodecSupportsDecodeSmoothing; /* Frame-reordering subcodecs should set this to indicate that they can safely decode a non-droppable frame before drawing the previous non-droppable frame. This enables smoother playback in GWorlds.*/
  481. UInt8 pad6[4];
  482. };
  483. typedef struct ImageSubCodecDecompressCapabilities ImageSubCodecDecompressCapabilities;
  484. enum {
  485. kCodecFrameTypeUnknown = 0,
  486. kCodecFrameTypeKey = 1,
  487. kCodecFrameTypeDifference = 2,
  488. kCodecFrameTypeDroppableDifference = 3
  489. };
  490. struct ImageSubCodecDecompressRecord {
  491. Ptr baseAddr;
  492. long rowBytes;
  493. Ptr codecData;
  494. ICMProgressProcRecord progressProcRecord;
  495. ICMDataProcRecord dataProcRecord;
  496. void * userDecompressRecord; /* pointer to codec-specific per-band data*/
  497. UInt8 frameType;
  498. Boolean inhibitMP; /* set this in BeginBand to tell the base decompressor not to call DrawBand from an MP task for this frame. (Only has any effect for MP-capable subcodecs. New in QuickTime 5.0.)*/
  499. UInt8 pad[2];
  500. long priv[2];
  501. /* The following fields only exist for QuickTime 5.0 and greater */
  502. ImageCodecDrawBandCompleteUPP drawBandCompleteUPP; /* only used if subcodec set subCodecCallsDrawBandComplete; if drawBandCompleteUPP is non-nil, codec must call it when a frame is finished, but may return from DrawBand before the frame is finished. */
  503. void * drawBandCompleteRefCon; /* Note: do not call drawBandCompleteUPP directly from a hardware interrupt; instead, use DTInstall to run a function at deferred task time, and call drawBandCompleteUPP from that. */
  504. /* The following fields only exist for QuickTime 7.0 and greater */
  505. void * reserved1;
  506. long reserved2;
  507. long reserved3;
  508. };
  509. typedef struct ImageSubCodecDecompressRecord ImageSubCodecDecompressRecord;
  510. /*
  511. These data structures are used by code that wants to pass planar pixmap
  512. information around.
  513. The structure below gives the basic idea of what is being done.
  514. Normal instances of code will use a fixed number of planes (eg YUV420 uses
  515. three planes, Y, U and V). Each such code instance will define its own
  516. version of the PlanarPixMapInfo struct counting the number of planes it
  517. needs along with defining constants that specify the meanings of each
  518. plane.
  519. */
  520. struct PlanarComponentInfo {
  521. SInt32 offset;
  522. UInt32 rowBytes;
  523. };
  524. typedef struct PlanarComponentInfo PlanarComponentInfo;
  525. struct PlanarPixMapInfo {
  526. PlanarComponentInfo componentInfo[1];
  527. };
  528. typedef struct PlanarPixMapInfo PlanarPixMapInfo;
  529. struct PlanarPixmapInfoSorensonYUV9 {
  530. PlanarComponentInfo componentInfoY;
  531. PlanarComponentInfo componentInfoU;
  532. PlanarComponentInfo componentInfoV;
  533. };
  534. typedef struct PlanarPixmapInfoSorensonYUV9 PlanarPixmapInfoSorensonYUV9;
  535. struct PlanarPixmapInfoYUV420 {
  536. PlanarComponentInfo componentInfoY;
  537. PlanarComponentInfo componentInfoCb;
  538. PlanarComponentInfo componentInfoCr;
  539. };
  540. typedef struct PlanarPixmapInfoYUV420 PlanarPixmapInfoYUV420;
  541. enum {
  542. codecSuggestedBufferSentinel = FOUR_CHAR_CODE('sent') /* codec public resource containing suggested data pattern to put past end of data buffer */
  543. };
  544. /* name of parameters or effect -- placed in root container, required */
  545. enum {
  546. kParameterTitleName = FOUR_CHAR_CODE('name'),
  547. kParameterTitleID = 1
  548. };
  549. /* codec sub-type of parameters or effect -- placed in root container, required */
  550. enum {
  551. kParameterWhatName = FOUR_CHAR_CODE('what'),
  552. kParameterWhatID = 1
  553. };
  554. /* effect version -- placed in root container, optional, but recommended */
  555. enum {
  556. kParameterVersionName = FOUR_CHAR_CODE('vers'),
  557. kParameterVersionID = 1
  558. };
  559. /* is effect repeatable -- placed in root container, optional, default is TRUE*/
  560. enum {
  561. kParameterRepeatableName = FOUR_CHAR_CODE('pete'),
  562. kParameterRepeatableID = 1
  563. };
  564. enum {
  565. kParameterRepeatableTrue = 1,
  566. kParameterRepeatableFalse = 0
  567. };
  568. /* substitution codec in case effect is missing -- placed in root container, recommended */
  569. enum {
  570. kParameterAlternateCodecName = FOUR_CHAR_CODE('subs'),
  571. kParameterAlternateCodecID = 1
  572. };
  573. /* maximum number of sources -- placed in root container, required */
  574. enum {
  575. kParameterSourceCountName = FOUR_CHAR_CODE('srcs'),
  576. kParameterSourceCountID = 1
  577. };
  578. /* EFFECT CLASSES*/
  579. /*
  580. The effect major class defines the major grouping of the effect.
  581. Major classes are defined only by Apple and are not extendable by third
  582. parties. Major classes are used for filtering of the effect list by
  583. applications, but do not define what UI sub-group may or may not be
  584. presented to the user. For example, the major class may be a transition,
  585. but the minor class may be a wipe.
  586. */
  587. /*
  588. Effects that fail to include a
  589. kEffectMajorClassType will be classified as kMiscMajorClass.
  590. */
  591. enum {
  592. kEffectMajorClassType = FOUR_CHAR_CODE('clsa'),
  593. kEffectMajorClassID = 1
  594. };
  595. enum {
  596. kGeneratorMajorClass = FOUR_CHAR_CODE('genr'), /* zero source effects*/
  597. kFilterMajorClass = FOUR_CHAR_CODE('filt'), /* one source effects*/
  598. kTransitionMajorClass = FOUR_CHAR_CODE('tran'), /* multisource morph effects */
  599. kCompositorMajorClass = FOUR_CHAR_CODE('comp'), /* multisource layer effects*/
  600. kMiscMajorClass = FOUR_CHAR_CODE('misc') /* all other effects*/
  601. };
  602. /*
  603. The effect minor class defines the grouping of effects for the purposes
  604. of UI. Apple defines a set of minor classes and will extend it over
  605. time. Apple also provides strings within the UI for minor classes
  606. that it defines. Third party developers may either classify
  607. their effects as a type defined by Apple, or may define their own
  608. minor class. Effects which define a minor class of their own
  609. must also then supply a kEffectMinorClassNameType atom.
  610. */
  611. /*
  612. If a kEffectMinorClassNameType atom is present, but
  613. the minor type is one defined by Apple, the Apple supplied
  614. string will be used in the UI.
  615. */
  616. /*
  617. Effects that fail to supply a kEffectMinorClassType will be
  618. classified as kMiscMinorClass.
  619. */
  620. enum {
  621. kEffectMinorClassType = FOUR_CHAR_CODE('clsi'),
  622. kEffectMinorClassID = 1,
  623. kEffectMinorClassNameType = FOUR_CHAR_CODE('clsn'),
  624. kEffectMinorClassNameID = 1
  625. };
  626. enum {
  627. kGeneratorMinorClass = FOUR_CHAR_CODE('genr'), /* "Generators"*/
  628. kRenderMinorClass = FOUR_CHAR_CODE('rend'), /* "Render"*/
  629. kFilterMinorClass = FOUR_CHAR_CODE('filt'), /* "Filters"*/
  630. kArtisticMinorClass = FOUR_CHAR_CODE('arts'), /* "Artistic*/
  631. kBlurMinorClass = FOUR_CHAR_CODE('blur'), /* "Blur"*/
  632. kSharpenMinorClass = FOUR_CHAR_CODE('shrp'), /* "Sharpen"*/
  633. kDistortMinorClass = FOUR_CHAR_CODE('dist'), /* "Distort"*/
  634. kNoiseMinorClass = FOUR_CHAR_CODE('nois'), /* "Noise"*/
  635. kAdjustmentMinorClass = FOUR_CHAR_CODE('adst'), /* "Adjustments"*/
  636. kTransitionMinorClass = FOUR_CHAR_CODE('tran'), /* "Transitions"*/
  637. kWipeMinorClass = FOUR_CHAR_CODE('wipe'), /* "Wipes"*/
  638. k3DMinorClass = FOUR_CHAR_CODE('pzre'), /* "3D Transitions"*/
  639. kCompositorMinorClass = FOUR_CHAR_CODE('comp'), /* "Compositors"*/
  640. kEffectsMinorClass = FOUR_CHAR_CODE('fxfx'), /* "Special Effects"*/
  641. kMiscMinorClass = FOUR_CHAR_CODE('misc') /* "Miscellaneous"*/
  642. };
  643. /*
  644. Effects can define a number of "preset" values which will be presented to the user
  645. in a simplified UI. Each preset is an atom within the parameter description list
  646. and must have an atom ID from 1 going up sequentially. Inside of this atom are three other
  647. atoms containing:
  648. 1) the name of the preset as a Pascal string
  649. 2) a preview picture for the preset, 86 x 64 pixels in size
  650. 3) the ENTIRE set of parameter values needed to create a sample of this preset.
  651. */
  652. enum {
  653. kEffectPresetType = FOUR_CHAR_CODE('peff'),
  654. kPresetNameType = FOUR_CHAR_CODE('pnam'),
  655. kPresetNameID = 1,
  656. kPresetPreviewPictureType = FOUR_CHAR_CODE('ppct'),
  657. kPresetPreviewPictureID = 1,
  658. kPresetSettingsType = FOUR_CHAR_CODE('psst'),
  659. kPresetSettingsID = 1
  660. };
  661. enum {
  662. kParameterDependencyName = FOUR_CHAR_CODE('deep'),
  663. kParameterDependencyID = 1
  664. };
  665. enum {
  666. kParameterListDependsUponColorProfiles = FOUR_CHAR_CODE('prof'),
  667. kParameterListDependsUponFonts = FOUR_CHAR_CODE('font')
  668. };
  669. struct ParameterDependancyRecord {
  670. long dependCount;
  671. OSType depends[1];
  672. };
  673. typedef struct ParameterDependancyRecord ParameterDependancyRecord;
  674. /*
  675. enumeration list in container -- placed in root container, optional unless used by a
  676. parameter in the list
  677. */
  678. enum {
  679. kParameterEnumList = FOUR_CHAR_CODE('enum')
  680. };
  681. struct EnumValuePair {
  682. long value;
  683. Str255 name;
  684. };
  685. typedef struct EnumValuePair EnumValuePair;
  686. struct EnumListRecord {
  687. long enumCount; /* number of enumeration items to follow*/
  688. EnumValuePair values[1]; /* values and names for them, packed */
  689. };
  690. typedef struct EnumListRecord EnumListRecord;
  691. /* atom type of parameter*/
  692. enum {
  693. kParameterAtomTypeAndID = FOUR_CHAR_CODE('type')
  694. };
  695. enum {
  696. kNoAtom = FOUR_CHAR_CODE('none'), /* atom type for no data got/set*/
  697. kAtomNoFlags = 0x00000000,
  698. kAtomNotInterpolated = 0x00000001, /* atom can never be interpolated*/
  699. kAtomInterpolateIsOptional = 0x00000002, /* atom can be interpolated, but it is an advanced user operation*/
  700. kAtomMayBeIndexed = 0x00000004 /* more than one value of atom can exist with accending IDs (ie, lists of colors)*/
  701. };
  702. struct ParameterAtomTypeAndID {
  703. QTAtomType atomType; /* type of atom this data comes from/goes into*/
  704. QTAtomID atomID; /* ID of atom this data comes from/goes into*/
  705. long atomFlags; /* options for this atom*/
  706. Str255 atomName; /* name of this value type*/
  707. };
  708. typedef struct ParameterAtomTypeAndID ParameterAtomTypeAndID;
  709. /* optional specification of mapping between parameters and properties*/
  710. enum {
  711. kParameterProperty = FOUR_CHAR_CODE('prop')
  712. };
  713. struct ParameterProperty {
  714. OSType propertyClass; /* class to set for this property (0 for default which is specified by caller)*/
  715. OSType propertyID; /* id to set for this property (default is the atomType)*/
  716. };
  717. typedef struct ParameterProperty ParameterProperty;
  718. /* data type of a parameter*/
  719. enum {
  720. kParameterDataType = FOUR_CHAR_CODE('data')
  721. };
  722. enum {
  723. kParameterTypeDataLong = kTweenTypeLong, /* integer value*/
  724. kParameterTypeDataFixed = kTweenTypeFixed, /* fixed point value*/
  725. kParameterTypeDataRGBValue = kTweenTypeRGBColor, /* RGBColor data*/
  726. kParameterTypeDataDouble = kTweenTypeQTFloatDouble, /* IEEE 64 bit floating point value*/
  727. kParameterTypeDataText = FOUR_CHAR_CODE('text'), /* editable text item*/
  728. kParameterTypeDataEnum = FOUR_CHAR_CODE('enum'), /* enumerated lookup value*/
  729. kParameterTypeDataBitField = FOUR_CHAR_CODE('bool'), /* bit field value (something that holds boolean(s))*/
  730. kParameterTypeDataImage = FOUR_CHAR_CODE('imag') /* reference to an image via Picture data*/
  731. };
  732. struct ParameterDataType {
  733. OSType dataType; /* type of data this item is stored as*/
  734. };
  735. typedef struct ParameterDataType ParameterDataType;
  736. /*
  737. alternate (optional) data type -- main data type always required.
  738. Must be modified or deleted when modifying main data type.
  739. Main data type must be modified when alternate is modified.
  740. */
  741. enum {
  742. kParameterAlternateDataType = FOUR_CHAR_CODE('alt1'),
  743. kParameterTypeDataColorValue = FOUR_CHAR_CODE('cmlr'), /* CMColor data (supported on machines with ColorSync)*/
  744. kParameterTypeDataCubic = FOUR_CHAR_CODE('cubi'), /* cubic bezier(s) (no built-in support)*/
  745. kParameterTypeDataNURB = FOUR_CHAR_CODE('nurb') /* nurb(s) (no built-in support)*/
  746. };
  747. struct ParameterAlternateDataEntry {
  748. OSType dataType; /* type of data this item is stored as*/
  749. QTAtomType alternateAtom; /* where to store*/
  750. };
  751. typedef struct ParameterAlternateDataEntry ParameterAlternateDataEntry;
  752. struct ParameterAlternateDataType {
  753. long numEntries;
  754. ParameterAlternateDataEntry entries[1];
  755. };
  756. typedef struct ParameterAlternateDataType ParameterAlternateDataType;
  757. /* legal values for the parameter*/
  758. enum {
  759. kParameterDataRange = FOUR_CHAR_CODE('rang')
  760. };
  761. enum {
  762. kNoMinimumLongFixed = 0x7FFFFFFF, /* ignore minimum/maxiumum values*/
  763. kNoMaximumLongFixed = (long)0x80000000,
  764. kNoScaleLongFixed = 0, /* don't perform any scaling of value*/
  765. kNoPrecision = (-1) /* allow as many digits as format*/
  766. };
  767. /* 'text'*/
  768. struct StringRangeRecord {
  769. long maxChars; /* maximum length of string*/
  770. long maxLines; /* number of editing lines to use (1 typical, 0 to default)*/
  771. };
  772. typedef struct StringRangeRecord StringRangeRecord;
  773. /* 'long'*/
  774. struct LongRangeRecord {
  775. long minValue; /* no less than this*/
  776. long maxValue; /* no more than this*/
  777. long scaleValue; /* muliply content by this going in, divide going out*/
  778. long precisionDigits; /* # digits of precision when editing via typing*/
  779. };
  780. typedef struct LongRangeRecord LongRangeRecord;
  781. /* 'enum'*/
  782. struct EnumRangeRecord {
  783. long enumID; /* 'enum' list in root container to search within*/
  784. };
  785. typedef struct EnumRangeRecord EnumRangeRecord;
  786. /* 'fixd'*/
  787. struct FixedRangeRecord {
  788. Fixed minValue; /* no less than this*/
  789. Fixed maxValue; /* no more than this*/
  790. Fixed scaleValue; /* muliply content by this going in, divide going out*/
  791. long precisionDigits; /* # digits of precision when editing via typing*/
  792. };
  793. typedef struct FixedRangeRecord FixedRangeRecord;
  794. /* 'doub'*/
  795. #define kNoMinimumDouble (NAN) /* ignore minimum/maxiumum values */
  796. #define kNoMaximumDouble (NAN)
  797. #define kNoScaleDouble (0) /* don't perform any scaling of value */
  798. struct DoubleRangeRecord
  799. {
  800. QTFloatDouble minValue; /* no less than this */
  801. QTFloatDouble maxValue; /* no more than this */
  802. QTFloatDouble scaleValue; /* muliply content by this going in, divide going out */
  803. long precisionDigits; /* # digits of precision when editing via typing */
  804. };
  805. typedef struct DoubleRangeRecord DoubleRangeRecord;
  806. /* 'bool' */
  807. struct BooleanRangeRecord {
  808. long maskValue; /* value to mask on/off to set/clear the boolean*/
  809. };
  810. typedef struct BooleanRangeRecord BooleanRangeRecord;
  811. /* 'rgb '*/
  812. struct RGBRangeRecord {
  813. RGBColor minColor;
  814. RGBColor maxColor;
  815. };
  816. typedef struct RGBRangeRecord RGBRangeRecord;
  817. /* 'imag'*/
  818. enum {
  819. kParameterImageNoFlags = 0,
  820. kParameterImageIsPreset = 1
  821. };
  822. enum {
  823. kStandardPresetGroup = FOUR_CHAR_CODE('pset')
  824. };
  825. struct ImageRangeRecord {
  826. long imageFlags;
  827. OSType fileType; /* file type to contain the preset group (normally kStandardPresetGroup)*/
  828. long replacedAtoms; /* # atoms at this level replaced by this preset group*/
  829. };
  830. typedef struct ImageRangeRecord ImageRangeRecord;
  831. /* union of all of the above*/
  832. struct ParameterRangeRecord
  833. {
  834. union
  835. {
  836. LongRangeRecord longRange;
  837. EnumRangeRecord enumRange;
  838. FixedRangeRecord fixedRange;
  839. DoubleRangeRecord doubleRange;
  840. StringRangeRecord stringRange;
  841. BooleanRangeRecord booleanRange;
  842. RGBRangeRecord rgbRange;
  843. ImageRangeRecord imageRange;
  844. } u;
  845. };
  846. typedef struct ParameterRangeRecord ParameterRangeRecord;
  847. /* UI behavior of a parameter*/
  848. enum {
  849. kParameterDataBehavior = FOUR_CHAR_CODE('ditl')
  850. };
  851. enum {
  852. /* items edited via typing*/
  853. kParameterItemEditText = FOUR_CHAR_CODE('edit'), /* edit text box*/
  854. kParameterItemEditLong = FOUR_CHAR_CODE('long'), /* long number editing box*/
  855. kParameterItemEditFixed = FOUR_CHAR_CODE('fixd'), /* fixed point number editing box*/
  856. kParameterItemEditDouble = FOUR_CHAR_CODE('doub'), /* double number editing box*/
  857. /* items edited via control(s)*/
  858. kParameterItemPopUp = FOUR_CHAR_CODE('popu'), /* pop up value for enum types*/
  859. kParameterItemRadioCluster = FOUR_CHAR_CODE('radi'), /* radio cluster for enum types*/
  860. kParameterItemCheckBox = FOUR_CHAR_CODE('chex'), /* check box for booleans*/
  861. kParameterItemControl = FOUR_CHAR_CODE('cntl'), /* item controlled via a standard control of some type*/
  862. /* special user items*/
  863. kParameterItemLine = FOUR_CHAR_CODE('line'), /* line*/
  864. kParameterItemColorPicker = FOUR_CHAR_CODE('pick'), /* color swatch & picker*/
  865. kParameterItemGroupDivider = FOUR_CHAR_CODE('divi'), /* start of a new group of items*/
  866. kParameterItemStaticText = FOUR_CHAR_CODE('stat'), /* display "parameter name" as static text*/
  867. kParameterItemDragImage = FOUR_CHAR_CODE('imag'), /* allow image display, along with drag and drop*/
  868. /* flags valid for lines and groups*/
  869. kGraphicsNoFlags = 0x00000000, /* no options for graphics*/
  870. kGraphicsFlagsGray = 0x00000001, /* draw lines with gray*/
  871. /* flags valid for groups*/
  872. kGroupNoFlags = 0x00000000, /* no options for group -- may be combined with graphics options */
  873. kGroupAlignText = 0x00010000, /* edit text items in group have the same size*/
  874. kGroupSurroundBox = 0x00020000, /* group should be surrounded with a box*/
  875. kGroupMatrix = 0x00040000, /* side-by-side arrangement of group is okay*/
  876. kGroupNoName = 0x00080000, /* name of group should not be displayed above box*/
  877. /* flags valid for popup/radiocluster/checkbox/control*/
  878. kDisableControl = 0x00000001,
  879. kDisableWhenNotEqual = (0x00000000 + kDisableControl),
  880. kDisableWhenEqual = (0x00000010 + kDisableControl),
  881. kDisableWhenLessThan = (0x00000020 + kDisableControl),
  882. kDisableWhenGreaterThan = (0x00000030 + kDisableControl), /* flags valid for controls*/
  883. kCustomControl = 0x00100000, /* flags valid for popups*/
  884. kPopupStoreAsString = 0x00010000
  885. };
  886. struct ControlBehaviors {
  887. QTAtomID groupID; /* group under control of this item*/
  888. long controlValue; /* control value for comparison purposes*/
  889. QTAtomType customType; /* custom type identifier, for kCustomControl*/
  890. QTAtomID customID; /* custom type ID, for kCustomControl*/
  891. };
  892. typedef struct ControlBehaviors ControlBehaviors;
  893. struct ParameterDataBehavior {
  894. OSType behaviorType;
  895. long behaviorFlags;
  896. union {
  897. ControlBehaviors controls;
  898. } u;
  899. };
  900. typedef struct ParameterDataBehavior ParameterDataBehavior;
  901. /* higher level purpose of a parameter or set of parameters*/
  902. enum {
  903. kParameterDataUsage = FOUR_CHAR_CODE('use ')
  904. };
  905. enum {
  906. kParameterUsagePixels = FOUR_CHAR_CODE('pixl'),
  907. kParameterUsageRectangle = FOUR_CHAR_CODE('rect'),
  908. kParameterUsagePoint = FOUR_CHAR_CODE('xy '),
  909. kParameterUsage3DPoint = FOUR_CHAR_CODE('xyz '),
  910. kParameterUsageDegrees = FOUR_CHAR_CODE('degr'),
  911. kParameterUsageRadians = FOUR_CHAR_CODE('rads'),
  912. kParameterUsagePercent = FOUR_CHAR_CODE('pcnt'),
  913. kParameterUsageSeconds = FOUR_CHAR_CODE('secs'),
  914. kParameterUsageMilliseconds = FOUR_CHAR_CODE('msec'),
  915. kParameterUsageMicroseconds = 0xB5736563,
  916. kParameterUsage3by3Matrix = FOUR_CHAR_CODE('3by3'),
  917. kParameterUsageCircularDegrees = FOUR_CHAR_CODE('degc'),
  918. kParameterUsageCircularRadians = FOUR_CHAR_CODE('radc')
  919. };
  920. struct ParameterDataUsage {
  921. OSType usageType; /* higher level purpose of the data or group*/
  922. };
  923. typedef struct ParameterDataUsage ParameterDataUsage;
  924. /* default value(s) for a parameter*/
  925. enum {
  926. kParameterDataDefaultItem = FOUR_CHAR_CODE('dflt')
  927. };
  928. /* atoms that help to fill in data within the info window */
  929. enum {
  930. kParameterInfoLongName = 0xA96E616D,
  931. kParameterInfoCopyright = 0xA9637079,
  932. kParameterInfoDescription = 0xA9696E66,
  933. kParameterInfoWindowTitle = 0xA9776E74,
  934. kParameterInfoPicture = 0xA9706978,
  935. kParameterInfoManufacturer = 0xA96D616E,
  936. kParameterInfoIDs = 1
  937. };
  938. /* flags for ImageCodecValidateParameters */
  939. enum {
  940. kParameterValidationNoFlags = 0x00000000,
  941. kParameterValidationFinalValidation = 0x00000001
  942. };
  943. typedef long QTParameterValidationOptions;
  944. /* QTAtomTypes for atoms in image compressor settings containers*/
  945. enum {
  946. kImageCodecSettingsFieldCount = FOUR_CHAR_CODE('fiel'), /* Number of fields (UInt8) */
  947. kImageCodecSettingsFieldOrdering = FOUR_CHAR_CODE('fdom'), /* Ordering of fields (UInt8)*/
  948. kImageCodecSettingsFieldOrderingF1F2 = 1,
  949. kImageCodecSettingsFieldOrderingF2F1 = 2
  950. };
  951. /*
  952. * Summary:
  953. * Additional Image Description Extensions
  954. */
  955. enum {
  956. /*
  957. * Image description extension describing the color properties.
  958. */
  959. kColorInfoImageDescriptionExtension = FOUR_CHAR_CODE('colr'),
  960. /*
  961. * Image description extension describing the pixel aspect ratio.
  962. */
  963. kPixelAspectRatioImageDescriptionExtension = FOUR_CHAR_CODE('pasp'), /* big-endian PixelAspectRatioImageDescriptionExtension */
  964. /*
  965. * Image description extension describing the clean aperture.
  966. */
  967. kCleanApertureImageDescriptionExtension = FOUR_CHAR_CODE('clap'), /* big-endian CleanApertureImageDescriptionExtension */
  968. /*
  969. * Specifies the offset in bytes from the start of one pixel row to
  970. * the next. Only valid for chunky pixel formats. If present, this
  971. * image description extension overrides other conventions for
  972. * calculating rowBytes.
  973. */
  974. kQTRowBytesImageDescriptionExtension = FOUR_CHAR_CODE('rowb') /* big-endian SInt32 */
  975. };
  976. /* Color Info Image Description Extension types*/
  977. enum {
  978. kVideoColorInfoImageDescriptionExtensionType = FOUR_CHAR_CODE('nclc'), /* For video color descriptions (defined below) */
  979. kICCProfileColorInfoImageDescriptionExtensionType = FOUR_CHAR_CODE('prof') /* For ICC Profile color descriptions (not defined here)*/
  980. };
  981. /* Video Color Info Image Description Extensions*/
  982. struct NCLCColorInfoImageDescriptionExtension {
  983. OSType colorParamType; /* Type of color parameter 'nclc' */
  984. UInt16 primaries; /* CIE 1931 xy chromaticity coordinates */
  985. UInt16 transferFunction; /* Nonlinear transfer function from RGB to ErEgEb */
  986. UInt16 matrix; /* Matrix from ErEgEb to EyEcbEcr */
  987. };
  988. typedef struct NCLCColorInfoImageDescriptionExtension NCLCColorInfoImageDescriptionExtension;
  989. /* Primaries*/
  990. enum {
  991. kQTPrimaries_ITU_R709_2 = 1, /* ITU-R BT.709-2, SMPTE 274M-1995, and SMPTE 296M-1997 */
  992. kQTPrimaries_Unknown = 2, /* Unknown */
  993. kQTPrimaries_EBU_3213 = 5, /* EBU Tech. 3213 (1981) */
  994. kQTPrimaries_SMPTE_C = 6 /* SMPTE C Primaries from SMPTE RP 145-1993 */
  995. };
  996. /* Transfer Function*/
  997. enum {
  998. kQTTransferFunction_ITU_R709_2 = 1, /* Recommendation ITU-R BT.709-2, SMPTE 274M-1995, SMPTE 296M-1997, SMPTE 293M-1996 and SMPTE 170M-1994 */
  999. kQTTransferFunction_Unknown = 2, /* Unknown */
  1000. kQTTransferFunction_SMPTE_240M_1995 = 7 /* SMPTE 240M-1995 and interim color implementation of SMPTE 274M-1995 */
  1001. };
  1002. /* Matrix*/
  1003. enum {
  1004. kQTMatrix_ITU_R_709_2 = 1, /* Recommendation ITU-R BT.709-2 (1125/60/2:1 only), SMPTE 274M-1995 and SMPTE 296M-1997 */
  1005. kQTMatrix_Unknown = 2, /* Unknown */
  1006. kQTMatrix_ITU_R_601_4 = 6, /* Recommendation ITU-R BT.601-4, Recommendation ITU-R BT.470-4 System B and G, SMPTE 170M-1994 and SMPTE 293M-1996 */
  1007. kQTMatrix_SMPTE_240M_1995 = 7 /* SMPTE 240M-1995 and interim color implementation of SMPTE 274M-1995 */
  1008. };
  1009. /* Field/Frame Info Image Description (this remaps to FieldInfoImageDescriptionExtension)*/
  1010. struct FieldInfoImageDescriptionExtension2 {
  1011. UInt8 fields;
  1012. UInt8 detail;
  1013. };
  1014. typedef struct FieldInfoImageDescriptionExtension2 FieldInfoImageDescriptionExtension2;
  1015. enum {
  1016. kQTFieldsProgressiveScan = 1,
  1017. kQTFieldsInterlaced = 2
  1018. };
  1019. enum {
  1020. kQTFieldDetailUnknown = 0,
  1021. kQTFieldDetailTemporalTopFirst = 1,
  1022. kQTFieldDetailTemporalBottomFirst = 6,
  1023. kQTFieldDetailSpatialFirstLineEarly = 9,
  1024. kQTFieldDetailSpatialFirstLineLate = 14
  1025. };
  1026. /* Pixel Aspect Ratio Image Description Extensions*/
  1027. struct PixelAspectRatioImageDescriptionExtension {
  1028. UInt32 hSpacing; /* Horizontal Spacing */
  1029. UInt32 vSpacing; /* Vertical Spacing */
  1030. };
  1031. typedef struct PixelAspectRatioImageDescriptionExtension PixelAspectRatioImageDescriptionExtension;
  1032. /* Clean Aperture Image Description Extensions*/
  1033. struct CleanApertureImageDescriptionExtension {
  1034. UInt32 cleanApertureWidthN; /* width of clean aperture, numerator, denominator */
  1035. UInt32 cleanApertureWidthD;
  1036. UInt32 cleanApertureHeightN; /* height of clean aperture, numerator, denominator*/
  1037. UInt32 cleanApertureHeightD;
  1038. SInt32 horizOffN; /* horizontal offset of clean aperture center minus (width-1)/2, numerator, denominator */
  1039. UInt32 horizOffD;
  1040. SInt32 vertOffN; /* vertical offset of clean aperture center minus (height-1)/2, numerator, denominator */
  1041. UInt32 vertOffD;
  1042. };
  1043. typedef struct CleanApertureImageDescriptionExtension CleanApertureImageDescriptionExtension;
  1044. typedef CALLBACK_API( ComponentResult , ImageCodecMPDrawBandProcPtr )(void *refcon, ImageSubCodecDecompressRecord *drp);
  1045. typedef STACK_UPP_TYPE(ImageCodecMPDrawBandProcPtr) ImageCodecMPDrawBandUPP;
  1046. /*
  1047. * NewImageCodecMPDrawBandUPP()
  1048. *
  1049. * Availability:
  1050. * Non-Carbon CFM: available as macro/inline
  1051. * CarbonLib: in CarbonLib 1.0 and later
  1052. * Mac OS X: in version 10.0 and later
  1053. */
  1054. EXTERN_API_C( ImageCodecMPDrawBandUPP )
  1055. NewImageCodecMPDrawBandUPP(ImageCodecMPDrawBandProcPtr userRoutine);
  1056. #if !OPAQUE_UPP_TYPES
  1057. enum { uppImageCodecMPDrawBandProcInfo = 0x000003F0 }; /* pascal 4_bytes Func(4_bytes, 4_bytes) */
  1058. #ifdef __cplusplus
  1059. inline DEFINE_API_C(ImageCodecMPDrawBandUPP) NewImageCodecMPDrawBandUPP(ImageCodecMPDrawBandProcPtr userRoutine) { return (ImageCodecMPDrawBandUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecMPDrawBandProcInfo, GetCurrentArchitecture()); }
  1060. #else
  1061. #define NewImageCodecMPDrawBandUPP(userRoutine) (ImageCodecMPDrawBandUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppImageCodecMPDrawBandProcInfo, GetCurrentArchitecture())
  1062. #endif
  1063. #endif
  1064. /*
  1065. * DisposeImageCodecMPDrawBandUPP()
  1066. *
  1067. * Availability:
  1068. * Non-Carbon CFM: available as macro/inline
  1069. * CarbonLib: in CarbonLib 1.0 and later
  1070. * Mac OS X: in version 10.0 and later
  1071. */
  1072. EXTERN_API_C( void )
  1073. DisposeImageCodecMPDrawBandUPP(ImageCodecMPDrawBandUPP userUPP);
  1074. #if !OPAQUE_UPP_TYPES
  1075. #ifdef __cplusplus
  1076. inline DEFINE_API_C(void) DisposeImageCodecMPDrawBandUPP(ImageCodecMPDrawBandUPP userUPP) { DisposeRoutineDescriptor((UniversalProcPtr)userUPP); }
  1077. #else
  1078. #define DisposeImageCodecMPDrawBandUPP(userUPP) DisposeRoutineDescriptor(userUPP)
  1079. #endif
  1080. #endif
  1081. /*
  1082. * InvokeImageCodecMPDrawBandUPP()
  1083. *
  1084. * Availability:
  1085. * Non-Carbon CFM: available as macro/inline
  1086. * CarbonLib: in CarbonLib 1.0 and later
  1087. * Mac OS X: in version 10.0 and later
  1088. */
  1089. EXTERN_API_C( ComponentResult )
  1090. InvokeImageCodecMPDrawBandUPP(
  1091. void * refcon,
  1092. ImageSubCodecDecompressRecord * drp,
  1093. ImageCodecMPDrawBandUPP userUPP);
  1094. #if !OPAQUE_UPP_TYPES
  1095. #ifdef __cplusplus
  1096. inline DEFINE_API_C(ComponentResult) InvokeImageCodecMPDrawBandUPP(void * refcon, ImageSubCodecDecompressRecord * drp, ImageCodecMPDrawBandUPP userUPP) { return (ComponentResult)CALL_TWO_PARAMETER_UPP(userUPP, uppImageCodecMPDrawBandProcInfo, refcon, drp); }
  1097. #else
  1098. #define InvokeImageCodecMPDrawBandUPP(refcon, drp, userUPP) (ComponentResult)CALL_TWO_PARAMETER_UPP((userUPP), uppImageCodecMPDrawBandProcInfo, (refcon), (drp))
  1099. #endif
  1100. #endif
  1101. #if CALL_NOT_IN_CARBON || OLDROUTINENAMES
  1102. /* support for pre-Carbon UPP routines: New...Proc and Call...Proc */
  1103. #define NewImageCodecMPDrawBandProc(userRoutine) NewImageCodecMPDrawBandUPP(userRoutine)
  1104. #define CallImageCodecMPDrawBandProc(userRoutine, refcon, drp) InvokeImageCodecMPDrawBandUPP(refcon, drp, userRoutine)
  1105. #endif /* CALL_NOT_IN_CARBON */
  1106. /* codec selectors 0-127 are reserved by Apple */
  1107. /* codec selectors 128-191 are subtype specific */
  1108. /* codec selectors 192-255 are vendor specific */
  1109. /* codec selectors 256-511 are available for general use */
  1110. /* codec selectors 512-1023 are reserved by Apple */
  1111. /* codec selectors 1024-32767 are available for general use */
  1112. /* negative selectors are reserved by the Component Manager */
  1113. /*
  1114. * ImageCodecGetCodecInfo()
  1115. *
  1116. * Availability:
  1117. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1118. * CarbonLib: in CarbonLib 1.0 and later
  1119. * Mac OS X: in version 10.0 and later
  1120. * Windows: in qtmlClient.lib 3.0 and later
  1121. */
  1122. EXTERN_API( ComponentResult )
  1123. ImageCodecGetCodecInfo(
  1124. ComponentInstance ci,
  1125. CodecInfo * info) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0000, 0x7000, 0xA82A);
  1126. /*
  1127. * ImageCodecGetCompressionTime()
  1128. *
  1129. * Availability:
  1130. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1131. * CarbonLib: in CarbonLib 1.0 and later
  1132. * Mac OS X: in version 10.0 and later
  1133. * Windows: in qtmlClient.lib 3.0 and later
  1134. */
  1135. EXTERN_API( ComponentResult )
  1136. ImageCodecGetCompressionTime(
  1137. ComponentInstance ci,
  1138. PixMapHandle src,
  1139. const Rect * srcRect,
  1140. short depth,
  1141. CodecQ * spatialQuality,
  1142. CodecQ * temporalQuality,
  1143. unsigned long * time) FIVEWORDINLINE(0x2F3C, 0x0016, 0x0001, 0x7000, 0xA82A);
  1144. /*
  1145. * ImageCodecGetMaxCompressionSize()
  1146. *
  1147. * Availability:
  1148. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1149. * CarbonLib: in CarbonLib 1.0 and later
  1150. * Mac OS X: in version 10.0 and later
  1151. * Windows: in qtmlClient.lib 3.0 and later
  1152. */
  1153. EXTERN_API( ComponentResult )
  1154. ImageCodecGetMaxCompressionSize(
  1155. ComponentInstance ci,
  1156. PixMapHandle src,
  1157. const Rect * srcRect,
  1158. short depth,
  1159. CodecQ quality,
  1160. long * size) FIVEWORDINLINE(0x2F3C, 0x0012, 0x0002, 0x7000, 0xA82A);
  1161. /*
  1162. * ImageCodecPreCompress()
  1163. *
  1164. * Availability:
  1165. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1166. * CarbonLib: in CarbonLib 1.0 and later
  1167. * Mac OS X: in version 10.0 and later
  1168. * Windows: in qtmlClient.lib 3.0 and later
  1169. */
  1170. EXTERN_API( ComponentResult )
  1171. ImageCodecPreCompress(
  1172. ComponentInstance ci,
  1173. CodecCompressParams * params) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0003, 0x7000, 0xA82A);
  1174. /*
  1175. * ImageCodecBandCompress()
  1176. *
  1177. * Availability:
  1178. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1179. * CarbonLib: in CarbonLib 1.0 and later
  1180. * Mac OS X: in version 10.0 and later
  1181. * Windows: in qtmlClient.lib 3.0 and later
  1182. */
  1183. EXTERN_API( ComponentResult )
  1184. ImageCodecBandCompress(
  1185. ComponentInstance ci,
  1186. CodecCompressParams * params) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0004, 0x7000, 0xA82A);
  1187. /*
  1188. * ImageCodecPreDecompress()
  1189. *
  1190. * Availability:
  1191. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1192. * CarbonLib: in CarbonLib 1.0 and later
  1193. * Mac OS X: in version 10.0 and later
  1194. * Windows: in qtmlClient.lib 3.0 and later
  1195. */
  1196. EXTERN_API( ComponentResult )
  1197. ImageCodecPreDecompress(
  1198. ComponentInstance ci,
  1199. CodecDecompressParams * params) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0005, 0x7000, 0xA82A);
  1200. /*
  1201. * ImageCodecBandDecompress()
  1202. *
  1203. * Availability:
  1204. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1205. * CarbonLib: in CarbonLib 1.0 and later
  1206. * Mac OS X: in version 10.0 and later
  1207. * Windows: in qtmlClient.lib 3.0 and later
  1208. */
  1209. EXTERN_API( ComponentResult )
  1210. ImageCodecBandDecompress(
  1211. ComponentInstance ci,
  1212. CodecDecompressParams * params) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0006, 0x7000, 0xA82A);
  1213. /*
  1214. * ImageCodecBusy()
  1215. *
  1216. * Availability:
  1217. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1218. * CarbonLib: in CarbonLib 1.0 and later
  1219. * Mac OS X: in version 10.0 and later
  1220. * Windows: in qtmlClient.lib 3.0 and later
  1221. */
  1222. EXTERN_API( ComponentResult )
  1223. ImageCodecBusy(
  1224. ComponentInstance ci,
  1225. ImageSequence seq) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0007, 0x7000, 0xA82A);
  1226. /*
  1227. * ImageCodecGetCompressedImageSize()
  1228. *
  1229. * Availability:
  1230. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1231. * CarbonLib: in CarbonLib 1.0 and later
  1232. * Mac OS X: in version 10.0 and later
  1233. * Windows: in qtmlClient.lib 3.0 and later
  1234. */
  1235. EXTERN_API( ComponentResult )
  1236. ImageCodecGetCompressedImageSize(
  1237. ComponentInstance ci,
  1238. ImageDescriptionHandle desc,
  1239. Ptr data,
  1240. long bufferSize,
  1241. ICMDataProcRecordPtr dataProc,
  1242. long * dataSize) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0008, 0x7000, 0xA82A);
  1243. /*
  1244. * ImageCodecGetSimilarity()
  1245. *
  1246. * Availability:
  1247. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1248. * CarbonLib: in CarbonLib 1.0 and later
  1249. * Mac OS X: in version 10.0 and later
  1250. * Windows: in qtmlClient.lib 3.0 and later
  1251. */
  1252. EXTERN_API( ComponentResult )
  1253. ImageCodecGetSimilarity(
  1254. ComponentInstance ci,
  1255. PixMapHandle src,
  1256. const Rect * srcRect,
  1257. ImageDescriptionHandle desc,
  1258. Ptr data,
  1259. Fixed * similarity) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0009, 0x7000, 0xA82A);
  1260. /*
  1261. * ImageCodecTrimImage()
  1262. *
  1263. * Availability:
  1264. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1265. * CarbonLib: in CarbonLib 1.0 and later
  1266. * Mac OS X: in version 10.0 and later
  1267. * Windows: in qtmlClient.lib 3.0 and later
  1268. */
  1269. EXTERN_API( ComponentResult )
  1270. ImageCodecTrimImage(
  1271. ComponentInstance ci,
  1272. ImageDescriptionHandle Desc,
  1273. Ptr inData,
  1274. long inBufferSize,
  1275. ICMDataProcRecordPtr dataProc,
  1276. Ptr outData,
  1277. long outBufferSize,
  1278. ICMFlushProcRecordPtr flushProc,
  1279. Rect * trimRect,
  1280. ICMProgressProcRecordPtr progressProc) FIVEWORDINLINE(0x2F3C, 0x0024, 0x000A, 0x7000, 0xA82A);
  1281. /*
  1282. * ImageCodecRequestSettings()
  1283. *
  1284. * Availability:
  1285. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1286. * CarbonLib: in CarbonLib 1.0 and later
  1287. * Mac OS X: in version 10.0 and later
  1288. * Windows: in qtmlClient.lib 3.0 and later
  1289. */
  1290. EXTERN_API( ComponentResult )
  1291. ImageCodecRequestSettings(
  1292. ComponentInstance ci,
  1293. Handle settings,
  1294. Rect * rp,
  1295. ModalFilterUPP filterProc) FIVEWORDINLINE(0x2F3C, 0x000C, 0x000B, 0x7000, 0xA82A);
  1296. /*
  1297. * ImageCodecGetSettings()
  1298. *
  1299. * Availability:
  1300. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1301. * CarbonLib: in CarbonLib 1.0 and later
  1302. * Mac OS X: in version 10.0 and later
  1303. * Windows: in qtmlClient.lib 3.0 and later
  1304. */
  1305. EXTERN_API( ComponentResult )
  1306. ImageCodecGetSettings(
  1307. ComponentInstance ci,
  1308. Handle settings) FIVEWORDINLINE(0x2F3C, 0x0004, 0x000C, 0x7000, 0xA82A);
  1309. /*
  1310. * ImageCodecSetSettings()
  1311. *
  1312. * Availability:
  1313. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1314. * CarbonLib: in CarbonLib 1.0 and later
  1315. * Mac OS X: in version 10.0 and later
  1316. * Windows: in qtmlClient.lib 3.0 and later
  1317. */
  1318. EXTERN_API( ComponentResult )
  1319. ImageCodecSetSettings(
  1320. ComponentInstance ci,
  1321. Handle settings) FIVEWORDINLINE(0x2F3C, 0x0004, 0x000D, 0x7000, 0xA82A);
  1322. /*
  1323. * ImageCodecFlush()
  1324. *
  1325. * Availability:
  1326. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1327. * CarbonLib: in CarbonLib 1.0 and later
  1328. * Mac OS X: in version 10.0 and later
  1329. * Windows: in qtmlClient.lib 3.0 and later
  1330. */
  1331. EXTERN_API( ComponentResult )
  1332. ImageCodecFlush(ComponentInstance ci) FIVEWORDINLINE(0x2F3C, 0x0000, 0x000E, 0x7000, 0xA82A);
  1333. /*
  1334. * ImageCodecSetTimeCode()
  1335. *
  1336. * Availability:
  1337. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1338. * CarbonLib: in CarbonLib 1.0 and later
  1339. * Mac OS X: in version 10.0 and later
  1340. * Windows: in qtmlClient.lib 3.0 and later
  1341. */
  1342. EXTERN_API( ComponentResult )
  1343. ImageCodecSetTimeCode(
  1344. ComponentInstance ci,
  1345. void * timeCodeFormat,
  1346. void * timeCodeTime) FIVEWORDINLINE(0x2F3C, 0x0008, 0x000F, 0x7000, 0xA82A);
  1347. /*
  1348. * ImageCodecIsImageDescriptionEquivalent()
  1349. *
  1350. * Availability:
  1351. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1352. * CarbonLib: in CarbonLib 1.0 and later
  1353. * Mac OS X: in version 10.0 and later
  1354. * Windows: in qtmlClient.lib 3.0 and later
  1355. */
  1356. EXTERN_API( ComponentResult )
  1357. ImageCodecIsImageDescriptionEquivalent(
  1358. ComponentInstance ci,
  1359. ImageDescriptionHandle newDesc,
  1360. Boolean * equivalent) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0010, 0x7000, 0xA82A);
  1361. /*
  1362. * ImageCodecNewMemory()
  1363. *
  1364. * Availability:
  1365. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1366. * CarbonLib: in CarbonLib 1.0 and later
  1367. * Mac OS X: in version 10.0 and later
  1368. * Windows: in qtmlClient.lib 3.0 and later
  1369. */
  1370. EXTERN_API( ComponentResult )
  1371. ImageCodecNewMemory(
  1372. ComponentInstance ci,
  1373. Ptr * data,
  1374. Size dataSize,
  1375. long dataUse,
  1376. ICMMemoryDisposedUPP memoryGoneProc,
  1377. void * refCon) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0011, 0x7000, 0xA82A);
  1378. /*
  1379. * ImageCodecDisposeMemory()
  1380. *
  1381. * Availability:
  1382. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1383. * CarbonLib: in CarbonLib 1.0 and later
  1384. * Mac OS X: in version 10.0 and later
  1385. * Windows: in qtmlClient.lib 3.0 and later
  1386. */
  1387. EXTERN_API( ComponentResult )
  1388. ImageCodecDisposeMemory(
  1389. ComponentInstance ci,
  1390. Ptr data) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0012, 0x7000, 0xA82A);
  1391. /*
  1392. * ImageCodecHitTestData()
  1393. *
  1394. * Availability:
  1395. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1396. * CarbonLib: in CarbonLib 1.0 and later
  1397. * Mac OS X: in version 10.0 and later
  1398. * Windows: in qtmlClient.lib 3.0 and later
  1399. */
  1400. EXTERN_API( ComponentResult )
  1401. ImageCodecHitTestData(
  1402. ComponentInstance ci,
  1403. ImageDescriptionHandle desc,
  1404. void * data,
  1405. Size dataSize,
  1406. Point where,
  1407. Boolean * hit) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0013, 0x7000, 0xA82A);
  1408. /*
  1409. * ImageCodecNewImageBufferMemory()
  1410. *
  1411. * Availability:
  1412. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1413. * CarbonLib: in CarbonLib 1.0 and later
  1414. * Mac OS X: in version 10.0 and later
  1415. * Windows: in qtmlClient.lib 3.0 and later
  1416. */
  1417. EXTERN_API( ComponentResult )
  1418. ImageCodecNewImageBufferMemory(
  1419. ComponentInstance ci,
  1420. CodecDecompressParams * params,
  1421. long flags,
  1422. ICMMemoryDisposedUPP memoryGoneProc,
  1423. void * refCon) FIVEWORDINLINE(0x2F3C, 0x0010, 0x0014, 0x7000, 0xA82A);
  1424. /*
  1425. * ImageCodecExtractAndCombineFields()
  1426. *
  1427. * Availability:
  1428. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1429. * CarbonLib: in CarbonLib 1.0 and later
  1430. * Mac OS X: in version 10.0 and later
  1431. * Windows: in qtmlClient.lib 3.0 and later
  1432. */
  1433. EXTERN_API( ComponentResult )
  1434. ImageCodecExtractAndCombineFields(
  1435. ComponentInstance ci,
  1436. long fieldFlags,
  1437. void * data1,
  1438. long dataSize1,
  1439. ImageDescriptionHandle desc1,
  1440. void * data2,
  1441. long dataSize2,
  1442. ImageDescriptionHandle desc2,
  1443. void * outputData,
  1444. long * outDataSize,
  1445. ImageDescriptionHandle descOut) FIVEWORDINLINE(0x2F3C, 0x0028, 0x0015, 0x7000, 0xA82A);
  1446. /*
  1447. * ImageCodecGetMaxCompressionSizeWithSources()
  1448. *
  1449. * Availability:
  1450. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  1451. * CarbonLib: in CarbonLib 1.0 and later
  1452. * Mac OS X: in version 10.0 and later
  1453. * Windows: in qtmlClient.lib 3.0 and later
  1454. */
  1455. EXTERN_API( ComponentResult )
  1456. ImageCodecGetMaxCompressionSizeWithSources(
  1457. ComponentInstance ci,
  1458. PixMapHandle src,
  1459. const Rect * srcRect,
  1460. short depth,
  1461. CodecQ quality,
  1462. CDSequenceDataSourcePtr sourceData,
  1463. long * size) FIVEWORDINLINE(0x2F3C, 0x0016, 0x0016, 0x7000, 0xA82A);
  1464. /*
  1465. * ImageCodecSetTimeBase()
  1466. *
  1467. * Availability:
  1468. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1469. * CarbonLib: in CarbonLib 1.0 and later
  1470. * Mac OS X: in version 10.0 and later
  1471. * Windows: in qtmlClient.lib 3.0 and later
  1472. */
  1473. EXTERN_API( ComponentResult )
  1474. ImageCodecSetTimeBase(
  1475. ComponentInstance ci,
  1476. void * base) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0017, 0x7000, 0xA82A);
  1477. /*
  1478. * ImageCodecSourceChanged()
  1479. *
  1480. * Availability:
  1481. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1482. * CarbonLib: in CarbonLib 1.0 and later
  1483. * Mac OS X: in version 10.0 and later
  1484. * Windows: in qtmlClient.lib 3.0 and later
  1485. */
  1486. EXTERN_API( ComponentResult )
  1487. ImageCodecSourceChanged(
  1488. ComponentInstance ci,
  1489. UInt32 majorSourceChangeSeed,
  1490. UInt32 minorSourceChangeSeed,
  1491. CDSequenceDataSourcePtr sourceData,
  1492. long * flagsOut) FIVEWORDINLINE(0x2F3C, 0x0010, 0x0018, 0x7000, 0xA82A);
  1493. /*
  1494. * ImageCodecFlushFrame()
  1495. *
  1496. * Availability:
  1497. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1498. * CarbonLib: in CarbonLib 1.0 and later
  1499. * Mac OS X: in version 10.0 and later
  1500. * Windows: in qtmlClient.lib 3.0 and later
  1501. */
  1502. EXTERN_API( ComponentResult )
  1503. ImageCodecFlushFrame(
  1504. ComponentInstance ci,
  1505. UInt32 flags) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0019, 0x7000, 0xA82A);
  1506. /*
  1507. * ImageCodecGetSettingsAsText()
  1508. *
  1509. * Availability:
  1510. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1511. * CarbonLib: in CarbonLib 1.1 and later
  1512. * Mac OS X: in version 10.0 and later
  1513. * Windows: in qtmlClient.lib 3.0 and later
  1514. */
  1515. EXTERN_API( ComponentResult )
  1516. ImageCodecGetSettingsAsText(
  1517. ComponentInstance ci,
  1518. Handle * text) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001A, 0x7000, 0xA82A);
  1519. /*
  1520. * ImageCodecGetParameterListHandle()
  1521. *
  1522. * Availability:
  1523. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1524. * CarbonLib: in CarbonLib 1.0 and later
  1525. * Mac OS X: in version 10.0 and later
  1526. * Windows: in qtmlClient.lib 3.0 and later
  1527. */
  1528. EXTERN_API( ComponentResult )
  1529. ImageCodecGetParameterListHandle(
  1530. ComponentInstance ci,
  1531. Handle * parameterDescriptionHandle) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001B, 0x7000, 0xA82A);
  1532. /*
  1533. * ImageCodecGetParameterList()
  1534. *
  1535. * Availability:
  1536. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1537. * CarbonLib: in CarbonLib 1.0 and later
  1538. * Mac OS X: in version 10.0 and later
  1539. * Windows: in qtmlClient.lib 3.0 and later
  1540. */
  1541. EXTERN_API( ComponentResult )
  1542. ImageCodecGetParameterList(
  1543. ComponentInstance ci,
  1544. QTAtomContainer * parameterDescription) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001C, 0x7000, 0xA82A);
  1545. /*
  1546. * ImageCodecCreateStandardParameterDialog()
  1547. *
  1548. * Availability:
  1549. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1550. * CarbonLib: in CarbonLib 1.0 and later
  1551. * Mac OS X: in version 10.0 and later
  1552. * Windows: in qtmlClient.lib 3.0 and later
  1553. */
  1554. EXTERN_API( ComponentResult )
  1555. ImageCodecCreateStandardParameterDialog(
  1556. ComponentInstance ci,
  1557. QTAtomContainer parameterDescription,
  1558. QTAtomContainer parameters,
  1559. QTParameterDialogOptions dialogOptions,
  1560. DialogPtr existingDialog,
  1561. short existingUserItem,
  1562. QTParameterDialog * createdDialog) FIVEWORDINLINE(0x2F3C, 0x0016, 0x001D, 0x7000, 0xA82A);
  1563. /*
  1564. * ImageCodecIsStandardParameterDialogEvent()
  1565. *
  1566. * Availability:
  1567. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1568. * CarbonLib: in CarbonLib 1.0 and later
  1569. * Mac OS X: in version 10.0 and later
  1570. * Windows: in qtmlClient.lib 3.0 and later
  1571. */
  1572. EXTERN_API( ComponentResult )
  1573. ImageCodecIsStandardParameterDialogEvent(
  1574. ComponentInstance ci,
  1575. EventRecord * pEvent,
  1576. QTParameterDialog createdDialog) FIVEWORDINLINE(0x2F3C, 0x0008, 0x001E, 0x7000, 0xA82A);
  1577. /*
  1578. * ImageCodecDismissStandardParameterDialog()
  1579. *
  1580. * Availability:
  1581. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1582. * CarbonLib: in CarbonLib 1.0 and later
  1583. * Mac OS X: in version 10.0 and later
  1584. * Windows: in qtmlClient.lib 3.0 and later
  1585. */
  1586. EXTERN_API( ComponentResult )
  1587. ImageCodecDismissStandardParameterDialog(
  1588. ComponentInstance ci,
  1589. QTParameterDialog createdDialog) FIVEWORDINLINE(0x2F3C, 0x0004, 0x001F, 0x7000, 0xA82A);
  1590. /*
  1591. * ImageCodecStandardParameterDialogDoAction()
  1592. *
  1593. * Availability:
  1594. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1595. * CarbonLib: in CarbonLib 1.0 and later
  1596. * Mac OS X: in version 10.0 and later
  1597. * Windows: in qtmlClient.lib 3.0 and later
  1598. */
  1599. EXTERN_API( ComponentResult )
  1600. ImageCodecStandardParameterDialogDoAction(
  1601. ComponentInstance ci,
  1602. QTParameterDialog createdDialog,
  1603. long action,
  1604. void * params) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0020, 0x7000, 0xA82A);
  1605. /*
  1606. * ImageCodecNewImageGWorld()
  1607. *
  1608. * Availability:
  1609. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1610. * CarbonLib: in CarbonLib 1.0 and later
  1611. * Mac OS X: in version 10.0 and later
  1612. * Windows: in qtmlClient.lib 3.0 and later
  1613. */
  1614. EXTERN_API( ComponentResult )
  1615. ImageCodecNewImageGWorld(
  1616. ComponentInstance ci,
  1617. CodecDecompressParams * params,
  1618. GWorldPtr * newGW,
  1619. long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0021, 0x7000, 0xA82A);
  1620. /*
  1621. * ImageCodecDisposeImageGWorld()
  1622. *
  1623. * Availability:
  1624. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1625. * CarbonLib: in CarbonLib 1.0 and later
  1626. * Mac OS X: in version 10.0 and later
  1627. * Windows: in qtmlClient.lib 3.0 and later
  1628. */
  1629. EXTERN_API( ComponentResult )
  1630. ImageCodecDisposeImageGWorld(
  1631. ComponentInstance ci,
  1632. GWorldPtr theGW) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0022, 0x7000, 0xA82A);
  1633. /*
  1634. * ImageCodecHitTestDataWithFlags()
  1635. *
  1636. * Availability:
  1637. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1638. * CarbonLib: in CarbonLib 1.1 and later
  1639. * Mac OS X: in version 10.0 and later
  1640. * Windows: in qtmlClient.lib 3.0 and later
  1641. */
  1642. EXTERN_API( ComponentResult )
  1643. ImageCodecHitTestDataWithFlags(
  1644. ComponentInstance ci,
  1645. ImageDescriptionHandle desc,
  1646. void * data,
  1647. Size dataSize,
  1648. Point where,
  1649. long * hit,
  1650. long hitFlags) FIVEWORDINLINE(0x2F3C, 0x0018, 0x0023, 0x7000, 0xA82A);
  1651. /*
  1652. * ImageCodecValidateParameters()
  1653. *
  1654. * Availability:
  1655. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1656. * CarbonLib: in CarbonLib 1.0 and later
  1657. * Mac OS X: in version 10.0 and later
  1658. * Windows: in qtmlClient.lib 3.0 and later
  1659. */
  1660. EXTERN_API( ComponentResult )
  1661. ImageCodecValidateParameters(
  1662. ComponentInstance ci,
  1663. QTAtomContainer parameters,
  1664. QTParameterValidationOptions validationFlags,
  1665. StringPtr errorString) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0024, 0x7000, 0xA82A);
  1666. /*
  1667. * ImageCodecGetBaseMPWorkFunction()
  1668. *
  1669. * Availability:
  1670. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  1671. * CarbonLib: in CarbonLib 1.0 and later
  1672. * Mac OS X: in version 10.0 and later
  1673. * Windows: in qtmlClient.lib 3.0 and later
  1674. */
  1675. EXTERN_API( ComponentResult )
  1676. ImageCodecGetBaseMPWorkFunction(
  1677. ComponentInstance ci,
  1678. ComponentMPWorkFunctionUPP * workFunction,
  1679. void ** refCon,
  1680. ImageCodecMPDrawBandUPP drawProc,
  1681. void * drawProcRefCon) FIVEWORDINLINE(0x2F3C, 0x0010, 0x0025, 0x7000, 0xA82A);
  1682. /*
  1683. * ImageCodecLockBits()
  1684. *
  1685. * Availability:
  1686. * Non-Carbon CFM: not available
  1687. * CarbonLib: not available
  1688. * Mac OS X: in version 10.3 (or QuickTime 6.4) and later
  1689. * Windows: in qtmlClient.lib 6.5 and later
  1690. */
  1691. EXTERN_API( ComponentResult )
  1692. ImageCodecLockBits(
  1693. ComponentInstance ci,
  1694. CGrafPtr port) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0026, 0x7000, 0xA82A);
  1695. /*
  1696. * ImageCodecUnlockBits()
  1697. *
  1698. * Availability:
  1699. * Non-Carbon CFM: not available
  1700. * CarbonLib: not available
  1701. * Mac OS X: in version 10.3 (or QuickTime 6.4) and later
  1702. * Windows: in qtmlClient.lib 6.5 and later
  1703. */
  1704. EXTERN_API( ComponentResult )
  1705. ImageCodecUnlockBits(
  1706. ComponentInstance ci,
  1707. CGrafPtr port) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0027, 0x7000, 0xA82A);
  1708. /*
  1709. * ImageCodecRequestGammaLevel()
  1710. *
  1711. * Availability:
  1712. * Non-Carbon CFM: in QuickTimeLib 5.0 and later
  1713. * CarbonLib: in CarbonLib 1.3 and later
  1714. * Mac OS X: in version 10.0 and later
  1715. * Windows: in qtmlClient.lib 5.0 and later
  1716. */
  1717. EXTERN_API( ComponentResult )
  1718. ImageCodecRequestGammaLevel(
  1719. ComponentInstance ci,
  1720. Fixed srcGammaLevel,
  1721. Fixed dstGammaLevel,
  1722. long * codecCanMatch) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0028, 0x7000, 0xA82A);
  1723. /*
  1724. * ImageCodecGetSourceDataGammaLevel()
  1725. *
  1726. * Availability:
  1727. * Non-Carbon CFM: in QuickTimeLib 5.0 and later
  1728. * CarbonLib: in CarbonLib 1.3 and later
  1729. * Mac OS X: in version 10.0 and later
  1730. * Windows: in qtmlClient.lib 5.0 and later
  1731. */
  1732. EXTERN_API( ComponentResult )
  1733. ImageCodecGetSourceDataGammaLevel(
  1734. ComponentInstance ci,
  1735. Fixed * sourceDataGammaLevel) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0029, 0x7000, 0xA82A);
  1736. /* (Selector 42 skipped) */
  1737. /*
  1738. * ImageCodecGetDecompressLatency()
  1739. *
  1740. * Availability:
  1741. * Non-Carbon CFM: in QuickTimeLib 5.0 and later
  1742. * CarbonLib: in CarbonLib 1.3 and later
  1743. * Mac OS X: in version 10.0 and later
  1744. * Windows: in qtmlClient.lib 5.0 and later
  1745. */
  1746. EXTERN_API( ComponentResult )
  1747. ImageCodecGetDecompressLatency(
  1748. ComponentInstance ci,
  1749. TimeRecord * latency) FIVEWORDINLINE(0x2F3C, 0x0004, 0x002B, 0x7000, 0xA82A);
  1750. /*
  1751. * ImageCodecMergeFloatingImageOntoWindow()
  1752. *
  1753. * Availability:
  1754. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1755. * CarbonLib: in CarbonLib 1.6 and later
  1756. * Mac OS X: in version 10.2 and later
  1757. * Windows: in qtmlClient.lib 6.0 and later
  1758. */
  1759. EXTERN_API( ComponentResult )
  1760. ImageCodecMergeFloatingImageOntoWindow(
  1761. ComponentInstance ci,
  1762. UInt32 flags) FIVEWORDINLINE(0x2F3C, 0x0004, 0x002C, 0x7000, 0xA82A);
  1763. /*
  1764. * ImageCodecRemoveFloatingImage()
  1765. *
  1766. * Availability:
  1767. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1768. * CarbonLib: in CarbonLib 1.6 and later
  1769. * Mac OS X: in version 10.2 and later
  1770. * Windows: in qtmlClient.lib 6.0 and later
  1771. */
  1772. EXTERN_API( ComponentResult )
  1773. ImageCodecRemoveFloatingImage(
  1774. ComponentInstance ci,
  1775. UInt32 flags) FIVEWORDINLINE(0x2F3C, 0x0004, 0x002D, 0x7000, 0xA82A);
  1776. /*
  1777. * ImageCodecGetDITLForSize()
  1778. *
  1779. * Availability:
  1780. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1781. * CarbonLib: in CarbonLib 1.6 and later
  1782. * Mac OS X: in version 10.2 and later
  1783. * Windows: in qtmlClient.lib 6.0 and later
  1784. */
  1785. EXTERN_API( ComponentResult )
  1786. ImageCodecGetDITLForSize(
  1787. ComponentInstance ci,
  1788. Handle * ditl,
  1789. Point * requestedSize) FIVEWORDINLINE(0x2F3C, 0x0008, 0x002E, 0x7000, 0xA82A);
  1790. /*
  1791. * ImageCodecDITLInstall()
  1792. *
  1793. * Availability:
  1794. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1795. * CarbonLib: in CarbonLib 1.6 and later
  1796. * Mac OS X: in version 10.2 and later
  1797. * Windows: in qtmlClient.lib 6.0 and later
  1798. */
  1799. EXTERN_API( ComponentResult )
  1800. ImageCodecDITLInstall(
  1801. ComponentInstance ci,
  1802. DialogRef d,
  1803. short itemOffset) FIVEWORDINLINE(0x2F3C, 0x0006, 0x002F, 0x7000, 0xA82A);
  1804. /*
  1805. * ImageCodecDITLEvent()
  1806. *
  1807. * Availability:
  1808. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1809. * CarbonLib: in CarbonLib 1.6 and later
  1810. * Mac OS X: in version 10.2 and later
  1811. * Windows: in qtmlClient.lib 6.0 and later
  1812. */
  1813. EXTERN_API( ComponentResult )
  1814. ImageCodecDITLEvent(
  1815. ComponentInstance ci,
  1816. DialogRef d,
  1817. short itemOffset,
  1818. const EventRecord * theEvent,
  1819. short * itemHit,
  1820. Boolean * handled) FIVEWORDINLINE(0x2F3C, 0x0012, 0x0030, 0x7000, 0xA82A);
  1821. /*
  1822. * ImageCodecDITLItem()
  1823. *
  1824. * Availability:
  1825. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1826. * CarbonLib: in CarbonLib 1.6 and later
  1827. * Mac OS X: in version 10.2 and later
  1828. * Windows: in qtmlClient.lib 6.0 and later
  1829. */
  1830. EXTERN_API( ComponentResult )
  1831. ImageCodecDITLItem(
  1832. ComponentInstance ci,
  1833. DialogRef d,
  1834. short itemOffset,
  1835. short itemNum) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0031, 0x7000, 0xA82A);
  1836. /*
  1837. * ImageCodecDITLRemove()
  1838. *
  1839. * Availability:
  1840. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1841. * CarbonLib: in CarbonLib 1.6 and later
  1842. * Mac OS X: in version 10.2 and later
  1843. * Windows: in qtmlClient.lib 6.0 and later
  1844. */
  1845. EXTERN_API( ComponentResult )
  1846. ImageCodecDITLRemove(
  1847. ComponentInstance ci,
  1848. DialogRef d,
  1849. short itemOffset) FIVEWORDINLINE(0x2F3C, 0x0006, 0x0032, 0x7000, 0xA82A);
  1850. /*
  1851. * ImageCodecDITLValidateInput()
  1852. *
  1853. * Availability:
  1854. * Non-Carbon CFM: in QuickTimeLib 6.0 and later
  1855. * CarbonLib: in CarbonLib 1.6 and later
  1856. * Mac OS X: in version 10.2 and later
  1857. * Windows: in qtmlClient.lib 6.0 and later
  1858. */
  1859. EXTERN_API( ComponentResult )
  1860. ImageCodecDITLValidateInput(
  1861. ComponentInstance ci,
  1862. Boolean * ok) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0033, 0x7000, 0xA82A);
  1863. /* (Selector 52 skipped) */
  1864. /* (Selector 53 skipped) */
  1865. /*
  1866. * ImageCodecGetPreferredChunkSizeAndAlignment()
  1867. *
  1868. * Summary:
  1869. * Returns the preferences of an image decompressor for the chunking
  1870. * of image data within a container, e.g. a movie file.
  1871. *
  1872. * Discussion:
  1873. * If you are writing image data to a container, you can optimize
  1874. * the subsequent loading of the image data for playback and other
  1875. * operations by chunking multiple samples of image data together.
  1876. * This function can be called to determine whether an image
  1877. * decompressor has special chunking preferences.
  1878. *
  1879. * Parameters:
  1880. *
  1881. * ci:
  1882. * Component instance / instance globals.
  1883. *
  1884. * desc:
  1885. * The image description for the image data to be chunked.
  1886. *
  1887. * frameRate:
  1888. * Mean frame rate in frames per second as in SCTemporalSettings;
  1889. * 0 if not known or not applicable.
  1890. *
  1891. * dataRate:
  1892. * Mean data rate in bytes per second as in SCDataRateSettings; 0
  1893. * if not known.
  1894. *
  1895. * bytesPerChunk:
  1896. * Points to a variable to receive the preferred maximum size in
  1897. * bytes of each chunk of image data. It is not safe to pass NULL
  1898. * for this parameter. The codec may indicate that it has no
  1899. * preference regarding chunk sizing by setting the variable to 0.
  1900. *
  1901. * alignment:
  1902. * Points to a variable to receive the preferred boundary for
  1903. * chunk alignment in bytes, e.g. 512. It is not safe to pass NULL
  1904. * for this parameter. The codec may indicate that it has no
  1905. * preference regarding chunk alignment by setting the variable to
  1906. * 0.
  1907. *
  1908. * Availability:
  1909. * Non-Carbon CFM: not available
  1910. * CarbonLib: not available
  1911. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  1912. */
  1913. EXTERN_API( ComponentResult )
  1914. ImageCodecGetPreferredChunkSizeAndAlignment(
  1915. ComponentInstance ci,
  1916. ImageDescriptionHandle desc,
  1917. Fixed frameRate,
  1918. UInt32 dataRate,
  1919. long * bytesPerChunk,
  1920. long * alignment) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0036, 0x7000, 0xA82A);
  1921. /* B-Frame Capable Image Compressor Component API */
  1922. /*
  1923. * ImageCodecPrepareToCompressFrames()
  1924. *
  1925. * Summary:
  1926. * Prepares the compressor to receive frames.
  1927. *
  1928. * Discussion:
  1929. * The compressor should record session and retain
  1930. * compressionSessionOptions for use in later calls.
  1931. * The compressor may modify imageDescription at this point.
  1932. * The compressor should create and return pixel buffer attributes,
  1933. * which the ICM will release.
  1934. * (Note: this replaces ImageCodecPreCompress.)
  1935. *
  1936. * Parameters:
  1937. *
  1938. * ci:
  1939. * Component instance / instance globals.
  1940. *
  1941. * session:
  1942. * The compressor session reference. The compressor should store
  1943. * this in its globals; it will need it when calling the ICM back
  1944. * (eg, to call ICMEncodedFrameCreateMutable and
  1945. * ICMCompressorSessionEmitEncodedFrame).
  1946. * This is not a CF type. Do not call CFRetain or CFRelease on it.
  1947. *
  1948. * compressionSessionOptions:
  1949. * The session options from the client. The compressor should
  1950. * retain this and use the settings to guide compression.
  1951. *
  1952. * imageDescription:
  1953. * The image description. The compressor may add image description
  1954. * extensions.
  1955. *
  1956. * reserved:
  1957. * Reserved for future use. Ignore this parameter.
  1958. *
  1959. * compressorPixelBufferAttributesOut:
  1960. * The compressor should create a pixel buffer attributes
  1961. * dictionary and set compressorPixelBufferAttributesOut to it.
  1962. * The ICM will release it.
  1963. *
  1964. * Availability:
  1965. * Non-Carbon CFM: not available
  1966. * CarbonLib: not available
  1967. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  1968. */
  1969. EXTERN_API( ComponentResult )
  1970. ImageCodecPrepareToCompressFrames(
  1971. ComponentInstance ci,
  1972. ICMCompressorSessionRef session,
  1973. ICMCompressionSessionOptionsRef compressionSessionOptions,
  1974. ImageDescriptionHandle imageDescription,
  1975. void * reserved,
  1976. CFDictionaryRef * compressorPixelBufferAttributesOut) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0037, 0x7000, 0xA82A);
  1977. /*
  1978. * ImageCodecEncodeFrame()
  1979. *
  1980. * Summary:
  1981. * Presents the compressor with a frame to encode.
  1982. *
  1983. * Discussion:
  1984. * The compressor may encode the frame immediately or queue it for
  1985. * later encoding. If the compressor queues the frame for later
  1986. * decode, it must retain it (by calling
  1987. * ICMCompressorSourceFrameRetain) and release it when it is done
  1988. * with it (by calling ICMCompressorSourceFrameRelease).
  1989. * Pixel buffers are guaranteed to conform to the pixel buffer
  1990. * attributes returned by ImageCodecPrepareToCompressFrames.
  1991. * During multipass encoding, if the compressor requested the
  1992. * kICMCompressionPassMode_NoSourceFrames flag, the source frame
  1993. * pixel buffers may be NULL.
  1994. * (Note: this replaces ImageCodecBandCompress.)
  1995. *
  1996. * Parameters:
  1997. *
  1998. * ci:
  1999. * Component instance / instance globals.
  2000. *
  2001. * sourceFrame:
  2002. * The source frame to encode.
  2003. *
  2004. * flags:
  2005. * Reserved; ignore.
  2006. *
  2007. * Availability:
  2008. * Non-Carbon CFM: not available
  2009. * CarbonLib: not available
  2010. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2011. */
  2012. EXTERN_API( ComponentResult )
  2013. ImageCodecEncodeFrame(
  2014. ComponentInstance ci,
  2015. ICMCompressorSourceFrameRef sourceFrame,
  2016. UInt32 flags) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0038, 0x7000, 0xA82A);
  2017. /*
  2018. * ImageCodecCompleteFrame()
  2019. *
  2020. * Summary:
  2021. * Directs the compressor to finish with a queued source frame,
  2022. * either emitting or dropping it.
  2023. *
  2024. * Discussion:
  2025. * This frame does not necessarily need to be the first or only
  2026. * source frame emitted or dropped during this call, but the
  2027. * compressor must call either ICMCompressorSessionDropFrame or
  2028. * ICMCompressorSessionEmitEncodedFrame with this frame before
  2029. * returning.
  2030. * The ICM will call this function to force frames to be encoded for
  2031. * the following reasons: (a) the maximum frame delay count or
  2032. * maximum frame delay time in the compressionSessionOptions does
  2033. * not permit frames to be queued; (b) the client has called
  2034. * ICMCompressionSessionCompleteFrames.
  2035. *
  2036. * Parameters:
  2037. *
  2038. * ci:
  2039. * Component instance / instance globals.
  2040. *
  2041. * sourceFrame:
  2042. * The source frame that must be completed.
  2043. *
  2044. * flags:
  2045. * Reserved; ignore.
  2046. *
  2047. * Availability:
  2048. * Non-Carbon CFM: not available
  2049. * CarbonLib: not available
  2050. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2051. */
  2052. EXTERN_API( ComponentResult )
  2053. ImageCodecCompleteFrame(
  2054. ComponentInstance ci,
  2055. ICMCompressorSourceFrameRef sourceFrame,
  2056. UInt32 flags) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0039, 0x7000, 0xA82A);
  2057. /*
  2058. * ImageCodecBeginPass()
  2059. *
  2060. * Summary:
  2061. * Notifies the compressor that it should operate in multipass mode
  2062. * and use the given multipass storage.
  2063. *
  2064. * Parameters:
  2065. *
  2066. * ci:
  2067. * Component instance / instance globals.
  2068. *
  2069. * passModeFlags:
  2070. * Indicates how the compressor should operate in this pass.
  2071. * If the kICMCompressionPassMode_WriteToMultiPassStorage flag is
  2072. * set, the compressor may gather information of interest and
  2073. * store it in multiPassStorage.
  2074. * If the kICMCompressionPassMode_ReadFromMultiPassStorage flag is
  2075. * set, the compressor may retrieve information from
  2076. * multiPassStorage.
  2077. * If the kICMCompressionPassMode_OutputEncodedFrames flag is set,
  2078. * the compressor must encode or drop every frame by calling
  2079. * ICMCompressorSessionDropFrame or
  2080. * ICMCompressorSessionEmitEncodedFrame. If that flag is not set,
  2081. * the compressor should not call these routines.
  2082. *
  2083. * flags:
  2084. * Reserved. Ignore this parameter.
  2085. *
  2086. * multiPassStorage:
  2087. * The multipass storage object that the compressor should use to
  2088. * store and retrieve information between passes.
  2089. *
  2090. * Availability:
  2091. * Non-Carbon CFM: not available
  2092. * CarbonLib: not available
  2093. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2094. */
  2095. EXTERN_API( ComponentResult )
  2096. ImageCodecBeginPass(
  2097. ComponentInstance ci,
  2098. ICMCompressionPassModeFlags passModeFlags,
  2099. UInt32 flags,
  2100. ICMMultiPassStorageRef multiPassStorage) FIVEWORDINLINE(0x2F3C, 0x000C, 0x003A, 0x7000, 0xA82A);
  2101. /*
  2102. * ImageCodecEndPass()
  2103. *
  2104. * Summary:
  2105. * Notifies the compressor that a pass is over.
  2106. *
  2107. * Parameters:
  2108. *
  2109. * ci:
  2110. * Component instance / instance globals.
  2111. *
  2112. * Availability:
  2113. * Non-Carbon CFM: not available
  2114. * CarbonLib: not available
  2115. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2116. */
  2117. EXTERN_API( ComponentResult )
  2118. ImageCodecEndPass(ComponentInstance ci) FIVEWORDINLINE(0x2F3C, 0x0000, 0x003B, 0x7000, 0xA82A);
  2119. /*
  2120. * ImageCodecProcessBetweenPasses()
  2121. *
  2122. * Summary:
  2123. * Gives the compressor an opportunity to perform processing between
  2124. * passes.
  2125. *
  2126. * Discussion:
  2127. * This function will be called repeatedly until it returns true in
  2128. * *interpassProcessingDoneOut.
  2129. * The compressor may read and write to multiPassStorage.
  2130. * The compressor should indicate which type of pass it would prefer
  2131. * to perform next by setting *requestedNextPassTypeOut.
  2132. *
  2133. * Parameters:
  2134. *
  2135. * ci:
  2136. * Component instance / instance globals.
  2137. *
  2138. * multiPassStorage:
  2139. * The multipass storage object that the compressor should use to
  2140. * store and retrieve information between passes.
  2141. *
  2142. * interpassProcessingDoneOut:
  2143. * Points to a Boolean. Set this to false if you want your
  2144. * ImageCodecProcessBetweenPasses function to be called again to
  2145. * perform more processing, true if not.
  2146. *
  2147. * requestedNextPassModeFlagsOut:
  2148. * Set *requestedNextPassModeFlagsOut to indicate the type of pass
  2149. * that should be performed next:
  2150. * To recommend a repeated analysis pass, set it to
  2151. * kICMCompressionPassMode_ReadFromMultiPassStorage |
  2152. * kICMCompressionPassMode_WriteToMultiPassStorage.
  2153. * To recommend a final encoding pass, set it to
  2154. * kICMCompressionPassMode_ReadFromMultiPassStorage |
  2155. * kICMCompressionPassMode_OutputEncodedFrames.
  2156. * If source frame buffers are not necessary for the recommended
  2157. * pass (eg, because all the required data has been copied into
  2158. * multipass storage), set kICMCompressionPassMode_NoSourceFrames.
  2159. *
  2160. * Availability:
  2161. * Non-Carbon CFM: not available
  2162. * CarbonLib: not available
  2163. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2164. */
  2165. EXTERN_API( ComponentResult )
  2166. ImageCodecProcessBetweenPasses(
  2167. ComponentInstance ci,
  2168. ICMMultiPassStorageRef multiPassStorage,
  2169. Boolean * interpassProcessingDoneOut,
  2170. ICMCompressionPassModeFlags * requestedNextPassModeFlagsOut) FIVEWORDINLINE(0x2F3C, 0x000C, 0x003C, 0x7000, 0xA82A);
  2171. /* (Selector 61 skipped) */
  2172. /* (Selector 62 skipped) */
  2173. /* (Selector 63 skipped) */
  2174. /* (Selector 64 skipped) */
  2175. /* (Selector 65 skipped) */
  2176. /* (Selector 66 skipped) */
  2177. /*
  2178. * ImageCodecPreflight()
  2179. *
  2180. * Availability:
  2181. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2182. * CarbonLib: in CarbonLib 1.0 and later
  2183. * Mac OS X: in version 10.0 and later
  2184. * Windows: in qtmlClient.lib 3.0 and later
  2185. */
  2186. EXTERN_API( ComponentResult )
  2187. ImageCodecPreflight(
  2188. ComponentInstance ci,
  2189. CodecDecompressParams * params) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0200, 0x7000, 0xA82A);
  2190. /*
  2191. * ImageCodecInitialize()
  2192. *
  2193. * Availability:
  2194. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2195. * CarbonLib: in CarbonLib 1.0 and later
  2196. * Mac OS X: in version 10.0 and later
  2197. * Windows: in qtmlClient.lib 3.0 and later
  2198. */
  2199. EXTERN_API( ComponentResult )
  2200. ImageCodecInitialize(
  2201. ComponentInstance ci,
  2202. ImageSubCodecDecompressCapabilities * cap) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0201, 0x7000, 0xA82A);
  2203. /*
  2204. * ImageCodecBeginBand()
  2205. *
  2206. * Availability:
  2207. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2208. * CarbonLib: in CarbonLib 1.0 and later
  2209. * Mac OS X: in version 10.0 and later
  2210. * Windows: in qtmlClient.lib 3.0 and later
  2211. */
  2212. EXTERN_API( ComponentResult )
  2213. ImageCodecBeginBand(
  2214. ComponentInstance ci,
  2215. CodecDecompressParams * params,
  2216. ImageSubCodecDecompressRecord * drp,
  2217. long flags) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0202, 0x7000, 0xA82A);
  2218. /*
  2219. * ImageCodecDrawBand()
  2220. *
  2221. * Availability:
  2222. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2223. * CarbonLib: in CarbonLib 1.0 and later
  2224. * Mac OS X: in version 10.0 and later
  2225. * Windows: in qtmlClient.lib 3.0 and later
  2226. */
  2227. EXTERN_API( ComponentResult )
  2228. ImageCodecDrawBand(
  2229. ComponentInstance ci,
  2230. ImageSubCodecDecompressRecord * drp) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0203, 0x7000, 0xA82A);
  2231. /*
  2232. * ImageCodecEndBand()
  2233. *
  2234. * Availability:
  2235. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2236. * CarbonLib: in CarbonLib 1.0 and later
  2237. * Mac OS X: in version 10.0 and later
  2238. * Windows: in qtmlClient.lib 3.0 and later
  2239. */
  2240. EXTERN_API( ComponentResult )
  2241. ImageCodecEndBand(
  2242. ComponentInstance ci,
  2243. ImageSubCodecDecompressRecord * drp,
  2244. OSErr result,
  2245. long flags) FIVEWORDINLINE(0x2F3C, 0x000A, 0x0204, 0x7000, 0xA82A);
  2246. /*
  2247. * ImageCodecQueueStarting()
  2248. *
  2249. * Availability:
  2250. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2251. * CarbonLib: in CarbonLib 1.0 and later
  2252. * Mac OS X: in version 10.0 and later
  2253. * Windows: in qtmlClient.lib 3.0 and later
  2254. */
  2255. EXTERN_API( ComponentResult )
  2256. ImageCodecQueueStarting(ComponentInstance ci) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0205, 0x7000, 0xA82A);
  2257. /*
  2258. * ImageCodecQueueStopping()
  2259. *
  2260. * Availability:
  2261. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2262. * CarbonLib: in CarbonLib 1.0 and later
  2263. * Mac OS X: in version 10.0 and later
  2264. * Windows: in qtmlClient.lib 3.0 and later
  2265. */
  2266. EXTERN_API( ComponentResult )
  2267. ImageCodecQueueStopping(ComponentInstance ci) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0206, 0x7000, 0xA82A);
  2268. /*
  2269. * ImageCodecDroppingFrame()
  2270. *
  2271. * Availability:
  2272. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2273. * CarbonLib: in CarbonLib 1.0 and later
  2274. * Mac OS X: in version 10.0 and later
  2275. * Windows: in qtmlClient.lib 3.0 and later
  2276. */
  2277. EXTERN_API( ComponentResult )
  2278. ImageCodecDroppingFrame(
  2279. ComponentInstance ci,
  2280. const ImageSubCodecDecompressRecord * drp) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0207, 0x7000, 0xA82A);
  2281. /*
  2282. * ImageCodecScheduleFrame()
  2283. *
  2284. * Availability:
  2285. * Non-Carbon CFM: in QuickTimeLib 4.0 and later
  2286. * CarbonLib: in CarbonLib 1.0.2 and later
  2287. * Mac OS X: in version 10.0 and later
  2288. * Windows: in qtmlClient.lib 4.0 and later
  2289. */
  2290. EXTERN_API( ComponentResult )
  2291. ImageCodecScheduleFrame(
  2292. ComponentInstance ci,
  2293. const ImageSubCodecDecompressRecord * drp,
  2294. ImageCodecTimeTriggerUPP triggerProc,
  2295. void * triggerProcRefCon) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0208, 0x7000, 0xA82A);
  2296. /*
  2297. * ImageCodecCancelTrigger()
  2298. *
  2299. * Availability:
  2300. * Non-Carbon CFM: in QuickTimeLib 4.0 and later
  2301. * CarbonLib: in CarbonLib 1.0.2 and later
  2302. * Mac OS X: in version 10.0 and later
  2303. * Windows: in qtmlClient.lib 4.0 and later
  2304. */
  2305. EXTERN_API( ComponentResult )
  2306. ImageCodecCancelTrigger(ComponentInstance ci) FIVEWORDINLINE(0x2F3C, 0x0000, 0x0209, 0x7000, 0xA82A);
  2307. /*
  2308. * ImageCodecDecodeBand()
  2309. *
  2310. * Availability:
  2311. * Non-Carbon CFM: not available
  2312. * CarbonLib: not available
  2313. * Mac OS X: in version 10.4 (or QuickTime 7.0) and later
  2314. * Windows: in qtmlClient.lib version 10.4 (or QuickTime 7.0) and later
  2315. */
  2316. EXTERN_API( ComponentResult )
  2317. ImageCodecDecodeBand(
  2318. ComponentInstance ci,
  2319. ImageSubCodecDecompressRecord * drp,
  2320. unsigned long flags) FIVEWORDINLINE(0x2F3C, 0x0008, 0x020F, 0x7000, 0xA82A);
  2321. /* selectors for component calls */
  2322. enum {
  2323. kImageCodecGetCodecInfoSelect = 0x0000,
  2324. kImageCodecGetCompressionTimeSelect = 0x0001,
  2325. kImageCodecGetMaxCompressionSizeSelect = 0x0002,
  2326. kImageCodecPreCompressSelect = 0x0003,
  2327. kImageCodecBandCompressSelect = 0x0004,
  2328. kImageCodecPreDecompressSelect = 0x0005,
  2329. kImageCodecBandDecompressSelect = 0x0006,
  2330. kImageCodecBusySelect = 0x0007,
  2331. kImageCodecGetCompressedImageSizeSelect = 0x0008,
  2332. kImageCodecGetSimilaritySelect = 0x0009,
  2333. kImageCodecTrimImageSelect = 0x000A,
  2334. kImageCodecRequestSettingsSelect = 0x000B,
  2335. kImageCodecGetSettingsSelect = 0x000C,
  2336. kImageCodecSetSettingsSelect = 0x000D,
  2337. kImageCodecFlushSelect = 0x000E,
  2338. kImageCodecSetTimeCodeSelect = 0x000F,
  2339. kImageCodecIsImageDescriptionEquivalentSelect = 0x0010,
  2340. kImageCodecNewMemorySelect = 0x0011,
  2341. kImageCodecDisposeMemorySelect = 0x0012,
  2342. kImageCodecHitTestDataSelect = 0x0013,
  2343. kImageCodecNewImageBufferMemorySelect = 0x0014,
  2344. kImageCodecExtractAndCombineFieldsSelect = 0x0015,
  2345. kImageCodecGetMaxCompressionSizeWithSourcesSelect = 0x0016,
  2346. kImageCodecSetTimeBaseSelect = 0x0017,
  2347. kImageCodecSourceChangedSelect = 0x0018,
  2348. kImageCodecFlushFrameSelect = 0x0019,
  2349. kImageCodecGetSettingsAsTextSelect = 0x001A,
  2350. kImageCodecGetParameterListHandleSelect = 0x001B,
  2351. kImageCodecGetParameterListSelect = 0x001C,
  2352. kImageCodecCreateStandardParameterDialogSelect = 0x001D,
  2353. kImageCodecIsStandardParameterDialogEventSelect = 0x001E,
  2354. kImageCodecDismissStandardParameterDialogSelect = 0x001F,
  2355. kImageCodecStandardParameterDialogDoActionSelect = 0x0020,
  2356. kImageCodecNewImageGWorldSelect = 0x0021,
  2357. kImageCodecDisposeImageGWorldSelect = 0x0022,
  2358. kImageCodecHitTestDataWithFlagsSelect = 0x0023,
  2359. kImageCodecValidateParametersSelect = 0x0024,
  2360. kImageCodecGetBaseMPWorkFunctionSelect = 0x0025,
  2361. kImageCodecLockBitsSelect = 0x0026,
  2362. kImageCodecUnlockBitsSelect = 0x0027,
  2363. kImageCodecRequestGammaLevelSelect = 0x0028,
  2364. kImageCodecGetSourceDataGammaLevelSelect = 0x0029,
  2365. kImageCodecGetDecompressLatencySelect = 0x002B,
  2366. kImageCodecMergeFloatingImageOntoWindowSelect = 0x002C,
  2367. kImageCodecRemoveFloatingImageSelect = 0x002D,
  2368. kImageCodecGetDITLForSizeSelect = 0x002E,
  2369. kImageCodecDITLInstallSelect = 0x002F,
  2370. kImageCodecDITLEventSelect = 0x0030,
  2371. kImageCodecDITLItemSelect = 0x0031,
  2372. kImageCodecDITLRemoveSelect = 0x0032,
  2373. kImageCodecDITLValidateInputSelect = 0x0033,
  2374. kImageCodecGetPreferredChunkSizeAndAlignmentSelect = 0x0036,
  2375. kImageCodecPrepareToCompressFramesSelect = 0x0037,
  2376. kImageCodecEncodeFrameSelect = 0x0038,
  2377. kImageCodecCompleteFrameSelect = 0x0039,
  2378. kImageCodecBeginPassSelect = 0x003A,
  2379. kImageCodecEndPassSelect = 0x003B,
  2380. kImageCodecProcessBetweenPassesSelect = 0x003C,
  2381. kImageCodecPreflightSelect = 0x0200,
  2382. kImageCodecInitializeSelect = 0x0201,
  2383. kImageCodecBeginBandSelect = 0x0202,
  2384. kImageCodecDrawBandSelect = 0x0203,
  2385. kImageCodecEndBandSelect = 0x0204,
  2386. kImageCodecQueueStartingSelect = 0x0205,
  2387. kImageCodecQueueStoppingSelect = 0x0206,
  2388. kImageCodecDroppingFrameSelect = 0x0207,
  2389. kImageCodecScheduleFrameSelect = 0x0208,
  2390. kImageCodecCancelTriggerSelect = 0x0209,
  2391. kImageCodecDecodeBandSelect = 0x020F
  2392. };
  2393. enum {
  2394. kMotionJPEGTag = FOUR_CHAR_CODE('mjpg'),
  2395. kJPEGQuantizationTablesImageDescriptionExtension = FOUR_CHAR_CODE('mjqt'),
  2396. kJPEGHuffmanTablesImageDescriptionExtension = FOUR_CHAR_CODE('mjht'),
  2397. kFieldInfoImageDescriptionExtension = FOUR_CHAR_CODE('fiel') /* image description extension describing the field count and field orderings*/
  2398. };
  2399. enum {
  2400. kFieldOrderUnknown = 0,
  2401. kFieldsStoredF1F2DisplayedF1F2 = 1,
  2402. kFieldsStoredF1F2DisplayedF2F1 = 2,
  2403. kFieldsStoredF2F1DisplayedF1F2 = 5,
  2404. kFieldsStoredF2F1DisplayedF2F1 = 6
  2405. };
  2406. struct MotionJPEGApp1Marker {
  2407. long unused;
  2408. long tag;
  2409. long fieldSize;
  2410. long paddedFieldSize;
  2411. long offsetToNextField;
  2412. long qTableOffset;
  2413. long huffmanTableOffset;
  2414. long sofOffset;
  2415. long sosOffset;
  2416. long soiOffset;
  2417. };
  2418. typedef struct MotionJPEGApp1Marker MotionJPEGApp1Marker;
  2419. struct FieldInfoImageDescriptionExtension {
  2420. UInt8 fieldCount;
  2421. UInt8 fieldOrderings;
  2422. };
  2423. typedef struct FieldInfoImageDescriptionExtension FieldInfoImageDescriptionExtension;
  2424. /*
  2425. * QTPhotoSetSampling()
  2426. *
  2427. * Availability:
  2428. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  2429. * CarbonLib: in CarbonLib 1.0 and later
  2430. * Mac OS X: in version 10.0 and later
  2431. * Windows: in qtmlClient.lib 3.0 and later
  2432. */
  2433. EXTERN_API( ComponentResult )
  2434. QTPhotoSetSampling(
  2435. ComponentInstance codec,
  2436. short yH,
  2437. short yV,
  2438. short cbH,
  2439. short cbV,
  2440. short crH,
  2441. short crV) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0100, 0x7000, 0xA82A);
  2442. /*
  2443. * QTPhotoSetRestartInterval()
  2444. *
  2445. * Availability:
  2446. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  2447. * CarbonLib: in CarbonLib 1.0 and later
  2448. * Mac OS X: in version 10.0 and later
  2449. * Windows: in qtmlClient.lib 3.0 and later
  2450. */
  2451. EXTERN_API( ComponentResult )
  2452. QTPhotoSetRestartInterval(
  2453. ComponentInstance codec,
  2454. unsigned short restartInterval) FIVEWORDINLINE(0x2F3C, 0x0002, 0x0101, 0x7000, 0xA82A);
  2455. /*
  2456. * QTPhotoDefineHuffmanTable()
  2457. *
  2458. * Availability:
  2459. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  2460. * CarbonLib: in CarbonLib 1.0 and later
  2461. * Mac OS X: in version 10.0 and later
  2462. * Windows: in qtmlClient.lib 3.0 and later
  2463. */
  2464. EXTERN_API( ComponentResult )
  2465. QTPhotoDefineHuffmanTable(
  2466. ComponentInstance codec,
  2467. short componentNumber,
  2468. Boolean isDC,
  2469. unsigned char * lengthCounts,
  2470. unsigned char * values) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0102, 0x7000, 0xA82A);
  2471. /*
  2472. * QTPhotoDefineQuantizationTable()
  2473. *
  2474. * Availability:
  2475. * Non-Carbon CFM: in QuickTimeLib 2.5 and later
  2476. * CarbonLib: in CarbonLib 1.0 and later
  2477. * Mac OS X: in version 10.0 and later
  2478. * Windows: in qtmlClient.lib 3.0 and later
  2479. */
  2480. EXTERN_API( ComponentResult )
  2481. QTPhotoDefineQuantizationTable(
  2482. ComponentInstance codec,
  2483. short componentNumber,
  2484. unsigned char * table) FIVEWORDINLINE(0x2F3C, 0x0006, 0x0103, 0x7000, 0xA82A);
  2485. /* selectors for component calls */
  2486. enum {
  2487. kQTPhotoSetSamplingSelect = 0x0100,
  2488. kQTPhotoSetRestartIntervalSelect = 0x0101,
  2489. kQTPhotoDefineHuffmanTableSelect = 0x0102,
  2490. kQTPhotoDefineQuantizationTableSelect = 0x0103
  2491. };
  2492. /*
  2493. * Summary:
  2494. * Properties for image compressor components
  2495. */
  2496. enum {
  2497. /*
  2498. * Property class for image compressor components.
  2499. */
  2500. kQTPropertyClass_ImageCompressor = FOUR_CHAR_CODE('imco')
  2501. };
  2502. /*
  2503. * Summary:
  2504. * Enforced properties for image compressor components
  2505. *
  2506. * Discussion:
  2507. * Image compressors that sometimes or always restrict image
  2508. * dimensions, clean aperture and/or pixel aspect ratio should
  2509. * support these properties.
  2510. * If these properties can change dynamically for a compressor (eg,
  2511. * in response to user interaction) then the properties should be
  2512. * listenable, and the compressor should call the listeners whenever
  2513. * the properties change. (In this case, the component's
  2514. * GetComponentPropertyInfo function should set the
  2515. * kComponentPropertyFlagWillNotifyListeners flag.)
  2516. * If a compressor has a mode in which these properties are
  2517. * flexible, then when the component is in that mode, (a) the
  2518. * component's GetComponentProperty function should return
  2519. * kQTPropertyAskLaterErr for these properties, and (b) the
  2520. * component's GetComponentPropertyInfo function should set the
  2521. * kComponentPropertyFlagCanGetLater flag for these properties.
  2522. */
  2523. enum {
  2524. /*
  2525. * The encoded width enforced for compressed frames.
  2526. */
  2527. kICMImageCompressorPropertyID_EnforcedEncodedWidth = FOUR_CHAR_CODE('enwi'), /* SInt32, Read/Sometimes Listen */
  2528. /*
  2529. * The encoded height enforced for compressed frames.
  2530. */
  2531. kICMImageCompressorPropertyID_EnforcedEncodedHeight = FOUR_CHAR_CODE('enhe'), /* SInt32, Read/Sometimes Listen */
  2532. /*
  2533. * The clean aperture enforced for compressed frames.
  2534. */
  2535. kICMImageCompressorPropertyID_EnforcedCleanAperture = FOUR_CHAR_CODE('encl'), /* CleanApertureImageDescriptionExtension, Read/Sometimes Listen */
  2536. /*
  2537. * The pixel aspect ratio enforced for compressed frames.
  2538. */
  2539. kICMImageCompressorPropertyID_EnforcedPixelAspectRatio = FOUR_CHAR_CODE('enpa'), /* PixelAspectRatioImageDescriptionExtension, Read/Sometimes Listen */
  2540. /*
  2541. * The number and order of fields enforced for compressed frames.
  2542. */
  2543. kICMImageCompressorPropertyID_EnforcedFieldInfo = FOUR_CHAR_CODE('enfi') /* FieldInfoImageDescriptionExtension2, Read/Sometimes Listen */
  2544. };
  2545. /*
  2546. * Summary:
  2547. * DV Compressor Component Properties.
  2548. */
  2549. enum {
  2550. /*
  2551. * Property class for DV compressors. (Applicable to DV25, DV50,
  2552. * NTSC, PAL, PROPAL.)
  2553. */
  2554. kQTPropertyClass_DVCompressor = FOUR_CHAR_CODE('dvco'),
  2555. /*
  2556. * If set, indicates that the compressed frames should be marked as
  2557. * progressive-scan. By default, this flag is clear, meaning that
  2558. * frames should be marked as interlaced.
  2559. */
  2560. kDVCompressorPropertyID_ProgressiveScan = FOUR_CHAR_CODE('prog'), /* Boolean, Read/Write */
  2561. /*
  2562. * If set, indicates that the compressor should use a 16:9 picture
  2563. * aspect ratio. If clear, the compressor will use the default 4:3
  2564. * picture aspect ratio.
  2565. */
  2566. kDVCompressorPropertyID_AspectRatio16x9 = FOUR_CHAR_CODE('16x9') /* Boolean, Read/Write */
  2567. };
  2568. /* source identifier -- placed in root container of description, one or more required */
  2569. enum {
  2570. kEffectSourceName = FOUR_CHAR_CODE('src ')
  2571. };
  2572. /* source type -- placed in the input map to identify the source kind */
  2573. enum {
  2574. kEffectDataSourceType = FOUR_CHAR_CODE('dtst')
  2575. };
  2576. /* default effect types */
  2577. enum {
  2578. kEffectRawSource = 0, /* the source is raw image data*/
  2579. kEffectGenericType = FOUR_CHAR_CODE('geff') /* generic effect for combining others*/
  2580. };
  2581. typedef struct EffectSource EffectSource;
  2582. typedef EffectSource * EffectSourcePtr;
  2583. union SourceData {
  2584. CDSequenceDataSourcePtr image;
  2585. EffectSourcePtr effect;
  2586. };
  2587. typedef union SourceData SourceData;
  2588. struct EffectSource {
  2589. long effectType; /* type of effect or kEffectRawSource if raw ICM data*/
  2590. Ptr data; /* track data for this effect*/
  2591. SourceData source; /* source/effect pointers*/
  2592. EffectSourcePtr next; /* the next source for the parent effect*/
  2593. /* fields added for QuickTime 4.0*/
  2594. TimeValue lastTranslatedFrameTime; /* start frame time of last converted frame, may be -1*/
  2595. TimeValue lastFrameDuration; /* duration of the last converted frame, may be zero*/
  2596. TimeValue lastFrameTimeScale; /* time scale of this source frame, only has meaning if above fields are valid*/
  2597. };
  2598. struct ICMFrameTimeRecord_QT3 {
  2599. wide value; /* frame display time*/
  2600. long scale; /* timescale of value/duration fields*/
  2601. void * base; /* timebase*/
  2602. long duration; /* duration frame is to be displayed (0 if unknown)*/
  2603. Fixed rate; /* rate of timebase relative to wall-time*/
  2604. long recordSize; /* total number of bytes in ICMFrameTimeRecord*/
  2605. long frameNumber; /* number of frame, zero if not known*/
  2606. long flags;
  2607. wide virtualStartTime; /* conceptual start time*/
  2608. long virtualDuration; /* conceptual duration*/
  2609. };
  2610. typedef struct ICMFrameTimeRecord_QT3 ICMFrameTimeRecord_QT3;
  2611. struct EffectsFrameParams {
  2612. ICMFrameTimeRecord_QT3 frameTime; /* timing data (uses non-extended ICMFrameTimeRecord)*/
  2613. long effectDuration; /* the duration of a single effect frame*/
  2614. Boolean doAsync; /* set to true if the effect can go async*/
  2615. unsigned char pad[3];
  2616. EffectSourcePtr source; /* ptr to the source input tree*/
  2617. void * refCon; /* storage for the effect*/
  2618. };
  2619. typedef struct EffectsFrameParams EffectsFrameParams;
  2620. typedef EffectsFrameParams * EffectsFrameParamsPtr;
  2621. /*
  2622. * ImageCodecEffectSetup()
  2623. *
  2624. * Availability:
  2625. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2626. * CarbonLib: in CarbonLib 1.0 and later
  2627. * Mac OS X: in version 10.0 and later
  2628. * Windows: in qtmlClient.lib 3.0 and later
  2629. */
  2630. EXTERN_API( ComponentResult )
  2631. ImageCodecEffectSetup(
  2632. ComponentInstance effect,
  2633. CodecDecompressParams * p) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0300, 0x7000, 0xA82A);
  2634. /*
  2635. * ImageCodecEffectBegin()
  2636. *
  2637. * Availability:
  2638. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2639. * CarbonLib: in CarbonLib 1.0 and later
  2640. * Mac OS X: in version 10.0 and later
  2641. * Windows: in qtmlClient.lib 3.0 and later
  2642. */
  2643. EXTERN_API( ComponentResult )
  2644. ImageCodecEffectBegin(
  2645. ComponentInstance effect,
  2646. CodecDecompressParams * p,
  2647. EffectsFrameParamsPtr ePtr) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0301, 0x7000, 0xA82A);
  2648. /*
  2649. * ImageCodecEffectRenderFrame()
  2650. *
  2651. * Availability:
  2652. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2653. * CarbonLib: in CarbonLib 1.0 and later
  2654. * Mac OS X: in version 10.0 and later
  2655. * Windows: in qtmlClient.lib 3.0 and later
  2656. */
  2657. EXTERN_API( ComponentResult )
  2658. ImageCodecEffectRenderFrame(
  2659. ComponentInstance effect,
  2660. EffectsFrameParamsPtr p) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0302, 0x7000, 0xA82A);
  2661. /*
  2662. * ImageCodecEffectConvertEffectSourceToFormat()
  2663. *
  2664. * Availability:
  2665. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2666. * CarbonLib: in CarbonLib 1.0 and later
  2667. * Mac OS X: in version 10.0 and later
  2668. * Windows: in qtmlClient.lib 3.0 and later
  2669. */
  2670. EXTERN_API( ComponentResult )
  2671. ImageCodecEffectConvertEffectSourceToFormat(
  2672. ComponentInstance effect,
  2673. EffectSourcePtr sourceToConvert,
  2674. ImageDescriptionHandle requestedDesc) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0303, 0x7000, 0xA82A);
  2675. /*
  2676. * ImageCodecEffectCancel()
  2677. *
  2678. * Availability:
  2679. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2680. * CarbonLib: in CarbonLib 1.0 and later
  2681. * Mac OS X: in version 10.0 and later
  2682. * Windows: in qtmlClient.lib 3.0 and later
  2683. */
  2684. EXTERN_API( ComponentResult )
  2685. ImageCodecEffectCancel(
  2686. ComponentInstance effect,
  2687. EffectsFrameParamsPtr p) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0304, 0x7000, 0xA82A);
  2688. /*
  2689. * ImageCodecEffectGetSpeed()
  2690. *
  2691. * Availability:
  2692. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2693. * CarbonLib: in CarbonLib 1.0 and later
  2694. * Mac OS X: in version 10.0 and later
  2695. * Windows: in qtmlClient.lib 3.0 and later
  2696. */
  2697. EXTERN_API( ComponentResult )
  2698. ImageCodecEffectGetSpeed(
  2699. ComponentInstance effect,
  2700. QTAtomContainer parameters,
  2701. Fixed * pFPS) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0305, 0x7000, 0xA82A);
  2702. enum {
  2703. kSMPTENoFlag = 0,
  2704. kSMPTESmoothEdgeFlag = 0x01, /* smooth edges of the stroke*/
  2705. kSMPTEStrokeEdgeFlag = 0x02 /* stroke edge with color*/
  2706. };
  2707. typedef long SMPTEFlags;
  2708. typedef long SMPTEFrameReference;
  2709. enum {
  2710. kSlideHorizontalWipe = 1,
  2711. kSlideVerticalWipe = 2,
  2712. kTopLeftWipe = 3,
  2713. kTopRightWipe = 4,
  2714. kBottomRightWipe = 5,
  2715. kBottomLeftWipe = 6,
  2716. kFourCornerWipe = 7,
  2717. kFourBoxWipe = 8,
  2718. kBarnVerticalWipe = 21,
  2719. kBarnHorizontalWipe = 22,
  2720. kTopCenterWipe = 23,
  2721. kRightCenterWipe = 24,
  2722. kBottomCenterWipe = 25,
  2723. kLeftCenterWipe = 26,
  2724. kDiagonalLeftDownWipe = 41,
  2725. kDiagonalRightDownWipe = 42,
  2726. kTopBottomBowTieWipe = 43,
  2727. kLeftRightBowTieWipe = 44,
  2728. kDiagonalLeftOutWipe = 45,
  2729. kDiagonalRightOutWipe = 46,
  2730. kDiagonalCrossWipe = 47,
  2731. kDiagonalBoxWipe = 48,
  2732. kFilledVWipe = 61,
  2733. kFilledVRightWipe = 62,
  2734. kFilledVBottomWipe = 63,
  2735. kFilledVLeftWipe = 64,
  2736. kHollowVWipe = 65,
  2737. kHollowVRightWipe = 66,
  2738. kHollowVBottomWipe = 67,
  2739. kHollowVLeftWipe = 68,
  2740. kVerticalZigZagWipe = 71,
  2741. kHorizontalZigZagWipe = 72,
  2742. kVerticalBarnZigZagWipe = 73,
  2743. kHorizontalBarnZigZagWipe = 74
  2744. };
  2745. enum {
  2746. kRectangleWipe = 101,
  2747. kDiamondWipe = 102,
  2748. kTriangleWipe = 103,
  2749. kTriangleRightWipe = 104,
  2750. kTriangleUpsideDownWipe = 105,
  2751. kTriangleLeftWipe = 106,
  2752. kSpaceShipWipe = 107,
  2753. kSpaceShipRightWipe = 108,
  2754. kSpaceShipUpsideDownWipe = 109,
  2755. kSpaceShipLeftWipe = 110,
  2756. kPentagonWipe = 111,
  2757. kPentagonUpsideDownWipe = 112,
  2758. kHexagonWipe = 113,
  2759. kHexagonSideWipe = 114,
  2760. kCircleWipe = 119,
  2761. kOvalWipe = 120,
  2762. kOvalSideWipe = 121,
  2763. kCatEyeWipe = 122,
  2764. kCatEyeSideWipe = 123,
  2765. kRoundRectWipe = 124,
  2766. kRoundRectSideWipe = 125,
  2767. kFourPointStarWipe = 127,
  2768. kFivePointStarWipe = 128,
  2769. kStarOfDavidWipe = 129,
  2770. kHeartWipe = 130,
  2771. kKeyholeWipe = 131
  2772. };
  2773. enum {
  2774. kRotatingTopWipe = 201,
  2775. kRotatingRightWipe = 202,
  2776. kRotatingBottomWipe = 203,
  2777. kRotatingLeftWipe = 204,
  2778. kRotatingTopBottomWipe = 205,
  2779. kRotatingLeftRightWipe = 206,
  2780. kRotatingQuadrantWipe = 207,
  2781. kTopToBottom180Wipe = 211,
  2782. kRightToLeft180Wipe = 212,
  2783. kTopToBottom90Wipe = 213,
  2784. kRightToLeft90Wipe = 214,
  2785. kTop180Wipe = 221,
  2786. kRight180Wipe = 222,
  2787. kBottom180Wipe = 223,
  2788. kLeft180Wipe = 224,
  2789. kCounterRotatingTopBottomWipe = 225,
  2790. kCounterRotatingLeftRightWipe = 226,
  2791. kDoubleRotatingTopBottomWipe = 227,
  2792. kDoubleRotatingLeftRightWipe = 228,
  2793. kVOpenTopWipe = 231,
  2794. kVOpenRightWipe = 232,
  2795. kVOpenBottomWipe = 233,
  2796. kVOpenLeftWipe = 234,
  2797. kVOpenTopBottomWipe = 235,
  2798. kVOpenLeftRightWipe = 236,
  2799. kRotatingTopLeftWipe = 241,
  2800. kRotatingBottomLeftWipe = 242,
  2801. kRotatingBottomRightWipe = 243,
  2802. kRotatingTopRightWipe = 244,
  2803. kRotatingTopLeftBottomRightWipe = 245,
  2804. kRotatingBottomLeftTopRightWipe = 246,
  2805. kRotatingTopLeftRightWipe = 251,
  2806. kRotatingLeftTopBottomWipe = 252,
  2807. kRotatingBottomLeftRightWipe = 253,
  2808. kRotatingRightTopBottomWipe = 254,
  2809. kRotatingDoubleCenterRightWipe = 261,
  2810. kRotatingDoubleCenterTopWipe = 262,
  2811. kRotatingDoubleCenterTopBottomWipe = 263,
  2812. kRotatingDoubleCenterLeftRightWipe = 264
  2813. };
  2814. enum {
  2815. kHorizontalMatrixWipe = 301,
  2816. kVerticalMatrixWipe = 302,
  2817. kTopLeftDiagonalMatrixWipe = 303,
  2818. kTopRightDiagonalMatrixWipe = 304,
  2819. kBottomRightDiagonalMatrixWipe = 305,
  2820. kBottomLeftDiagonalMatrixWipe = 306,
  2821. kClockwiseTopLeftMatrixWipe = 310,
  2822. kClockwiseTopRightMatrixWipe = 311,
  2823. kClockwiseBottomRightMatrixWipe = 312,
  2824. kClockwiseBottomLeftMatrixWipe = 313,
  2825. kCounterClockwiseTopLeftMatrixWipe = 314,
  2826. kCounterClockwiseTopRightMatrixWipe = 315,
  2827. kCounterClockwiseBottomRightMatrixWipe = 316,
  2828. kCounterClockwiseBottomLeftMatrixWipe = 317,
  2829. kVerticalStartTopMatrixWipe = 320,
  2830. kVerticalStartBottomMatrixWipe = 321,
  2831. kVerticalStartTopOppositeMatrixWipe = 322,
  2832. kVerticalStartBottomOppositeMatrixWipe = 323,
  2833. kHorizontalStartLeftMatrixWipe = 324,
  2834. kHorizontalStartRightMatrixWipe = 325,
  2835. kHorizontalStartLeftOppositeMatrixWipe = 326,
  2836. kHorizontalStartRightOppositeMatrixWipe = 327,
  2837. kDoubleDiagonalTopRightMatrixWipe = 328,
  2838. kDoubleDiagonalBottomRightMatrixWipe = 329,
  2839. kDoubleSpiralTopMatixWipe = 340,
  2840. kDoubleSpiralBottomMatixWipe = 341,
  2841. kDoubleSpiralLeftMatixWipe = 342,
  2842. kDoubleSpiralRightMatixWipe = 343,
  2843. kQuadSpiralVerticalMatixWipe = 344,
  2844. kQuadSpiralHorizontalMatixWipe = 345,
  2845. kVerticalWaterfallLeftMatrixWipe = 350,
  2846. kVerticalWaterfallRightMatrixWipe = 351,
  2847. kHorizontalWaterfallLeftMatrixWipe = 352,
  2848. kHorizontalWaterfallRightMatrixWipe = 353,
  2849. kRandomWipe = 409, /* non-SMPTE standard numbers*/
  2850. kRandomWipeGroupWipe = 501,
  2851. kRandomIrisGroupWipe = 502,
  2852. kRandomRadialGroupWipe = 503,
  2853. kRandomMatrixGroupWipe = 504
  2854. };
  2855. typedef unsigned long SMPTEWipeType;
  2856. /*
  2857. * ImageCodecEffectPrepareSMPTEFrame()
  2858. *
  2859. * Availability:
  2860. * Non-Carbon CFM: in QuickTimeLib 4.0 and later
  2861. * CarbonLib: in CarbonLib 1.0.2 and later
  2862. * Mac OS X: in version 10.0 and later
  2863. * Windows: in qtmlClient.lib 4.0 and later
  2864. */
  2865. EXTERN_API( ComponentResult )
  2866. ImageCodecEffectPrepareSMPTEFrame(
  2867. ComponentInstance effect,
  2868. PixMapPtr destPixMap,
  2869. SMPTEFrameReference * returnValue) FIVEWORDINLINE(0x2F3C, 0x0008, 0x0100, 0x7000, 0xA82A);
  2870. /*
  2871. * ImageCodecEffectDisposeSMPTEFrame()
  2872. *
  2873. * Availability:
  2874. * Non-Carbon CFM: in QuickTimeLib 4.0 and later
  2875. * CarbonLib: in CarbonLib 1.0.2 and later
  2876. * Mac OS X: in version 10.0 and later
  2877. * Windows: in qtmlClient.lib 4.0 and later
  2878. */
  2879. EXTERN_API( ComponentResult )
  2880. ImageCodecEffectDisposeSMPTEFrame(
  2881. ComponentInstance effect,
  2882. SMPTEFrameReference frameRef) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0101, 0x7000, 0xA82A);
  2883. /*
  2884. * ImageCodecEffectRenderSMPTEFrame()
  2885. *
  2886. * Availability:
  2887. * Non-Carbon CFM: in QuickTimeLib 4.0 and later
  2888. * CarbonLib: in CarbonLib 1.0.2 and later
  2889. * Mac OS X: in version 10.0 and later
  2890. * Windows: in qtmlClient.lib 4.0 and later
  2891. */
  2892. EXTERN_API( ComponentResult )
  2893. ImageCodecEffectRenderSMPTEFrame(
  2894. ComponentInstance effect,
  2895. PixMapPtr destPixMap,
  2896. SMPTEFrameReference frameRef,
  2897. Fixed effectPercentageEven,
  2898. Fixed effectPercentageOdd,
  2899. Rect * pSourceRect,
  2900. MatrixRecord * matrixP,
  2901. SMPTEWipeType effectNumber,
  2902. long xRepeat,
  2903. long yRepeat,
  2904. SMPTEFlags flags,
  2905. Fixed penWidth,
  2906. long strokeValue) FIVEWORDINLINE(0x2F3C, 0x0030, 0x0102, 0x7000, 0xA82A);
  2907. /* selectors for component calls */
  2908. enum {
  2909. kImageCodecEffectSetupSelect = 0x0300,
  2910. kImageCodecEffectBeginSelect = 0x0301,
  2911. kImageCodecEffectRenderFrameSelect = 0x0302,
  2912. kImageCodecEffectConvertEffectSourceToFormatSelect = 0x0303,
  2913. kImageCodecEffectCancelSelect = 0x0304,
  2914. kImageCodecEffectGetSpeedSelect = 0x0305,
  2915. kImageCodecEffectPrepareSMPTEFrameSelect = 0x0100,
  2916. kImageCodecEffectDisposeSMPTEFrameSelect = 0x0101,
  2917. kImageCodecEffectRenderSMPTEFrameSelect = 0x0102
  2918. };
  2919. /* curve atom types and data structures */
  2920. enum {
  2921. kCurvePathAtom = FOUR_CHAR_CODE('path'),
  2922. kCurveEndAtom = FOUR_CHAR_CODE('zero'),
  2923. kCurveAntialiasControlAtom = FOUR_CHAR_CODE('anti'),
  2924. kCurveAntialiasOff = 0,
  2925. kCurveAntialiasOn = (long)0xFFFFFFFF,
  2926. kCurveFillTypeAtom = FOUR_CHAR_CODE('fill'),
  2927. kCurvePenThicknessAtom = FOUR_CHAR_CODE('pent'),
  2928. kCurveMiterLimitAtom = FOUR_CHAR_CODE('mitr'),
  2929. kCurveJoinAttributesAtom = FOUR_CHAR_CODE('join'),
  2930. kCurveMinimumDepthAtom = FOUR_CHAR_CODE('mind'),
  2931. kCurveDepthAlwaysOffscreenMask = (long)0x80000000,
  2932. kCurveTransferModeAtom = FOUR_CHAR_CODE('xfer'),
  2933. kCurveGradientAngleAtom = FOUR_CHAR_CODE('angl'),
  2934. kCurveGradientRadiusAtom = FOUR_CHAR_CODE('radi'),
  2935. kCurveGradientOffsetAtom = FOUR_CHAR_CODE('cent')
  2936. };
  2937. enum {
  2938. kCurveARGBColorAtom = FOUR_CHAR_CODE('argb')
  2939. };
  2940. struct ARGBColor {
  2941. unsigned short alpha;
  2942. unsigned short red;
  2943. unsigned short green;
  2944. unsigned short blue;
  2945. };
  2946. typedef struct ARGBColor ARGBColor;
  2947. enum {
  2948. kCurveGradientRecordAtom = FOUR_CHAR_CODE('grad')
  2949. };
  2950. struct GradientColorRecord {
  2951. ARGBColor thisColor;
  2952. Fixed endingPercentage;
  2953. };
  2954. typedef struct GradientColorRecord GradientColorRecord;
  2955. typedef GradientColorRecord * GradientColorPtr;
  2956. enum {
  2957. kCurveGradientTypeAtom = FOUR_CHAR_CODE('grdt')
  2958. };
  2959. /* currently supported gradient types */
  2960. enum {
  2961. kLinearGradient = 0,
  2962. kCircularGradient = 1
  2963. };
  2964. typedef long GradientType;
  2965. /*
  2966. * CurveGetLength()
  2967. *
  2968. * Availability:
  2969. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2970. * CarbonLib: in CarbonLib 1.0 and later
  2971. * Mac OS X: in version 10.0 and later
  2972. * Windows: in qtmlClient.lib 3.0 and later
  2973. */
  2974. EXTERN_API( ComponentResult )
  2975. CurveGetLength(
  2976. ComponentInstance effect,
  2977. gxPaths * target,
  2978. long index,
  2979. wide * wideLength) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0100, 0x7000, 0xA82A);
  2980. /*
  2981. * CurveLengthToPoint()
  2982. *
  2983. * Availability:
  2984. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  2985. * CarbonLib: in CarbonLib 1.0 and later
  2986. * Mac OS X: in version 10.0 and later
  2987. * Windows: in qtmlClient.lib 3.0 and later
  2988. */
  2989. EXTERN_API( ComponentResult )
  2990. CurveLengthToPoint(
  2991. ComponentInstance effect,
  2992. gxPaths * target,
  2993. long index,
  2994. Fixed length,
  2995. FixedPoint * location,
  2996. FixedPoint * tangent) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0101, 0x7000, 0xA82A);
  2997. /*
  2998. * CurveNewPath()
  2999. *
  3000. * Availability:
  3001. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3002. * CarbonLib: in CarbonLib 1.0 and later
  3003. * Mac OS X: in version 10.0 and later
  3004. * Windows: in qtmlClient.lib 3.0 and later
  3005. */
  3006. EXTERN_API( ComponentResult )
  3007. CurveNewPath(
  3008. ComponentInstance effect,
  3009. Handle * pPath) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0102, 0x7000, 0xA82A);
  3010. /*
  3011. * CurveCountPointsInPath()
  3012. *
  3013. * Availability:
  3014. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3015. * CarbonLib: in CarbonLib 1.0 and later
  3016. * Mac OS X: in version 10.0 and later
  3017. * Windows: in qtmlClient.lib 3.0 and later
  3018. */
  3019. EXTERN_API( ComponentResult )
  3020. CurveCountPointsInPath(
  3021. ComponentInstance effect,
  3022. gxPaths * aPath,
  3023. unsigned long contourIndex,
  3024. unsigned long * pCount) FIVEWORDINLINE(0x2F3C, 0x000C, 0x0103, 0x7000, 0xA82A);
  3025. /*
  3026. * CurveGetPathPoint()
  3027. *
  3028. * Availability:
  3029. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3030. * CarbonLib: in CarbonLib 1.0 and later
  3031. * Mac OS X: in version 10.0 and later
  3032. * Windows: in qtmlClient.lib 3.0 and later
  3033. */
  3034. EXTERN_API( ComponentResult )
  3035. CurveGetPathPoint(
  3036. ComponentInstance effect,
  3037. gxPaths * aPath,
  3038. unsigned long contourIndex,
  3039. unsigned long pointIndex,
  3040. gxPoint * thePoint,
  3041. Boolean * ptIsOnPath) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0104, 0x7000, 0xA82A);
  3042. /*
  3043. * CurveInsertPointIntoPath()
  3044. *
  3045. * Availability:
  3046. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3047. * CarbonLib: in CarbonLib 1.0 and later
  3048. * Mac OS X: in version 10.0 and later
  3049. * Windows: in qtmlClient.lib 3.0 and later
  3050. */
  3051. EXTERN_API( ComponentResult )
  3052. CurveInsertPointIntoPath(
  3053. ComponentInstance effect,
  3054. gxPoint * aPoint,
  3055. Handle thePath,
  3056. unsigned long contourIndex,
  3057. unsigned long pointIndex,
  3058. Boolean ptIsOnPath) FIVEWORDINLINE(0x2F3C, 0x0012, 0x0105, 0x7000, 0xA82A);
  3059. /*
  3060. * CurveSetPathPoint()
  3061. *
  3062. * Availability:
  3063. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3064. * CarbonLib: in CarbonLib 1.0 and later
  3065. * Mac OS X: in version 10.0 and later
  3066. * Windows: in qtmlClient.lib 3.0 and later
  3067. */
  3068. EXTERN_API( ComponentResult )
  3069. CurveSetPathPoint(
  3070. ComponentInstance effect,
  3071. gxPaths * aPath,
  3072. unsigned long contourIndex,
  3073. unsigned long pointIndex,
  3074. gxPoint * thePoint,
  3075. Boolean ptIsOnPath) FIVEWORDINLINE(0x2F3C, 0x0012, 0x0106, 0x7000, 0xA82A);
  3076. /*
  3077. * CurveGetNearestPathPoint()
  3078. *
  3079. * Availability:
  3080. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3081. * CarbonLib: in CarbonLib 1.0 and later
  3082. * Mac OS X: in version 10.0 and later
  3083. * Windows: in qtmlClient.lib 3.0 and later
  3084. */
  3085. EXTERN_API( ComponentResult )
  3086. CurveGetNearestPathPoint(
  3087. ComponentInstance effect,
  3088. gxPaths * aPath,
  3089. FixedPoint * thePoint,
  3090. unsigned long * contourIndex,
  3091. unsigned long * pointIndex,
  3092. Fixed * theDelta) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0107, 0x7000, 0xA82A);
  3093. /*
  3094. * CurvePathPointToLength()
  3095. *
  3096. * Availability:
  3097. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3098. * CarbonLib: in CarbonLib 1.0 and later
  3099. * Mac OS X: in version 10.0 and later
  3100. * Windows: in qtmlClient.lib 3.0 and later
  3101. */
  3102. EXTERN_API( ComponentResult )
  3103. CurvePathPointToLength(
  3104. ComponentInstance ci,
  3105. gxPaths * aPath,
  3106. Fixed startDist,
  3107. Fixed endDist,
  3108. FixedPoint * thePoint,
  3109. Fixed * pLength) FIVEWORDINLINE(0x2F3C, 0x0014, 0x0108, 0x7000, 0xA82A);
  3110. /*
  3111. * CurveCreateVectorStream()
  3112. *
  3113. * Availability:
  3114. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3115. * CarbonLib: in CarbonLib 1.0 and later
  3116. * Mac OS X: in version 10.0 and later
  3117. * Windows: in qtmlClient.lib 3.0 and later
  3118. */
  3119. EXTERN_API( ComponentResult )
  3120. CurveCreateVectorStream(
  3121. ComponentInstance effect,
  3122. Handle * pStream) FIVEWORDINLINE(0x2F3C, 0x0004, 0x0109, 0x7000, 0xA82A);
  3123. /*
  3124. * CurveAddAtomToVectorStream()
  3125. *
  3126. * Availability:
  3127. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3128. * CarbonLib: in CarbonLib 1.0 and later
  3129. * Mac OS X: in version 10.0 and later
  3130. * Windows: in qtmlClient.lib 3.0 and later
  3131. */
  3132. EXTERN_API( ComponentResult )
  3133. CurveAddAtomToVectorStream(
  3134. ComponentInstance effect,
  3135. OSType atomType,
  3136. Size atomSize,
  3137. void * pAtomData,
  3138. Handle vectorStream) FIVEWORDINLINE(0x2F3C, 0x0010, 0x010A, 0x7000, 0xA82A);
  3139. /*
  3140. * CurveAddPathAtomToVectorStream()
  3141. *
  3142. * Availability:
  3143. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3144. * CarbonLib: in CarbonLib 1.0 and later
  3145. * Mac OS X: in version 10.0 and later
  3146. * Windows: in qtmlClient.lib 3.0 and later
  3147. */
  3148. EXTERN_API( ComponentResult )
  3149. CurveAddPathAtomToVectorStream(
  3150. ComponentInstance effect,
  3151. Handle pathData,
  3152. Handle vectorStream) FIVEWORDINLINE(0x2F3C, 0x0008, 0x010B, 0x7000, 0xA82A);
  3153. /*
  3154. * CurveAddZeroAtomToVectorStream()
  3155. *
  3156. * Availability:
  3157. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3158. * CarbonLib: in CarbonLib 1.0 and later
  3159. * Mac OS X: in version 10.0 and later
  3160. * Windows: in qtmlClient.lib 3.0 and later
  3161. */
  3162. EXTERN_API( ComponentResult )
  3163. CurveAddZeroAtomToVectorStream(
  3164. ComponentInstance effect,
  3165. Handle vectorStream) FIVEWORDINLINE(0x2F3C, 0x0004, 0x010C, 0x7000, 0xA82A);
  3166. /*
  3167. * CurveGetAtomDataFromVectorStream()
  3168. *
  3169. * Availability:
  3170. * Non-Carbon CFM: in QuickTimeLib 3.0 and later
  3171. * CarbonLib: in CarbonLib 1.0 and later
  3172. * Mac OS X: in version 10.0 and later
  3173. * Windows: in qtmlClient.lib 3.0 and later
  3174. */
  3175. EXTERN_API( ComponentResult )
  3176. CurveGetAtomDataFromVectorStream(
  3177. ComponentInstance effect,
  3178. Handle vectorStream,
  3179. long atomType,
  3180. long * dataSize,
  3181. Ptr * dataPtr) FIVEWORDINLINE(0x2F3C, 0x0010, 0x010D, 0x7000, 0xA82A);
  3182. /* selectors for component calls */
  3183. enum {
  3184. kCurveGetLengthSelect = 0x0100,
  3185. kCurveLengthToPointSelect = 0x0101,
  3186. kCurveNewPathSelect = 0x0102,
  3187. kCurveCountPointsInPathSelect = 0x0103,
  3188. kCurveGetPathPointSelect = 0x0104,
  3189. kCurveInsertPointIntoPathSelect = 0x0105,
  3190. kCurveSetPathPointSelect = 0x0106,
  3191. kCurveGetNearestPathPointSelect = 0x0107,
  3192. kCurvePathPointToLengthSelect = 0x0108,
  3193. kCurveCreateVectorStreamSelect = 0x0109,
  3194. kCurveAddAtomToVectorStreamSelect = 0x010A,
  3195. kCurveAddPathAtomToVectorStreamSelect = 0x010B,
  3196. kCurveAddZeroAtomToVectorStreamSelect = 0x010C,
  3197. kCurveGetAtomDataFromVectorStreamSelect = 0x010D
  3198. };
  3199. /* UPP call backs */
  3200. #endif // !__LP64__
  3201. #if PRAGMA_STRUCT_ALIGN
  3202. #pragma options align=reset
  3203. #elif PRAGMA_STRUCT_PACKPUSH
  3204. #pragma pack(pop)
  3205. #elif PRAGMA_STRUCT_PACK
  3206. #pragma pack()
  3207. #endif
  3208. #ifdef PRAGMA_IMPORT_OFF
  3209. #pragma import off
  3210. #elif PRAGMA_IMPORT
  3211. #pragma import reset
  3212. #endif
  3213. #ifdef __cplusplus
  3214. }
  3215. #endif
  3216. #endif /* __IMAGECODEC__ */