org.bytedeco.javacpp

Class opencv_core.Stream

java.lang.Object

org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.opencv_core.Stream

All Implemented Interfaces:

AutoCloseable

Enclosing class:

opencv_core

@Namespace(value="cv::cuda")
 @NoOffset
public static class opencv_core.Stream
extends org.bytedeco.javacpp.Pointer

\brief This class encapsulates a queue of asynchronous calls.

\note Currently, you may face problems if an operation is enqueued twice with different data. Some functions use the constant GPU memory, and next call may update the memory before the previous one has been finished. But calling different operations asynchronously is safe because each operation has its own constant buffer. Memory copy/upload/download/set operations to the buffers you hold are also safe.

\note The Stream class is not thread-safe. Please use different Stream objects for different CPU threads.

void thread1()
{
    cv::cuda::Stream stream1;
    cv::cuda::func1(..., stream1);
}

void thread2()
{
    cv::cuda::Stream stream2;
    cv::cuda::func2(..., stream2);
}

\note By default all CUDA routines are launched in Stream::Null() object, if the stream is not specified by user. In multi-threading environment the stream objects must be passed explicitly (see previous note).

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	opencv_core.Stream.Impl returns true if stream object is not default (!= 0)
static class	opencv_core.Stream.StreamCallback

Nested classes/interfaces inherited from class org.bytedeco.javacpp.Pointer

org.bytedeco.javacpp.Pointer.CustomDeallocator, org.bytedeco.javacpp.Pointer.Deallocator, org.bytedeco.javacpp.Pointer.NativeDeallocator

Field Summary

Fields inherited from class org.bytedeco.javacpp.Pointer

address, capacity, limit, position

Constructor Summary

Constructors

Constructor and Description
Stream() creates a new asynchronous stream
Stream(long size) Native array allocator.
Stream(opencv_core.GpuMat.Allocator allocator) creates a new asynchronous stream with custom allocator
Stream(org.bytedeco.javacpp.Pointer p) Pointer cast constructor.

Method Summary

Modifier and Type	Method and Description
void	enqueueHostCallback(opencv_core.Stream.StreamCallback callback, org.bytedeco.javacpp.Pointer userData) \brief Adds a callback to be called on the host after all currently enqueued items in the stream have completed.
static opencv_core.Stream	Null() return Stream object for default CUDA stream
opencv_core.Stream	position(long position)
boolean	queryIfComplete() \brief Returns true if the current stream queue is finished.
void	waitEvent(opencv_core.Event event) \brief Makes a compute stream wait on an event.
void	waitForCompletion() \brief Blocks the current CPU thread until all operations in the stream are complete.

Methods inherited from class org.bytedeco.javacpp.Pointer

address, asBuffer, asByteBuffer, availablePhysicalBytes, calloc, capacity, capacity, close, deallocate, deallocate, deallocateReferences, deallocator, deallocator, equals, fill, formatBytes, free, hashCode, isNull, limit, limit, malloc, maxBytes, maxPhysicalBytes, memchr, memcmp, memcpy, memmove, memset, offsetof, parseBytes, physicalBytes, position, put, realloc, setNull, sizeof, toString, totalBytes, totalPhysicalBytes, withDeallocator, zero

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

Stream

public Stream(org.bytedeco.javacpp.Pointer p)

Pointer cast constructor. Invokes Pointer.Pointer(Pointer).

Stream

public Stream(long size)

Native array allocator. Access with Pointer.position(long).

Stream

public Stream()

creates a new asynchronous stream

Stream

public Stream(@opencv_core.Ptr
              opencv_core.GpuMat.Allocator allocator)

creates a new asynchronous stream with custom allocator

Method Detail

position

public opencv_core.Stream position(long position)

Overrides:

position in class org.bytedeco.javacpp.Pointer

queryIfComplete

@Cast(value="bool")
public boolean queryIfComplete()

\brief Returns true if the current stream queue is finished. Otherwise, it returns false.

waitForCompletion

public void waitForCompletion()

\brief Blocks the current CPU thread until all operations in the stream are complete.

waitEvent

public void waitEvent(@Const @ByRef
                      opencv_core.Event event)

\brief Makes a compute stream wait on an event.

enqueueHostCallback

public void enqueueHostCallback(opencv_core.Stream.StreamCallback callback,
                                org.bytedeco.javacpp.Pointer userData)

\brief Adds a callback to be called on the host after all currently enqueued items in the stream have completed.

\note Callbacks must not make any CUDA API calls. Callbacks must not perform any synchronization that may depend on outstanding device work or other callbacks that are not mandated to run earlier. Callbacks without a mandated order (in independent streams) execute in undefined order and may be serialized.

Null

@ByRef
public static opencv_core.Stream Null()

return Stream object for default CUDA stream