La conversion des fichiers DWG en images PNG est une exigence fréquente pour les applications .NET qui doivent afficher des dessins techniques sur le web ou dans des rapports. Aspose.CAD Cloud SDK for .NET fournit une API robuste qui prend en charge le rendu CAD dans le cloud. Ce guide vous accompagne à travers l’ensemble du processus, depuis l’installation du SDK jusqu’à l’écriture d’un exemple complet en C#, la configuration des options de conversion, la gestion des erreurs et l’utilisation de cURL pour des appels REST directs.
Installation et configuration en .NET
Pour commencer à utiliser le SDK, vous avez besoin de :
- Exigences du système: .NET 6.0 ou version ultérieure, accès Internet pour les appels cloud.
- Installation du package: Exécutez la commande suivante dans le répertoire de votre projet :
dotnet add package Aspose.CAD-Cloud
- Télécharger le SDK : Obtenez les dernières binaires depuis cette page.
- Authentification : Créez un ID client et un secret client Aspose Cloud depuis votre tableau de bord Aspose. Conservez-les en toute sécurité, par exemple dans appsettings.json ou dans des variables d’environnement.
var clientId = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_ID");
var clientSecret = Environment.GetEnvironmentVariable("ASPOSE_CLIENT_SECRET");
Principales fonctionnalités d’Aspose.CAD Cloud SDK pour .NET
- Prise en charge d’un large éventail de formats : Convertissez DWG, DXF, DWF et de nombreux autres formats CAD en PNG, JPEG, PDF et plus encore.
- Rasterisation de haute qualité : Conservez les épaisseurs de ligne, les calques et les couleurs avec une résolution DPI configurable.
- Traitement basé sur le cloud : Déchargez le rendu intensif vers les serveurs Aspose, réduisant la consommation de ressources locales.
- Conversion par lots : Traitez plusieurs fichiers en un seul appel d’API en utilisant des modèles asynchrones.
- Documentation exhaustive : La référence complète de l’API est disponible sur la référence officielle de l’API.
Configuration des options de conversion de DWG en PNG
Vous pouvez contrôler l’image de sortie en définissant les options suivantes dans le corps de la requête :
| Option | Description |
|---|---|
width |
Largeur cible de l’image en pixels. |
height |
Hauteur cible de l’image en pixels. |
dpi |
Points par pouce pour la rasterisation (par défaut 300). |
backgroundColor |
Couleur hexadécimale pour l’arrière-plan, par ex., #FFFFFF. |
layerVisibility |
Liste des noms de calques à inclure ou exclure. |
Exemple de charge utile JSON :
{
"outputFormat": "png",
"width": 1024,
"height": 768,
"dpi": 300,
"backgroundColor": "#FFFFFF"
}
Optimisation des performances et de l’utilisation de la mémoire
- Utiliser les appels asynchrones : Le SDK prend en charge les méthodes async qui libèrent le thread pendant l’attente de la réponse du cloud.
- Ajuster le DPI : Un DPI plus élevé améliore la qualité mais augmente la taille du payload. Choisissez le DPI le plus bas qui satisfait les exigences visuelles.
- Réutiliser HttpClient : Créez une seule instance
HttpClientpour toutes les requêtes de conversion afin de profiter du pool de connexions.
Gestion des erreurs et dépannage des problèmes de conversion
Voici une référence rapide des codes d’état HTTP courants renvoyés par le point de terminaison de conversion :
| Code d’état | Signification | Action suggérée |
|---|---|---|
| 400 | Mauvaise requête - paramètres invalides | Vérifiez la charge JSON et le format du fichier. |
| 401 | Non autorisé - informations d’identification invalides | Vérifiez l’ID client/le secret et la génération du jeton. |
| 404 | Fichier non trouvé - source DWG manquante | Assurez-vous que le fichier a été téléchargé au bon chemin. |
| 500 | Erreur interne du serveur | Réessayez après un court délai ; contactez le support si le problème persiste. |
Étapes pour convertir DWG en PNG avec .NET
- Créer le client API - Initialisez la classe
CadApiavec vos identifiants.var api = new Aspose.CAD.Cloud.Sdk.Api.CadApi(clientId, clientSecret); - Télécharger le fichier DWG - Utilisez la méthode
UploadFilepour placer le fichier source dans le stockage cloud.api.UploadFile("input.dwg", File.ReadAllBytes("local/path/input.dwg")); - Préparer les options de conversion - Créez un objet JSON avec les paramètres PNG souhaités (voir le tableau ci‑dessus).
- Appeler le point de terminaison de conversion - Appelez
Convertavec le chemin source, le format cible et les options.var result = api.Convert("input.dwg", "png", conversionOptions); - Télécharger le résultat PNG - Récupérez les données binaires et enregistrez‑les localement.
File.WriteAllBytes("output.png", result);
Pour plus de détails sur chaque méthode, consultez la référence API.
Conversion DWG en PNG - Exemple de code complet
Le programme suivant montre une conversion complète de bout en bout, incluant la gestion des erreurs et le nettoyage des ressources.
Remarque : Cet exemple de code démontre la fonctionnalité principale. Avant de l’utiliser dans votre projet, assurez-vous de mettre à jour les chemins de fichiers (
sample.dwg,sample.png, etc.) pour qu’ils correspondent à vos emplacements réels, 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 d’assistance pour obtenir de l’aide.
Conversion DWG basée sur le cloud via l’API REST avec cURL
Vous pouvez obtenir le même résultat sans écrire de code C# en appelant directement les points de terminaison REST d’Aspose.CAD Cloud.
1. Obtenir un jeton d’accès
curl -X POST "https://api.aspose.cloud/connect/token" \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials&client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET"
2. Télécharger le fichier DWG
curl -X PUT "https://api.aspose.cloud/v3.0/storage/file/inputs/sample.dwg" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/octet-stream" \
--data-binary "@sample.dwg"
3. Demande de conversion en PNG
curl -X POST "https://api.aspose.cloud/v3.0/cad/convert" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"inputPath": "inputs/sample.dwg",
"outputPath": "outputs/sample.png",
"format": "png",
"options": {
"width": 1024,
"height": 768,
"dpi": 300,
"backgroundColor": "#FFFFFF"
}
}'
4. Télécharger le PNG converti
curl -X GET "https://api.aspose.cloud/v3.0/storage/file/outputs/sample.png" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-o "sample.png"
Pour une liste complète des paramètres et des exemples supplémentaires, consultez la documentation officielle de l’API.
Conclusion
La conversion de DWG en PNG sous .NET est simple lorsque vous exploitez la puissance du Aspose.CAD Cloud SDK for .NET. Le SDK gère le téléchargement du fichier, la conversion et le téléchargement tout en offrant un contrôle fin de la qualité d’image et des performances. N’oubliez pas d’obtenir une licence valide pour une utilisation en production ; vous pouvez obtenir une licence temporaire depuis la page de licence temporaire et explorer les options de tarification sur le site Web d’Aspose. Avec l’exemple de code fourni et les commandes cURL, vous êtes prêt à intégrer la conversion DWG‑vers‑PNG dans n’importe quelle application .NET.
FAQ
Q : Est-il possible de convertir un fichier DWG en PNG sans écrire de code ?
A : Oui, vous pouvez utiliser directement l’API REST avec des outils tels que cURL ou Postman. Les étapes sont décrites dans la section "Cloud-Based DWG Conversion via REST API using cURL", et la référence de l’API fournit tous les paramètres requis.
Q: Comment gérer les gros fichiers DWG pour éviter les problèmes de mémoire ?
A: Utilisez les méthodes asynchrones présentées dans l’exemple de code et définissez un DPI raisonnable (par ex., 150-300). Le SDK diffuse les données vers le cloud, minimisant la consommation de mémoire locale.
Q: Que se passe-t-il si la conversion échoue avec une erreur 400 ?
A: Une erreur 400 indique généralement une charge utile de requête invalide. Vérifiez que vos options JSON correspondent au schéma décrit dans la section “Configuring Conversion Options for DWG to PNG” et que le fichier source existe dans le chemin cloud spécifié.
Q: Puis-je convertir plusieurs fichiers DWG en PNG dans une opération par lots unique ?
A: Bien que l’API traite un fichier par requête, vous pouvez écrire un script qui boucle sur chaque DWG, télécharge le fichier, déclenche la conversion et télécharge le PNG de façon asynchrone. Cette approche maximise le débit et maintient l’implémentation simple.