SAGA API v9.10
Loading...
Searching...
No Matches
CSG_Tool Class Referenceabstract

#include <tool.h>

Inheritance diagram for CSG_Tool:
CSG_Tool_Chain CSG_Tool_Grid CSG_Tool_Interactive CSG_Tool_Grid_Interactive

Public Types

enum class  Script_Format {
  CMD_Shell , CMD_Batch , CMD_Usage , Toolchain ,
  Python , Python_Wrapper_Func_Name , Python_Wrapper_Func_ID , Python_Wrapper_Call_Name ,
  Python_Wrapper_Call_ID , Markdown_Table
}

Public Member Functions

 CSG_Tool (void)
virtual ~CSG_Tool (void)
virtual void Destroy (void)
virtual TSG_Tool_Type Get_Type (void) const
const CSG_StringGet_ID (void) const
const CSG_StringGet_Library (void) const
const CSG_StringGet_File_Name (void) const
const CSG_StringGet_Name (void) const
const CSG_StringGet_Author (void) const
const CSG_StringGet_Version (void) const
const CSG_StringGet_Description (void) const
const CSG_StringsGet_References (void) const
const SG_CharGet_Icon (void)
CSG_String Get_Summary (bool bParameters=true, const CSG_String &Menu="", const CSG_String &Description="", int Format=SG_SUMMARY_FMT_HTML)
virtual CSG_String Get_MenuPath (void)
virtual CSG_String Get_MenuPath (bool bSolved)
CSG_ParametersGet_Parameters (void)
int Get_Parameters_Count (void) const
CSG_ParametersGet_Parameters (int i) const
CSG_ParametersGet_Parameters (int i)
CSG_ParametersGet_Parameters (const CSG_String &Identifier) const
CSG_ParameterGet_Parameter (const CSG_String &ID) const
CSG_ParameterGet_Parameter (const char *ID) const
CSG_ParameterGet_Parameter (const wchar_t *ID) const
bool Set_Parameter (const CSG_String &ID, CSG_Parameter *pValue)
bool Set_Parameter (const char *ID, CSG_Parameter *pValue)
bool Set_Parameter (const wchar_t *ID, CSG_Parameter *pValue)
bool Set_Parameter (const CSG_String &ID, int Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, int Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, int Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const CSG_String &ID, double Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, double Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, double Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const CSG_String &ID, void *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, void *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, void *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const CSG_String &ID, const CSG_String &Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, const CSG_String &Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, const CSG_String &Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const CSG_String &ID, const char *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, const char *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, const char *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const CSG_String &ID, const wchar_t *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const char *ID, const wchar_t *Value, int Type=PARAMETER_TYPE_Undefined)
bool Set_Parameter (const wchar_t *ID, const wchar_t *Value, int Type=PARAMETER_TYPE_Undefined)
bool Reset (bool bManager=true)
bool Reset_Manager (void)
bool Reset_Grid_System (void)
bool Update_Parameter_States (void)
void Set_Callback (bool bActive=true)
bool Set_Manager (class CSG_Data_Manager *pManager)
class CSG_Data_ManagerGet_Manager (void) const
class CSG_Data_ManagerCreate_Manager (void)
bool Delete_Manager (bool bDetachData=false, bool bReset=true)
bool Set_Grid_System (const CSG_Grid_System &System)
CSG_Grid_SystemGet_Grid_System (void) const
bool Settings_Push (class CSG_Data_Manager *pManager=NULL)
bool Settings_Pop (void)
virtual bool do_Sync_Projections (void) const
virtual bool needs_GUI (void) const
bool has_GUI (void) const
bool has_CMD (void) const
virtual bool is_Grid (void) const
virtual bool is_Interactive (void) const
bool is_Progress (void) const
bool is_Executing (void) const
void Set_Show_Progress (bool bOn=true)
virtual bool On_Before_Execution (void)
virtual bool On_After_Execution (void)
bool Execute (bool bAddHistory=false)
const SG_CharGet_Execution_Info (void) const
CSG_MetaData Get_History (int Depth=-1)
bool Set_History (CSG_Data_Object *pDataObject, int Depth=-1)
CSG_String Get_Script (Script_Format Format, bool bHeader=true, int Arguments=0, bool bWrapArgs=true)

Protected Member Functions

