220 lines
5.7 KiB
ReStructuredText
220 lines
5.7 KiB
ReStructuredText
Initalization and Information
|
|
=============================
|
|
|
|
.. highlight:: cpp
|
|
|
|
|
|
|
|
gpu::getCudaEnabledDeviceCount
|
|
------------------------------
|
|
Returns the number of installed CUDA-enabled devices.
|
|
|
|
.. ocv:function:: int gpu::getCudaEnabledDeviceCount()
|
|
|
|
Use this function before any other GPU functions calls. If OpenCV is compiled without GPU support, this function returns 0.
|
|
|
|
|
|
|
|
gpu::setDevice
|
|
--------------
|
|
Sets a device and initializes it for the current thread.
|
|
|
|
.. ocv:function:: void gpu::setDevice(int device)
|
|
|
|
:param device: System index of a GPU device starting with 0.
|
|
|
|
If the call of this function is omitted, a default device is initialized at the fist GPU usage.
|
|
|
|
|
|
|
|
gpu::getDevice
|
|
--------------
|
|
Returns the current device index set by :ocv:func:`gpu::setDevice` or initialized by default.
|
|
|
|
.. ocv:function:: int gpu::getDevice()
|
|
|
|
|
|
|
|
gpu::resetDevice
|
|
----------------
|
|
Explicitly destroys and cleans up all resources associated with the current device in the current process.
|
|
|
|
.. ocv:function:: void gpu::resetDevice()
|
|
|
|
Any subsequent API call to this device will reinitialize the device.
|
|
|
|
|
|
|
|
gpu::FeatureSet
|
|
---------------
|
|
Enumeration providing GPU computing features.
|
|
|
|
.. ocv:enum:: gpu::FeatureSet
|
|
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_10
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_11
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_12
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_13
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_20
|
|
.. ocv:emember:: FEATURE_SET_COMPUTE_21
|
|
.. ocv:emember:: GLOBAL_ATOMICS
|
|
.. ocv:emember:: SHARED_ATOMICS
|
|
.. ocv:emember:: NATIVE_DOUBLE
|
|
|
|
|
|
gpu::TargetArchs
|
|
----------------
|
|
.. ocv:class:: gpu::TargetArchs
|
|
|
|
Class providing a set of static methods to check what NVIDIA* card architecture the GPU module was built for.
|
|
|
|
The following method checks whether the module was built with the support of the given feature:
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::builtWith( FeatureSet feature_set )
|
|
|
|
:param feature_set: Features to be checked. See :ocv:enum:`gpu::FeatureSet`.
|
|
|
|
There is a set of methods to check whether the module contains intermediate (PTX) or binary GPU code for the given architecture(s):
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::has(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasPtx(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasBin(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasEqualOrLessPtx(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasEqualOrGreater(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasEqualOrGreaterPtx(int major, int minor)
|
|
|
|
.. ocv:function:: static bool gpu::TargetArchs::hasEqualOrGreaterBin(int major, int minor)
|
|
|
|
:param major: Major compute capability version.
|
|
|
|
:param minor: Minor compute capability version.
|
|
|
|
According to the CUDA C Programming Guide Version 3.2: "PTX code produced for some specific compute capability can always be compiled to binary code of greater or equal compute capability".
|
|
|
|
|
|
|
|
gpu::DeviceInfo
|
|
---------------
|
|
.. ocv:class:: gpu::DeviceInfo
|
|
|
|
Class providing functionality for querying the specified GPU properties. ::
|
|
|
|
class CV_EXPORTS DeviceInfo
|
|
{
|
|
public:
|
|
DeviceInfo();
|
|
DeviceInfo(int device_id);
|
|
|
|
string name() const;
|
|
|
|
int majorVersion() const;
|
|
int minorVersion() const;
|
|
|
|
int multiProcessorCount() const;
|
|
|
|
size_t freeMemory() const;
|
|
size_t totalMemory() const;
|
|
|
|
bool supports(FeatureSet feature) const;
|
|
bool isCompatible() const;
|
|
|
|
int deviceID() const;
|
|
};
|
|
|
|
|
|
|
|
gpu::DeviceInfo::DeviceInfo
|
|
---------------------------
|
|
The constructors.
|
|
|
|
.. ocv:function:: gpu::DeviceInfo::DeviceInfo()
|
|
|
|
.. ocv:function:: gpu::DeviceInfo::DeviceInfo(int device_id)
|
|
|
|
:param device_id: System index of the GPU device starting with 0.
|
|
|
|
Constructs the ``DeviceInfo`` object for the specified device. If ``device_id`` parameter is missed, it constructs an object for the current device.
|
|
|
|
|
|
|
|
gpu::DeviceInfo::name
|
|
---------------------
|
|
Returns the device name.
|
|
|
|
.. ocv:function:: string gpu::DeviceInfo::name() const
|
|
|
|
|
|
|
|
gpu::DeviceInfo::majorVersion
|
|
-----------------------------
|
|
Returns the major compute capability version.
|
|
|
|
.. ocv:function:: int gpu::DeviceInfo::majorVersion()
|
|
|
|
|
|
|
|
gpu::DeviceInfo::minorVersion
|
|
-----------------------------
|
|
Returns the minor compute capability version.
|
|
|
|
.. ocv:function:: int gpu::DeviceInfo::minorVersion()
|
|
|
|
|
|
|
|
gpu::DeviceInfo::multiProcessorCount
|
|
------------------------------------
|
|
Returns the number of streaming multiprocessors.
|
|
|
|
.. ocv:function:: int gpu::DeviceInfo::multiProcessorCount()
|
|
|
|
|
|
|
|
gpu::DeviceInfo::freeMemory
|
|
---------------------------
|
|
Returns the amount of free memory in bytes.
|
|
|
|
.. ocv:function:: size_t gpu::DeviceInfo::freeMemory()
|
|
|
|
|
|
|
|
gpu::DeviceInfo::totalMemory
|
|
----------------------------
|
|
Returns the amount of total memory in bytes.
|
|
|
|
.. ocv:function:: size_t gpu::DeviceInfo::totalMemory()
|
|
|
|
|
|
|
|
gpu::DeviceInfo::supports
|
|
-------------------------
|
|
Provides information on GPU feature support.
|
|
|
|
.. ocv:function:: bool gpu::DeviceInfo::supports( FeatureSet feature_set ) const
|
|
|
|
:param feature_set: Features to be checked. See :ocv:enum:`gpu::FeatureSet`.
|
|
|
|
This function returns ``true`` if the device has the specified GPU feature. Otherwise, it returns ``false`` .
|
|
|
|
|
|
|
|
gpu::DeviceInfo::isCompatible
|
|
-----------------------------
|
|
Checks the GPU module and device compatibility.
|
|
|
|
.. ocv:function:: bool gpu::DeviceInfo::isCompatible()
|
|
|
|
This function returns ``true`` if the GPU module can be run on the specified device. Otherwise, it returns ``false`` .
|
|
|
|
|
|
|
|
gpu::DeviceInfo::deviceID
|
|
-------------------------
|
|
Returns system index of the GPU device starting with 0.
|
|
|
|
.. ocv:function:: int gpu::DeviceInfo::deviceID()
|