imagecreatefromwbmp

(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)

imagecreatefromwbmp — Создаёт новое изображение из файла или URL

Описание

imagecreatefromwbmp(string $filename): GdImage|false

imagecreatefromwbmp() возвращает идентификатор изображения, представляющего изображение полученное из файла с заданным именем.

Замечание: Изображения WBMP представляют собой Wireless Bitmaps, а не Windows Bitmaps. Последние могут быть загружены с помощью imagecreatefrombmp().

Подсказка

В эту функцию в качестве имени файла можно передавать URL-адреса, если была включена директива fopen wrappers. Подробнее о том, как указать имя файла, рассказано в описании функции fopen(). В разделе «Поддерживаемые протоколы и обёртки» также даны ссылки на информацию о способностях поддерживаемых обёрток, замечания по работе с ними и список предопределённых переменных, которые они дают.

Список параметров

filename: Путь к изображению WBMP.

Возвращаемые значения

Возвращает объект изображения в случае успешного выполнения или false в случае возникновения ошибки.

Список изменений

Версия	Описание
8.0.0	В случае успешного выполнения функция теперь возвращает экземпляр GDImage; ранее возвращался ресурс (resource).

Примеры

Пример #1 Пример обработки ошибки при загрузке WBMP

<?php
function LoadWBMP($imgname)
{
    /* Пытаемся открыть */
    $im = @imagecreatefromwbmp($imgname);

    /* Если не удалось */
    if(!$im)
    {
        /* Создаём пустое изображение */
        $im  = imagecreatetruecolor(150, 30);
        $bgc = imagecolorallocate($im, 255, 255, 255);
        $tc  = imagecolorallocate($im, 0, 0, 0);

        imagefilledrectangle($im, 0, 0, 150, 30, $bgc);

        /* Выводим сообщение об ошибке */
        imagestring($im, 1, 5, 5, 'Ошибка загрузки ' . $imgname, $tc);
    }

    return $im;
}

header('Content-Type: image/vnd.wap.wbmp');

$img = LoadWBMP('bogus.image');

imagewbmp($img);
imagedestroy($img);
?>

add a note

User Contributed Notes 4 notes

down

clambert at whitecrown dot net ¶

22 years ago


WBMP images are Wireless Bitmaps, not Windows Bitmaps. WBMP is used for bandwidth constrained, black and white, limited devices such as PDAs and Cell Phones.

down

AeroX @ aerox-studios ¶

15 years ago


.bmp is just hex encoded RGB values.
All you need to do is open in binary mode and seperate the header from the body.
Decode the width and height from the header.
Then create the image pixel by pixel from the RGB values in the body.

function imagecreatefrombmp( $filename )
{
    $file = fopen( $filename, "rb" );
    $read = fread( $file, 10 );
    while( !feof( $file ) && $read != "" )
    {
        $read .= fread( $file, 1024 );
    }
    $temp = unpack( "H*", $read );
    $hex = $temp[1];
    $header = substr( $hex, 0, 104 );
    $body = str_split( substr( $hex, 108 ), 6 );
    if( substr( $header, 0, 4 ) == "424d" )
    {
        $header = substr( $header, 4 );
        // Remove some stuff?
        $header = substr( $header, 32 );
        // Get the width
        $width = hexdec( substr( $header, 0, 2 ) );
        // Remove some stuff?
        $header = substr( $header, 8 );
        // Get the height
        $height = hexdec( substr( $header, 0, 2 ) );
        unset( $header );
    }
    $x = 0;
    $y = 1;
    $image = imagecreatetruecolor( $width, $height );
    foreach( $body as $rgb )
    {
        $r = hexdec( substr( $rgb, 4, 2 ) );
        $g = hexdec( substr( $rgb, 2, 2 ) );
        $b = hexdec( substr( $rgb, 0, 2 ) );
        $color = imagecolorallocate( $image, $r, $g, $b );
        imagesetpixel( $image, $x, $height-$y, $color );
        $x++;
        if( $x >= $width )
        {
            $x = 0;
            $y++;
        }
    }
    return $image;
}

down

alexander at alexauto dot nl ¶

15 years ago