void Set_Name (const CSG_String &String)
void Set_Author (const CSG_String &String)
void Set_Version (const CSG_String &String)
void Set_Description (const CSG_String &String)
void Add_Reference (const CSG_String &Authors, const CSG_String &Year, const CSG_String &Title, const CSG_String &Where, const SG_Char *Link=NULL, const SG_Char *Link_Text=NULL)
void Add_Reference (const CSG_String &Link, const SG_Char *Link_Text=NULL)
virtual bool On_Execute (void)=0
virtual int On_Parameter_Changed (CSG_Parameters *pParameters, CSG_Parameter *pParameter)
virtual int On_Parameters_Enable (CSG_Parameters *pParameters, CSG_Parameter *pParameter)
TSG_PFNC_Parameter_Changed Get_Parameter_Changed (void)
CSG_ParametersAdd_Parameters (const CSG_String &Identifier, const CSG_String &Name, const CSG_String &Description)
bool Dlg_Parameters (const CSG_String &Identifier)
bool Dlg_Parameters (CSG_Parameters *pParameters, const CSG_String &Caption="")
bool Dlg_Parameters (CSG_Parameters &Parameters, const CSG_String &Caption="")
virtual bool Set_Progress (int Position, int Range) const
virtual bool Set_Progress (sLong Position, sLong Range) const
virtual bool Set_Progress (double Position, double Range=1.) const
bool Stop_Execution (bool bDialog=true)
void Message_Dlg (const CSG_String &Text, const SG_Char *Caption=NULL)
bool Message_Dlg_Confirm (const CSG_String &Text, const SG_Char *Caption=NULL)
void Message_Add (const CSG_String &Text, bool bNewLine=true)
void Message_Fmt (const char *Format,...)
void Message_Fmt (const wchar_t *Format,...)
bool Error_Set (TSG_Tool_Error Error_ID=TOOL_ERROR_Unknown)
bool Error_Set (const CSG_String &Text)
bool Error_Fmt (const char *Format,...)
bool Error_Fmt (const wchar_t *Format,...)
bool DataObject_Add (CSG_Data_Object *pDataObject, bool bUpdate=false)
bool DataObject_Update_All (void)
bool DataObject_Set_History (CSG_Parameter *pParameter, CSG_MetaData *pHistory=NULL)
bool Get_Projection (CSG_Projection &Projection) const

Static Protected Member Functions

static int _On_Parameter_Changed (CSG_Parameter *pParameter, int Flags)
static bool Process_Get_Okay (bool bBlink=false)
static void Process_Set_Text (const CSG_String &Text)
static void Process_Set_Text (const char *Format,...)
static void Process_Set_Text (const wchar_t *Format,...)
static bool DataObject_Update (CSG_Data_Object *pDataObject, int Show=SG_UI_DATAOBJECT_UPDATE)
static bool DataObject_Update (CSG_Data_Object *pDataObject, double Minimum, double Maximum, int Show=SG_UI_DATAOBJECT_UPDATE)
static bool DataObject_Get_Colors (CSG_Data_Object *pDataObject, CSG_Colors &Colors)
static bool DataObject_Set_Colors (CSG_Data_Object *pDataObject, const CSG_Colors &Colors)
static bool DataObject_Set_Colors (CSG_Data_Object *pDataObject, int nColors=0, int Colors=SG_COLORS_DEFAULT, bool bRevert=false)
static bool DataObject_Set_Colors (CSG_Data_Object *pDataObject, const CSG_String &Colors, int nColors=0, bool bRevert=false)
static bool DataObject_Get_Parameters (CSG_Data_Object *pDataObject, CSG_Parameters &Parameters)
static bool DataObject_Set_Parameters (CSG_Data_Object *pDataObject, CSG_Parameters &Parameters)
static bool DataObject_Set_Parameters (CSG_Data_Object *pDataObject, CSG_Data_Object *pCopy)
static CSG_ParameterDataObject_Get_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, CSG_Parameter *pParameter)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, CSG_Data_Object *pCopy, const CSG_String &ID)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID, int Value)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID, double Value)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID, void *Value)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID, const SG_Char *Value)
static bool DataObject_Set_Parameter (CSG_Data_Object *pDataObject, const CSG_String &ID, double loVal, double hiVal)
static bool DataObject_Set_Stretch_Linear (CSG_Data_Object *pDataObject, int Field=-1, double Minimum=5., double Maximum=95., int Interval_Mode=0, double Interval_Log=1., int Colors=-1, bool bUpdateNow=false)
static bool DataObject_Set_Stretch_StdDev (CSG_Data_Object *pDataObject, int Field=-1, double StdDev=2., bool bKeepInRange=false, int Interval_Mode=0, double Interval_Log=1., int Colors=-1, bool bUpdateNow=false)
static bool DataObject_Set_Stretch_Percentile (CSG_Data_Object *pDataObject, int Field=-1, double Minimum=2., double Maximum=98., int Interval_Mode=0, double Interval_Log=1., int Colors=-1, bool bUpdateNow=false)
static bool DataObject_Set_Stretch (CSG_Data_Object *pDataObject, int Field, double Minimum, double Maximum, int Interval_Mode=0, double Interval_Log=1., int Colors=-1, bool bUpdateNow=false)
static bool DataObject_Classify_Unique (CSG_Data_Object *pDataObject, int Field=-1, int Classes_Max=1024, int Colors=-1)
static bool DataObject_Classify_Equal (CSG_Data_Object *pDataObject, int Field=-1, int Classes=10, int Colors=-1)
static bool DataObject_Classify_Defined (CSG_Data_Object *pDataObject, int Field, double Interval, bool bOffset=false, double Offset=0., int Colors=-1)
static bool DataObject_Classify_Quantile (CSG_Data_Object *pDataObject, int Field=-1, int Classes=10, bool bHistogram=true, int Colors=-1)
static bool DataObject_Classify_Geometric (CSG_Data_Object *pDataObject, int Field=-1, int Classes=10, bool bIncreasing=true, int Colors=-1)
static bool DataObject_Classify_Natural (CSG_Data_Object *pDataObject, int Field=-1, int Classes=10, int Colors=-1)
static bool DataObject_Classify_StdDev (CSG_Data_Object *pDataObject, int Field=-1, double StdDev=0.5, double StdDev_Max=4.5, int Colors=-1)

