Модуль:Color/документація

Цей модуль призначений для корисних функцій на обробку кольору. Модуль має дві реалізації: одна, що взята з французького модуля, а інша — з англійського модуля. Англійська реалізаця переважно використовується шаблоном {{Картка кольору}}, прибираючи потребу у використанні зовнішніх конверторів кольору та запобігаючи невідповідності між кольоровими координатами.

Використання

Англійська реалізація

Щоб використати цей модуль, то ви можете використати один з шаблонів, перерахованих вище, або викликати модуль напряму. Всі функції, що приймають три пари шістнадцяткових цифр, також оброблюють скорочений формат з трьох цифр.

Щоб перетворити три пари шістнадцяткових цифр до трьох пар цифр RGB, що розділені комою:

{{#invoke:Color|hexToRgbTriplet|color}}

Щоб перетворити три пари шістнадцяткових цифр до колірної моделі CMYK без кольорового профілю (що є дуже поганою ідеєю!):

{{#invoke:Color|hexToCmyk|color|precision=?|pctsign=?}}

Щоб перетворити три пари шістнадцяткових цифр до HSL або HSV:

{{#invoke:Color|hexToHsl|color|precision=?}}

{{#invoke:Color|hexToHsv|color|precision=?}}

Щоб перетворити три пари шістнадцяткових цифр до перцептивного колірного простору CIELCh_uv:

{{#invoke:Color|hexToCielch|color|precision=?}}

Щоб поєднати два кольори в більш фізично правильному лінійному просторі RGB:

{{#invoke:Color|hexMix|color1|color2|proportion|min=?|max=?}}

Щоб перетворити три пари цифр RGB до коду hex:

{{#invoke:Color|rgbTripletToHex|r|g|b}}

Наступні параметри є необов'язковими:

• precision: по стандарту — 0 (нуль)
• pctsign: встановіть 0 (нуль), щоб приховати символ відсотка в створеному виводу
• proportion: пропорція color2, по стандарту — 50
• min: мінімальне значення діапазону пропорція, по стандарту — 0
• max: максимальне значення діапазону пропорція, по стандарту — 100

Французька реалізація

Функція p.shade забезпечує колірний шістнадцятковий код, коли відомо колір. У разі не відомої назви кольору, функція вертає до того самого. Наприклад, якщо ми використовуємо шістнадцятковий колірний код — буде без змін.

Приклади

{{#invoke:Color|shade|ocher}} дає нам: ocher

{{#invoke:Color|shade|a27ed3}} дає нам: a27ed3