Edit Report a Bug

    imagesavealpha

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

    imagesavealpha — Détermine si les informations complètes du canal alpha doivent être conservées lors de la sauvegardes d'images

    Description

    imagesavealpha(GdImage $image, bool $enable): bool

    imagesavealpha() définit le drapeau qui détermine si les informations du canal alpha (en opposition à la transparence à couleur unique) doivent être conservées lors de la sauvegarde d'images. Cela est supporte seulement pour les formats d'images qui supportent la totalité des informations de chaines alpha, par exemple PNG, WebP et AVIF.

    Note: imagesavealpha() est seulement significatif pour les images PNG, comme les chaînes alpha pleines sont toujours sauvegardées pour WebP et AVIF. Il n'est pas recommendé de se reposer sur ce comportement, cela pourrait changer dans le futur. Donc, imagesavealpha() devrait être appelé intentionellement aussi pour les images WebP et AVIF.

    Le alphablending doit être désactivé (imagealphablending($im, false)) pour conserver le canal alpha en premier lieu.

    Liste de paramètres

    image

    Un objet GdImage, retournée par une des fonctions de création d'images, comme imagecreatetruecolor().

    enable

    Si l'on doit ou non sauvegarder le canal alpha. Par défaut false.

    Valeurs de retour

    Cette fonction retourne true en cas de succès ou false si une erreur survient.

    Historique

    Version Description
    8.0.0 image attend une instance de GdImage désormais; auparavant, une resource gd était attendue.

    Exemples

    Exemple #1 Utilisation simple de imagesavealpha()

    <?php
    // Charge une image PNG avec un canal alpha
    $png = imagecreatefrompng('./alphachannel_example.png');

    // Désactiver le alpha blending
    imagealphablending($png, false);

    // Faire les opérations désirées

    // Définir le drapeau alpha
    imagesavealpha($png, true);

    // Affiche l'image au navigateur
    header('Content-Type: image/png');

    imagepng($png);
    imagedestroy($png);
    ?>

    Voir aussi

    add a note add a note

    User Contributed Notes 2 notes

    up
    19
    ray hatfield
    13 years ago
    After much trial and error and gnashing of teeth I finally figured out how to composite a png with an 8-bit alpha onto a jpg. This was not obvious to me so I thought I'd share. Hope it helps.

    I'm using this to create a framed thumbnail image:

    <?php
    // load the frame image (png with 8-bit transparency)
    $frame = imagecreatefrompng('path/to/frame.png');

    // load the thumbnail image
    $thumb = imagecreatefromjpeg('path/to/thumbnail.jpg');

    // get the dimensions of the frame, which we'll also be using for the
    // composited final image.
    $width = imagesx( $frame );
    $height = imagesy( $frame );

    // create the destination/output image.
    $img=imagecreatetruecolor( $width, $height );

    // enable alpha blending on the destination image.
    imagealphablending($img, true);

    // Allocate a transparent color and fill the new image with it.
    // Without this the image will have a black background instead of being transparent.
    $transparent = imagecolorallocatealpha( $img, 0, 0, 0, 127 );
    imagefill( $img, 0, 0, $transparent );

    // copy the thumbnail into the output image.
    imagecopyresampled($img,$thumb,32,30,0,0, 130, 100, imagesx( $thumb ), imagesy( $thumb ) );

    // copy the frame into the output image (layered on top of the thumbnail)
    imagecopyresampled($img,$frame,0,0,0,0, $width,$height,$width,$height);

    imagealphablending($img, false);

    // save the alpha
    imagesavealpha($img,true);

    // emit the image
    header('Content-type: image/png');
    imagepng( $img );

    // dispose
    imagedestroy($img);

    // done.
    exit;
    ?>
    up
    -1
    phil at unabacus dot net
    16 years ago
    The comment left by "doggz at mindless dot com" will cause a duplication in layering of the transparent image - AlphaImageLoader loads the image as if it were a floating layer on top of the <img> element - so your image will double up.. so don't go thinking something very strange is happening with your PHP it's the silly browser ;)

    The easiest (although not the best) way to get around this is to use the CSS background property instead of an image src - because as of yet you can't change an image's src dynamically using currently supported CSS:

    <div style="width:200px; height:200px; background: url(my-trans-image.php); *background:url(); *filter:progid:
    DXImageTransform.Microsoft.AlphaImageLoader(src='my-trans-image.php', sizingMethod='scale');"></div>

    The above (although not pretty) keeps the image loaded as a background for any good browser as they should ignore the starred (*) CSS items and should support Alpha PNGs natively. IE will listen to the starred items and blank out the background whilst applying it's AlphaLoader on top. Obviously you need to know the width and height of your image but you can get this using getimagesize() or just by hardcoding.

    Downsides to know:

    1. Unless the user has 'backgrounds enabled when printing' your image wont show up when the webpage is printed.

    2. You can't stretch or shrink a background image - if you change the div's dimensions from that of the image you will stretch it in IE (due to the 'scale' property - which you can change for sake of standardness to 'crop') but you will crop it in any other browser.

    3. Most browsers treat images and backgrounds differently, in load priority and in the way the user can interact with them.

    Other Options:

    Other methods resort to using JavaScript or Browser Detection on the Server Side.
    add a note add a note
    To Top