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

   1 \r
   2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" \r
   3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">\r
   4 <html version="-//W3C//DTD XHTML 1.1//EN"\r
   5       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"\r
   6       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"\r
   7       xsi:schemaLocation="http://www.w3.org/1999/xhtml\r
   8                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">\r
   9 <head>\r
  10   <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>\r
  11   <meta name="google-site-verification" content="MxsMq6bdLOx0KSuz1MY6yG9ZTIJ7_7DVRfl5NCAT5Yg"/>\r
  12   <title>ImageMagick: Motion Picture Digital Images</title>
  13   <meta http-equiv="Content-Language" content="en-US"/>
  14   <meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
  15   <meta http-equiv="Reply-to" content="magick-users@imagemagick.org"/>
  16   <meta name="Application-name" content="ImageMagick"/>
  17   <meta name="Description" content="Use ImageMagick to convert, edit, or compose bitmap images in a variety of formats.  In addition resize, rotate, shear, distort and transform images automagically."/>
  18   <meta name="Application-url" content="http://www.imagemagick.org"/>
  19   <meta name="Generator" content="PHP"/>
  20   <meta name="Keywords" content="motion, picture, digital, images, ImageMagick, PerlMagick, image processing, OpenMP, software development library, image, photo, software, Magick++, MagickWand"/>
  21   <meta name="Rating" content="GENERAL"/>
  22   <meta name="Robots" content="INDEX, FOLLOW"/>
  23   <meta name="Generator" content="ImageMagick Studio LLC"/>
  24   <meta name="Author" content="ImageMagick Studio LLC"/>
  25   <meta name="Revisit-after" content="2 DAYS"/>
  26   <meta name="Resource-type" content="document"/>
  27   <meta name="Copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
  28   <meta name="Distribution" content="Global"/>
  29   <link rel="icon" href="../images/wand.png"/>
  30   <link rel="shortcut icon" href="../images/wand.ico"  type="images/x-icon"/>
  31   <link rel="canonical" href="http://www.imagemagick.org" />\r
  32   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>\r
  33   <!-- Add jQuery library -->\r
  34   <script type="text/javascript" src="http://ajax.googleapis.com/ajax/libs/jquery/1.7/jquery.min.js"></script>\r
  35   \r
  36   <!-- Optionaly include easing and/or mousewheel plugins -->\r
  37   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.easing-1.3.pack.js"></script>\r
  38   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.mousewheel-3.0.6.pack.js"></script>\r
  39   \r
  40   <!-- Add fancyBox -->\r
  41   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/jquery.fancybox.css?v=2.0.3" type="text/css" media="screen" />\r
  42   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/jquery.fancybox.pack.js?v=2.0.3"></script>\r
  43   \r
  44   <!-- Optionaly include button and/or thumbnail helpers -->\r
  45   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.css?v=2.0.3" type="text/css" media="screen" />\r
  46   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-buttons.js?v=2.0.3"></script>\r
  47   \r
  48   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.css?v=2.0.3" type="text/css" media="screen" />\r
  49   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/helpers/jquery.fancybox-thumbs.js?v=2.0.3"></script>\r
  50   <script type="text/javascript">\r
  51         $(document).ready(function() {\r
  52                 $(".fancybox").fancybox();\r
  53         });\r
  54   </script>\r
  55   <!-- ImageMagick style -->\r
  56   <link rel="stylesheet" href="http://www.google.com/cse/style/look/default.css" type="text/css" />\r
  57   <style type="text/css" media="all">\r
  58     @import url("../www/magick.css");\r
  59   </style>\r
  60 </head>\r
  61 \r
  62 <body id="www-imagemagick-org">\r
  63 <div class="titlebar">\r
  64 <div style="margin: 17px auto; float: left;">\r
  65   <script type="text/javascript">\r
  66   <!--\r
  67     google_ad_client = "pub-3129977114552745";\r
  68     google_ad_slot = "5439289906";\r
  69     google_ad_width = 728;\r
  70     google_ad_height = 90;\r
  71   //-->\r
  72   </script>\r
  73   <script type="text/javascript"\r
  74     src="http://pagead2.googlesyndication.com/pagead/show_ads.js">\r
  75   </script>\r
  76 </div>\r
  77 <a href="http://www.imagemagick.org/discourse-server/">\r
  78   <img src="../images/logo.jpg"\r
  79   alt="ImageMagick Logo"\r
  80   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>\r
  81 <a href="../index.html">\r
  82   <img src="../images/sprite.jpg"\r
  83   alt="ImageMagick Sprite"\r
  84   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>\r
  85 </div>\r
  86 \r
  87 <div class="westbar">\r
  88 \r
  89 <div class="menu">
  90   <a title="About ImageMagick" href="../index.html">About ImageMagick</a>
  91 </div>
  92 <div class="menu">
  93   <a title="Binary Releases" href="../www/binary-releases.html">Binary Releases</a>
  94 </div>
  95 <div class="sub">
  96     <a title="Binary Release: Unix" href="../www/binary-releases.html#unix">Unix</a>
  97 </div>
  98 <div class="sub">
  99     <a title="Binary Release: MacOS X" href="../www/binary-releases.html#macosx">Mac OS X</a>
 100 </div>
 101 <div class="sub">
 102     <a title="Binary Release: iOS" href="../www/binary-releases.html#iOS">iOS</a>
 103 </div>
 104 <div class="sub">
 105     <a title="Binary Release: Windows" href="../www/binary-releases.html#windows">Windows</a>
 106 </div>
 107 <div class="sep"></div>\r
 108 <div class="menu">
 109   <a title="Command-line Tools" href="../www/command-line-tools.html">Command-line Tools</a>
 110 </div>
 111 <div class="sub">
 112     <a title="Command-line Tools: Processing" href="../www/command-line-processing.html">Processing</a>
 113 </div>
 114 <div class="sub">
 115     <a title="Command-line Tools: Options" href="../www/command-line-options.html">Options</a>
 116 </div>
 117 <div class="sub">
 118     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
 119 </div>
 120 <div class="menu">
 121   <a title="Program Interfaces" href="../www/api.html">Program Interfaces</a>
 122 </div>
 123 <div class="sub">
 124     <a title="Program Interface: MagickWand" href="../www/magick-wand.html">MagickWand</a>
 125 </div>
 126 <div class="sub">
 127     <a title="Program Interface: MagickCore" href="../www/magick-core.html">MagickCore</a>
 128 </div>
 129 <div class="sub">
 130     <a title="Program Interface: PerlMagick" href="../www/perl-magick.html">PerlMagick</a>
 131 </div>
 132 <div class="sub">
 133     <a title="Program Interface: Magick++" href="../www/magick++.html">Magick++</a>
 134 </div>
 135 <div class="sep"></div>\r
 136 <div  class="menu">
 137    <a title="Install from Source" href="../www/install-source.html">Install from Source</a>
 138 </div>
 139 <div class="sub">
 140     <a title="Install from Source: Unix" href="../www/install-source.html#unix">Unix</a>
 141 </div>
 142 <div class="sub">
 143     <a title="Install from Source: Windows" href="../www/install-source.html#windows">Windows</a>
 144  </div>
 145 <div class="menu">
 146   <a title="Resources" href="../www/resources.html">Resources</a>
 147 </div>
 148 <div class="menu">
 149   <a title="Architecture" href="../www/architecture.html">Architecture</a>
 150 </div>
 151 <div class="menu">
 152   <a title="Download" href="../www/download.html">Download</a>
 153 </div>
 154 <div class="sep"></div>\r
 155 <div class="menu">
 156   <a title="Search" href="../www/search.html">Search</a>
 157 </div>
 158 <div class="sep"></div>\r
 159 <div class="menu">
 160   <a title="Site Map" href="../www/sitemap.html">Site Map</a>
 161 </div>
 162 <div  class="sub">
 163   <a title="Site Map: Links" href="../www/links.html">Links</a>
 164 </div>
 165 <div class="sep"></div>\r
 166 <div class="menu">
 167   <a rel="follow" title="Sponsors" href="../www/sponsors.html">Sponsors:</a>
 168
 169   <a href="http://www.networkredux.com"> <img src="../images/networkredux.png" width="140" height="31" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a>
 170   <a href="http://www.dinodirect.com/ipads-tablets/"> <img src="../images/dino-direct.jpg" width="140" height="90" alt="[sponsor]" style="margin-top: 4px; margin-left: 4px; border: 0px; float: left;" /></a><!-- 201204010120 mickey@163... -->
 171 <div class="sponsbox">
 172 <div class="sponsor">
 173   <a rel="follow" title="Android Tablet" href="http://www.dinodirect.com/ipads-tablets/">Android Tablet</a><!-- 201204010120 mickey@163... -->
 174 </div>
 175 <div class="sponsor">
 176   <a rel="follow" title="Sponsor: Web Hosting" href="http://www.micfo.com">Web Hosting</a><!-- 209901010090s golestan -->
 177 </div>
 178 <div class="sponsor">
 179   <a rel="follow" title="Sponsor: Autos Part" href="http://www.pkwteile.de/autoteile">Autos Part</a><!-- 201203010270 info@pkwte... -->
 180 </div>
 181 <div class="sponsor">
 182   <a rel="follow" title="Sponsor: Web Site Hosting" href="http://webhostinggeeks.com">Web Site Hosting</a><!-- 201302010900 funds@enmob... -->
 183 </div>
 184 <div class="sponsor">
 185   <a rel="follow" title="Sponsor: Tenant Check" href="http://www.rentmethod.com/">Tenant Check</a><!-- 201203010090 chris@rentm... -->
 186 </div>
 187 <div class="sponsor">
 188   <a rel="follow" title="Sponsor: VPS" href="http://www.interdominios.com/vps">VPS</a><!-- 201204010090 barsh@inter... -->
 189 </div>
 190 <div class="sponsor">
 191    <a rel="follow" title="Sponsor: Premium Quality Stock Photos" href="http://www.f1online.pro/en/">Premium Quality Stock Photos</a><!-- 2012080100540 ... -->
 192 </div>
 193 <div class="sponsor">
 194   <a rel="follow" title="Sponsor: Search engine optimisation" href="http://www.seomoves.com.au">Search engine optimisation</a><!-- 201301010090s jen@seo lowprofilelinks -->
 195 </div>
 196 <div class="sponsor">
 197    <a rel="follow" title="Sponsor: Druckerei" href="http://print24.com/de/">Druckerei</a><!-- 2012070100250 ... -->
 198 </div>
 199 <div class="sponsor">
 200   <a rel="follow" title="Sponsor: Managed Server" href="http://www.robhost.de">Managed Server</a><!-- 201210010720 klikics... -->
 201 </div>
 202 <div class="sponsor">
 203    <a rel="follow" title="Sponsor: Stock Photography" href="http://www.fotosearch.com/">Stock Photography</a><!-- 2012040100250 ... -->
 204 </div>
 205 <div class="sponsor">
 206   <a rel="follow" title="Sponsor: Autoteile" href="http://www.q11-shop.de">Autoteile</a><!-- 201205010540 suvalj -->
 207 </div>
 208 <div class="sponsor">
 209    <a rel="follow" title="Sponsor: Royalty Free Stock Images" href="http://www.canstockphoto.com/">Royalty Free Stock Images</a><!-- 2012050100360 support@can -->
 210 </div>
 211 <div class="sponsor">
 212   <a rel="follow" title="Sponsor: Web Hosting Reviews" href="http://www.webhostingsecretrevealed.com">Web Hosting Secret Revealed</a><!-- 201204010540 iamchee jerry -->
 213 </div>
 214 <div class="sponsor">
 215   <a rel="follow" title="Sponsor: Druckerei" href="http://www.allesdruck.de">Druckerei</a><!-- 201303011500 r.leo -->
 216 </div>
 217 <div class="sponsor">
 218    <a rel="follow" title="Sponsor: Photo Sharing Websites" href="http://www.zoofoo.com">Photo Sharing Websites</a><!-- 2012050100150 dancu@dans...-->
 219 </div>
 220 <div class="sponsor">
 221    <a rel="follow" title="Sponsor: Schlüsseldienst Berlin BSD" href="http://www.schluesseldienst-berlin.de">Schlüsseldienst Berlin BSD</a><!-- 2012050100025 info@schlues-->
 222 </div>
 223 </div>
 224 </div>
 225 </div>\r
 226 \r
 227 <div class="eastbar">\r
 228   <div class="g-plusone" data-size="standard" data-count="false"></div>\r
 229   <script type="text/javascript">\r
 230     window.___gcfg = {\r
 231       lang: 'en-US'\r
 232     };\r
 233 \r
 234     (function() {\r
 235       var po = document.createElement('script'); po.type = 'text/javascript'; po.async = true;\r
 236       po.src = 'https://apis.google.com/js/plusone.js';\r
 237       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(po, s);\r
 238     })();\r
 239   </script>\r
 240 </div>\r
 241 \r
 242 <div class="main">\r
 243 \r
 244 <h1>ImageMagick Motion Picture Formats</h1>
 245 <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>
 246
 247 <h2><a id="intro"></a>Introduction to Motion Picture Formats</h2>
 248 <div class="doc-section">
 249
 250 <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>
 251
 252 <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>
 253
 254 <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>
 255
 256 <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>
 257
 258 <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>
 259
 260 <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>
 261
 262 </div>
 263
 264 <h2><a id="log"></a>Log Format</h2>
 265 <div class="doc-section">
 266
 267 <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>
 268
 269 <p class="image">
 270   <a href="../images/bluebells_log.jpg"><img src="../images/bluebells_log.jpg" width="384" height="288" class="image-slices" alt="bluebells-log" /></a>
 271   <a href="../images/bluebells_lin.jpg"><img src="../images/bluebells_lin.jpg" width="384" height="288" class="image-slices" alt="bluebells-linear" /></a>
 272 </p>
 273
 274 <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>
 275
 276 <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>
 277
 278 <p class="image">
 279   <a href="../images/bluebells_clipped.jpg"><img src="../images/bluebells_clipped.jpg" width="384" height="288" class="image-slices" alt="bluebells-clipped" /></a>
 280   <a href="../images/bluebells_darker.jpg"><img src="../images/bluebells_darker.jpg" width="384" height="288" class="image-slices" alt="bluebells-darker" /></a>
 281 </p>
 282
 283 </div>
 284
 285 <h2><a id="properties"></a>DPX Properties</h2>
 286 <div class="doc-section">
 287
 288 <p>ImageMagick supports these DPX properties:</p>
 289
 290 <pre class="text">
 291   dpx:file.copyright
 292   dpx:file.creator
 293   dpx:file.filename
 294   dpx:file.project
 295   dpx:file.version
 296   dpx:film.count
 297   dpx:film.format
 298   dpx:film.frame_id
 299   dpx:film.frame_position
 300   dpx:film.frame_rate
 301   dpx:film.held_count
 302   dpx:film.id
 303   dpx:film.offset
 304   dpx:film.prefix
 305   dpx:film.sequence_length
 306   dpx:film.shutter_angle
 307   dpx:film.slate
 308   dpx:film.type
 309   dpx:orientation.aspect_ratio
 310   dpx:orientation.border
 311   dpx:orientation.device
 312   dpx:orientation.filename
 313   dpx:orientation.serial
 314   dpx:orientation.x_center
 315   dpx:orientation.x_offset
 316   dpx:orientation.x_size
 317   dpx:orientation.y_center
 318   dpx:orientation.y_offset
 319   dpx:orientation.y_size
 320   dpx:television.black_gain
 321   dpx:television.black_level
 322   dpx:television.break_point
 323   dpx:television.field_number
 324   dpx:television.frame_rate
 325   dpx:television.gamma
 326   dpx:television.integration_times
 327   dpx:television.interlace
 328   dpx:television.padding
 329   dpx:television.time.code
 330   dpx:television.time_offset
 331   dpx:television.user.bits
 332   dpx:television.vertical_sample_rate
 333   dpx:television.video_signal
 334   dpx:television.white_level
 335   dpx:user.id
 336   dpx:user.data
 337 </pre>
 338
 339 <p> To determine which properties are associated with your DPX image, use this command for example:</p>
 340
 341 <p class='crt'><span class="crtprompt"> $ </span><span class='crtin'>identify -verbose bluebells.dpx</span></p>
 342 <p>To identify a particular property, try this:</p>
 343
 344 <p class='crt'><span class="crtprompt"> $ </span><span class='crtin'>identify -format "%[dpx:television.time.code]" bluebells.dpx</span></p>
 345 <p>Finally, to set a property:</p>
 346
 347 <p class='crt'><span class="crtprompt"> $ </span><span class='crtin'>convert bluebells.dpx -define dpx:television.time.code=10:00:02:15 bluebells-001.dpx</span></p>
 348 </div>
 349
 350 <h2><a id="settings"></a>DPX Settings</h2>
 351 <div class="doc-section">
 352
 353 <p>Use <a href="../www/command-line-options.html#set">-set</a> to specify the image or film gamma or black and white points.  For example use:
 354 </p>
 355
 356         <div>
 357         <p class="crtsnip">-set gamma 1.7</p>
 358
 359         <p class="crtsnip">-set film-gamma 0.6</p>
 360
 361         <p class="crtsnip">-set reference-black 95</p>
 362
 363         <p class="crtsnip">-set reference-white 685</p>
 364
 365         <p class="crtsnip">-set profile dpx:user.data</p>
 366         </div>
 367
 368 </div>
 369
 370 \r
 371 </div>\r
 372 \r
 373 <div id="linkbar">\r
 374     <span id="linkbar-west">&nbsp;</span>\r
 375     <span id="linkbar-center">\r
 376       <a href="http://www.imagemagick.org/discourse-server/">Discourse Server</a> &bull;\r
 377       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a>\r
 378     </span>\r
 379     <span id="linkbar-east">&nbsp;</span>\r
 380   </div>\r
 381   <div class="footer">\r
 382     <span id="footer-west">&copy; 1999-2011 ImageMagick Studio LLC</span>\r
 383     <span id="footer-east"> <a href="http://www.imagemagick.org/script/contact.php">Contact the Wizards</a></span>\r
 384   </div>\r
 385   <div style="clear: both; margin: 0; width: 100%; "></div>\r
 386   <script type="text/javascript">\r
 387     var _gaq = _gaq || [];\r
 388     _gaq.push(['_setAccount', 'UA-17690367-1']);\r
 389     _gaq.push(['_trackPageview']);\r
 390 \r
 391     (function() {\r
 392       var ga = document.createElement('script'); ga.type = 'text/javascript'; ga.async = true;\r
 393       ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';\r
 394       var s = document.getElementsByTagName('script')[0]; s.parentNode.insertBefore(ga, s);\r
 395     })();\r
 396   </script>\r
 397 </body>\r
 398 </html>\r