"Connect, Set, Decode!"
~~~~~~~~~~~~~~~~~~~~~~~

In the following section, we present a small sample program ("Connect, Set, Decode!"). This sample demonstrates how the :term:`CameraSDK` and the ImageSDK can be utilized in relation to each other, when connecting to a camera, setting properties, capturing an image and decoding the image.

The application code takes the following actions:

1. Connects through USB to a camera (to utilize the :term:`CameraSDK`, at least one camera must be connected to the :term:`Host computer`).
   1. If multiple cameras are connected, the application picks any of the connected cameras, if none are specified.
2. Set-up of 3 properties: "ISO", "Aperture" and "Shutter-time" (see :ref:`camera-getting-setting-label`).
3. Enable image receiving (see :ref:`camera-receive-images-label`).
4. Capture an image (see :ref:`camera-trigger-capture-label`).
5. Receive the images in-memory (RAM) on the :term:`Host computer`.
6. Use the ImageSDK’s *Decode* pipeline to decode the image into uncompressed Bayer sensor data (see :ref:`image-decode-pipeline-label`).
7. Use the ImageSDK’s *Convert* pipeline to scale the image to a width of 1024px, and convert it into an RGB image (see :ref:`image-convert-pipeline-label`).
8. Save the converted image to a file.

.. TODO: The full code of the sample application is provided in section 11.1.1, in C++. In section 0 parts of the code is explained in greater detail.

Full Source code
^^^^^^^^^^^^^^^^

.. code-tabs::

    .. include-tab:: ../../labels/cppDocumentaionExample1
        :language: cpp
        :title: C++

    .. include-tab:: ../../labels/csDocumentaionExample1
        :language: csharp
        :title: C#

Setting Properties Explanation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

When setting properties, both the type and value of the property should be assigned (see :ref:`camera-getting-setting-label`).

.. To determine the specific property’s type, refer to Appendix H.

.. code-tabs::
    .. include-tab:: ../../labels/cppSetupProperties2
        :language: cpp
        :title: C++

    .. include-tab:: ../../labels/csSetupProperties2
        :language: csharp
        :title: C#

Alternatively, use the *conversion operators* to assign the properties. This can be seen in the following example, where the type is assigned:

.. code-tabs::
    .. include-tab:: ../../labels/cppSetupProperties3
        :language: cpp
        :title: C++

    .. include-tab:: ../../labels/csSetupProperties3
        :language: csharp
        :title: C#

In C#, typecasting for *aperture* and *shutter time* is not strictly necessary in the above example, as 5.0 and 0.125 are already doubles. However, 200 need it, because it will be interpreted as an integer.