Que représente la fonction ImageColorClosesthWB -1? Quelles sont les raisons courantes de ce résultat lors de l'analyse?

gitbox 2025-09-03

<span><span><span class="hljs-meta"><?php</span></span><span>
</span><span><span class="hljs-comment">// Ce code n&#39;a rien à voir avec le contenu de l&#39;article，Pour l&#39;espace réservé uniquement</span></span><span>
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Exemples de contenu non lié avant le début de cet article。\n"</span></span><span>;
</span><span><span class="hljs-meta">?></span></span><span>
<hr>

<h1>imagecolorclosesthwb Renvoie la fonction -</span><span><span class="hljs-number">1</span></span><span> Qu&#39;est-ce que ça veut dire？Quelles sont les causes communes de ce résultat?？</h1>

<p>exister PHP milieu，<code>imagecolorclosesthwb

Il renvoie l'index de couleur dans la palette la plus proche de la couleur RVB spécifiée. Normalement, un entier non négatif est renvoyé, représentant l'indice de couleur. Mais lorsque la fonction renvoie -1 , cela signifie qu'aucun indice de couleur approprié n'a été trouvé.

ImageColorClosesthwb Retour - Que signifie 1 ?
Le rendement -1 indique que l'exécution de la fonction a échoué et que toute couleur correspondant à la couleur d'entrée n'a pas été trouvée dans la palette d'images spécifiée. Cela se produit généralement dans les situations suivantes:
L' image de ressource entrante n'est pas une ressource d'image de palette valide.
L'image elle-même n'a pas de palette (comme une véritable image couleur), et cette fonction ne s'applique qu'aux images de palette.
La valeur RVB d'entrée n'est pas dans la plage autorisée ( 0 - 255 ), ce qui fait échouer la correspondance interne.
Il y a un problème avec la version de la bibliothèque GD ou l'environnement PHP, provoquant l'exécution des exceptions de la fonction.

Analyse des causes communes qui provoquent le retour d'imageColorClosesthwb - 1
Les images ne sont pas des images de palette La fonction ImageColorClosesthwb ne peut être utilisée que sur les images de palette. Si l'image est une image TrueColor, la fonction ne fonctionne pas correctement et revient souvent - 1 . La solution consiste à s'assurer de créer une image de palette avec ImageCreate () , ou de convertir la véritable image couleur en image de palette avant de l'appeler.
Ressources d'image non valides Si l' image $ entrante n'est pas une ressource d'image GD légale ou que la ressource a été détruite, la fonction reviendra également - 1 . Il est nécessaire de vérifier si la ressource d'image est valide et est initialisée correctement.
Paramètres RVB hors de portée Les valeurs adoptées dans $ Red , $ Green , $ Blue doivent être comprises entre 0 et 255. La portée peut entraîner l'échec de la correspondance interne, retour - 1 . Il est recommandé de vérifier la validité de la valeur d'entrée avant d'appeler.
La palette d'images est vide ou incolore Si la palette d'images n'a pas de couleur (très rare mais possible), la fonction ne trouvera pas de couleur correspondante, retour - 1 .
Problèmes de bibliothèque GD ou de version PHP Certaines anciennes versions des bibliothèques GD ou des environnements PHP peuvent avoir des bogues, ce qui fait revenir les exceptions de la fonction. Il est recommandé de mettre à niveau les bibliothèques PHP et GD vers la dernière version stable.

Exemple de code

 &lt;?php
</span><span><span class="hljs-comment">// Créer une image de palette</span></span><span>
</span><span><span class="hljs-variable">$image</span></span><span> = </span><span><span class="hljs-title function_ invoke__">imagecreate</span></span><span>(</span><span><span class="hljs-number">100</span></span><span>, </span><span><span class="hljs-number">100</span></span><span>);

</span><span><span class="hljs-comment">// Attribuer plusieurs couleurs</span></span><span>
</span><span><span class="hljs-variable">$red</span></span><span> = </span><span><span class="hljs-title function_ invoke__">imagecolorallocate</span></span><span>(</span><span><span class="hljs-variable">$image</span></span><span>, </span><span><span class="hljs-number">255</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>);
</span><span><span class="hljs-variable">$green</span></span><span> = </span><span><span class="hljs-title function_ invoke__">imagecolorallocate</span></span><span>(</span><span><span class="hljs-variable">$image</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>, </span><span><span class="hljs-number">255</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>);

</span><span><span class="hljs-comment">// Essayez de trouver la couleur la plus proche</span></span><span>
</span><span><span class="hljs-variable">$index</span></span><span> = </span><span><span class="hljs-title function_ invoke__">imagecolorclosesthwb</span></span><span>(</span><span><span class="hljs-variable">$image</span></span><span>, </span><span><span class="hljs-number">254</span></span><span>, </span><span><span class="hljs-number">10</span></span><span>, </span><span><span class="hljs-number">10</span></span><span>);

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$index</span></span><span> === -</span><span><span class="hljs-number">1</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"Aucune couleur correspondante trouvée，Renvoie la fonction -1。\n"</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">"L&#39;indice de couleur trouvé est: <span class="hljs-subst">$index</span></span></span><span>\n";
}
?&gt;

Résumer

Lorsque ImageColorClosesthWB renvoie -1 , cela signifie qu'aucun index de couleur approprié n'est trouvé, la raison la plus courante est que l'image n'est pas une image de palette ou que la ressource d'image n'est pas valide. Ces problèmes sont généralement évités en confirmant le type d'image, la plage de paramètres d'entrée et la version de l'environnement.

Connexe