OEHighlightByLasso¶

class OEHighlightByLasso : public OEHighlightBase

The OEHighlightByLasso class allows the customization of the lasso highlighting style that is associated with the OEHighlightStyle::Lasso constant. See example in Figure: Example of highlighting using the ‘lasso’ style.

../../_images/OEHighlightStyle_Lasso.png

Example of highlighting using the ‘lasso’ style¶

The OEHighlightByLasso class stores the following properties:

Property	Get method	Set method	Corresponding namespace / class / type
atom label color	`GetAtomLabelMonochrome`	`SetAtomLabelMonochrome`	boolean
atom label box	`GetConsiderAtomLabelBoundingBox`	`SetConsiderAtomLabelBoundingBox`	boolean
color	`GetColor`	`SetColor`	OEColor
pen	`GetPen`	`SetPen`	OEPen
position	`GetPosition`	`SetPosition`	`OELayerPosition` namespace
lasso scale	`GetLassoScale`	`SetLassoScale`	floating point number
line width scale	`GetLineWidthScale`	`SetLineWidthScale`	floating point

See also

Constructors¶

OEHighlightByLasso(const OESystem::OEColor &color,
                   double lassoScale=3.0,
                   bool monochrome=true,
                   bool considerAtomLabelBox = false,
                   unsigned int position = OELayerPosition::Below,
                   double lineWidthScale = 1.0)

Creates an OEHighlightByLasso object with the specified parameters.

color: The color used for highlighting. See also OEHighlightByLasso::SetColor method.
lassoScale: The multiplier that can be used to increase or decrease the distance of the “lasso” from the highlighted atom(s) and bond(s). See also OEHighlightByLasso::SetLassoScale method.
monochrome: Defines whether or not to change the color of the atom label of the highlighted atom(s). See also OEHighlightByLasso::SetAtomLabelMonochrome method.
considerAtomLabelBox: Determines whether or not to consider the atom label bounding boxes when generating the ‘lasso’ highlights. See also OEHighlightByLasso::SetConsiderAtomLabelBoundingBox method.
position: Defines whether the ‘lasso’ highlight is going to be rendered below or above the molecule. See also OEHighlightByLasso::SetPosition method.
lineWidthScale: The multiplier that can be used to increase or decrease the line width of lasso. See also OEHighlightByLasso::SetLineWidthScale method.

OEHighlightByLasso(const OEHighlightByLasso &rhs)

Copy constructor.

operator=¶

OEHighlightByLasso &operator=(const OEHighlightByLasso &rhs)

Assignment operator.

CreateCopy¶

OEHighlightBase *CreateCopy() const

Deep copy constructor that returns a copy of the object. The memory for the returned OEHighlightByLasso object is dynamically allocated and owned by the caller.

GetAtomLabelMonochrome¶

bool GetAtomLabelMonochrome() const

Returns whether or not the color of the atom label of the highlighted atom(s) is changed.

See also

OEHighlightByLasso::SetAtomLabelMonochrome method

GetConsiderAtomLabelBoundingBox¶

bool GetConsiderAtomLabelBoundingBox() const

Returns whether or not to consider the atom label bounding boxes when generating the ‘lasso’ highlights.

See also

OEHighlightByLasso::SetConsiderAtomLabelBoundingBox method

GetLassoScale¶

double GetLassoScale() const

Returns the multiplier that can be used to increase or decrease the distance of the line of the ‘lasso’ from the highlighted atom(s) and bonds(s).

See also

OEHighlightByLasso::SetLassoScale method

GetLineWidthScale¶

double GetLineWidthScale() const

Returns the multiplier that can be used to increase or decrease the line width of the lasso.

See also

OEHighlightByLasso::SetLineWidthScale method

GetColor¶

const OESystem::OEColor &GetColor() const

Returns the foreground color of the highlighting.

See also

OEHighlightByLasso::GetColor method
OEColor class

GetPen¶

const OEPen &GetPen() const

Returns the pen of the highlighting.

See also

OEHighlightByLasso::SetPen method
OEPen class

GetPosition¶

unsigned int GetPosition() const

Returns whether the ‘lasso’ highlight is going to be render above or below the molecule. The return value is taken from the OELayerPosition namespace.

See also

OEHighlightByLasso::SetPosition method
OELayerPosition namespace

SetAtomLabelMonochrome¶

void SetAtomLabelMonochrome(bool monochrome)

Sets whether or not to change the color of the atom label of the highlighted atom(s).

Example (Figure: Example of using the SetAtomLabelMonochrome method)

OEHighlightByLasso highlight(OEDarkGreen);
highlight.SetAtomLabelMonochrome(false);

../../_images/OEHighlightByLasso_SetAtomLabelMonochrome.png

Example of using the SetAtomLabelMonochrome method¶

See also

OEHighlightByLasso::GetAtomLabelMonochrome method

SetConsiderAtomLabelBoundingBox¶

void SetConsiderAtomLabelBoundingBox(bool consider)

Sets whether or not to consider the atom label bounding boxes when generating the ‘lasso’ highlights. By considering the bounding boxes, the number cases when the lines of the highlight clash with the atom label can be reduced.

Example (Figure: Example of using the SetConsiderAtomLabelBoundingBox method)

OEHighlightByLasso highlight(OEDarkGreen);
highlight.SetConsiderAtomLabelBoundingBox(true);

../../_images/OEHighlightByLasso_SetConsiderAtomLabelBoundingBox.png

Example of using the SetConsiderAtomLabelBoundingBox method¶

See also

OEHighlightByLasso::SetConsiderAtomLabelBoundingBox method

SetLassoScale¶

void SetLassoScale(double lassoScale)

Sets the multiplier that can be used to increase or decrease the distance of the line of the ‘lasso’ from the highlighted atom(s) and bond(s).

Example (Figure: Example of using the SetLassoScale method)

OEHighlightByLasso highlight(OEDarkGreen);
highlight.SetLassoScale(6.0);

../../_images/OEHighlightByLasso_SetLassoScale.png

Example of using the SetLassoScale method¶

See also

OEHighlightByLasso::GetLassoScale method

SetLineWidthScale¶

void SetLineWidthScale(double lineWidthScale)

Sets the multiplier that can be used to increase or decrease the line width of the lasso.

Example (Figure: Example of using the SetLineWidthScale method)

OEHighlightByLasso  highlight(OEDarkGreen);
highlight.SetLineWidthScale(3.0);

../../_images/OEHighlightByLasso_SetLineWidthScale.png

Example of using the SetLineWidthScale method¶

See also

OEHighlightByLasso::GetLineWidthScale method

SetColor¶

void SetColor(const OESystem::OEColor &color)

Sets the foreground color of the highlighting.

Example (Figure: Example of using the SetColor method)

highlight.SetColor(OEDarkGreen);

../../_images/OEHighlightByLasso_SetColor.png

Example of using the SetColor method¶

See also

OEHighlightByLasso::GetColor method
OEColor class

SetPen¶

void SetPen(const OEPen &pen)

Sets the pen of the highlighting.

Example (Figure: Example of using the SetPen method)

OEPen pen(OEGreenTint, OEDarkGreen, OEFill::On, 3.0, OEStipple::ShortDash);
highlight.SetPen(pen);

../../_images/OEHighlightByLasso_SetPen.png

Example of using the SetPen method¶

See also

OEHighlightByLasso::GetPen method
OEPen class

SetPosition¶

void SetPosition(unsigned int position)

Sets whether the ‘lasso’ highlight is going to be render above or below the molecule.

position: This value has to be from the OELayerPosition namespace.

See also

OEHighlightByLasso::GetPosition method