Scroll to navigation

MIX(3clc) OpenCL Manual MIX(3clc)

NAME

mix - Linear blend of x and y.

gentype mix(gentype x, gentype y, gentype a);

gentypef mix(gentypef x, gentypef y, float a);

gentyped mix(gentyped x, gentyped y, double a);

gentype mix (gentype x, gentype y, half a) // if half extension enabled

DESCRIPTION

Returns the linear blend of x and y implemented as: x + (y - x) * a

a must be a value in the range 0.0 ... 1.0. If a is not in the range 0.0 ... 1.0, the return values are undefined.

NOTES

The generic type name gentype is used to indicate that the function can take float, float2, float3, float4, float8, float16, double, double2, double3, double4, double8, or double16 as the type for the arguments.

The generic type name gentypef is used to indicate that the function can take float, float2, float3, float4, float8, or float16 as the type for the arguments.

The generic type name gentyped is used to indicate that the function can take double, double2, double3, double4, double8, or double16 as the type for the arguments.

The built-in common functions are implemented using the round to nearest even rounding mode.

If extended with cl_khr_fp16(3clc), generic type name gentype may indicate half and half{2|3|4|8|16} as arguments and return values.

The mix function can be implemented using contractions such as mad(3clc) or fma(3clc).

SPECIFICATION

OpenCL Specification[1]

SEE ALSO

commonFunctions(3clc)

AUTHORS

The Khronos Group

COPYRIGHT

Copyright © 2007-2011 The Khronos Group Inc.
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and/or associated documentation files (the "Materials"), to deal in the Materials without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Materials, and to permit persons to whom the Materials are furnished to do so, subject to the condition that this copyright notice and permission notice shall be included in all copies or substantial portions of the Materials.

NOTES

1.
OpenCL Specification
page 260, section 6.12.4 - Common Functions
01/14/2021 The Khronos Group