2014-01-06 17:29:10 +00:00
# ifndef slic3r_Model_hpp_
# define slic3r_Model_hpp_
2015-12-07 23:39:54 +00:00
# include "libslic3r.h"
2014-04-29 23:04:49 +00:00
# include "PrintConfig.hpp"
2014-01-06 17:29:10 +00:00
# include "Layer.hpp"
# include "Point.hpp"
# include "TriangleMesh.hpp"
2016-12-08 18:02:16 +00:00
# include "Slicing.hpp"
2014-01-06 17:29:10 +00:00
# include <map>
# include <string>
# include <utility>
# include <vector>
2018-10-31 13:56:51 +00:00
# include "Geometry.hpp"
2019-02-01 15:12:00 +00:00
# include <libslic3r/SLA/SLACommon.hpp>
2014-01-06 17:29:10 +00:00
namespace Slic3r {
2017-06-13 10:09:49 +00:00
class Model ;
2014-01-06 17:29:10 +00:00
class ModelInstance ;
class ModelMaterial ;
class ModelObject ;
class ModelVolume ;
2018-10-17 09:12:38 +00:00
class Print ;
2018-11-21 16:35:35 +00:00
class SLAPrint ;
2014-01-06 17:29:10 +00:00
typedef std : : string t_model_material_id ;
typedef std : : string t_model_material_attribute ;
2018-11-02 13:47:13 +00:00
typedef std : : map < t_model_material_attribute , std : : string > t_model_material_attributes ;
2014-01-06 17:29:10 +00:00
2018-11-02 13:47:13 +00:00
typedef std : : map < t_model_material_id , ModelMaterial * > ModelMaterialMap ;
2014-04-29 23:04:49 +00:00
typedef std : : vector < ModelObject * > ModelObjectPtrs ;
typedef std : : vector < ModelVolume * > ModelVolumePtrs ;
typedef std : : vector < ModelInstance * > ModelInstancePtrs ;
2018-10-17 09:12:38 +00:00
// Unique identifier of a Model, ModelObject, ModelVolume, ModelInstance or ModelMaterial.
// Used to synchronize the front end (UI) with the back end (BackgroundSlicingProcess / Print / PrintObject)
2018-11-02 13:47:13 +00:00
// Valid IDs are strictly positive (non zero).
// It is declared as an object, as some compilers (notably msvcc) consider a typedef size_t equivalent to size_t
// for parameter overload.
struct ModelID
{
ModelID ( size_t id ) : id ( id ) { }
bool operator = = ( const ModelID & rhs ) const { return this - > id = = rhs . id ; }
bool operator ! = ( const ModelID & rhs ) const { return this - > id ! = rhs . id ; }
bool operator < ( const ModelID & rhs ) const { return this - > id < rhs . id ; }
bool operator > ( const ModelID & rhs ) const { return this - > id > rhs . id ; }
bool operator < = ( const ModelID & rhs ) const { return this - > id < = rhs . id ; }
bool operator > = ( const ModelID & rhs ) const { return this - > id > = rhs . id ; }
2019-02-20 14:54:12 +00:00
bool valid ( ) const { return id ! = 0 ; }
2018-11-02 13:47:13 +00:00
size_t id ;
} ;
2018-10-17 09:12:38 +00:00
// Base for Model, ModelObject, ModelVolume, ModelInstance or ModelMaterial to provide a unique ID
// to synchronize the front end (UI) with the back end (BackgroundSlicingProcess / Print / PrintObject).
2018-10-18 16:06:40 +00:00
// Achtung! The s_last_id counter is not thread safe, so it is expected, that the ModelBase derived instances
// are only instantiated from the main thread.
2018-10-17 09:12:38 +00:00
class ModelBase
{
public :
2018-11-02 13:47:13 +00:00
ModelID id ( ) const { return m_id ; }
2018-10-17 09:12:38 +00:00
protected :
2018-11-02 13:47:13 +00:00
// Constructors to be only called by derived classes.
// Default constructor to assign a unique ID.
ModelBase ( ) : m_id ( generate_new_id ( ) ) { }
// Constructor with ignored int parameter to assign an invalid ID, to be replaced
// by an existing ID copied from elsewhere.
ModelBase ( int ) : m_id ( ModelID ( 0 ) ) { }
2018-11-02 18:49:40 +00:00
// Use with caution!
void set_new_unique_id ( ) { m_id = generate_new_id ( ) ; }
void set_invalid_id ( ) { m_id = 0 ; }
// Use with caution!
void copy_id ( const ModelBase & rhs ) { m_id = rhs . id ( ) ; }
2018-11-02 13:47:13 +00:00
// Override this method if a ModelBase derived class owns other ModelBase derived instances.
void assign_new_unique_ids_recursive ( ) { this - > set_new_unique_id ( ) ; }
2018-10-17 09:12:38 +00:00
private :
2018-11-02 13:47:13 +00:00
ModelID m_id ;
static inline ModelID generate_new_id ( ) { return ModelID ( + + s_last_id ) ; }
static size_t s_last_id ;
2018-10-17 09:12:38 +00:00
} ;
2018-11-02 13:47:13 +00:00
# define MODELBASE_DERIVED_COPY_MOVE_CLONE(TYPE) \
/* Copy a model, copy the IDs. The Print::apply() will call the TYPE::copy() method */ \
/* to make a private copy for background processing. */ \
static TYPE * new_copy ( const TYPE & rhs ) { return new TYPE ( rhs ) ; } \
static TYPE * new_copy ( TYPE & & rhs ) { return new TYPE ( std : : move ( rhs ) ) ; } \
static TYPE make_copy ( const TYPE & rhs ) { return TYPE ( rhs ) ; } \
static TYPE make_copy ( TYPE & & rhs ) { return TYPE ( std : : move ( rhs ) ) ; } \
TYPE & assign_copy ( const TYPE & rhs ) ; \
TYPE & assign_copy ( TYPE & & rhs ) ; \
/* Copy a TYPE, generate new IDs. The front end will use this call. */ \
2018-11-02 18:49:40 +00:00
static TYPE * new_clone ( const TYPE & rhs ) { \
2018-11-02 13:47:13 +00:00
/* Default constructor assigning an invalid ID. */ \
auto obj = new TYPE ( - 1 ) ; \
obj - > assign_clone ( rhs ) ; \
return obj ; \
} \
TYPE make_clone ( const TYPE & rhs ) { \
/* Default constructor assigning an invalid ID. */ \
TYPE obj ( - 1 ) ; \
obj . assign_clone ( rhs ) ; \
return obj ; \
} \
TYPE & assign_clone ( const TYPE & rhs ) { \
this - > assign_copy ( rhs ) ; \
this - > assign_new_unique_ids_recursive ( ) ; \
return * this ; \
}
# define MODELBASE_DERIVED_PRIVATE_COPY_MOVE(TYPE) \
private : \
/* Private constructor with an unused int parameter will create a TYPE instance with an invalid ID. */ \
explicit TYPE ( int ) : ModelBase ( - 1 ) { } ; \
void assign_new_unique_ids_recursive ( ) ;
2016-09-13 11:30:00 +00:00
// Material, which may be shared across multiple ModelObjects of a single Model.
2018-10-17 09:12:38 +00:00
class ModelMaterial : public ModelBase
2014-01-06 17:29:10 +00:00
{
2016-09-13 11:30:00 +00:00
public :
// Attributes are defined by the AMF file format, but they don't seem to be used by Slic3r for any purpose.
2014-01-06 17:29:10 +00:00
t_model_material_attributes attributes ;
2016-09-13 11:30:00 +00:00
// Dynamic configuration storage for the object specific configuration values, overriding the global configuration.
2014-04-29 23:04:49 +00:00
DynamicPrintConfig config ;
2017-06-13 10:09:49 +00:00
Model * get_model ( ) const { return m_model ; }
2017-06-13 09:35:24 +00:00
void apply ( const t_model_material_attributes & attributes )
{ this - > attributes . insert ( attributes . begin ( ) , attributes . end ( ) ) ; }
2018-11-02 18:49:40 +00:00
protected :
friend class Model ;
// Constructor, which assigns a new unique ID.
ModelMaterial ( Model * model ) : m_model ( model ) { }
// Copy constructor copies the ID and m_model!
ModelMaterial ( const ModelMaterial & rhs ) = default ;
void set_model ( Model * model ) { m_model = model ; }
2016-09-13 11:30:00 +00:00
private :
// Parent, owning this material.
2017-06-13 09:35:24 +00:00
Model * m_model ;
2014-05-09 12:24:35 +00:00
2018-11-02 18:49:40 +00:00
ModelMaterial ( ) = delete ;
ModelMaterial ( ModelMaterial & & rhs ) = delete ;
ModelMaterial & operator = ( const ModelMaterial & rhs ) = delete ;
ModelMaterial & operator = ( ModelMaterial & & rhs ) = delete ;
2014-01-06 17:29:10 +00:00
} ;
2016-09-13 11:30:00 +00:00
// A printable object, possibly having multiple print volumes (each with its own set of parameters and materials),
// and possibly having multiple modifier volumes, each modifier volume with its set of parameters and materials.
// Each ModelObject may be instantiated mutliple times, each instance having different placement on the print bed,
// different rotation and different uniform scaling.
2018-10-17 09:12:38 +00:00
class ModelObject : public ModelBase
2014-01-06 17:29:10 +00:00
{
2014-05-09 12:24:35 +00:00
friend class Model ;
2016-09-13 11:30:00 +00:00
public :
2017-06-13 09:35:24 +00:00
std : : string name ;
2018-09-17 10:15:11 +00:00
std : : string input_file ; // XXX: consider fs::path
2016-09-13 11:30:00 +00:00
// Instances of this ModelObject. Each instance defines a shift on the print bed, rotation around the Z axis and a uniform scaling.
// Instances are owned by this ModelObject.
2017-06-13 09:35:24 +00:00
ModelInstancePtrs instances ;
2016-09-13 11:30:00 +00:00
// Printable and modifier volumes, each with its material ID and a set of override parameters.
// ModelVolumes are owned by this ModelObject.
2017-06-13 09:35:24 +00:00
ModelVolumePtrs volumes ;
2016-09-13 11:30:00 +00:00
// Configuration parameters specific to a single ModelObject, overriding the global Slic3r settings.
2017-06-13 09:35:24 +00:00
DynamicPrintConfig config ;
2016-09-13 11:30:00 +00:00
// Variation of a layer thickness for spans of Z coordinates.
2017-06-13 09:35:24 +00:00
t_layer_height_ranges layer_height_ranges ;
2017-02-07 17:17:12 +00:00
// Profile of increasing z to a layer height, to be linearly interpolated when calculating the layers.
2019-01-21 09:06:51 +00:00
// The pairs of <z, layer_height> are packed into a 1D array.
2017-06-13 09:35:24 +00:00
std : : vector < coordf_t > layer_height_profile ;
2018-09-19 12:59:57 +00:00
// This vector holds position of selected support points for SLA. The data are
// saved in mesh coordinates to allow using them for several instances.
2019-01-30 07:26:23 +00:00
// The format is (x, y, z, point_size, supports_island)
std : : vector < sla : : SupportPoint > sla_support_points ;
2019-02-27 15:23:10 +00:00
// To keep track of where the points came from (used for synchronization between
// the SLA gizmo and the backend).
sla : : PointsStatus sla_points_status = sla : : PointsStatus : : None ;
2016-09-13 11:30:00 +00:00
2014-10-25 09:10:44 +00:00
/* This vector accumulates the total translation applied to the object by the
center_around_origin ( ) method . Callers might want to apply the same translation
2015-01-08 23:47:40 +00:00
to new volumes before adding them to this object in order to preserve alignment
2014-10-25 09:10:44 +00:00
when user expects that . */
2018-08-21 15:43:05 +00:00
Vec3d origin_translation ;
2018-10-17 09:12:38 +00:00
2018-11-08 13:23:17 +00:00
Model * get_model ( ) { return m_model ; } ;
const Model * get_model ( ) const { return m_model ; } ;
2018-10-17 09:12:38 +00:00
ModelVolume * add_volume ( const TriangleMesh & mesh ) ;
ModelVolume * add_volume ( TriangleMesh & & mesh ) ;
ModelVolume * add_volume ( const ModelVolume & volume ) ;
2018-11-02 13:47:13 +00:00
ModelVolume * add_volume ( const ModelVolume & volume , TriangleMesh & & mesh ) ;
2018-10-17 09:12:38 +00:00
void delete_volume ( size_t idx ) ;
void clear_volumes ( ) ;
2018-10-23 09:26:15 +00:00
bool is_multiparts ( ) const { return volumes . size ( ) > 1 ; }
2018-10-17 09:12:38 +00:00
ModelInstance * add_instance ( ) ;
ModelInstance * add_instance ( const ModelInstance & instance ) ;
2019-01-03 14:04:29 +00:00
ModelInstance * add_instance ( const Vec3d & offset , const Vec3d & scaling_factor , const Vec3d & rotation , const Vec3d & mirror ) ;
2018-10-17 09:12:38 +00:00
void delete_instance ( size_t idx ) ;
void delete_last_instance ( ) ;
void clear_instances ( ) ;
2014-04-29 23:04:49 +00:00
2017-06-13 09:35:24 +00:00
// Returns the bounding box of the transformed instances.
// This bounding box is approximate and not snug.
2018-03-14 15:11:57 +00:00
// This bounding box is being cached.
2018-05-25 13:56:14 +00:00
const BoundingBoxf3 & bounding_box ( ) const ;
2019-04-13 12:15:54 +00:00
void invalidate_bounding_box ( ) { m_bounding_box_valid = false ; m_raw_bounding_box_valid = false ; m_raw_mesh_bounding_box_valid = false ; }
2014-04-29 23:04:49 +00:00
2017-06-13 09:35:24 +00:00
// A mesh containing all transformed instances of this object.
2015-01-19 17:53:04 +00:00
TriangleMesh mesh ( ) const ;
2017-06-13 09:35:24 +00:00
// Non-transformed (non-rotated, non-scaled, non-translated) sum of non-modifier object volumes.
// Currently used by ModelObject::mesh() and to calculate the 2D envelope for 2D platter.
2015-01-19 17:53:04 +00:00
TriangleMesh raw_mesh ( ) const ;
2018-12-18 09:49:22 +00:00
// Non-transformed (non-rotated, non-scaled, non-translated) sum of all object volumes.
TriangleMesh full_raw_mesh ( ) const ;
2017-06-13 09:35:24 +00:00
// A transformed snug bounding box around the non-modifier object volumes, without the translation applied.
// This bounding box is only used for the actual slicing.
2019-04-13 12:15:54 +00:00
const BoundingBoxf3 & raw_bounding_box ( ) const ;
2017-06-13 09:35:24 +00:00
// A snug bounding box around the transformed non-modifier object volumes.
BoundingBoxf3 instance_bounding_box ( size_t instance_idx , bool dont_translate = false ) const ;
2019-01-26 17:51:34 +00:00
// A snug bounding box of non-transformed (non-rotated, non-scaled, non-translated) sum of non-modifier object volumes.
2019-04-13 12:15:54 +00:00
const BoundingBoxf3 & raw_mesh_bounding_box ( ) const ;
2019-01-26 17:51:34 +00:00
// A snug bounding box of non-transformed (non-rotated, non-scaled, non-translated) sum of all object volumes.
2019-01-18 11:52:09 +00:00
BoundingBoxf3 full_raw_mesh_bounding_box ( ) const ;
2019-01-28 09:10:23 +00:00
// Calculate 2D convex hull of of a projection of the transformed printable volumes into the XY plane.
// This method is cheap in that it does not make any unnecessary copy of the volume meshes.
// This method is used by the auto arrange function.
2019-04-18 10:45:43 +00:00
Polygon convex_hull_2d ( const Transform3d & trafo_instance ) const ;
2019-01-28 09:10:23 +00:00
2019-03-22 08:47:40 +00:00
# if ENABLE_VOLUMES_CENTERING_FIXES
void center_around_origin ( bool include_modifiers = true ) ;
# else
2014-09-21 08:51:36 +00:00
void center_around_origin ( ) ;
2019-03-22 08:47:40 +00:00
# endif // ENABLE_VOLUMES_CENTERING_FIXES
2018-10-30 15:03:03 +00:00
void ensure_on_bed ( ) ;
void translate_instances ( const Vec3d & vector ) ;
void translate_instance ( size_t instance_idx , const Vec3d & vector ) ;
2018-08-21 15:43:05 +00:00
void translate ( const Vec3d & vector ) { this - > translate ( vector ( 0 ) , vector ( 1 ) , vector ( 2 ) ) ; }
2018-11-01 13:25:10 +00:00
void translate ( double x , double y , double z ) ;
2018-08-21 15:43:05 +00:00
void scale ( const Vec3d & versor ) ;
2018-09-20 14:48:13 +00:00
void scale ( const double s ) { this - > scale ( Vec3d ( s , s , s ) ) ; }
2018-11-02 13:41:08 +00:00
void scale ( double x , double y , double z ) { this - > scale ( Vec3d ( x , y , z ) ) ; }
2019-03-13 14:44:50 +00:00
/// Scale the current ModelObject to fit by altering the scaling factor of ModelInstances.
/// It operates on the total size by duplicating the object according to all the instances.
/// \param size Sizef3 the size vector
void scale_to_fit ( const Vec3d & size ) ;
2018-11-05 07:31:54 +00:00
void rotate ( double angle , Axis axis ) ;
void rotate ( double angle , const Vec3d & axis ) ;
2018-11-05 07:51:00 +00:00
void mirror ( Axis axis ) ;
2018-12-19 08:54:15 +00:00
void scale_mesh ( const Vec3d & versor ) ;
2014-09-21 08:51:36 +00:00
size_t materials_count ( ) const ;
2014-08-08 19:48:59 +00:00
size_t facets_count ( ) const ;
bool needed_repair ( ) const ;
2018-11-26 11:08:10 +00:00
ModelObjectPtrs cut ( size_t instance , coordf_t z , bool keep_upper = true , bool keep_lower = true , bool rotate_lower = false ) ; // Note: z is in world coordinates
2014-11-12 22:50:09 +00:00
void split ( ModelObjectPtrs * new_objects ) ;
2018-09-20 14:48:13 +00:00
void repair ( ) ;
2018-07-18 12:26:42 +00:00
2018-10-30 15:03:03 +00:00
double get_min_z ( ) const ;
double get_instance_min_z ( size_t instance_idx ) const ;
2018-09-14 07:28:00 +00:00
// Called by Print::validate() from the UI thread.
2018-10-23 13:27:31 +00:00
unsigned int check_instances_print_volume_state ( const BoundingBoxf3 & print_volume ) ;
2017-08-02 14:05:18 +00:00
// Print object statistics to console.
void print_info ( ) const ;
2018-10-17 09:12:38 +00:00
2019-04-04 12:00:31 +00:00
std : : string get_export_filename ( ) const ;
2019-04-24 14:04:47 +00:00
// Get full stl statistics for all object's meshes
stl_stats get_object_stl_stats ( ) const ;
// Get count of errors in the mesh( or all object's meshes, if volume index isn't defined)
int get_mesh_errors_count ( const int vol_idx = - 1 ) const ;
2018-10-17 09:12:38 +00:00
protected :
friend class Print ;
2018-11-21 16:35:35 +00:00
friend class SLAPrint ;
2018-11-02 13:47:13 +00:00
// Called by Print::apply() to set the model pointer after making a copy.
void set_model ( Model * model ) { m_model = model ; }
2018-10-17 09:12:38 +00:00
private :
2019-01-26 17:51:34 +00:00
ModelObject ( Model * model ) : m_model ( model ) , origin_translation ( Vec3d : : Zero ( ) ) ,
2019-04-13 12:15:54 +00:00
m_bounding_box_valid ( false ) , m_raw_bounding_box_valid ( false ) , m_raw_mesh_bounding_box_valid ( false ) { }
2014-05-09 12:24:35 +00:00
~ ModelObject ( ) ;
2017-06-13 09:35:24 +00:00
2018-11-02 18:49:40 +00:00
/* To be able to return an object from own copy / clone methods. Hopefully the compiler will do the "Copy elision" */
/* (Omits copy and move(since C++11) constructors, resulting in zero - copy pass - by - value semantics). */
ModelObject ( const ModelObject & rhs ) : ModelBase ( - 1 ) , m_model ( rhs . m_model ) { this - > assign_copy ( rhs ) ; }
explicit ModelObject ( ModelObject & & rhs ) : ModelBase ( - 1 ) { this - > assign_copy ( std : : move ( rhs ) ) ; }
ModelObject & operator = ( const ModelObject & rhs ) { this - > assign_copy ( rhs ) ; m_model = rhs . m_model ; return * this ; }
ModelObject & operator = ( ModelObject & & rhs ) { this - > assign_copy ( std : : move ( rhs ) ) ; m_model = rhs . m_model ; return * this ; }
MODELBASE_DERIVED_COPY_MOVE_CLONE ( ModelObject )
2018-11-02 13:47:13 +00:00
MODELBASE_DERIVED_PRIVATE_COPY_MOVE ( ModelObject )
2017-06-13 09:35:24 +00:00
2018-11-02 18:49:40 +00:00
// Parent object, owning this ModelObject. Set to nullptr here, so the macros above will have it initialized.
Model * m_model = nullptr ;
2018-06-21 06:37:04 +00:00
2018-11-02 18:49:40 +00:00
// Bounding box, cached.
2018-05-25 13:56:14 +00:00
mutable BoundingBoxf3 m_bounding_box ;
mutable bool m_bounding_box_valid ;
2019-04-13 12:15:54 +00:00
mutable BoundingBoxf3 m_raw_bounding_box ;
mutable bool m_raw_bounding_box_valid ;
2019-01-26 17:51:34 +00:00
mutable BoundingBoxf3 m_raw_mesh_bounding_box ;
mutable bool m_raw_mesh_bounding_box_valid ;
2014-01-06 17:29:10 +00:00
} ;
2019-02-22 11:12:10 +00:00
// Declared outside of ModelVolume, so it could be forward declared.
enum class ModelVolumeType : int {
INVALID = - 1 ,
MODEL_PART = 0 ,
PARAMETER_MODIFIER ,
SUPPORT_ENFORCER ,
SUPPORT_BLOCKER ,
} ;
2016-09-13 11:30:00 +00:00
// An object STL, or a modifier volume, over which a different set of parameters shall be applied.
// ModelVolume instances are owned by a ModelObject.
2018-10-17 09:12:38 +00:00
class ModelVolume : public ModelBase
2014-01-06 17:29:10 +00:00
{
2016-09-13 11:30:00 +00:00
public :
2018-10-17 09:12:38 +00:00
std : : string name ;
2016-09-13 11:30:00 +00:00
// The triangular model.
2018-10-17 09:12:38 +00:00
TriangleMesh mesh ;
2016-09-13 11:30:00 +00:00
// Configuration parameters specific to an object model geometry or a modifier volume,
// overriding the global Slic3r settings and the ModelObject settings.
2018-10-17 09:12:38 +00:00
DynamicPrintConfig config ;
2018-09-06 12:19:20 +00:00
2016-09-13 11:30:00 +00:00
// A parent object owning this modifier volume.
2018-09-06 12:19:20 +00:00
ModelObject * get_object ( ) const { return this - > object ; } ;
2019-02-22 11:12:10 +00:00
ModelVolumeType type ( ) const { return m_type ; }
void set_type ( const ModelVolumeType t ) { m_type = t ; }
bool is_model_part ( ) const { return m_type = = ModelVolumeType : : MODEL_PART ; }
bool is_modifier ( ) const { return m_type = = ModelVolumeType : : PARAMETER_MODIFIER ; }
bool is_support_enforcer ( ) const { return m_type = = ModelVolumeType : : SUPPORT_ENFORCER ; }
bool is_support_blocker ( ) const { return m_type = = ModelVolumeType : : SUPPORT_BLOCKER ; }
bool is_support_modifier ( ) const { return m_type = = ModelVolumeType : : SUPPORT_BLOCKER | | m_type = = ModelVolumeType : : SUPPORT_ENFORCER ; }
2018-10-17 09:12:38 +00:00
t_model_material_id material_id ( ) const { return m_material_id ; }
void set_material_id ( t_model_material_id material_id ) ;
2018-09-06 12:19:20 +00:00
ModelMaterial * material ( ) const ;
void set_material ( t_model_material_id material_id , const ModelMaterial & material ) ;
2018-11-22 12:20:13 +00:00
// Extract the current extruder ID based on this ModelVolume's config and the parent ModelObject's config.
// Extruder ID is only valid for FFF. Returns -1 for SLA or if the extruder ID is not applicable (support volumes).
int extruder_id ( ) const ;
2019-03-13 13:04:59 +00:00
bool is_splittable ( ) const ;
2019-01-21 14:42:33 +00:00
2017-06-15 13:38:15 +00:00
// Split this volume, append the result to the object owning this volume.
// Return the number of volumes created from this one.
// This is useful to assign different materials to different volumes of an object.
2018-09-20 14:48:13 +00:00
size_t split ( unsigned int max_extruders ) ;
2018-11-02 13:41:08 +00:00
void translate ( double x , double y , double z ) { translate ( Vec3d ( x , y , z ) ) ; }
2018-11-01 13:25:10 +00:00
void translate ( const Vec3d & displacement ) ;
2018-11-02 13:41:08 +00:00
void scale ( const Vec3d & scaling_factors ) ;
void scale ( double x , double y , double z ) { scale ( Vec3d ( x , y , z ) ) ; }
void scale ( double s ) { scale ( Vec3d ( s , s , s ) ) ; }
2018-11-05 07:31:54 +00:00
void rotate ( double angle , Axis axis ) ;
void rotate ( double angle , const Vec3d & axis ) ;
2018-11-05 07:51:00 +00:00
void mirror ( Axis axis ) ;
2018-05-07 14:13:58 +00:00
2018-12-19 08:54:15 +00:00
void scale_geometry ( const Vec3d & versor ) ;
2018-11-12 07:54:22 +00:00
// translates the mesh and the convex hull so that the origin of their vertices is in the center of this volume's bounding box
void center_geometry ( ) ;
2018-11-06 14:51:33 +00:00
2018-09-20 14:48:13 +00:00
void calculate_convex_hull ( ) ;
2018-08-15 10:50:06 +00:00
const TriangleMesh & get_convex_hull ( ) const ;
2019-04-29 13:27:59 +00:00
// Get count of errors in the mesh
int get_mesh_errors_count ( ) const ;
2018-08-15 10:50:06 +00:00
2018-09-06 12:19:20 +00:00
// Helpers for loading / storing into AMF / 3MF files.
2019-02-22 11:12:10 +00:00
static ModelVolumeType type_from_string ( const std : : string & s ) ;
static std : : string type_to_string ( const ModelVolumeType t ) ;
2018-09-06 12:19:20 +00:00
2018-11-01 13:25:10 +00:00
const Geometry : : Transformation & get_transformation ( ) const { return m_transformation ; }
void set_transformation ( const Geometry : : Transformation & transformation ) { m_transformation = transformation ; }
2018-10-31 13:56:51 +00:00
const Vec3d & get_offset ( ) const { return m_transformation . get_offset ( ) ; }
double get_offset ( Axis axis ) const { return m_transformation . get_offset ( axis ) ; }
void set_offset ( const Vec3d & offset ) { m_transformation . set_offset ( offset ) ; }
void set_offset ( Axis axis , double offset ) { m_transformation . set_offset ( axis , offset ) ; }
const Vec3d & get_rotation ( ) const { return m_transformation . get_rotation ( ) ; }
double get_rotation ( Axis axis ) const { return m_transformation . get_rotation ( axis ) ; }
void set_rotation ( const Vec3d & rotation ) { m_transformation . set_rotation ( rotation ) ; }
void set_rotation ( Axis axis , double rotation ) { m_transformation . set_rotation ( axis , rotation ) ; }
Vec3d get_scaling_factor ( ) const { return m_transformation . get_scaling_factor ( ) ; }
double get_scaling_factor ( Axis axis ) const { return m_transformation . get_scaling_factor ( axis ) ; }
void set_scaling_factor ( const Vec3d & scaling_factor ) { m_transformation . set_scaling_factor ( scaling_factor ) ; }
void set_scaling_factor ( Axis axis , double scaling_factor ) { m_transformation . set_scaling_factor ( axis , scaling_factor ) ; }
const Vec3d & get_mirror ( ) const { return m_transformation . get_mirror ( ) ; }
double get_mirror ( Axis axis ) const { return m_transformation . get_mirror ( axis ) ; }
2019-04-02 11:47:49 +00:00
bool is_left_handed ( ) const { return m_transformation . is_left_handed ( ) ; }
2018-10-31 13:56:51 +00:00
void set_mirror ( const Vec3d & mirror ) { m_transformation . set_mirror ( mirror ) ; }
void set_mirror ( Axis axis , double mirror ) { m_transformation . set_mirror ( axis , mirror ) ; }
2018-11-01 13:25:10 +00:00
const Transform3d & get_matrix ( bool dont_translate = false , bool dont_rotate = false , bool dont_scale = false , bool dont_mirror = false ) const { return m_transformation . get_matrix ( dont_translate , dont_rotate , dont_scale , dont_mirror ) ; }
2018-10-31 13:56:51 +00:00
2019-02-03 21:14:34 +00:00
using ModelBase : : set_new_unique_id ;
2018-11-02 18:49:40 +00:00
protected :
2018-11-02 19:41:49 +00:00
friend class Print ;
2018-11-21 16:35:35 +00:00
friend class SLAPrint ;
2018-11-02 19:41:49 +00:00
friend class ModelObject ;
2018-11-12 15:28:27 +00:00
explicit ModelVolume ( const ModelVolume & rhs ) = default ;
2018-11-02 18:49:40 +00:00
void set_model_object ( ModelObject * model_object ) { object = model_object ; }
2016-09-13 11:30:00 +00:00
private :
// Parent object owning this ModelVolume.
2018-09-06 12:19:20 +00:00
ModelObject * object ;
// Is it an object to be printed, or a modifier volume?
2019-02-22 11:12:10 +00:00
ModelVolumeType m_type ;
2018-10-17 09:12:38 +00:00
t_model_material_id m_material_id ;
2018-11-01 13:25:10 +00:00
// The convex hull of this model's mesh.
TriangleMesh m_convex_hull ;
Geometry : : Transformation m_transformation ;
2019-04-01 10:27:45 +00:00
// flag to optimize the checking if the volume is splittable
// -1 -> is unknown value (before first cheking)
// 0 -> is not splittable
// 1 -> is splittable
mutable int m_is_splittable { - 1 } ;
2019-02-22 11:12:10 +00:00
ModelVolume ( ModelObject * object , const TriangleMesh & mesh ) : mesh ( mesh ) , m_type ( ModelVolumeType : : MODEL_PART ) , object ( object )
2018-08-15 10:50:06 +00:00
{
if ( mesh . stl . stats . number_of_facets > 1 )
calculate_convex_hull ( ) ;
}
2018-11-02 11:11:28 +00:00
ModelVolume ( ModelObject * object , TriangleMesh & & mesh , TriangleMesh & & convex_hull ) :
2019-02-22 11:12:10 +00:00
mesh ( std : : move ( mesh ) ) , m_convex_hull ( std : : move ( convex_hull ) ) , m_type ( ModelVolumeType : : MODEL_PART ) , object ( object ) { }
2018-11-02 11:11:28 +00:00
2018-11-05 16:52:55 +00:00
// Copying an existing volume, therefore this volume will get a copy of the ID assigned.
2018-11-02 11:11:28 +00:00
ModelVolume ( ModelObject * object , const ModelVolume & other ) :
ModelBase ( other ) , // copy the ID
name ( other . name ) , mesh ( other . mesh ) , m_convex_hull ( other . m_convex_hull ) , config ( other . config ) , m_type ( other . m_type ) , object ( object ) , m_transformation ( other . m_transformation )
{
this - > set_material_id ( other . material_id ( ) ) ;
}
2018-11-05 16:52:55 +00:00
// Providing a new mesh, therefore this volume will get a new unique ID assigned.
2018-11-02 11:11:28 +00:00
ModelVolume ( ModelObject * object , const ModelVolume & other , const TriangleMesh & & mesh ) :
name ( other . name ) , mesh ( std : : move ( mesh ) ) , config ( other . config ) , m_type ( other . m_type ) , object ( object ) , m_transformation ( other . m_transformation )
{
this - > set_material_id ( other . material_id ( ) ) ;
if ( mesh . stl . stats . number_of_facets > 1 )
calculate_convex_hull ( ) ;
}
2018-10-30 14:24:36 +00:00
ModelVolume & operator = ( ModelVolume & rhs ) = delete ;
2014-01-06 17:29:10 +00:00
} ;
2016-09-13 11:30:00 +00:00
// A single instance of a ModelObject.
// Knows the affine transformation of an object.
2018-10-17 09:12:38 +00:00
class ModelInstance : public ModelBase
2014-01-06 17:29:10 +00:00
{
2016-09-13 11:30:00 +00:00
public :
2018-07-18 12:26:42 +00:00
enum EPrintVolumeState : unsigned char
{
PVS_Inside ,
PVS_Partly_Outside ,
PVS_Fully_Outside ,
Num_BedStates
} ;
2018-09-13 13:15:00 +00:00
private :
2018-10-31 13:56:51 +00:00
Geometry : : Transformation m_transformation ;
2018-09-13 13:15:00 +00:00
public :
2018-07-18 12:26:42 +00:00
// flag showing the position of this instance with respect to the print volume (set by Print::validate() using ModelObject::check_instances_print_volume_state())
EPrintVolumeState print_volume_state ;
2018-07-18 07:37:25 +00:00
2018-06-28 14:14:17 +00:00
ModelObject * get_object ( ) const { return this - > object ; }
2016-09-13 11:30:00 +00:00
2018-10-31 13:56:51 +00:00
const Geometry : : Transformation & get_transformation ( ) const { return m_transformation ; }
void set_transformation ( const Geometry : : Transformation & transformation ) { m_transformation = transformation ; }
const Vec3d & get_offset ( ) const { return m_transformation . get_offset ( ) ; }
double get_offset ( Axis axis ) const { return m_transformation . get_offset ( axis ) ; }
void set_offset ( const Vec3d & offset ) { m_transformation . set_offset ( offset ) ; }
void set_offset ( Axis axis , double offset ) { m_transformation . set_offset ( axis , offset ) ; }
const Vec3d & get_rotation ( ) const { return m_transformation . get_rotation ( ) ; }
double get_rotation ( Axis axis ) const { return m_transformation . get_rotation ( axis ) ; }
void set_rotation ( const Vec3d & rotation ) { m_transformation . set_rotation ( rotation ) ; }
void set_rotation ( Axis axis , double rotation ) { m_transformation . set_rotation ( axis , rotation ) ; }
2019-01-28 07:52:22 +00:00
const Vec3d & get_scaling_factor ( ) const { return m_transformation . get_scaling_factor ( ) ; }
2018-10-31 13:56:51 +00:00
double get_scaling_factor ( Axis axis ) const { return m_transformation . get_scaling_factor ( axis ) ; }
void set_scaling_factor ( const Vec3d & scaling_factor ) { m_transformation . set_scaling_factor ( scaling_factor ) ; }
void set_scaling_factor ( Axis axis , double scaling_factor ) { m_transformation . set_scaling_factor ( axis , scaling_factor ) ; }
const Vec3d & get_mirror ( ) const { return m_transformation . get_mirror ( ) ; }
double get_mirror ( Axis axis ) const { return m_transformation . get_mirror ( axis ) ; }
2019-04-02 11:54:23 +00:00
bool is_left_handed ( ) const { return m_transformation . is_left_handed ( ) ; }
2018-10-31 13:56:51 +00:00
void set_mirror ( const Vec3d & mirror ) { m_transformation . set_mirror ( mirror ) ; }
void set_mirror ( Axis axis , double mirror ) { m_transformation . set_mirror ( axis , mirror ) ; }
2018-09-20 13:00:40 +00:00
2016-09-13 11:30:00 +00:00
// To be called on an external mesh
2014-08-03 18:33:16 +00:00
void transform_mesh ( TriangleMesh * mesh , bool dont_translate = false ) const ;
2016-11-16 10:53:29 +00:00
// Calculate a bounding box of a transformed mesh. To be called on an external mesh.
2018-11-09 09:31:58 +00:00
BoundingBoxf3 transform_mesh_bounding_box ( const TriangleMesh & mesh , bool dont_translate = false ) const ;
2016-11-16 10:53:29 +00:00
// Transform an external bounding box.
BoundingBoxf3 transform_bounding_box ( const BoundingBoxf3 & bbox , bool dont_translate = false ) const ;
2018-09-06 07:16:32 +00:00
// Transform an external vector.
Vec3d transform_vector ( const Vec3d & v , bool dont_translate = false ) const ;
2016-09-13 11:30:00 +00:00
// To be called on an external polygon. It does not translate the polygon, only rotates and scales.
2014-01-06 17:29:10 +00:00
void transform_polygon ( Polygon * polygon ) const ;
2018-07-18 12:26:42 +00:00
2018-11-01 13:25:10 +00:00
const Transform3d & get_matrix ( bool dont_translate = false , bool dont_rotate = false , bool dont_scale = false , bool dont_mirror = false ) const { return m_transformation . get_matrix ( dont_translate , dont_rotate , dont_scale , dont_mirror ) ; }
2018-09-04 12:42:14 +00:00
2018-07-18 12:26:42 +00:00
bool is_printable ( ) const { return print_volume_state = = PVS_Inside ; }
2018-11-02 18:49:40 +00:00
protected :
friend class Print ;
2018-11-21 16:35:35 +00:00
friend class SLAPrint ;
2018-11-02 18:49:40 +00:00
friend class ModelObject ;
explicit ModelInstance ( const ModelInstance & rhs ) = default ;
void set_model_object ( ModelObject * model_object ) { object = model_object ; }
2016-09-13 11:30:00 +00:00
private :
// Parent object, owning this instance.
2014-05-09 12:24:35 +00:00
ModelObject * object ;
2017-06-13 09:35:24 +00:00
2018-11-02 18:49:40 +00:00
// Constructor, which assigns a new unique ID.
2018-11-02 19:41:49 +00:00
explicit ModelInstance ( ModelObject * object ) : object ( object ) , print_volume_state ( PVS_Inside ) { }
2018-11-02 18:49:40 +00:00
// Constructor, which assigns a new unique ID.
2018-11-02 19:41:49 +00:00
explicit ModelInstance ( ModelObject * object , const ModelInstance & other ) :
2018-10-31 13:56:51 +00:00
m_transformation ( other . m_transformation ) , object ( object ) , print_volume_state ( PVS_Inside ) { }
2017-06-13 09:35:24 +00:00
2018-11-02 18:49:40 +00:00
ModelInstance ( ) = delete ;
explicit ModelInstance ( ModelInstance & & rhs ) = delete ;
ModelInstance & operator = ( const ModelInstance & rhs ) = delete ;
ModelInstance & operator = ( ModelInstance & & rhs ) = delete ;
2018-10-30 14:24:36 +00:00
} ;
2017-06-13 09:35:24 +00:00
// The print bed content.
// Description of a triangular model with multiple materials, multiple instances with various affine transformations
// and with multiple modifier meshes.
// A model groups multiple objects, each object having possibly multiple instances,
// all objects may share mutliple materials.
2018-10-17 09:12:38 +00:00
class Model : public ModelBase
2017-06-13 09:35:24 +00:00
{
2018-04-10 10:17:55 +00:00
static unsigned int s_auto_extruder_id ;
2017-06-13 09:35:24 +00:00
public :
// Materials are owned by a model and referenced by objects through t_model_material_id.
// Single material may be shared by multiple models.
2018-11-02 13:47:13 +00:00
ModelMaterialMap materials ;
2017-06-13 09:35:24 +00:00
// Objects are owned by a model. Each model may have multiple instances, each instance having its own transformation (shift, scale, rotation).
2018-11-02 13:47:13 +00:00
ModelObjectPtrs objects ;
2017-06-13 09:35:24 +00:00
2018-11-02 13:47:13 +00:00
// Default constructor assigns a new ID to the model.
2017-06-13 09:35:24 +00:00
Model ( ) { }
2017-08-02 14:05:18 +00:00
~ Model ( ) { this - > clear_objects ( ) ; this - > clear_materials ( ) ; }
2018-11-02 18:49:40 +00:00
/* To be able to return an object from own copy / clone methods. Hopefully the compiler will do the "Copy elision" */
/* (Omits copy and move(since C++11) constructors, resulting in zero - copy pass - by - value semantics). */
Model ( const Model & rhs ) : ModelBase ( - 1 ) { this - > assign_copy ( rhs ) ; }
explicit Model ( Model & & rhs ) : ModelBase ( - 1 ) { this - > assign_copy ( std : : move ( rhs ) ) ; }
Model & operator = ( const Model & rhs ) { this - > assign_copy ( rhs ) ; return * this ; }
Model & operator = ( Model & & rhs ) { this - > assign_copy ( std : : move ( rhs ) ) ; return * this ; }
2018-11-02 13:47:13 +00:00
MODELBASE_DERIVED_COPY_MOVE_CLONE ( Model )
2018-09-25 09:53:05 +00:00
static Model read_from_file ( const std : : string & input_file , DynamicPrintConfig * config = nullptr , bool add_default_instances = true ) ;
static Model read_from_archive ( const std : : string & input_file , DynamicPrintConfig * config , bool add_default_instances = true ) ;
2017-08-02 14:05:18 +00:00
2018-09-20 14:48:13 +00:00
/// Repair the ModelObjects of the current Model.
/// This function calls repair function on each TriangleMesh of each model object volume
2018-11-02 13:47:13 +00:00
void repair ( ) ;
2017-08-02 14:05:18 +00:00
2018-11-02 13:47:13 +00:00
// Add a new ModelObject to this Model, generate a new ID for this ModelObject.
2017-06-13 09:35:24 +00:00
ModelObject * add_object ( ) ;
ModelObject * add_object ( const char * name , const char * path , const TriangleMesh & mesh ) ;
ModelObject * add_object ( const char * name , const char * path , TriangleMesh & & mesh ) ;
2018-11-02 13:47:13 +00:00
ModelObject * add_object ( const ModelObject & other ) ;
void delete_object ( size_t idx ) ;
2018-11-02 18:49:40 +00:00
bool delete_object ( ModelID id ) ;
bool delete_object ( ModelObject * object ) ;
2018-11-02 13:47:13 +00:00
void clear_objects ( ) ;
2018-10-18 13:13:38 +00:00
2017-06-13 09:35:24 +00:00
ModelMaterial * add_material ( t_model_material_id material_id ) ;
ModelMaterial * add_material ( t_model_material_id material_id , const ModelMaterial & other ) ;
ModelMaterial * get_material ( t_model_material_id material_id ) {
ModelMaterialMap : : iterator i = this - > materials . find ( material_id ) ;
return ( i = = this - > materials . end ( ) ) ? nullptr : i - > second ;
}
2018-11-02 18:49:40 +00:00
void delete_material ( t_model_material_id material_id ) ;
void clear_materials ( ) ;
bool add_default_instances ( ) ;
2018-03-09 09:40:42 +00:00
// Returns approximate axis aligned bounding box of this model
BoundingBoxf3 bounding_box ( ) const ;
2018-10-23 13:27:31 +00:00
// Set the print_volume_state of PrintObject::instances,
// return total number of printable objects.
unsigned int update_print_volume_state ( const BoundingBoxf3 & print_volume ) ;
2018-11-08 19:18:40 +00:00
// Returns true if any ModelObject was modified.
bool center_instances_around_point ( const Vec2d & point ) ;
2017-06-13 09:35:24 +00:00
void translate ( coordf_t x , coordf_t y , coordf_t z ) { for ( ModelObject * o : this - > objects ) o - > translate ( x , y , z ) ; }
TriangleMesh mesh ( ) const ;
2018-07-30 14:41:35 +00:00
bool arrange_objects ( coordf_t dist , const BoundingBoxf * bb = NULL ) ;
2017-06-13 09:35:24 +00:00
// Croaks if the duplicated objects do not fit the print bed.
void duplicate ( size_t copies_num , coordf_t dist , const BoundingBoxf * bb = NULL ) ;
void duplicate_objects ( size_t copies_num , coordf_t dist , const BoundingBoxf * bb = NULL ) ;
void duplicate_objects_grid ( size_t x , size_t y , coordf_t dist ) ;
2017-08-02 14:05:18 +00:00
bool looks_like_multipart_object ( ) const ;
2018-05-07 14:13:58 +00:00
void convert_multipart_object ( unsigned int max_extruders ) ;
2017-08-02 14:05:18 +00:00
2018-03-06 09:26:39 +00:00
// Ensures that the min z of the model is not negative
void adjust_min_z ( ) ;
2017-08-02 14:05:18 +00:00
void print_info ( ) const { for ( const ModelObject * o : this - > objects ) o - > print_info ( ) ; }
2018-04-10 10:17:55 +00:00
2018-05-07 14:13:58 +00:00
static unsigned int get_auto_extruder_id ( unsigned int max_extruders ) ;
static std : : string get_auto_extruder_id_as_string ( unsigned int max_extruders ) ;
2018-04-10 10:17:55 +00:00
static void reset_auto_extruder_id ( ) ;
2018-11-02 13:47:13 +00:00
2019-02-03 09:41:14 +00:00
// Propose an output file name & path based on the first printable object's name and source input file's path.
std : : string propose_export_file_name_and_path ( ) const ;
2019-03-13 14:44:50 +00:00
// Propose an output path, replace extension. The new_extension shall contain the initial dot.
std : : string propose_export_file_name_and_path ( const std : : string & new_extension ) const ;
2018-12-03 12:14:28 +00:00
2018-11-02 13:47:13 +00:00
private :
MODELBASE_DERIVED_PRIVATE_COPY_MOVE ( Model )
2014-01-06 17:29:10 +00:00
} ;
2018-11-02 13:47:13 +00:00
# undef MODELBASE_DERIVED_COPY_MOVE_CLONE
# undef MODELBASE_DERIVED_PRIVATE_COPY_MOVE
2018-11-21 16:35:35 +00:00
// Test whether the two models contain the same number of ModelObjects with the same set of IDs
// ordered in the same order. In that case it is not necessary to kill the background processing.
extern bool model_object_list_equal ( const Model & model_old , const Model & model_new ) ;
// Test whether the new model is just an extension of the old model (new objects were added
// to the end of the original list. In that case it is not necessary to kill the background processing.
extern bool model_object_list_extended ( const Model & model_old , const Model & model_new ) ;
// Test whether the new ModelObject contains a different set of volumes (or sorted in a different order)
// than the old ModelObject.
2019-02-22 11:12:10 +00:00
extern bool model_volume_list_changed ( const ModelObject & model_object_old , const ModelObject & model_object_new , const ModelVolumeType type ) ;
2018-11-21 16:35:35 +00:00
2019-01-31 07:47:23 +00:00
# ifndef NDEBUG
2018-11-16 17:28:50 +00:00
// Verify whether the IDs of Model / ModelObject / ModelVolume / ModelInstance / ModelMaterial are valid and unique.
void check_model_ids_validity ( const Model & model ) ;
void check_model_ids_equal ( const Model & model1 , const Model & model2 ) ;
2019-01-31 07:47:23 +00:00
# endif /* NDEBUG */
2018-11-16 17:28:50 +00:00
2014-01-06 17:29:10 +00:00
}
# endif