/*============================================================================= Copyright (C) 2012 Allied Vision Technologies. All Rights Reserved. Redistribution of this file, in original or modified form, without prior written consent of Allied Vision Technologies is prohibited. ------------------------------------------------------------------------------- File: program.cpp Description: Main entry point of BandwidthHelper example of VimbaCPP. ------------------------------------------------------------------------------- THIS SOFTWARE IS PROVIDED BY THE AUTHOR "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF TITLE, NON-INFRINGEMENT, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. =============================================================================*/ #include #include #include #include #include #include #include "BandwidthHelper.h" #include "Common/StreamSystemInfo.h" enum SettingsMode { SettingsModeUnknown = 0, SettingsModeGet = 1, SettingsModeSet = 2, SettingsModeGetMin = 3, SettingsModeGetMax = 4 }; bool StartsWith( const char *pString, const char *pStart ) { if( NULL == pString ) { return false; } if( NULL == pStart ) { return false; } if( std::strlen( pString ) < std::strlen( pStart ) ) { return false; } if( std::memcmp( pString, pStart, std::strlen( pStart ) ) != 0 ) { return false; } return true; } int main( int argc, char* argv[] ) { std::string cameraID, cameraName; VmbInterfaceType cameraInterfaceType; double fValue; SettingsMode settingsMode = SettingsModeUnknown; bool printHelp = false; std::cout << "\n"; std::cout << "//////////////////////////////////////////\n"; std::cout << "/// Vimba API Bandwidth Helper Example ///\n"; std::cout << "//////////////////////////////////////////\n"; std::cout << std::endl; VmbErrorType err = VmbErrorSuccess; ////////////////////// //Parse command line// ////////////////////// if( 4 < argc ) { err = VmbErrorBadParameter; printHelp = true; } else { for( int i=1; i= std::strlen( pParameter ) ) { err = VmbErrorBadParameter; break; } if( pParameter[0] == '/' ) { // Get bandwidth usage if( 0 == std::strcmp( pParameter, "/g" ) ) { if( SettingsModeUnknown != settingsMode ) { err = VmbErrorBadParameter; break; } settingsMode = SettingsModeGet; } // Set bandwidth usage else if( true == StartsWith( pParameter, "/s:" ) ) { if( SettingsModeUnknown != settingsMode ) { err = VmbErrorBadParameter; break; } settingsMode = SettingsModeSet; std::string strVal = pParameter + 3; if( 0 >= strVal.size() ) { err = VmbErrorBadParameter; break; } fValue = atof( strVal.c_str() ) / 100; } else if( 0 == std::strcmp( pParameter, "/h" ) ) { if( true == printHelp ) { err = VmbErrorBadParameter; break; } printHelp = true; } // Get min bandwidth usage else if( 0 == std::strcmp( pParameter, "/min" ) ) { if( SettingsModeUnknown != settingsMode ) { err = VmbErrorBadParameter; break; } settingsMode = SettingsModeGetMin; } // Get max bandwidth usage else if( 0 == std::strcmp( pParameter, "/max" ) ) { if( SettingsModeUnknown != settingsMode ) { err = VmbErrorBadParameter; break; } settingsMode = SettingsModeGetMax; } else { err = VmbErrorBadParameter; break; } } else { if( false == cameraID.empty() ) { err = VmbErrorBadParameter; break; } cameraID = pParameter; } } } // Write out an error if we could not parse the command line if( VmbErrorBadParameter == err ) { std::cout << "Invalid parameter found.\n\n"; printHelp = true; } // Print out help if( true == printHelp ) { std::cout << "Gets or sets the current bandwidth as percentage of the theoretically possible bandwidth.\n\n"; std::cout << "Usage: BandwidthHelper [CameraID] [/h] [/{g|s:val|min|max}]\n"; std::cout << "Parameters: CameraID ID of the camera to use (using first camera if not specified)\n"; std::cout << " /h Print out help\n"; std::cout << " /g Get bandwidth usage (default if not specified)\n"; std::cout << " /s:val Set bandwidth usage to % of the maximum bandwidth\n"; std::cout << " /min Get minimal possible bandwidth usage\n"; std::cout << " /max Get maximal possible bandwidth usage\n\n"; return err; } if( VmbErrorSuccess == err ) { // Get a reference to the VimbaSystem singleton AVT::VmbAPI::VimbaSystem &rVimbaSystem = AVT::VmbAPI::VimbaSystem::GetInstance(); // Print out version of Vimba std::cout << "Vimba C++ API Version " << rVimbaSystem << "\n"; // Startup API err = rVimbaSystem.Startup(); if( VmbErrorSuccess != err ) { std::cout << "Could not start system. Error code: " << err <<"\n"; } else { AVT::VmbAPI::CameraPtr pCamera; // Open first available camera if( cameraID.empty() ) { // Fetch all cameras known to Vimba AVT::VmbAPI::CameraPtrVector cameras; err = rVimbaSystem.GetCameras( cameras ); if( VmbErrorSuccess == err ) { if( !cameras.empty() ) { for( AVT::VmbAPI::CameraPtrVector::const_iterator iter = cameras.begin(); cameras.end() != iter; ++iter ) { // Check if we can open the camera in full mode VmbAccessModeType accessMode = VmbAccessModeNone; err = (*iter)->GetPermittedAccess( accessMode ); if( VmbErrorSuccess == err ) { if( VmbAccessModeFull & accessMode ) { // Now get the camera ID err = ( *iter )->GetID( cameraID ); if( VmbErrorSuccess == err ) { // Try to open the camera err = ( *iter )->Open( VmbAccessModeFull ); if( VmbErrorSuccess == err ) { pCamera = *iter; // Get camera name and interface type if( VmbErrorSuccess == pCamera->GetName( cameraName ) && VmbErrorSuccess == pCamera->GetInterfaceType( cameraInterfaceType ) ) { std::cout << "Successfully opened " << AVT::VmbAPI::Examples::BandwidthHelper::InterfaceToString( cameraInterfaceType ) << " camera " << cameraName << " (" << cameraID << ")\n" ; } else { std::cout << "Successfully opened camera " << "(" << cameraID << ")\n"; } break; } } } } } if( NULL == pCamera ) { std::cout << "Could not open any camera.\n"; err = VmbErrorNotFound; } } else { std::cout << "No camera available.\n"; err = VmbErrorNotFound; } } else { std::cout << "Could not list cameras. Error code: " << err << std::endl; } } else { // Open specific camera err = rVimbaSystem.OpenCameraByID( cameraID.c_str(), VmbAccessModeFull, pCamera ); if( VmbErrorSuccess != err ) { std::cout << "Could not open camera. Error code: " << err <<"\n"; } } if( VmbErrorSuccess == err ) { switch( settingsMode ) { default: case SettingsModeGet: { // Get bandwidth err = AVT::VmbAPI::Examples::BandwidthHelper::GetBandwidthUsage( pCamera, fValue ); if ( VmbErrorWrongType == err ) { std::cout << "The bandwidth cannot be controlled for this interface type.\n"; } else if ( VmbErrorSuccess != err ) { std::cout << "Could not get bandwidth usage. Error code: " << err <<"\n"; } else { std::cout << "Bandwidth usage: " << fValue * 100 << "%\n"; } } break; case SettingsModeSet: { // Set bandwidth err = AVT::VmbAPI::Examples::BandwidthHelper::SetBandwidthUsage( pCamera, fValue ); if ( VmbErrorWrongType == err ) { std::cout << "The bandwidth cannot be controlled for this interface type.\n"; } else { if ( VmbErrorSuccess == err ) { // Read back written value err = AVT::VmbAPI::Examples::BandwidthHelper::GetBandwidthUsage( pCamera, fValue ); if ( VmbErrorSuccess == err ) { std::cout << "Bandwidth usage successfully set to: " << fValue * 100 << "%\n"; } } if ( VmbErrorSuccess != err ) { std::cout << "Could not set bandwidth usage. Error code: " << err <<"\n"; } } } break; case SettingsModeGetMin: { // Get bandwidth err = AVT::VmbAPI::Examples::BandwidthHelper::GetMinPossibleBandwidthUsage( pCamera, fValue ); if ( VmbErrorWrongType == err ) { std::cout << "The bandwidth cannot be controlled for this interface type.\n"; } else if( VmbErrorSuccess != err ) { std::cout << "Could not get minimal possible bandwidth usage. Error code: " << err <<"\n"; } else { std::cout << "Minimal possible bandwidth usage: " << fValue * 100 << "%\n"; } } break; case SettingsModeGetMax: { // Get bandwidth err = AVT::VmbAPI::Examples::BandwidthHelper::GetMaxPossibleBandwidthUsage( pCamera, fValue ); if ( VmbErrorWrongType == err ) { std::cout << "The bandwidth cannot be controlled for this interface type.\n"; } else if ( VmbErrorSuccess != err ) { std::cout << "Could not get maximal possible bandwidth usage. Error code: " << err <<"\n"; } else { std::cout << "Maximal possible bandwidth usage: " << fValue * 100 << "%\n"; } } break; } // Close camera err = pCamera->Close(); } // Shutdown API rVimbaSystem.Shutdown(); } return err; } }