### Overview This repository contains the source code for and releases of Carnassial and its associated template editor. Refer to Github's wiki tab above to find out how to get started and learn more about Carnassial.
Bug reports, feature requests, and feedback are most welcome. Let us know! If Carnassial is crashing without putting up an error dialog please use Event Viewer to check for .NET runtime and application errors in Windows Logs -> Application and include that information in the issue.
We'd also really appreciate sample images and videos to test our code on and expand some features. Shoot us an email at carnassialdev@gmail.com if you've some you'd like to share. If you'd like to translate Carnassial into your language it's easy. Send us your edited version of Resources.xaml or drop us a line and we'll set you up.
If you're a developer and would like to submit a pull request please see below.
Carnassial should run on any 64 bit processor with AVX instructions (circal 2011; AMD Bulldozer, Intel Core 2nd gen and newer) but its code design and optimization targets newer processors with four or more cores (currently AMD Ryzen and Intel 6th gen and newer). Display resolutions of 1600 x 900 or higher are recommended for viewing details of camera images and user interface layout.
Known limitations:
Known limitations with earlier versions of Windows:
Carnassial is named for carnassials as its function is analogous (though unfortunately it lacks the teeth's self-sharpening properties).
Carnassial began as a substantial overhaul of Timelapse 2.0 for improved code quality and sufficient flexibility to accommodate typical carnivore studies. Timelapse 2.1 includes several months of initial Carnassial coding effort but is now diverged.
The need to analyze remote camera data is a common one. In addition to Carnassial and Timelapse we're aware of CPW Photo Warehouse and eMammal. As of March 2021, key differences are
mutate() statement to implement in R.If you know of other analysis tools please let us know.
Feel free to open new issues on Carnassial here on GitHub. Or email us at carnassialdev@gmail.com.
Install Visual Studio 2022 Community or newer with the C# and C++ desktop workloads (other Visual Studio SKUs such as Enterprise are fine). After Visual Studio installation:
Commits should
Application and test development is done against .NET 8. Carnassial is a 64 bit app and for the most part only an x64 build is needed for development and testing. However, the Visual Studio development UI is a 32 bit app and is therefore unable to load controls from the regular Carnassial build for display in the WPF designer. As a result, Carnassial has a vestigial x86 build which needs to be selected when doing UI tasks if the view in the designer is to match what's displayed at x64 runtime. (Building Carnassial as AnyCPU in the x64 build isn't an option as StockMessageControl hits call graphs which go into Carnassial.Native, an approach which is anyways undesirable as there's a moderate performance penalty to building AnyCPU rather than x64.)
To build Carnassial's installer, publish both Carnassial and the template editor and then build the installer project. Since the installer picks up published, ready to run binaries the regular release build does not produce a .msi.
Historically, Visual Studio's discovery and honoring of test.runsettings has been unreliable, requiring manual selection of x64 test execution. In such situations VS can fail to find any unit tests until restarted, though setting x64 and forcing a build typically resulted in test discovery. This appears to be less commonly an issue in Visual Studio 2018 and newer.
Carnassial is not currently MVVM. In general, greater use of MVVM would be beneficial but current UX development effort is primarily directed to model-view adoption in order to enable refactoring to view models. Carnassial uses WPF resource dictionaries for localization as the approach is lighter weight and more flexible than .resx files or locbaml type methods. Culture specific resources are merged in Carnassial\LocalizedApplication.cs
Also helpful are
A nuget package for libjpeg-turbo exists but is not being maintained so the library is comitted to the Carnassial repro. To update, download the libjpeg-turbo VC and VC64 installers, copy the updated bits from %SYSTEMDRIVE%\libjpeg-turbox64{bin, include, lib} and %SYSTEMDRIVE%\libjpeg-turbo\lib to Native\libjpeg-turbo{bin, include, lib}, and update the additional dependencies in Native.vcxproj's Win32 and x64 linker settings to point to the new .libs. Either a rebuild or code changes within Carnassial.Native are required for Visual Studio to copy the updated turbojpeg.dll to the build output.
Carnassial needs MFC only for the version header of Carnassial.Native.dll. Another detail, as of Visual Studio 2019, is app.rc must be Unicode as Microsoft's resource compiler does not support UTF-8. This is incompatible with git differencing's lack of Unicode support and is undesirable with respect to the de facto convention of using UTF-8 for source files.