imagecreatefromwbmp

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

imagecreatefromwbmp — Cria uma nova imagem a partir de um arquivo ou URL

Descrição

imagecreatefromwbmp(string $filename): GdImage|false

imagecreatefromwbmp() retorna um identificador de imagem representando a imagem obtida a partir do arquivo informado.

Nota: Imagen WBMP é um Bitmap "Wireless", e não um Bitmap do Windows. Este último pode ser carregado com imagecreatefrombmp().

Dica

Uma URL pode ser usada como um nome de arquivo com esta função se os wrappers fopen estiverem habilitados. Consulte a função fopen() para mais detalhes sobre como especificar o nome do arquivo. Consulte os Protocolos e Wrappers suportados para obter links para informações sobre as capacidades de cada wrapper, notas de uso e informações sobre quaisquer variáveis predefinidas que eles possam fornecer.

Parâmetros

filename: Caminho para a imagem WBMP.

Valor Retornado

Retorna um objeto de imagem em caso de sucesso, false em caso de erros.

Registro de Alterações

Versão	Descrição
8.0.0	Em caso de sucesso, esta função agora retorna um objeto GDImage; anteriormente, um resource era retornado.

Exemplos

Exemplo #1 Examplo de gerenciamento de erro ao carregar um WBMP

<?php
function LoadWBMP($imgname)
{
    /* Tenta abrir */
    $im = @imagecreatefromwbmp($imgname);

    /* Vê se falhou */
    if(!$im)
    {
        /* Cria uma imagem vazia */
        $im  = imagecreatetruecolor(150, 30);
        $bgc = imagecolorallocate($im, 255, 255, 255);
        $tc  = imagecolorallocate($im, 0, 0, 0);

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

        /* Mostra mensagem de erro */
        imagestring($im, 1, 5, 5, 'Error loading ' . $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