Subversion Repositories filter_foundry

Rev

Rev 190 | Go to most recent revision | Show entire file | Regard whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 190 Rev 192
Line 1... Line 1...
1 
    This file is part of "Filter Foundry", a filter plugin for Adobe Photoshop
 1 
    This file is part of "Filter Foundry", a filter plugin for Adobe Photoshop
2 
    Copyright (C) 2003-2019 Toby Thain, toby@telegraphics.com.au
 2 
    Copyright (C) 2003-2009 Toby Thain, toby@telegraphics.com.au
- 
 
 3 
    Copyright (C) 2018-2019 Daniel Marschall, ViaThinkSoft
3 
 
 4 
 
4 
    This program is free software; you can redistribute it and/or modify
 5 
    This program is free software; you can redistribute it and/or modify
5 
    it under the terms of the GNU General Public License as published by
6 
    it under the terms of the GNU General Public License as published by
6 
    the Free Software Foundation; either version 2 of the License, or
 7 
    the Free Software Foundation; either version 2 of the License, or
7 
    (at your option) any later version.
 8 
    (at your option) any later version.
Line 21... Line 22...
21 
 
 22 
 
22 
Notes on source code
 23 
Notes on source code
23 
--------------------
 24 
--------------------
24 
Source code, makefiles and IDE projects under GPL license are provided
 25 
Source code, makefiles and IDE projects under GPL license are provided
25 
for MPW (Classic & Carbon PowerPC targets), CodeWarrior 7
 26 
for MPW (Classic & Carbon PowerPC targets), CodeWarrior 7
26 
(Classic & Carbon PowerPC, Win32, 68K targets) and mingw32 (Win32 target).
 27 
(Classic & Carbon PowerPC, Win32, 68K targets),
- 
 
 28 
Microsoft Visual C++ (Win32 target), OpenWatcom (Win32 target),
- 
 
 29 
and mingw32 (Win32 target).
27 
 
 30 
 
