|
SEDRIS Reference Manual
APPENDIX A - Transmittal Access Level 0 API Functions SE SetColourModel |
|---|
| extern SE_Return_Code | |||
| SE_SetColourModel | |||
| ( | |||
| SE_Colour_Model | new_colour_model | (notes) | |
| ); | |||
Sets the colour model that will be used to represent all <Colour Data> objects retrieved after this function is called. This function has no effect on <Colour Data> objects that were returned to the user before this function was called. By default (if this function is not called), colours are returned to the user in the format in which the colours were defined in the transmittal from which the colours were extracted. So, if a SEDRIS transmittal contains HSV colours, then by default these colours will be returned to the user as <HSV Colour> objects. If the user calls the SE_SetColourModel() function and sets the colour model to SE_RGB_MODEL, then all colours returned after this call would be returned as <RGB Colour> objects.
The colour model used for returning <Colour Data> objects can be changed as often as the user desires. After changing colour models, if the user wants to return to the 'default' colour model (for all transmittals, go back to using the colour model that was used by the producer of each transmittal) then call the SE_UseDefaultColourModel() function.
| SE_RET_CODE_SUCCESS | and the colour model is set. |
| SE_RET_CODE_FAILURE | and the status code is set appropriately if the call failed. |
SE_Status_Code(s) when SE_RET_CODE_SUCCESS is returned:
| SE_STAT_CODE_SUCCESS | set if new_colour_model is valid and the call was successful. |
SE_Status_Code(s) when SE_RET_CODE_FAILURE is returned:
| SE_STAT_CODE_INACTIONABLE_FAILURE | set if new_colour_model is invalid or the call fails for any other reason. |
the colour model to use from now on (or until another
call is made to either this function or the SE_UseDefaultColourModel()
function).
Prev: SE_ResolveTransmittalName.
Next: SE_SetFirstErrorMessage.
Up:Index.
|