Convertir des dessins DWG en images PNG est une exigence fréquente lors de la création d’outils de visualisation basés sur le Web ou de la génération de vignettes pour les données CAD. Aspose.HTML Cloud SDK for Node.js fournit une bibliothèque puissante qui gère le rendu DWG et l’exportation d’images directement depuis vos applications Node.js. Dans ce guide, vous apprendrez le processus étape par étape, verrez un exemple complet fonctionnel, explorerez les appels cURL de l’API cloud et découvrirez des astuces de performance pour gérer efficacement les gros fichiers DWG.
Étapes de conversion DWG en PNG avec Node.JS
- Installez le SDK : Exécutez
npm install aspose-html-cloudpour ajouter la bibliothèque à votre projet. - Créez un client : Initialise la classe
HtmlApiavec votreCLIENT_IDetCLIENT_SECRET. Cela authentifie tous les appels suivants. - Fournissez la source DWG : Téléversez le fichier DWG vers le stockage Aspose ou indiquez un chemin local que le SDK peut lire.
- Lancez la conversion : Appelez
convertDocumenten définissant le format cible surPNGet transmettez les options d’image souhaitées. Consultez la référence API pour la signature complète de la méthode. - Enregistrez le PNG : L’API renvoie un flux ; redirigez-le vers un fichier sur le disque ou envoyez-le directement au client dans une réponse Express.
Exemple de conversion DWG en PNG - Exemple de code complet
L’exemple suivant montre une route Express minimale qui reçoit un fichier DWG, le convertit en PNG en utilisant Aspose.HTML Cloud SDK, et renvoie l’image à l’appelant.
// Complete working example for DWG to PNG conversion
const express = require('express');
const fileUpload = require('express-fileupload');
const { HtmlApi, ConvertDocumentRequest } = require('aspose-html-cloud');
const app = express();
app.use(fileUpload());
const clientId = 'YOUR_CLIENT_ID';
const clientSecret = 'YOUR_CLIENT_SECRET';
const htmlApi = new HtmlApi(clientId, clientSecret);
app.post('/convert', async (req, res) => {
if (!req.files || !req.files.dwgFile) {
return res.status(400).send('DWG file is required.');
}
const dwgBuffer = req.files.dwgFile.data;
// Prepare conversion request
const convertRequest = new ConvertDocumentRequest({
inputFile: dwgBuffer,
inputFormat: 'DWG',
outputFormat: 'PNG',
// Optional image options
options: {
width: 1920,
height: 1080,
backgroundColor: '#FFFFFF',
compressionLevel: 9
}
});
try {
const result = await htmlApi.convertDocument(convertRequest);
// result.body contains the PNG binary stream
res.set('Content-Type', 'image/png');
res.send(result.body);
} catch (error) {
console.error('Conversion error:', error);
res.status(500).send('Failed to convert DWG to PNG.');
}
});
app.listen(3000, () => console.log('Server listening on port 3000'));
Note : 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 (
input.pdf,output.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 de support pour obtenir de l’aide.
Conversion distante de DWG en PNG via l’API REST avec cURL
Lorsque vous préférez les appels HTTP directs, l’API cloud peut être appelée avec cURL. Voici les étapes requises.
-
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" -
Télécharger le fichier DWG (optionnel si utilisation du stockage)
curl -X PUT "https://api.aspose.cloud/v4.0/storage/file/dwgSample.dwg" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/octet-stream" \ --data-binary @dwgSample.dwg -
Demander la conversion en PNG
curl -X POST "https://api.aspose.cloud/v4.0/html/convert?format=png" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"inputPath":"dwgSample.dwg","outputPath":"output.png","options":{"width":1920,"height":1080}}' -
Télécharger le PNG résultant
curl -X GET "https://api.aspose.cloud/v4.0/storage/file/output.png" \ -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \ -o output.png
Pour une liste complète des paramètres, consultez la documentation officielle de l’API.
Installation et configuration dans Node.js
- Installez le package
npm install aspose-html-cloud - Téléchargez les binaires du SDK (si vous avez besoin de ressources locales) depuis la page de téléchargement.
- Configurez les informations d’identification - créez un compte gratuit Aspose Cloud, récupérez
CLIENT_IDetCLIENT_SECRET, et stockez-les en toute sécurité (les variables d’environnement sont recommandées). - Appliquez une licence temporaire pour les tests en utilisant la clé obtenue sur la page de licence temporaire.
Conversion de DWG en PNG dans Node.JS avec Aspose.HTML
Le SDK Cloud Aspose.HTML permet le rendu côté serveur des fichiers DWG en formats raster sans nécessiter de composants CAD natifs. La bibliothèque analyse la structure DWG, rasterise chaque mise en page et génère des images PNG haute fidélité qui conservent les épaisseurs de ligne, les couleurs et les calques. Cela la rend idéale pour les portails web, les intégrations GIS et les pipelines de génération de rapports automatisés.
Aspose.HTML Features That Matter For This Task
- Prise en charge native DWG - aucun convertisseur externe requis.
- Options raster configurables - largeur, hauteur, arrière-plan et compression.
- Sortie en streaming - gérer de gros fichiers sans charger l’image entière en mémoire.
- Intégration du stockage cloud - lire et écrire directement dans le stockage cloud d’Aspose.
Configuration de la qualité de sortie et des options d’image
Lors de la conversion de DWG en PNG, vous pouvez ajuster finement le résultat :
options: {
width: 2560, // Desired pixel width
height: 1440, // Desired pixel height
backgroundColor: '#FFFFFF',
compressionLevel: 8 // PNG compression (0‑9)
}
Les autres paramètres réglables incluent colorDepth, antiAliasing et preserveAspectRatio. Consultez la référence API pour la liste complète.
Optimisation des performances pour les gros fichiers DWG
- Utiliser le streaming - le SDK renvoie un flux lisible ; dirigez‑le directement vers un fichier ou une réponse HTTP pour éviter les pics de mémoire.
- Limiter la résolution - définissez la largeur/hauteur au minimum requis pour votre cas d’utilisation.
- Traitement par lots - traitez les fichiers séquentiellement ou avec une concurrence contrôlée afin de maintenir une utilisation stable du CPU.
- Activer la compression gzip au niveau HTTP si vous servez des PNG sur le web.
Bonnes pratiques pour la conversion DWG en PNG
- Validez l’intégrité du fichier DWG avant la conversion afin de détecter les fichiers corrompus dès le départ.
- Stockez les PNG intermédiaires dans un cache lorsque le même dessin est demandé à plusieurs reprises.
- Enregistrez la durée de conversion et surveillez les valeurs aberrantes afin d’identifier les goulets d’étranglement de performance.
- Utilisez la licence temporaire pour le développement et passez à une licence payante avant de déployer en production.
Conclusion
En tirant parti de Aspose.HTML Cloud SDK for Node.js, les développeurs peuvent mettre en œuvre une conversion fiable de DWG en PNG avec seulement quelques lignes de code. Le SDK gère le rendu intensif du CAO, tandis que l’API cloud offre un traitement évolutif et à la demande. 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 depuis la page de licence temporaire. Intégrez les extraits de code ci‑dessus, ajustez les options selon vos besoins, et vous serez prêt à fournir des aperçus PNG de haute qualité pour tout dessin DWG.
FAQ
-
Comment gérer l’authentification lors de l’utilisation du Aspose.HTML Cloud SDK pour Node.js ?
Créez une instanceHtmlApiavec votreCLIENT_IDet votreCLIENT_SECRET. Le SDK demande automatiquement et rafraîchit le jeton d’accès. Consultez la documentation officielle pour plus de détails. -
Quels formats d’image puis-je exporter en plus du PNG ?
Le SDK prend en charge JPEG, BMP, GIF, et TIFF en plus du PNG. Choisissez le format souhaité en définissant le paramètreoutputFormatdans la requête de conversion. -
Est-il possible de convertir des fichiers DWG stockés dans Azure Blob Storage ?
Oui. Fournissez l’URL complète du blob Azure en tant queinputPathet assurez‑vous que le blob est accessible publiquement ou fournissez le jeton SAS requis. La conversion fonctionne de la même manière que pour les fichiers locaux. -
Ai‑je besoin d’une licence payante pour les conversions à grande échelle ?
Pour les charges de travail en production, vous devez acheter une licence complète. Une licence temporaire suffit pour le développement et les tests, et peut être obtenue depuis la page de licence temporaire.