SolidView

Package Python pour la visualisation 3D d'objets SolidPython2 dans Jupyter notebooks

v0.1.0 Python 3.8+ MIT License

Installer maintenant Voir les exemples

Fonctionnalités

Intégration Facile

API simple pour visualiser les objets SolidPython2 en quelques lignes de code.

Multi-plateforme

Détection automatique d'OpenSCAD sur Windows, macOS et Linux.

Visualisation Interactive

Export STL

Fonctionnalité intégrée pour sauvegarder les objets au format STL.

Nettoyage Intelligent

Gestion automatique des fichiers temporaires.

Personnalisable

Dimensions du viewer et options de rendu configurables.

Installation

Prérequis

Assurez-vous d'avoir OpenSCAD installé sur votre système avant d'utiliser SolidView.

Installation via pip

Terminal

                            pip install solidview

Exemples d'utilisation

basic_usage.py

                            from solid2 import *
from solidview import view3d

# Créer un objet simple
cube_obj = cube([10, 10, 10])
sphere_obj = sphere(8)
combined = cube_obj + translate([15, 0, 0])(sphere_obj)

# Visualiser dans Jupyter
view3d(combined, width=600, height=400)
                        

advanced_usage.py

                            from solidview import SolidViewer
from solid2 import *

# Créer une instance de viewer (plus efficace pour plusieurs objets)
viewer = SolidViewer()

# Créer et visualiser plusieurs objets
for i in range(3):
    obj = translate([i * 20, 0, 0])(
        rotate([0, 0, i * 45])(
            cube([10, 5, 8])
        )
    )
    viewer.view(obj, width=400, height=300)
                        

stl_export.py

                            from solidview import SolidViewer
from solid2 import *

# Créer un viewer
viewer = SolidViewer()

# Créer un objet complexe
base = cube([30, 30, 5])
post = translate([15, 15, 5])(cylinder(r=3, h=20))
hole = translate([15, 15, -1])(cylinder(r=1, h=27))
final_object = base + post - hole

# Visualiser
viewer.view(final_object)

# Sauvegarder en STL
viewer.save_stl(final_object, "mon_objet.stl")
                        

Référence API

`view3d(obj, width=600, height=600, openscad_exec=None)`

Fonction de commodité pour la visualisation rapide d'objets 3D.

obj

Objet SolidPython2 à rendre

width

Largeur du viewer en pixels (défaut: 600)

height

Hauteur du viewer en pixels (défaut: 600)

openscad_exec

Chemin vers l'exécutable OpenSCAD (optionnel)

`SolidViewer`

Classe principale pour la visualisation d'objets 3D avec gestion avancée.

`init(openscad_exec=None)`

Initialise une instance SolidViewer.

`view(obj, width=600, height=600, cleanup=True)`

Rend et affiche un objet 3D.

`save_stl(obj, output_path, overwrite=False)`

Rend un objet et le sauvegarde au format STL.

obj

Objet SolidPython2 à rendre

output_path

Chemin de sortie pour le fichier STL

overwrite

Écraser les fichiers existants (défaut: False)