Subversion Repositories filter_foundry

Compare Revisions

Regard whitespace Rev 191 → Rev 192

/trunk/BUILDING.txt
1,5 → 1,6
This file is part of "Filter Foundry", a filter plugin for Adobe Photoshop
Copyright (C) 2003-2019 Toby Thain, toby@telegraphics.com.au
Copyright (C) 2003-2009 Toby Thain, toby@telegraphics.com.au
Copyright (C) 2018-2019 Daniel Marschall, ViaThinkSoft
 
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
23,12 → 24,14
--------------------
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) and mingw32 (Win32 target).
(Classic & Carbon PowerPC, Win32, 68K targets),
Microsoft Visual C++ (Win32 target), OpenWatcom (Win32 target),
and mingw32 (Win32 target).
 
A Photoshop SDK is required (available from Adobe Systems, http://www.adobe.com/).
A Photoshop SDK is required (available from Adobe Systems,
https://www.adobe.com/devnet/photoshop/sdk.html ).
The SDK was also distributed with Photoshop 6.0 and earlier.
 
The source has been built with SDK 6.0, CS2 and CS3 beta, but older
The source code has been built with SDK 6.0, CS2, CS3 beta, and 2017 but older
versions can be used.
(If building with SDK v4, edit 68k.r, carbon.r, classic.r, and PiMI_68k.r
to remove references to "PIResDefines.h", "PiPL.r" and "PiMI.r" and replace
35,11 → 38,14
with a single #include "PIGeneral.r"; also remove "fmtCanWriteTransparency"
from PiPL_common.r.)
 
 
Mac notes
---------
Before attempting to build, you must edit the makefiles
("FilterFoundry.make" for MPW, "Makefile" for mingw32 or OS X), or change your
("FilterFoundry.make" for MPW), or change your
CodeWarrior project's access paths, to reflect the SDK's installed location.
 
In order to build the Carbon plugin with an SDK prior to version 7.0,
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:"
47,7 → 53,7
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.
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
58,12 → 64,9
a "universal" plugin if you have the CS3 "Beta" SDK (use target "fat").
 
Note that building Mach-O plugins requires Apple's Developer Tools
be installed (from the DVD that came with your Mac, or download from
to be installed (from the DVD that came with your Mac, or downloaded from
http://developer.apple.com/ if you have an ADC login).
 
 
Mac notes
---------
The Mac build requires Apple's MoreFiles library, which can be obtained via
https://developer.apple.com/library/archive/samplecode/MoreFiles/
 
73,7 → 76,7
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 analyser definitions,
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
 
84,35 → 87,33
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
(Most recently tested with Visual C++ 2019 with Adobe Photoshop SDK CC 2017):
 
To build in Windows with Visual Studio (IDE or command line), see the 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.TXT).
* Most recently tested with Visual C++ 2019 with Adobe Photoshop SDK CC 2017
 
BUILDING WITH OPEN WATCOM
(Most recently tested with Open Watcom 1.9 with Adobe Photoshop SDK CC 2017):
* OpenWatcom can also 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.TXT), kindly provided by Peter Heckert and Daniel Marschall.
* Most recently tested with Open Watcom 1.9 with Adobe Photoshop SDK CC 2017
 
To build in Windows with the OpenWatcom IDE, see the wpj
subdirectory and notes (README.TXT) kindly provided by Peter Heckert and Daniel Marschall.
 
 
Development systems
-------------------
While a CodeWarrior 7 project is provided, MPW and mingw32 are recommended
as they produce much smaller executables.
 
Mingw32 (http://www.mingw.org/) can be hosted on virtually any UNIX or
Linux system, or under Windows.
 
MPW (http://developer.apple.com/tools/mpw-tools/) runs on PowerPC and
68K Macs under Mac OS 9 or earlier, or Classic under OS X.
 
For Windows, Visual Studio works best (the community edition is even free),
and it can compile the 32-Bit and 64-Bit plugin for Windows.
OpenWatcom can also be used, but only for 32 Bit, and it is officially not
supported by Adobe.
BUILDING WITH MINGW32
* Mingw32 can be hosted on virtually any UNIX or Linux system, or under Windows.
* Download: http://mingw-w64.org/doku.php/download
* Before attempting to build, you must edit the file "Makefile".