PhotoPackage can obtain images directly from a number of third party applications by installing custom integration components.  Installation and removal of the integration components is managed from the Integration page of the Preferences window.

_000001b4.pdf

The table provides the name and installation state of the third-party integrations available to PhotoPackage:



Aperture

An export plug-in for Aperture 1.x and later.





iPhoto

An export plug-in for iPhoto ’08 and later.





Lightroom

An export plug-in for Adobe Photoshop Lightroom 2 and 3.





Command Line Tool

This integration will install a photopackagejob command line utility which can be used by shell scripts, Automator actions, and the like.


Availability

The left-most table column is an indication of the existence of the third-party application.  When the application is installed, its icon is displayed; otherwise, an “empty” icon is presented.

Installation State

The right-most table column indicates the installation state of the integration.



IntegrationNotInstalled.png

The integration is not currently installed, but eligible for being installed.





IntegrationInstalled.png

The integration is installed and functioning properly.





IntegrationError.png

The integration encountered an installation error.  The failure is usually resolved by removing and re-installing the integration.  If you place the mouse pointer over the indicator, a tool tip describing the failure will be displayed.

Integration Installation

To install an integration, select it in the list and click the Install button.  Depending on the integration, you may need to provide an administrative password to install it, or the host application associated with the integration may need to be quit if it is running.  Each integration installation will prompt you for the necessary permission it needs.

Integration Removal

The removal of an integration is just a simple as installation — select it in the list and click the Remove button.  Again, permission may be asked for by the integration removal.


Using the Aperture Integration

This Integration is an Aperture Export Plug-In that will create new PhotoPackage documents using image versions as poses.  From within Aperture, select the images that you would like to use, then select the Export | PhotoPackage... menu item.  The export panel will show you the version of the PhotoPackage application that it was able to locate, and the collection of images that will be used as poses.

_000001e2.pdf


Clicking the Export button will render high resolution images and add them to a newly-created PhotoPackage document.


Using the iPhoto Integration

This Integration is an iPhoto Export Plug-In that will create new PhotoPackage documents using the edited images as poses.  From within iPhoto, select the images that you would like to use, then select the File | Export... menu item.  The export panel will show you the version of the PhotoPackage application that it was able to locate, and the collection of images that will be used as poses.

_000001e9.pdf


Clicking the Export button will render high resolution images and add them to a newly-created PhotoPackage document.


Using the Lightroom Integration

This Integration is an Lightroom Export Module that will create new PhotoPackage documents using the edited images as poses.  From within Lightroom, select the images that you would like to use, then select the File | Export... menu item.

_000001f2.pdf

Setting the desired image settings and clicking the Export button will render images and add them to a newly-created PhotoPackage document.


Using the Command Line Tool Integration

This Integration is meant for more advanced users.  It installs a Unix command line tool which can be used for creating new PhotoPackage documents via other scripts or automated tools.


The command usage is:


photopackagejob <options> <imagePathname> [<imagePathname>]*


where <options> are

  -v, --verbose           Increase verbosity

      --version           Display version and exit

  -h, --help              Display this help and exit


The tool will create a new PhotoPackage document and add all of the images provided on the command line as poses.