#include <opennurbs_mesh.h>

Public Types
enum	: unsigned int { UnsetDensity = 0, MinimumUserInterfaceDensity = 1, MaximumUserInterfaceDensity = 5, MinimumAdaptiveDensity = 1, MinimumDensity = 0, ExtraCoarseDensity = 1, CoarseDensity = 2, MediumDensity = 3, FineDensity = 4, DefaultDensity = 4, ExtraFineDensity = 5, MaximumDensity = 6 }

enum	: unsigned int { AdaptiveDisplayMeshQuadMaximum = 512000 }

enum	Context : unsigned char { Context::Unknown = 0, Context::SubDToMesh = 1, Context::SubDToNURBS = 2 }

Public Member Functions
	ON_SubDDisplayParameters ()=default

	ON_SubDDisplayParameters (const ON_SubDDisplayParameters &)=default

	~ON_SubDDisplayParameters ()=default

bool	ComputeCurvature () const

ON_SubDDisplayParameters::Context	ContextForExperts () const

unsigned int	DisplayDensity () const

unsigned int	DisplayDensity (const class ON_SubD &subd) const

bool	DisplayDensityIsAbsolute () const

bool	DisplayDensityIsAdaptive () const

void	Dump (class ON_TextLog &) const

unsigned char	EncodeAsUnsignedChar () const

const unsigned char	GetRawDisplayDensityForExperts () const

ON_SubDComponentLocation	MeshLocation () const

ON_SubDDisplayParameters &	operator= (const ON_SubDDisplayParameters &)=default

ON_ProgressReporter *	ProgressReporter () const

const ON_Interval	ProgressReporterInterval () const

bool	Read (class ON_BinaryArchive &archive)

void	SetAbsoluteDisplayDensity (unsigned int absolute_display_density)

void	SetAdaptiveDisplayDensity (unsigned int adaptive_display_density)

void	SetComputeCurvature (bool compute_curvature)

void	SetContextForExperts (ON_SubDDisplayParameters::Context context)

void	SetDisplayDensity (unsigned int adaptive_display_density)

void	SetMeshLocation (ON_SubDComponentLocation mesh_location)

void	SetProgressReporter (ON_ProgressReporter *progress_reporter, ON_Interval progress_reporter_interval)

void	SetTerminator (ON_Terminator *terminator)

ON_Terminator *	Terminator () const
	TODO - split this class into two - what's above and one derived from that with what's below. More...

bool	Write (class ON_BinaryArchive &archive) const

Static Public Member Functions
static unsigned int	AbsoluteDisplayDensityFromSubD (unsigned adaptive_subd_display_density, const class ON_SubD &subd)

static unsigned int	AbsoluteDisplayDensityFromSubDFaceCount (unsigned adaptive_subd_display_density, unsigned subd_face_count)

static const ON_SubDDisplayParameters	CreateFromAbsoluteDisplayDensity (unsigned int absolute_subd_display_density)

static const ON_SubDDisplayParameters	CreateFromDisplayDensity (unsigned int adaptive_subd_display_density)

static const ON_SubDDisplayParameters	CreateFromMeshDensity (double normalized_mesh_density)

static const ON_SubDDisplayParameters	DecodeFromUnsignedChar (unsigned char encoded_parameters)

Static Public Attributes
static const ON_SubDDisplayParameters	Coarse

static const ON_SubDDisplayParameters	Default

static const ON_SubDDisplayParameters	Empty

static const ON_SubDDisplayParameters	ExtraCoarse

static const ON_SubDDisplayParameters	ExtraFine

static const ON_SubDDisplayParameters	Fine

static const ON_SubDDisplayParameters	Medium

Detailed Description

ON_SubDDisplayParameters

A collection of parameters that are passed to functions that calculate a various representations of ON_SubD objects.

Member Enumeration Documentation

◆ anonymous enum

anonymous enum : unsigned int