Protected Attributes

CSG_Parameters Parameters
CSG_MetaData History_Supplement

Friends

class CSG_Tool_Interactive_Base
class CSG_Tool_Library_Interface
class CSG_Tool_Library_Manager
class CSG_Tool_Chain

Detailed Description

CSG_Tool is the base class for all executable SAGA tools.

See also
CSG_Parameters
CSG_Tool_Interactive
CSG_Tool_Grid
CSG_Tool_Grid_Interactive

Definition at line 134 of file tool.h.

Member Enumeration Documentation

◆ Script_Format

enum class CSG_Tool::Script_Format
strong
Enumerator
CMD_Shell 
CMD_Batch 
CMD_Usage 
Toolchain 
Python 
Python_Wrapper_Func_Name 
Python_Wrapper_Func_ID 
Python_Wrapper_Call_Name 
Python_Wrapper_Call_ID 
Markdown_Table 

Definition at line 241 of file tool.h.

Constructor & Destructor Documentation

◆ CSG_Tool()

◆ ~CSG_Tool()

CSG_Tool::~CSG_Tool ( void )
virtual

Definition at line 86 of file tool.cpp.

References Destroy(), Get_Parameters(), and Get_Parameters_Count().

Member Function Documentation

◆ _On_Parameter_Changed()

int CSG_Tool::_On_Parameter_Changed ( CSG_Parameter * pParameter,
int Flags )
staticprotected

◆ Add_Parameters()

CSG_Parameters * CSG_Tool::Add_Parameters ( const CSG_String & Identifier,
const CSG_String & Name,
const CSG_String & Description )
protected

◆ Add_Reference() [1/2]

void CSG_Tool::Add_Reference ( const CSG_String & Authors,
const CSG_String & Year,
const CSG_String & Title,
const CSG_String & Where,
const SG_Char * Link = NULL,
const SG_Char * Link_Text = NULL )
protected

Definition at line 171 of file tool.cpp.

References Parameters, and SG_Char.

◆ Add_Reference() [2/2]

void CSG_Tool::Add_Reference ( const CSG_String & Link,
const SG_Char * Link_Text = NULL )
protected

Definition at line 176 of file tool.cpp.

References Parameters, and SG_Char.

◆ Create_Manager()

CSG_Data_Manager * CSG_Tool::Create_Manager ( void )

Definition at line 589 of file tool.cpp.

References Get_Manager(), and Set_Manager().

◆ DataObject_Add()

bool CSG_Tool::DataObject_Add ( CSG_Data_Object * pDataObject,
bool bUpdate = false )
protected

◆ DataObject_Classify_Defined()

bool CSG_Tool::DataObject_Classify_Defined ( CSG_Data_Object * pDataObject,
int Field,
double Interval,
bool bOffset = false,
double Offset = 0.,
int Colors = -1 )
staticprotected

Definition at line 1223 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_Equal()

bool CSG_Tool::DataObject_Classify_Equal ( CSG_Data_Object * pDataObject,
int Field = -1,
int Classes = 10,
int Colors = -1 )
staticprotected

Definition at line 1213 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_Geometric()

bool CSG_Tool::DataObject_Classify_Geometric ( CSG_Data_Object * pDataObject,
int Field = -1,
int Classes = 10,
bool bIncreasing = true,
int Colors = -1 )
staticprotected

Definition at line 1243 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_Natural()

bool CSG_Tool::DataObject_Classify_Natural ( CSG_Data_Object * pDataObject,
int Field = -1,
int Classes = 10,
int Colors = -1 )
staticprotected

Definition at line 1253 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_Quantile()

bool CSG_Tool::DataObject_Classify_Quantile ( CSG_Data_Object * pDataObject,
int Field = -1,
int Classes = 10,
bool bHistogram = true,
int Colors = -1 )
staticprotected

Definition at line 1233 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_StdDev()

bool CSG_Tool::DataObject_Classify_StdDev ( CSG_Data_Object * pDataObject,
int Field = -1,
double StdDev = 0.5,
double StdDev_Max = 4.5,
int Colors = -1 )
staticprotected

Definition at line 1263 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Classify_Unique()

bool CSG_Tool::DataObject_Classify_Unique ( CSG_Data_Object * pDataObject,
int Field = -1,
int Classes_Max = 1024,
int Colors = -1 )
staticprotected

Definition at line 1203 of file tool.cpp.

References INIT_CLASSIFY_OPTIONS, and SG_UI_DataObject_Classify().

