colour.full_to_legal¶
-
colour.
full_to_legal
(CV, bit_depth=10, in_int=False, out_int=False)[source]¶ Converts given code value \(CV\) or float equivalent of a code value at a given bit depth from full range (full swing) to legal range (studio swing).
Parameters: - CV (array_like) – Full range code value \(CV\) or float equivalent of a code value at a given bit depth.
- bit_depth (int, optional) – Bit depth used for conversion.
- in_int (bool, optional) – Whether to treat the input value as integer code value or float equivalent of a code value at a given bit depth.
- out_int (bool, optional) – Whether to return value as integer code value or float equivalent of a code value at a given bit depth.
Returns: Legal range code value \(CV\) or float equivalent of a code value at a given bit depth.
Return type: ndarray
Examples
>>> full_to_legal(0.0) # doctest: +ELLIPSIS 0.0625610... >>> full_to_legal(1.0) # doctest: +ELLIPSIS 0.9188660... >>> full_to_legal(0.0, out_int=True) 64 >>> full_to_legal(1.0, out_int=True) 940 >>> full_to_legal(0, in_int=True) # doctest: +ELLIPSIS 0.0625610... >>> full_to_legal(1023, in_int=True) # doctest: +ELLIPSIS 0.9188660... >>> full_to_legal(0, in_int=True, out_int=True) 64 >>> full_to_legal(1023, in_int=True, out_int=True) 940