Selects objects on the active spread. This action can either modify the current selection or create a new selection. There are many ways for the Select action to be used, however the most common way is to select objects by their name, as assigned in the Fuga Object panel. Remember to put quotes around object names (unless the name is stored in a variable) as they are considered strings.
- Works On
- Objects within the current spread.
- Changes Selection
- Modifies the current selection or creates a new selection as specified in the parameters.
The Select action is located in the Fuga Workshop panel under the Object actions category.
Selecting Everything in the Current Spread
This example selects all the objects within the current spread by leaving all the parameters on their default values.
All the Select action’s parameters are left on their default values.
All the objects on the active spread are selected.
Select An Object By Name
This example selects any object by their name as assigned in the Fuga Object panel. Although only one object is selected in this example, multiple objects can be selected if they have the same name (the only objects that need to have unique names are Super Groups).
In the string input field, “Box1″ is written, to tell Fuga that this is the name of the object to select. The quotes around the object name in the Select action are there because the object name is a string.
After the Select action is performed, the object named Box1 is selected.
Selecting One Object At a Time Using a Loop and Variable
This example uses a loop with a string expression to select Box1, then Box2, then Box3. The expression, (i.e., pieces of information combined together) is made up of the string “Box”, with a variable representing a number. The two pieces of information are combined using the plus sign. The variable representing the number (the variable named i in this example) is increased each time the loop is performed, which we instruct Fuga to do by setting i as the loop variable.
You can additionally accomplish something similar to this using a selected object loop.
A numeric loop is used to repeat the Select action over and over again and increase the variable i by 1 each time the loop is repeated. The letter i is a commonly used to represent a variable being used as a counter, but essentially the variable could be named anything, as long as its the variable chosen from the Loop Variable drop-down (new variables are added to the drop-down as they’re created).
In the String Input field, “Box”+i is used, to tell Fuga to select the object named “Box” with whatever number i’s value is at the end of it. This means that as the loop is repeated, and i increases, Fuga will select Box1, then Box2, then Box3.
The first time the Loop action is performed, i is set to 1, and then when the Select action is performed, Fuga selects Box1.
Then the next time the Loop action is performed, i is increased to 2, and when the Select action is performed, Fuga selects Box2, and so on.
The Select action’s parameters can be found on both the Criteria and the Source tabs in the Select action’s parameter area.
General Selection Parameters
Specifies how to modify the current selection or if to create a new selection, as well as provides some options for narrowing down your selection.
- Set Selection Drop-Down
- Specifies to either to create a new selection or how to modify the existing selection.
- Set Selection – Default. Creates a completely new selection.
- Add to Selection – Selects objects without deselecting the ones already selected. Use this tool to select objects that would be difficult to select using only one Select action.
- Remove from Selection – Removes objects from the selection while keeping the rest of the objects selected. You can use this when you want to select all objects that fit a specific category except for some.
- Select from Selection – Selects only from the objects that are already selected. Use this to narrow down your selection.
- Object Type Drop-Down
- Specifies what type of objects to select from.
- All Types – Default. Selects from all object types.
- Super Group – Selects from only Super Groups.
- Group – Selects from only traditional InDesign groups.
- Text Frames – Selects from only text frames.
- Graphic Frames – Selects from only graphic frames.
- Place and Relation Drop-Down
- Specifies the relationship to the currently selected object to select from, or the place in the active spread to select from. To select from objects on a different spread, you first need to use the Set Active Pageaction to move to that spread.
- Active Spread – Default. Selects from objects on the active spread, meaning the active page and its facing page, and the area around them (i.e., the pasteboard).
- Active Page – Selects from only objects only on the active page.
- Pasteboard Only – Selects from only the area around the active spread (i.e., the white area, that’s not actually on the pages).
- Children of Selected SG – Selects from only from objects that are children of the selected Super Group.
- Same Parent – Selects from only objects that are in the same Super Group as the objects already selected. If objects from multiple Super Groups are selected, Fuga will only select from one of them. Currently this option does not work with normal groups.
Narrows down the objects to select based on a string associated with them. There are two string filter sections, for further control.
- String Represents Drop-Down
- Tells the Flow how the string specified in the input field relates to the object to select.
- Name – Default. Specifies that the string represents an object name as assigned in the Fuga Object panel or through the Rename or Duplicate actions.
- Label – Specifies that the string represents a script label, as specified in the Script Label panel.
- Text – Specifies that the string represents plain text inside a graphic frame.
- String Comparison Drop-Down
- Tells the Flow how the string specified in the Text box relates to the objects’ name, label, or text.
- Matches (Default) – Default. Specifies that the name, label, or text match the string exactly.
- Contains – Default. Specifies that the name, label or text must contain the string anywhere.
- Ends with – Specifies that the name, label or text must end with the string.
- Begins with- Specifies that the name, label or text must begin with the string.
- String Input Field
- (string) The string associated with the object (i.e., its name, label, or the text within it). If this field is left blank, Fuga will not filter the object based on any string.
- And/Or Drop-Down
- Specifies if Fuga should select from objects who match both of the string filter or one or the other.
- And – Fuga will select only from objects who fit the criteria of both string filter sections.
- Or – Fuag will select from objects who fit the criteria of either string filter section.
These parameters are located on the source tab. Use these parameters to further specify criteria for selecting objects.
- Only from Layer
- (string) The name of the layer to select from. If left blank, Fuga will select from every layer.
- Only from Version
- (string) The name of the version to select from. If left blank, Fuga will select from every version.
- Only If Overlapping
- (string) The name of the object to select overlapping objects from. An object is considering overlapping another if they share any of the same space. An object is also considered to be overlapping itself, so the object whose name is inserted into this field will also be selected if it fits the rest of the parameters. If left blank, Fuga will not select objects based on what object they are overlapping.