*sets()

Starts a set block.

Syntax

*sets (?card_image_name?, ?idpool_name?,?subentity_idpool_name?)

Type

HyperMesh Template Command

Description

Starts a set block. Sets with a card image matching the specified card image name are considered for the block.

This command must be accompanied by an *output() command at the end of the block.

Inputs

card_image_name
An optional 32-character string enclosed in double quotes that defines the card image name of the sets in the block. If not needed, use double quotes "" or omit the argument.
idpool_name
An optional 32-character string enclosed in double quotes that defines the name of the ID pool that the sets belong to. If not needed, use double quotes "" or omit the argument.
The ID pool must be defined using the *defineidpool() command.
subentity_idpool_name
An optional 32-character string enclosed in double quotes that defines the name of the ID pool that the entities in the set must belong to. If not needed, use double quotes "" or omit the argument.
The ID pool must be defined using the *defineidpool() command.

Example

To write out all sets with the format:

*set(id,"name",color,"typename",ordered)

*setid(entity 1 ID)

*setid(entity 2 ID)

...

*sets()
*format()
*string("*set(")
*field(integer,id,0)
*string(",")
*field(quotedstring,name,0)
*string(",")
*field(integer,color,0)
*string(",")
*field(quotedstring,typename,0)
*string(",")
*field(integer,ordered,0)
*string(")")
*end()

*counterset(counter1,0)
*loopif([counter1 != idsmax])
*pointerset(pointer1,ids,counter1)
*string("*setid(")
*field(integer,pointer1.pointervalue,0)
*string(")")
*end()
*counterinc(counter1)
*endloop()
*output()