◆ DataObject_Get_Colors()

bool CSG_Tool::DataObject_Get_Colors ( CSG_Data_Object * pDataObject,
CSG_Colors & Colors )
staticprotected

Definition at line 996 of file tool.cpp.

References SG_UI_DataObject_Colors_Get().

◆ DataObject_Get_Parameter()

CSG_Parameter * CSG_Tool::DataObject_Get_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID )
staticprotected

Definition at line 1049 of file tool.cpp.

References DataObject_Get_Parameters().

Referenced by DataObject_Set_Parameter().

◆ DataObject_Get_Parameters()

◆ DataObject_Set_Colors() [1/3]

bool CSG_Tool::DataObject_Set_Colors ( CSG_Data_Object * pDataObject,
const CSG_Colors & Colors )
staticprotected

Definition at line 1001 of file tool.cpp.

References CSG_Colors::Create(), and SG_UI_DataObject_Colors_Set().

◆ DataObject_Set_Colors() [2/3]

bool CSG_Tool::DataObject_Set_Colors ( CSG_Data_Object * pDataObject,
const CSG_String & Colors,
int nColors = 0,
bool bRevert = false )
staticprotected

Definition at line 1011 of file tool.cpp.

References CSG_Colors::Set_Predefined(), and SG_UI_DataObject_Colors_Set().

◆ DataObject_Set_Colors() [3/3]

bool CSG_Tool::DataObject_Set_Colors ( CSG_Data_Object * pDataObject,
int nColors = 0,
int Colors = SG_COLORS_DEFAULT,
bool bRevert = false )
staticprotected

Definition at line 1006 of file tool.cpp.

References CSG_Colors::Set_Predefined(), and SG_UI_DataObject_Colors_Set().

◆ DataObject_Set_History()

◆ DataObject_Set_Parameter() [1/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID,
const SG_Char * Value )
staticprotected

Definition at line 1106 of file tool.cpp.

References DataObject_Get_Parameters(), DataObject_Set_Parameter(), and SG_Char.

◆ DataObject_Set_Parameter() [2/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID,
double loVal,
double hiVal )
staticprotected

◆ DataObject_Set_Parameter() [3/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID,
double Value )
staticprotected

Definition at line 1082 of file tool.cpp.

References DataObject_Get_Parameters(), and DataObject_Set_Parameter().

◆ DataObject_Set_Parameter() [4/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID,
int Value )
staticprotected

Definition at line 1070 of file tool.cpp.

References DataObject_Get_Parameters(), and DataObject_Set_Parameter().

◆ DataObject_Set_Parameter() [5/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
const CSG_String & ID,
void * Value )
staticprotected

Definition at line 1094 of file tool.cpp.

References DataObject_Get_Parameters(), and DataObject_Set_Parameter().

◆ DataObject_Set_Parameter() [6/7]

bool CSG_Tool::DataObject_Set_Parameter ( CSG_Data_Object * pDataObject,
CSG_Data_Object * pCopy,
const CSG_String & ID )
staticprotected

Definition at line 1063 of file tool.cpp.

References DataObject_Get_Parameter(), and DataObject_Set_Parameter().

◆ DataObject_Set_Parameter() [7/7]

◆ DataObject_Set_Parameters() [1/2]

bool CSG_Tool::DataObject_Set_Parameters ( CSG_Data_Object * pDataObject,
CSG_Data_Object * pCopy )
staticprotected

◆ DataObject_Set_Parameters() [2/2]

bool CSG_Tool::DataObject_Set_Parameters ( CSG_Data_Object * pDataObject,
CSG_Parameters & Parameters )
staticprotected

Definition at line 1022 of file tool.cpp.

References Parameters, and SG_UI_DataObject_Params_Set().

Referenced by DataObject_Set_Parameter(), and DataObject_Set_Parameters().

◆ DataObject_Set_Stretch()

bool CSG_Tool::DataObject_Set_Stretch ( CSG_Data_Object * pDataObject,
int Field,
double Minimum,
double Maximum,
int Interval_Mode = 0,
double Interval_Log = 1.,
int Colors = -1,
bool bUpdateNow = false )
staticprotected

◆ DataObject_Set_Stretch_Linear()

bool CSG_Tool::DataObject_Set_Stretch_Linear ( CSG_Data_Object * pDataObject,
int Field = -1,
double Minimum = 5.,
double Maximum = 95.,
int Interval_Mode = 0,
double Interval_Log = 1.,
int Colors = -1,
bool bUpdateNow = false )
staticprotected

◆ DataObject_Set_Stretch_Percentile()

bool CSG_Tool::DataObject_Set_Stretch_Percentile ( CSG_Data_Object * pDataObject,
int Field = -1,
double Minimum = 2.,
double Maximum = 98.,
int Interval_Mode = 0,
double Interval_Log = 1.,
int Colors = -1,
bool bUpdateNow = false )
staticprotected

◆ DataObject_Set_Stretch_StdDev()

