Pick Commands

🙋 Pick me! Pick me!

Pick commands, also known as pickers, are Landshape's most powerful and accurate commands.

If you take some time to understand how pickers work, you will unlock the world of Landshape.

Pick Overview

Pick in a Nutshell

Pickers let you use Sketchup geometry to impose your vision onto the terrain.

In Landshape, you use input geometry to communicate with the terrain.

The input geometry you select will drive the result.

This way of working enables great accuracy, control, and repeatability. Sketchup is already pretty good at creating geometry.

The input is simply standard Sketchup geometry — faces, surfaces, edges, points. Input should be grouped. It is also known as control groups.

Some pickers allow you to interact also with non-terrain. For instance with input groups.

Terrain Editing Examples

For instance:

• To move terrain up or down, select a grouped face, and run Fit.
• To smoothen terrain, select a grouped face, and run Smooth.
• To add local detail, select grouped edges, and run Embed.
• To color terrain, select a grouped painted face, and run Zone.

Input Editing Examples

For instance:

• To remove e.g. tiny edges from an input group, select it, and run Clean.
• To flatten an input group of edges, select it, and run Smash.
• To make faces in an input group, select it, and run Face.

Valid Pick Input

Different commands require different input.

Some commands already support a quite liberal range inputs.

However, some commands simply will not work with certain kinds of input.

Troubleshooting Command Input

🤔 Does Command not work as expected? Probably, you are using invalid input.

😎 For Pick commands, it's easy to learn valid inputs. Try one of these:

• Simply hover the toolbar command button. Some tooltips summarize valid input.
• While Commanding, right-click geometry and go directly to: Landshape > Learn Command. Alternatively, open Learn from anywhere, and manually navigate to the command's page.
• Open SketchUp's Instructor panel. The Instructor will update as you switch tools. You may dock it to the side.

One reason for this is because different commands have different purposes. Some commands only make sense for an enclosed area. Others only make sense for a path of edges.

Holygon aims to expand the range valid inputs in future updates. Ideally, all pickers should support any input that makes sense. A long-term goal of Landshape is to become very liberal with input.

Always Group Input Geometry

Generally, pickers expect groups. Make it a habit to always group your input geometry. This way, you can also easily select, move, hide, show, and generally interact with the input.

A few Pickers also support raw geometry input.

Holygon plans to make more pickers support raw geometry input.

Pickers versus Other Command Types

Pick commands may be contrasted with Brushes. Brushes let you edit terrain by directly stroking the terrain.However, brush strokes may not have the same accuracy and resuability as geometry-based commands do.

For an overview of all command types, see Command Types.

Pick Operation

Direct

1. Pre-select valid inputs.
2. To adjust result, type values.

To finish, switch to any other tool.
To keep commanding, continue to item 2, below.

Alternatively:

Picking

1. Run Pick Command with nothing selected.
2. While running Command, Pick valid inputs.
3. To Command, click Enter or Doubleclick.
4. To adjust result, type values.

To finish, switch to any other tool.
To keep commanding, repeat from item 2, above.

While running, type VCB values anytime.
Values control active result, and next result.

Most or all Main Pick commands may be used in the way above. Note that a few pick commands, e.g. in Prop, may not yet support all of the above.

First, create standard Sketchup geometry — faces, surfaces, edges, points, and group it.
Second, select the groups.
Third, run a Pick command.
Fourth, adjust result by typing values into the VCB.

Pick Details

Input affects the terrain above and below it.

Most pickers have parameters. Parameters like Distance and Falloff may allow you to e.g. expand or shrink the area affected.

Pick commands that use areas as input will per default effect any terrain area above or below it.

For all pickers, the most important property of the input is its plan position. This also known as the red and green axis, or the X- and Y-dimensions

For some pickers, their position in height does not matter at all. This dimension is also known as elevation, blue axis, Z-dimension. The reason is that Landshape automatically projects the input up or down to the terrain. An example of this is Embed.

For some pickers, only their relative position in height matters. The reason is that when Landshape automatically projects the selected input to the terrain, it needs to to so in a meaningful order. An example of this is Zone.

For some pickers, their height matters. The reason is that they move the terrain towards the selected target. An exampe of this is Fit

Best Practises to Pick like a Master

Group Your Input

To keep things organised and avoid cluttering, always group your input. Most Pickers should work also with components.

Tag Your Input Groups

In complex models, your viewport may get cluttered with input. To keep your model tidy, Holygon recommends tagging your input groups. This way, you may show and hide your input at a single click.

Check Affected Areas

To check which parts of the terrain should be affected before running a picker, view your terrain from the top and parallel projection. There is a command for that.

Technically, it works equally well to keep control groups below the terrain. However, for practical reasons, like visibility and selectability, it is recommended to keep control groups above the terrain.

No Need to Select Terrain

You never need to select the Landshape terrain itself. Landshape will automatically identify the corresponding plot, and apply the command effect.

Pick Command Examples

Examples of common Pick commands include ::Form, Mesh, Embed, Fit, Blend, Flare, and many more.

Most Pick commands are found under menu Main, but some are also found under menu Prop.