Enumerator
UnsetDensity	summary> Indicates the SubD display mesh density has not be set. /summary> summary> The minimum SubD display density that can be se in Rhino user interface is ExtraCoarseDensity (1). /summary>
MinimumUserInterfaceDensity	summary> The maximum SubD display density that can be se in Rhino user interface is ExtraFineDensity (5). /summary>
MaximumUserInterfaceDensity	summary> SubD display density values <= MinimumAdaptiveDensity will never be adaptively reduced. SubD display density values > MinimumAdaptiveDensity may be adaptively reduced to a value >= MinimumAdaptiveDensity. /summary>
MinimumAdaptiveDensity	summary> Each SubD quad will generate 1 display mesh quads in a 1x1 grid. This density can only be used with SubDs where every face is a quad. User interface code never returns this density. /summary>
MinimumDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 4 display mesh quads in a 2x2 grid and each SubD N-gon will generate N display mesh quads. Adaptive reductions do not apply to this density. This is the minimum SubD display density. /summary>
ExtraCoarseDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 16 display mesh quads in a 4x4 grid and each SubD N-gon will generate N*4 display mesh quads. Adaptive reductions do not apply to this density. /summary>
CoarseDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 64 display mesh quads in an 8x8 grid and each SubD N-gon will generate N*8 display mesh quads. When a SubD has more than 8000 faces, adaptive MediumDensity is reduced to CoarseDensity. /summary>
MediumDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 256 display mesh quads in a 16x16 grid and each SubD N-gon will generate N*16 display mesh quads. When a SubD has more than 2000 faces, adaptive FineDensity is reduced to adaptive MediumDensity. /summary>
FineDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 256 display mesh quads in a 16x16 grid and each SubD N-gon will generate N*16 display mesh quads. When a SubD has more than 2000 faces, adaptive DefaultDensity is reduced to adaptive MediumDensity. This is the default value for creating mesh approximations of SubD surface. When treadted as an adaptive setting, it produces acceptable results for most SubDs. /summary>
DefaultDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 1024 display mesh quads in a 32x32 grid and each SubD N-gon will generate N*32 display mesh quads. When a SubD has more than 500 faces, adaptive ExtraFineDensity is reduced to adaptive FineDensity. /summary>
ExtraFineDensity	summary> When interpreted as an absolute SubD display density, each SubD quad will generate 4096 display mesh quads in a 64x64 grid and each SubD N-gon will generate N*64 display mesh quads. ON_SubDDisplayParameters.AdaptiveDensity() determines if the subd display density is treated adaptively or absolutely. This value creates ridiculously dense display meshes and should generally be avoided. No Rhino user interface will create this value. /summary>
MaximumDensity

◆ anonymous enum

anonymous enum : unsigned int

Enumerator

AdaptiveDisplayMeshQuadMaximum

When the SubD display density is adaptive (default), AdaptiveMeshQuadMaximum specifies the approximate number of display mesh quads to permit before reducing the SubD display mesh density. Approximate display mesh quad count = subd.FaceCount()*(4^subd_display_density). This enum value may change from release to release as rendering technology improves. Make sure your code works for values between 1024 and 134217728.

◆ Context

enum ON_SubDDisplayParameters::Context : unsigned char

strong

Enumerator
Unknown	summary> Unknown, unspecified, or unset context. This is typical. /summary> summary> These parameters are being used to generate a quad mesh approximations of an ON_SubD. Low level meshing code copies input parameters and specifies this context when appropriate. /summary>
SubDToMesh	summary> These parameters are being used to generate NURBS surface approximations of an ON_SubD. Low level conversion to NURB code copies input parameters and specifies this context when appropriate. /summary>
SubDToNURBS

Constructor & Destructor Documentation

◆ ON_SubDDisplayParameters() [1/2]

ON_SubDDisplayParameters::ON_SubDDisplayParameters ( )

default

◆ ~ON_SubDDisplayParameters()

ON_SubDDisplayParameters::~ON_SubDDisplayParameters ( )

default

◆ ON_SubDDisplayParameters() [2/2]

ON_SubDDisplayParameters::ON_SubDDisplayParameters ( const ON_SubDDisplayParameters & )

default

Member Function Documentation

◆ AbsoluteDisplayDensityFromSubD()

static unsigned int ON_SubDDisplayParameters::AbsoluteDisplayDensityFromSubD	(	unsigned	adaptive_subd_display_density,
		const class ON_SubD &	subd
	)

static

Parameters: adaptive_subd_display_density - [in] A value <= ON_SubDDisplayParameters::MaximumDensity. When in doubt, pass ON_SubDDisplayParameters::DefaultDensity. Invalid input values are treated as ON_SubDDisplayParameters::DefaultDensity. subd - [in] In the cases when the subd in question is not available, like user interface code that applies in general and to unknown SubDs, pass ON_SubD::Empty. Returns: The absolute SubD display density for subd. The absolute SubD display density is <= adaptive_subd_display_density and <= ON_SubDDisplayParameters::MaximumDensity.

