Gentec-EO BEAMAGE Series User Manual

Gentec-EO BEAMAGE Series User Manual

Software development kit, sdk
Hide thumbs Also See for BEAMAGE Series:

Advertisement

Quick Links

121-105627

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the BEAMAGE Series and is the answer not in the manual?

Questions and answers

Summary of Contents for Gentec-EO BEAMAGE Series

  • Page 1 121-105627...
  • Page 2 Gentec-EO agent. Gentec-EO Inc. assumes no risk for damage during transit. Gentec-EO Inc. will, at its discretion, repair or replace the defective product free of charge or refund your purchase price. However, if Gentec-EO Inc. determines that the failure is caused by misuse, alterations, accident, or improper conditions of operation or handling, the product shall therefore not be covered by the warranty.
  • Page 3: Table Of Contents

    Beamage SDK User Manual Revision 1 TABLE OF CONTENTS GENTEC-EO’S BEAMAGE SDK .......................... 5 1.1. SDK ? ..........................5 HAT IS THE EAMAGE 1.2. .NET ..................7 COMPATIBLE PIPELINE FOR EAMAGE CAMERAS 1.3. SDK ......................7 ETTING STARTED WITH THE EAMAGE 1.4.
  • Page 4 Beamage SDK User Manual Revision 1 ABLE OF IGURES 1 – C ....... 5 IGURE ONCEPTUAL EXAMPLE OF EAMAGE INTEGRATION ON AN ASSEMBLY LINE 2 – A -EO’ SDK ........6 IGURE NEW WAY TO USE ENTEC EAMAGE CAMERA EAMAGE 3 - F .NET ......
  • Page 5: Gentec-Eo's Beamage Sdk

    Figure 1 – Conceptual example of Beamage SDK integration on an assembly line Gentec-EO’s Beamage SDK is a dll (Dynamic Link Library) that communicates with the camera drivers. It provides our customers with specific software functions to control the Beamage camera and retrieve images from it, in order to build custom Windows applications.
  • Page 6: Figure 2 - Anew Way To Use

    Beamage SDK User Manual Revision 1 Beamage camera Camera drivers Gentec-EO's Beamage SDK PC-Beamage software Microsoft .NET compatible software PC-Beamage user interface - Integration - Custom user interface Figure 2 – A new way to use Gentec-EO’s Beamage camera: the Beamage SDK...
  • Page 7: The .Net Compatible Pipeline For Beamage Cameras

    1.2. The .NET compatible pipeline for Beamage cameras Gentec-EO’s Beamage SDK offers basic functions and no calculation on diameter for now. If you would like your custom Windows application to include the powerful advanced functions available in Gentec-EO’s PC-Beamage software, the .NET compatible pipeline will be of great use to you.
  • Page 8: Beamage Sdk User Manual Revision 1

    Beamage SDK (BSDK). Gentec-EO also provides a Beamage SDK Samples solution for Visual Studio. This example shows how to create a Beamage camera object, connect to it, grab images, and how to use many other of the Beamage...
  • Page 9: What Your Visual Studio Solution Needs

    1.4. What your Visual Studio solution needs To create your first software application with Beamage SDK, launch Visual Studio and create a new project. Then, download the Gentec-EO Beamage SDK.zip from our Download Center to your computer and extract all files. Find the BeamageSDK.dll file and add it as a reference to your Visual Studio project.
  • Page 10 Beamage SDK User Manual Revision 1 pictureBox1.Size = size; labelBeamage.Text = "Beamage-4M"; else Size size = new Size(512, 272); pictureBox1.Size = size; labelBeamage.Text = "Beamage-3.0"; That’s it! Once the BSDK object is created, all other functions in the Beamage SDK will be available. For more code samples and to see how to use all functions, please refer to the...
  • Page 11 Beamage SDK User Manual Revision 1 started example section or the Table of Content.
  • Page 12: Beamage Sdk Class Diagram

    Beamage SDK User Manual Revision 1 1.6. Beamage SDK Class Diagram The Beamage SDK has been designed to be as simple as possible, for a fast, headache-free experience. All object classes that are part of the Beamage SDK begin with the letter B (for Beamage). The main object of the Beamage SDK is BSDK.
  • Page 13: Get Started Example

    Beamage SDK User Manual Revision 1 2. Get started example Two examples have been coded to help you get started with the Beamage SDK. The first one is written in C# and helps you understand how to connect a camera and view images in your application. The second example is a C++ console application that will show you how to make mathematical calculations on camera images.
  • Page 14: Grab Images

    Beamage SDK User Manual Revision 1 Figure 8 - Beamage SDK Simple Viewer user interface when a Beamage-3.0 is connected The Auto Connect button will open the camera drivers, detect all Beamage cameras plugged into the computer, and then connect to the first detected camera. The application will adapt the pictureBox size depending on the current Beamage camera model.
  • Page 15: Mathematical Operations On The Image Buffer

    Beamage SDK User Manual Revision 1 Code Sample private void buttonRun_Click(object sender, EventArgs // Assign an event when a new image is captured by the camera bsdk.camera.NewImageEvent EventHandler(newImage); // Start streaming a camera bsdk.camera.Run(); // Here a simple thread that will update a BMP image into a picture box // For demonstration purposes // No optimization for CPU, GPU, or memory has been made capture...
  • Page 16: Events

    Beamage SDK User Manual Revision 1 image = bsdk.camera.camImg.GetLastImageArray(); width = bsdk.camera.camImg.width; height = bsdk.camera.camImg.height; double pixelSum = 0.0; for (int = 0; < height; i++) for(int = 0; < width; j++) pixelSum image[i height + j]; // Make an average pixelSum (width * height);...
  • Page 17: Beamage Api

    Beamage SDK User Manual Revision 1 3. Beamage API This section provides a description of each of the classes and functions included in the Beamage SDK. Code samples are included. 3.1. BCam Bcam is the Beamage SDK’s camera class. Included are basic functions to interact with the Beamage camera.
  • Page 18: Properties

    Beamage SDK User Manual Revision 1 Code sample bsdk.camera.BackgroundIsReadyEvent EventHandler(backgroundIsReady); private void backgroundIsReady(object sender, EventArgs MessageBox.Show(“Background is Ready”); bsdk.camera.BackgroundIsReadyEvent EventHandler(backgroundIsReady); Functions void Dispose() Bcam class is derived from Idisposable and needs a Dispose function. void GrabOneFrame() Grabs only one image. void Run() Starts capturing images from the Beamage camera.
  • Page 19: Events

    Beamage SDK User Manual Revision 1 Events Functions int[] GetLastImageArray() Return a raw buffer of the last image. This is a one-dimension array. The elements in the array are ordered in the following way: they begin in the top left corner of the image, progress in a left-to-right and then top- to-bottom fashion and finish in the bottom right corner.
  • Page 20: Functions

    Beamage SDK User Manual Revision 1 3.3. BCamProperties BCamProperties are the internal properties of the Beamage camera. Contrary to the BCamSettings class, methods properties BCamProperties class are read-only. Class declaration Properties Events Functions bool Is4mSensor() This function returns True if the Beamage camera is a Beamage-4M model and False if the Beamage camera is a Beamage-3.0 model.
  • Page 21: Bsdk

    Beamage SDK User Manual Revision 1 3.5. BSDK BSDK is the main class of the Beamage SDK. See the Understanding the code section for more information. Class declaration BSDK() Main class of objects in the Beamage SDK. Properties BCam camera Return BCam object for the connected camera.
  • Page 22: Future Classes And Functions

    Beamage SDK User Manual Revision 1 3.6. Future classes and functions The following features are currently under development: Classes Functions BCamImages BCamSettings BErrorsManager Count() void Clear()
  • Page 23 Beamage SDK User Manual Revision 1...

This manual is also suitable for:

Beamage usb 3.0 4mBeamage usb 3.0

Table of Contents