Clarify the difference between ImageMagick::setColorspace() and ImageMagick::setImageColorspace()

Ouverte
#25 0 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Personne n'a encore pris cette issue.

Évaluation

Difficulté
3/5
Temps estimé
1-2 jours
Accessibilité débutants
35/100
Type d'issue
Documentation
Clarté
Plutôt claire
Activité
À l'abandon
Stack technique
php
Domaine
documentation

Piste de recherche

Commencez par comparer les pages du manuel de Imagick::setColorspace() et Imagick::setImageColorspace(), puis lisez la page liée de Imagick::transformImageColorspace() et le comportement sous-jacent de l’extension. Clarifiez la distinction ou documentez explicitement une relation d’alias sur les deux pages, et ajoutez des exemples montrant quand chaque méthode doit être utilisée.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

From manual page: https://php.net/imagick.setimagecolorspace


By reading
https://www.php.net/manual/en/imagick.setcolorspace.php and
https://www.php.net/manual/en/imagick.setimagecolorspace.php

I honestly can't tell the differene between the two, when I should use one and when the other.
There's no example for either of them. (BTW there shoudl ALWAYS be examples, every single page of the documentation should have examples)

The descriptions are slightly different:

public Imagick::setColorspace(int $COLORSPACE): bool
Sets the global colorspace value for the object.

vs

public Imagick::setImageColorspace(int $colorspace): bool
Sets the image colorspace. This method should be used when creating new images. To change the colorspace of an existing image, you should use Imagick::transformImageColorspace().

but it's not clear what the difference is between the "global workspace for the object" and "the image colorspace".

This difference should be clarified in both pages. Or if they are actually the same thing, it should be explicitly stated that one is an alias for the other.

Langage dominant
XML
Étoiles
4
Forks
8
Merge moyen
1 j 5 h
PR mergées (30 j)
4

Préparer son environnement

Ouvrir dans Codespaces

Lance le conteneur de développement du projet dans votre navigateur, avec votre propre compte GitHub.

  • Aucun Dockerfile ni fichier Docker Compose
  • Aucun modèle de pull request
  • Aucun guide de contribution

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de php/doc-extensions

Toutes les issues de php/doc-extensions

Issues similaires

Plus d'issues Documentation

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.