0LASubrWidgetCnvClrToRgb < Main

Tags: view all tags
---+ 
---+ .WIDGET CNV CLR TO RGB

_This subroutine converts an alpha/hex color code to decimal._

<br />%TOC%
---++ Usage:
<pre>      PASS         &lt;clr_binary&gt;               FIELD            SHARE? Y
      PASS         &lt;clr_alpha&gt;                FIELD            SHARE? N
      GOSUB    --- .WIDGET CNV CLR TO RGB
      *        Check for errors
      IF       --- .WIDGET CNV CLR TO RGB     NE

</pre>
---++ Description:

This subroutine converts an alpha/hex color code to decimal. This is useful for converting web or hex color codes (ie, #FFFF0000) to the format required for the --- WIDGET file (255, 255, 0, 0). Both parameters are required, and the subroutine will cancel if they are not received.

&lt;clr_binary&gt; is the color value returned (Required). This must be PASSed with Share "Y" to return the value. This should be a Group Header field, where the group consists of 4 numeric fields, 9(3), binary format. This corresponds to the layout of the various color fields in the --- WIDGET file, so you may use them directly. The fields are:

   * WIDGET COLOR EN FG
   * WIDGET COLOR EN BG
   * WIDGET COLOR DB FG
   * WIDGET COLOR DB BG
   * WIDGET COLOR RO FG
   * WIDGET COLOR RO BG
   * WIDGET COLOR WP BG
&lt;clr_alpha&gt; is the hex color code you want converted (Required). This must be in the format '#RRGGBBTT' or '#RRGGBB' where RR is the hex value for Red, GG is the hex value for Green, BB is the hex value for Blue and TT is the transparency. The transparency is optional, and if omitted will default to 1 (not transparent). Other values for TT are 0-255 where 0 is fully transparent and 255 is fully opaque.

To convert from decimal format to alpha color codes, see [[0LASubrWidgetCnvRgbToClr][.WIDGET CNV RGB TO CLR]]

---++ Comments:

_Read what other users have said about this page or add your own comments._

<br />%COMMENT%

-- Main.JeanNeron - 2012-02-06
Topic revision: r3 - 2020-05-12 - JeanNeron