Import and Export Reference for QuickTime

Framework
Frameworks/QuickTime.framework
Declared in
Dialogs.h
ImageCompression.h

Overview

Image importers and exporters manage the import and export of graphic images, such as JPEG, TIFF, Photoshop, and PNG. Movie data exchange components support the import and export of other multimedia formats, such as AIFF, WAVE, AVI, MPEG-1, MIDI, MPEG-4, 3GPP, MP3, MPEG-2, H.263, and OpenDML. QuickTime can open any format file for which it has an importer and create any for which it has an exporter.

Functions by Task

Accessing a Graphics Exporter's Input Image

Accessing Graphics Exporter Settings

Drawing Imported Images

Finding Out About Graphics Export Image Formats

Getting and Setting Progress Procs

Getting Image Characteristics

Getting MIME Types

Internal Graphics Export Routines

Managing Graphics Importers

Obtaining Graphics Exporter Settings

Reading Graphics Exporter Input Data

Restricting the Range of an Input Image's Source

Saving Image Files

Setting Drawing Parameters

Specifying a Graphics Import Data Source

Specifying Destinations for Output Images

Specifying Sources for Graphics Exporter Input Images

Working With Exif Files

Writing Graphics Exporter Output Data

Supporting Functions

Functions

Callbacks

ModalFilterYDProc

Determines how the Dialog Manager filters events.

typedef Boolean (*ModalFilterYDProcPtr) (DialogPtr theDialog, EventRecord *theEvent, short *itemHit, void *yourDataPtr);

If you name your function MyModalFilterYDProc, you would declare it this way:

Boolean MyModalFilterYDProc (
   DialogPtr      theDialog,
   EventRecord    *theEvent,
   short          *itemHit,
   void           *yourDataPtr );

Parameters
theDialog

A pointer to the dialog record.

theEvent

A pointer to the event record.

itemHit

The item number.

yourDataPtr

A pointer to the data received from your application, if any.

Return Value

Your ModalFilterProc callback returns a Boolean value that reports whether it handled the event. If your function returns a value of FALSE, QuickTime processes the event through its own filters. If your function returns a value of TRUE, QuickTime returns with no further action.

Discussion

The ModalFilterProc callback used with custom file dialogs requires the additional yourDataPtr parameter.

Declared In
ImageCompression.h

Data Types

GraphicsExportComponent

Represents a type used by the Graphics Import and Export API.

typedef ComponentInstance GraphicsExportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
ImageCompression.h

GraphicsImportComponent

Represents a type used by the Graphics Import and Export API.

typedef ComponentInstance GraphicsImportComponent;
Availability
  • Available in OS X v10.0 and later.
  • Not available to 64-bit applications.
Declared In
ImageCompression.h

ModalFilterYDUPP

Represents a type used by the Graphics Import and Export API.

typedef STACK_UPP_TYPE(ModalFilterYDProcPtr) ModalFilterYDUPP;
Availability
  • Available in OS X v10.0 and later.
Declared In
Dialogs.h

Constants

GraphicsImportDoesDrawAllPixels Values

Constants passed to GraphicsImportDoesDrawAllPixels.

enum {
   graphicsImporterDrawsAllPixels = 0,
   graphicsImporterDoesntDrawAllPixels = 1,
   graphicsImporterDontKnowIfDrawAllPixels = 2
};
Declared In
ImageCompression.h

Graphics Importer Flags

Constants that represent the flags of graphics importers.

enum {
   graphicsImporterIsBaseImporter = 1L << 0,
   graphicsImporterCanValidateFile = 1L << 9,
   graphicsImporterSubTypeIsFileExtension = 1L << 12,
   graphicsImporterHasMIMEList   = 1L << 14,
   graphicsImporterUsesImageDecompressor = 1L << 23
};
enum {
   kGraphicsImporterDontDoGammaCorrection = 1L << 0,
   kGraphicsImporterTrustResolutionFromFile = 1L << 1,
   kGraphicsImporterEnableSubPixelPositioning = 1L << 2,
   kGraphicsImporterDontUseColorMatching = 1L << 3 /* set this flag (*before* calling GraphicsImportGetColorSyncProfile) if you do matching yourself */
};
Declared In
ImageCompression.h

