Subversion Repositories filter_foundry

Compare Revisions

Regard whitespace Rev 192 → Rev 191

/trunk/BUILDING.txt
1,6 → 1,5
This file is part of "Filter Foundry", a filter plugin for Adobe Photoshop
Copyright (C) 2003-2009 Toby Thain, toby@telegraphics.com.au
Copyright (C) 2018-2019 Daniel Marschall, ViaThinkSoft
Copyright (C) 2003-2019 Toby Thain, toby@telegraphics.com.au
 
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
24,14 → 23,12
--------------------
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 target), OpenWatcom (Win32 target),
and mingw32 (Win32 target).
(Classic & Carbon PowerPC, Win32, 68K targets) and mingw32 (Win32 target).
 
A Photoshop SDK is required (available from Adobe Systems,
https://www.adobe.com/devnet/photoshop/sdk.html ).
A Photoshop SDK is required (available from Adobe Systems, http://www.adobe.com/).
The SDK was also distributed with Photoshop 6.0 and earlier.
The source code has been built with SDK 6.0, CS2, CS3 beta, and 2017 but older
 
The source has been built with SDK 6.0, CS2 and CS3 beta, 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
38,14 → 35,11
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), or change your
("FilterFoundry.make" for MPW, "Makefile" for mingw32 or OS X), 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,
In order 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:"
53,7 → 47,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
64,9 → 58,12
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
be installed (from the DVD that came with your Mac, or download 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/
 
76,7 → 73,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 analyzer definitions,
These files are generated from the parser and lexical analyser definitions,
parser.y and lexer.l, by a UNIX Terminal (not MPW!) command such as:
make y.tab.c lex.yy.c
 
87,33 → 84,35
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
(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
subdirectory and notes (README.TXT).
* Most recently tested with Visual C++ 2019 with Adobe Photoshop SDK CC 2017
 
BUILDING WITH OPEN WATCOM
* 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
(Most recently tested with Open Watcom 1.9 with Adobe Photoshop SDK CC 2017):
 
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".
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.