--- /dev/null
+///////////////////////////////////////////////////////////////////////////
+//
+// 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