-
Notifications
You must be signed in to change notification settings - Fork 4
/
photoshop_plugin.html
281 lines (270 loc) · 16.4 KB
/
photoshop_plugin.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
<html>
<head>
<title>OpenEXR</title>
</head>
<body background="images/exr_bkg2.jpg" bgcolor="#000000" leftmargin=0 topmargin=0 marginheight=0 marginwidth=0 alink="#00FFFF" link="#33ffFF" vlink="#33ffFF" text="#999999">
<STYLE>
body {font-family: Verdana, Arial, Helvetica, sans-serif; color:999999;}
b {font-family: Verdana, Arial, Helvetica, sans-serif;}
td {font-family: Verdana, Arial, Helvetica, sans-serif; color:999999;}
table {font-family: Verdana, Arial, Helvetica, sans-serif;}
p {font-family: Verdana, Arial, Helvetica, sans-serif; color:999999;}
a {font-family: Verdana, Arial, Helvetica, sans-serif; text-decoration: none;}
h5 {font-family: Verdana, Arial, Helvetica, sans-serif; color:cccccc;}
</STYLE>
<table width="770" border="0" cellspacing="0" cellpadding="0">
<tr>
<td width="270" valign="top">
<table border="0" cellspacing="0" cellpadding="0">
<tr>
<td colspan="2" align="left"><a href="index.html"><img src="images/exr_logo2.jpg" width="255" height="234" alt="" border="0"></a></td>
</tr>
<tr>
<td valign="top"><!-- begin navigation -->
<table width="182" border="0" cellspacing="0" cellpadding="0">
<tr>
<td><img src="images/spacer.gif" width="142" height="5" alt="" border="0"></td>
<td><img src="images/spacer.gif" width="42" height="5" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="index.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">Home</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="about.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">About OpenEXR</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="samples.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">OpenEXR samples</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right" bgcolor="#202B2F"><a href="documentation.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">Documentation</font></a><br><br>
<a href="photoshop_plugin.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1" color="#009999">Photoshop Plugin -</font></a><br><br>
</td>
<td bgcolor="#202B2F"><img src="images/arrow.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="downloads.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">Downloads</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="license.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">License</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="links.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">Related links</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
<tr>
<td align="right"><a href="mailinglist.html" style="text-decoration: none;"><font face="Arial,Helvetica,sans-serif" size="1">Mailing lists</font></a></td>
<td><img src="images/spacer.gif" width="42" height="28" alt="" border="0"></td>
</tr>
</table></td>
<td width="80" valign="top"><img src="images/spacer.gif" width="80" height="2" alt="" border="0">
<!-- secondary navigation -->
<font face="Arial,Helvetica,sans-serif" size="1" color="#009999">
<!-- <ul compact>
<li>link 1
<li>link 2
<li>link 3
<li>link 4
<li>link 5
<li>link 6
<li>link 7</ul> --></td>
</tr>
</table><!-- end navigation --></td>
<td width="500" valign="top" bgcolor="#000000">
<table width="500" border="0" cellspacing="0" cellpadding="0">
<tr>
<br></br>
<br></br>
<br></br>
</tr>
<tr>
<td valign="top"><!-- header --><font face="Verdana, Arial, Helvetica, sans-serif" size="3" color="#00cccc"><b>OpenEXR Documentation</b></font></td>
</tr>
<tr>
<td valign="top" bgcolor="#870F33"><img src="images/spacer.gif" width="10" height="1" alt="" border="0"></td>
</tr>
<tr>
<td valign="top">
<!-- begin content -->
<p> </p>
<font size="2">
<b>
OpenEXR for Adobe Photoshop</b><br>
This document describes how to use the "EXRFormat" plug-in to read and
write OpenEXR images using Adobe Photoshop.
<br>
<h5>
Supported Operating Systems</h5>
This plug-in has only been tested on MacOS 9.2.2, Mac OS X 10.2.4, and
Windows 2000. It should work on MacOS 8.1 and higher, and Windows
98 and higher, but this has not been verified.
<br>
<h5>
Supported Host Applications</h5>
This plug-in has only been tested with Adobe Photoshop 7.0. It should
work with Photoshop 5.5 and higher, but this has not been verified.
This plug-in will not work with versions of Photoshop earlier than 5.5.
<p><font size="2">This plug-in will not work correctly with other applications which support
some Photoshop file format plug-ins, such as combustion from Discreet,
or Commotion from Pinnacle Systems.
<p><font size="2">This plug-in will also not work correctly with Adobe After Effects.
An After Effects-specific plug-in may be included in a future release of
OpenEXR.
<br>
<p align="right"><a href="#top" style="text-decoration: none;"><img src="images/top.gif" width="45" height="26" alt="back to top" border="0"></a></p>
<h5>
Installation</h5>
To install the plug-in, copy it to your Photoshop plug-ins folder.
If Photoshop is running, you will have to quit it and launch it again.
Here is a typical Macintosh installation:
<p><font size="2"><img SRC="images/Picture00.jpg" NOSAVE height="554" width="350" border="0" alt="">
<p><font size="2">You could also place the EXRFormat plug-in in the "File Formats" folder,
or in any folder inside the "Plug-Ins" folder.
<br>
<p align="right"><a href="#top" style="text-decoration: none;"><img src="images/top.gif" width="45" height="26" alt="back to top" border="0"></a></p>
<h5>
Opening an OpenEXR image</h5>
Once you have installed the plug-in, you will be able to open images in
the OpenEXR format. Select "Open..." from Photoshop's File menu:
<p><font size="2"><img SRC="images/Picture01.jpg" NOSAVE height="100" width="212" border="0" alt="">
<p><font size="2">and navigate to a folder containing OpenEXR images. This example
uses the images distributed with the OpenEXR source code release.
<p><font size="2"><img SRC="images/Picture02.jpg" NOSAVE height="348" width="450" border="0" alt="">
<p><font size="2">Note that when you select an OpenEXR image, the "Format:" menu in the
Open dialog reads "OpenEXR". This lets you know that the plug-in
is installed correctly, and that Photoshop has detected that the file is
in the OpenEXR format.
<p><font size="2">When you click Open in the Open dialog, you will see a new dialog which
allows you to specify how the image is interpreted in Photoshop.
<p><font size="2"><img SRC="images/Picture03.jpg" NOSAVE height="294" width="450" border="0" alt="">
<p><font size="2">This dialog is necessary because an OpenEXR image can contain many more
colors than you can work with in Photoshop, even in Photoshop's "16 Bits/Channel"
mode. OpenEXR uses floating-point (real number) pixels, and supports
a high dynamic range of pixel values - that is, colors which are brighter
than white. Photoshop uses integer (whole number) pixels, and does
not support colors brighter than white. Because of this, not all
of the pixels in the OpenEXR image will be preserved when the image is
loaded into Photoshop. This dialog lets you control which pixels
are preserved, so that you can work with the image in Photoshop with a
minimal loss of quality.
<p><font size="2">Here is a quick explanation of what these controls do:
<ul>
<li>
Exposure: this controls the apparent exposure of the image. An exposure
of 0 (the default) will apply no change to the image. An exposure
of 1 will make the image twice as bright, revealing more detail in the
low end. An exposure of -1 will make the image twice as dark, revealing
highlights that may have been clipped at higher exposures.</li>
<li>
Gamma: this controls the gamma correction that is applied to the image.
Most images, such as JPEGs or TIFFs, are stored with an implicit gamma
encoding of 2.2, the standard for video images. OpenEXR images are
stored with no gamma correction. By default, the EXRFormat plug-in
applies a gamma correction of 2.2 to the image as it is read into Photoshop,
so that it will match the color space of other images, and display correctly
on a computer monitor. If you do not need to color-match the EXR
image with an image in another, gamma-corrected format, you might find
other gamma values more visually appealing. For example, most Macintosh
monitors have a display gamma of 1.8, not 2.2. (Microsoft Windows
computers generally have a display gamma of 2.2).</li>
<li>
Un-Premultiply: by convention, OpenEXR images are "premultiplied" - the
color channel values are already matted against black using the alpha channel.
In Photoshop, it's more convenient to work with unmatted images.
It's important to use this option rather than un-premultiplying the image
within Photoshop, because the plug-in will un-premultiply before applying
exposure and gamma correction. This option will have no affect if
your image does not contain an alpha channel.</li>
</ul>
The dialog also contains a preview area, which lets you see the effect
your settings will have on the image. Click in the black area of
the dialog to load the preview:
<p><font size="2"><img SRC="images/Picture04.jpg" NOSAVE height="295" width="450" border="0" alt="">
<p><font size="2">In this preview, we can see that this image has a fairly broad dynamic
range. Much of the image is too dark to see clearly, but the lamps
are so bright that they have been clipped at the default settings.
If we darken our exposure, however, we can see that the image does contain
data for those bright areas. Setting the exposure to -2 makes the
image four times darker - the pixels that now appear white are actually
four times brighter than "white".
<p><font size="2"><img SRC="images/Picture05.jpg" NOSAVE height="295" width="450" border="0" alt="">
<p><font size="2">We could reduce the exposure even further, and reveal more detail in
the highlights, but we would start to lose detail in the dark areas.
If we click "OK" at this point, the image will be opened in Photoshop at
an exposure of -2, and will appear very dark (as we saw in the preview):
<p><font size="2"><img SRC="images/Picture06.jpg" NOSAVE height="341" width="470" border="0" alt="">
<p><font size="2">It appears that we have lost a large amount of detail in the image,
but there is actually much more detail here than can be displayed on your
computer screen. Checking the "Image->Mode" menu in Photoshop reveals
that this image is 16 bits per channel, and a computer monitor can only
display 8 bits of information per channel.
<p><font size="2"><img SRC="images/Picture07.jpg" NOSAVE height="280" width="300" border="0" alt="">
<p><font size="2">To see the hidden detail, we can use the preview feature of Photoshop's
Levels command:
<p><font size="2"><img SRC="images/Picture08.jpg" NOSAVE height="81" width="300" border="0" alt="">
<p><font size="2">This will create a dialog that will show us the histogram of the image.
Note that there is a large gap between the brightest pixels (the blown-out
highlights) and the majority of the colors in the image.
<p><font size="2"><img SRC="images/Picture09.jpg" NOSAVE height="236" width="470" border="0" alt="">
<p><font size="2">If we adjust the white point so that the majority of the pixels define
the full range of the image, the highlights will be blown out, but more
low-end detail will be revealed.
<p><font size="2"><img SRC="images/Picture10.jpg" NOSAVE height="237" width="470" border="0" alt="">
<p><font size="2">Note that if you click OK in the Levels dialog, the range adjustment
will be applied to the actual image, and all of the overrange pixel values
will be clipped to white. When working with OpenEXR image in Photoshop,
It's important to be careful that the details you care about are preserved.
<p><font size="2">Also, note that when working on a 16 bit image in Photoshop, many features
such as painting and layers are unavailable. If you wish to use these
tools, you must convert the image to 8 bits per channel using the "Image->Mode"
menu, which will result in an even greater loss of data. Cautious
use of the exposure and gamma controls in the EXR Import dialog, along
with applying the Levels command before converting to 8 bits, will help
you use all of Photoshop's powerful tools while preserving the colors that
are most important in your image. Of course, some images will simply
contain too much data to be manipulated safely in Photoshop - it's up to
you to ensure that the image you end up with is correct and visually appealing.
<br>
<p align="right"><a href="#top" style="text-decoration: none;"><img src="images/top.gif" width="45" height="26" alt="back to top" border="0"></a></p>
<h5>
Saving an OpenEXR image</h5>
Saving an OpenEXR image is similar to opening one. When you choose
to save an image in OpenEXR format, a dialog will appear, allowing you
to specify how the image should be saved. Many of these settings
are similar to the controls provided by the Import dialog.
<p><font size="2"><img SRC="images/Picture11.jpg" NOSAVE height="249" width="300" border="0" alt="">
<p><font size="2">Note that the Exposure and Gamma settings mean something different in
this dialog - they specify the settings that currently apply to the image.
For example, when the image opened in the previous example is saved, this
dialog states that the image has been gamma corrected and darkened.
The plug-in will undo both of these settings before saving the OpenEXR
file. This means that if you use the same settings when you save
an OpenEXR image as when you opened it, the color space of the image will
stay the same. However, any colors which were lost when the image
was opened (clipped highlights or crushed low-end values) will not be restored.
If you are saving a new image, or an image originally in another format,
as an OpenEXR image, the default settings will result in a valid image.
<p><font size="2">This dialog also allows you to specify the compression scheme used to
save the OpenEXR image. The OpenEXR format supports several methods
of compression, all of them lossless.
<p><font size="2"><img SRC="images/Picture12.jpg" NOSAVE height="250" width="300" border="0" alt="">
<p align="right"><a href="#top" style="text-decoration: none;"><img src="images/top.gif" width="45" height="26" alt="back to top" border="0"></a></p>
<br>
<br>
<br>
<br>
<font face="Arial,Helvetica,sans-serif" size="1" color="#993333">© <script>var curDate=new Date(); document.write(curDate.getFullYear())</script>Copyright OpenEXR a Series of LF Projects, LLC and/or its contributors. All documentation on this website made available under a Creative Commons Attribution 4.0 International License.</FONT><br>
<p><font size="2"> </p>
<!-- end content -->
</td>
</tr>
</table></td>
</tr>
</table>
</body>
</html>