bool CSG_Tool::DataObject_Set_Stretch_StdDev ( CSG_Data_Object * pDataObject,
int Field = -1,
double StdDev = 2.,
bool bKeepInRange = false,
int Interval_Mode = 0,
double Interval_Log = 1.,
int Colors = -1,
bool bUpdateNow = false )
staticprotected

Definition at line 1160 of file tool.cpp.

References DataObject_Set_Parameter(), DataObject_Update(), and INIT_STRETCH_OPTIONS.

◆ DataObject_Update() [1/2]

bool CSG_Tool::DataObject_Update ( CSG_Data_Object * pDataObject,
double Minimum,
double Maximum,
int Show = SG_UI_DATAOBJECT_UPDATE )
staticprotected

◆ DataObject_Update() [2/2]

bool CSG_Tool::DataObject_Update ( CSG_Data_Object * pDataObject,
int Show = SG_UI_DATAOBJECT_UPDATE )
staticprotected

◆ DataObject_Update_All()

bool CSG_Tool::DataObject_Update_All ( void )
protected

Definition at line 815 of file tool.cpp.

References DataObject_Update(), and Parameters.

◆ Delete_Manager()

bool CSG_Tool::Delete_Manager ( bool bDetachData = false,
bool bReset = true )

◆ Destroy()

void CSG_Tool::Destroy ( void )
virtual

Definition at line 102 of file tool.cpp.

References History_Supplement.

Referenced by CSG_Tool_Chain, and ~CSG_Tool().

◆ Dlg_Parameters() [1/3]

bool CSG_Tool::Dlg_Parameters ( const CSG_String & Identifier)
protected

◆ Dlg_Parameters() [2/3]

bool CSG_Tool::Dlg_Parameters ( CSG_Parameters & Parameters,
const CSG_String & Caption = "" )
protected

Definition at line 548 of file tool.cpp.

References Get_Name(), CSG_String::is_Empty(), Parameters, and SG_UI_Dlg_Parameters().

◆ Dlg_Parameters() [3/3]

bool CSG_Tool::Dlg_Parameters ( CSG_Parameters * pParameters,
const CSG_String & Caption = "" )
protected

Definition at line 543 of file tool.cpp.

References Dlg_Parameters().

◆ do_Sync_Projections()

virtual bool CSG_Tool::do_Sync_Projections ( void ) const
inlinevirtual

Reimplemented in CSG_Tool_Chain.

Definition at line 216 of file tool.h.

◆ Error_Fmt() [1/2]

bool CSG_Tool::Error_Fmt ( const char * Format,
... )
protected

Definition at line 742 of file tool.cpp.

References Error_Set().

Referenced by CSG_Tool_Chain::Create(), and CSG_Tool_Chain::Create().

◆ Error_Fmt() [2/2]

bool CSG_Tool::Error_Fmt ( const wchar_t * Format,
... )
protected

Definition at line 767 of file tool.cpp.

References Error_Set().

◆ Error_Set() [1/2]

bool CSG_Tool::Error_Set ( const CSG_String & Text)
protected

◆ Error_Set() [2/2]

bool CSG_Tool::Error_Set ( TSG_Tool_Error Error_ID = TOOL_ERROR_Unknown)
protected

Definition at line 705 of file tool.cpp.

References _TL, Error_Set(), and TOOL_ERROR_Calculation.

Referenced by Error_Fmt(), Error_Fmt(), Error_Set(), and CSG_Tool_Chain::On_Execute().

◆ Execute()

◆ Get_Author()

const CSG_String & CSG_Tool::Get_Author ( void ) const

Definition at line 143 of file tool.cpp.

Referenced by Get_Summary().

◆ Get_Description()

const CSG_String & CSG_Tool::Get_Description ( void ) const

Definition at line 165 of file tool.cpp.

References Get_Name(), and Parameters.

Referenced by CSG_Tool_Chain::Create(), and Get_Summary().

◆ Get_Execution_Info()

const SG_Char * CSG_Tool::Get_Execution_Info ( void ) const
inline

Definition at line 234 of file tool.h.

References SG_Char.

◆ Get_File_Name()

const CSG_String & CSG_Tool::Get_File_Name ( void ) const

Definition at line 121 of file tool.cpp.

Referenced by Get_Summary().

◆ Get_Grid_System()

CSG_Grid_System * CSG_Tool::Get_Grid_System ( void ) const

Gets the tools' grid system, if it has one, which is typically the case for all derivatives of CSG_Tool_Grid.

Definition at line 1412 of file tool.cpp.

References Parameters.

◆ Get_History()

◆ Get_Icon()

const SG_Char * CSG_Tool::Get_Icon ( void )
inline

Definition at line 159 of file tool.h.

References SG_Char.

◆ Get_ID()

◆ Get_Library()

const CSG_String & CSG_Tool::Get_Library ( void ) const

Definition at line 115 of file tool.cpp.

Referenced by Get_History(), CSG_Tool_Chain::Get_Script(), and Get_Summary().

◆ Get_Manager()

CSG_Data_Manager * CSG_Tool::Get_Manager ( void ) const

