File: rgb_esp.class.txt

 AUTOR / AUTHOR : LUIS QUIJADA SERRANO 
 FECHA / DATE   : 7/03/2002.
 VERSION        : 1.0
 THIS FILE      : COMMENTS AND EXPAMPLES FOR rgb_esp.clas.php

 /* THE DESCRIPTIONS HERE ARE IN SPANISH BECAUSE THE METHODS EXPLAINED
 /* ARE IN SPANISH WAY. FOR ENGLISH METHODS AND ITS DESCRIPTIONS LOOK
 /* AT rgb_eng.class.txt DOCUMENTATION FILE. thanks.

 LIST AND DESCRIPTION OF SPANISH METHODS *******************************/

  Extrae el valor de componente especificado por $componente
  ([RGB_R|RGB_G|RGB_B]).
  /* Valor retornado : cadena */
  function ExtraerComponenteRGB($rgb, $componente, $cseparador="")
  /* Valor retornado : cadena */
  function ExtraerComponenteCSS($colorcss, $componente)

  Sustituye el valor de componente especificado por $componente
  ([RGB_R|RGB_G|RGB_B]) por $nuevovalor.
  /* Valor retornado : [matriz|lista] */
  function SubstituirComponenteRGB($rgb, $nuevovalor, $componente, $cseparador="")
  /* Valor retornado : cadena */
  function SubstituirComponenteCSS($colorcss, $nuevovalor, $componente)
  
  Incrementa en $cantidad unidadaes el componente especificado
  ([RGB_R|RGB_G|RGB_B]).
  /* Valor retornado : [matriz|lista] */
  function IncrementarComponenteRGB($cantidad, $rgb, $componente, $cseparador="")
  /* Valor retornado : cadena */
  function IncrementarComponenteCSS($cantidad, $colorcss, $componente)
  
  Decrementa en $cantidad unidadaes el componente especificado
  ([RGB_R|RGB_G|RGB_B]).
  /* Valor retornado : [matriz|lista] */
  function DecrementarComponenteRGB($cantidad, $rgb, $componente, $cseparador="")
  /* Valor retornado : cadena */
  function DecrementarComponenteCSS($cantidad, $colorcss, $componente)

  Incremeta el componente especificado ([RGB_R|RGB_G|RGB_B], por defecto el
  componente a incrementar/saturar es el mayor del triplete) decrementando
  en la misma cantidad el resto de componentes.
  /* Valor retornado : [matriz|lista] */
  function SaturarRGB($cantidad, $rgb, $componente="", $cseparador="")
  /* Valor retornado : cadena */
  function SaturarCSS($cantidad, $colorcss, $componente="")

  
  Incrementa los todos compontes del color.
  /* Valor retornado : [matriz|lista] */
  function LuminizarRGB($cantidad, $rgb, $cseparador="")
  /* Valor retornado : cadena */
  function LuminizarCSS($cantidad, $colorcss)
  
  
  Decrementa los todos compontes del color.
  /* Valor retornado : [matriz|lista] */
  function OscurecerRGB($cantidad, $rgb, $cseparador="")
  /* Valor retornado : cadena */
  function OscurecerCSS($cantidad, $colorcss)

  Convierte un triplete RGB en color válido CSS.
  /* Valor retornado : cadena */
  function ConvertirAColorCSS($rgb, $cseparador=",")

  Convierte una color valido CSS en un triplete RGB.
  /* Valor retornado : [matriz]|[lista] */
  function ConvertirAColorRGB($colorcss, $cseparador="")


/* ALGUNOS EJEMPLOS (FOR ENGLISH EXAMPLES (see at the rbg_eng.class.txt documentation file)) */
/*
/* Instanciacion (para métodos en español)
$objRGB = new RGB(RGB_ES);

/* extrayendo componentes
print($objRGB->ExtraerComponenteRGB("21,12,10", RGB_R, ",")); // S: 21
print($objRGB->ExtraerComponenteRGB(array(21,12,10), RGB_B)); // S: 10
print($objRGB->ExtraerComponenteCSS("#FFEEAA", RGB_R));       // S: FF

/* remplazando componentes
print($objRGB->SubstituirComponenteCSS("#FFEEAA", "AA", RGB_G)); // S: #FFAAAA

/* Incrementando / Decrementando y utilizando algunas operaciones especiales
print($objRGB->IncrementarComponenteRGB(30, "40,50,20", RGB_B, ",")); // S: 40,50,50
print($objRGB->IncrementarComponenteCSS(9, "#A0BBCC", RGB_R));        // S: #A9BBCC
print($objRGB->DecrementarComponenteCSS(9, "#A9BBCC", RGB_R));        // S: #A0BBCC

print($objRGB->SaturarRGB(20, "20,20,25", "", ","));  // S: 0,0,54
print($objRGB->SaturarCSS(20, "#202025", "", ","));   // S: #0C0C39

print($objRGB->LuminizarRGB(20, "20,20,25", ","));    // S: 40,40,45
print($objRGB->LuminizarCSS(20, "#202020", ","));     // S: #343434

print($objRGB->OscurecerRGB(20, "20,20,25", ","));    // S: 0,0,5
print($objRGB->OscurecerCSS(20, "#202020", ","));     // S: #0C0C0C

/* convirtiendo values 
print($objRGB->ConvertirAColorCSS("20,20,25", ","));             // S: #141419
print($objRGB->ConvertirAColorRGB("#452020","@")); //            // S: 69@32@32