SilverScreen Solid Modeler

fence_qgroup

fence_qgroup

Previous topic Next topic  

fence_qgroup

Previous topic Next topic JavaScript is required for the print function  

SilverScreenAPI

 

int fence_qgroup ( char *message, int e_type )

 

char *message;     // prompting message

int e_type;        // entity type mask

 

 




Synopsis

#include "silver.h"

 

The fence_qgroup function displays message , and then permits a q-group of entities to be interactively selected using a fence. e_type designates the allowable entity type that is considered for selection. Entities of this type that are wholly inside the fence are placed in the q-group list.

 

 

Parameters

message is a null-terminated string containing the message to be used in prompting, e_type is an integer value containing flags indicating which entity type is to be considered. e_type may be one of (as defined in silver.h):

 

Name

Value

Meaning

BITS_BLOCK

0X0001

select blocks

BITS_DETAIL

0X0100

select details

BITS_OBJECT

0X0002

select objects

BITS_TEXT

0X0400

select text

BITS_SYMBOL

0X0004

select symbols

 

 

Return Value

fence_qgroup returns 1 if the user successfully completes the fencing operation, and 0 if not.

 

 

Comments

The paths to the entities selected by fence_qgroup may be accessed by use of get_group_item .

 

 

See Also

prompt_qgroup , fence_pgroup , get_group_item

 

 

Example

Here is an example of how to populate a q-group using fence_qgroup , and how to access the members using get_group_item (remember that the group name "" refers to the q-group):

C / C++ Code

 

 if ( fence_qgroup("Mark area containing the objects", E_OB­JECT ) )

    {

    for ( i = 1 ; ; ++i )

       {

       if ( ! get_qgroup_item( "", i, path ) )

          break;

       // Display i-th object

       ss_command (“note Path = %s”,path);

       inchar ();

       }

    }