imagecolorallocate(3) [php man page]

IMAGECOLORALLOCATE(3)							 1						     IMAGECOLORALLOCATE(3)

imagecolorallocate - Allocate a color for an image

SYNOPSIS

       int imagecolorallocate (resource  $image, int  $red, int  $green, int  $blue)

DESCRIPTION

	Returns a color identifier representing the color composed of the given RGB components.

       imagecolorallocate(3) must be called to create each color that is to be used in the image represented by $image.

       Note

	       The first call to imagecolorallocate(3) fills the background color in palette-based images - images created using imagecreate(3).

PARAMETERS

	      o $
		image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3).

	      o $red
		-Value of red component.

	      o $green
		-Value of green component.

	      o $blue
		-Value of blue component.

	These parameters are integers between 0 and 255 or hexadecimals between 0x00 and 0xFF.

RETURN VALUES

	A color identifier or FALSE if the allocation failed.

       Warning

	      This function may return Boolean FALSE, but may also return a non-Boolean value which evaluates to FALSE. Please read the section on
	      Booleans for more information. Use the === operator for testing the return value of this function.

CHANGELOG

       +--------+---------------------------------------------------+
       |Version |						    |
       |	|						    |
       |	|		     Description		    |
       |	|						    |
       +--------+---------------------------------------------------+
       | 5.1.3	|						    |
       |	|						    |
       |	|  Returns FALSE if the allocation  failed.  Previ- |
       |	| ously -1 was returned.			    |
       |	|						    |
       +--------+---------------------------------------------------+
EXAMPLES

       Example #1

	      imagecolorallocate(3) example

	      <?php

	      $im = imagecreate(100, 100);

	      // sets background to red
	      $background = imagecolorallocate($im, 255, 0, 0);

	      // sets some colors
	      $white = imagecolorallocate($im, 255, 255, 255);
	      $black = imagecolorallocate($im, 0, 0, 0);

	      // hexadecimal way
	      $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);
	      $black = imagecolorallocate($im, 0x00, 0x00, 0x00);

	      ?>

SEE ALSO

       imagecolorallocatealpha(3), imagecolordeallocate(3).

PHP Documentation Group 												     IMAGECOLORALLOCATE(3)

Check Out this Related Man Page

IMAGEDASHEDLINE(3)							 1							IMAGEDASHEDLINE(3)

imagedashedline - Draw a dashed line

SYNOPSIS

       bool imagedashedline (resource  $image, int  $x1, int  $y1, int	$x2, int  $y2, int  $color)

DESCRIPTION

	This function is deprecated. Use combination of imagesetstyle(3) and imageline(3) instead.

PARAMETERS

	      o $
		image -An image resource, returned by one of the image creation functions, such as imagecreatetruecolor(3).

	      o $x1
		- Upper left x coordinate.

	      o $y1
		- Upper left y coordinate 0, 0 is the top left corner of the image.

	      o $x2
		- Bottom right x coordinate.

	      o $y2
		- Bottom right y coordinate.

	      o $color
		- The fill color. A color identifier created with imagecolorallocate(3).

RETURN VALUES

	Always returns true

EXAMPLES

       Example #1

	      imagedashedline(3) example

	      <?php
	      // Create a 100x100 image
	      $im = imagecreatetruecolor(100, 100);
	      $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

	      // Draw a vertical dashed line
	      imagedashedline($im, 50, 25, 50, 75, $white);

	      // Save the image
	      imagepng($im, './dashedline.png');
	      imagedestroy($im);
	      ?>

	      The above example will output something similar to:[NOT DISPLAYABLE MEDIA]Output of example : imagedashedline()

       Example #2

	      Alternative to imagedashedline(3)

	      <?php
	      // Create a 100x100 image
	      $im = imagecreatetruecolor(100, 100);
	      $white = imagecolorallocate($im, 0xFF, 0xFF, 0xFF);

	      // Define our style: First 4 pixels is white and the
	      // next 4 is transparent. This creates the dashed line effect
	      $style = Array(
			      $white,
			      $white,
			      $white,
			      $white,
			      IMG_COLOR_TRANSPARENT,
			      IMG_COLOR_TRANSPARENT,
			      IMG_COLOR_TRANSPARENT,
			      IMG_COLOR_TRANSPARENT
			      );

	      imagesetstyle($im, $style);

	      // Draw the dashed line
	      imageline($im, 50, 25, 50, 75, IMG_COLOR_STYLED);

	      // Save the image
	      imagepng($im, './imageline.png');
	      imagedestroy($im);
	      ?>

SEE ALSO

       imagesetstyle(3), imageline(3).

PHP Documentation Group 													IMAGEDASHEDLINE(3)

Linux and UNIX Man Pages

imagecolorallocate(3) [php man page]

Check Out this Related Man Page