# Releases

## Version 0.10.0 (2024-03-31)

### Bug fixes

Use `opencl-sys` version 0.3 and fix [Clippy Lints](https://rust-lang.github.io/rust-clippy/master/index.html) issues.

## Version 0.9.5 (2023-12-22)

### New Features

* Issue [#32](https://github.com/kenba/cl3/issues/32) Update with new functions in OpenCL-Headers repo.

## Version 0.9.4 (2023-11-05)

### New Features

* Issue [#31](https://github.com/kenba/cl3/issues/31) Update with new functions in OpenCL-Headers repo.

## Version 0.9.3 (2023-11-04)

### Bug fixes

Remove deprecated OpenCL constants: `CL_DEPTH_STENCIL` and `CL_UNORM_INT24`
for compatibility with [opencl-sys](https://crates.io/crates/opencl-sys) crate.

## Version 0.9.2 (2023-07-30)

### New Features

* PR [#30](https://github.com/kenba/cl3/pull/30) Adds `thiserror` crate and derives impls std::error::Error for ClError.

### Bug fixes

* PR [#28](https://github.com/kenba/cl3/pull/28) use `opencl_sys::cl_char`.

## Version 0.9.1 (2022-09-17)

### New Features

* Issue [#27](https://github.com/kenba/cl3/issues/27) Update for extension `cl_khr_command_buffer_mutable_dispatch`.

## Version 0.9.0 (2022-09-10)

### Breaking Changes

* Issue [#25](https://github.com/kenba/cl3/issues/25) Declare OpenCL release_*and retain_* functions unsafe.
* Issue [#26](https://github.com/kenba/cl3/issues/26) Declare OpenCL functions that can lead to undefined behaviour as unsafe.

## Version 0.8.1 (2022-07-23)

### New Features

* Issue [#24](https://github.com/kenba/cl3/issues/24) Update for extension `cl_ext_image_requirements_info`.

## Version 0.8.0 (2022-05-02)

### Breaking Changes

* Issue [#22](https://github.com/kenba/cl3/issues/22) Base `cl3` on [opencl-sys](https://crates.io/crates/opencl-sys) crate.
* Issue [#23](https://github.com/kenba/cl3/issues/23) Put deprecation notices behind conditional attributes.

## Version 0.7.0 (2022-04-10)

### Breaking Changes

* Transition to Rust 2021 Edition.

## Version 0.6.5 (2022-04-09)

### New Features

* Issue [#20](https://github.com/kenba/cl3/issues/20) Add `cl_intel_mem_alloc_buffer_location` property.

### Bug fixes

* Issue [#21](https://github.com/kenba/cl3/issues/21) Empty slice is not null.

## Version 0.6.4 (2021-12-31)

### New Features

* Issue [#19](https://github.com/kenba/cl3/issues/19) Update for extension `cl_arm_protected_memory_allocation`.

* Issue [#18](https://github.com/kenba/cl3/issues/18) Update for extension `cl_intel_unified_shared_memory`.

## Version 0.6.3 (2021-11-20)

### New Features

* Issue [#17](https://github.com/kenba/cl3/issues/17) Update for new OpenCL extension `cl_khr_command_buffer`.

## Version 0.6.2 (2021-11-12)

### New Features

* Issue [#16](https://github.com/kenba/cl3/issues/16) Update for new OpenCL extensions: `cl_khr_external_memory`, `cl_khr_external_semaphore` and `cl_khr_semaphore`.

## Version 0.6.1 (2021-10-17)

### Bug fixes

* Issue [#15](https://github.com/kenba/cl3/issues/15) Don't panic if UUIDs or LUIDs are wrong size.

## Version 0.6.0 (2021-10-15)

### Breaking Changes

* Issue [#13](https://github.com/kenba/cl3/issues/13) Remove Info enums to support new OpenCL versions and extensions.
* Issue [#14](https://github.com/kenba/cl3/issues/14) Add UUID and LUID types to InfoType.

## Version 0.5.1 (2021-10-09)

### New Features

* Add Device Vendor Ids, vendor_id_text and device_type_text functions.
* Add device Uuid and Luid types for UUID and LUIDs.
* Add clinfo example program.

### Bug fixes

* Fix bugs in device tests.

## Version 0.5.0 (2021-10-02)

### Breaking Changes

* Issue [#11](https://github.com/kenba/cl3/issues/11) InfoType::to_string shadows the implementation of Display. Note: the Display::to_string implementation does not remove trailing nulls, see PR [#1](Remove all trailing nulls from OpenCL API info strings).

### New Features

* Issue [#12](https://github.com/kenba/cl3/issues/12) Use From trait for `conversions.

## Version 0.4.4 (2021-09-19)

### New Features

* Return `uints` and `ulongs` for `cl_intel_device_attribute_query` after testing on Intel hardware, for Issue [#10](https://github.com/kenba/cl3/issues/10).

## Version 0.4.3 (2021-09-18)

### New Features

* Issue [#10](https://github.com/kenba/cl3/issues/10) Update for latest OpenCL-Headers: `cl_khr_integer_dot_product` and `cl_intel_device_attribute_query`.
* Fix more `clippy` warnings.
* Add CONTRIBUTING and CODE_OF_CONDUCT documents.

## Version 0.4.2 (2021-08-20)

### Changes

* PR [#9](https://github.com/kenba/cl3/pull/9) Implement CL_VERSION_* features.
* Remove deprecated attribute for `create_command_queue`
* Fix `clippy` warnings and format with `fmt`.

## Version 0.4.1 (2021-08-06)

### Changes

* Add `cl_khr_integer_dot_product` extension.
* Use `CL_BLOCKING` and `CL_NON_BLOCKING` in enqueue calls.

## Version 0.4.0 (2021-05-30)

### New Features

* Add functions for Issue [#8](https://github.com/kenba/cl3/issues/8) Add generic functions to call `clGet*Info` functions.

## Version 0.3.1 (2021-05-22)

### New Features

* Add `cl_apple_setmemobjectdestructor` feature for Issue [#7](https://github.com/kenba/cl3/issues/7) Building on Debian Stretch fails.

## Version 0.3.0 (2021-05-16)

### Changes

* None.

## Version 0.2.4 (2021-05-16)

### New Features

* Add `cl_khr_gl_event` extension.
* Inline EGL functions.

## Version 0.2.3 (2021-05-15)

### New Features

* Issue [#6](https://github.com/kenba/cl3/issues/6) Make custom clGetDeviceInfo requests easier.
* Add undocumented `cl_nv_device_attribute_query` extension values.
* Add FFI interfaces for OpenCL extensions.
* Add OpenGL interoperability functions.
* Add dx9_media_sharing, d3d10 and d3d11.
* Add cl_khr_device_uuid values.
* Add DirectX error codes.

## Version 0.2.2 (2021-04-18)

### Changes

* Add Event types and OpenCL 3 constants.

## Version 0.2.1 (2021-04-11)

### Changes

* Add OpenCL memory constants.

## Version 0.2.0 (2021-03-28)

### Breaking Changes

* Change `create_program_with_source` to take an array of string slices for source code strings.

## Version 0.1.8 (2021-03-26)

### Breaking Changes

* Issue [#4](https://github.com/kenba/cl3/issues/4) Change the API to use String instead of ffi::CString.

### New Features

* PR [#3](https://github.com/kenba/cl3/pull/3) Add InfoType::to_string method.

## Version 0.1.7 (2021-03-19)

### Bug fixes

* Issue [#2](https://github.com/kenba/cl3/issues/2) Change InfoType to handle nulls in strings returned from OpenCL devices.

## Version 0.1.6 (2021-03-12)

### Changes

* Add `CSTRING_UTF8_CONVERSION_ERROR` to error_codes.

## Version 0.1.5 (2021-01-13)

### Bug fixes

* PR [#1](https://github.com/kenba/cl3/pull/1) Remove all trailing nulls from OpenCL API info strings.

## Version 0.1.4 (2021-01-10)

### Bug fixes

* create_sub_devices

## Version 0.1.3 (2020-12-31)

### Bug fixes

* Mark missing CL_VERSION_2_1 features.

## Version 0.1.2 (2020-12-30)

### New Features

* `error_text` function in [error_codes](src/error_codes.rs) to convert OpenCL API error codes to text.

### Changes

* Now gets OpenCL FFI bindings from [cl-sys](https://crates.io/crates/cl-sys) where possible.
* Small functions are now declared `inline`.
* Added more tests, including [integration_test](tests/integration_test.rs).
* Added `rust.yml` for [GitHub Actions](https://docs.github.com/en/actions).

### Bug fixes

* SVM mapping
* get_program_info CL_PROGRAM_BINARIES
* clEnqueueCopyBufferRect

## Version 0.1.1 (2020-12-21)

### Changes

* Fixes for `cargo` documentation.

## Version 0.1.0 (2020-12-21)

### Features

* `safe` Rust functions that call OpenCL C API functions and return Rust Result types.
* Foreign Function Interfaces for OpenCL C functions in [ffi](src/ffi).
* OpenCL API data types in [types](src/type.rs).
* OpenCL API error codes in [error_codes](src/error_codes.rs).
* A Rust enum ([info_type](src/info_type.rs)) to hold the OpenCL types that can be returned from OpenCL "Info" functions, e.g. clGetPlatformInfo, clGetDeviceInfo, clGetProgramInfo, etc.
* Rust macros to call the OpenCL "Info" functions and return the appropriate `InfoType` in a Rust Result in [macros](src/macros.rs).