.. _subscriptions:

Subscriptions
=============

.. note::
    CameraSDK 3.0 introduces the concept of *subscriptions*. Subscriptions now handles two of the central functions, that was previously ungrouped: *image receiving* and *LiveView*.

    See: :ref:`3_0_migration_guide-label`

Some actions in the camera will generate a large amount of data, like capturing an image. You might not always have interest in the data from such events. Subscriptions lets you subscribe to such data heavy events.

These events (including the data) is pushed to you, so you do not need to request them manually first. The camera will push the data, as soon as it becomes available. Data that is subscribed to will be delivered to the SDK using regular :ref:`camera-notifications-label`.

For each kind of data subscription, there might be a set of related *options*. These *options* acts as arguments, that define specific preferences about the data subscription.

The next sections will take you though the available subscriptions.

..  toctree::
    :maxdepth: 1

    subs-full-image.rst
    subs-preview.rst
    subs-live-view.rst