◆ AbsoluteDisplayDensityFromSubDFaceCount()

static unsigned int ON_SubDDisplayParameters::AbsoluteDisplayDensityFromSubDFaceCount	(	unsigned	adaptive_subd_display_density,
		unsigned	subd_face_count
	)

static

Parameters: adaptive_subd_display_density - [in] A value <= ON_SubDDisplayParameters::MaximumDensity. When in doubt, pass ON_SubDDisplayParameters::DefaultDensity. Invalid input values are treated as ON_SubDDisplayParameters::DefaultDensity. subd_face_count - [in] Number of SubD faces. When subd_face_count = 0, adaptive_subd_display_density is returned. Returns: The absolute SubD display density for SubD with subd_face_count faces. The absolute SubD display density is <= adaptive_subd_display_density and <= ON_SubDDisplayParameters::MaximumDensity.

◆ ComputeCurvature()

bool ON_SubDDisplayParameters::ComputeCurvature ( ) const

Description: The ComputeCurvature() property determines if the mesh has curvature values.

◆ ContextForExperts()

ON_SubDDisplayParameters::Context ON_SubDDisplayParameters::ContextForExperts ( ) const

Description: Low level mesh creation and ON_SubD to NURBS conversion code occasional looks at the context. Typically it is set in a local copy and no user of the top level ON_SubD SDK needs to be concerned about the context setting. This setting is not saved in 3dm archives and is ignored by all compare functions.

◆ CreateFromAbsoluteDisplayDensity()

static const ON_SubDDisplayParameters ON_SubDDisplayParameters::CreateFromAbsoluteDisplayDensity ( unsigned int absolute_subd_display_density )

static

Description: Use of absolute display density is strongly discouraged. SubDs can have a single face or millions of faces. Adaptive display meshing produces more desirable results in almost all cases. Parameters: absolute_subd_display_density - [in] A value <= ON_SubDDisplayParameters::MaximumDensity. When in doubt, pass ON_SubDDisplayParameters::DefaultDensity. Returns: A ON_SubDDisplayParameters that treats the display density value as a constant for all SubDs.

◆ CreateFromDisplayDensity()

static const ON_SubDDisplayParameters ON_SubDDisplayParameters::CreateFromDisplayDensity ( unsigned int adaptive_subd_display_density )

static

Description: In most applications, the caller sets the mesh_density and leaves the other parameters set to the default values. Parameters: adaptive_subd_display_density - [in] A value <= ON_SubDDisplayParameters::MaximumDensity. When in doubt, pass ON_SubDDisplayParameters::DefaultDensity. Values < ON_SubDDisplayParameters::MinimumAdaptiveDensity are treated as N_SubDDisplayParameters::MinimumAdaptiveDensity. All other invalid input values are treated as ON_SubDDisplayParameters::DefaultDensity. Returns: A ON_SubDDisplayParameters with adaptive SubD display density.

◆ CreateFromMeshDensity()

static const ON_SubDDisplayParameters ON_SubDDisplayParameters::CreateFromMeshDensity ( double normalized_mesh_density )

static

Description: This function creates ON_SubDDisplayParameters from a user interface "slider" like Rhino's simple mesh controls. Parameters: normalized_mesh_density - [in] A double between 0.0 and 1.0

The table below shows the correspondence between normalized_density and subd display density.

Mesh density percentage / normalized_mesh_density / subd display density 0% -> [0.0, ON_ZERO_TOLERANCE] -> 1 = adaptive MinimumUserInterfaceDensity 0% to 19% -> (ON_ZERO_TOLERANCE, 0.20) -> 2 = adaptive CoarseDensity 20% to 34% -> [0.20, 0.35) -> 3 = adaptive MediumDensity 35% to 75% -> [0.35, 0.75] -> 4 = adaptive FineDensity 76% to 99% -> (0.75, 1 - ON_ZERO_TOLERANCE) -> 5 = adaptive ExtraFineDensity 100% -> [1 - ON_ZERO_TOLERANCE, 1.0] -> 5 = adaptive MaximumUserInterfaceDensity

Invalid input -> adaptive DefaultDensity;

Returns: A valid ON_SubDDisplayParameters with the specified subd display density.

◆ DecodeFromUnsignedChar()

static const ON_SubDDisplayParameters ON_SubDDisplayParameters::DecodeFromUnsignedChar ( unsigned char encoded_parameters )

static

◆ DisplayDensity() [1/2]

