MAQUETTE DESSIN MODELISATION. More...

#include <Draw.hxx>

Static Public Member Functions
static void	Load (Draw_Interpretor &theDI, const TCollection_AsciiString &theKey, const TCollection_AsciiString &theResourceFileName, const TCollection_AsciiString &theDefaultsDirectory, const TCollection_AsciiString &theUserDefaultsDirectory, const Standard_Boolean theIsVerbose=Standard_False)
	(Re)Load a Draw Harness plugin. More...

Tcl variables management tools
static void	Set (const Standard_CString Name, const Handle< Draw_Drawable3D > &D, const Standard_Boolean Disp)
	Sets a variable. Display it if <Disp> is true. More...

static void	Set (const Standard_CString Name, const Handle< Draw_Drawable3D > &D)
	Sets a variable, a null handle clear the vartiable. Automatic display is context driven. More...

static void	Set (const Standard_CString Name, const Standard_Real val)
	Sets a numeric variable. More...

static Draw_Interpretor &	GetInterpretor ()
	Returns main DRAW interpretor. More...

static Handle< Draw_Drawable3D >	Get (Standard_CString &theName)
	Returns a variable value. The name "." does a graphic selection; in this case theName will be is overwritten with the name of the variable. More...

static Handle< Draw_Drawable3D >	GetExisting (const Standard_CString &theName)
	Returns a variable value. More...

static Standard_Boolean	Get (const Standard_CString Name, Standard_Real &val)
	Gets a numeric variable. Returns True if the variable exist. More...

static void	Set (const Standard_CString Name, const Standard_CString val)
	Sets a TCL string variable. More...

static const NCollection_Map< Handle< Draw_Drawable3D > > &	Drawables ()
	Returns a map of Draw_Drawable3D variables. More...

argument parsing tools
static Standard_Real	Atof (const Standard_CString Name)
	Converts numeric expression, that can involve DRAW variables, to real value. More...

static bool	ParseReal (const Standard_CString theExpressionString, Standard_Real &theParsedRealValue)
	Converts the numeric expression, that can involve DRAW variables, to a real value. More...

static Standard_Integer	Atoi (const Standard_CString Name)
	Converts numeric expression, that can involve DRAW variables, to integer value. Implemented as cast of Atof() to integer. More...

static bool	ParseInteger (const Standard_CString theExpressionString, Standard_Integer &theParsedIntegerValue)
	Converts the numeric expression, that can involve DRAW variables, to an integer value. More...

static Standard_Integer	ParseColor (const Standard_Integer theArgNb, const char const const theArgVec, Quantity_ColorRGBA &theColor)
	Parses RGB(A) color argument(s) specified within theArgVec[0], theArgVec[1], theArgVec[2] and theArgVec[3]. Handles either color specified by name (single argument) or by RGB(A) components (3-4 arguments) in range 0..1. The result is stored in theColor on success. More...

static Standard_Integer	ParseColor (const Standard_Integer theArgNb, const char const const theArgVec, Quantity_Color &theColor)
	Parses RGB color argument(s). More...

static Standard_Boolean	ParseOnOff (Standard_CString theArg, Standard_Boolean &theIsOn)
	Parses boolean argument. Handles either flag specified by 0\|1 or on\|off. More...

static Standard_Boolean	ParseOnOffIterator (Standard_Integer theArgsNb, const char **theArgVec, Standard_Integer &theArgIter)
	Parses boolean argument at specified iterator position with optional on/off coming next. More...

static Standard_Boolean	ParseOnOffNoIterator (Standard_Integer theArgsNb, const char **theArgVec, Standard_Integer &theArgIter)
	Parses boolean argument at specified iterator position with optional on/off coming next. Similar to ParseOnOffIterator() but also reverses returned value if argument name starts with "no" prefix. E.g. if nominal argument is "cmd -usefeature [on\|off\|1\|0]=on", then "-nousefeature" argument will return FALSE. More...

static void	LastPick (Standard_Integer &view, Standard_Integer &X, Standard_Integer &Y, Standard_Integer &button)
	Returns last graphic selection description. More...

static void	Repaint ()
	Asks to repaint the screen after the current command. More...

static void	SetProgressBar (const Handle< Draw_ProgressIndicator > &theProgress)
	sets progress indicator More...

static Handle< Draw_ProgressIndicator >	GetProgressBar ()
	gets progress indicator More...

