Bitbybit Docs
    Preparing search index...

    Class Color

    الألوان بالصيغتين اللتين تستخدمهما المكتبة: نص hex مثل #ff5733، وكائن { r, g, b } أو { r, g, b, a } تمتد قنواته إما من 0 إلى 255 أو من 0 إلى 1. تبني الدوال هنا الألوان بكل صيغة، وتحول بينها بنطاق قنوات صريح، وتقرأ القنوات المفردة وتعكس لونا.

    Index

    Constructors

    convert

    • يقرأ لونا سداسيا عشريا إلى كائن { r, g, b } بقنوات من 0 إلى 255.

      يمكن أن يبدأ النص بـ # أو بدونها؛ أي شيء غير ستة أرقام سداسية عشرية يرمي خطأ. مثال: '#FF5733' -> { r: 255, g: 87, b: 51 }

      Parameters

      • inputs: HexDto

        اللون بصيغة hex

      Returns ColorRGB

      كائن اللون بقنوات من 0 إلى 255

      const rgb = bitbybit.color.hexToRgb({ color: "#ff5733" });
      
    • يكتب ثلاث قيم قنوات كلون سداسي عشري.

      min و max يحددان النطاق الذي تستخدمه القيم؛ النطاق المختلف عن 0 إلى 255 يُعاد ربطه أولا، فتعمل القنوات من 0 إلى 1 أيضا. مثال: r 255، g 87، b 51 في [0,255] -> '#ff5733'؛ r 1، g 0.5، b 0.2 في [0,1] -> '#ff8033'

      Parameters

      • inputs: RGBMinMaxDto

        قيم الأحمر والأخضر والأزرق ونطاقها

      Returns string

      اللون بصيغة hex

      const hex = bitbybit.color.rgbToHex({ r: 1, g: 0.5, b: 0.2, min: 0, max: 1 });
      
    • يكتب لون { r, g, b } كلون سداسي عشري.

      min و max يحددان النطاق الذي تستخدمه القنوات؛ النطاق المختلف عن 0 إلى 255 يُعاد ربطه أولا. مثال: { r: 1, g: 0.5, b: 0.2 } في [0,1] -> '#ff8033'

      Parameters

      • inputs: RGBObjectMaxDto

        كائن اللون والنطاق الذي تستخدمه قنواته

      Returns string

      اللون بصيغة hex

      const hex = bitbybit.color.rgbObjToHex({ rgb: { r: 1, g: 0.5, b: 0.2 }, min: 0, max: 1 });
      
    • يقرأ لونا سداسيا عشريا إلى كائن { r, g, b } مع إعادة ربط القنوات إلى نطاق من اختيارك.

      مثال: '#FF5733' مربوطا إلى [0,1] -> { r: 1, g: 0.341, b: 0.2 }

      Parameters

      • inputs: HexDtoMapped

        اللون بصيغة hex والنطاق المراد تحويل القنوات إليه

      Returns ColorRGB

      كائن اللون بقنوات في ذلك النطاق

      const rgb = bitbybit.color.hexToRgbMapped({ color: "#ff5733", from: 0, to: 1 });
      

    create

    • يمرر لونا سداسيا عشريا دون تغيير، بحيث يمكن إعطاء اللون اسما وإعادة استخدامه.

      مثال: '#FF5733' -> '#FF5733'

      Parameters

      • inputs: HexDto

        اللون بصيغة hex

      Returns string

      اللون hex نفسه

    • يمرر لون { r, g, b } بقنوات من 0 إلى 255 دون تغيير، بحيث يمكن إعطاؤه اسما وإعادة استخدامه.

      مثال: { r: 255, g: 87, b: 51 } -> الكائن نفسه

      Parameters

      Returns ColorRGB

      كائن اللون نفسه

    • يمرر لون { r, g, b } بقنوات من 0 إلى 1 دون تغيير، بحيث يمكن إعطاؤه اسما وإعادة استخدامه.

      مثال: { r: 1, g: 0.34, b: 0.2 } -> الكائن نفسه

      Parameters

      • inputs: Rgb1Dto

        كائن اللون

      Returns ColorRGB

      كائن اللون نفسه

    • يمرر لون { r, g, b, a } بقنوات لون من 0 إلى 255 وعتامة من 0 إلى 1 دون تغيير، بحيث يمكن إعطاؤه اسما وإعادة استخدامه.

      مثال: { r: 255, g: 87, b: 51, a: 1 } -> الكائن نفسه

      Parameters

      Returns ColorRGBA

      كائن اللون نفسه

    • يمرر لون { r, g, b, a } بكل قناة من 0 إلى 1 دون تغيير، بحيث يمكن إعطاؤه اسما وإعادة استخدامه.

      مثال: { r: 1, g: 0.34, b: 0.2, a: 1 } -> الكائن نفسه

      Parameters

      Returns ColorRGBA

      كائن اللون نفسه

    • يبني لون { r, g, b } من ثلاث قيم قنوات منفصلة من 0 إلى 255.

      مثال: r 255، g 87، b 51 -> { r: 255, g: 87, b: 51 }

      Parameters

      Returns ColorRGB

      كائن اللون

      const orange = bitbybit.color.rgbAtomic255Color({ r: 255, g: 87, b: 51 });
      
    • يبني لون { r, g, b } من ثلاث قيم قنوات منفصلة من 0 إلى 1.

      مثال: r 1، g 0.34، b 0.2 -> { r: 1, g: 0.34, b: 0.2 }

      Parameters

      • inputs: RgbAttomic1Dto

        قيم الأحمر والأخضر والأزرق

      Returns ColorRGB

      كائن اللون

      const orange = bitbybit.color.rgbAtomic1Color({ r: 1, g: 0.34, b: 0.2 });
      

    hex to

    • يقرأ القناة الحمراء للون سداسي عشري، معاد ربطها إلى نطاق من اختيارك.

      مثال: '#FF5733' في [0,1] -> 1

      Parameters

      • inputs: HexDtoMapped

        اللون بصيغة hex والنطاق المراد تحويل القناة إليه

      Returns number

      القناة الحمراء في ذلك النطاق

      const red = bitbybit.color.getRedParam({ color: "#ff5733", from: 0, to: 1 });
      
    • يقرأ القناة الخضراء للون سداسي عشري، معاد ربطها إلى نطاق من اختيارك.

      مثال: '#FF5733' في [0,1] -> 0.341

      Parameters

      • inputs: HexDtoMapped

        اللون بصيغة hex والنطاق المراد تحويل القناة إليه

      Returns number

      القناة الخضراء في ذلك النطاق

      const green = bitbybit.color.getGreenParam({ color: "#ff5733", from: 0, to: 1 });
      
    • يقرأ القناة الزرقاء للون سداسي عشري، معاد ربطها إلى نطاق من اختيارك.

      مثال: '#FF5733' في [0,1] -> 0.2

      Parameters

      • inputs: HexDtoMapped

        اللون بصيغة hex والنطاق المراد تحويل القناة إليه

      Returns number

      القناة الزرقاء في ذلك النطاق

      const blue = bitbybit.color.getBlueParam({ color: "#ff5733", from: 0, to: 1 });
      
    • يعكس لونا سداسيا عشريا، محولا كل قناة إلى نقيضها: 255 ناقص القيمة.

      مع تفعيل blackAndWhite، تكون النتيجة أسود صرفا للون الفاتح أو أبيض للون الداكن، وهو ما يناسب النص على خلفية ملونة. مثال: '#FF5733' -> '#00a8cc'؛ مع blackAndWhite -> '#ffffff'

      Parameters

      • inputs: InvertHexDto

        اللون بصيغة hex وما إذا كان يختزل النتيجة إلى الأسود أو الأبيض

      Returns string

      اللون hex المعكوس

      const textColor = bitbybit.color.invert({ color: "#ff5733", blackAndWhite: true });
      

    rgb to

    • يقرأ القناة الحمراء للون { r, g, b }.

      مثال: { r: 255, g: 87, b: 51 } -> 255

      Parameters

      Returns number

      القناة الحمراء، بأي نطاق يستخدمه الكائن

    • يقرأ القناة الخضراء للون { r, g, b }.

      مثال: { r: 255, g: 87, b: 51 } -> 87

      Parameters

      Returns number

      القناة الخضراء، بأي نطاق يستخدمه الكائن

    • يقرأ القناة الزرقاء للون { r, g, b }.

      مثال: { r: 255, g: 87, b: 51 } -> 51

      Parameters

      Returns number

      القناة الزرقاء، بأي نطاق يستخدمه الكائن