P4Photoshop - P4GT Photoshop Plugin

P4Photoshop is a powerful Adobe Photoshop plugin that seamlessly integrates with the Perforce version control system. It enables developers and designers to:

• Manage assets
• Collaborate across versions
• Work in multiple languages —all without leaving the Photoshop environment.

Prerequisites

To build and use the plugin, ensure the following dependencies are installed:

• Photoshop SDK Download from the Adobe Photoshop site
• Jam build system Download jam-2.6.1.zip
• OpenSSL 3
• P4 source code Download p4source.tgz from www.perforce.com or the FTP site
• Visual Studio Version matching the Adobe Photoshop edition, per Adobe's guidelines

Folder Structure

Create a root folder named p4photoshop, then follow these steps:

1. Clone the repository
   Create a folder named p4-gt and clone the repository into it:

   git clone <repo-url> p4-gt
   

2. Add Photoshop SDK
   Inside p4-gt, create a folder sdk/photoshop. Download the Photoshop SDK from Adobe and copy the photoshopapi and samplecode folders into sdk/photoshop.

3. Add Jam build system
   Create a folder named jam and unzip all Jam files into it.

4. Add OpenSSL 3
   Create a folder named openssl-3. After building the OpenSSL source code, copy the following folders:

   openssl-3\include\openssl
   openssl-3\lib

   Then, open tools/setenv20xx.bat and set the following environment variables:

   set SSLINCDIR=\path\to\openssl-3\include
   set SSLLIBDIR=\path\to\openssl-3\lib

   (ensure openssl used must be compatible with visual studio version installed)

5. Add P4 source code
   Create a folder named p4 and extract the contents of p4source.tgz into it.

Your folder structure should look like this -

p4photoshop/
├── jam/                      # Jam build system files
├── openssl-3/                # OpenSSL headers and libraries
├── p4/                       # P4API source and build scripts
├── p4-bin/                   # Generated after building P4API
├── p4-gt/                    # P4Photoshop source code
│   ├── libp4gt/              # Graphical components interfacing with P4API
│   ├── photoshop/            # Photoshop plugin source
│   ├── sdk/
│   │   └── photoshop/        # Photoshop SDK files
│   ├── tools/                # Build and utility scripts
│   ├── Jamfile               # Jam build configuration
│   ├── Jamrules              # Jam build rules
└── README.md                 # This file

Build Instructions

To build the Photoshop plugin (.8li file), follow these steps:

1. Open the Developer Command Prompt for Visual Studio
   Navigate to the root folder:

   cd p4photoshop

2. Set the environment variables
   Choose the appropriate setenv20xx.bat file based on your Visual Studio version:

   cd p4-gt\tools
   setenv20xx.bat

3. Go to the jam folder and build it:

   cd p4photoshop/jam
   nmake -a

4. Build the P4API:

   cd p4photoshop/p4
   ..\p4-gt\tools\bldp4api.bat 

   (Note: It may skip few (~6) targets - this is expected and can be ignored.)

5. Update version metadata:

   cd p4-gt\tools
   UpdateVersion.bat

6. Build the plugin:

   cd p4-gt
   tools\bldps.bat

7. Locate the output .8li file:

   For English: p4-bin\bin.ntx64\en\dyn
   For Japanese: p4-bin\bin.ntx64\ja\dyn

Install

To install the plugin in Adobe Photoshop:

1. Copy the .8li file to the Photoshop Plug-ins directory.
2. Launch Photoshop and navigate to:

   File → Automate → P4GT Photoshop

3. Click on P4 to open the Perforce integration menu.

License

See LICENSE.txt for license information.