Next Previous

Retired Document

Important: This sample code may not represent best practices for current development. The project may use deprecated symbols and illustrate technologies and techniques that are no longer recommended.

EI_ImageDecompressor/EI_Codec.r

/*

    File:       EI_Codec.r

    Description: Decompressor component resources

    Author:     QuickTime Engineering

    Copyright:  © Copyright 1999 - 2005 Apple Computer, Inc. All rights reserved.

    Disclaimer: IMPORTANT:  This Apple software is supplied to you by Apple Computer, Inc.

                ("Apple") in consideration of your agreement to the following terms, and your

                use, installation, modification or redistribution of this Apple software

                constitutes acceptance of these terms.  If you do not agree with these terms,

                please do not use, install, modify or redistribute this Apple software.

                In consideration of your agreement to abide by the following terms, and subject

                to these terms, Apple grants you a personal, non-exclusive license, under AppleÕs

                copyrights in this original Apple software (the "Apple Software"), to use,

                reproduce, modify and redistribute the Apple Software, with or without

                modifications, in source and/or binary forms; provided that if you redistribute

                the Apple Software in its entirety and without modifications, you must retain

                this notice and the following text and disclaimers in all such redistributions of

                the Apple Software.  Neither the name, trademarks, service marks or logos of

                Apple Computer, Inc. may be used to endorse or promote products derived from the

                Apple Software without specific prior written permission from Apple.  Except as

                expressly stated in this notice, no other rights or licenses, express or implied,

                are granted by Apple herein, including but not limited to any patent rights that

                may be infringed by your derivative works or by other works in which the Apple

                Software may be incorporated.

                The Apple Software is provided by Apple on an "AS IS" basis.  APPLE MAKES NO

                WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED

                WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR

                PURPOSE, REGARDING THE APPLE SOFTWARE OR ITS USE AND OPERATION ALONE OR IN

                COMBINATION WITH YOUR PRODUCTS.

                IN NO EVENT SHALL APPLE BE LIABLE FOR ANY SPECIAL, INDIRECT, INCIDENTAL OR

                CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE

                GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)

                ARISING IN ANY WAY OUT OF THE USE, REPRODUCTION, MODIFICATION AND/OR DISTRIBUTION

                OF THE APPLE SOFTWARE, HOWEVER CAUSED AND WHETHER UNDER THEORY OF CONTRACT, TORT

                (INCLUDING NEGLIGENCE), STRICT LIABILITY OR OTHERWISE, EVEN IF APPLE HAS BEEN

                ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    Change History (most recent first):

        <4>     06/28/05    dts     added X86 to platform array

        <3>     06/12/01    dts     rezability for MAC and Win

        <2>     11/17/00    dts     updating for PPC and X

        <1>     11/28/99    QTE     first file

*/

/*

    thng_RezTemplateVersion:

        0 - original 'thng' template    <-- default

        1 - extended 'thng' template    <-- used for multiplatform things

        2 - extended 'thng' template including resource map id

*/

#define thng_RezTemplateVersion 1

/*

    cfrg_RezTemplateVersion:

        0 - original                    <-- default

        1 - extended                    <-- we use the extended version

*/

#define cfrg_RezTemplateVersion 1

#if TARGET_REZ_CARBON_MACHO

    #include <Carbon/Carbon.r>

    #include <QuickTime/QuickTime.r>

    #undef __CARBON_R__

    #undef __CORESERVICES_R__

    #undef __CARBONCORE_R__

    #undef __COMPONENTS_R__

#else

    #include "ConditionalMacros.r"

    #include "MacTypes.r"

    #include "Components.r"

    #include "ImageCodec.r"

    #include "CodeFragments.r"

    #undef __COMPONENTS_R__

#endif

#include "EI_CodecVersion.h"

#define kEI_CodecFormatType 'EIDI'

#define kEI_CodecFormatName "Electric Image"

// These flags specify information about the capabilities of the component

// Works with 1-bit, 8-bit, 16-bit and 32-bit Pixel Maps

#define kEI_DecoFlags ( codecInfoDoes32 | codecInfoDoes16 | codecInfoDoes8 | codecInfoDoes1 | codecInfoDoesSpool )

// These flags specify the possible format of compressed data produced by the component

// and the format of compressed files that the component can handle during decompression

// The component can decompress from files at 1-bit, 8-bit, 16-bit, 24-bit and 32-bit depths

#define kEI_FormatFlags ( codecInfoDepth32 | codecInfoDepth24 | codecInfoDepth16 | codecInfoDepth8 | codecInfoDepth1 )

// Component Description

