diff --git a/README.md b/README.md new file mode 100644 index 0000000..02e0a2d --- /dev/null +++ b/README.md @@ -0,0 +1,39 @@ +

+ +

+ +# Gruppe Adler PAA Photoshop Plugin + +PaaPhotoshopPlugin is a Photoshop File Format Plugin for opening and saving PAA images in Photoshop. For more information on the PAA file format check out the [public PAA file format specification](https://community.bistudio.com/wiki/PAA_File_Format). + +# Installation + +## Windows +- Download the latest `PaaFormat.8bi` from https://github.com/gruppe-adler/PaaPhotoshopPlugin/releases. +- Move the `PaaFormat.8bi` into `\Plug-ins\`. + + + +# Features +- `Open`, `Open As` menu commands can be used to read `*.paa` files. +- `Save`, `Save As` menu commands can be used to write `*.paa` files. + +# Limitations +- As per the PAA file format specification only images where the height and width is a power of 2 (`2^n`) are supported. +- Only the "RGB Color" image mode is currently support. +- Only the DXT1/DXT5 PAA Formats are currently supported. + +# Dependencies +* [Adobe Photoshop SDK](https://console.adobe.io/downloads/ps) +* [grad_aff](https://github.com/gruppe-adler/grad_aff/tree/dev) + +# Building +- Download and unpack the latest [Adobe Photoshop SDK](https://console.adobe.io/downloads/ps) +- `git clone` this repository into `adobe_photoshop_sdk_[version]/pluginsdk/samplecode/format` +- Build and install [grad_aff](https://github.com/gruppe-adler/grad_aff) +- Set the environment variables `GRAD_AFF` and `GRAD_AFF_DEBUG` to the directory where you installed grad_aff +- Set the environment variable `PS_DIR` to your Adobe Photoshop installation directory +- Open the `PaaFormat.sln` with Microsoft Visual Studio 2019 or later and build the solution \ No newline at end of file diff --git a/win/PaaFormat.vcxproj b/win/PaaFormat.vcxproj index cfa7dd3..0e7c6a9 100644 --- a/win/PaaFormat.vcxproj +++ b/win/PaaFormat.vcxproj @@ -237,9 +237,9 @@ MachineX64 - copy /Y "$(OutDir)$(ProjectName).8bi" "$(PS_DIR)\Plug-ins\File Formats\$(ProjectName).8bi" -copy /Y "$(OutDir)$(ProjectName).pdb" "$(PS_DIR)\Plug-ins\File Formats\$(ProjectName).pdb" -copy /Y "$(OutDir)$(ProjectName).bsc" "$(PS_DIR)\Plug-ins\File Formats\$(ProjectName).bsc" + copy /Y "$(OutDir)$(ProjectName).8bi" "$(PS_DIR)\Plug-ins\$(ProjectName).8bi" +copy /Y "$(OutDir)$(ProjectName).pdb" "$(PS_DIR)\Plug-ins\$(ProjectName).pdb" +copy /Y "$(OutDir)$(ProjectName).bsc" "$(PS_DIR)\Plug-ins\$(ProjectName).bsc" @@ -306,7 +306,7 @@ copy /Y "$(OutDir)$(ProjectName).bsc" "$(PS_DIR)\Plug-ins\File Formats\$(Project UseLinkTimeCodeGeneration - copy /Y "$(OutDir)$(ProjectName).8bi" "$(PS_DIR)\Plug-ins\File Formats\$(ProjectName).8bi" + copy /Y "$(OutDir)$(ProjectName).8bi" "$(PS_DIR)\Plug-ins\$(ProjectName).8bi" false