User`s guide

mxGPUCreateFromMxArray (C)

11-185

mxGPUCreateFromMxArray (C)

Create read-only mxGPUArray object from input mxArray

C Syntax

#include "gpu/mxGPUArray.h"

mxGPUArray const * mxGPUCreateFromMxArray(mxArray const * const mp)

Arguments

Pointer to an mxArray that contains either GPU or CPU data.

Returns

Pointer to a read-only mxGPUArray object.

Description

mxGPUCreateFromMxArray produces a read-only mxGPUArray object from an mxArray.

• If the input mxArray contains a gpuArray, this function extracts a reference to the

GPU data from an mxArray passed as an input to the function.

• If the input mxArray contains CPU data, the data is copied to the GPU, but the

returned object is still read-only.

If you need a writable copy of the array, use mxGPUCopyFromMxArray instead.

This function allocates a new mxGPUArray object on the CPU. Use

mxGPUDestroyGPUArray to delete the result when you are done with it.