granicus.if.org Git - imagemagick/blob - www/motion-picture.html

   1
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
   3     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
   4 <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
   5 <head>
   6   <meta http-equiv="Content-Type" value="application/xhtml+xml" />
   7   <meta name="verify-v1" content="g222frIIxcQTrvDR3NBRUSKP3AnMNoqxOkIniCEkV7U=" />
   8   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf" />
   9   <style type="text/css" media="screen,projection"><!--
  10     @import url("../www/magick.css");
  11   --></style>
  12   <link rel="shortcut icon" href="../images/wand.ico"  type="images/vnd.microsoft.icon"/>
  13   <title>ImageMagick: Motion Picture Digital Images</title>
  14   <meta http-equiv="Content-Language" content="en-US"/>
  15   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  16   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  17   <meta name="Generator" content="PHP"/>
  18   <meta name="Keywords" content="motion, picture, digital, images, ImageMagick, ImageMagic, MagickCore, MagickWand, PerlMagick, Magick++, RMagick, PythonMagick, JMagick, TclMagick, Image, Magick, Magic, Wand, ImageMagickObject, Swiss, Army, Knife, Image, Processing"/>
  19   <meta name="Description" content="ImageMagick® is a software suite to create, edit, and compose bitmap images. It can read, convert and write images in a variety of formats (about 100) including GIF, JPEG, JPEG-2000, PNG, PDF, PhotoCD, TIFF, and DPX. Use ImageMagick to translate, flip, mirror, rotate, scale, shear and transform images, adjust image colors, apply various special effects, or draw text, lines, polygons, ellipses and Bézier curves.  ImageMagick is free software delivered as a ready-to-run binary distribution or as source code that you can freely use, copy, modify, and distribute. Its license is compatible with the GPL. It runs on all major operating systems.  The functionality of ImageMagick is typically utilized from the command line or you can use the features from programs written in your favorite programming language. Choose from these interfaces: MagickCore (C), MagickWand (C), ChMagick (Ch), Magick++ (C++), JMagick (Java), L-Magick (Lisp), PascalMagick (Pascal), PerlMagick (Perl), MagickWand for PHP (PHP), PythonMagick (Python), RMagick (Ruby), or TclMagick (Tcl/TK). With a language interface, use ImageMagick to modify or create images automagically and dynamically."/>
  20   <meta name="Rating" content="GENERAL"/>
  21   <meta name="Robots" content="INDEX, FOLLOW"/>
  22   <meta name="Generator" content="ImageMagick Studio LLC"/>
  23   <meta name="Author" content="ImageMagick Studio LLC"/>
  24   <meta name="Revisit-after" content="2 DAYS"/>
  25   <meta name="Resource-type" content="document"/>
  26   <meta name="Copyright" content="Copyright (c) 1999-2010 ImageMagick Studio LLC"/>
  27   <meta name="Distribution" content="Global"/>
  28 </head>
  29
  30 <body id="www-imagemagick-org">
  31 <div class="titlebar">
  32 <a href="../index.html">
  33   <img src="../images/script.png" alt="[ImageMagick]"
  34   style="width: 350px; height: 60px; margin: 28px auto; float: left;" /></a>
  35 <a href="http://www.networkredux.com">
  36   <img src="../images/networkredux.png" alt="[sponsor]"
  37   style="margin: 45px auto; border: 0px; float: left;" /></a>
  38 <a href="http://www.imagemagick.org/discourse-server/">
  39   <img src="../images/logo.jpg" alt=""
  40   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  41 <a href="../index.html">
  42   <img src="../images/sprite.jpg" alt=""
  43   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
  44 </div>
  45
  46 <div class="eastbar">
  47
  48 <div class="menu">
  49   <a href="../index.html">About ImageMagick</a>
  50 </div>
  51 <div class="sep"></div>
  52 <div class="menu">
  53   <a href="../www/command-line-tools.html">Command-line Tools</a>
  54 </div>
  55 <div class="sub">
  56     <a href="../www/command-line-processing.html">Processing</a>
  57 </div>
  58 <div class="sub">
  59     <a href="../www/command-line-options.html">Options</a>
  60 </div>
  61 <div class="sub">
  62     <a href="http://www.imagemagick.org/Usage/">Usage</a>
  63 </div>
  64 <div class="menu">
  65   <a href="../www/api.html">Program Interfaces</a>
  66 </div>
  67 <div class="sub">
  68     <a href="../www/magick-wand.html">MagickWand</a>
  69 </div>
  70 <div class="sub">
  71     <a href="../www/magick-core.html">MagickCore</a>
  72 </div>
  73 <div class="sub">
  74     <a href="../www/perl-magick.html">PerlMagick</a>
  75 </div>
  76 <div class="sub">
  77     <a href="../Magick++/">Magick++</a>
  78 </div>
  79 <div class="menu">
  80   <a href="../www/architecture.html">Architecture</a>
  81 </div>
  82 <div class="sep"></div>
  83 <div  class="menu">
  84    <a href="../www/install-source.html">Install from Source</a>
  85 </div>
  86 <div class="sub">
  87     <a href="../www/install-source.html#unix">Unix</a>
  88 </div>
  89 <div class="sub">
  90     <a href="../www/install-source.html#windows">Windows</a>
  91  </div>
  92 <div class="menu">
  93   <a href="../www/binary-releases.html">Binary Releases</a>
  94 </div>
  95 <div class="sub">
  96     <a href="../www/binary-releases.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a href="../www/binary-releases.html#macosx">Mac OS X</a>
 100 </div>
 101 <div class="sub">
 102     <a href="../www/binary-releases.html#windows">Windows</a>
 103 </div>
 104 <div class="menu">
 105   <a href="../www/resources.html">Resources</a>
 106 </div>
 107 <div class="sep"></div>
 108 <div class="menu">
 109   <a href="../www/download.html">Download</a>
 110 </div>
 111 <div class="sep"></div>
 112 <div class="menu">
 113   <a href="http://www.imagemagick.org/script/search.php">Search</a>
 114 </div>
 115 <div class="sep"></div>
 116 <div class="menu">
 117   <a href="../www/sitemap.html">Site Map</a>
 118 </div>
 119 <div  class="sub">
 120     <a href="../www/links.html">Links</a>
 121 </div>
 122 <div class="sep"></div>
 123 <div  class="menu">
 124   <a href="../www/sponsors.html">Sponsors:</a>
 125
 126 <div class="sponsbox">
 127 <div  class="sponsor">
 128    <a href="http://www.abi-stoff.de/abizeitung/" title="Abibuch">Abizeitung</a><!-- 20101101000200 -->
 129 </div>
 130 <div  class="sponsor">
 131   <a href="http://www.deko.net">Deko.net</a><!-- 201101010600 Peterssen-->
 132 </div>
 133 <div  class="sponsor">
 134   <a href="http://www.tomsgutscheine.de">Tom's Gutscheine</a><!-- 201005010360 invendio.de-->
 135 </div>
 136 <div  class="sponsor">
 137   <a href="http://www.online-kredit-index.de">Kredit</a><!-- 201007010120 Buchhorn -->
 138 </div>
 139 <div  class="sponsor">
 140   <a href="http://www.blumenversender.com">Blumenversand</a><!-- 201005010120 -->
 141 </div>
 142 <div  class="sponsor">
 143   <a href="http://www.print24.de/">Druckerei</a><!-- 201009010720 -->
 144 </div>
 145 <div  class="sponsor">
 146    <a href="http://www.goyax.de">Börse</a><!-- 201004010240 Gewiese digital-finance.de -->
 147 </div>
 148 <div  class="sponsor">
 149    <a href="http://www.allesdruck.de">Druckerei Online</a><!-- 201012011200 allesdruck.de-->
 150 </div>
 151 </div>
 152 </div>
 153
 154
 155 </div>
 156
 157 <div class="main">
 158
 159 <p class="navigation-index">[<a href="#intro">Introduction to Motion Picture Formats</a> &bull; <a href="#log">Log Format</a> &bull; <a href="#properties">DPX properties</a> &bull; <a href="#settings">DPX Settings</a>]</p>
 160
 161 <h2><a name="intro"></a>Introduction to Motion Picture Formats</h2>
 162 <div class="doc-section">
 163
 164 <p>DPX (SMPTE 268M-2003) - This format is used in Motion Picture and Effects industry that makes particular use of the extensive header information and the format's flexibility in being able to handle high dynamic range and logarithmic color values at a variety of bit depths using RGB or YCbCr pixel descriptions.  It is based on, but largely supercedes, Kodak's Cineon format that has more a more film specific header.</p>
 165
 166 <p>One example of it's use includes scanning film for use in post production. Each frame is stored as an individual DPX file ranging from 2k (2048 pixels wide) to 8k (8192 pixels wide - for IMAX frames) at anything between 8 to 64 bits per color component. A sequence of these might then be processed using compositing software, altering the color or adding visual effects. Once complete they might then be recorded digitally to tape or projected back on to film.</p>
 167
 168 <p>The color values for each pixel are often stored logarithmically (particularly if the sequence is destined to be transferred back on to film) which more naturally reflects the density of how color information is stored in the emulsion on the original film. When viewed without alteration, logarithmic files appear to have very low contrast and requires a 'look up table' to translate the logarithmic image to something that resembles what you might see if the image was transferred back to film and projected in a cinema. Apart from making the image linear (like most typical computer images) and adjusting the gamma level this table sets where the black and white point lies.</p>
 169
 170 <p>For a 10 bit logarithmic image where each color component value ranges from 0 to 1023 the black and white points are normally set at 95 for black and 685 for white. What this means is that the logarithmic file stores color values that are lighter than what the linear version will display as pure white and darker than what it will display as pure black. This extra information therefore remains available for an effects artists who might wish to alter the brightness of the image after it has been stored as a DPX file.</p>
 171
 172 <p>As an example, had this information been lost, reducing the brightness of an image uniformly would result in highlights becoming darker, whereas with this extra information the highlights instead reduce in size and start showing details that were previously too bright to be seen. The latter is far closer to what happens in the real world.</p>
 173
 174 <p>The header can contain Film and/or Television specific data related to a production. For example the television header can contain a SMPTE time code so that shots exported as a DPX sequence from a production's edit can be easily replaced once any effects have been added. The film header holds information about the reel of film the frames originated from and various camera settings that were used while filming.  All these details usually stay with the images as they are passed between post-production companies.</p>
 175
 176 </div>
 177
 178 <h2><a name="log"></a>Log Format</h2>
 179 <div class="doc-section">
 180
 181 <p>The color values for each pixel are often stored logarithmically (particularly if the sequence is destined to be transferred back on to film) which more naturally reflects the density of how color information is stored in the emulsion on the original film. When viewed without alteration logarithmic files appear to have very low contrast (leftmost image), and so require a 'look up table' to translate the logarithmic image to something that resembles what you might see if the image was transferred back to film and projected in a cinema (rightmost image). Apart from making the image linear (like most typical computer images) and adjusting the gamma level this table sets where the black and white point lies.</p>
 182
 183 <p class="image">
 184   <a href="../images/bluebells_log.jpg"><img src="../images/bluebells_log.jpg" width="384" height="288" class="image-slices" alt="bluebells-log" /></a>
 185   <a href="../images/bluebells_lin.jpg"><img src="../images/bluebells_lin.jpg" width="384" height="288" class="image-slices" alt="bluebells-linear" /></a>
 186 </p>
 187
 188 <p>For a 10 bit logarithmic image where each color component value ranges from 0 to 1023 the black and white points are normally set at 95 for black and 685 for white. What this means is that the logarithmic file stores color values that are lighter than what the linear version will display as pure white and darker than what it will display as pure black. This extra information therefore remains available for an effects artists who might wish to alter the brightness of the image after it has been stored as a DPX file.</p>
 189
 190 <p>As an example, had this information been lost, reducing the brightness of a linear image uniformly would result in highlights becoming darker (leftmost image), whereas with this extra information the highlights instead reduce in size and start showing details that were previously too bright to be seen (rightmost image). The latter is far closer to what happens in the real world.</p>
 191
 192 <p class="image">
 193   <a href="../images/bluebells_clipped.jpg"><img src="../images/bluebells_clipped.jpg" width="384" height="288" class="image-slices" alt="bluebells-clipped" /></a>
 194   <a href="../images/bluebells_darker.jpg"><img src="../images/bluebells_darker.jpg" width="384" height="288" class="image-slices" alt="bluebells-darker" /></a>
 195 </p>
 196
 197 </div>
 198
 199 <h2><a name="properties"></a>DPX Properties</h2>
 200 <div class="doc-section">
 201
 202 <p>ImageMagick supports these DPX properties:</p>
 203
 204 <pre class="text">
 205   dpx:file.copyright
 206   dpx:file.creator
 207   dpx:file.filename
 208   dpx:file.project
 209   dpx:file.version
 210   dpx:film.count
 211   dpx:film.format
 212   dpx:film.frame_id
 213   dpx:film.frame_position
 214   dpx:film.frame_rate
 215   dpx:film.held_count
 216   dpx:film.id
 217   dpx:film.offset
 218   dpx:film.prefix
 219   dpx:film.sequence_length
 220   dpx:film.shutter_angle
 221   dpx:film.slate
 222   dpx:film.type
 223   dpx:orientation.aspect_ratio
 224   dpx:orientation.border
 225   dpx:orientation.device
 226   dpx:orientation.filename
 227   dpx:orientation.x_center
 228   dpx:orientation.x_offset
 229   dpx:orientation.x_size
 230   dpx:orientation.y_center
 231   dpx:orientation.y_offset
 232   dpx:orientation.y_size
 233   dpx:television.black_gain
 234   dpx:television.black_level
 235   dpx:television.break_point
 236   dpx:television.field_number
 237   dpx:television.frame_rate
 238   dpx:television.gamma
 239   dpx:television.integration_times
 240   dpx:television.interlace
 241   dpx:television.padding
 242   dpx:television.time.code
 243   dpx:television.time_offset
 244   dpx:television.user.bits
 245   dpx:television.vertical_sample_rate
 246   dpx:television.video_signal
 247   dpx:television.white_level
 248   dpx:user.id
 249 </pre>
 250
 251 <p> To determine which properties are associated with your DPX image, use this command for example:</p>
 252
 253 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -verbose bluebells.dpx</span></p>
 254 <p>To identify a particular property, try this:</p>
 255
 256 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -format "%[dpx:television.time.code]" bluebells.dpx</span></p>
 257 <p>Finally, to set a property:</p>
 258
 259 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>convert bluebells.dpx -define dpx:television.time.code=10:00:02:15 bluebells-001.dpx</span></p>
 260 </div>
 261
 262 <h2><a name="settings"></a>DPX Settings</h2>
 263 <div class="doc-section">
 264
 265 <p>Use <a href="../www/command-line-options.html#set">-set</a> to specify the image gamma or black and white points.  For example use:
 266 </p>
 267
 268         <div>
 269         <p class="crtsnip">-set gamma 1.7</p>
 270
 271         <p class="crtsnip">-set reference-black 95</p>
 272
 273         <p class="crtsnip">-set reference-white 685</p>
 274         </div>
 275
 276 </div>
 277
 278
 279 </div>
 280
 281 <div id="linkbar">
 282  <!--    <span id="linkbar-west">&nbsp;</span>  -->
 283     <span id="linkbar-center">
 284       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;
 285     <a href="http://studio.webbyland.com/ImageMagick/MagickStudio/scripts/MagickStudio.cgi">Studio</a>
 286     </span>
 287     <span id="linkbar-east">&nbsp;</span>
 288   </div>
 289   <div class="footer">
 290     <span id="footer-west">&copy; 1999-2010 ImageMagick Studio LLC</span>
 291     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>
 292   </div>
 293   <div style="clear: both; margin: 0; width: 100%; "></div>
 294 </body>
 295 </html>