Модуль:Color/документація
Це підсторінка документації модуля Модуль:Color. Вона містить інформацію про використання, категорії та інший вміст, що не є частиною оригінальної сторінки модуля. |
Цей модуль позначений як К:реліз, готовий до загального вжитку (43). Він досягнув стадії готовності й вважається, що вільний від помилок і може використовуватись всюди, де знадобиться. Його можна вживати на допоміжних сторінках та інших сторінках Вікіпедії як можливість для навчання новачків. Аби зменшити навантаження на сервери та некоректний показ сторінок, його можна вдосконалювати в рамцях чернеткового тестування[en], а не з застосуванням спроб і помилок. |
Цей модуль призначений для корисних функцій на обробку кольору. Модуль має дві реалізації: одна, що взята з французького модуля, а інша — з англійського модуля. Англійська реалізаця переважно використовується шаблоном {{Картка кольору}}, прибираючи потребу у використанні зовнішніх конверторів кольору та запобігаючи невідповідності між кольоровими координатами.
Використання
[ред. код]Англійська реалізація
[ред. код]Щоб використати цей модуль, то ви можете використати один з шаблонів, перерахованих вище, або викликати модуль напряму. Всі функції, що приймають три пари шістнадцяткових цифр, також оброблюють скорочений формат з трьох цифр.
Щоб перетворити три пари шістнадцяткових цифр до трьох пар цифр RGB, що розділені комою:
{{#invoke:Color|hexToRgbTriplet|color}}
Щоб перетворити три пари шістнадцяткових цифр до колірної моделі CMYK без кольорового профілю (що є дуже поганою ідеєю!):
{{#invoke:Color|hexToCmyk|color|precision=?|pctsign=?}}
Щоб перетворити три пари шістнадцяткових цифр до HSL або HSV:
{{#invoke:Color|hexToHsl|color|precision=?}}
{{#invoke:Color|hexToHsv|color|precision=?}}
Щоб перетворити три пари шістнадцяткових цифр до перцептивного колірного простору CIELChuv[en]:
{{#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
, по стандарту — 50min
: мінімальне значення діапазону пропорція, по стандарту — 0max
: максимальне значення діапазону пропорція, по стандарту — 100
Французька реалізація
[ред. код]Цей модуль залежить від наступних модулів: |
Функція p.shade забезпечує колірний шістнадцятковий код, коли відомо колір. У разі не відомої назви кольору, функція вертає до того самого. Наприклад, якщо ми використовуємо шістнадцятковий колірний код — буде без змін.
Приклади
[ред. код]{{#invoke:Color|shade|ocher}} дає нам: ocher
{{#invoke:Color|shade|a27ed3}} дає нам: a27ed3
Це сторінка документації для Модуль:Color