Operacje na kolorach - Color 0.3, Klasa, php 5 Opcje

[dr_bonzo]

Update 2
---------------
W paczce takze UnitTesty (SimpleTest) dla obu klas.


Co mozna nia zrobic?
- przejscie tonalne miedzy dwoma kolorami,
- inwersje koloru
- pobranie wartosci koloru jako tablice intow, lub wersji HTML dla kazdej skladowej osobno lub dla calego koloru,
- (brakuje fadeTo)


wymaga php5
http://northslope.lap.pl/dev/Color/

[PHP] pobierz, plaintext 
<?php
/**
 * (c) Copyright by dr_bonzo
 * Free to use and modify, just leave the note that i'm the autor of the initial version.
 * 
 * @author dr_bonzo
 * @version 0.3
 * @package Color
 */
class Color
{
	/**
	 * 
	 *
	 * @param mixed $mixColorSpecification
	 * @throws ColorException 
	 */
	public function __construct( $mixColorSpecification )
	{
		try
		{
			// chain of responsibility?
			if ( is_array( $mixColorSpecification ) )
			{
				$this->setColorFromRGBArray( $mixColorSpecification );
			}
			elseif ( is_string( $mixColorSpecification ) )
			{
				if ( preg_match( &#092;"/^#?[a-f0-9]{6,6}$/\", strtolower( $mixColorSpecification ) ) === 1 )
				{
					$this->setColorFromHexString( $mixColorSpecification );
				}
				else 
				{
					$this->setColorFromColorName( $mixColorSpecification );
				}
			}
			else 
			{
				throw new ColorException( 'Unsupported color specification' );
			}
		}
		catch ( ColorException $e )
		{
			throw $e;
		}
	}
 
	/**
	 * 
	 *
	 * @param unknown_type $strColorName
	 * @throws ColorException
	 */
	private function setColorFromColorName( $strColorName )
	{
		if ( array_key_exists( $strColorName, self::$arrPredefinedColorNames ) )
		{
			$this->setColorFromHexString( self::$arrPredefinedColorNames[ $strColorName ] );
		}
		else 
		{
			throw new ColorException( 'Invalid color name: '' . $strColorName . ''' );
		}
 
	}	
	/**
	 * Creates color from array( $r, $g, $b ) format, where $r is red color value as integer
	 *
	 * @param array $arrColorSpecification
	 * @throws ColorException
	 */
	private function setColorFromRGBArray( $arrColorSpecification )
	{
		if ( count( $arrColorSpecification ) !== 3 )
		{
			throw new ColorException( 'Invalid color specification as array of rgb values' );
		}
 
		$arrNormalizedColorSpecification = array_values( $arrColorSpecification );
		$this->intRed = intval( $arrNormalizedColorSpecification[ 0 ] );
		$this->intGreen = intval( $arrNormalizedColorSpecification[ 1 ] );
		$this->intBlue = intval( $arrNormalizedColorSpecification[ 2 ] );
 
		if ( ! $this->allIngredientRangesAreCorrect() )
		{
			throw new ColorException( 'Wrong color ingredient specification: invalid range');
		}
	}
 
	/**
	 * Creates color from '#rrggbb' or 'rrggbb' format, where 'rr' is red color value in hex.
	 *
	 * @param string $strHexString
	 * @throws ColorException
	 */
	private function setColorFromHexString( $strHexString )
	{
		$strColorSpecification = strtolower( strval( $strHexString ) ); // to lower case
		$strColorSpecification = substr( $strColorSpecification, -6, 6 ); // remove '#' if exists
 
		$this->intRed = hexdec( substr( $strColorSpecification, 0, 2 ) );
		$this->intGreen = hexdec( substr( $strColorSpecification, 2, 2 ) );
		$this->intBlue = hexdec( substr( $strColorSpecification, 4, 2 ) );
 
		if ( ! $this->allIngredientRangesAreCorrect() )
		{
			throw new ColorException( 'Wrong color ingredient specification: invalid range');
		}
	}
 
	/**
	 * Checks whether reg, green and blue values are in correct value ranges
	 *
	 * @return boolean 
	 */
	private function allIngredientRangesAreCorrect()
	{
		$boolRetVal = TRUE;
		$boolRetVal &= ( ( $this->intRed >= 0 ) && ( $this->intRed <= 255 ) );
		$boolRetVal &= ( ( $this->intGreen >= 0 ) && ( $this->intGreen <= 255 ) );
		$boolRetVal &= ( ( $this->intBlue >= 0 ) && ( $this->intBlue <= 255 ) );
 
		return $boolRetVal;
	}
 
	/**
	 * Returns red ingredient as integer
	 *
	 * @return integer
	 */
	public function getRed()
	{
		return $this->intRed;
	}
 
	/**
	 * Returns green ingredient as integer
	 *
	 * @return integer
	 */
	public function getGreen()
	{
		return $this->intGreen;
	}
 
	/**
	 * Returns blue ingredient as integer
	 *
	 * @return integer
	 */
	public function getBlue()
	{
		return $this->intBlue;
	}
 
	/**
	 * @return string
	 */
	public function getRedAsHex()
	{
		return $this->getHexValueWithLeadingZero( $this->intRed );
	}
 
	/**
	 * @return string
	 */
	public function getGreenAsHex()
	{
		return $this->getHexValueWithLeadingZero( $this->intGreen );
	}
 
	/**
	 * @return string
	 */
	public function getBlueAsHex()
	{
		return $this->getHexValueWithLeadingZero( $this->intBlue );
	}
 
 
	private function getHexValueWithLeadingZero( $intNumber )
	{
		$strRetVal = dechex( $intNumber );
		return strlen( $strRetVal ) < 2 ? '0' . $strRetVal : $strRetVal;
	}
 
	/**
	 * Returns color representation as '#rrggbb' or just 'rrggbb'
	 *
	 * @param boolean $boolWithSharp indicates whether add '#' prefix to color
	 * @return string
	 */
	public function getHTMLValue( $boolWithSharp = TRUE )
	{
		return ( $boolWithSharp ? '#' : '' ) . implode( '', array( $this->getRedAsHex(), $this->getGreenAsHex(), $this->getBlueAsHex() ) );
	}
 
	public function getAsIntArray()
	{
		return array( $this->getRed(), $this->getGreen(), $this->getBlue() );
	}
 
	/**
	 * Returns color being an invertion of current color.
	 * New object is returned
	 *
	 * @return Color
	 */
	public function getInverted()
	{
		return new Color( array( 255 - $this->getRed(), 255 - $this->getGreen(), 255 - $this->getBlue() ) );
	}
 
	private $intRed = -1;
	private $intGreen = -1;
	private $intBlue = -1;
 
	static private $arrPredefinedColorNames = array(
									'black' => '000000', 
									'silver' => 'C0C0C0',
									'gray' => '808080',
									'white' => 'FFFFFF',
									'maroon' => '800000',
									'red' => 'FF0000',
									'purple' => '800080',
									'fuchsia' => 'FF00FF',
									'green' => '00FF00',
									'lime' => '00FF00',
									'olive' => '808000',
									'yellow' => 'FFFF00',
									'navy' => '000080',
									'blue' => '0000FF',
									'teal' => '008080',
									'aqua' => '00FFFF'
									);
}
 
class ColorException extends Exception 
{
}
?>
[PHP] pobierz, plaintext 

[PHP] pobierz, plaintext 
<?php
 
/**
 * (c) Copyright by dr_bonzo
 * Free to use and modify, just leave the note that i'm the autor of the initial version.
 * 
 * @author dr_bonzo
 * @version 0.3
 * @package Color
 */
class ColorGradientGenerator
{
	/**
	 * Creates gradient between colors of the ColorGradient object
	 *
	 * @param Color[] $arrColors
	 * @param integer[] $arrIntermediateColorNumbers
	 * @return Color[]
	 * @throws ColorException
	 */
	public function createGradient( $arrColors, $arrIntermediateColorNumbers )
	{
		if ( count( $arrColors ) < 2 )
		{
			throw new ColorException( 'Illegal number of Colors: ' . count( $arrColors ) );
		}
 
		if ( count( $arrIntermediateColorNumbers ) !== count( $arrColors ) - 1 )
		{
			throw new ColorException( 'Illegal number of intermediate color numbers: ' . count( $arrIntermediateColorNumbers ) );
		}
 
		$arrGradient = array();
		$iMax = count( $arrColors ) - 1;
 
		for ( $i = 0; $i < $iMax; $i++ )
		{
			$arrGradient[] = $arrColors[ $i ]; // start color
			$arrGradient = array_merge( $arrGradient, $this->createGradientBeetweenColors( $arrColors[ $i ], $arrColors[ $i + 1 ], $arrIntermediateColorNumbers[ $i ] ) );
		}
 
		$arrGradient[] = $arrColors[ count( $arrColors ) - 1 ]; // last color
 
		return $arrGradient;
	}
 
	/**
	 * Creates intermediate colors between two specified colors: startColor and endC
olor.
	 *
	 * @param Color $startColor
	 * @param Color $endColor
	 * @param integer $intIntermediateColors numer of colors between start and 
nd color
	 * @return Color[] 
	 * @throws ColorException
	 */
	private function createGradientBeetweenColors( Color $startColor, Color $endColor, $intIntermediateColors )
	{
		if ( $intIntermediateColors < 0 )
		{
			throw new ColorException( 'Illegal intIntermediateColors: ' . $intIntermediateColors );
		}
		$flRedInterval = ( $endColor->getRed() - $startColor->getRed() ) / ( $intIntermediateColors + 1 );
		$flGreenInterval = ( $endColor->getGreen() - $startColor->getGreen() ) / ( $intIntermediateColors + 1 );
		$flBlueInterval = ( $endColor->getBlue() - $startColor->getBlue() ) / ( $intIntermediateColors + 1 );
 
		$flRed = floatval( $startColor->getRed() );
		$flGreen = floatval( $startColor->getGreen() );
		$flBlue = floatval( $startColor->getBlue() );
 
		$arrGradient = array();
 
		for ( $i = 0; $i < $intIntermediateColors; $i++ )
		{
			$flRed += $flRedInterval;
			$flGreen += $flGreenInterval;
			$flBlue += $flBlueInterval;
 
			$c = new Color( array( round( $flRed ), round( $flGreen ), round( $flBlue ) ) );
			$arrGradient[] = $c;
		}
 
		return $arrGradient;
	}
}
?>
[PHP] pobierz, plaintext 

Ten post edytował dr_bonzo 7.02.2006, 13:37:46

[bigZbig]

Tak przygladam sie Twojej klasie i nie bardzo moge zrozumiec koncepcje. Aby stworzyc gradient wywolujesz metode obiektu Color i jako parametr przekazujesz jej obiekt bedacy inna instancja tej samej klasy.

Nie lepiej byloby stworzyc osobna klase gradient do ktorej przekazywalbys dwa obiekty klasy Color? To samo tyczy sie metody fadeTo.

Pod wzgledem koncepcyjnym o wiele bardziej podoba mi sie klasa stworzona przez FiDO http://forum.php.pl/index.php?showtopic=21562. Dodajesz kolory do obiektu i pobierasz gradient.

[dr_bonzo]

Aby stworzyc gradient wywolujesz metode obiektu Color i jako parametr przekazujesz jej obiekt bedacy inna instancja tej samej klasy.Nie lepiej byloby stworzyc osobna klase gradient do ktorej przekazywalbys dwa obiekty klasy Color?

OK, za malo przemyslalem to rozwiazanie. Dodam nowa klase z Iteratorem po kolorach gradientu.
Dodam podawanie kolowow przez nazwy np. Color::BLACK, Color::RED i opcjonalnie przez stringi "black" "red" -- jesli ktos tak woli.
Gradient z posrednimi stanami -- nawet nie pomyslalem >> Color 0.3

Dzieki za uwagi.

[bigZbig]

@dr_bonzo postanowilem powalczyc troszke z Twoja klasa i wspominanym juz przeze mnie rozwiazaniem FiDO i stworzylem swoja klase o podobnej funkcjonalnosci, ktora niesmialo nazwalem bigColor ;-)

[dr_bonzo]

Fajne, fajne.
Ma wszystko to czego mojej brakowalo.
----edit:
Skoro masz bigColorColection, to nie bylo by lepiej zwracac z gradientu kolekcje kolorow?

[bigZbig]

Tworzac instancje klasy gradient masz automatycznie do czynienia z obiektem klasy bigColorColection bo bigColorGradient jest rozszerzeniem klasy bigColorColection. Nalezy oczywiscie uzyc metody generate klasy bigColorGradient bo inaczej kolekcja nie bedzie zawierac kolorow posrednich. Nie widze potrzeby wprowadzania dodatkowego posrednika jakim bylby pierwotny obiekt klasy bigColorColection zwracany przez klase generujaca gradient.

[dr_bonzo]

Aha, bo nie zagladalem do kodu, tylko do przykladow uzycia. Ale teraz nie pasuje mi logiczne zlozenie obiektow: to ze gradient dziedziczy po kolekcji, a przeznaczenie ma inne -- on tworzy kolekcje i sam nia jest :|

BTW. Dzisiaj wyjdzie moja wersja klas Kolorowych


---------------------
edit: updatowalem pierwszy post.
bigZbig dzieki za uwagi: dodalem klase do robienia Gradientow

[bigZbig]

Ale teraz nie pasuje mi logiczne zlozenie obiektow: to ze gradient dziedziczy po kolekcji, a przeznaczenie ma inne -- on tworzy kolekcje i sam nia jest :|

Hmm faktycznie jest pewien zgrzyt logiczny ale czy aby napewno? Gradient jest kolekcja kolorow. Jesli nie wygenerujesz kolorow posrednich to w sumie tez masz gradient tyle, ze w postaci maksymalnie uproszczonej. Jak na to spojrzec w ten posob to kazda kolekscja jest gradientem. No zapedzilem sie juz w rozwazania filozoficzne, a nie o to przecierz chodzi aby na sile udowadniac swoja racje. Powiem szczerze zrobilem tak aby zaoszczedzic sobie pracy z metodami odpowiedzialnymi za dodawanie koloru do obiektu. Po glebszym zastanowieniu przyznaje Ci racje, ze klase gradient nalerzy raczej traktowac jak narzedzie niz jak pojemnik.

Tymczasem zrobilem maly formularz generujacy kolorowe naglowki.

@dr_bonzo - przyjrze sie Twojemu dzielu

[dr_bonzo]

Przyjzalem sie blizej kodowi:

- [ bigColor]Globale w OOP? Nie lepiej zawrzec to w klasie:

[PHP] pobierz, plaintext 
<?php
if (is_array($GLOBALS['aColorsNames']) && !empty($GLOBALS['aColorsNames'])) ...
 
//...
$aColorsNames = array(
	"aqua" => "#00FFFF",
	"lime" => "#00FF00", ...
 
?>
[PHP] pobierz, plaintext 

- [ bigColorCollection]

[PHP] pobierz, plaintext 
<?php
public function addColor($mColor){
	if(is_a($mColor, 'bigColor')) {
 
?>
[PHP] pobierz, plaintext 

manual:

The is_a() function is deprecated as of php 5 in favor of the instanceof type operator.

* [ bigColorCollection]

[PHP] pobierz, plaintext 
<?php
public function addColors($aColors)
  {
	if (!is_array($aColors))
	{
	  throw new Exception('Wrong format color (array(255,255,255), "255,255,255", "#FF0000", "black")');
	}
?>
[PHP] pobierz, plaintext 

chyba troche nie trafiles z komentarzem: $aColors powinno byc tablica bigColor[], a komentarz masz od konstruktora bigColor'u :|

+ Znajdowanie nazwy dla koloru podanego jako liczby/-a
+ Masz wiecej nazwanych kolorow

? Przydalby sie iterator po bigColorCollection, bo na razie jest pojemnikiem na tablice bigColor[], musze wybrac ->getColors() zeby otrzymac tablice i dopiero po miej puscic foreach()

[PHP] pobierz, plaintext 
<?php
		// upewnienie sie ze wartosci kolorow mieszcza sie w granicach
		$color[$j] = ($color[$j] > 255) ? 255 : $color[$j];
		$color[$j] = ($color[$j] < 0) ? 0 : $color[$j];
?>
[PHP] pobierz, plaintext 

To nie jest konieczne, gwarantuje ci to matematyka i algorytm


PS. Zgodnie z regulaminem powinienes zalozyc nowy watek dla swojej klasy

[bigZbig]

Zastosowalem sie do wszystkich Twoich rad - za wyjatkiem zalozenia nowego watku ;-)