AeroX created a nice example, but it only works at specific imagesizes because bmp uses fully 32-bit lines. To prevent failures (different colors, pixel-shifting per line), the solution is to skip the padding, inserted after color-pixels on the line. His implementation did cutting the padding into the image-data, causing wrong colors, pixel-shifting per line and also an large memory-consumption.



I improved this script to the next implementation. The readability of a image is checked by a other function, so it doesn't take part in this script.

Suggestions? Please let me know.



<?php

    public function imagecreatefrombmp($p_sFile)

    {

        //    Load the image into a string

        $file    =    fopen($p_sFile,"rb");

        $read    =    fread($file,10);

        while(!feof($file)&&($read<>""))

            $read    .=    fread($file,1024);

        

        $temp    =    unpack("H*",$read);

        $hex    =    $temp[1];

        $header    =    substr($hex,0,108);

        

        //    Process the header

        //    Structure: http://www.fastgraph.com/help/bmp_header_format.html

        if (substr($header,0,4)=="424d")

        {

            //    Cut it in parts of 2 bytes

            $header_parts    =    str_split($header,2);

            

            //    Get the width        4 bytes

            $width            =    hexdec($header_parts[19].$header_parts[18]);

            

            //    Get the height        4 bytes

            $height            =    hexdec($header_parts[23].$header_parts[22]);

            

            //    Unset the header params

            unset($header_parts);

        }

        

        //    Define starting X and Y

        $x                =    0;

        $y                =    1;

        

        //    Create newimage

        $image            =    imagecreatetruecolor($width,$height);

        

        //    Grab the body from the image

        $body            =    substr($hex,108);



        //    Calculate if padding at the end-line is needed

        //    Divided by two to keep overview.

        //    1 byte = 2 HEX-chars

        $body_size        =    (strlen($body)/2);

        $header_size    =    ($width*$height);



        //    Use end-line padding? Only when needed

        $usePadding        =    ($body_size>($header_size*3)+4);

        

        //    Using a for-loop with index-calculation instaid of str_split to avoid large memory consumption

        //    Calculate the next DWORD-position in the body

        for ($i=0;$i<$body_size;$i+=3)

        {

            //    Calculate line-ending and padding

            if ($x>=$width)

            {

                //    If padding needed, ignore image-padding

                //    Shift i to the ending of the current 32-bit-block

                if ($usePadding)

                    $i    +=    $width%4;

                

                //    Reset horizontal position

                $x    =    0;

                

                //    Raise the height-position (bottom-up)

                $y++;

                

                //    Reached the image-height? Break the for-loop

                if ($y>$height)

                    break;

            }

            

            //    Calculation of the RGB-pixel (defined as BGR in image-data)

            //    Define $i_pos as absolute position in the body

            $i_pos    =    $i*2;

            $r        =    hexdec($body[$i_pos+4].$body[$i_pos+5]);

            $g        =    hexdec($body[$i_pos+2].$body[$i_pos+3]);

            $b        =    hexdec($body[$i_pos].$body[$i_pos+1]);

            

            //    Calculate and draw the pixel

            $color    =    imagecolorallocate($image,$r,$g,$b);

            imagesetpixel($image,$x,$height-$y,$color);

            

            //    Raise the horizontal position

            $x++;

        }

        

        //    Unset the body / free the memory

        unset($body);

        

        //    Return image-object

        return $image;

    }

?>

down

-1

php at webdecker dot de ¶

14 years ago


To get the horizontal and vertical resolution you could add some lines to the previous code of alexander. BMP stores the resolution in pixels per meter. To get it as pixels per inch (dpi) you have to multiply the value by 0.0254.

<?php
    public function imagecreatefrombmp($p_sFile)
    {
            // ...
            // ... insert after the lines where you get width and height...

            //    Get the horz. resolution in pixel per meter, 4 bytes
            $dpix = hexdec($header_parts[39]. $header_parts[38]) * 0.0254;
            
            //    Get the vert. resolution in pixel per meter, 4 bytes
            $dpiy = hexdec($header_parts[43]. $header_parts[42]) * 0.0254;

            // ... rest of the code...

            return ($image, $dpix, $dpiy);
    }           
?>

add a note