Upgrade Camera to Visual Studio 2012

Last changed: 13 August 2015.

Contents

Prerequisites · 11-jun-2015
Create Subversion branch for Camera 6 · 9-jun-2015
Upgrade Camera dependencies · 29-jun-2015
Upgrade Visual Studio projects & code · 29-jun-2015
Upgrade build system to use VS2012 · 10-aug-2015 · 11-aug-2015
Verify files needed in bin/DebugStore, bin/ReleaseStore folders · 30-jun-2015
Replace VC6-specific code with standard C++. · 1-jul-2015
Update installer · 30-jun-2015 · 2-jul-2015 · 9-jul-2015 · 10-aug-2015
Remaining issues · 13-aug-2015
Releases · 8-jul-2015 · 9-jul-2015 · 25-aug-2015 · 10-sep-2015

Prerequisites

Release Camera 4.3.5 (down-up scanning) · 28-may-2015
Release Camera 5.0.0, 5.0.1 (spectroscopy) · 28-may-2015, 3-jun-2015
Install Visual Studio 2012 · 15-jan-2014
Buy Stingray Studio 11.3 32-bit · 10-jun-2015
Received Stingray Studio 11.3 32-bit · 11-jun-2015

Create Subversion branches

Create camera-6 branch from camera-5 branch
Create camera-6.0.x branch from camera-6 branch (perform upgrade to VS2012 here)
Checkout working copy of camera-6
Checkout working copy of camera-6.0.x

Upgrade Camera dependencies

Adapt CxImage to VS2012, see also Note 1 · 10-jun-2015
Adapt Ultimate Grid version 7.2 to VS2012, see also Note 2 · 16-jun-2015
Provide HDF5 as vendor dependency, Note 3 , Note 4 [5] · 29-jun-2015
Replace Stingray studio 2006 v2 by version 11.3 32-bit, provide as vendor dependency, Note 3 [6][7]

Upgrade Visual Studio projects & code

Note: During upgrade try to keep VC6 version working.

./Camera/...) · 29-jun-2015
./CameraDll/... Note: a large part of Camera software sits here.) · 29-jun-2015
./CameraDll/CameraDllDialogs/... · 22-jun-2015
./CameraHook/... · 16-jun-2015
./CameraUtil/... · 16-jun-2015
./CameraViewer/... · 10-jun-2015
./CFiltLib/... · 16-jun-2015
./DualFiberPciCard/LpmDualFiberPciCardDll/... · 17-jun-2015
- Api1 + Driver 4.40
- Api1 + Driver 6.50
./DualFiberPciCard/LpmDualFiberPciCardDll2/... · 17-jun-2015
- Api2 + Driver 4.40
- Api2 + Driver 6.50
./DualFiberPciCard/Vendor/... · 17-jun-2015
- PlxApi 4.40
- PlxApi 6.50
- PlxDriver 4.40 (copying)
- PlxDriver 6.50 (copying)
./Graphics/Graphics.dsp · 16-jun-2015
./PythonDLL/... (no changes required?)
./Stingray/... (no changes required, keep until vc6 abandoned)
./Vendor/CxImage - Image export (CxImage DLL) and CameraViewer (CxImage LIB); moved from ./CxImage · 15-jun-2015
- CxImage
- CxImageDll
- jpeg2000
- jbig
- jpeg
- png
- tiff
- zlib
./Vendor/Hdf5 (placeholder for HDF5 library) · 29-jun-2015
./Vendor/UltimateGrid v7.2 · 16-jun-2015, 18-jun-2015 (moved from ./Utils)
./Vendor/Stingray (placeholder for Stingray Studio 11.3 32-bit) · 16-jun-2015

Upgrade build system to use VS2012

./CameraDLL/Project/Build/BuildHdf5CameraDLL.bat) · 29-jun-2015
./BuildHdf5Api.bat) · 29-jun-2015
./BuildUniverse.bat (upgrade version handling from .dsw to .sln file) · 10-aug-2015
./BuildUniverse.bat (remove project configuration check using .dsp files) · 11-aug-2015
./PushWeb.bat · 29-jun-2015

Verify files needed in bin/DebugStore, bin/ReleaseStore folders

Keep python24.dll · 29-jun-2015
Keep msvcr71.dll (needed by python24.dll)
Remove *.hap
Remove *.rbf
Remove MFCD42D.DLL
Remove MFCO42D.DLL
Remove MFC42D.DLL
Remove MSVCP60D.DLL
Remove MSVCRTD.DLL
Remove python23.dll
Remove pywintypes23.dll
Remove pythoncom23.dll
Remove vc6-re200l.dll

Replace VC6-specific code with standard C++

Camera Common/...

static_assert · 1-jul-2015
sized types, std::int8_t, <cstdint> · 1-jul-2015
std::shared_ptr<>, <memory> · 1-jul-2015
std::min(), std::max(), <algorithm> · 1-jul-2015
std::lock<>, std::mutex<>, <mutex> (./Sync) [Can be removed] · 1-jul-2015
keep lpm::isnan(), std::isnan(), <math> · 1-jul-2015
keep common/Path for now std::path etc, <filesystem> · 1-jul-2015

CameraDLL core/...