Definition at line 583 of file tool.cpp.

References Parameters.

Referenced by Create_Manager(), and Delete_Manager().

◆ Get_MenuPath() [1/2]

CSG_String CSG_Tool::Get_MenuPath ( bool bSolved)
virtual

Definition at line 187 of file tool.cpp.

References CSG_Strings::Get_Count(), Get_MenuPath(), and SG_String_Tokenize().

◆ Get_MenuPath() [2/2]

virtual CSG_String CSG_Tool::Get_MenuPath ( void )
inlinevirtual

Reimplemented in CSG_Tool_Chain.

Definition at line 162 of file tool.h.

References SG_T.

Referenced by Get_MenuPath(), CSG_Tool_Chain::Get_Script(), and Get_Summary().

◆ Get_Name()

◆ Get_Parameter() [1/3]

CSG_Parameter * CSG_Tool::Get_Parameter ( const char * ID) const
inline

Definition at line 173 of file tool.h.

References Parameters.

◆ Get_Parameter() [2/3]

CSG_Parameter * CSG_Tool::Get_Parameter ( const CSG_String & ID) const
inline

Definition at line 172 of file tool.h.

References Parameters.

Referenced by CSG_Projections::Parse(), CSG_Projections::Parse(), and SG_Get_Projected().

◆ Get_Parameter() [3/3]

CSG_Parameter * CSG_Tool::Get_Parameter ( const wchar_t * ID) const
inline

Definition at line 174 of file tool.h.

References Parameters.

◆ Get_Parameter_Changed()

TSG_PFNC_Parameter_Changed CSG_Tool::Get_Parameter_Changed ( void )
inlineprotected

Definition at line 276 of file tool.h.

References _On_Parameter_Changed().

◆ Get_Parameters() [1/4]

CSG_Parameters * CSG_Tool::Get_Parameters ( const CSG_String & Identifier) const

Definition at line 509 of file tool.cpp.

References Get_Parameters(), and Get_Parameters_Count().

◆ Get_Parameters() [2/4]

CSG_Parameters * CSG_Tool::Get_Parameters ( int i)
inline

Definition at line 169 of file tool.h.

References Get_Parameters_Count().

◆ Get_Parameters() [3/4]

CSG_Parameters * CSG_Tool::Get_Parameters ( int i) const
inline

Definition at line 168 of file tool.h.

References Get_Parameters_Count().

◆ Get_Parameters() [4/4]

◆ Get_Parameters_Count()

◆ Get_Projection()

bool CSG_Tool::Get_Projection ( CSG_Projection & Projection) const
protected

Definition at line 430 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), Parameters, and Projection.

◆ Get_References()

const CSG_Strings & CSG_Tool::Get_References ( void ) const

Definition at line 181 of file tool.cpp.

References Parameters.

Referenced by Get_Summary().

◆ Get_Script()

CSG_String CSG_Tool::Get_Script ( Script_Format Format,
bool bHeader = true,
int Arguments = 0,
bool bWrapArgs = true )

◆ Get_Summary()

◆ Get_Type()

virtual TSG_Tool_Type CSG_Tool::Get_Type ( void ) const
inlinevirtual

◆ Get_Version()

const CSG_String & CSG_Tool::Get_Version ( void ) const

Definition at line 154 of file tool.cpp.

Referenced by Get_Summary().

◆ has_CMD()

bool CSG_Tool::has_CMD ( void ) const

Definition at line 245 of file tool.cpp.

◆ has_GUI()

bool CSG_Tool::has_GUI ( void ) const

Definition at line 239 of file tool.cpp.

Referenced by CSG_Tool_Chain::Create(), and Get_Summary().

◆ is_Executing()

bool CSG_Tool::is_Executing ( void ) const
inline

Definition at line 225 of file tool.h.

◆ is_Grid()

virtual bool CSG_Tool::is_Grid ( void ) const
inlinevirtual

Reimplemented in CSG_Tool_Grid.

Definition at line 222 of file tool.h.

Referenced by Get_Summary().

◆ is_Interactive()

virtual bool CSG_Tool::is_Interactive ( void ) const
inlinevirtual

◆ is_Progress()

bool CSG_Tool::is_Progress ( void ) const
inline

Definition at line 224 of file tool.h.

References SG_UI_Process_Get_Okay().

Referenced by CSG_Tool_Grid::Set_Progress_Cells().

◆ Message_Add()

void CSG_Tool::Message_Add ( const CSG_String & Text,
bool bNewLine = true )
protected

Definition at line 908 of file tool.cpp.

References SG_UI_Msg_Add_Execution().

Referenced by Message_Fmt(), and Message_Fmt().

◆ Message_Dlg()

void CSG_Tool::Message_Dlg ( const CSG_String & Text,
const SG_Char * Caption = NULL )
protected

Definition at line 693 of file tool.cpp.

References Get_Name(), SG_Char, and SG_UI_Dlg_Message().

Referenced by Execute().

◆ Message_Dlg_Confirm()

