]> granicus.if.org Git - imagemagick/blob - www/motion-picture.html
(no commit message)
[imagemagick] / www / motion-picture.html
1
2 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN" 
3   "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
4 <html version="-//W3C//DTD XHTML 1.1//EN"
5       xmlns="http://www.w3.org/1999/xhtml" xml:lang="en"
6       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
7       xsi:schemaLocation="http://www.w3.org/1999/xhtml
8                           http://www.w3.org/MarkUp/SCHEMA/xhtml11.xsd">
9 <head>
10   <meta http-equiv="content-type" content="text/html; charset=UTF-8"/>
11   <meta name=viewport content="width=device-width, initial-scale=0.3333334">
12   <meta name="google-site-verification" content="_bMOCDpkx9ZAzBwb2kF3PRHbfUUdFj2uO8Jd1AXArz4"/>
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="application-name" content="ImageMagick"/>
18   <meta name="description" content="A collection of tools and libraries to read, write, and manipulate an image in any of the more popular image formats."/>
19   <meta name="application-url" content="http://www.imagemagick.org"/>
20   <meta name="generator" content="PHP"/>
21   <meta name="keywords" content="motion, picture, digital, images, convert, edit, compose, image, pixel"/>
22   <meta name="rating" content="GENERAL"/>
23   <meta name="robots" content="INDEX, FOLLOW"/>
24   <meta name="generator" content="ImageMagick Studio LLC"/>
25   <meta name="author" content="ImageMagick Studio LLC"/>
26   <meta name="revisit-after" content="2 DAYS"/>
27   <meta name="resource-type" content="document"/>
28   <meta name="copyright" content="Copyright (c) 1999-2012 ImageMagick Studio LLC"/>
29   <meta name="distribution" content="Global"/>
30   <link rel="icon" href="../images/wand.png"/>
31   <link rel="shortcut icon" href="../images/wand.ico" type="images/x-icon"/>
32   <link rel="canonical" href="http://www.imagemagick.org" />
33   <link rel="meta" type="application/rdf+xml" title="ICI" href="http://imagemagick.org/ici.rdf"/>
34
35   <!-- Add jQuery library -->
36   <script type="text/javascript" src="http://localhost/ajax/libs/jquery/2.1.0/jquery.min.js"></script>
37   
38   <!-- Add mousewheel plugin (this is optional) -->
39   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/lib/jquery.mousewheel-3.0.6.pack.js"></script>
40   
41   <!-- Add fancyBox -->
42   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/jquery.fancybox.css?v=2.1.5" type="text/css" media="screen" />
43   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/jquery.fancybox.pack.js?v=2.1.5"></script>
44   
45   <!-- Optionally add helpers - button, thumbnail and/or media -->
46   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.css?v=1.0.5" type="text/css" media="screen" />
47   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-buttons.js?v=1.0.5"></script>
48   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-media.js?v=1.0.6"></script>
49   
50   <link rel="stylesheet" href="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.css?v=1.0.7" type="text/css" media="screen" />
51   <script type="text/javascript" src="http://www.imagemagick.org/fancybox/source/helpers/jquery.fancybox-thumbs.js?v=1.0.7"></script>
52   
53   <script type="text/javascript">
54         $(document).ready(function() {
55                 $(".fancybox").fancybox();
56         });
57   </script>
58
59   <!-- ImageMagick style -->
60   <style type="text/css" media="all">
61     @import url("../www/magick.css");
62   </style>
63 </head>
64
65 <body id="www-imagemagick-org">
66
67 <script type="text/javascript">
68   (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
69   (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
70   m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
71   })(window,document,'offline-script','//www.google-analytics.com/analytics.js','ga');
72
73   ga('create', 'UA-40133312-1', 'imagemagick.org');
74   ga('send', 'pageview');
75 </script>
76
77 <div class="titlebar">
78 <div style="margin: 17px auto; float: left;">
79   <script type="text/javascript">
80   <!--
81     google_ad_client = "pub-3129977114552745";
82     google_ad_slot = "5439289906";
83     google_ad_width = 728;
84     google_ad_height = 90;
85   //-->
86   </script>
87   <script type="text/javascript"
88     src="http://localhost/pagead/show_ads.js">
89   </script>
90 </div>
91 <a href="../discourse-server">
92   <img src="../images/logo.jpg"
93   alt="ImageMagick Logo" width="123" height="118"
94   style="width: 123px; height: 118px; border: 0px; float: right;" /></a>
95 <a href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">
96   <img src="../images/sprite.jpg"
97   alt="ImageMagick Sprite" width="114" height="118"
98   style="width: 114px; height: 118px; border: 0px; float: right;" /></a>
99 </div>
100
101 <div class="westbar">
102
103 <div class="menu">
104   <a title="About ImageMagick" href="http://www.imagemagick.org/ImageMagick-7.0.0/index.html">About ImageMagick</a>
105 </div>
106 <div class="menu">
107   <a title="Binary Releases" href="binary-releases.html">Binary Releases</a>
108 </div>
109 <div class="sub">
110     <a title="Binary Release: Unix" href="binary-releases.html#unix">Unix</a>
111 </div>
112 <div class="sub">
113     <a title="Binary Release: MacOS X" href="binary-releases.html#macosx">Mac OS X</a>
114 </div>
115 <div class="sub">
116     <a title="Binary Release: iOS" href="binary-releases.html#iOS">iOS</a>
117 </div>
118 <div class="sub">
119     <a title="Binary Release: Windows" href="binary-releases.html#windows">Windows</a>
120 </div>
121 <div class="sep"></div>
122 <div class="menu">
123   <a title="Command-line Tools" href="command-line-tools.html">Command-line Tools</a>
124 </div>
125 <div class="sub">
126     <a title="Command-line Tools: Processing" href="command-line-processing.html">Processing</a>
127 </div>
128 <div class="sub">
129     <a title="Command-line Tools: Options" href="command-line-options.html">Options</a>
130 </div>
131 <div class="sub">
132     <a title="Command-line Tools: Usage" href="http://www.imagemagick.org/Usage/">Usage</a>
133 </div>
134 <div class="menu">
135   <a title="Program Interfaces" href="api.html">Program Interfaces</a>
136 </div>
137 <div class="sub">
138     <a title="Program Interface: MagickWand" href="magick-wand.html">MagickWand</a>
139 </div>
140 <div class="sub">
141     <a title="Program Interface: MagickCore" href="magick-core.html">MagickCore</a>
142 </div>
143 <div class="sub">
144     <a title="Program Interface: PerlMagick" href="perl-magick.html">PerlMagick</a>
145 </div>
146 <div class="sub">
147     <a title="Program Interface: Magick++" href="magick++.html">Magick++</a>
148 </div>
149 <div class="sep"></div>
150 <div  class="menu">
151    <a title="Install from Source" href="install-source.html">Install from Source</a>
152 </div>
153 <div class="sub">
154     <a title="Install from Source: Unix" href="install-source.html#unix">Unix</a>
155 </div>
156 <div class="sub">
157     <a title="Install from Source: Windows" href="install-source.html#windows">Windows</a>
158  </div>
159 <div class="menu">
160   <a title="Resources" href="resources.html">Resources</a>
161 </div>
162 <div class="menu">
163   <a title="Architecture" href="architecture.html">Architecture</a>
164 </div>
165 <div class="menu">
166   <a title="Download" href="download.html">Download</a>
167 </div>
168 <div class="sep"></div>
169 <div class="menu">
170   <a title="Search" href="search.html">Search</a>
171 </div>
172 <div class="sep"></div>
173 <div class="menu">
174   <a title="Site Map" href="sitemap.html">Site Map</a>
175 </div>
176 <div  class="sub">
177   <a title="Site Map: Links" href="links.html">Links</a>
178 </div>
179 <div class="sep"></div>
180 </div>
181
182 <div class="eastbar">
183   <script type="text/javascript">
184     /* <![CDATA[ */
185     window.___gcfg = {
186       lang: 'en-US'
187     };
188
189     (function() {
190       var po = document.createElement('offline-script');
191       po.type = 'text/javascript';
192       po.async = true;
193       po.src = 'https://apis.google.com/js/plusone.js';
194       var script = document.getElementsByTagName('offline-script')[0];
195       script.parentNode.insertBefore(po, script);
196     })();
197     var gplusone = document.getElementById("gplusone");
198     gplusone.setAttribute("data-size","medium");
199     gplusone.setAttribute("data-count","true");
200     /* ]]> */
201   </script>
202   <script type="text/javascript">
203     /* <![CDATA[ */
204     (function() {
205         var po = document.createElement('offline-script'), t = document.getElementsByTagName('offline-script')[0];
206         po.type = 'text/javascript';
207         po.async = true;
208         po.src = 'http://api.flattr.com/js/0.6/load.js?mode=auto';
209         var script = document.getElementsByTagName('offline-script')[0];
210         script.parentNode.insertBefore(po, script);
211     })();
212     /* ]]> */
213   </script>
214   <div> <a class="FlattrButton" style="display:none;" rev="flattr;button:compact;" href="http://www.imagemagick.org/"></a></div>
215   <noscript>
216     <a href="http://flattr.com/thing/947300/Convert-Edit-And-Compose-Images" target="_blank">
217     <img src="http://api.flattr.com/button/flattr-badge-large.png" alt="Flattr this" title="Flattr this" width="93" height="20" border="0" /></a>
218   </noscript>
219   <div class="g-plusone" data-size="standard" data-count="true"></div>
220 </div>
221
222 <div class="main">
223
224 <h1>ImageMagick Motion Picture Formats</h1>
225 <p class="navigation-index">[<a href="motion-picture.html#intro">Introduction to Motion Picture Formats</a> • <a href="motion-picture.html#log">Log Format</a> • <a href="motion-picture.html#properties">DPX properties</a> • <a href="motion-picture.html#settings">DPX Settings</a>]</p>
226
227 <h2><a id="intro"></a>Introduction to Motion Picture Formats</h2>
228 <div class="doc-section">
229
230 <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>
231
232 <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>
233
234 <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>
235
236 <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>
237
238 <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>
239
240 <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>
241
242 </div>
243
244 <h2><a id="log"></a>Log Format</h2>
245 <div class="doc-section">
246
247 <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>
248
249 <p class="image">
250   <a href="../images/bluebells_log.jpg"><img src="../images/bluebells_log.jpg" width="384" height="288" class="image-slices" alt="bluebells-log" /></a>
251   <a href="../images/bluebells_lin.jpg"><img src="../images/bluebells_lin.jpg" width="384" height="288" class="image-slices" alt="bluebells-linear" /></a>
252 </p>
253
254 <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>
255
256 <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>
257
258 <p class="image">
259   <a href="../images/bluebells_clipped.jpg"><img src="../images/bluebells_clipped.jpg" width="384" height="288" class="image-slices" alt="bluebells-clipped" /></a>
260   <a href="../images/bluebells_darker.jpg"><img src="../images/bluebells_darker.jpg" width="384" height="288" class="image-slices" alt="bluebells-darker" /></a>
261 </p>
262
263 </div>
264
265 <h2><a id="properties"></a>DPX Properties</h2>
266 <div class="doc-section">
267
268 <p>ImageMagick supports these DPX properties:</p>
269
270 <pre class="text">
271   dpx:file.copyright
272   dpx:file.creator
273   dpx:file.filename
274   dpx:file.project
275   dpx:file.version
276   dpx:film.count
277   dpx:film.format
278   dpx:film.frame_id
279   dpx:film.frame_position
280   dpx:film.frame_rate
281   dpx:film.held_count
282   dpx:film.id
283   dpx:film.offset
284   dpx:film.prefix
285   dpx:film.sequence_length
286   dpx:film.shutter_angle
287   dpx:film.slate
288   dpx:film.type
289   dpx:orientation.aspect_ratio
290   dpx:orientation.border
291   dpx:orientation.device
292   dpx:orientation.filename
293   dpx:orientation.serial
294   dpx:orientation.x_center
295   dpx:orientation.x_offset
296   dpx:orientation.x_size
297   dpx:orientation.y_center
298   dpx:orientation.y_offset
299   dpx:orientation.y_size
300   dpx:television.black_gain
301   dpx:television.black_level
302   dpx:television.break_point
303   dpx:television.field_number
304   dpx:television.frame_rate
305   dpx:television.gamma
306   dpx:television.integration_times
307   dpx:television.interlace
308   dpx:television.padding
309   dpx:television.time.code
310   dpx:television.time_offset
311   dpx:television.user.bits
312   dpx:television.vertical_sample_rate
313   dpx:television.video_signal
314   dpx:television.white_level
315   dpx:user.id
316   dpx:user.data
317 </pre>
318 <p>Look for any user data as the <code>dpx:user-data</code> image profile.</p>
319
320 <p> To determine which properties are associated with your DPX image, use this command for example:</p>
321
322 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -verbose bluebells.dpx</span></p>
323 <p>To identify a particular property, try this:</p>
324
325 <p class='crt'><span class="crtprompt"> $magick&gt; </span><span class='crtin'>identify -format "%[dpx:television.time.code]" bluebells.dpx</span></p>
326 <p>Finally, to set a property:</p>
327
328 <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>
329 </div>
330
331 <h2><a id="settings"></a>DPX Settings</h2>
332 <div class="doc-section">
333
334 <p>Use <a href="command-line-options.html#set">-set</a> to specify the image or film gamma or black and white points.  For example use:
335 </p>
336
337         <div>
338         <p class="crtsnip">-set gamma 1.7</p>
339
340         <p class="crtsnip">-set film-gamma 0.6</p>
341
342         <p class="crtsnip">-set reference-black 95</p>
343
344         <p class="crtsnip">-set reference-white 685</p>
345
346         <p class="crtsnip">-set profile dpx:user.data</p>
347         </div>
348
349 </div>
350
351
352 </div>
353
354 <div id="linkbar">
355     <span id="linkbar-west"> </span>
356
357     <span id="linkbar-center">
358       <a href="../discourse-server">Discourse Server</a> •
359       <a href="http://pgp.mit.edu:11371/pks/lookup?op=get&amp;search=0x89AB63D48277377A">Public Key</a> •
360       <a href="http://www.imagemagick.org/MagickStudio/scripts/MagickStudio.cgi">Studio</a> •
361       <a href="http://jqmagick.imagemagick.org/">JqMagick</a>
362     </span>
363     <span id="linkbar-east"> </span>
364 </div>
365 <div class="footer">
366   <span id="footer-west">©  1999-2014 ImageMagick Studio LLC</span>
367   <span id="footer-east"> <a href="contact.html">Contact the Wizards</a></span>
368 </div>
369 <div style="clear: both; margin: 0; width: 100%; "></div>
370 </body>
371 </html>