methods loading standard command sets
static void	Commands (Draw_Interpretor &I)
	Defines all Draw commands. More...

static void	BasicCommands (Draw_Interpretor &I)
	Defines Draw basic commands. More...

static void	MessageCommands (Draw_Interpretor &I)
	Defines Draw message commands. More...

static void	VariableCommands (Draw_Interpretor &I)
	Defines Draw variables handling commands. More...

static void	GraphicCommands (Draw_Interpretor &I)
	Defines Draw variables handling commands. More...

static void	PloadCommands (Draw_Interpretor &I)
	Defines Loads Draw plugins commands. More...

static void	UnitCommands (Draw_Interpretor &I)
	Defines Draw unit commands. More...

static Handle< Draw_Drawable3D >	getDrawable (Standard_CString &theName, Standard_Boolean theToAllowPick)
	Returns a variable value. More...

static Standard_Integer	parseColor (Standard_Integer theArgNb, const char const theArgVec, Quantity_ColorRGBA &theColor, bool theToParseAlpha)
	Parses RGB(A) color argument(s) specified within theArgVec[0], theArgVec[1], theArgVec[2] and theArgVec[3]. Handles either color specified by name (single argument) or by RGB(A) components (3-4 arguments) in range 0..1. The result is stored in theColor on success. Returns number of handled arguments (1, 2, 3 or 4) or 0 on syntax error. More...

Detailed Description

MAQUETTE DESSIN MODELISATION.

Member Function Documentation

◆ Atof()

static Standard_Real Draw::Atof ( const Standard_CString Name )

static

Converts numeric expression, that can involve DRAW variables, to real value.

◆ Atoi()

static Standard_Integer Draw::Atoi ( const Standard_CString Name )

static

Converts numeric expression, that can involve DRAW variables, to integer value. Implemented as cast of Atof() to integer.

◆ BasicCommands()

static void Draw::BasicCommands ( Draw_Interpretor & I )

static

Defines Draw basic commands.

◆ Commands()

static void Draw::Commands ( Draw_Interpretor & I )

static

Defines all Draw commands.

◆ Drawables()

static const NCollection_Map<Handle< Draw_Drawable3D > >& Draw::Drawables ( )

static

Returns a map of Draw_Drawable3D variables.

◆ Get() [1/2]

static Standard_Boolean Draw::Get	(	const Standard_CString	Name,
		Standard_Real &	val
	)

static

Gets a numeric variable. Returns True if the variable exist.

◆ Get() [2/2]

static Handle< Draw_Drawable3D > Draw::Get ( Standard_CString & theName )

inlinestatic

Returns a variable value. The name "." does a graphic selection; in this case theName will be is overwritten with the name of the variable.

◆ getDrawable()

static Handle< Draw_Drawable3D > Draw::getDrawable	(	Standard_CString &	theName,
		Standard_Boolean	theToAllowPick
	)

staticprotected

Returns a variable value.

Parameters

theName	[in] [out] variable name, or "." to activate picking
theToAllowPick	[in] when TRUE, "." name will activate picking

◆ GetExisting()

static Handle< Draw_Drawable3D > Draw::GetExisting ( const Standard_CString & theName )

inlinestatic

Returns a variable value.

◆ GetInterpretor()

static Draw_Interpretor& Draw::GetInterpretor ( )

static

Returns main DRAW interpretor.

◆ GetProgressBar()

static Handle< Draw_ProgressIndicator > Draw::GetProgressBar ( )

static

gets progress indicator

◆ GraphicCommands()

static void Draw::GraphicCommands ( Draw_Interpretor & I )

static

Defines Draw variables handling commands.

◆ LastPick()

static void Draw::LastPick	(	Standard_Integer &	view,
		Standard_Integer &	X,
		Standard_Integer &	Y,
		Standard_Integer &	button
	)

static

Returns last graphic selection description.

◆ Load()

static void Draw::Load	(	Draw_Interpretor &	theDI,
		const TCollection_AsciiString &	theKey,
		const TCollection_AsciiString &	theResourceFileName,
		const TCollection_AsciiString &	theDefaultsDirectory,
		const TCollection_AsciiString &	theUserDefaultsDirectory,
		const Standard_Boolean	theIsVerbose = `Standard_False`
	)

static

(Re)Load a Draw Harness plugin.

Parameters

