Subversion Repositories filter_foundry

Compare Revisions

Regard whitespace Rev 191 → Rev 192

/trunk/visual_studio/README.txt
2,13 → 2,13
BUILDING FILTER FOUNDRY ON VISUAL STUDIO
by Daniel Marschall
 
Most recently tested with Visual Studio 2019 with Adobe Photoshop SDK CC 2017
Most recently tested with Visual Studio 2019 and Adobe Photoshop SDK CC 2017.
 
 
Prerequisites:
================
Prerequisites
-------------
 
1) Visual Studio / C++
1) Visual Studio (Visual C++)
There is a free "Community Edition" available here:
https://visualstudio.microsoft.com/de/vs/community/
 
15,83 → 15,76
2) Flex and Bison
Download the tools here:
https://sourceforge.net/projects/winflexbison/
Put the 2 EXE files somewhere on your disk, e.g.
D:\FilterFoundry\win_flex_bison\win_bison.exe
D:\FilterFoundry\win_flex_bison\win_flex.exe
Extract the contents of the package in the directory "..\win_flex_bison"
 
3) Adobe Photoshop SDK
Available on some Photoshop CDs, or can be downloaded at
https://www.adobe.com/devnet/photoshop/sdk.html
Put it somewhere on your disk, e.g.
D:\FilterFoundry\adobe_photoshop_sdk_cc_2017_win\
Extract the contents of the package in the directory "..\photoshop_sdk"
 
4) SVN client
Get the command line svn client:
https://tortoisesvn.net/index.de.html
Get an SVN client, e.g. TortoiseSVN:
https://tortoisesvn.net/downloads.html
Make sure you include the command line tools during the install.
 
5) Windows SDK
Download the Windows SDK here:
https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk
https://developer.microsoft.com/en-us/windows/downloads/windows-10-sdk/
and install the following components:
- Windows SDK for Desktop C++ x86 Apps
- Windows SDK for Desktop C++ amd64 Apps
For some reason, you only need to install the Windows SDK if you
build using the IDE, but not if you build using command-line (*.mak files).
 
How to get FilterFoundry:
===========================
How to get FilterFoundry
------------------------
 
Make a directory anywhere (e.g. D:\FilterFoundry\) for telegraphics plugins,
remember, no spaces in pathname, then open the command line and type:
cd /d "D:\FilterFoundry\"
Make a directory anywhere (e.g. C:\FilterFoundry\) for telegraphics plugins,
then open the command line and type:
cd /d "C:\FilterFoundry\"
svn checkout https://www.telegraphics.com.au/svn/common/trunk common
svn checkout https://www.telegraphics.com.au/svn/filterfoundry/trunk filterfoundry
 
In our example, you should now have the directories
D:\FilterFoundry\common\
D:\FilterFoundry\filterfoundry\
C:\FilterFoundry\common\
C:\FilterFoundry\filterfoundry\
 
 
Build setup using the IDE:
============================
Build setup using the IDE
-------------------------
 
1. Open the visual_studio\FilterFoundry.sln
1. Open the visual_studio\FilterFoundry.sln with Visual Studio
 
2. Adjust the paths in the project settings:
a) Path to Adobe plugin SDK (in C/C++ category, and Resource category)
b) Path to win_flex and win_bison (pre-build-events)
c) Your specific version of the Windows SDK
2. Go to the project settings and change the Windows SDK version to the one you have installed.
 
3. You can now compile the x86 and x64 plugin inside the IDE.
3. You can now compile the x86 and x64 plugins inside the IDE.
The output files are:
D:\FilterFoundry\Source\visual_studio\Win32\(Release|Debug)\FilterFoundry.8bf
D:\FilterFoundry\Source\visual_studio\Win64\(Release|Debug)\FilterFoundry64.8bf
C:\FilterFoundry\Source\visual_studio\Win32\(Release|Debug)\FilterFoundry.8bf
C:\FilterFoundry\Source\visual_studio\Win64\(Release|Debug)\FilterFoundry64.8bf
 
 
Build setup using command line/nmake:
=======================================
Build setup using command line/nmake
------------------------------------
 
1. Adjust the paths in the visual_studio\nmake.mak and visual_studio\nmake64.mak files:
a) Path to Adobe plugin SDK (in C/C++ category, and Resource category)
b) Path to win_flex and win_bison (pre-build-events)
1. Check/Edit visual_studio\vc_make_3264.bat: Change the Visual Studio path to the one you have on your system.
 
2. Edit visual_studio\vc_make_3264.bat: Change the Visual Studio path to the one you have on your system.
 
3. You can now use the script visual_studio\vc_make_3264.bat to build both x86 and x64 with one click.
2. You can now use the script visual_studio\vc_make_3264.bat to build both x86 and x64 with one click.
The output files are:
D:\FilterFoundry\Source\visual_studio\FilterFoundry.8bf
D:\FilterFoundry\Source\visual_studio\FilterFoundry64.8bf
...\visual_studio\FilterFoundry.8bf
...\visual_studio\FilterFoundry64.8bf
 
 
Troubleshooting:
==================
Troubleshooting
---------------
 
- If "rc" can't be found, install the Windows 10 SDK, and then copy
C:\Program Files (x86)\Windows Kits\10\bin\...\x64 to C:\Program Files (x86)\Windows Kits\10\bin\x86
C:\Program Files (x86)\Windows Kits\10\bin\...\x64 to
C:\Program Files (x86)\Windows Kits\10\bin\x86
see also https://stackoverflow.com/questions/43847542/rc-exe-no-longer-found-in-vs-2015-command-prompt
 
- If lex.yy.c can't be found, check the flex command (it generates lex.yy.c) in the project properties
or the mak-file, respectively.
- If lex.yy.c can't be found, check the flex command (it generates lex.yy.c)
in the project properties or the mak-file, respectively.
 
- If nmake gives the error message "makefile(28) : fatal error U1000: Syntax error: ")" missing in macro invocation"
then run nmake with the parameter "/f nmake.mak" or "/f nmake64.mak"
99,7 → 92,13
 
- If you run into any problems, try "nmake /f nmake.mak clean" followed by "nmake /f nmake.mak",
or for 64 bit: "nmake /f nmake64.mak clean" followed by "nmake /f nmake64.mak"
It is necessary to run the "clean" command when switching between 32bit and 64 bit building.
It is necessary to run the "clean" command when switching between 32-bit and 64-bit builds.
 
- Since the RC files have a complex structure, you cannot edit the resources inside the IDE.
You need to edit the *.rc files manually.
 
- If the winflex/bison prebuild commands fail, Visual Studio will just show the message
'The command "cd ..'
because the command contains line breaks and so you will only see the first command "cd ..".
Hover the mouse over the error message to display the whole message (commands),
or copy it using Ctrl+C and paste it into a text editor.