Proxyshop

Proxyshop est une application d'automatisation Photoshop qui génère des rendus de cartes Magic the Gathering de haute qualité. Inspiré des scripts d'automatisation Photoshop originaux de Chilli-Axe. Si vous avez besoin d'aide avec cette application ou si vous souhaitez résoudre un problème, rejoignez notre Discord !

Exigences

• Photoshop (2017-2024 pris en charge)
• Windows (actuellement incompatible avec Mac/Linux)
• Les modèles Photoshop (Peut être téléchargé dans l'application)
• Polices requises (incluses dans fonts/ ) :
  • Beleren Proxy Bold — Pour le nom de la carte, la ligne de type, la puissance/résistance
  • Proxyglyphe — Pour les symboles de mana, un fork de la police NDPMTG de Chilli
  • Plantin MT Pro — Pour le texte des règles, installez toutes les variantes incluses
  • Beleren Smallcaps — Pour ligne de crédit d'artiste et divers
  • Gotham Medium — Pour le texte du collectionneur
• Polices facultatives (mais recommandées) :
  • Magic The Gathering – Requis par le modèle Classic
  • Matrix Bold — Requis par le modèle Colorshifted
  • Mana — Pour divers symboles de cartes supplémentaires

Guide de configuration

1. Téléchargez la dernière version, extrayez-la dans un dossier de votre choix.
2. Installez les polices incluses dans le dossier fonts/ . Veuillez noter que Proxyglyph devra peut-être être mis à jour dans les versions futures.
3. Placez les arts de cartes pour les cartes que vous souhaitez restituer dans le dossier art/ . Ces arts doivent être nommés en fonction de la carte (voir Nommage des fichiers artistiques pour plus d'informations).
4. Lancez Proxyshop.exe . Cliquez sur le bouton Mettre à jour . Proxyshop chargera les modèles disponibles en téléchargement, récupérez ce que vous voulez.
5. Appuyez sur Render All pour afficher chaque illustration de carte dans le dossier art/ . Appuyez sur Render Target pour afficher un ou plusieurs arts de carte spécifiques.
6. Vous pouvez également faire glisser des images artistiques ou des dossiers contenant des images artistiques sur l'application Proxyshop, Proxyshop commencera automatiquement à restituer ces cartes.
7. Pendant le processus de rendu, la console en bas affichera la progression actuelle et vous avertira en cas d'échec.

? Dénomination des fichiers artistiques

• Les types de fichiers artistiques actuellement pris en charge sont : jpg , jpeg , jpf , png , tif et webp . REMARQUE : webp nécessite Photoshop 2022+.
• Les fichiers artistiques doivent être nommés d'après de vraies cartes Magic the Gathering et doivent être nommés aussi précisément que possible, par exemple Damnation.jpg .
• Proxyshop prend en charge plusieurs balises facultatives lors du nom de vos fichiers artistiques, pour vous donner plus de contrôle sur la façon dont la carte est rendue !
  • Set [SET] — Force Photoshop à restituer une version de cette carte à partir d'une extension MTG spécifique correspondant au code d'ensemble donné. Cette balise n'est pas sensible à la casse, donc "set" et "SET" fonctionneront.

   Damnation [TSR].jpg
  

  • Numéro de collection {num} – Fonctionne uniquement si la balise Set a également été fournie, affiche une version de cette carte avec la combinaison exacte du code défini et du numéro . Ceci est particulièrement utile dans les cas où un set comporte plusieurs versions de la même carte, par exemple Secret Lair (SLD) possède 3 versions différentes de Brainstorm .

   Brainstorm [SLD] {175}.jpg
  

  • Nom de l'artiste (Artist Name) — Lors du remplissage du nom de l'artiste, Proxyshop remplacera le nom présent dans les données Scryfall par le nom que vous fournissez. Ce changement est purement cosmétique et n'affecte pas la façon dont la carte est récupérée, ni n'entre en conflit avec d'autres balises.

   Brainstorm [SLD] {175} (Rusty Shackleford).jpg
  

  • Nom du créateur $Creator Name — Cette balise n'est pas largement prise en charge par les modèles par défaut de Proxyshop. Cette balise vous permet d'insérer votre nom préféré en tant qu'utilisateur/concepteur/créateur, et si le modèle prend en charge la fonctionnalité de nom de créateur, ce texte sera placé sur un calque de texte spécifié. Peut être utilisé comme une sorte de signature pour votre travail. REMARQUE : Cette balise DOIT être placée à la TRÈS FIN du nom du fichier artistique.

   Brainstorm [SLD] {175}$My Creator Name.jpg
  

Utilisation de l'interface graphique de Proxyshop

Onglet Cartes de rendu

• L'onglet principal pour le rendu des cartes Magic the Gathering authentiques.
• Render All : Rend une image de carte en utilisant chaque image d'art trouvée dans le dossier art/ .
• Cible de rendu : ouvre la sélection de fichier dans Photoshop, restitue une image de carte en utilisant chaque image artistique que vous sélectionnez.
• Paramètres globaux : ouvre un panneau de paramètres utilisé pour modifier les options à l'échelle de l'application pour :
  • Paramètres principaux : affecte le comportement du modèle, peut être modifié pour des modèles individuels. Lorsque vous cliquez sur l'icône à côté d'un modèle, un fichier de configuration est généré pour ce modèle qui remplace ces paramètres.
  • Paramètres système : affecte l'ensemble de l'application et ne peut pas être modifié pour des modèles individuels.
• L'ensemble d'onglets sous ces boutons représentent les types de modèles , par exemple Normal, MDFC, Transformation, etc.
  • Les types de modèles représentent différents types de modèles qui nécessitent différents éléments de cadre ou différentes techniques de rendu.
  • Si l'onglet Normal est actif et que vous cliquez sur un bouton de modèle, ce modèle est sélectionné pour le type de modèle Normal . Les cartes qui correspondent au type Normal seront désormais rendues en utilisant ce modèle.
  • Ce modèle N'EST PAS sélectionné pour d'autres types. Par exemple, si Borderless est sélectionné dans l’onglet Normal , mais que Normal est sélectionné dans l’onglet MDFC . Les cartes qui correspondent au type MDFC seront rendues en utilisant le MDFC normal .
• À côté de chaque modèle dans la liste des modèles se trouvent deux icônes :
  • Vous permet de modifier les paramètres principaux de ce modèle. Certains modèles auront également leurs propres paramètres spécialement conçus que vous pourrez également modifier.
  • ? Supprime le fichier de configuration distinct généré pour ce modèle, ramenant ainsi ce modèle aux paramètres par défaut. Garantit que les paramètres principaux de ce modèle sont régis par le panneau Paramètres globaux .
• La zone gris foncé sous le sélecteur de modèles est la console , c'est là que les messages d'état seront affichés pour suivre la progression du rendu et d'autres actions de l'utilisateur.
• À droite de la console se trouvent quelques boutons utiles :
  • ? Épingle la fenêtre Proxyshop, afin qu'elle reste au-dessus de tous les autres programmes en cours d'exécution
  • ? Prend une capture d'écran de la fenêtre Proxyshop, l'enregistre dans : out/screenshots/
  • ? Ouvre votre navigateur Web par défaut et accédez à la page GitHub de Proxyshop
  • ❔ Ouvre votre navigateur Web par défaut et accédez à notre serveur Discord communautaire
  • Continuer : devient actif lorsque l'application attend une réponse de l'utilisateur, soit lorsque l'édition manuelle est activée, soit qu'une erreur s'est produite.
  • Annuler : Devient actif lorsque les cartes sont en cours de rendu, peut annuler l'opération de rendu à tout moment ou si une erreur se produit.
  • Mise à jour : Ouvre le panneau Updater qui vous permet de télécharger de nouveaux modèles et de mettre à jour ceux existants.

Onglet Créateur personnalisé

• Cet onglet contrôle le créateur de cartes personnalisées.
• Cette fonctionnalité est actuellement considérée comme une version bêta expérimentale et peut rencontrer des problèmes.
• Vous pouvez actuellement rendre les cartes Normal , Planeswalker ou Saga , remplissez simplement les données appropriées et cliquez sur Render Custom .
• D'autres fonctionnalités et types de cartes seront ajoutés dans un avenir proche.

Onglet Outils

• Cet onglet contient une liste croissante d'outils et d'utilitaires utiles.
• Rendre toutes les vitrines : génère une image de vitrine bordée pour chaque image de carte dans le dossier out/ , les vitrines seront placées dans out/showcase/ .
• Render Target Showcase : ouvre une sélection de fichier dans Photoshop, génère une image de vitrine bordée pour chaque image de carte que vous sélectionnez.
• Compress Renders : Cet outil réduit la taille des images de carte stockées dans le dossier out/ . Les paramètres sont :
  • Qualité : Qualité de sauvegarde JPEG de l'image compressée, supporte un nombre compris entre 1 et 100. ( Recommandé : 95-99)
  • Optimiser : active l'indicateur "optimiser" automatique de Pillow. Réduit légèrement la taille du fichier sans aucun inconvénient perceptible. ( Recommandé : Activé)
  • 800 DPI : Réduit les images de carte au-dessus de 800 DPI jusqu'à un maximum de 800 DPI. La plupart des modèles Proxyshop ont une résolution de 1 200 DPI, ce qui est bien supérieur à ce dont quiconque a réellement besoin. La plupart des services d'impression n'impriment pas au-dessus de 800 DPI. ( Recommandé : Activé)

? Guide de configuration (environnement Python)

La configuration de l'environnement Python pour Proxyshop est destinée aux utilisateurs avancés, aux contributeurs et à tous ceux qui souhaitent se salir les mains en créant un plugin ou un modèle personnalisé pour l'application ! Ce guide suppose que Python est déjà installé. Voir le badge ci-dessus pour les versions Python prises en charge.

1. Installez Poetry avec pipx.

    # Install pipx and poetry
   python -m pip install --user pipx
   python -m pipx ensurepath
   pipx install poetry

2. Clonez Proxyshop quelque part sur votre système, nous appellerons cela le répertoire racine .

   git clone https://github.com/MrTeferi/Proxyshop.git

3. Accédez au répertoire racine et installez l'environnement du projet.

    cd proxyshop
   poetry install

4. Installez les polices incluses dans le dossier fonts/ . Ne les supprimez pas après l'installation, certains sont utilisés par l'interface graphique.
5. Créez un dossier appelé art dans le répertoire racine. C'est ici que vous placez les images artistiques des cartes que vous souhaitez restituer.
6. Exécutez l'application.

    # OPTION 1) Execute via poetry
   poetry run main.py
   
   # OPTION 2) Enter the poetry environment, then execute with cli
   poetry shell
   proxyshop gui

7. Reportez-vous au guide d'utilisation pour naviguer dans l'interface graphique.

? Télécharger les modèles manuellement

Si vous souhaitez télécharger les modèles manuellement, visitez ce lien. Ces archives doivent être extraites dans le répertoire /templates . Les archives trouvées dans les dossiers des lecteurs Investigamer et SilvanMTG doivent être extraites respectivement dans /plugins/Investigamer/templates et /plugins/SilvanMTG/templates .

? Comment puis-je soutenir Proxyshop ?

N'hésitez pas à rejoindre notre discord et à participer à la chaîne #Proxyshop où nous réfléchissons et testons constamment de nouvelles fonctionnalités, publions des versions bêta et partageons de nouveaux plugins et modèles. Pensez également à soutenir notre Patreon qui paie l'hébergement S3 + Cloudfront des modèles Proxyshop et nous donne la liberté de travailler sur l'application, ainsi que sur d'autres applications comme MPC Autofill, MTG Art Downloader, et plus encore ! Si Patreon n'est pas votre truc, vous pouvez aussi m'acheter un café via Paypal. Merci beaucoup à nos formidables supporters !

❓FAQ

Comment puis-je remplacer le symbole défini par autre chose ?

Dans les paramètres, remplacez « Symbole par défaut » par le code défini du symbole souhaité et activez « Forcer le symbole par défaut ». Si vous souhaitez ajouter un symbole totalement personnalisé, voici la marche à suivre :

• Rendez-vous sur src/img/symbols/ et créez un dossier nommé selon un nouveau code personnalisé.
• Ajoutez vos symboles SVG personnalisés au dossier que vous avez créé, nommez chaque fichier en fonction de la première lettre de sa rareté (en majuscule).
• Définissez ce symbole comme "Symbole par défaut" et activez "Forcer le symbole par défaut". Vous êtes prêt à partir !

Comment masquer complètement le symbole défini ?

Dans les paramètres globaux ou dans les paramètres d'un modèle spécifique, remplacez « Mode de rendu des symboles » par Aucun. Cela désactive complètement le symbole d'expansion.

Comment masquer un calque dans un modèle Proxyshop, afin qu'il n'apparaisse pas dans les cartes rendues ?

Dans le modèle Photoshop de votre choix, changez l'opacité à 0 sur le calque que vous souhaitez masquer. Vous pouvez utiliser cette méthode pour cacher n'importe quoi. C'est plus sûr que de simplement désactiver la visibilité de la couche, car les couches peuvent être activées et désactivées de force par l'application. C'est également plus sûr que de supprimer la couche, car cela peut provoquer des erreurs sur certains modèles.

Où trouver un bon endroit pour trouver de l’art MTG de haute qualité ?

Votre meilleure ressource sera MTG Pics, pour améliorer encore plus la qualité artistique, vous pouvez envisager la mise à l'échelle avec Topaz/Chainner/ESRGAN. Sur notre Discord, nous fournissons de nombreuses ressources pour apprendre à mettre à niveau l'art facilement et efficacement. Pour télécharger des œuvres d’art en masse, consultez mon autre projet : MTG Art Downloader

L'application s'arrête lorsque vous essayez de saisir du texte et Photoshop ne répond plus !

Il existe un bug connu où Photoshop plante lorsque vous essayez de saisir trop de texte dans une zone de texte. Il devrait être corrigé, mais cela pourrait théoriquement se produire sur certains modèles de plugins qui ne rendent pas la zone de texte assez grande. La meilleure façon de résoudre ce problème consiste à ouvrir le modèle dans Photoshop et à développer le bord inférieur des zones de texte des règles (créature et non-créature).

La valeur requise est manquante/le serveur RPC ne répond pas.

Cela peut parfois être l’une des erreurs les plus rares mais les plus désagréables qui se produisent sur certains systèmes. Parfois, la cause première est inconnue, mais elle peut généralement être corrigée. Essayez ces options dans l'ordre jusqu'à ce que quelque chose fonctionne :

• Assurez-vous qu’il n’y a qu’UNE SEULE installation de Photoshop sur votre ordinateur. Avoir deux versions de Photoshop installées en même temps peut empêcher l’établissement d’une connexion à l’application. Si vous en avez plusieurs installés, désinstallez toutes les versions de Photoshop et réinstallez une version. Vous devez d’abord tous les désinstaller, le simple fait d’en supprimer un ne résoudra probablement pas le problème.
• Assurez-vous que votre application Photoshop a été installée à l'aide d'un programme d'installation réel. Les installations portables de Photoshop ne fonctionnent pas avec Proxyshop, car Windows a besoin de savoir où il se trouve.
• Fermez Photoshop et Proxyshop, puis exécutez Photoshop et Proxyshop en tant qu'administrateur, essayez de restituer quelque chose.
• Fermez-les tous les deux, puis maintenez ALT + CTRL + MAJ lors du lancement de Photoshop, puis lancez Proxyshop, réessayez.
• Redémarrez votre ordinateur, puis démarrez les deux et réessayez.
• Si vous disposez d'un logiciel antivirus particulièrement trop défensif qui peut interférer avec la connexion de Proxyshop à Photoshop, tel qu'Avast, Norton, etc., fermez votre logiciel antivirus, relancez les deux et réessayez. Vous pouvez également essayer de désactiver Windows Defender.
• S'il existe un risque que votre installation de Photoshop soit endommagée, corrompue ou gâchée d'une manière ou d'une autre, il est recommandé de désinstaller complètement Photoshop et d'installer la dernière version à laquelle vous avez accès. Généralement, Proxyshop fonctionne mieux avec les versions plus récentes de Photoshop. Si vous utilisez une version authentique de Photoshop, vérifiez qu'elle est de haute qualité et qu'elle utilise un véritable programme d'installation.
• Si toutes ces solutions ne parviennent pas à résoudre le problème, veuillez rejoindre notre Discord (lien en haut) et fournir le journal des erreurs de logs/error.txt dans votre répertoire Proxyshop, afin que nous puissions vous aider à trouver la cause :)

Le coût en mana, les règles ou tout autre texte est énorme et ne diminue pas ?

• Dans Photoshop, allez dans Édition > Préférences > Unités et règles .
• Définir les règles sur les pixels
• Définir le type sur Points
• Le problème devrait être résolu.

Photoshop est occupé !

Cette erreur se produit lorsque Photoshop ne répond pas aux commandes car il est occupé. Pour éviter cette erreur, vous devez vous assurer que Photoshop est dans un état neutre lorsque vous exécutez Proxyshop ou effectuez le rendu d'une carte :

• Aucune boîte de dialogue ou menu de paramètres ne doit être ouvert dans Photoshop. Les panneaux d’outils normaux conviennent.
• Il ne devrait y avoir aucun outil effectuant des tâches, par exemple mettre du texte en surbrillance pour l'éditer avec l'outil Texte.
• Idéalement, Photoshop devrait être lancé à nouveau, sans aucun document ouvert.

J'obtiens une autre erreur !

Dans le répertoire de votre proxyshop, recherchez un dossier nommé logs , à l'intérieur de ce dossier, vous devriez voir error.txt , vérifiez le dernier journal des erreurs dans ce fichier. Si l'erreur n'est pas évidente, rejoignez notre Discord et n'hésitez pas à demander de l'aide sur le canal #Proxyshop.

Crédits

• Nos incroyables supporters Patreon qui font littéralement avancer ce projet.
• Chilli Axe pour son projet exceptionnel MTG Photoshop Automation dont Proxyshop s'est inspiré et pour avoir produit de nombreux modèles PSD de base qui ont été modifiés pour fonctionner avec Proxyshop.
• Prise en charge supplémentaire des modèles et des actifs de :
  • SilvanMTG
  • Nélynes
  • Les Trix sont pour Scoot
  • FeuerAmeise
  • michayggdrasil
  • Warpdandy
  • MâleMPC
  • Vittorio Masía
  • iDerp
  • Tupinamba (Pedro Neves)
• Andrew Gioia pour ses différents projets de polices qui ont été utiles à Proxyshop dans le passé.
• John Prime, Haven King et les membres du CCGHQ pour avoir fourni les symboles d'extension SVG.
• Hal et les autres contributeurs de l'API Photoshop Python.
• Wizards of the Coast et tous les artistes talentueux qui font de Magic the Gathering une réalité.
• D'innombrables autres personnes qui ont fourni de l'aide et d'autres atouts à la communauté qui ont rendu diverses fonctionnalités possibles.
• Tous les contributeurs à la base de code.