From 923df0243f895bc4b29a8b6ab5a2587f5a86f477 Mon Sep 17 00:00:00 2001 From: Willard Date: Fri, 24 Jul 2020 19:47:40 +0200 Subject: [PATCH 1/3] Inital readme --- README.md | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..fe3b6be --- /dev/null +++ b/README.md @@ -0,0 +1,24 @@ +# 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 +Move the `PaaFormat.8bi` into `\Plug-ins\`. + +## MacOS +Move the `PaaFormat.plugin` into `Applications/Adobe Photoshop/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. From 2043c8185f3d5195c890a726421be569a7b90c44 Mon Sep 17 00:00:00 2001 From: Willard Date: Fri, 24 Jul 2020 19:51:07 +0200 Subject: [PATCH 2/3] Logo to the top --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index fe3b6be..02fb367 100644 --- a/README.md +++ b/README.md @@ -1,9 +1,9 @@ -# Gruppe Adler PAA Photoshop Plugin -

+# 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 From 769385593c4b940f58b810814cfceec99fb3e188 Mon Sep 17 00:00:00 2001 From: Willard Date: Thu, 6 Aug 2020 19:47:52 +0200 Subject: [PATCH 3/3] readme and config --- README.md | 17 ++++++++++++++++- win/PaaFormat.vcxproj | 8 ++++---- 2 files changed, 20 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 02fb367..02e0a2d 100644 --- a/README.md +++ b/README.md @@ -9,10 +9,13 @@ PaaPhotoshopPlugin is a Photoshop File Format Plugin for opening and saving PAA # Installation ## Windows -Move the `PaaFormat.8bi` into `\Plug-ins\`. +- 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. @@ -22,3 +25,15 @@ Move the `PaaFormat.plugin` into `Applications/Adobe Photoshop/Plug-ins/`. - 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