theDI	[in] [out] Tcl interpretor to append loaded commands
theKey	[in] plugin code name to be resolved in resource file
theResourceFileName	[in] description file name
theDefaultsDirectory	[in] default folder for looking description file
theUserDefaultsDirectory	[in] user folder for looking description file
theIsVerbose	[in] print verbose messages

◆ MessageCommands()

static void Draw::MessageCommands ( Draw_Interpretor & I )

static

Defines Draw message commands.

◆ ParseColor() [1/2]

static Standard_Integer Draw::ParseColor	(	const Standard_Integer	theArgNb,
		const char const const	theArgVec,
		Quantity_Color &	theColor
	)

inlinestatic

Parses RGB color argument(s).

Parameters

theArgNb	[in] number of available arguments in theArgVec (array limits)
theArgVec	[in] argument list
theColor	[out] retrieved color

Returns: number of handled arguments (1 or 3) or 0 on syntax error.

◆ ParseColor() [2/2]

static Standard_Integer Draw::ParseColor	(	const Standard_Integer	theArgNb,
		const char const const	theArgVec,
		Quantity_ColorRGBA &	theColor
	)

inlinestatic

Parses RGB(A) color argument(s) specified within theArgVec[0], theArgVec[1], theArgVec[2] and theArgVec[3]. Handles either color specified by name (single argument) or by RGB(A) components (3-4 arguments) in range 0..1. The result is stored in theColor on success.

Usage code sample for command argument in form "cmd -color {ColorName|R G B [A]|ColorHex}":

for (int anArgIter = 1; anArgIter < theNbArgs; ++anArgIter)
{
  TCollection_AsciiString aParam (theArgVec[anArgIter]);
  aParam.LowerCase();
  if (aParam == "-color")
  {
    Quantity_ColorRGBA aColor;
    Standard_Integer aNbParsed = Draw::ParseColor (theArgNb  - anArgIter - 1,
                                                   theArgVec + anArgIter + 1, aColor);
    anArgIter += aNbParsed;
    if (aNbParsed == 0) { std::cerr << "Syntax error at '" << aParam << "'"; return 1; }
    // process color
  }
}

Parameters

theArgNb	[in] number of available arguments in theArgVec (array limits)
theArgVec	[in] argument list
theColor	[out] retrieved color

Returns: number of handled arguments (1, 2, 3 or 4) or 0 on syntax error

◆ parseColor()

static Standard_Integer Draw::parseColor	(	Standard_Integer	theArgNb,
		const char const	theArgVec,
		Quantity_ColorRGBA &	theColor,
		bool	theToParseAlpha
	)

staticprotected

Parses RGB(A) color argument(s) specified within theArgVec[0], theArgVec[1], theArgVec[2] and theArgVec[3]. Handles either color specified by name (single argument) or by RGB(A) components (3-4 arguments) in range 0..1. The result is stored in theColor on success. Returns number of handled arguments (1, 2, 3 or 4) or 0 on syntax error.

◆ ParseInteger()

static bool Draw::ParseInteger	(	const Standard_CString	theExpressionString,
		Standard_Integer &	theParsedIntegerValue
	)

static

Converts the numeric expression, that can involve DRAW variables, to an integer value.

Parameters

theExpressionString	the strings that contains the expression involving DRAW variables to be parsed
theParsedIntegerValue	an integer value that is a result of parsing

Returns: true if parsing was successful, or false otherwise

◆ ParseOnOff()

static Standard_Boolean Draw::ParseOnOff	(	Standard_CString	theArg,
		Standard_Boolean &	theIsOn
	)

static

Parses boolean argument. Handles either flag specified by 0|1 or on|off.

Usage code sample for command argument in form "cmd -usefeature [on|off|1|0]=on":

for (int anArgIter = 1; anArgIter < theNbArgs; ++anArgIter)
{
  TCollection_AsciiString aParam (theArgVec[anArgIter]);
  aParam.LowerCase();
  if (aParam == "-usefeature")
  {
    bool toUseFeature = true;
    if (anArgIter + 1 < theNbArgs && Draw::ParseOnOff (theArgVec[anArgIter + 1]))
    {
      ++anArgIter;
    }
    // process feature
  }
}

Parameters

theArg	[in] argument value
theIsOn	[out] decoded Boolean flag

Returns: FALSE on syntax error

◆ ParseOnOffIterator()

