Struct ocl::builders::ProgramBuilder

pub struct ProgramBuilder { /* fields omitted */ }

A builder for Program.

Methods

impl ProgramBuilder

fn new() -> ProgramBuilder

Returns a new, empty, build configuration object.

fn build(&self, context: &Context) -> OclResult<Program>

Returns a newly built Program.

[TODO]: If the context is associated with more than one device, check that at least one of those devices has been specified. An empty device list will cause an OpenCL error in that case.

[TODO]: Check for duplicate devices in the final device list.

fn cmplr_def<S: Into<String>>(self, name: S, val: i32) -> ProgramBuilder

Adds a build option containing a compiler command line definition. Formatted as -D {name}={val}.

Example

...cmplr_def("MAX_ITERS", 500)...

fn cmplr_opt<S: Into<String>>(self, co: S) -> ProgramBuilder

Adds a build option containing a raw compiler command line parameter. Formatted as {} (exact text).

Example

...cmplr_opt("-g")...

fn bo(self, bo: BuildOpt) -> ProgramBuilder

Pushes pre-created build option to the list of options.

fn src_file<P: Into<PathBuf>>(self, file_path: P) -> ProgramBuilder

Adds the contents of a file to the program.

fn src<S: Into<String>>(self, src: S) -> ProgramBuilder

Adds raw text to the program source.

fn devices<D: Into<DeviceSpecifier>>(self, device_spec: D) -> ProgramBuilder

Specify a list of devices to build this program on. The devices must also be associated with the context passed to ::build later on.

[FIXME]: Include DeviceSpecifier usage instructions.

Panics

Devices may not have already been specified.

fn get_device_spec(&self) -> &Option<DeviceSpecifier>

Returns the devices specified to be associated the program.

fn get_compiler_options(&self) -> OclResult<CString>

Returns a contatenated string of command line options to be passed to the compiler when building this program.

fn get_src_strings(&self) -> OclResult<Vec<CString>>

Returns the final program source code as a list of strings.

Order of Inclusion

1. Macro definitions and code strings specified by a BuildOpt::IncludeDefine or BuildOpt::IncludeRaw via ::bo
2. Contents of files specified via ::src_file
3. Contents of strings specified via ::src or a BuildOpt::IncludeRawEof via ::bo

Trait Implementations

impl Clone for ProgramBuilder

fn clone(&self) -> ProgramBuilder

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ProgramBuilder

fn fmt(&self, __arg_0: &mut Formatter) -> Result

Formats the value using the given formatter.