unsigned int ON_SubDDisplayParameters::DisplayDensity ( ) const

Deprecated:: Use DisplayDensity(subd)

◆ DisplayDensity() [2/2]

unsigned int ON_SubDDisplayParameters::DisplayDensity ( const class ON_SubD & subd ) const

Parameters: subd - [in] Used when the display density is adaptive and subd.FaceCount() > 0. Ignored when the display density is absolute or subd.FaceCount() = 0.

Returns: The absolute display density to use when creating display meshes for subd. When adaptive reduction is enabled, subd.FaceCount() is used to determine the appropriate display density.

Remarks: The chart below shows the relationship between the returned value and the number of display mesh quads a generated by 1 SubD quad.

return display mesh value quads 0 1 = 1x1 1 4 = 2x2 2 16 = 4x4 3 64 = 8x8
4 128 = 16x16 5 1,024 = 32x32 6 4,096 = 64x64

◆ DisplayDensityIsAbsolute()

bool ON_SubDDisplayParameters::DisplayDensityIsAbsolute ( ) const

Returns: True if the SubD display density setting is absolute. Remarks: this->DensityIsAdaptive() and this->DensityIsAbsolute() always return opposite bool values. Use the one that makes your code easiest to read and understand.

◆ DisplayDensityIsAdaptive()

bool ON_SubDDisplayParameters::DisplayDensityIsAdaptive ( ) const

Returns: True if the SubD display density setting is adaptive and approximate display mesh quad count is capped at ON_SubDDisplayParameters::AdaptiveDisplayMeshQuadMaximum. Remarks: this->DensityIsAdaptive() and this->DensityIsAbsolute() always return opposite bool values. Use the one that makes your code easiest to read and understand.

◆ Dump()

void ON_SubDDisplayParameters::Dump ( class ON_TextLog & ) const

◆ EncodeAsUnsignedChar()

unsigned char ON_SubDDisplayParameters::EncodeAsUnsignedChar ( ) const

◆ GetRawDisplayDensityForExperts()

const unsigned char ON_SubDDisplayParameters::GetRawDisplayDensityForExperts ( ) const

Returns: The raw value of m_display_density. Remarks: This function is only intended to get public raw access to that value (for example when comparing meshing parameters) and should not be used in any place where the returned value will be used to compute a SubD display density.

Use DisplayDensity(subd) instead!

◆ MeshLocation()

ON_SubDComponentLocation ON_SubDDisplayParameters::MeshLocation ( ) const

Description: The MeshLocation() property determines if the mesh is on the SubD's control net or the SubD's surface.

◆ operator=()

ON_SubDDisplayParameters& ON_SubDDisplayParameters::operator= ( const ON_SubDDisplayParameters & )

default

◆ ProgressReporter()

ON_ProgressReporter* ON_SubDDisplayParameters::ProgressReporter ( ) const

◆ ProgressReporterInterval()

const ON_Interval ON_SubDDisplayParameters::ProgressReporterInterval ( ) const

◆ Read()

bool ON_SubDDisplayParameters::Read ( class ON_BinaryArchive & archive )

◆ SetAbsoluteDisplayDensity()

void ON_SubDDisplayParameters::SetAbsoluteDisplayDensity ( unsigned int absolute_display_density )

Description: In almost all cases, you are better off using SetAdaptiveDisplayDensity(). Parameters: absolute_display_density - [in] absolute_display_density <= ON_SubDDisplayParameters::MaximumDensity Remarks: The use of this setting

◆ SetAdaptiveDisplayDensity()

void ON_SubDDisplayParameters::SetAdaptiveDisplayDensity ( unsigned int adaptive_display_density )

Description: Set an adaptive SubD display density that caps display mesh quad count at ON_SubDDisplayParameters::AdaptiveDisplayMeshQuadMaximum. Parameters: adaptive_display_density - [in] adaptive_display_density <= ON_SubDDisplayParameters::MaximumDensity Values <= ON_SubDDisplayParameters::MinimumAdaptiveDensity will never be adaptively reduced during display mesh creation. Remarks: The use of this setting

◆ SetComputeCurvature()

void ON_SubDDisplayParameters::SetComputeCurvature ( bool compute_curvature )

Description: The ComputeCurvature() property determines if the mesh has curvature values. Parameters: compute_curvature - [in]

◆ SetContextForExperts()

void ON_SubDDisplayParameters::SetContextForExperts ( ON_SubDDisplayParameters::Context context )

