From d1d9760b084f460cf21de2b8e273e8d6adcfb4f6 Mon Sep 17 00:00:00 2001 From: Cary Phillips Date: Tue, 7 Aug 2018 13:46:54 -0700 Subject: [PATCH] README.md cleanup --- OpenEXR_Viewers/AUTHORS | 12 --- OpenEXR_Viewers/COPYING | 34 ------ OpenEXR_Viewers/INSTALL | 2 - OpenEXR_Viewers/Makefile.am | 6 +- OpenEXR_Viewers/NEWS | 2 - OpenEXR_Viewers/README.OSX | 18 ---- OpenEXR_Viewers/README.win32 | 196 ----------------------------------- 7 files changed, 4 insertions(+), 266 deletions(-) delete mode 100644 OpenEXR_Viewers/AUTHORS delete mode 100644 OpenEXR_Viewers/COPYING delete mode 100644 OpenEXR_Viewers/INSTALL delete mode 100644 OpenEXR_Viewers/NEWS delete mode 100644 OpenEXR_Viewers/README.OSX delete mode 100644 OpenEXR_Viewers/README.win32 diff --git a/OpenEXR_Viewers/AUTHORS b/OpenEXR_Viewers/AUTHORS deleted file mode 100644 index e4f8fa6065..0000000000 --- a/OpenEXR_Viewers/AUTHORS +++ /dev/null @@ -1,12 +0,0 @@ -Developers: ------------ - -Florian Kainz -Drew Hess - - -Win32 build system: -------------------- - -Kimball Thurston - diff --git a/OpenEXR_Viewers/COPYING b/OpenEXR_Viewers/COPYING deleted file mode 100644 index 6372750d3c..0000000000 --- a/OpenEXR_Viewers/COPYING +++ /dev/null @@ -1,34 +0,0 @@ -Copyright (c) 2006, Industrial Light & Magic, a division of Lucasfilm -Entertainment Company Ltd. Portions contributed and copyright held by -others as indicated. 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 - any other contributors to this software 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. - diff --git a/OpenEXR_Viewers/INSTALL b/OpenEXR_Viewers/INSTALL deleted file mode 100644 index 10613ac6f3..0000000000 --- a/OpenEXR_Viewers/INSTALL +++ /dev/null @@ -1,2 +0,0 @@ -See the README file for instructions on how to build OpenEXR_Viewers from -source. diff --git a/OpenEXR_Viewers/Makefile.am b/OpenEXR_Viewers/Makefile.am index d816254ed0..6eb758a96d 100644 --- a/OpenEXR_Viewers/Makefile.am +++ b/OpenEXR_Viewers/Makefile.am @@ -8,7 +8,9 @@ DIST_SUBDIRS = \ $(SUBDIRS) EXTRA_DIST = \ - AUTHORS COPYING ChangeLog INSTALL LICENSE NEWS \ - README README.CVS README.OSX README.win32 bootstrap + ChangeLog \ + LICENSE \ + README.md \ + bootstrap diff --git a/OpenEXR_Viewers/NEWS b/OpenEXR_Viewers/NEWS deleted file mode 100644 index 4b4cbb466d..0000000000 --- a/OpenEXR_Viewers/NEWS +++ /dev/null @@ -1,2 +0,0 @@ -Version 0.9.0 - - initial release diff --git a/OpenEXR_Viewers/README.OSX b/OpenEXR_Viewers/README.OSX deleted file mode 100644 index d7fb7527fe..0000000000 --- a/OpenEXR_Viewers/README.OSX +++ /dev/null @@ -1,18 +0,0 @@ -OpenEXR_Viewers on MacOS X ------------------- - -Building OpenEXR_Viewers on MacOS X is just like building it on GNU/Linux. -Follow the instructions in the README file under BUILDLING OPENEXR_VIEWERS, -but see below re: shared libraries. - -On OS X 10.4, you can build universal binaries by passing -'--enable-osx-universal-binaries --disable-dependency-tracking' to the -configure script. The default is *not* to build universal binaries. - - -Known bugs ----------- - -None. - - diff --git a/OpenEXR_Viewers/README.win32 b/OpenEXR_Viewers/README.win32 deleted file mode 100644 index ed03d81aee..0000000000 --- a/OpenEXR_Viewers/README.win32 +++ /dev/null @@ -1,196 +0,0 @@ -OpenEXR_Viewers is one of five software packages that were designed to -work together: IlmBase, OpenEXR, OpenEXR_Viewers, CTL and OpenEXR_CTL. -OpenEXR_Viewers contains two OpenEXR image viewing programs that can -be built with or without support for color rendering via CTL. - -What follows are instructions for building OpenEXR_Viewers with CTL -support. To build without CTL support, skip steps 3 and 4. - -A couple of notes before getting started: - -- This is not the only way to do this. This document describes a path -that doesn't involve installing libraries into default system paths, -but rather, creates a standalone universe. -- Some of these steps may be a bit redundant, and will be optimized in -the future. -- The Debug versions of the libraries and tools are not required if -you are not going to be doing any debugging, and can be optionally -built. - -The source will build under both Visual Studio versions 7 and 8, and -there are separate directories for the corresponding build files. The -tag is used in this document to describe the appropriate folder -in the path that corresponds to your the version of Visual Studio. - -The Visual Studio project files assume, and help build out, a directory -called "Deploy". In the end, this directory will contain the objects -that might then be moved away from the source for general running of the -compiled programs. The directory structure at the end of compiling all -the related tools looks like this: - -Deploy - include - lib - Debug - Release - bin - Debug - Release -openexr-cvs (name as desired) - IlmBase - OpenEXR - OpenEXR_Viewers -ctl-cvs (name as desired) - CTL - OpenEXR_CTL -fltk - FL - GL - lib -nvidia - include - GL - glh - lib - -If OpenEXR_Viewers is not being compiled, then fltk and nvidia will -not be needed, but that will be covered later. - -Step 1. Compile IlmBase - - a. Point Visual Studio at the .sln file in vc\\IlmBase in the - IlmBase subdirectory - - b. Select the Release configuration and hit Build Solution. This - will create the Deploy directory, and copy the relevant parts to it. - - c. If the debug versions are desired, select the Debug configuration - and hit Build Solution. This will add the Debug directories to Deploy. - -Step 2. Compile OpenEXR support - - a. Retrieve the zlib binaries. The project files are set up to link - against the dll version of zlib, but can easily be changed to link - against a static version, or a self-built version if desired. - - 1. Go to http://www.zlib.net and download the precompiled DLL - version of zlib (as of writing, zlib123-dll.zip) - - 2. If you don't wish to put the files into your MS visual studio - directories and install the dll into windows\system32: - - a. Put a copy of zlib1.dll into Deploy\bin\Release and - Deploy\bin\Debug - - b. Copy the header files into Deploy\include - - c. Copy zdll.lib and zdll.exp into Deploy\lib\Release and - Deploy\lib\Debug - - b. Open the Visual Studio project in OpenEXR\vc\\OpenEXR. - - c. Select the Release configuration and build. The IlmImfTest - program runs a confidence test of your build to make sure - it is able to work, and may take some time to complete. - - d. Optionally select the Debug configuration and build. - -Step 3. Compile CTL support - - a. Open the Visual Studio project in CTL\vc\\CTL. - - b. Select the Release configuration and build. The IlmCtlTest - program runs a confidence test of your build to make sure it is - able to work, and may take some time to complete. - - c. Optionally select the Debug configuration and build. - -Step 4. Compile OpenEXR_CTL support - - a. Open the Visual Studio project in OpenEXR_CTL\vc\\OpenEXR_CTL. - - b. Select the Release configuration and build. - - c. Optionally select the Debug configuration and build. - -Step 5. Compile OpenEXR_Viewers - - a. Open the appropriate Visual Studio project in - OpenEXR_Viewers\vc\\OpenEXR_Viewers depending on whether or not - you want CTL support. - - b. exrdisplay requires fltk to work. - - 1. Go to http://www.fltk.org and download fltk 1.1.7 - - 2. Open its project files and compile using the instructions they - provide. - - 3. Create the fltk directory at the top level of your directory - structure as presented above and copy the FL, GL, and lib folders - into the fltk directory - - 4. exrdisplay links fltk statically, so no dll is needed. - - c. playexr requires the nvidia cg library as well as glut and glew. - - 1. Setup the cg toolkit - - a. Go to http://developer.nvidia.com, the developer section and - download the cg toolkit, version 1.5, and install it. The path - where you choose to install Cg is referred to by the - tag in the steps below. - - b. During the installation, if the integrate with visual studio - option is selected, the header files will be automatically found. - Otherwise, copy the directory \Cg\include\Cg - to Deploy\include\Cg - - b. Copy the cg.dll and cgGL.dll from the \Cg\bin - into Deploy\bin\Release and Deploy\bin\Debug, or otherwise make - them available (put them in system32, add to path, etc.) - - c. Copy the cg.lib and cgGL.lib from \Cg\lib - into Deploy\lib\Release and Deploy\lib\Debug - - 2. Make glut available. This can be done via several mechanisms. - See step 4 below. - - 3. Make glew available. This can be done via several mechanisms. - http://glew.sourceforge.net is the master site for this - library. See step 4 below. - - 4. nVidia makes both glut and glew available in their SDK package, - which is a fairly large download, but provides a wealth of other - information on programming for the GPU, and is generally a useful - package, so that is the path chosen for this set up. - - a. Go to http://developer.nvidia.com and download version 10 of the - SDK and install it. It will prompt you to install the Cg toolkit, - but this is not necessary as it was handled in step 1. The path - where you choose to install the SDK is referred to by the - tag in the steps below. - - b. Make an nvidia folder at the top level, with an include and - lib folder inside it. Inside the lib folder, make Debug and - Release folders. - - c. Copy the \external\include\GL directory into - nvidia\include the GL and glh folders into nvidia\include. - - d. Copy the glew headers in \common\GLEW\include\GL - into nvidia\include\GL. - - e. Copy \common\GLEW\lib\glew32.lib and - \external\lib\glut32.lib into Deploy\bin\Release. - - f. Copy bin\glut32.dll and bin\glew32.dll into Deploy\bin\Release. - - d. Build the Release configuration of the OpenEXR_Viewers. - - e. Build the Debug configuration if desired. - -At this point, the Deploy folder should be fully built out and ready -to be used. Both exrdisplay and playexr are meant to be launched from -the command line, as they originated as unix commands, so open a command -prompt, cd to the Deploy\bin\Release folder and enjoy.