162 lines
4.8 KiB
C++
162 lines
4.8 KiB
C++
///////////////////////////////////////////////////////////////////////////
|
|
//
|
|
// Copyright (c) 2004, Industrial Light & Magic, a division of Lucas
|
|
// Digital Ltd. LLC
|
|
//
|
|
// All rights reserved.
|
|
//
|
|
// Redistribution and use in source and binary forms, with or without
|
|
// modification, are permitted provided that the following conditions are
|
|
// met:
|
|
// * Redistributions of source code must retain the above copyright
|
|
// notice, this list of conditions and the following disclaimer.
|
|
// * Redistributions in binary form must reproduce the above
|
|
// copyright notice, this list of conditions and the following disclaimer
|
|
// in the documentation and/or other materials provided with the
|
|
// distribution.
|
|
// * Neither the name of Industrial Light & Magic nor the names of
|
|
// its contributors may be used to endorse or promote products derived
|
|
// from this software without specific prior written permission.
|
|
//
|
|
// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
|
|
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
|
|
// LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
|
|
// A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
|
|
// OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
|
|
// SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
|
|
// LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
|
// DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
|
// THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
|
// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
|
|
// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
|
//
|
|
///////////////////////////////////////////////////////////////////////////
|
|
|
|
|
|
#ifndef INCLUDED_IMF_KEY_CODE_H
|
|
#define INCLUDED_IMF_KEY_CODE_H
|
|
|
|
//-----------------------------------------------------------------------------
|
|
//
|
|
// class KeyCode
|
|
//
|
|
// A KeyCode object uniquely identifies a motion picture film frame.
|
|
// The following fields specifiy film manufacturer, film type, film
|
|
// roll and the frame's position within the roll:
|
|
//
|
|
// filmMfcCode film manufacturer code
|
|
// range: 0 - 99
|
|
//
|
|
// filmType film type code
|
|
// range: 0 - 99
|
|
//
|
|
// prefix prefix to identify film roll
|
|
// range: 0 - 999999
|
|
//
|
|
// count count, increments once every perfsPerCount
|
|
// perforations (see below)
|
|
// range: 0 - 9999
|
|
//
|
|
// perfOffset offset of frame, in perforations from
|
|
// zero-frame reference mark
|
|
// range: 0 - 119
|
|
//
|
|
// perfsPerFrame number of perforations per frame
|
|
// range: 1 - 15
|
|
//
|
|
// typical values:
|
|
//
|
|
// 1 for 16mm film
|
|
// 3, 4, or 8 for 35mm film
|
|
// 5, 8 or 15 for 65mm film
|
|
//
|
|
// perfsPerCount number of perforations per count
|
|
// range: 20 - 120
|
|
//
|
|
// typical values:
|
|
//
|
|
// 20 for 16mm film
|
|
// 64 for 35mm film
|
|
// 80 or 120 for 65mm film
|
|
//
|
|
// For more information about the interpretation of those fields see
|
|
// the following standards and recommended practice publications:
|
|
//
|
|
// SMPTE 254 Motion-Picture Film (35-mm) - Manufacturer-Printed
|
|
// Latent Image Identification Information
|
|
//
|
|
// SMPTE 268M File Format for Digital Moving-Picture Exchange (DPX)
|
|
// (section 6.1)
|
|
//
|
|
// SMPTE 270 Motion-Picture Film (65-mm) - Manufacturer- Printed
|
|
// Latent Image Identification Information
|
|
//
|
|
// SMPTE 271 Motion-Picture Film (16-mm) - Manufacturer- Printed
|
|
// Latent Image Identification Information
|
|
//
|
|
//-----------------------------------------------------------------------------
|
|
|
|
namespace Imf {
|
|
|
|
|
|
class KeyCode
|
|
{
|
|
public:
|
|
|
|
//-------------------------------------
|
|
// Constructors and assignment operator
|
|
//-------------------------------------
|
|
|
|
KeyCode (int filmMfcCode = 0,
|
|
int filmType = 0,
|
|
int prefix = 0,
|
|
int count = 0,
|
|
int perfOffset = 0,
|
|
int perfsPerFrame = 4,
|
|
int perfsPerCount = 64);
|
|
|
|
KeyCode (const KeyCode &other);
|
|
KeyCode & operator = (const KeyCode &other);
|
|
|
|
|
|
//----------------------------
|
|
// Access to individual fields
|
|
//----------------------------
|
|
|
|
int filmMfcCode () const;
|
|
void setFilmMfcCode (int filmMfcCode);
|
|
|
|
int filmType () const;
|
|
void setFilmType (int filmType);
|
|
|
|
int prefix () const;
|
|
void setPrefix (int prefix);
|
|
|
|
int count () const;
|
|
void setCount (int count);
|
|
|
|
int perfOffset () const;
|
|
void setPerfOffset (int perfOffset);
|
|
|
|
int perfsPerFrame () const;
|
|
void setPerfsPerFrame (int perfsPerFrame);
|
|
|
|
int perfsPerCount () const;
|
|
void setPerfsPerCount (int perfsPerCount);
|
|
|
|
private:
|
|
|
|
int _filmMfcCode;
|
|
int _filmType;
|
|
int _prefix;
|
|
int _count;
|
|
int _perfOffset;
|
|
int _perfsPerFrame;
|
|
int _perfsPerCount;
|
|
};
|
|
|
|
|
|
} // namespace Imf
|
|
|
|
#endif
|