static Standard_Boolean Draw::ParseOnOffIterator	(	Standard_Integer	theArgsNb,
		const char **	theArgVec,
		Standard_Integer &	theArgIter
	)

static

Parses boolean argument at specified iterator position with optional on/off coming next.

Usage code sample for command argument in form "cmd -usefeature [on|off|1|0]=on":

for (int anArgIter = 1; anArgIter < theNbArgs; ++anArgIter)
{
  if (strcasecmp (theArgVec[anArgIter], "-usefeature") == 0)
  {
    bool toUseFeature = Draw::ParseOnOffIterator (theNbArgs, theArgVec, anArgIter);
    // process feature
  }
}

Parameters

theArgsNb	[in] overall number of arguments
theArgVec	[in] vector of arguments
theArgIter	[in] [out] argument position to parse

Returns: flag value

◆ ParseOnOffNoIterator()

static Standard_Boolean Draw::ParseOnOffNoIterator	(	Standard_Integer	theArgsNb,
		const char **	theArgVec,
		Standard_Integer &	theArgIter
	)

static

Parses boolean argument at specified iterator position with optional on/off coming next. Similar to ParseOnOffIterator() but also reverses returned value if argument name starts with "no" prefix. E.g. if nominal argument is "cmd -usefeature [on|off|1|0]=on", then "-nousefeature" argument will return FALSE.

Parameters

theArgsNb	[in] overall number of arguments
theArgVec	[in] vector of arguments
theArgIter	[in] [out] argument position to parse

Returns: flag value

◆ ParseReal()

static bool Draw::ParseReal	(	const Standard_CString	theExpressionString,
		Standard_Real &	theParsedRealValue
	)

static

Converts the numeric expression, that can involve DRAW variables, to a real value.

Parameters

theExpressionString	the strings that contains the expression involving DRAW variables to be parsed
theParsedRealValue	a real value that is a result of parsing

Returns: true if parsing was successful, or false otherwise

◆ PloadCommands()

static void Draw::PloadCommands ( Draw_Interpretor & I )

static

Defines Loads Draw plugins commands.

◆ Repaint()

static void Draw::Repaint ( )

static

Asks to repaint the screen after the current command.

◆ Set() [1/4]

static void Draw::Set	(	const Standard_CString	Name,
		const Handle< Draw_Drawable3D > &	D
	)

static

Sets a variable, a null handle clear the vartiable. Automatic display is context driven.

◆ Set() [2/4]

static void Draw::Set	(	const Standard_CString	Name,
		const Handle< Draw_Drawable3D > &	D,
		const Standard_Boolean	Disp
	)

static

Sets a variable. Display it if <Disp> is true.

◆ Set() [3/4]

static void Draw::Set	(	const Standard_CString	Name,
		const Standard_CString	val
	)

static

Sets a TCL string variable.

◆ Set() [4/4]

static void Draw::Set	(	const Standard_CString	Name,
		const Standard_Real	val
	)

static

Sets a numeric variable.

◆ SetProgressBar()

static void Draw::SetProgressBar ( const Handle< Draw_ProgressIndicator > & theProgress )

static

sets progress indicator

◆ UnitCommands()

static void Draw::UnitCommands ( Draw_Interpretor & I )

static

Defines Draw unit commands.

◆ VariableCommands()

static void Draw::VariableCommands ( Draw_Interpretor & I )

static

Defines Draw variables handling commands.

The documentation for this class was generated from the following file:

Draw.hxx

Draw Class Reference

Static Public Member Functions

methods loading standard command sets

Detailed Description

Member Function Documentation

◆ Atof()

◆ Atoi()

◆ BasicCommands()

◆ Commands()

◆ Drawables()

◆ Get() [1/2]

◆ Get() [2/2]

◆ getDrawable()

◆ GetExisting()

◆ GetInterpretor()

◆ GetProgressBar()

◆ GraphicCommands()

◆ LastPick()

◆ Load()

◆ MessageCommands()

◆ ParseColor() [1/2]

◆ ParseColor() [2/2]

◆ parseColor()

◆ ParseInteger()

◆ ParseOnOff()

◆ ParseOnOffIterator()

◆ ParseOnOffNoIterator()

◆ ParseReal()

◆ PloadCommands()

◆ Repaint()

◆ Set() [1/4]

◆ Set() [2/4]

◆ Set() [3/4]

◆ Set() [4/4]

◆ SetProgressBar()

◆ UnitCommands()

◆ VariableCommands()