sized types, std::int8_t, <cstdint> · 1-jul-2015
std::shared_ptr<>, <memory> · 1-jul-2015
keep common/Path for now std::path etc, <filesystem> · 1-jul-2015

Update installer

Supply redistributable package for Visual Studio 2012 (v11.4) · 30-jun-2015
~~Omit Debug build from Windows XP installation and supply no-op shortcut for Camera (Debug).~~ · 2-jul-2015
Include Debug build in Windows XP installation after correcting debug runtime files. · 10-aug-2015
Add debug runtime (Debug). · 8-jul-2015
Fix location of hh.exe used in shortcuts. · 8-jul-2015
Fix check for redistributable package version. · 8-jul-2015

Remaining issues

Fix crash under Windows 8 due to acquiring unique toolbar Id (Workaround). · 2-jul-2015
Fix crash due to bracketed unit on IV Tab. · 2-jul-2015
Fix white background of Tabs on Digital Scan and Approach mode under Windows 7 & 8. · 12-aug-2015
Will-not-fix Registration database update failed for key 'Camera.Scan.Document', 12 more under Windows 7 & 8.
This is not a problem with Camera 5.0.1 (Debug) under Windows XP.
Note: this (e.g. opening a .csc file) probably has never worked. · 13-aug-2015
Fix running of Camera Debug version on Windows XP. · 2-jul-2015 · 10-aug-2015
Make sure Camera builds outside a Subversion working-copy (exported from a -). · 8-jul-2015
Update project description (e.g. External dependencies Stingray Studio 11.3, Hdf5 1.8.8). · 8-jul-2015
Update several screen shots in online help.

Releases

Release Camera-6.0.0-RC1 · 8-jul-2015
Release Camera-6.0.0-RC2 · 8-jul-2015
Release Camera-6.0.0-RC3 · 9-jul-2015
Release Camera-6.0.0-RC4 · 9-jul-2015
Release Camera-6.0.0-RC5 · 25-aug-2015
Release Camera-6.0.0 · 10-sep-2015

Notes

Note 1: Initially I planned to upgrade CxImage using [1][2][3]. However that newer version (2008) was not directly compatible with the version used from 2002, so I adapted the version already in use.

Note 2: Initially I planned to upgrade Ultimate Grid to version 7.3 [4]. However, the current version, 7.2 was easily adapted for Visual Studio 2012 and upgrading can be done later if at all. I moved it from ./Utils to ./Vendor.

Note 3: With vendor dependency, I mean that the software is located outside the Camera repository and referred to via an environment variable or via a sym-link. It may, or may not be held in a repository. Contrast this with a Subversion external, which puts an external Subversion repository effectively in the source tree. The latter form of coupling is too strong for vendor-supplied libraries such as HDF5 and Stingray Studio to keep these libraries really separate from the Camera sources.

Note 4: Make sure to build HDF5 DLLs using the Visual Studio 2012 - Windows XP (v110_xp) toolset:

Generate HDF5.sln for Visual Studio 2012 using CMake
For all non-utility projects, change the Configuration Properties | General: Platform Toolset property to Visual Studio 2012 - Windows XP (v110_xp)
From Build | Batch Build select ALL_BUILD|Debug and ALL_BUILD|Release and click Rebuild.

References

[1] CxImage. Davide Pizzolato. CodeProject. 15 February 2008.
[2] CxImage VS2010 port. Bruce B Campbell. 2008. 7 June 2012.
[3] CxImage VS2010 port on GitHub. Bruce B Campbell. 2008. 13 April 2014.
[4] Ulitmate Grid 7.3. The Ultimate Toolbox, metalogicsw.com, CodeProject. 15 September 2013.
[5] HDF5. The HDF Group.
[6] Stingray Studio. RogueWave Software.
[7] Stingray Studio 11.3 documentation. RogueWave Software.

Appendix A. Short list of project folders

./Camera/Camera.dsp
./CameraDll/CameraDll.dsp
./CameraDll/CameraDllDialogs/CameraDllDialogs.dsp
./CameraHook/CameraHook.dsp
./CameraUtil/CameraUtil.dsp
./CameraViewer/cameraviewer.dsp
./CFiltLib/cfl/CFiltLib.dsp
./CxImage/CxImage.dsp
./DualFiberPciCard/LpmDualFiberPciCardDll/4.40/LpmDualFiberPciCard.dsp
./DualFiberPciCard/LpmDualFiberPciCardDll/6.50/LpmDualFiberPciCard.dsp
./DualFiberPciCard/LpmDualFiberPciCardDll2/4.40/LpmDualFiberPciCard.dsp
./DualFiberPciCard/LpmDualFiberPciCardDll2/6.50/LpmDualFiberPciCard.dsp
./DualFiberPciCard/Vendor/plx-pcisdk/4.40/plx-pcisdk/Win32/Api/PlxApi.dsp
./DualFiberPciCard/Vendor/plx-pcisdk/4.40/plx-pcisdk/Win32/PciDrvApi/PciDrvApi.dsp
./DualFiberPciCard/Vendor/plx-pcisdk/6.50/plx-pcisdk/Windows/PlxApi/PlxApi.dsp
./Graphics/Graphics.dsp
./PythonDLL/...
./Stingray/...
./Utils/UltimateGrid/...