CHANGELOG for ContactSheetX
2.2
Fixed Install script so it actually works again.
The ini file, if there is one, will now be put into the log file.
Fixed bug when accumulating keywords.
Fixed bug in xtools so that ${XMP:ICCProfile} would be supported
Added CSX.MAX_ROWS and CSX.MAX_COLUMNS for people to change if they
think that 30 rows and 30 columns is not enough.
Fixed bug where calling CSX from Bridge did not work in CC2015.
Fixed bug reading XMP files with Camera Raw files(e.g. NEF).
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.
1.5 CS5 Extensions packaging
Fixed autonumbering when prefix contains spaces.
Fixed bug in saving settings when recorded in Actions.
Misc. other bug fixes.
Win 7 port and testing.
xpSort will now sort on leading numbers instead of only trailing numbers.
Added better logic for handling incorrect EXIF names in caption formats.
For CS4 and CS5, there is no longer a requirement to have
Bridge open when setting EXIF format specifiers for
captions. The XMPScript extensions library will be used.
1.4.5 CS5 Upgrade
Changed to BSD-style license
1.4.2
Fixed installation problem on 64bit Vista.
1.4.1
Fixed problem with processing hidden files on OS X.
Fixed problem with captions for images with no Description field.
v1.4
Added metadata substitution capability to template variables.
Added fixMaskPhantomPixels ini setting. See ReleaseNotes for details.
Fixed redisplay problem with Color Chooser.
Fixed bug in handling accumulateKeywords setting.
Fixed problems in handling multiline captions.
Added %n, %t and % format specifiers for metadata.
Updated docs.
v1.4b4
Fixed formatting bug for GPS metadata.
Fixed Bridge sort order bug.
Fixed Color Profile settings visibility problem on Document panel.
Fixed error related to sheet post-processing.
Added improved error handling and reporting.
Fixed vertical caption alignment bug for multi-line captions.
Simplified CSXBridge implementation, especially for CS3+.
Added Middle to caption vertical alignment.
v1.4b2
Added 'Color Profile' to Document panel. Removed 'convertToProfile' and
'forceProfileMatch. from Advanced panel.
Reworked Progress Bar interaction so that Cancel now terminates the
script after the current image has been processed.
Renamed 'rasterizedThumbs' to 'embedSmartObjects'.
Added code for eventual CS4 port.
Fixed CS2 compatibility problems.
v1.4b1
Added ability to extract all metadata from an image file via Bridge
without having to open the image. This greatly speeds things up when
captions have embedded metadata.
Fixed bug where ° symbol in the default gpsFormat setting was
getting bashed.
Added @Metadata substitution layers. Needs docs and a sample template.
Greatly improved quality of thumbs by reworking SmartObject code. This
is very noticable with large source images.
Fixed a bug with Lab and Grayscale document modes not working.
Added ContactSheet-UI.log to help trackdown errors in the UI.
Added 'Show Previous Log' button on Advanced panel to show the
log file contents from the last run.
Removed logFile and logEnabled from Advanced panel. These values are
now hardwired in the script.
Fixed bug involving saving some of the settings from the Outpanel
when Save Sheet is off and Keep Sheet Open is on.
Added MS-Intuitive-Sort of filenames (xpSort = true). The setting is on
the 'Advanced' panel.
Keep thumbnails as smart objects when placed (rasterizeThumbs = false).
Added ability to disable date/gps formatting for caption fields by
prefixing EXIF, XMP or IPTC tags with a '-'. This allows the raw field
value to be passed through. Ex: %E{-DateTimeOriginal}
Moved logging so that it starts immediately (before conversion
of UI options).
Improved diagnostics for post-validation/pre-processing phase.
Fixed a potential localization problem on the Mac for HP modes that
run external applications.
Fixed bug where the script would not recurse into folders more than
2 deep in some situations.
Added support in InstallCSX for localized (non-English) versions of
Photoshop.
v1.3
Fixed postProcessAction settings bug.
v1.3b3
Removed enablePage/DateLayers.
Extended postProcessAction to support scripts. Contact xbytor
for details.
Added splitCSXLayerOnFlatten setting. This splits captions and images
onto different layers when flattening the cell layers.
Added postProcessAction setting. This action gets run just before
saving the sheet.
Added vertical caption alignment.
v1.3b2
Added "%-3.2f" style support for file-specs in captions.
Added "% " support for captions.
Resetting the settings reverts back to the defaults for all settings
rather than the settings at the start of the script.
Changed the font color selection mechanism to use a new color icon
button instead of text.
CSX now remembers the last panel that had focus in tabbed mode.
Fixed bug when forceProfileMatch is true and processing RAW files,
PS prompts for saving the RAW file.
Sheets that are created in Keep Open but not Save Sheet will now
have a name as specified by the Naming fields in the Output Panel
but will not have a file extension in the name.
On the Output Panel, the Naming fields are now active if either
Save Sheet or Keep Open are selected.
v1.3b1
Added UNINSTALLATION section to README.
Added Progress Window.
Changed to Filename Format.
Added support for file save types: bmp,gif,jpg,psd,eps,pdf,png,tga,tiff
courtesy a new GenericUI panel.
Stdlib -> Xstdlib in InstallCSX.
Enabled support for multi-line captions.
Removed templateVarsEnabled setting.
Removed captionMetadata setting.
Reworked caption specification UI.
Remove separate handling of Header setting.
Changed uiConfirmBasicModeForMetadata to true, false, uiModeOnly.
true - always prompt (if needed)
false - never prompt
uiModeOnly - only prompt if needed and if a UI is being used
v1.2
Fixed bug where filename captions had %20s instead of spaces.
Changed metadata to work better if only files (and not docs) are
available (e.g. HP Mode 1, source==bridge).
Added Bookmarks to CSX.PDF. This makes the doc a bit more usable.
Added new InstallCSX.jsx script to simplify the installation process.
Reworked Caption Panel UI.
Added GPS metadata formatting.
More cleanup of UI for CS3.
Added metadata support (and UI) for captions.
Added 'halign' property and UI to horizontally align thumbnails.
Added 'flattenCell' flag to enable/disable the flattening of the
sheet's cell layers when in Template mode.
Implementation now populates template directly instead of using an
intermediate document.
Fixed sticky Flatten flag.
Added code to Copy/Merged on image docs.
Changed distribution naming scheme.
Changed invokation mechanism from Bridge in CS3.
Added support for 'filesList' parameter when invoked by Bridge in CS3.
Changed 'recordEnabled' to 'forceRecording' for CS3 compatibility.
Reimplemented settings management and restructured implementation
files.
Added 'Next Page' and 'Next File' settings to automatically use
the next filename in a numbered sequence. The impact from a UI
perspective is minimal. It becomes important when running CSX
without a UI.
Added 'recordEnabled' flag.
Added 'alphaLayerPinRegister' flag.
Added 'forceProfileMatch' flag.
Added Template Variables panel and flag.
Added png output.
'None' for background will delete background of sheet as last step.
v1.1
Changed the runtime script name to CSX.jsx
Fixed Page Totals in %P substitution.
Disabled recording of properties for Action steps.
Fixed bug with page/file sequence numbers.
Added code to make Output Folder/Page-File Index/File Prefix smarter.
UI opens up in last position.
UI clean up on Mac. (See Folder text fields).
Added new CSXPortfolio-1 template.
Added Template Preview support on Document panel in tabbed mode.
A template preview will be presented on the panel if a file with
the same name and a png extension are found in the same folder
as the template.
Misc. minor changes for CS3 beta (moving target...).
Fixed widget state problems on Source panel.
Added Caption Alignment setting (Left,Center,Right).
Changed alignment of thumbnails to (Top,Middle,Bottom).
Bridge support cleaned up. Added installation note for CSXBridge.jsx.
Moved xtools runtime directory to Application Data on Win XP and
~/Library/Application Support on OSX.
Added automatic conversion on Resolution settings.
Improved logging support for CSXBridge
Added full Bridge support (CSX from Bridge, Bridge from CSX).
Changed log file setting to use complete path. Adjusted UI.
Made some mods to the CSX Homepage. It's less lame. But still lame.
Fixed backgrounding problem on OSX.
Fixed internal rounding errors.
Added automatic conversion of Document Width and Height when the
Document Units property is changed.
Fixed error where not having C:\temp on was causing errors in xexec.js.
v1.0
HP3 mode added
Open Documents mode now works
Added Advanced/Standard button to switch between tabbed/untabbed modes.
HP2 mode now supportd on OSX.
Added HighPerformanceMode docs.
Improved build support on OSX.
Added <javaresource> for improved CS3 support.
MacUI port.
Standard vs Advanced UI complete (needs button).
Internal code renaming.
Beta 3
The file is now executable from a double-click.
More UI tweaks.
Dialogs are now centered when opened.
CSX now recognizes the 'dialog on/off toggle' when recorded in an
action. When the toggle is turned off, CSX executes with the values
in the CSX INI file.
Added flags to enable/disable page and date layers.
Added margins support.
Swapped Columns and Rows. Makes more sense now.
Moved Header field to Advanced panel.
Removed @DateTime and @Time support.
Added YYYY/MM/DD style date/time format specifiers.
Added %p, %0p, %P Page specifiers.
Added an initial set of Presets.
Added Presets functionality.
Fixed spacing problem in thumbnail layout.
Added 'Advanced' panel.
Added Settings->View button.
Added pop-up when no images are found.
Fixed problem where .tiff and .psd files were not found. (CS2 bug).
Reworked text layer substitution mechanism for templates.
Fixed Rotation Bug.
Added enableTextSubstitutions flag in INI file.
Added specifiers for date/time formats. See
http://www.opengroup.org/onlinepubs/007908799/xsh/strftime.html
Constrain to Square.
Overlay Caption.
Beta 2 2006-10-22
Added font selector
Added 'Save Sheet' and 'Keep Sheet Open' checkboxes
Improved open-document error handling
Added Styles for Thumbnails and Captions
Added keyword propagation/accumulation
Added layer-text substitution
Added CW/CCW for Rotate
Fixed problems with centimeter handling
More better docs.
New zip directory structure.
New performance instrumentation.
$Id: CHANGELOG,v 1.83 2015/08/31 02:52:35 xbytor Exp $
CSX v2.2 README
This has been updated for CC2015.
Welcome to Contact Sheet X, an advanced contact sheet generation script for
Adobe Photoshop CS4, CS5, CS6, CC+. However, the script may still work for
CS2 and CS3, I just no longer test these releases.
Contact Sheet X (CSX) is a script-based package for Adobe Photoshop CS3-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
remove the InstallCSX.jsx script and any README files that may be there.
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.45 $
Download Latest Version
xtools-2_2.zip (5.4 MB)
