MarkerAttributeControl

class MarkerAttributeControl : public HPS::Control

The HPS::MarkerAttributeControl class is a smart pointer that is tied to a database object. This control allows you to manipulate the marker size and symbol at the segment level.

This table lists default values for the various segment attributes accessible from HPS::MarkerAttributeControl.

Public Functions

MarkerAttributeControl(MarkerAttributeControl &&in_that)

The move constructor creates a MarkerAttributeControl by transferring the underlying impl of the rvalue reference to this MarkerAttributeControl thereby avoiding a copy and allocation.

Parameters:

in_that – An rvalue reference to a MarkerAttributeControl to take the impl from.

MarkerAttributeControl(MarkerAttributeControl const &in_that)

Initializes a control tied to the same object as in_that.

explicit MarkerAttributeControl(SegmentKey &in_seg)

Initializes a control tied to the segment in_seg.

inline virtual HPS::Type ObjectType() const

This function returns the type the object, as declared (if the object is derived, this does not give the true type of the derived object).

Returns:

The declared type of the object in question, which may differ from the true, underlying type.

MarkerAttributeControl &operator=(MarkerAttributeControl &&in_that)

The move assignment operator transfers the underlying impl of the rvalue reference to this MarkerAttributeControl thereby avoiding a copy.

Parameters:

in_that – An rvalue reference to a MarkerAttributeControl to take the impl from.

Returns:

A reference to this MarkerAttributeControl.

MarkerAttributeControl &operator=(MarkerAttributeControl const &in_that)

Share the underlying smart-pointer of the MarkerAttributeControl source.

Parameters:

in_that – The MarkerAttributeControl source of the assignment.

Returns:

A reference to this MarkerAttributeControl.

MarkerAttributeControl &SetDrawingPreference(Marker::DrawingPreference in_preference)

Sets the drawing method for markers. Fastest will draw at requested size, unless that would incur performance cost. Nicest will anyway.

Parameters:

in_preference – The preferred drawing style.

Returns:

A reference to this object.

MarkerAttributeControl &SetGlyphRotation(float in_rotation)

Sets the glyph rotation option.

Parameters:

in_rotation – The rotation for glyphs.

Returns:

A reference to this object.

MarkerAttributeControl &SetSize(float in_size, Marker::SizeUnits in_units = Marker::SizeUnits::ScaleFactor)

Sets the size of markers.

Parameters:
  • in_size – The size for markers.

  • in_units – The units of the size for markers.

Returns:

A reference to this object.

MarkerAttributeControl &SetSymbol(char const *in_glyph_name)

Sets the glyph that should be used to draw markers.

Parameters:

in_glyph_name – A UTF8 encoded name of a glyph, defined in an accessible portfolio.

Returns:

A reference to this object.

bool ShowDrawingPreference(Marker::DrawingPreference &out_preference) const

Shows the drawing method for markers.

Parameters:

out_preference – The preferred drawing style. return true if the setting is valid, false otherwise.

bool ShowGlyphRotation(float &out_rotation) const

Shows the glyph rotation.

Parameters:

out_rotation – The rotation value. return true if the setting is valid, false otherwise.

bool ShowSize(float &out_size, Marker::SizeUnits &out_units) const

Shows the size of markers.

Parameters:
  • out_size – The size for markers.

  • out_units – The units of the size for markers.

Returns:

true if the setting is valid, false otherwise.

bool ShowSymbol(UTF8 &out_glyph_name) const

Shows the glyph that should be used to draw markers.

Parameters:

out_glyph_name – A UTF8 encoded name of a glyph, defined in an accessible portfolio.

Returns:

true if the setting is valid, false otherwise.

MarkerAttributeControl &UnsetDrawingPreference()

Removes the drawing preference setting

Returns:

A reference to this object.

MarkerAttributeControl &UnsetEverything()

Removes all settings from this object. If the control is attached to a WindowKey this function restores the default settings of this control as specified by MarkerAttributeKit::GetDefault().

Returns:

A reference to this object.

MarkerAttributeControl &UnsetGlyphRotation()

Removes the glyph rotation setting

Returns:

A reference to this object.

MarkerAttributeControl &UnsetSize()

Removes the marker size setting. If the control is attached to a WindowKey this function restores the default value of this setting as specified by MarkerAttributeKit::GetDefault().

Returns:

A reference to this object.

MarkerAttributeControl &UnsetSymbol()

Removes the marker symbol setting. If the control is attached to a WindowKey this function restores the default value of this setting as specified by MarkerAttributeKit::GetDefault().

Returns:

A reference to this object.

~MarkerAttributeControl()

Releases a reference to the database object this control is tied to.

Public Static Attributes

static const HPS::Type staticType = HPS::Type::MarkerAttributeControl