resource 'cdci' (256) {

    kEI_CodecFormatName,    // Type

    1,                      // Version

    1,                      // Revision level

    'appl',                 // Manufacturer

    kEI_DecoFlags,          // Decompression Flags

    0,                      // Compression Flags

    kEI_FormatFlags,        // Format Flags

    128,                    // Compression Accuracy

    128,                    // Decomression Accuracy

    200,                    // Compression Speed

    200,                    // Decompression Speed

    128,                    // Compression Level

    0,                      // Reserved

    1,                      // Minimum Height

    1,                      // Minimum Width

    0,                      // Decompression Pipeline Latency

    0,                      // Compression Pipeline Latency

    0                       // Private Data

};

resource 'thng' (256) {

    decompressorComponentType,              // Type

    'EIDI',                                 // SubType

    'appl',                                 // Manufacturer

                                            // - use componentHasMultiplePlatforms

    0,                                      // not used Component flags

    0,                                      // not used Component flags Mask

    0,                                      // not used Code Type

    0,                                      // not used Code ID

    'STR ',                                 // Name Type

    256,                                    // Name ID

    'STR ',                                 // Info Type

    257,                                    // Info ID

    0,                                      // Icon Type

    0,                                      // Icon ID

    kEI_CodecVersion,                       // Version

    componentHasMultiplePlatforms +         // Registration Flags

    componentDoAutoVersion,

    0,                                      // Resource ID of Icon Family

#if TARGET_OS_MAC

    #if TARGET_REZ_CARBON_MACHO

        #if !(TARGET_REZ_MAC_PPC || TARGET_REZ_MAC_X86)

            #error "Platform architecture not defined, TARGET_REZ_MAC_PPC and/or TARGET_REZ_MAC_X86 must be defined!"

        #endif

        #if TARGET_REZ_MAC_PPC

            kEI_DecoFlags,

            'dlle',                             // Code Resource type - Entry point found by symbol name 'dlle' resource

            256,                                // ID of 'dlle' resource

            platformPowerPCNativeEntryPoint,    // PPC

        #endif

        #if TARGET_REZ_MAC_X86

            kEI_DecoFlags,

            'dlle',

            256,

            platformIA32NativeEntryPoint,       // INTEL

        #endif

    #elif TARGET_REZ_CARBON_CFM

        #error "Obsolete, new components should not be built for this configuration."

        kEI_DecoFlags,                      // Component Flags

        'cfrg',                             // Special Case: data-fork based code fragment

        256,                                /* Code ID usage for CFM components:

                                                0 (kCFragResourceID) - This means the first member in the code fragment;

                                                    Should only be used when building a single component per file. When doing so

                                                    using kCFragResourceID simplifies things because a custom 'cfrg' resource is not required

                                                n - This value must match the special 'cpnt' qualifier 1 in the custom 'cfrg' resource */

        platformPowerPCNativeEntryPoint,    // Platform Type (response from gestaltComponentPlatform or failing that, gestaltSysArchitecture)

    #elif TARGET_REZ_MAC_PPC

        #error "Obsolete, new components should not be built for this configuration."

        kEI_DecoFlags,

        'cdek',                             // Code Type

        256,                                // Code ID

        platformPowerPC,

    #elif TARGET_REZ_MAC_68K

        #error "Obsolete, new components should not be built for this configuration."

        kEI_DecoFlags,

        'cdec',

        256,

        platform68k,

    #else

        #error "At least one TARGET_REZ_XXX_XXX platform must be defined."

    #endif

#endif

#if TARGET_OS_WIN32

    kEI_DecoFlags,

    'dlle',

    256,

    platformWin32,

#endif

};

};

// Component Name

resource 'STR ' (256) {

    "Electric Image Codec"

};

// Component Information

resource 'STR ' (257) {

    "Decompresses images stored in the Electric Image format."

};

#if TARGET_REZ_CARBON_MACHO || TARGET_REZ_WIN32

// Code Entry Point for Mach-O and Windows

    resource 'dlle' (256) {

        "EI_ImageCodecComponentDispatch"

};

#endif

#if TARGET_REZ_CARBON_CFM

// Custom extended code fragment resource

// CodeWarrior will correctly adjust the offset and length of each

// code fragment when building a MacOS Merge target

resource 'cfrg' (0) {

        extendedEntry {

            kPowerPCCFragArch,                  // archType

            kIsCompleteCFrag,                   // updateLevel

            kNoVersionNum,                      // currentVersion

            kNoVersionNum,                      // oldDefVersion

            kDefaultStackSize,                  // appStackSize

            kNoAppSubFolder,                    // appSubFolderID

            kImportLibraryCFrag,                // usage

            kDataForkCFragLocator,              // where

            kZeroOffset,                        // offset

            kCFragGoesToEOF,                    // length

            "EI Codec",                         // member name

            // Start of extended info.

            'cpnt',                             // libKind (not kFragComponentMgrComponent == 'comp' as you might expect)

            "\0x01\0x00",                       // qualifier 1 - hex 0x0100 (256) matches Code ID in 'thng'

            "",                                 // qualifier 2

            "",                                 // qualifier 3

            "Electric Image Codec",             // intlName, localised

};

};

};

#endif

Next Previous