setParameter

int clemrtl_setParameter(
	clemrtl_image_handle handle,
	const char* name,
	const char* value);

Sets the value of an image parameter.

Table 1. setParameter parameters
Parameter	Description
`handle`	The image handle.
`name`	The parameter name.
`value`	The parameter value.

Returns one of the status codes shown in the following table.

Table 2. Status codes
Result	Description
`CLEMRTL_OK`	Success.
`CLEMRTL_ERROR`	Failed with further details available.

The operation fails if the image handle is invalid or if the parameter name does not match the name of any parameter in the image. Parameter names use the name.attribute format described above—for example, file0.name—and parameter values are always strings, even when the interpretation is numeric.