Site Tools

Adding command line options

Developer: C++
Summary: Demonstrates how to add a different type of command line options to a custom command.


The Rhino SDK has a number of CRhinoGet derived classes that you can use to interactively get information from the user. Some of these classes include:

  • CRhinoGetObject - SDK user interface tool used to get objects.
  • CRhinoGetPoint - SDK user interface tool used to get points.
  • CRhinoGetString - SDK user interface tool used to get strings.
  • CRhinoGetNumber - SDK user interface tool used to get floating point values.
  • CRhinoGetInteger - SDK user interface tool used to get integer values.
  • CRhinoGetAngle - SDK user interface tool used to get angles.
  • CRhinoGetDistance - SDK user interface tool used to get distances.
  • CRhinoGetOption - SDK user interface tool used to get command line options.

Each CRhinoGet derived classes can, in addition to its primary function, prompt the user for additional options. These options display on the command following the developer specified prompt, and appear as clickable hyperlinks.

The following example code demonstrates how to add command line options to some user interaction. In this example, we use the CRhinoGetOption class, which is only capable of displaying command line options. But, we could have used any of the above CRhinoGet derived classes.


CRhinoCommand::result CCommandTestOptions::RunCommand(const CRhinoCommandContext& context)
  CRhinoCommandOptionValue list_items[5];
  list_items[0] = RHCMDOPTVALUE(L"Item0");
  list_items[1] = RHCMDOPTVALUE(L"Item1");
  list_items[2] = RHCMDOPTVALUE(L"Item2");
  list_items[3] = RHCMDOPTVALUE(L"Item3");
  list_items[4] = RHCMDOPTVALUE(L"Item4");
  CRhinoGetOption go;
  go.SetCommandPrompt( L"Command options" );
    int nval_option_index = go.AddCommandOptionInteger( 
        RHCMDOPTNAME(L"Integer"), &m_nVal, L"integer value", 1, 99 );
    int dval_option_index = go.AddCommandOptionNumber( 
        RHCMDOPTNAME(L"Double"), &m_dVal, L"double value", FALSE, 0.1, 99.9 );
    int bval_option_index = go.AddCommandOptionToggle( 
        m_bVal, &m_bVal );
    int list_option_index = go.AddCommandOptionList( RHCMDOPTNAME(L"List"), 
        5, list_items, m_list_index );
    int test_option_index = go.AddCommandOption( RHCMDOPTNAME(L"Test") );
    CRhinoGet::result res = go.GetOption();
    if( res == CRhinoGet::nothing )
    if( res == CRhinoGet::cancel )
      return CRhinoCommand::cancel;
    if( res != CRhinoGet::option )
      return CRhinoCommand::failure;
    const CRhinoCommandOption* option = go.Option();
    if( !option )
      return CRhinoCommand::failure;
    int option_index = option->m_option_index;
    if( option_index == nval_option_index )
      continue; // nothing to do
    if( option_index == dval_option_index )
      continue; // nothing to do
    if( option_index == bval_option_index )
      continue; // nothing to do
    if( option_index == list_option_index )
      m_list_index = option->m_list_option_current;
  return CRhinoCommand::success;
developer/sdksamples/commandlineoptions.txt ยท Last modified: 2014/01/23 (external edit)