bool CSG_Tool::Message_Dlg_Confirm ( const CSG_String & Text,
const SG_Char * Caption = NULL )
protected

Definition at line 699 of file tool.cpp.

References Get_Name(), SG_Char, and SG_UI_Dlg_Continue().

◆ Message_Fmt() [1/2]

void CSG_Tool::Message_Fmt ( const char * Format,
... )
protected

Definition at line 921 of file tool.cpp.

References Message_Add().

◆ Message_Fmt() [2/2]

void CSG_Tool::Message_Fmt ( const wchar_t * Format,
... )
protected

Definition at line 946 of file tool.cpp.

References Message_Add().

◆ needs_GUI()

virtual bool CSG_Tool::needs_GUI ( void ) const
inlinevirtual

Reimplemented in CSG_Tool_Grid_Interactive, and CSG_Tool_Interactive.

Definition at line 218 of file tool.h.

Referenced by CSG_Tool_Library_Manager::Create_Python_ToolBox().

◆ On_After_Execution()

virtual bool CSG_Tool::On_After_Execution ( void )
inlinevirtual

Definition at line 230 of file tool.h.

◆ On_Before_Execution()

virtual bool CSG_Tool::On_Before_Execution ( void )
inlinevirtual

Definition at line 229 of file tool.h.

Referenced by CSG_Shapes::Create(), and CSG_Table::Create().

◆ On_Execute()

virtual bool CSG_Tool::On_Execute ( void )
protectedpure virtual

Implemented in CSG_Tool_Chain.

References On_Parameter_Changed(), and On_Parameters_Enable().

Referenced by Execute().

◆ On_Parameter_Changed()

int CSG_Tool::On_Parameter_Changed ( CSG_Parameters * pParameters,
CSG_Parameter * pParameter )
protectedvirtual

Definition at line 476 of file tool.cpp.

Referenced by _On_Parameter_Changed(), and On_Execute().

◆ On_Parameters_Enable()

int CSG_Tool::On_Parameters_Enable ( CSG_Parameters * pParameters,
CSG_Parameter * pParameter )
protectedvirtual

Reimplemented in CSG_Tool_Chain.

Definition at line 482 of file tool.cpp.

Referenced by _On_Parameter_Changed(), On_Execute(), and CSG_Tool_Chain::On_Parameters_Enable().

◆ Process_Get_Okay()

bool CSG_Tool::Process_Get_Okay ( bool bBlink = false)
staticprotected

Definition at line 846 of file tool.cpp.

References SG_UI_Process_Get_Okay().

Referenced by Execute(), and Set_Progress().

◆ Process_Set_Text() [1/3]

void CSG_Tool::Process_Set_Text ( const char * Format,
... )
staticprotected

Definition at line 858 of file tool.cpp.

References SG_UI_Process_Set_Text().

◆ Process_Set_Text() [2/3]

void CSG_Tool::Process_Set_Text ( const CSG_String & Text)
staticprotected

Definition at line 852 of file tool.cpp.

References SG_UI_Process_Set_Text().

◆ Process_Set_Text() [3/3]

void CSG_Tool::Process_Set_Text ( const wchar_t * Format,
... )
staticprotected

Definition at line 883 of file tool.cpp.

References SG_UI_Process_Set_Text().

◆ Reset()

bool CSG_Tool::Reset ( bool bManager = true)

Resets the tools' parameters list. All input and output data objects and object lists are cleared and parameter defaults are restored.

Definition at line 1355 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), Parameters, Reset_Grid_System(), Reset_Manager(), and CSG_Parameters::Restore_Defaults().

◆ Reset_Grid_System()

bool CSG_Tool::Reset_Grid_System ( void )

Resets the tools' grid system, if it has one, which is typically the case for all derivatives of CSG_Tool_Grid.

Definition at line 1387 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), Parameters, and CSG_Parameters::Reset_Grid_System().

Referenced by Reset().

◆ Reset_Manager()

bool CSG_Tool::Reset_Manager ( void )

Resets the tools' data manager so it will be the SAGA API's default manager as can be requested by SG_Get_Data_Manager().

Definition at line 1377 of file tool.cpp.

References Set_Manager(), and SG_Get_Data_Manager().

Referenced by Reset().

◆ Set_Author()

void CSG_Tool::Set_Author ( const CSG_String & String)
protected

Definition at line 138 of file tool.cpp.

Referenced by CSG_Tool_Chain::Create().

◆ Set_Callback()

void CSG_Tool::Set_Callback ( bool bActive = true)

◆ Set_Description()

void CSG_Tool::Set_Description ( const CSG_String & String)
protected

Definition at line 160 of file tool.cpp.

References Parameters.

Referenced by CSG_Tool_Chain::Create().

◆ Set_Grid_System()

bool CSG_Tool::Set_Grid_System ( const CSG_Grid_System & System)

Sets the tools' grid system, if it has one, which is typically the case for all derivatives of CSG_Tool_Grid.

Definition at line 1402 of file tool.cpp.

References Parameters.

◆ Set_History()