◆ SetDisplayDensity()

void ON_SubDDisplayParameters::SetDisplayDensity ( unsigned int adaptive_display_density )

Deprecated:: Use SetAdaptiveDisplayDensity()

◆ SetMeshLocation()

void ON_SubDDisplayParameters::SetMeshLocation ( ON_SubDComponentLocation mesh_location )

Description: The MeshLocation() property determines if the mesh is on the SubD's control net or the SubD's surface. Parameters: mesh_location - [in]

◆ SetProgressReporter()

void ON_SubDDisplayParameters::SetProgressReporter	(	ON_ProgressReporter *	progress_reporter,
		ON_Interval	progress_reporter_interval
	)

◆ SetTerminator()

void ON_SubDDisplayParameters::SetTerminator ( ON_Terminator * terminator )

◆ Terminator()

ON_Terminator* ON_SubDDisplayParameters::Terminator ( ) const

TODO - split this class into two - what's above and one derived from that with what's below.

◆ Write()

bool ON_SubDDisplayParameters::Write ( class ON_BinaryArchive & archive ) const

Member Data Documentation

◆ Coarse

const ON_SubDDisplayParameters ON_SubDDisplayParameters::Coarse

static

Parameters for a course limit surface display mesh. SubD display density = adaptive ON_SubDDisplayParameters::CoarseDensity

◆ Default

const ON_SubDDisplayParameters ON_SubDDisplayParameters::Default

static

Parameters for the default limit surface display mesh. SubD display density = adaptive ON_SubDDisplayParameters::DefaultDensity

◆ Empty

const ON_SubDDisplayParameters ON_SubDDisplayParameters::Empty

static

◆ ExtraCoarse

const ON_SubDDisplayParameters ON_SubDDisplayParameters::ExtraCoarse

static

Parameters for a course limit surface display mesh. SubD display density = adaptive ON_SubDDisplayParameters::ExtraCoarseDensity

◆ ExtraFine

const ON_SubDDisplayParameters ON_SubDDisplayParameters::ExtraFine

static

Parameters for an extra fine limit surface display mesh. SubD display density = adaptive ON_SubDDisplayParameters::ExtraFineDensity

◆ Fine

const ON_SubDDisplayParameters ON_SubDDisplayParameters::Fine

static

Parameters for the default limit surface display mesh. Produces and acceptable rendering of the SubD Rhino logo. SubD display density = adaptive ON_SubDDisplayParameters::FineDensity (default)

◆ Medium

const ON_SubDDisplayParameters ON_SubDDisplayParameters::Medium

static

Parameters for a medium limit surface display mesh. SubD display density = adaptive ON_SubDDisplayParameters::MediumDensity Too crude for a quality rendering of the SubD Rhino logo.

Public Types

Public Member Functions

Static Public Member Functions

Static Public Attributes

Detailed Description

Member Enumeration Documentation

◆ anonymous enum

◆ anonymous enum

◆ Context

Constructor & Destructor Documentation

◆ ON_SubDDisplayParameters() [1/2]

◆ ~ON_SubDDisplayParameters()

◆ ON_SubDDisplayParameters() [2/2]

Member Function Documentation

◆ AbsoluteDisplayDensityFromSubD()

◆ AbsoluteDisplayDensityFromSubDFaceCount()

◆ ComputeCurvature()

◆ ContextForExperts()

◆ CreateFromAbsoluteDisplayDensity()

◆ CreateFromDisplayDensity()

◆ CreateFromMeshDensity()

◆ DecodeFromUnsignedChar()

◆ DisplayDensity() [1/2]

◆ DisplayDensity() [2/2]

◆ DisplayDensityIsAbsolute()

◆ DisplayDensityIsAdaptive()

◆ Dump()

◆ EncodeAsUnsignedChar()

◆ GetRawDisplayDensityForExperts()

◆ MeshLocation()

◆ operator=()

◆ ProgressReporter()

◆ ProgressReporterInterval()

◆ Read()

◆ SetAbsoluteDisplayDensity()

◆ SetAdaptiveDisplayDensity()

◆ SetComputeCurvature()

◆ SetContextForExperts()

◆ SetDisplayDensity()

◆ SetMeshLocation()

◆ SetProgressReporter()

◆ SetTerminator()

◆ Terminator()

◆ Write()

Member Data Documentation

◆ Coarse

◆ Default

◆ Empty

◆ ExtraCoarse

◆ ExtraFine

◆ Fine

◆ Medium