La conversion de dessins CAO en images compatibles avec le Web est un besoin fréquent lors de l’intégration de données d’ingénierie dans des applications modernes. Aspose.HTML Cloud SDK for Python fournit une bibliothèque puissante qui simplifie la conversion de DWG vers PNG en Python. Ce guide vous accompagne dans l’installation de la bibliothèque, la configuration de l’authentification, l’exécution d’un exemple complet de code, l’utilisation de cURL pour la conversion REST, et l’application de conseils de performance pour les gros fichiers CAO.

Étapes de la conversion DWG en PNG avec Python

  1. Configurer l’authentification de l’API : définissez vos identifiants client dans l’objet Configuration.
config = Configuration()
config.api_key['client_id'] = 'YOUR_CLIENT_ID'
config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'
  1. Initialiser le client API : créez une instance ApiClient et une instance HtmlApi.
api_client = ApiClient(config)
html_api = HtmlApi(api_client)
  1. Charger le fichier DWG : lisez le fichier DWG source dans un tableau d’octets.
with open('sample.dwg', 'rb') as f:
    dwg_data = f.read()
  1. Convertir le DWG en PNG : appelez convert_document avec format='png'.
png_bytes = html_api.convert_document(dwg_data, format='png')
  1. Enregistrer la sortie PNG : écrivez les octets retournés dans un fichier PNG.
with open('sample.png', 'wb') as out_file:
    out_file.write(png_bytes)

Pour une référence API détaillée, voir la documentation de la classe HtmlApi.

Conversion de DWG en PNG avec Aspose.HTML Cloud SDK for Python - Exemple de code complet

L’exemple suivant montre l’ensemble du flux de travail, de l’authentification à l’enregistrement du résultat PNG.

import asposehtmlcloud
from asposehtmlcloud.rest import ApiException
from asposehtmlcloud import Configuration, HtmlApi, ApiClient

def main():
    # Configure API authentication (replace with your actual credentials)
    config = Configuration()
    config.api_key['client_id'] = 'YOUR_CLIENT_ID'
    config.api_key['client_secret'] = 'YOUR_CLIENT_SECRET'

# Initialise the API client
    api_client = ApiClient(config)
    html_api = HtmlApi(api_client)

# Input DWG file and desired PNG output file
    input_path = 'sample.dwg'
    output_path = 'sample.png'

# Read the DWG file into memory
    with open(input_path, 'rb') as f:
        dwg_data = f.read()

try:
        # Perform the conversion: DWG -> PNG
        png_bytes = html_api.convert_document(dwg_data, format='png')
        # Write the resulting PNG to disk
        with open(output_path, 'wb') as out_file:
            out_file.write(png_bytes)
        print(f'Conversion succeeded, PNG saved to: {output_path}')
    except ApiException as e:
        print(f'Conversion failed: {e}')

if __name__ == '__main__':
    main()

Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez‑vous de mettre à jour tous les chemins de fichiers et les valeurs de configuration pour qu’ils correspondent à votre environnement réel, vérifiez que toutes les dépendances requises sont correctement installées et testez soigneusement dans votre environnement de développement. Si vous rencontrez des problèmes, veuillez consulter la documentation officielle ou contacter l’équipe de support pour obtenir de l’aide.

Conversion DWG en PNG via API REST avec cURL

Vous pouvez obtenir le même résultat sans écrire de code Python en appelant directement les points de terminaison REST d’Aspose.HTML Cloud.

  1. Obtenir un jeton d’accès
curl -X POST "https://api.aspose.cloud/connect/token" \
     -d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
  1. Téléverser le fichier DWG
curl -X POST "https://api.aspose.cloud/v4.0/html/upload" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.dwg"
  1. Demander la conversion en PNG
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -F "file=@sample.dwg"
  1. Télécharger le résultat PNG
curl -X GET "https://api.aspose.cloud/v4.0/html/download/sample.png" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o sample.png

Pour une liste complète des paramètres, consultez la référence API.

Aspose.HTML Cloud SDK - Prérequis et configuration

La bibliothèque est distribuée via PyPI. Installez‑la avec pip et assurez‑vous de disposer d’un compte Aspose Cloud valide.

pip install asposehtmlcloud

Vous devez également télécharger le dernier package client si vous préférez une installation manuelle :

curl -L -o asposehtmlcloud.zip https://releases.aspose.cloud/html/python/

Assurez-vous que Python 3.7+ est installé et que votre client_id et client_secret sont obtenus depuis le tableau de bord Aspose Cloud.

Considérations de performance pour les gros fichiers DWG

  • Flux au lieu de charger le fichier entier : Pour les fichiers DWG très volumineux, lisez le fichier par morceaux et transmettez un flux à convert_document afin de réduire la pression sur la mémoire.
  • Ajuster la résolution de sortie : Utilisez format='png' avec des paramètres de requête supplémentaires (par ex., dpi=150) pour équilibrer qualité et taille.
  • Traitement par lots de plusieurs conversions : Si vous devez convertir de nombreux fichiers, réutilisez la même instance HtmlApi pour éviter le surcoût d’authentification répété.
  • Exécution parallèle : Exécutez les conversions dans des threads ou processus séparés lorsque les ressources CPU le permettent, mais surveillez l’utilisation de la mémoire pour éviter l’épuisement.

Conclusion

La conversion DWG vers PNG en Python devient simple avec le Aspose.HTML Cloud SDK for Python. En suivant les étapes, l’exemple de code et les commandes cURL présentés ici, vous pouvez intégrer la conversion CAD‑vers‑image dans n’importe quel flux de travail basé sur Python. N’oubliez pas d’obtenir une licence appropriée pour une utilisation en production ; les détails de tarification sont disponibles sur la page du produit, et une licence temporaire peut être obtenue via la page de licence temporaire. Bon codage !

FAQ

  • Comment effectuer une conversion DWG en PNG en Python en utilisant l’Aspose.HTML Cloud SDK for Python ?
    Utilisez la méthode convert_document avec format='png' après avoir configuré l’authentification. L’exemple complet de code dans cet article montre les étapes exactes.

  • Quelle méthode d’authentification le Aspose.HTML Cloud SDK for Python nécessite-t-il pour la conversion DWG en PNG ?
    La bibliothèque utilise les informations d’identification client OAuth2. Définissez client_id et client_secret dans l’objet Configuration avant de créer le client HtmlApi.

  • Puis-je convertir de gros fichiers DWG en images PNG haute résolution efficacement ?
    Oui. Diffusez le fichier, ajustez les paramètres DPI et réutilisez le client API pour le traitement par lots. Consultez la section Considérations de performance pour des conseils détaillés.

  • Existe-t-il un point de terminaison REST pour la conversion DWG en PNG que je peux appeler avec cURL ?
    Absolument. La section Commandes cURL fournit les appels exacts pour obtenir un jeton d’accès, télécharger le DWG, demander la conversion et télécharger le résultat PNG.

En savoir plus