bool CSG_Tool::Set_History ( CSG_Data_Object * pDataObject,
int Depth = -1 )

◆ Set_Manager()

◆ Set_Name()

void CSG_Tool::Set_Name ( const CSG_String & String)
protected

Definition at line 127 of file tool.cpp.

References Parameters.

Referenced by CSG_Tool_Chain::Create().

◆ Set_Parameter() [1/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
const char * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1330 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [2/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
const CSG_String & Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1321 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [3/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
const wchar_t * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1339 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [4/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
CSG_Parameter * pValue )

Definition at line 1285 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [5/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
double Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1303 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [6/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
int Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1294 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [7/21]

bool CSG_Tool::Set_Parameter ( const char * ID,
void * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1312 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [8/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
const char * Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1329 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [9/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
const CSG_String & Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1320 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [10/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
const wchar_t * Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1338 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [11/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
CSG_Parameter * pValue )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1284 of file tool.cpp.

References Parameters.

Referenced by CSG_Parameters_CRSPicker::Activate_GUI(), CSG_Shapes::Create(), CSG_Table::Create(), CSG_Projections::Parse(), CSG_Projections::Parse(), SG_Get_Projected(), and SG_Get_Projected().

◆ Set_Parameter() [12/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
double Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1302 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [13/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
int Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1293 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [14/21]

bool CSG_Tool::Set_Parameter ( const CSG_String & ID,
void * Value,
int Type = PARAMETER_TYPE_Undefined )

Direct 'set a value' access to this tool's default parameters list.

Definition at line 1311 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [15/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
const char * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1331 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [16/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
const CSG_String & Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1322 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [17/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
const wchar_t * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1340 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [18/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
CSG_Parameter * pValue )

Definition at line 1286 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [19/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
double Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1304 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [20/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
int Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1295 of file tool.cpp.

References Parameters.

◆ Set_Parameter() [21/21]

bool CSG_Tool::Set_Parameter ( const wchar_t * ID,
void * Value,
int Type = PARAMETER_TYPE_Undefined )

Definition at line 1313 of file tool.cpp.

References Parameters.

◆ Set_Progress() [1/3]

bool CSG_Tool::Set_Progress ( double Position,
double Range = 1. ) const
protectedvirtual

Definition at line 672 of file tool.cpp.

References Process_Get_Okay(), and SG_UI_Process_Set_Progress().

◆ Set_Progress() [2/3]

bool CSG_Tool::Set_Progress ( int Position,
int Range ) const
protectedvirtual

◆ Set_Progress() [3/3]

bool CSG_Tool::Set_Progress ( sLong Position,
sLong Range ) const
protectedvirtual

Definition at line 666 of file tool.cpp.

References Set_Progress().

◆ Set_Show_Progress()

void CSG_Tool::Set_Show_Progress ( bool bOn = true)

Definition at line 654 of file tool.cpp.

Referenced by CSG_Tool().

◆ Set_Version()

void CSG_Tool::Set_Version ( const CSG_String & String)
protected

Definition at line 149 of file tool.cpp.

◆ Settings_Pop()

bool CSG_Tool::Settings_Pop ( void )

Definition at line 634 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), Parameters, and CSG_Parameters::Pop().

◆ Settings_Push()

bool CSG_Tool::Settings_Push ( class CSG_Data_Manager * pManager = NULL)

Definition at line 621 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), Parameters, and CSG_Parameters::Push().

◆ Stop_Execution()

bool CSG_Tool::Stop_Execution ( bool bDialog = true)
protected

Definition at line 678 of file tool.cpp.

References SG_UI_Stop_Execution().

◆ Update_Parameter_States()

bool CSG_Tool::Update_Parameter_States ( void )

Definition at line 1425 of file tool.cpp.

References Get_Parameters(), Get_Parameters_Count(), and Parameters.

Referenced by Execute().

◆ CSG_Tool_Chain

friend class CSG_Tool_Chain ( void )
friend

Definition at line 139 of file tool.h.

References CSG_Tool(), CSG_Tool_Chain, and Destroy().

Referenced by CSG_Tool_Chain.

◆ CSG_Tool_Interactive_Base

friend class CSG_Tool_Interactive_Base
friend

Definition at line 136 of file tool.h.

References CSG_Tool_Interactive_Base.

Referenced by CSG_Tool_Interactive_Base.

◆ CSG_Tool_Library_Interface

friend class CSG_Tool_Library_Interface
friend

Definition at line 137 of file tool.h.

References CSG_Tool_Library_Interface.

Referenced by CSG_Tool_Library_Interface.

◆ CSG_Tool_Library_Manager

friend class CSG_Tool_Library_Manager
friend

Definition at line 138 of file tool.h.

References CSG_Tool_Library_Manager.

Referenced by CSG_Tool_Library_Manager.

Member Data Documentation

◆ History_Supplement

CSG_MetaData CSG_Tool::History_Supplement
protected

Definition at line 258 of file tool.h.

Referenced by Destroy(), Dlg_Parameters(), Execute(), and Get_History().

◆ Parameters


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