Subversion Repositories filter_foundry

Building the Filter Foundry plugin for Photoshop

------------------------------------------------

Notes on source code

--------------------

Source code, makefiles and IDE projects under GPL license are provided

for MPW (Classic & Carbon PowerPC targets), CodeWarrior 7

(Classic & Carbon PowerPC, Win32, 68K targets),

Microsoft Visual C++ (Win32/64 target), OpenWatcom (Win32 target),

mingw32 (Win32 target), and mingw64 (Win64 target).

A Photoshop SDK is required (available from Adobe Systems).

Please read the document DOWNLOAD.txt in the directory "photoshop_sdk"

for further information.

The dependency "telegraphics_common" is available here

https://www.telegraphics.com.au/svn/common/

Revision 84 (dated 9 October 2019) is included in this repository

to simplify the build process. After the addition, the

code there was updated.

Mac notes

---------

Before attempting to build, you must edit the makefiles

("FilterFoundry.make" for MPW), or change your

CodeWarrior project's access paths, to reflect the SDK's installed location.

To build the Carbon plugin with an SDK prior to version 7.0,

it is necessary to edit the SDK file

	:PhotoshopAPI:Resources:PIPL.r

as follows:

1. find the line "case CodePowerPC:"

2. duplicate the next 15 lines

3. in the copy only, change "case CodePowerPC:" to "case CodeCarbonPowerPC:"

   and change the 5 occurrences of "pwpc" to "ppcb"

Photoshop 7.0, CS, and CS2 will load Carbon/PEF plugins built in this manner.

Only CodeWarrior and MPW can build these.

Photoshop CS2 also supports Mach-O format plugins. For details on how

these are built, see the Makefile.mac (target "osx"). 

Photoshop CS3 supports "universal" (or "fat") plugins having native code

for both PowerPC and Intel architectures. The provided Makefile.mac can build

a "universal" plugin if you have the CS3 "Beta" SDK (use target "fat").

Note that building Mach-O plugins requires Apple's Developer Tools

to be installed (from the DVD that came with your Mac, or downloaded from

https://developer.apple.com/ if you have an ADC login).

The Mac build requires Apple's MoreFiles library, which can be obtained via

https://developer.apple.com/library/archive/samplecode/MoreFiles/

Depending on how the source files were extracted, it may be necessary to set

the correct Mac file types before attempting to build. In MPW, this can

be done as follows. First set the current directory to the Filter Foundry

source directory, then:

	setfile -t TEXT Å.[chrly] Å.make Å.rc ::common:tt:Å ::common:adobeplugin:Å

This can also be necessary after regenerating y.tab.c and lex.yy.c.

These files are generated from the parser and lexical analyzer definitions,

parser.y and lexer.l, by a UNIX Terminal (not MPW!) command such as:

	make y.tab.c lex.yy.c

If building with MPW, finished binaries are left in the "debug" directory;

these are good for testing and debugging, as they can be updated

and re-run without having to re-launch Photoshop.

The finished binary, which contains executables for Classic and Carbon,

is left in the "dist" directory.

While a CodeWarrior 7 project is provided, MPW and mingw32 are recommended 

as they produce much smaller executables.

MPW (Macintosh Programmer's Workshop) runs on PowerPC and

68K Macs under Mac OS 9 or earlier, or Classic under OS X.

Windows notes

-------------

BUILDING WITH VISUAL STUDIO

* For Windows, Visual Studio works best (the community edition is even free),

  and it can compile the 32-bit and 64-bit plugins for Windows.

* Download: https://visualstudio.microsoft.com/de/vs/community/

* To build in Windows with Visual Studio (IDE or command line), see the visual_studio

  subdirectory and notes (README.md).

* Most recently tested with Visual C++ 2019 and Adobe Photoshop SDK CC 2017.

BUILDING WITH OPEN WATCOM

* OpenWatcom can be used, but only for 32 Bit, and it is officially not

  supported by Adobe.

* Download: https://sourceforge.net/projects/openwatcom/files/

* To build in Windows with the OpenWatcom IDE, see the wpj

  subdirectory and notes (README.md), kindly provided by Peter Heckert and Daniel Marschall.

* Most recently tested with Open Watcom 1.9 and Adobe Photoshop SDK CC 2017.

BUILDING WITH MINGW32/64

* IMPORTANT: Building with MINGW32/64 is currently NOT possible

  because the resoure compiler doesn't resolve the compiler (windres) constants of language.h in

  language_win.rc and shows a syntax error. You can compile if you replace the constants by hand.

  Reported bug in May 8, 2022 via email, because the bugtracker doesn't allow user account creation.

* Mingw32 can be hosted on virtually any UNIX or Linux system, or under Windows.

* Download: http://mingw-w64.org/doku.php/download/mingw-builds

* Do NOT install mingw32 to a directory that contains white spaces (i.e. "C:\Program Files (x86)\")!

* To build both Win32 and Win64, you need to run setup two times:

  For 32 bit "i686" and for 64 bit "x86_64"

* Check if all paths inside the file "make_mingw32.bat" are valid, then run it.

  The files FilterFoundry.8bf (32 Bit) and FilterFoundry64.8bf (64 Bit) should now be generated.

* Most recently tested with mingw64 and Adobe Photoshop SDK 2021:

  - i686-8.1.0-posix-dwarf-rt_v6-rev0	for 32 Bit	

  - x86_64-8.1.0-posix-seh-rt_v6-rev0	for 64 Bit

ViaThikSoft builds the 32-bit version using OpenWatcom (to keep Win9x compatibility)

and the 64-bit version using Visual Studio batch file. Of course, you can do it

the way you like.

Allowing 32/64 cross-building

-----------------------------

(Currently only available in Windows)

The 32-bit version of Windows is able to create a 64-bit standalone filter

and vice-versa. Therefore, the filters need to have each other be included

as a resource. To achieve this, a post-build event is started that will

place the newest FilterFoundry.8bf and FilterFoundry64.8bf into the folder

**3264_mixer\in**. Then, **3264_mixer\foundry_3264_mixer.bat** will be started,

which mixes everything together. It will then copy back the mixed 8BF files

into the original locations so that your debugger/IDE can work with them.

The files ready for publishing are always placed in **3264_mixer\out**.

Unfortunately, the mixer will only work if a 64-bit file is existing,

therefore you MUST compile both 32-bit and 64-bit before you can continue!

Note: 32-bit and 64-bit don't need to be compiled using the same compiler.

It is fine to compile 64-bit using Visual C++ and 32-bit using OpenWatcom

(this is done by ViaThinkSoft to achieve Windows 9x compatibility).