Creating Buffer Variables

Developer Guide for Intel® SDK for OpenCL™ Applications 2017

Download PDF

ID 773042

Date 10/22/2018

Version

Public

A newer version of this document is available. Customers should click here to go to the newest version.

Visible to Intel only — GUID: GUID-2B688A12-5372-481F-9E41-2832D6BBA96E

To create a new buffer variable:

Open the variable management pane. Go to Tools > Intel Code Builder for OpenCL API > OpenCL Kernel Development > Windows > Variable Management
Click the Add button in the Code Builder Variable Management pane to open and select Buffer. The Buffer Variable dialog box opens.
Fill out the dialog box entries:

Field	Options
Name	Enter a meaningful name or leave the default.
IO Mode	Use the drop-down to select Input, Output, or InOut.
Number of Elements	Enter the number of elements or leave the default value of 1.
Memory flags to use	Use the drop-down to select a memory flag, or leave the default `CL_MEM_USE_HOST_PTR`
Use as SVM	Check to use the buffer as an SVM on systems that support SVM.
Initialization options	For Input, or InOut IO Mode, you need to set an initialization option. To select an input `.csv` or binary file as the initialization option, click the browse (...) button. When using .cvs files, each line represents one OpenCL data type (like int4, float16, and so on), with a value in each column to satisfy the type size. For example, for a long8, at least eight columns of long numbers should exist in each line. The size of the buffer is used as the number of lines to read from CSV. The .cvs file may hold more columns or lines than needed for a specific buffer, but not fewer. When using binary files, the content should be a concatenation of the OpenCL data type, and as with using .cvs files, the file may hold more data than indicated by the Size argument. You can also select Use random values or Zero the entire buffer.

NOTE:

Output buffers do not need a value assigned to them. If a value is assigned, it is ignored.