php 한글 메뉴얼 도움말 검색 사이트 Allocate a color for an image [function.imagecolorallocate]

설명

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

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

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

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

인수

image: imagecreatetruecolor() 등의 이미지 생성 함수에서 반환한 이미지 자원.
red: Red 컴포넌트 값.
green: Green 컴포넌트 값.
blue: Blue 컴포넌트 값.

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

반환값

A color identifier or FALSE if the allocation failed.

Warning

이 함수는 논리 FALSE를 반환하지만, 논리 FALSE로 취급할 수 있는 다른 값을 반환할 수 있습니다. 자세한 정보는 논리형 섹션을 참고하십시오. 이 함수의 반환값을 확인하려면 === 연산자를 이용하십시오.

변경점

버전	설명
5.1.3	Returns `FALSE` if the allocation failed. Previously -1 was returned.

예제

Example #1 imagecolorallocate() 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);

?>

참고

imagecolorallocatealpha() - Allocate a color for an image
imagecolordeallocate() - De-allocate a color for an image