ps-scripts Files

Hear are the most recent changes. If you already have 2.1, you probably do not
need 2.1.1 as only one incidental feature/change has occured and no bugs were
fixed in the release.

			CHANGELOG for ContactSheetX
2.1.1
	Added CSX.CAPTION_IMAGE_GAP setting. It allows fine tuning of
	the gap between the caption and the thumbnail. The default is 0
	and it's value is in pixels.
	
2.1     CC Port

        Fixed critical font-size bug

        Miscellaneous other fixes for CC/2014 port.

2.0     CS6 port

        Fixed a problem with accumulateKeywords.
        
        Fixed pin register bug.

        Tuned up code for handling color profiles.

        Fixed a bug where splitCSXLayersOnFlatten would fail if captions
        were not used.

CSX v2.1.1 README

Welcome to Contact Sheet X, an advanced contact sheet generation script for
Adobe Photoshop CS2, CS3, CS4, CS5, CS6, CC+. However, I do not test on CS2.

Contact Sheet X (CSX) is a script-based package for Adobe Photoshop CS2-CC
that provides a full featured contact sheet generator. The core of the
package has capabilities that include everything found in Contact Sheet II
(bundled with Photoshop) as well as some of the contact sheet facilities
found in Adobe Lightroom.

INSTALLATION:

For CS5/CS6, there is an Adobe Extensions package available (a .mxp file).
Use that and you're done.

For CS4 and earlier and CC+, use the ZIP'd version of CSX.

If there are previous versions of CSX, be sure to remove them at
this time. Failure to do so may result in 'Copy' errors during installation.

Unzip the CSX zip file into a temporary directory. It's location is
unimportant EXCEPT DO NOT unzip it anywhere your Photoshop application tree.
Run the InstallCSX script in the top-level directory. You can do this by:

1) double clicking it
2) dragging it onto a PS application
3) running it from inside PS via File->Scripts->Browse

If your OS is Vista or Windows 7, you will probably need to start Photoshop using
'Run as administrator' because the installation script needs to install
CSX into Photoshop folders that are normally protected. Alternatively,
you can manually create the folder C:\Program Files\Adobe\xtools with 'write'
permissions enabled.

If you have more than one installation of Photoshop on your computer, you'll
need to run the installation script for each copy of Photoshop.

On Windows, if you are running 32bit and 64bit versions of Photoshop, you'll
have to run the installation script for each version.

When the installation is complete, you can removed the contents that you
unzipped before.

MANUAL INSTALLATION:
You don't need to do this if you ran the InstallCSX script.

If there are previous versions of this script, be sure to remove them at
this time.

Unzip the distrubution file in your Photoshop Presets/Scripts directory and
restart Photoshop. "CSX-1_5.jsx" should appear in your File->Scripts menu
in CS2.

With CS3 and newer it should appear under File->Automate menu as
'Contact Sheet X v1.5...'.


BRIDGE SUPPORT:
If you want a 'Contact Sheet X' entry in your Bridge Tools menu, you need
need to copy a the CSX bridge script to the right directory. The script is
csx/Bridge Scripts Only/CSXBridge-1_5.jsx.

INSTALLATION:
If you ran the InstallCSX script, you do not need to do anything else; the
Bridge support scripts have already been installed


MANUAL BRIDGE SUPPORT INSTALLATION:
You don't need to do this if you ran the InstallCSX script.

If there are previous versions of this script, be sure to remove them at
this time.

Copy that script to one of the following folders:
   On WinXP CS2
      %CommonProgramFiles%\Adobe\StartupScripts
   On WinXP CS3
      %CommonProgramFiles%\Adobe\Startup Scripts CS3\Adobe Photoshop
   On WinXP+ CS4
      %CommonProgramFiles%\Adobe\Startup Scripts CS4\Adobe Photoshop
   On WinXP+ CS5
      %CommonProgramFiles%\Adobe\Startup Scripts CS5\Adobe Photoshop
   On WinXP+ CS6
      %CommonProgramFiles%\Adobe\Startup Scripts CS6\Adobe Photoshop
   On OSX CS2
      /Library/Application Support/Adobe/StartupScripts
   On OSX CS3
      /Library/Application Support/Adobe/StartupScripts CS3/Adobe Photoshop
   On OSX CS4
      /Library/Application Support/Adobe/StartupScripts CS4/Adobe Photoshop
   On OSX CS5
      /Library/Application Support/Adobe/StartupScripts CS5/Adobe Photoshop
   On OSX CS6
      /Library/Application Support/Adobe/StartupScripts CS6/Adobe Photoshop

For CC and CC2014, use the corresponding subfolders.

%CommonProgramFiles% is usually equivalent to something like:
    C:\Program Files\Common Files\

If you also have a C:\Programs (x86)\Common Files\, you may need to copy
the Bridge script there.

More detailed installation instructions can be found in the CSX.pdf file along
with a description of the files that are actually installed.


WHEN YOU HAVE A PROBLEM
If you find any problems please send a note to xbytor@gmail.com and/or
file a bug report at
   http://sourceforge.net/tracker/?func=add&group_id=173281&atid=864854

When you file a bug report, please include your CSX log file.
You can find the log file here on WinXP (or somewhere similar):
   C:\Documents and Settings\[user id]\Application Data\xtools\ContactSheetX.log

on Vista and Windows:
   C:\Users\[user id]\AppData\Roaming\xtools

and someplace like this on OSX:
   /Users/[user id]/Library/Application Support/xtools/ContactSheetX.log


UNINSTALLATION

1) In the Photoshop Presets/Scripts folder, delete the file CSX*.jsx and
   the folder csx.

2) To remove Bridge support remove the CSXBridge*.jsx file from one of the
   installation folders listed in the MANUAL INSTALLATION section above.

3) Remove the ContactSheetX.log and ContactSheetX.ini files
   On WinXP (or somewhere similar):
      C:\Documents and Settings\[user id]\Application Data\xtools

   on Vista or Win7:
      C:\Users\[user id]\AppData\Roaming\xtools

   and someplace like this on OSX:
      /Users/[user id]/Library/Application Support/xtools

4) You can also remove that xtools directory if you have no other
   scripts using it.


VIDEO TUTORIAL
Some kind user of CSX (amolloy02) has put together a video tutorial for CSX.
It's based on an earlier version, but it's still useful. And it was very cool
to stumble across. Many thanks to him for this.

TROUBLESHOOTING
When things go wrong, here's a list of things you can try on your own.
1 - Use Image Processor or Batch an action to make a copy of all of your image
    where the size is 1024x1024 or smaller.
2 - Try it from another account on the same machine.
3 - Try it on another machine, of possible.
4 - After you make one set of sheets, restart PS and try to do another set.
    That should work and indicates that something in PS/JS is (probably) getting
     corrupted in memory.
5 - If you are not on the most recent version of CS, download a trial copy of the
    current versions, install CSX there and see if it behaves any better. If it
     does (as I suspect), then you have found a version-specific problem in PS.


NOTES
This is Open Software. Use it. Pass it around. Sell it if you want. Just make
sure this copyright, license, and contact information go with the software.

Copyright: (c)2010, xbytor
License: http://www.opensource.org/licenses/bsd-license.php
Contact: xbytor@gmail.com

Enjoy. And remember:
   "The Software shall be used for Good, not Evil."

-X

$Revision: 1.41 $