GraphicsImportCreateCGImage Values

Constants passed to GraphicsImportCreateCGImage.

enum {
   kGraphicsImportCreateCGImageUsingCurrentSettings = 1L << 0
};
Declared In
ImageCompression.h

PNG Properties

Constants that represent the properties of PNGs.

enum {
   kQTPNGFilterPreference        = 'pngf', /* UInt32*/
   kQTPNGFilterBestForColorType  = 'bflt',
   kQTPNGFilterNone              = 0,
   kQTPNGFilterSub               = 1,
   kQTPNGFilterUp                = 2,
   kQTPNGFilterAverage           = 3,
   kQTPNGFilterPaeth             = 4,
   kQTPNGFilterAdaptivePerRow    = 'aflt',
   kQTPNGInterlaceStyle          = 'ilac', /* UInt32*/
   kQTPNGInterlaceNone           = 0,
   kQTPNGInterlaceAdam7          = 1
};
Constants
kQTPNGFilterPreference

UInt32.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTPNGInterlaceStyle

UInt32.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

Declared In
ImageCompression.h

TIFF Properties

Constants that represent the properties of TIFFs.

enum {
   kQTTIFFCompressionMethod      = 'tifc', /* UInt32*/
   kQTTIFFCompression_None       = 1,
   kQTTIFFCompression_PackBits   = 32773L,
   kQTTIFFLittleEndian           = 'tife' /* UInt8 (boolean)*/
};
enum {
   kQTTIFFUserDataModelPixelScale = 0x7469830E, /* 3 DOUBLEs */
   kQTTIFFUserDataModelTransformation = 0x746985D8, /* 16 DOUBLEs */
   kQTTIFFUserDataModelTiepoint  = 0x74698482, /* n DOUBLEs */
   kQTTIFFUserDataGeoKeyDirectory = 0x746987AF, /* n SHORTs */
   kQTTIFFUserDataGeoDoubleParams = 0x746987B0, /* n DOUBLEs */
   kQTTIFFUserDataGeoAsciiParams = 0x746987B1, /* n ASCIIs */
   kQTTIFFUserDataIntergraphMatrix = 0x74698480 /* 16 or 17 DOUBLEs */
};
enum {
   kQTTIFFUserDataOrientation    = 0x74690112, /* 1 SHORT */
   kQTTIFFUserDataTransferFunction = 0x7469012D, /* n SHORTs */
   kQTTIFFUserDataWhitePoint     = 0x7469013E, /* 2 RATIONALs */
   kQTTIFFUserDataPrimaryChromaticities = 0x7469013F, /* 6 RATIONALs */
   kQTTIFFUserDataTransferRange  = 0x74690156, /* 6 SHORTs */
   kQTTIFFUserDataYCbCrPositioning = 0x74690213, /* 1 SHORT */
   kQTTIFFUserDataReferenceBlackWhite = 0x74690214 /* n LONGs */
};
Constants
kQTTIFFCompressionMethod

UInt32.

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFCompression_PackBits

PackBits compression. This value is 32773L

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFLittleEndian

UInt8 (Boolean).

Available in OS X v10.0 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataModelPixelScale

3 DOUBLEs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataModelTransformation

16 DOUBLEs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataModelTiepoint

N DOUBLEs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataGeoKeyDirectory

N SHORTs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataGeoDoubleParams

N DOUBLEs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataGeoAsciiParams

N ASCIIs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataIntergraphMatrix

16 or 17 DOUBLEs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataOrientation

1 SHORT.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataTransferFunction

N SHORTs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataWhitePoint

2 RATIONALs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataPrimaryChromaticities

6 RATIONALs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataTransferRange

6 SHORTs.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

kQTTIFFUserDataYCbCrPositioning

1 SHORT.

Available in OS X v10.2 and later.

Not available to 64-bit applications.

Declared in ImageCompression.h.

Declared In
ImageCompression.h