28 
A Photoshop SDK is required (available from Adobe Systems, http://www.adobe.com/).
 31 
A Photoshop SDK is required (available from Adobe Systems,
- 
 
 32 
https://www.adobe.com/devnet/photoshop/sdk.html ).
29 
The SDK was also distributed with Photoshop 6.0 and earlier.
 33 
The SDK was also distributed with Photoshop 6.0 and earlier.
30 
 
 - 
 
31 
The source has been built with SDK 6.0, CS2 and CS3 beta, but older
 34 
The source code has been built with SDK 6.0, CS2, CS3 beta, and 2017 but older
32 
versions can be used.
 35 
versions can be used.
33 
(If building with SDK v4, edit 68k.r, carbon.r, classic.r, and PiMI_68k.r
 36 
(If building with SDK v4, edit 68k.r, carbon.r, classic.r, and PiMI_68k.r
34 
to remove references to "PIResDefines.h", "PiPL.r" and "PiMI.r" and replace
 37 
to remove references to "PIResDefines.h", "PiPL.r" and "PiMI.r" and replace
35 
with a single #include "PIGeneral.r"; also remove "fmtCanWriteTransparency"
 38 
with a single #include "PIGeneral.r"; also remove "fmtCanWriteTransparency"
36 
from PiPL_common.r.)
 39 
from PiPL_common.r.)
37 
 
 40 
 
- 
 
 41 
 
- 
 
 42 
Mac notes
- 
 
 43 
---------
38 
Before attempting to build, you must edit the makefiles
 44 
Before attempting to build, you must edit the makefiles
39 
("FilterFoundry.make" for MPW, "Makefile" for mingw32 or OS X), or change your
 45 
("FilterFoundry.make" for MPW), or change your
40 
CodeWarrior project's access paths, to reflect the SDK's installed location.
 46 
CodeWarrior project's access paths, to reflect the SDK's installed location.
41 
 
 47 
 
42 
In order to build the Carbon plugin with an SDK prior to version 7.0,
 48 
To build the Carbon plugin with an SDK prior to version 7.0,
43 
it is necessary to edit the SDK file :PhotoshopAPI:Resources:PIPL.r
 49 
it is necessary to edit the SDK file :PhotoshopAPI:Resources:PIPL.r
44 
as follows:
 50 
as follows:
45 
1. find the line "case CodePowerPC:"
 51 
1. find the line "case CodePowerPC:"
46 
2. duplicate the next 15 lines
 52 
2. duplicate the next 15 lines
47 
3. in the copy only, change "case CodePowerPC:" to "case CodeCarbonPowerPC:"
 53 
3. in the copy only, change "case CodePowerPC:" to "case CodeCarbonPowerPC:"
48 
   and change the 5 occurrences of "pwpc" to "ppcb"
 54 
   and change the 5 occurrences of "pwpc" to "ppcb"
49 
 
 55 
 
50 
Photoshop 7.0, CS and CS2 will load Carbon/PEF plugins built in this manner.
 56 
Photoshop 7.0, CS, and CS2 will load Carbon/PEF plugins built in this manner.
51 
Only CodeWarrior and MPW can build these.
 57 
Only CodeWarrior and MPW can build these.
52 
 
 58 
 
53 
Photoshop CS2 also supports Mach-O format plugins. For details on how
 59 
Photoshop CS2 also supports Mach-O format plugins. For details on how
54 
these are built, see the Makefile (target "osx").
60 
these are built, see the Makefile (target "osx").
55 
 
 61 
 
56 
Photoshop CS3 supports "universal" (or "fat") plugins having native code
 62 
Photoshop CS3 supports "universal" (or "fat") plugins having native code
57 
for both PowerPC and Intel architectures. The provided Makefile can build
 63 
for both PowerPC and Intel architectures. The provided Makefile can build
58 
a "universal" plugin if you have the CS3 "Beta" SDK (use target "fat").
 64 
a "universal" plugin if you have the CS3 "Beta" SDK (use target "fat").
59 
 
 65 
 
60 
Note that building Mach-O plugins requires Apple's Developer Tools
 66 
Note that building Mach-O plugins requires Apple's Developer Tools
61 
be installed (from the DVD that came with your Mac, or download from
 67 
to be installed (from the DVD that came with your Mac, or downloaded from
62 
http://developer.apple.com/ if you have an ADC login).
 68 
http://developer.apple.com/ if you have an ADC login).
63 
 
 69 
 
64 
 
 - 
 
65 
Mac notes
 - 
 
66 
---------
 - 
 
67 
The Mac build requires Apple's MoreFiles library, which can be obtained via
 70 
The Mac build requires Apple's MoreFiles library, which can be obtained via
68 
https://developer.apple.com/library/archive/samplecode/MoreFiles/
 71 
https://developer.apple.com/library/archive/samplecode/MoreFiles/
69 
 
 72 
 
70 
Depending on how the source files were extracted, it may be necessary to set
 73 
Depending on how the source files were extracted, it may be necessary to set
71 
the correct Mac file types before attempting to build. In MPW, this can
 74 
the correct Mac file types before attempting to build. In MPW, this can
72 
be done as follows. First set the current directory to the Filter Foundry
 75 
be done as follows. First set the current directory to the Filter Foundry
73 
source directory, then:
 76 
source directory, then:
74 
	setfile -t TEXT Å.[chrly] Å.make Å.rc ::common:tt:Å ::common:adobeplugin:Å
 77 
	setfile -t TEXT Å.[chrly] Å.make Å.rc ::common:tt:Å ::common:adobeplugin:Å
75 
This can also be necessary after regenerating y.tab.c and lex.yy.c.
 78 
This can also be necessary after regenerating y.tab.c and lex.yy.c.
76 
These files are generated from the parser and lexical analyser definitions,
 79 
These files are generated from the parser and lexical analyzer definitions,
77 
parser.y and lexer.l, by a UNIX Terminal (not MPW!) command such as:
 80 
parser.y and lexer.l, by a UNIX Terminal (not MPW!) command such as:
78 
	make y.tab.c lex.yy.c
 81 
	make y.tab.c lex.yy.c
79 
 
 82 
 
80 
If building with MPW, finished binaries are left in the "debug" directory;
 83 
If building with MPW, finished binaries are left in the "debug" directory;
81 
these are good for testing and debugging, as they can be updated
 84 
these are good for testing and debugging, as they can be updated
82 
and re-run without having to re-launch Photoshop.
 85 
and re-run without having to re-launch Photoshop.
83 
 
 86 
 
84 
The finished binary, which contains executables for Classic and Carbon,
 87 
The finished binary, which contains executables for Classic and Carbon,
85 
is left in the "dist" directory.
 88 
is left in the "dist" directory.
86 
 
 89 
 
- 
 
 90 
While a CodeWarrior 7 project is provided, MPW and mingw32 are recommended
- 
 
 91 
as they produce much smaller executables.
- 
 
 92 
 
- 
 
 93 
MPW (Macintosh Programmer's Workshop) runs on PowerPC and
- 
 
 94 
68K Macs under Mac OS 9 or earlier, or Classic under OS X.
- 
 
 95 
 
87 
 
 96 
 
88 
Windows notes
 97 
Windows notes
89 
-------------
 98 
-------------
90 
 
 99 
 
91 
BUILDING WITH VISUAL STUDIO
 100 
BUILDING WITH VISUAL STUDIO
92 
(Most recently tested with Visual C++ 2019 with Adobe Photoshop SDK CC 2017):
 101 
	* For Windows, Visual Studio works best (the community edition is even free),
93 
 
 - 
 
- 
 
 102 
	  and it can compile the 32-bit and 64-bit plugins for Windows.
- 
 
 103 
	* Download: https://visualstudio.microsoft.com/de/vs/community/
94 
	To build in Windows with Visual Studio (IDE or command line), see the visual_studio
 104 
	* To build in Windows with Visual Studio (IDE or command line), see the visual_studio
95 
	subdirectory and notes (README.TXT).
 105 
	  subdirectory and notes (README.TXT).
- 
 
 106 
	* Most recently tested with Visual C++ 2019 with Adobe Photoshop SDK CC 2017
96 
 
 107 
 
97 
BUILDING WITH OPEN WATCOM
 108 
BUILDING WITH OPEN WATCOM
98 
(Most recently tested with Open Watcom 1.9 with Adobe Photoshop SDK CC 2017):
 - 
 
99 
 
 - 
 
100 
	To build in Windows with the OpenWatcom IDE, see the wpj
 - 
 
101 
	subdirectory and notes (README.TXT) kindly provided by Peter Heckert and Daniel Marschall.
 - 
 
102 
 
 - 
 
103 
 
 - 
 
104 
Development systems
 - 
 
105 
-------------------
 - 
 
106 
While a CodeWarrior 7 project is provided, MPW and mingw32 are recommended
- 
 
107 
as they produce much smaller executables.
 - 
 
108 
 
 - 
 
109 
Mingw32 (http://www.mingw.org/) can be hosted on virtually any UNIX or
 - 
 
110 
Linux system, or under Windows.
 - 
 
111 
 
 - 
 
112 
MPW (http://developer.apple.com/tools/mpw-tools/) runs on PowerPC and
 - 
 
113 
68K Macs under Mac OS 9 or earlier, or Classic under OS X.
 - 
 
114 
 
 - 
 
115 
For Windows, Visual Studio works best (the community edition is even free),
 - 
 
116 
and it can compile the 32-Bit and 64-Bit plugin for Windows.
 - 
 
117 
OpenWatcom can also be used, but only for 32 Bit, and it is officially not
 109 
	* OpenWatcom can also be used, but only for 32 Bit, and it is officially not
118 
supported by Adobe.
 110 
	  supported by Adobe.
119 

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

          

          

            -
            
 

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

          

          

            -
            
 

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

          

          

            -
            
 

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

          

          

            -
            
 

            115
            
 

          

          

            -
            
 

            116
            
BUILDING WITH MINGW32

          

          

            -
            
 

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

          

          

            -
            
 

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

          

          

            -
            
 

            119
            
	* Before attempting to build, you must edit the file "Makefile".

          

          

            -
            
 

            120