ANDVFX / TOOL DOCUMENTATION

Scatter_EA

From your first scatter to precise point control.
A practical reference for every object, modifier, and shared workflow.

3ds Max 2027.3 · SEA 0.1258 · 28 topics

Start here

Introduction

Build rich environments with points, shared geometry, and a procedural modifier stack.
On this page · 4 sections
  1. What is Scatter_EA?
  2. Your first scatter
  3. Read the stack from bottom to top
  4. Find your way around

What is Scatter_EA?

Scatter_EA is a scattering and point editing tool for Autodesk 3ds Max. Use it to distribute vegetation, rocks, debris, architectural details, or other source geometry across surfaces. You can generate points procedurally, paint them in the viewport, load point caches, convert existing objects to instances, or reference another MAX scene.

A point stores placement and data. Its instance source supplies the geometry. Modifiers then change transforms, choose source shapes, control density, remove overlaps, select subsets, or change display. This lets you work with many placements while reusing geometry.

Your first scatter

Start by assigning the surfaces that will receive the points.
Start by assigning the surfaces that will receive the points.Click image for full size. Example values are illustrative.
  1. Create a surface and the geometry you want to scatter. Check scene units, source size, and source pivots.
  2. In the Create panel, open the Scatter_EA category and create SeaPointDistribution.
  3. Add the distribution surfaces to its surface list. Choose a distribution mode and set count, density, or spacing.
  4. Use the point system’s Point Instance controls to assign your source geometry. A default pyramid is a placement preview until you assign a source.
  5. Add SeaModify for variation, SeaFilters for masks, or SeaKillOverlaps for spacing between instances.
  6. Use SeaVisualization to keep the viewport responsive and control the render percentage independently.

Read the stack from bottom to top

The base object creates or imports points. Every modifier receives the result below it. A selection must be below a modifier that uses Selection (below). A transform change before overlap removal changes the tested footprint. A transform change after overlap removal can create new intersections.

Practical stack
PointDistribution → Modify → Filters → KillOverlaps → Visualization. Keep overlap removal on the point data side of the Point Instance workflow, as directed by its rollout.

Find your way around

Choose an object or modifier in the left navigation. Each entry explains its purpose, workflow, and controls. The shared guides describe controls reused across multiple tools.

Controls appear according to the selected mode. A hidden or disabled field usually belongs to another mode. Distances use scene units unless marked otherwise; rotation uses degrees, scale 1 means original size, and percentages describe influence or population.

Objects

SeaPointDistribution

Generate procedural points on scene surfaces, then control their population, variation, and masks.
On this page · 19 sections
  1. What this object does
  2. Workflow
  3. Choose a distribution mode
  4. How the modes differ in practice
  5. Surface list
  6. Max Items, cancellation, and retry
  7. Distribution
  8. Position, Rotation, and Scale variation
  9. Built-in filters: how they combine
  10. Slope range: angle-based filtering
  11. Altitude range: height-based filtering
  12. Texture range: control coverage with a map
  13. Texture gizmo fitting and interactive preview
  14. Distribution map browser: presets, files, and custom maps
  15. Spline proximity: paths, borders, and clearings
  16. Geometry proximity: avoid or gather near meshes
  17. Point proximity: react to another point system
  18. A practical filter setup
  19. Point Data Channels

What this object does

SeaPointDistribution generates points on scene surfaces. Choose a mode and set the count, density, or spacing. Use General Filters to restrict the result. CPU is the default. The GPU toggle selects an available backend automatically, with CPU fallback. Its tooltip identifies the active backend or fallback reason.

Workflow

Add meshes to the surface list, select a distribution mode, and adjust population. Assign instance geometry, then add modifiers for variation and filtering. Changing a seed gives a new repeatable layout.

Choose a distribution mode

ControlWhat it does
Surface (Random)Samples the actual 3D surface area. Larger triangles receive proportionally more samples, so a dense patch of small polygons does not automatically get more points. Count sets the candidate population across the surfaces. Use this for natural, unstructured scatter on terrain, curved meshes, and walls.
UV GridBuilds a regular lattice in the surface UV layout and maps it back to the mesh. UV Spacing controls the step in texture coordinates. Useful for repeated rows following an unwrap or curved surface. The spacing on the mesh depends on UV scale and stretching: equal UV spacing does not guarantee equal distances in scene units.
Grid (Projected)Builds a grid in world XY and projects down onto the surfaces. Spacing controls its world-space step. Useful for planting rows or even top-view coverage of terrain without relying on UVs. It uses the uppermost hit at each projected location; lower overlapping surfaces and vertical walls are not covered like a full 3D surface scatter.
Surface DensityGenerates points according to surface density rather than a fixed total Count. The result responds to the area of each surface and is capped by Max points per surface. Use this when multiple terrains should maintain a consistent density as their areas change. Density Jitter perturbs the generated placement.

How the modes differ in practice

Fixed population or area-based population: Surface (Random) is the clearest choice when you want a chosen total number of candidates. Surface Density is the choice when you want population to follow surface area. The grid modes derive their population from spacing and coverage; the Count field is hidden for them.

UV Grid or projected grid: a UV grid follows the unwrap, so it can wrap around curved geometry and walls. A projected grid follows a world-XY lattice, so it is useful for plan-view spacing across terrain. UV seams, overlapping islands, and uneven texel scale can interrupt UV rows. A projected grid can miss surfaces hidden underneath other surfaces.

Example: use Surface (Random) for scattered stones, UV Grid for repeated details following an unwrapped tube, Grid (Projected) for orchard rows over rolling terrain, and Surface Density for grass coverage on terrains of different sizes.

Filters run on the generated candidates. A requested count or a dense grid is not a guarantee of the same final visible population after masks and overlap removal. Start with a moderate population while tuning masks.

Surface list

Distribution Surfaces.
Distribution Surfaces.Click image for full size. Example values are illustrative.
ControlWhat it does
Pick / Add / RemovePick a surface, add selected scene objects, or remove highlighted list entries. Removing an entry stops using that surface.
Selected facesRestrict distribution to faces selected on the source Editable Poly or Mesh.
Material IDs / InvertRestrict eligible polygons by their material IDs; invert to use the complementary IDs.

Picking or adding surfaces works while other rows are disabled. In lists that support multiple objects, use Pick by Name to add all compatible named objects you select.

Max Items, cancellation, and retry

Max Items is a generation safety limit, not the desired visible count or a viewport display limit. A sparse texture can leave few visible points while the underlying potential grid is very large. That grid must still fit the budget.

If the limit is exceeded, the last complete scatter remains visible and the panel reports a warning. Increase Max Items, reduce Point Count or density, or increase Spacing, then edit a setting to generate again. The limit defaults to 2,000,000 candidates.

Press Escape to cancel generation or filtering. Cancellation retains the previous completed output; a new object with no previous result stays empty. Redrawing does not restart cancelled work. Change a distribution setting when you want to retry. An individual third-party conversion or host SDK operation may need to finish before cancellation can be observed.

Distribution

ControlWhat it does
ModeSurface (Random), UV Grid, Grid (Projected), or Surface Density. The mode determines which population and spacing fields are shown.
Point Count / CountCandidate population for Surface (Random). Filters can reduce the output.
Surface Density / Max pointsDensity on each source surface and the per-surface cap for density generation. Max Items is an additional overall generation safety budget.
Density JitterPerturb the density-generated positions.
RelaxSmooth random spacing on the surface. 0 disables relaxation.
SpacingScene-unit spacing for Grid (Projected). Smaller spacing increases the potential grid population.
UV SpacingGrid step in UV coordinates. Resulting world-space spacing depends on UV scale and stretching.
JitterPerturb grid positions. The selected distribution mode determines the relevant coordinates.
ScaleOverall multiplier applied to generated instance scale in every distribution mode, including existing XYZ scale variation. 1 preserves original size. It is animatable; changing it reuses sampled positions.
Random Seed / RSet a repeatable distribution or randomize the seed.
Kill Overlaps / Overlap ScaleEnable the creation overlap control and adjust its collision size. Use SeaKillOverlaps for its full methods and per-shape profiles.
Direction alignmentBlend between Down, Surface Normal, and Up. The center follows surface normals.
Max ItemsMaximum sampling candidates before filters; defaults to 2,000,000 and is saved per object. Limits all modes, including UV and density generation.
Output pointsCompleted point count after the base object’s distribution filters and before modifiers above it. During a texture-gizmo drag it keeps the last complete count.

GPU sampling. Toggle GPU to request acceleration where supported. Read Processing under the point count to see the backend actually used, such as GPU area CDF or CPU. Surface Density and relaxed Random use the CPU.

Position, Rotation, and Scale variation

ControlWhat it does
Enable / axis controlsEnable the transform rollout and edit each available axis range. Position is an offset; Rotation uses degrees; Scale uses multipliers. Equal Min and Max gives a constant value.
Uniform scaleKeep proportions when varying size. Disable it to vary axes independently.
Distribution / CurveChoose the axis distribution and edit its remapping curve. The curve maps an input sample to the fraction between Min and Max; it lets you favor small values, large values, or discrete steps.
SeedChoose repeatable variation independently where a transform seed is provided.
X / Y / Z MapEnable the appropriate axis map and assign its driver. Black corresponds to Min and white to Max. Each visible map row has its own mapping and strength.
Mapping / StrengthUVs uses the assigned map channel. Texture Gizmo uses the projection gizmo. Strength controls how much the assigned map influences that driver.

Built-in filters: how they combine

General Filters combines selected faces, Material ID, slope, altitude, and texture masks. Texture uses a brightness threshold. Use SeaFilters for ordered mask operations, proximity, painted boundaries, and shadows.

Slope range: angle-based filtering

Slope measures the angle between the surface normal and world Up. An upward horizontal surface is about 0°, a vertical wall is 90°, and a downward-facing surface approaches 180°. Use it to separate flat ground, steep slopes, cliff faces, or undersides.

ControlWhat it does
EnableActivate the Slope range.
Min (degrees) / Max (degrees)Define the angle interval. For example, 0–35° targets relatively flat upward-facing regions, while 65–100° targets steep surfaces.
LimitedWhen checked, values outside Min–Max are excluded. When unchecked, the range is a remapping interval: values below or above it continue using the corresponding curve endpoint rather than being hard-clipped.
Min Map / Max MapMultiply the corresponding numeric angle bound by sampled brightness. The two bounds have independent maps. A black map region drives that bound toward 0; white keeps the full numeric bound. This varies the allowed angle across the surface.
Density Falloff / CurveUse the normalized slope within Min–Max to drive survival. A curve value of 1 keeps full density; 0 removes it. A falling curve thins toward Max.
Scale Falloff / CurveUse a separate curve to multiply instance scale across the slope interval. A constant 1 preserves size; lower values shrink it.

Example: for grass that fades before a cliff, enable Slope and Limited, set Min to 0° and Max to 45°, then use a Density curve that stays high over gentle ground and falls toward 0 near the steep end. Leave Scale Falloff off if you want surviving plants to keep their normal size.

Reference axis: PointDistribution always measures slope against world Z. Its slope range has no Reference Z picker. Use a Slope entry in SeaFilters when a helper or object should supply a different reference axis.

Altitude range: height-based filtering

Altitude uses the point’s world-space Z height in scene units. It is useful for treelines, shore bands, snow limits, and transitions between low and high terrain.

ControlWhat it does
EnableActivate the Altitude range.
Min altitude / Max altitudeDefine the height interval in the scene’s units. The zero level is world Z = 0, rather than the bottom of each individual surface.
LimitedExclude candidates outside the height interval. Disable it when the curve should continue its endpoint influence outside the interval.
Min Map / Max MapMultiply either height bound by map brightness. This produces a spatially varying height boundary. A zero numeric bound stays zero when multiplied by a map.
Density Falloff / CurveControl population through the normalized height interval. A falling curve favors the low end; a rising curve favors the high end.
Scale Falloff / CurveIndependently control size through that height interval.

Example: to make trees disappear between heights 200 and 300, turn Limited off, set Min = 200 and Max = 300, and use a density curve from 1 at Min to 0 at Max. Below 200 the endpoint keeps full density; above 300 the endpoint keeps zero density. With Limited on, heights below 200 would also be excluded.

For a shoreline band, enable Limited and use a narrow Min–Max interval. Keep Density Falloff off for a uniform band, or enable it and edit the curve to soften coverage within the band.

Texture range: control coverage with a map

Enable Texture range and click the map slot to choose a preset, image, or custom map. Threshold defaults to 50%. Points pass when brightness meets or exceeds the threshold. Invert applies before the test. At 0% every brightness passes. At 100% only white passes. UVs samples the map channel and Texture Gizmo projects using the stack subobject.

Texture gizmo fitting and interactive preview

With Texture Gizmo mapping, select the Texture Gizmo subobject in the stack and use Max Move, Rotate, and Scale. A newly created gizmo fits the world bounds of the distribution surfaces instead of starting at world zero. If no surface is assigned yet, fitting waits until one becomes available. Existing custom gizmo controllers are preserved.

Dragging the texture gizmo uses a temporary random-subsample preview, capped at 100,000 candidates. It can look less dense than the finished scatter. Releasing or cancelling the interaction restores the full result. Output points retains the last complete output count during the drag.

Texture edits reuse cached decisions from unchanged base filters. Changes to source geometry, transforms, mapping, or other relevant settings invalidate the affected cached work. The final result still evaluates the complete population, so a fast drag preview does not imply that a large final update is equally fast.

Distribution map browser: presets, files, and custom maps

Distribution Map Browser.
Distribution Map Browser.Click image for full size. Example values are illustrative.
  1. Enable the texture filter and click its map slot or thumbnail to open the browser.
  2. Click a preset card once to select it, then click Select Map. Double-clicking a card selects and accepts it in one step.
  3. Choose Custom Map (Scene / Mat) to open the native map picker and use a scene or Material Editor map.
  4. Choose Browse Image File… to load a file from disk. The file picker offers PNG, JPG/JPEG, BMP, TGA, TIF/TIFF, EXR, and HDR.
  5. Click Clear Map to remove the assignment, or Cancel to close without accepting a new choice.

The bundled library includes noise, sparse and dense patches, clusters, stripes, grids, rings, streaks, and other mask patterns. Full White is useful for checking the setup with an unbroken mask before choosing a patterned one.

Where supported, you can also drag an image onto the map thumbnail or a native map onto a map slot. Right-click the main slot to browse or clear it. Range-bound Map buttons use their own image picker and coordinate/weight menu; they modify a numeric bound rather than acting as the main texture density mask.

Map strength is local to the control. A texture mask changes population. A Slope or Altitude bound map changes the numeric limit. A transform map drives position, rotation, or scale. The same image can therefore produce different results in different slots.

Spline proximity: paths, borders, and clearings

Use a Splines entry in SEA_Filters to control proximity to paths and boundaries.
Use a Splines entry in SEA_Filters to control proximity to paths and boundaries.Click image for full size. Example values are illustrative.
ControlWhat it does
Enable / spline listEnable the filter and Pick, Add Selected, or Remove spline references.
Both Sides / Outside Only / Inside OnlyUse distance on both sides or choose one side of a closed spline. Inside/outside requires a meaningful closed boundary.
Fill OppositeChoose whether the untouched opposite side is filled. Inactive for Both Sides.
Density / Near Distance / Far DistanceEnable density control. The normal spline mask keeps the region near the curve, transitioning between Near and Far; Invert reverses the survival mask.
Density Curve / InvertShape and reverse the density transition.
Scale / Near / Far / Curve / InvertUse independent scale distances and remapping.
Scale at Near / Scale at FarSet the endpoint size multipliers.
Distance map / Mapping / Strength / Distance AmountVary the distance mask spatially. Mapping and map strength belong to the map; Distance Amount controls its distance modulation.

Use a spline alongside a path to create a roadside strip, or invert the mask to form a clearing. Start with a hard, easy-to-read distance before softening the transition.

Geometry proximity: avoid or gather near meshes

Use a Geometry entry in SEA_Filters for mesh proximity.
Use a Geometry entry in SEA_Filters for mesh proximity.Click image for full size. Example values are illustrative.
ControlWhat it does
Enable / geometry listChoose the reference meshes used for distance tests.
Outside Mesh / Inside Mesh / Both SidesRestrict which side of the reference mesh contributes.
Vertex (Fast)Measure using vertices. This can be coarse on meshes with large faces.
Face / Triangle (Accurate)Measure against triangle surfaces for more accurate surface distance.
Hybrid (Balanced)Use the balanced sampling option between the other methods.
Fill volumeTreat the entire interior as full proximity instead of only the shell near the surface.
Density Near / Far / Curve / InvertNormally removes near-reference points. Invert keeps the nearby region instead.
Scale Near / Far / Curve / InvertConfigure an independent size transition. Scale at Near and Scale at Far provide the endpoint multipliers.
Distance map / Mapping / Strength / Distance AmountVary the distance boundary using a map.

Example: add a building as a reference to clear vegetation around it. Use accurate face sampling if a sparse building mesh produces an uneven clearance.

Point proximity: react to another point system

Use a Points entry in SEA_Filters for reference-point proximity.
Use a Points entry in SEA_Filters for reference-point proximity.Click image for full size. Example values are illustrative.

Use a reference point system to create clearances or a second layer of scatter around existing placements. Density and Scale have independent Near/Far distances, curves, inversion, and scale endpoint values, with a distance map where shown.

ControlWhat it does
Points (current)Use full 3D distance to reference point centers. Visible point data is used; mesh references can contribute their vertices.
Geometry aware (top view)Use the actual reference instance meshes as cached world-XY footprints, including their scale, orientation, and offsets. Height is ignored. Useful for keeping smaller plants out of tree or rock footprints.
Resolution64–4096 pixels on the longest side of the footprint map. Increase only when smaller details need to be resolved. Higher values increase memory use and rebuild time.
Density / InvertNormally remove points near the references; invert to keep that neighborhood.
Scale at Near / Scale at FarSize multipliers for the independent scale proximity transition.

A point-only reference has no mesh footprint. Use Points mode for it, or assign actual reference instance geometry before choosing Geometry aware.

A practical filter setup

  1. Choose the distribution mode and confirm that points cover the intended surfaces with every filter off.
  2. Set a repeatable seed and a moderate population.
  3. Enable Slope to establish the terrain type, then Altitude for the height transition.
  4. Choose a texture preset and fit its gizmo or UV mapping to break coverage into patches.
  5. Add spline, geometry, or point proximity for local clearances.
  6. Inspect scale falloffs separately from density falloffs. If points disappear unexpectedly, disable masks one at a time to find the restrictive one.

Point Data Channels

Store Surface Normal independently from Instance orientation. UV Coordinates, Material ID, Object ID, and Sel. Sets Dist. Surface are optional. The default selection-set prefix is Dist_. An empty prefix uses the surface name. Surface references used by snapping and distribution casters are tracked independently.

Objects

SeaPaint · Object

Paint, edit, and physically settle an instance point system directly in the viewport.
On this page · 17 sections
  1. What this object creates
  2. First painting session
  3. Start, finish, and shortcuts
  4. Brush modes
  5. Brush settings
  6. Data channels: color and custom values
  7. Creation rollout
  8. Instanced Geometry: the three source modes
  9. From list: picking and using a palette
  10. Physics
  11. Physics Options
  12. Understand the two kinds of collision shape
  13. Physics behavior while painting
  14. Physics setup: scatter stones on a floor
  15. Surface constraints, projection, and snapping
  16. Stroke history and editing safely
  17. Surface position, orientation, and shortcuts

What this object creates

SeaPaint is a base object that starts a point system from viewport strokes. Create adds placements; the other brushes edit points already in this object. Every point can carry instance geometry, scale, rotation, color, and other data. The Paint modifier uses similar tools on a result coming from lower in the stack.

The following sections explain the controls directly on the Paint object, including its source picker and Physics rollout. Fields change with the active brush, so you only see the settings relevant to that operation.

First painting session

  1. Create SeaPaint from the Scatter_EA category.
  2. In Instanced Geometry, choose From list and add a source, or choose Pick Geometry for one source. Check the source pivot and size.
  3. Choose Create. Set a manageable Radius, Density, Spacing, and Strength.
  4. In Creation, choose the scale mode and set Randomize Scale, random rotation, and Z offset.
  5. Click Start Painting and drag over a mesh. Surface hits take priority; otherwise the selected projection plane is used.
  6. Release to finish a stroke. Use Erase, Move, Scale, or another brush to refine the result.
  7. Right-click, press Enter, or use the painting toggle to leave the tool.

Start, finish, and shortcuts

Brush Tools.
Brush Tools.Click image for full size. Example values are illustrative.

Click Start Painting to enter the viewport tool. Right-click or press Enter to finish; Tab cycles brush modes while painting. Ctrl + Alt + left drag adjusts radius. Alt + left drag adjusts creation Z offset. Modifier keys can have brush-specific behavior; use the tool’s current mode when interpreting a stroke.

Brush modes

ControlWhat it does
CreateAdd points using the chosen source mode. Density sets candidates per stamp; Spacing prevents excessive clustering; Strength controls the probability of accepting each candidate. Shift switches to erasing, and Ctrl switches to Relax.
EraseHide points locally rather than deleting the point structure. Erase % controls how many are hidden per dose. Holding continues trimming; Shift restores hidden points. Falloff softens the effect toward the brush edge.
Push/PullPush separates points from the brush region; Shift pulls them toward it; Ctrl relaxes spacing. Radius, Falloff, and Strength control the region and influence.
RelaxSpread and smooth local spacing. Strength controls how strongly the spacing is relaxed. Use this to soften a dense hand-painted patch without changing its source choices.
ScaleChoose Add, Multiply, Replace, or Subtract. Scale Value is a delta for Add/Subtract, a factor for Multiply, and a target for Replace. Shift reverses Add/Subtract. Ctrl smooths neighboring scale values.
MoveClick and drag captured points still inside the brush. Points leaving Radius stop receiving mouse movement; active gravity can continue. Falloff reduces movement toward the edge.
SmudgeMove points along mouse travel, weighted by Strength and Falloff. New points join as the moving brush passes over them. Use it to reshape a swath rather than carry only the original captured points.
Data ChannelPaint a numeric or color channel. Add, Set, or Multiply uses the Value field; a color channel uses the color swatch. Ctrl averages the values beneath the brush. Shift reverses Add, negates Set, or uses the reciprocal for Multiply.
InstanceShapeReassign instance geometry and its associated source color to existing points in the brush. Choose one or more source variants. Ctrl or Shift in the source list selects multiple entries.
ChaosAgitate Position and/or Rotation, with independent 0–100 strengths. 1 Kick agitates once per press; Continuous Chaos keeps shaking while held. With Physics enabled, it adds linear and angular impulses.

Brush settings

ControlWhat it does
RadiusOuter brush radius.
FalloffInner falloff region controlling transition toward the outer brush edge.
DensityNumber of candidate points per stamp.
SpacingMinimum spacing while creating points.
StrengthInfluence of Push/Pull and Relax, or creation probability. Smudge has its own percentage of mouse travel.
Erase %Percentage hidden or restored with each dose, from 0–100%.
Brush ShapeCircle, Square, or Sphere.
ProjectionXY, XZ, YZ, or Screen Space fallback plane. Surface hits take priority.
Position / OrientationConstrain point origins to the recorded surface and optionally align instance orientation to its normal.
Force snapPrefer point hits over surface hits. With this off, point hits are used only if no surface is hit.
Preview PointsShow point previews while working.
Clear StrokesRemove the stroke history stored in this object or modifier.

Data channels: color and custom values

Data channels.
Data channels.Click image for full size. Example values are illustrative.
ControlWhat it does
ChannelChoose an incoming point data channel. Use the Color channel when painting color instead of a numeric value.
AxisX, Y, Z, W, or All. All paints the numeric value on each component.
OperationAdd changes by a delta; Set writes a target; Multiply scales the existing value. Falloff blends the result with the incoming value.
ValueNumeric operand used by the chosen operation.
ColorColor value used for color-channel painting.
Refresh ChannelsReload the available incoming channel list after the point data changes.

Painting a color channel stores point color data. Its visibility depends on the instance display or shading setup; use a color-aware display mode to inspect it. Ctrl averages vector components independently.

Creation rollout

SeaPaint Creation scale and randomization
SeaPaint Creation scale and randomization3ds Max 2027.3 · SEA 0.1257
ControlWhat it does
Use reference scaleUse the selected source’s original scale, including scale captured from a picked SeaXref shape.
Override ScaleSet a uniform base scale in the Scale field.
Randomize ScaleVary the base scale independently for each newly created point. A value of 0% keeps the base scale.
Randomize rotations: OffDo not add creation rotation randomization.
Randomize rotations: All axesAdd independent random angles to the creation orientation in X, Y, and Z. Useful for stones or debris that can tumble.
Randomize rotations: Z axisRandomize the Z component while retaining the other creation orientation components. Useful for rotational variation without full tumbling.
Z offsetOffset new points along their painted surface normal. Positive lifts them away; negative moves them into the surface. Alt + left drag adjusts it while using Create.

These settings are captured when points are created. Changing the range or offset prepares new strokes; use the Scale or Move brushes when you want to alter existing placements.

Instanced Geometry: the three source modes

ControlWhat it does
Incoming/DefaultUse the available incoming/default instance geometry rather than choosing a new list or a single picked source. For a new Paint object, the default pyramid provides a placement preview.
From listMaintain a palette of scene objects and select which variants Create or InstanceShape may use. This is the mode for painting mixed vegetation, several rock shapes, or another reusable source collection.
Pick GeometryPick one scene source through the dedicated Pick Geometry button. The button shows the chosen object’s name. Use this for quickly painting one particular object without maintaining a mixed palette.

Both Create and InstanceShape use these source choices. Create adds points using a source; InstanceShape changes the source of existing points. Switching source modes does not replace every earlier stroke: earlier placements retain their recorded sources and colors.

When the source is a native Gaussian splat object, Create retains its native type and source orientation. SEA displays a bounding box for the instance in the viewport.

From list: picking and using a palette

  1. Set Sources to From list.
  2. Use Pick to collect sources from the scene, or select objects in Max and click Add Selected.
  3. Select the palette entries you want to paint. A single selection restricts painting to that source. Multiple selections randomize among them per point. If no entry is selected, all listed sources are eligible.
  4. Use Remove to remove highlighted entries from the active palette.
  5. Choose Create to add placements, or InstanceShape to paint variants onto existing placements.

The list shows source names and color swatches. During an active Create or InstanceShape stroke, you can hold the mouse button, move over a source in the expanded list to switch objects, then return to the viewport. Recorded earlier sources remain associated with earlier edits.

Pick Geometry uses the single-source picker instead. If you were painting, it pauses for picking and resumes afterward. Keep source geometry available: the palette points to geometry used by the point system.

Physics

ControlWhat it does
PhysicsEnable collision simulation for brush edits and creation settling.
CollisionPoint, Box, or Convex hull.
Collision scaleMultiply collision shape size without changing visible geometry size.
Point radiusScene-unit radius, further multiplied by point scale, object scale, and Collision scale.
On create apply it forSettle only newly created points after release for this number of scene frames. 0 skips settling.
Gravity / MagnitudeDownward world-Z acceleration in scene units per second squared. Surface Position constraints remain active with Gravity.
Use scene objectsAlso collide with geometry visited by the brush. Create remembers surfaces touched during the stroke.
Collision objects: Pick / Add / RemoveManage additional colliders.
Geometry: Convex hullUse solid hulls, placed separately for each point-system instance with its transforms and offsets.
Geometry: MeshUse triangles, preserving holes and concave surfaces.

Physics Options

Physics Options.
Physics Options.Click image for full size. Example values are illustrative.
ControlWhat it does
Simulation speedTime multiplier for held simulation, 0.1–10×. Default is 3×. It does not multiply gravity or change Create frame duration.
Linear dragDamp translational motion; 0 disables drag. Units are inverse seconds.
Angular dragDamp rotation when orientation is unconstrained.
Max speedLimit linear velocity in world scene units per second.
Max spinLimit angular velocity in degrees per second.
Separation speedLimit overlap-correction velocity. Lower values reduce explosive separation impulses.

Understand the two kinds of collision shape

Collision: Point / Box / Convex hull chooses the moving painted instance’s collision approximation. Point uses the Point radius. Box uses source bounds. Convex hull follows a solid convex approximation of the source. Collision scale changes the collision shape without resizing the visible instance.

Collision objects → Geometry: Convex hull / Mesh chooses how the supporting or obstructing scene objects are represented. A convex hull is a solid approximation, so it bridges holes and concavities. Mesh follows triangle surfaces and is more suitable for a concave container, an opening, or a detailed support surface. Point-system colliders place the source shape separately at each instance with its scale, orientation, and offsets.

Physics behavior while painting

Physics can resolve collisions during editing, continue simulation while the brush is held, and settle newly created points after the mouse is released. It works with the point edits recorded by the Paint object rather than requiring you to set up a separate timeline simulation.

On create apply it for simulates only newly created points for the specified number of scene frames after release. At 30 fps, 60 frames represents two seconds of settling. A value of 0 skips this stage. Longer frame durations are handled with smaller collision steps.

Gravity accelerates affected points down world Z. The Position constraint remains active with Gravity. Constraint orientation is separate: keep it on when orientation should remain controlled and follow surface normals when constrained; turn it off when debris should tumble through collision-driven rotation.

Use scene objects includes geometry actually hit or visited by the brush. It is not a command to collide with every scene object automatically. Create remembers the touched surfaces during its stroke. Use the explicit collision-object list for additional obstacles or supports that the brush has not touched.

Physics setup: scatter stones on a floor

  1. Add stone geometry in From list and set Min/Max scale to a modest interval.
  2. Enable Physics. Choose Box for an initial test, then Convex hull if tighter contact is needed.
  3. Enable Use scene objects and paint over the floor, or add the floor explicitly to Collision objects.
  4. Enable Gravity if stones should drop. Disable Constraint orientation if they should rotate naturally.
  5. Set a short On create frame count and paint a small group. Inspect the settled result before increasing density or duration.
  6. If separation is too abrupt, reduce Separation speed. If motion takes too long to settle, adjust drag and velocity limits in Options.

Surface constraints, projection, and snapping

Projection selects XY, XZ, YZ, or Screen Space for cases without a mesh hit. A hit surface takes precedence. Force snap reverses the usual priority between point hits and surface hits: enable it to prefer point hits; disable it to use point hits only when there is no surface hit.

Constraint to Surface keeps Move, Relax, and Smudge on their recorded creation surfaces. Missing creation surfaces leave the affected points unchanged. Collision handling happens after that projection; enabling Gravity takes precedence over the surface constraint.

Brush Shape chooses Circle, Square, or Sphere. Start with a small radius to understand the affected region before editing tightly packed or layered placements.

Stroke history and editing safely

Use Clear Strokes to remove the edits stored in this Paint object. In a base Paint object, that can remove the painted placements that build its result. Ordinary undo is useful when testing a brush or an unfamiliar setting.

Creation settings, source choices, and physics motion settings are recorded for new strokes. Changing Physics Options does not resimulate old stroke history. To create a different settled arrangement, undo or clear the relevant test and paint again with the new settings.

The modifier version has additional overall Strength and particle ID matching options. Those are modifier-specific; the base Paint object creates and owns its initial points.

Surface position, orientation, and shortcuts

In Brush Settings, use Position to project touched points onto their recorded surface, including during Physics with Gravity enabled. Orientation aligns instances to the surface normal while preserving heading and scale. The viewport shortcut legend follows the active brush and Max key assignments.

Objects

SeaLoader

Load external point and particle caches into the point workflow.
On this page · 11 sections
  1. Workflow
  2. Supported particle and cache formats
  3. Supported survey, scan, text, and CAD formats
  4. All accepted extensions
  5. File and time controls
  6. Import controls
  7. Check the result
  8. Single files and frame sequences
  9. CAD and ReCap import tips
  10. Geometry, channels, and format limits
  11. USD and Storm BIN

Workflow

Browse to a supported point cache, choose sequence handling and units, then assign instances if the file contains only points. Reload after the source file changes. The status area reports the loaded data or a read error.

Supported particle and cache formats

ControlWhat it does
Alembic · .abcPoint caches in Ogawa archives. Supports animated single-file archives and numbered sequences. This reads point data, not arbitrary Alembic mesh scenes. HDF5 Alembic archives are not supported by the shipped reader.
Universal Scene Description · .usd, .usda, .usdcReads USD Points primitives and their point attributes, including sampled animation and primitive transforms. Supports single-file animation and numbered sequences. This is a point reader, not a general USD scene or mesh importer.
Krakatoa particles · .prtReads PRT v1/v1.1 numeric particle channels, typically one file per frame. PRT2 is a different container and is not supported.
RealFlow particles · .binReads RealFlow particle BIN layouts 1–12, normally from a frame sequence. The .bin extension must contain that particle format; unrelated binary files are not supported.
Bifrost particles · .bifReads the supported BIF version 9 particle encoding, including float/vector and uint64 particle arrays. Bifrost volumes are outside this reader’s scope. Nonidentity voxel transforms and unsupported channel encodings are reported as unsupported.
tyFlow cache · .tycReads the supported tyCache version 121 particle encoding. Enable Load tyFlow instances to load companion tyMesh prototype geometry when available. The supplied reader does not require tyFlow to be installed. Additional custom property tables or channel schemas may require a reader extension.

Supported survey, scan, text, and CAD formats

ControlWhat it does
XYZ / ASCII text · .xyz, .asc, .txtReads numeric point rows, with whitespace or comma-separated columns. XYZ position fields are required. Optional named columns can preserve numeric attributes such as color, normals, intensity, and IDs. An arbitrary prose TXT file is not a point file.
PTS · .ptsReads text point data, including the optional initial point-count line. Typical XYZ / intensity / RGB columns are recognized. The declared count is checked against the rows.
PTX · .ptxReads structured scan grids with registration matrices, intensity, optional RGB, scan membership, row/column indices, and point IDs. Applies the scan registration and excludes zero-position empty samples.
PLY · .plyReads the vertex point data and numeric vertex properties from ASCII or binary PLY. It does not turn face topology into scattered instance geometry. Ragged/list-valued vertex attributes are not supported.
Point Cloud Data · .pcdReads ASCII, binary, and binary_compressed PCD, including numeric fields and packed RGB/RGBA where provided.
E57 · .e57Reads multi-scan point data with Cartesian or spherical coordinates, registration poses, supported numeric attributes, color, and normals where available. Invalid samples are excluded and scans retain identifying information.
LAS / LAZ · .las, .lazReads LAS survey/LiDAR points and compressed LAZ. Preserves the numeric dimensions available in the source, such as intensity, classification, return information, and RGB when present.
AutoCAD drawing · .dwg, .dxfReads CAD point entities, or geometry vertices with the CAD import option. Numeric layer/entity metadata and available entity colors are retained. DWG decoding uses the reader runtime supplied with the package. It is not a full drawing-to-instance conversion.
Autodesk ReCap · .rcp, .rcsReads project or scan point clouds through the host’s ReCap interface. RCP projects must retain access to their referenced scan files. The public host interface exposes positions, RGBA, and normals; other original scan attributes are not available through that route.

All accepted extensions

.abc .usd .usda .usdc .prt .bin .bif .tyc .xyz .asc .txt .pts .ptx .ply .pcd .e57 .las .laz .dwg .dxf .rcp .rcs

These are the 22 extensions offered by the Loader file picker in the documented build. A supported extension identifies a reader family; a different format variant or unsupported attribute encoding can still produce a diagnostic.

File and time controls

ControlWhat it does
Path / Browse / ReloadChoose the cache file or refresh it from disk. Supported formats depend on the readers shipped with your host package.
FilesAuto detects handling; Sequence reads a numbered sequence; Single archive reads an archive as one source.
Time offsetSource time = scene time − offset. A positive offset delays playback.
Outside rangeHold the endpoint, Loop the cache, or Hide outside its time range.

Import controls

ControlWhat it does
SpaceLocal applies the loader object’s transform; World interprets source placement in world space.
ScaleMultiply imported placement scale.
Up axisChoose +Z or +Y to match the source coordinate system.
File unitsAuto, Scene units, Meters, Centimeters, Millimeters, Inches, or Feet. Choose explicitly when automatic metadata is absent or incorrect.
CAD importRead Points / point clouds or Geometry vertices.
Read everyRead one out of every N source points. 1 loads all points. This changes imported data and is separate from viewport display limits.
Load tyFlow instancesLoad instance geometry from a tyFlow cache when available.

Check the result

Before increasing the population, check orientation and size with a known scene object. For animated cache editing, use stable IDs when available so paint edits follow the intended particles.

Single files and frame sequences

Choose Auto for ordinary detection. The loader detects numbered filenames and their padding, and can use matching siblings as a sequence. Use Sequence when the source is explicitly one file per frame, or Single archive to avoid treating a numbered archive name as a sequence.

Alembic and USD can contain animated data inside a single archive. PRT, BIN, BIF, and the supported TYC workflow generally use per-frame files. Missing files inside a sequence produce a diagnostic rather than displaying stale data from a previous frame.

Time offset is measured in frames: an offset of +10 makes source frame 0 appear at scene frame 10. Outside range chooses Hold, Loop, or Hide. These controls affect playback; they do not repair a gap inside a sequence.

CAD and ReCap import tips

CAD import → Points / point clouds reads explicit point entities. Geometry vertices also samples supported CAD entity geometry as vertices or control vertices. If a DWG/DXF contains a point-cloud reference, load the referenced RCP/RCS directly; the CAD route does not resolve that cloud reference into points.

For an RCP project, copy or relink the associated scans as well as the project file. If the host cannot open the scans or exposes an incomplete point set, the Loader reports a failure instead of silently accepting a partial import.

Use File units, Up axis, and Scale to match the survey to your scene. E57 and ReCap supply meter-based unit information; CAD may supply drawing-unit metadata. If a text or other source has no useful unit metadata, choose its units explicitly and compare against a known-sized object.

Geometry, channels, and format limits

A position cache is not automatically an instance-geometry cache. For point-only files, use Point Instance to assign geometry after loading. The tyFlow option is the dedicated route for loading tyCache instance prototypes; keep its companion data accessible.

Numeric channels are preserved where the format and host can represent them. Source IDs remain distinct from Max’s managed point IDs. Unsupported strings, ragged data, or channel encodings are reported rather than treated as ordinary numeric point channels.

If a file fails, read the status message first. Confirm its actual format/version, whether its companion files are present, and whether you selected a point cache rather than a mesh or volume cache. Lower Read every for a denser import, or increase it to load fewer source points while testing.

USD and Storm BIN

USD reads point data, transforms, and numeric channels from USD archives or sequences. Storm RealFlow BIN version 13 sequences retain typed channels and exact 64-bit IDs. Check file mode, Time offset, and Outside range when loading animated caches.

Objects

SeaConvertToInstances · Object

Convert existing scene geometry into points that share instance shapes.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Object or modifier?

Workflow

Sources.
Sources.Click image for full size. Example values are illustrative.

Add geometry to Sources, decide whether to split by element, and enable Detect Similar when independent copies should share matching meshes. Refresh the result after source changes. This object is useful for converting a scene assembly into a compact point system.

All controls

Options.
Options.Click image for full size. Example values are illustrative.
ControlWhat it does
Sources: Pick / Add / RemoveBuild the source list. Pick supports viewport selection and H for selection by name; right-click ends picking.
Convert by elementCreate placements from separate mesh elements instead of treating each source as one shape.
Detect SimilarFind matching meshes across independent copies, including elements, while considering topology, mapping, material, vertices, relative scale, orientation, and pivot offset.
World space / Local spaceWorld preserves the original placement when the converter moves. Local applies the converter transform as an additional offset.
Keep namesWrite point named selection sets from source object names. A source’s elements belong to its set.
Keep object IDWrite ObjectID from the source’s 1-based position in the source list.
Hide source objectsHide the original scene objects to avoid showing both originals and converted instances.
RefreshRebuild the converted result.
Move Instances to active layerMove the actual used shapes to the active layer. It retains the source list and current converted point snapshot for source cleanup.
StatusRead conversion counts and diagnostic information.

Object or modifier?

The object can collect several scene sources and offers World/Local and Hide source objects. The modifier version converts the geometry entering its own stack.

Objects

SeaXref (SeaPointRef)

Reference chosen geometry from another MAX scene as shared instance data.
On this page · 5 sections
  1. Workflow
  2. Reference controls
  3. Store Data
  4. Convenience actions
  5. Editing nested parts

Workflow

Browse to a MAX file, open Choose Objects to select the required hierarchy entries, then choose Static or Animation. This keeps the source scene external while allowing downstream point modifiers in the host scene.

Reference controls

SeaXref reference controls and Detect similar
SeaXref reference controls and Detect similar3ds Max 2027.3 · SEA 0.1257
ControlWhat it does
File / Browse / Reload / ClearChoose the MAX scene, reload it from disk, or clear the reference.
Choose ObjectsChoose source objects from the layer hierarchy. Layers open collapsed so you can expand the ones you need.
Detect similarShare matching geometry across source objects that have different transforms or pivots.
Mode: StaticEvaluate a specific Source frame using the frame rate stored in the referenced file.
Mode: AnimationFollow host frame numbers mapped to the source scene’s frame rate.
ScaleAdjust the overall reference scale.
DisplayObjects displays the contents; Reference Bounding Box gives a lighter preview.
Include hidden source objectsInclude objects hidden in the referenced scene.
StatusRead reference errors, object counts, or shared-shape counts.

Store Data

Store Data.
Store Data.Click image for full size. Example values are illustrative.
ControlWhat it does
Names as selection setsStore source object names as point selection sets. The adjacent prefix field helps distinguish these sets.
Materials as selection setsStore material membership as selection sets, with an optional prefix.
Groups as selection setsStore source group membership as selection sets, with an optional prefix.

Convenience actions

Modifiers.
Modifiers.Click image for full size. Example values are illustrative.
ControlWhat it does
Add LOD ControlsAdd SeaVisualization configured for LOD geometry.
Add Pack / UnpackAdd the hierarchy modifier so you can expose nested parts for downstream edits.

Editing nested parts

If a reference contains nested instance systems, use Pack / Unpack to expose deeper points. Select parts by stored named sets, edit them, and pack them again when the recorded hierarchy is available. Keep the referenced MAX file accessible wherever the scene will be evaluated.

Objects

SeaPacking

Pack building instances inside district meshes.
On this page · 4 sections
  1. Districts and buildings
  2. Spacing, weights, and borders
  3. Settings and alignment
  4. Surface contact and point data

Districts and buildings

Packing with a district mesh and two building sources.
Packing with a district mesh and two building sources.Click image for full size.

Create SeaPacking under Create → Geometry → Scatter_EA. Add district meshes and building geometry to their respective lists. Each connected mesh element defines a block. Packing starts enabled and computes once both lists contain eligible sources. Use Packing ON/OFF to pause computation, and Repack or commit a changed setting to retry after Escape. Clearing either required list clears the result.

Spacing, weights, and borders

Minimum separation controls footprint clearance in world XY. Zero permits contact and negative spacing permits limited overlap. Per-building Min separation can inherit Global or add a stricter limit. Pair clearance uses the strictest applicable value. Weight is a relative preference and zero excludes a source. Low weights can leave pockets unfilled. Avoid borders uses the complete footprint and includes hole boundaries. Falloff softens the transition. Invert favors the near-border band. Select rows to edit their values together, including direct sources and dynamic rules.

Settings and alignment

Choose Quick, Standard, or Dense effort, set a seed, scale variation, boundary setback, and building limit. Border alignment starts enabled and follows the nearest edge, including holes, within its alignment distance. Its falloff blends toward world axes. Spline alignment uses the nearest guide tangent in world XY. Set full alignment distance, falloff, and strength. Spline influence blends over the border heading. Numeric edits commit on Enter or spinner release.

Surface contact and point data

Optional surface metadata and block and district IDs.
Optional surface metadata and block and district IDs.Click image for full size.

Footprints must fit within their assigned block. The uppermost hit on that block supplies height and Surface Normal while buildings stay upright. Point Data Channels controls Surface Normal, Instance orientation, UV Coordinates, Material ID, Object ID, surface selection sets and their prefix, Block ID, and District ID. District ID identifies the source mesh and Block ID identifies its connected element. Layout depends on available footprints, weights, and alignment.

Packed point data also preserves source wire colors.

Modifiers

SeaModify

Transform a chosen subset with controlled variation, maps, and selection weights.
On this page · 4 sections
  1. Workflow
  2. Operation and space
  3. Position, Rotation, and Scale
  4. Hide controls

Workflow

Choose Target, enable the required Position, Rotation, and Scale axes, then adjust the ranges. Use a fixed seed for repeatable variation. For a graduated effect, enable weights and use a proximity target or incoming soft selection.

Operation and space

Options.
Options.Click image for full size. Example values are illustrative.
ControlWhat it does
TargetChoose the points to affect. All shared Target modes are described in the Target guide.
Operation: AddOffset position and rotation, and multiply scale.
Operation: SetReplace enabled values with the generated values.
Operation: MultiplyMultiply incoming components by the generated values.
StrengthMultiply transform influence after the operation, maps, and selection weights.
World / LocalWorld uses world axes. Local uses each incoming point’s orientation, including instance normal. Point scale does not change position offset distances.
Use weights / CurveMultiply changes by selection weights. Proximity targets supply distance weights; other targets use incoming soft selection. Scale influence blends from multiplier 1. The curve remaps incoming weight to transform influence. Without incoming selected points, the weight option allows full influence.

Position, Rotation, and Scale

ControlWhat it does
Axis enables / Min / MaxEnable axes independently and define the generated range. Equal Min and Max produces a constant value.
SeedEach transform rollout has its own variation seed. Change it to regenerate that variation while preserving the other rollouts.
Uniform scaleLink scale variation to preserve proportions. Disable it for independent axis scaling.
Shared map / axis switchesUse one shared map for a transform rollout and choose which axes it drives. Black drives Min and white drives Max.
Mapping / StrengthUse UVs or Texture Gizmo and adjust map influence. UV mode uses the map’s assigned channel.

Hide controls

Hide.
Hide.Click image for full size. Example values are illustrative.

Hide hides the Target subset without deleting points. Invert hides the complement while transform variation still uses the original Target. Points already hidden upstream stay hidden. Disable Hide to return to upstream visibility.

Modifiers

SeaFilters

Combine independent filter entries inside one modifier, with per-entry settings and shared outputs.
On this page · 23 sections
  1. Build a filter stack
  2. Evaluation order and combination operations
  3. Example: vegetation mask with a clearing
  4. Enable and disable with eye icons
  5. Selection, bulk editing, and the expanded list
  6. Reorder, rename, duplicate, and delete
  7. Independent entry settings, Target, and Outputs
  8. Mode selector
  9. Shared distances and Transform controls
  10. Splines
  11. Geometry
  12. Points
  13. Occlusion and face-angle regions
  14. Paint
  15. Texture entries: Threshold and Invert
  16. Tileable: repeated mask or one footprint
  17. Independent named texture gizmos
  18. Slope and Altitude entries
  19. Outputs: selection sets, gradients, and keeping points
  20. Saving and animation
  21. Shadows
  22. Orientation modes
  23. Surface normals and painted falloff

Build a filter stack

Set Target, then click Add Mode and choose a filter. The new row is selected automatically. Configure its Mode Settings and Transform controls, then choose its Operation. The first entry defaults to Set and subsequent entries default to Add. An empty stack passes incoming points through. Use Outputs to write a selection set or gradient or retain the point population.

Evaluation order and combination operations

The list evaluates from bottom to top. The bottom row runs first, followed by the rows above it. Each entry compares its own matching points with the accumulated result:

ControlWhat it does
SetReplace the accumulated point membership with this entry’s matches. Use it as a starting mask or to replace earlier mask decisions.
AddKeep points matched by either the accumulated result or this entry: a union. This can restore eligible candidates rejected by earlier rows in this modifier.
SubtractRemove this entry’s matches from the accumulated result. Use it for clearings, paths, or exclusion regions.
MultiplyKeep only points matched by both the accumulated result and this entry: an intersection. Use it to restrict an existing mask.

The accumulator initially contains the incoming points. Therefore a lone Subtract removes its matches, and a lone Multiply keeps its matches. Candidates stay available until the entire entry stack has finished; rejected points are removed once at the end.

Scope matters. Add and Set can recover candidates rejected by earlier entries in this SeaFilters modifier. They cannot recreate points already removed by PointDistribution or a lower modifier. Global Target still limits which incoming points may change.

Example: vegetation mask with a clearing

Read this example from the bottom row upward:

ControlWhat it does
Bottom: Texture · SetStart with patches selected by a Texture entry.
Next: Slope · MultiplyKeep only patch points within the allowed slope range.
Next: Paint · SubtractPaint a clearing and remove its matched points.
Top: Paint_B · AddAdd another painted region back into the eligible incoming population.

Move the Add row below the Subtract row and the clearing can remove it again. Add a Set row at the top and it replaces the earlier membership decisions. Use the eye icons to compare the effect of each entry while keeping its configuration.

Enable and disable with eye icons

ControlWhat it does
Eye before the filter nameToggle the entry on or off in either the compact or expanded list. Off bypasses all effects of that entry.
Settings are retainedTurning an entry off preserves its Set/Add/Subtract/Multiply operation, properties, references, maps, animation, and gizmo.
Selected rowsClicking the eye on a selected row toggles the selected rows together in one undo step.
Expanded Enable / DisableApply an explicit on/off state to the current multi-selection.

There is no need to replace a row’s operation to bypass it.

Selection, bulk editing, and the expanded list

Use Ctrl-click to select individual rows and Shift-click to select a range. Opening an operation dropdown captures the current selection. Choosing Set, Add, Subtract, or Multiply changes every selected row in one undo step. The selection remains available for another operation edit; unselected rows keep their operations.

The expanded list has editable Operation dropdowns and bulk controls for operation, Enable/Disable, Up, Down, and Delete. Compact and expanded views share the same row state and stay synchronized through edits and undo. Selecting multiple rows does not turn their Mode Settings into a shared property editor: the active row supplies the displayed entry properties.

Reorder, rename, duplicate, and delete

ControlWhat it does
Up / DownMove the selected entry or entries through the list. Evaluation remains bottom to top. Moving multiple rows preserves their relative order.
RenameUse the row’s right-click menu. Bulk rename creates unique names from the supplied base name.
DuplicateUse the right-click menu in either view. Copies appear immediately above their sources and retain operation, on/off state, references, and properties.
Independent copiesDuplicated animation and texture-gizmo controllers are cloned. Editing the copy’s settings or gizmo does not edit the source entry. Referenced scene objects remain the same references unless you change them.
Automatic namesRepeated types and duplicates use the next unused suffix: Texture, Texture_B, Texture_C; Paint becomes Paint_B.
DeleteRemove selected entries through the context menu or expanded controls. Use the eye instead when you want to keep a configuration for later.

A duplicate can immediately affect the result because it is another evaluated row. For example, duplicating a Subtract entry creates a second subtraction step; inspect its operation and position after copying.

Independent entry settings, Target, and Outputs

Each entry owns its own parameters, references, maps, animated controllers, slope reference, and paint boundary. Selecting a different row switches the property editor to that entry. Two Texture or Paint entries can therefore have different maps, projections, boundaries, and transforms inside the same modifier.

Target belongs to the modifier, not to individual rows. It limits the incoming points the combined filter stack may affect. Points outside Target retain their data. Outputs also belong to the modifier and describe the combined stack result rather than whichever row is currently selected.

Mode selector

Click Add Mode and choose Splines, Geometry, Points, Occlusion, Paint, Texture, Slope, Altitude, or Shadows. The new row becomes active immediately. Use Up and Down to reorder rows, or Delete to remove the selected rows.

Shared distances and Transform controls

For distance-based entries, Near Distance and Far Distance are shared by Density, Scale, and Orientation within that entry. Near is the full-influence region and Far ends its transition. Curve and Noise controls shape that entry’s mask. Different entries can use different distances.

ControlWhat it does
Reference list / Pick / Add Selected / RemoveManage the selected entry’s reference objects, splines, or point systems.
Density / Density Curve / InvertEnable density filtering and reshape or reverse its survival mask. Spline filtering normally keeps the near-curve region; geometry and point filtering normally remove their nearby region.
Scale / Scale Curve / InvertEnable an independent scale response using the same entry distance interval. Scale at Near and Scale at Far set the endpoint multipliers.
NoiseDisplace distance sampling to break up a mask boundary. The noise changes mask sampling rather than the actual point positions.
Enable orientationAvailable for Splines, Geometry, Points, Occlusion, and Paint entries. Enable the directional response for that mask.
Max inclinationMaximum tilt angle.
DivergenceRandom angular variation around the leaning direction, within plus or minus the given angle.
Orientation CurveRemap influence using the shared distance: X = 0 at Far and 1 at Near.

Texture entries have their own Density, Scale, and Orientation controls. Slope and Altitude provide Density and Scale falloffs with curves.

Splines

ControlWhat it does
Both SidesMeasure distance on either side of the spline.
Outside Only / Inside OnlyChoose the relevant side of a closed spline.
Fill OppositeFill or empty the untouched opposite side; inactive for Both Sides.

Geometry

ControlWhat it does
Outside Mesh / Inside Mesh / Both SidesChoose where mesh proximity applies.
Vertex (Fast)Approximate distance using vertices.
Face / Triangle (Accurate)Use triangle surfaces for a closer geometric test.
Hybrid (Balanced)Balance surface accuracy and sampling cost.
Fill volumeGive the entire mesh interior full proximity, regardless of its distance from the surface.

Choose Inside Mesh or Outside Mesh to set the side, and enable Fill to use the enclosed volume in the side test. Closed meshes give a defined interior.

Points

ControlWhat it does
Points (current)Use 3D distance to point centers.
Geometry aware (top view)Use cached world-XY footprints of actual reference instance meshes, with their scale, orientation, and offsets. Height is ignored.
ResolutionFootprint-map resolution: 64–4096 px on its longest side. Higher values capture finer details at a greater memory and rebuild cost. References without instance geometry contribute no footprint.

Occlusion and face-angle regions

ControlWhat it does
Shared surfacesSupply reference meshes for both calculations. An empty list uses the distribution surfaces.
Enable face angle regionsEnable filtering around qualifying face edges.
Edge typeConvex ridges/peaks, concave valleys/creases, or Both.
Min. face angleMinimum angle between faces that qualifies an edge.
Near / Far DistanceDistance transition around qualifying edges. The distance is in 3D world space.
Density / Scale / Invert / CurvesControl density and scale independently around these regions. Scale at Near and Scale at Far define the size endpoints.
Enable occlusionEnable the ray-based sheltered/exposed mask.
Ray radiusMaximum ray distance in scene units.
Ray samplesRays per point. Higher values improve sampling quality and increase evaluation time.
Min. occlusion / Occlusion falloffSet the threshold and transition width as percentages.
Invert (keep exposed)Keep exposed regions instead of the normally occluded region.

When you assign explicit occluders, the shared Near and Far distances control the falloff from those casters.

Paint

ControlWhat it does
Start Painting / Brush RadiusPaint the mask in the viewport. Left drag adds; Shift subtracts; Ctrl + Alt + left drag changes radius.
ProjectionXY, XZ, YZ, or Screen Space. Screen Space stores the captured view plane.
Export Boundary / Clear BoundaryExport the painted boundary or clear it.
InvertReverse the region.
Density / Scale / Min / Max / CurvesUse signed distance from the boundary to drive population and size. Positive distance is inside; equal distance limits produce a hard boundary.
Scale multipliers / Density SeedSet the scale endpoints and repeatable random density pattern.

Use the shared Near and Far values to shape Scale and Orientation even when Density is disabled.

Texture entries: Threshold and Invert

Texture entries use a deterministic brightness Threshold, to select points from the mask. Assign a preset, image, or custom map, choose its mapping, and set the cutoff. Inversion is applied before the threshold test.

ControlWhat it does
Map slot / thumbnailChoose a preset or custom map. Use the map browser, file browsing, or supported drag-and-drop workflows.
ThresholdKeep points whose sampled brightness is at least this percentage. Default: 50%. Within valid texture coverage, 0% admits every brightness and 100% keeps white.
InvertReverse brightness before the cutoff: dark areas become bright and bright areas become dark.
TileableRepeat the image beyond its first tile when on. See the single-tile rules below.
Mapping: UVsUse the channel selected in the assigned map.
Mapping: Texture GizmoUse this entry’s world-projection gizmo. Select its named subobject in the stack to Move, Rotate, or Scale it.
Dimensions / Link X/Y / Offsets / RotationUse the coordinate controls where shown. In world-projection mode, transform the entry’s gizmo.
Refresh MapRefresh changed external or custom map content.

Open Transform to shape Density and Scale with curves. Enable Orientation, then choose Gizmo orientation to align with the projection or Defined angle to enter an angle. Choose the alignment axis and use Divergence to vary the result.

Tileable: repeated mask or one footprint

Tileable is on by default. Turn it off to limit this Texture entry to one transformed world-gizmo footprint or one UV tile. Points outside that footprint do not match the entry, even when Invert is enabled or Threshold is zero. Image-edge sampling is clamped rather than wrapping into the opposite edge.

Example: to make one local patch, turn Tileable off, fit the Texture Gizmo to the desired area, then choose the threshold. To repeat the same pattern over an entire terrain, leave Tileable on.

An outside point failing this entry does not automatically mean it is removed from the final modifier result. Set, Add, Subtract, or Multiply determines how this entry’s non-match combines with the accumulated mask.

Independent named texture gizmos

Each world-projected Texture entry has its own named subobject under SeaFilters. Select the corresponding subobject and transform it with Max’s Move, Rotate, or Scale tools.

Repeated entries are named Texture, Texture_B, Texture_C, and so on. Rename a row to make its gizmo easier to identify; the name updates in the subobject list. UV-projected Texture entries do not expose a world-projection gizmo. Duplicating an entry gives the copy an independent gizmo controller.

Slope and Altitude entries

Set Enable, Min, Max, and Limited for the selected range. Slope uses degrees; Altitude uses scene height. Limited clips values outside the interval. With Limited off, values outside use the corresponding falloff-curve endpoint. Density and Scale falloff controls are in Transform; Noise can vary the range sampling.

ControlWhat it does
Slope: Reference ZPick a helper or another scene object. Its normalized local Z axis defines the reference for measuring slope. The picker stays in viewport/H-list pick mode until a reference is chosen or picking is ended.
Clear reference / World ZClear the reference to return to world (0, 0, 1).
Reference transformsRotating the reference changes the slope direction and therefore the matched points. The reference belongs to this entry.
PointDistribution comparisonThe base PointDistribution slope range always uses world Z and has no Reference Z picker. Use a SeaFilters Slope entry for a custom axis.
Density / Scale Falloff / CurvesRemap the normalized range independently for population and size.
NoiseBreak up the range boundary without adding a range-bound image map.

For a treeline fade, use an Altitude entry with Limited off, Min and Max defining the transition, and a Density curve falling from 1 to 0. For a slope test relative to a tilted structure, pick that structure or a helper as Reference Z in a Slope entry.

Outputs: selection sets, gradients, and keeping points

SeaFilters Outputs
SeaFilters Outputs3ds Max 2027.3 · SEA 0.1257
ControlWhat it does
SelectionWrite the combined membership to the active point selection.
Named Selection Set / nameSave the combined membership as a named set for downstream Target controls.
Gradient (0–1) / channel nameWrite a float channel describing the combined gradients. Use it for downstream weighting or inspection.
Keep all pointsKeep the incoming population instead of removing points rejected by the combined filter. Useful when exporting a mask for later processing. Transform effects still apply where configured.

The selection set describes the evaluated membership. The gradient combines the entry gradients using the corresponding clamped arithmetic operation; it need not equal a binary density decision at every point. Outputs are taken from the whole stack, not from the active row’s preview alone.

Saving and animation

Entry settings, enabled states, references, animation, and independent gizmos survive save/load, undo/redo, and modifier cloning.

Select a row to show its property editor. A new modifier shows Target and Mode until you add and select an entry. Multi-row operation edits preserve the selection in both list views.

Shadows

Pick one helper or light as the source. Helpers and directional lights cast parallel shadows. Spot and omni lights use perspective depth maps, and spot cones limit coverage. Distribution objects supplies casters by default. Pick additional mesh geometry in the caster list. Turn Distribution objects off to use only that list. Resolution defaults to 1024 px. Soft edges feather the mask and Invert keeps lit points. Casters use opaque evaluated geometry.

Use the Falloff rollout to set Near and Far up to 2,000 px. In Transform, Density and Scale each have their own inversion and curve. Scale at Near and Scale at Far set the endpoint values.

Orientation modes

Enable Orientation and choose Tilt Z, Acquire Local Axis, Orient to Closest Point, or Orient to Tangent. Choose X, Y, or Z alignment and use Invert to reverse direction. Closest Point works in world XY. Mesh tangent uses the surface normal crossed with world Z. Painted boundaries use their projection frame and nearest edge. The shared Near/Far distances give full influence near the source and zero far away. Curve and Divergence apply across modes. Max inclination applies to Tilt Z. Spline orientation follows the selected side and Fill setting.

Surface normals and painted falloff

Slope defaults to Surface Normal. Pick another Normal channel to evaluate instance orientation, a stored vector, or the local Z axis of a quaternion or transform. Missing default surface metadata falls back to instance normals. An explicitly selected missing channel leaves slope unapplied. For Paint, choose Inside or Outside. Outside keeps the filled interior at full influence and fades outward from the boundary. The setting applies to density, scale, and orientation.

Modifiers

SeaPaint · Modifier

Paint local edits onto the incoming point system.
On this page · 4 sections
  1. When to use it
  2. Brushes and rollouts
  3. Modifier options
  4. Animated and changing sources

When to use it

Add this modifier above PointDistribution, Loader, Convert to Instances, or PointRef to refine an existing result. Choose Target to restrict existing-point edits. Use Target: All when creating new points.

Brushes and rollouts

Brush Tools.
Brush Tools.Click image for full size. Example values are illustrative.

Use the same brushes, Creation, Instanced Geometry, and Physics controls as the Paint object. The shared Painting & Physics guide lists them. Clear Strokes removes the edits recorded in this modifier.

Modifier options

Options.
Options.Click image for full size. Example values are illustrative.
ControlWhat it does
StrengthMultiply the influence of all edits stored in this Paint modifier.
IDChoose the point channel used to match particles across evaluations. New modifiers default to Index. Choose a stable ID channel when the upstream point order can change. Missing or duplicate keys are skipped.

Animated and changing sources

Stable IDs help keep edits attached to the intended particles. Index follows point order, so a source whose ordering changes can produce a different match. Earlier strokes retain their recorded instance sources and colors even when you change the current geometry list.

SeaXref supplies live references for Paint, including updates to imported layers and instance colors. The Creation rollout uses the reference scale and override controls described under SeaPaint Object.

Modifiers

SeaKillOverlaps

Remove intersecting placements using source geometry and point transforms.
On this page · 4 sections
  1. Workflow
  2. Collision controls
  3. Density Profile settings
  4. What to expect

Workflow

Assign your instance sources, finalize the important scale and rotation variation, then add this modifier where the overlap rollout directs in relation to Point Instance. Choose a collision method and inspect the surviving layout with full geometry or bounds.

Collision controls

Kill Overlaps.
Kill Overlaps.Click image for full size. Example values are illustrative.
ControlWhat it does
EnableTurn overlap removal on or off.
Mode: Bounding BoxTest oriented source bounds. Fast and predictable, but empty space inside the box still counts.
Mode: Convex HullUse the source’s convex hull for a tighter solid approximation.
Mode: Density ProfileEstimate occupied volume with cached per-source profiles. Useful for irregular or sparse vegetation.
Remove oneKeep the first surviving placement in the tested order.
Remove bothRemove both members of an overlap.
Remove larger first / Remove smaller firstPrioritize removal using transformed bounding-box volume.
Bounds ScaleMultiply collision size about the source bounds center. 1 uses the original size. This changes collision size rather than displayed geometry.
Fallback RadiusRadius for a point without assigned instance mesh geometry.

Density Profile settings

Density Profile.
Density Profile.Click image for full size. Example values are illustrative.
ControlWhat it does
Profile QualityLow (8), Medium (16), or High (32) source-relative grid resolution. Higher values capture more gaps and cost more preparation and overlap work.
Allowed OverlapCumulative overlap budget for the smaller occupied profile. 0% rejects occupied-cell intersections; 100% allows all profiled shapes.
InstanceShape listSelect one or more source slots to edit their overrides together. Overrides follow the selected slots.
DensityMultiply the occupancy estimate, from 0–400%. Lower values suit sparse plants or alpha-cutout cards. 0 excludes a shape from density overlap checks.
Ignore BelowIgnore the lower percentage of source bounds height; useful for canopy-only profiles.
Falloff DistanceOutside the occupied profile, progressively remove nearby point positions with stable randomness. 0 disables this extra falloff.
Exclude Mat IDsChoose material IDs to exclude from profile voxelization and falloff. None includes all faces.

What to expect

Profiles estimate geometric occupancy. Adjust Density for leaf cards whose mesh surface overstates visible coverage. A later modifier that enlarges or moves instances can reintroduce intersections, so stack order matters.

Modifiers

SeaClusters

Choose instance variants in spatial clusters, from maps, by painting, or by distance.
On this page · 5 sections
  1. Workflow
  2. Diversity controls
  3. Clusters and map controls
  4. Distance and Paint
  5. Incoming sources and cluster coordinates

Workflow

Assign several instance sources, refresh the source-color list, and choose a mode. Clusters creates patches of variants; distance modes arrange sources from near to far; Paint lets you directly choose local variants.

Diversity controls

ControlWhat it does
Enable / TargetEnable the operation and restrict the affected points.
ModeClusters, Match Color ID on Map, Paint, From object distance, From spline distance, or From target.
SeedRepeatable source distribution.
Refresh Point Instance ColorsReload source entries and their colors from the incoming instance table.
Move Up (Near) / Move Down (Far)Reorder variants for distance assignment.
Group by instance color / HueGroup similar hues within the chosen percentage of the hue wheel. 5% equals 18 degrees. Grays form a separate group. Variants retain their probabilities.

Clusters and map controls

ControlWhat it does
SizeSize of the spatial patches.
Roughness / Blurry Edge / NoiseControl patch irregularity and transition softness.
Color Map / StrengthChoose the map used for color matching and its influence.
MappingUVs or Texture Gizmo.
Link X/Y / Dimension X/YSet and optionally link projection dimensions.
Offset X/Y / RotationPosition and rotate the map coordinates.

Distance and Paint

ControlWhat it does
Object or spline listPick or add the references used for distance assignment.
Near / Far / Curve / NoiseDefine and reshape the distance band. The source list runs from near to far; same-color groups share a band.
Mesh side / sampling / Fill volumeChoose mesh inside/outside handling, distance precision, and interior influence.
Spline Side / Fill OppositeChoose spline side handling for a closed curve.
Start Paint / Brush Radius / Brush FalloffPaint the selected source variants. Multiple selected sources are randomized per point.
Clear Painted ShapesClear the stored source-paint edits.

Incoming sources and cluster coordinates

Refresh Diversity to inspect incoming instance geometry and source colors from SeaInstance or Point Instance. Disable palette rows to exclude them from assignment. Procedural clusters use local axes centered on all incoming points, and the default cluster map gizmo shares that center.

Modifiers

SeaCameraCull

Reduce point populations outside a camera view or across a distance range.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Animation tip

Workflow

Choose the active view or pick a camera. Expand the culling view slightly to retain edge coverage. Add distance density or scale falloff when distant detail can be reduced.

All controls

ControlWhat it does
Enable / TargetEnable culling and select the incoming subset to process.
Use Active Camera / ViewportUse the current view rather than a picked camera.
Pick CameraChoose a scene camera.
ExpandExpand the viewing region used for culling.
Close OffsetAdjust the close boundary of the culling region.
Far Culling / Far DistanceEnable and set a far cutoff.
Only at This Frame / FrameEvaluate the chosen view at a fixed frame. Animated cameras use that frame.
Update Frozen ViewCapture the current free viewport for the frozen-view workflow.
Density / Min Distance / Max Distance / CurveReduce population through a distance transition.
Scale / Min Distance / Max Distance / Curve / Scale multiplierChange size through the distance transition. Scale starts at 1 at Min Distance and reaches its multiplier at Max Distance.
Density SeedChoose a stable random density pattern.

Animation tip

Use a frozen frame to keep a consistent culled population while working. Use the animated camera when culling should follow the shot. Check reflections and shadows before relying on view-based removal.

Modifiers

SeaSelection

Create reusable selections, named sets, and soft-selection weight channels.
On this page · 4 sections
  1. Workflow
  2. Selection outputs
  3. Soft selection
  4. Selection Noise and Noise falloff

Workflow

Choose a Target rule, set how it combines with the incoming selection, and enable the outputs you need. Put this modifier below tools that use Selection (below), Named Selection Sets, or the written float channel.

Selection outputs

Selection.
Selection.Click image for full size. Example values are illustrative.
ControlWhat it does
TargetChoose the source of the selection: geometric, painted, texture, data, source shape, or another shared Target mode.
Mode: Set / Add / SubtractReplace, add to, or subtract from the incoming selection.
Output: SelectionWrite the standard point selection.
Output: Named Selection SetWrite a reusable named set. Can be combined with the other outputs.
Output: Float Channel / Channel NameStore soft-selection weights as a point float channel from 0 to 1.
Set Names: Custom Name / Set NameUse a chosen name for the output set.
Set Names: Source Object NamesUse originating geometry or spline target names. Soft-selected points inherit the name of the nearest selected point.

Soft selection

Soft selection.
Soft selection.Click image for full size. Example values are illustrative.
ControlWhat it does
EnableExtend influence beyond the fully selected core.
Min Distance / Max DistanceWeight is 1 at Min Distance and fades to 0 at Max Distance. Distances are measured from the nearest fully selected point. Partially selected points do not create new falloff origins.
CurveRemap the distance-to-weight transition. Preview updates while editing.
Falloff weightPass calculated fractional weights through unchanged.
Falloff densityUse each weight as a stable probability of selecting the point; the result is 0 or 1.

Selection Noise and Noise falloff

ControlWhat it does
Enable / NoiseEnable each noise layer and choose Simplex, Simplex Fractal, Ridged Fractal, or Turbulence.
StrengthDisplace selection sampling in scene units. Selection Noise breaks the target boundary; Noise falloff mainly displaces the outer falloff and preserves the core. Actual point positions do not move.
ScalePattern size in scene units.
FrequencyEvolution per second. 0 keeps noise static over time.
RoughnessDetail contributed by higher octaves.
LacunarityFrequency multiplier between octaves.
GainAmplitude multiplier between octaves.
OctavesNumber of overlapping patterns. Simplex uses one octave.
Phase / SeedEvolution offset and deterministic pattern seed.
Curve / PreviewRemap normalized noise and inspect its pattern. The preview shows pattern independently of displacement amplitude.
Modifiers

SeaVisualization

Control point and instance display, LODs, and channel colors.
On this page · 6 sections
  1. Workflow
  2. Points
  3. Instances
  4. Colors and channel inspection
  5. Display versus data
  6. Stacked display and material opacity

Workflow

Use a lightweight geometry mode and a reduced Viewport percentage while editing. Set Render independently. For diagnostics, choose a data channel and inspect its values through a color gradient.

Points

Points.
Points.Click image for full size. Example values are illustrative.
ControlWhat it does
Point VisualizationEnable point display controls.
ViewportPercentage of target points shown in the viewport.
Point SizePoint marker size in pixels.
Hide Not TargetHide other points in the viewport. Disable to preserve their incoming display. Instance and rendering settings are separate.

Instances

ControlWhat it does
Instances VisualizationEnable instance display controls.
ColorInstance Material, Flat color, or Colors.
GeometryObject Bounding Box, Bounding Box, Pyramid, Convex Hull, Full Resolution, or LODs.
LOD 1 / 2 / 3Choose None, Bounding Box, Pyramid, Convex Hull, or Full Resolution for each tier, and set its maximum camera distance. Beyond LOD3, instances are hidden.
TransparencyViewport opacity: 0% is opaque and 100% invisible. Applies across geometry and color modes. Source shader transparency is used in Full Resolution.
Viewport / RenderSeparate percentages of target instances for the viewport and rendering.
SeedStable ordering by point ID. The viewport and render percentages share that ordering, so smaller populations are nested subsets.
Max ViewportCap on target instances after Viewport %. Rendering uses Render % without this cap.
Hide Not TargetHide instances outside Target in the viewport; disable to retain their incoming geometry display.

Native Gaussian splat instances appear as bounding boxes in the SEA viewport.

Colors and channel inspection

ControlWhat it does
ChannelChoose an incoming point channel. Color channels display directly; numeric and vector values use the gradient.
SpaceInterpret transform channels in Local or World space for visualization. Stored data is unchanged.
ComponentX, Y, Z, or Magnitude for vector values.
Min / MaxValue range mapped through the gradient.
Auto rangeUse finite incoming minimum and maximum, including points outside Target. A constant channel uses the gradient midpoint.
Preset / GradientChoose a preset or edit color flags. Double-click changes a color; drag changes its position; right-click adds or removes a flag. End flags remain at 0% and 100%.

Named selection sets are grouped under one heading.

Display versus data

Channel visualization changes appearance, not channel values. Viewport transparency does not rewrite materials. Rendering is controlled separately from point size, viewport LODs, and the viewport cap.

Stacked display and material opacity

Keep Hide no target off to retain incoming display outside a painted target when stacking SeaVisualization modifiers. Full Resolution uses source shader opacity and cutouts. Box, Pyramid, and Convex Hull proxies use the visualization transparency setting independently of source opacity.

Modifiers

SeaChannelEdit

Calculate and write point channel values without rebuilding the source.
On this page · 4 sections
  1. Workflow
  2. Input and arithmetic
  3. Proximity and map operands
  4. Clamp, Retarget, and Output

Workflow

Choose Input and its Component, select an Operation and Operand, then choose Output. Use Clamp and Retarget to constrain or reshape the result. Restrict changes with Target.

Input and arithmetic

ControlWhat it does
Input / ComponentChoose a channel and All, X, Y, Z, or W. None input starts from zero and requires an explicit output channel.
OperationMultiply, Add, Subtract, Blend, Divide, or Set. Set writes the operand directly. Blend interpolates toward it. Division by zero preserves the incoming value.
Operand: ValueUse the numeric Value field.
Operand: ChannelRead another channel and select its component.
Operand: By proximity meshCalculate an operand from distance to reference meshes.
Operand: By proximity splineCalculate an operand from distance to reference splines.
Operand: By mapCalculate an operand from map brightness.
BlendInterpolation amount for the Blend operation.

Proximity and map operands

ControlWhat it does
Pick / Add / RemoveManage reference meshes or splines.
Near Dist / Far Dist / CurveMap distance to the operand value. Curve X is 0 at Far and 1 at Near.
Mesh SamplingVertex (Fast), Face / Triangle (Accurate), or Hybrid (Balanced).
Mesh Side / Fill volumeOutside Mesh, Inside Mesh, or Both Sides; Fill volume makes interior influence full.
Spline Side / Fill opposite sideBoth Sides, Outside Only, or Inside Only, with optional opposite-side fill.
Map / MappingChoose a native map or drag one from the Material Editor. Use UVs or Texture Gizmo.
MultiplierMultiply map brightness. Values over 1 amplify it.

Clamp, Retarget, and Output

ControlWhat it does
Enable Clamp / Min / MaxClamp the arithmetic result to the chosen range.
Enable RetargetNormalize after arithmetic and Clamp, apply the remap curve, then map to the output range.
Input Min / Input MaxNormalization range for Retarget.
Output Min / Output MaxFinal remapped value range.
CurveNormalized input-to-output remapping. Values outside the input range hold the curve’s endpoint values.
OutputChoose an existing channel or type a new name. Same as Input edits the incoming channel. A new channel inherits the whole input type; a selected component creates a float channel.
Output ComponentAuto, All, X, Y, Z, or W determines where the result is written.
Modifiers

SeaConvertToInstances · Modifier

Turn geometry entering this stack into an instance point system.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Related object

Workflow

Apply the modifier to an existing mesh object. Enable Convert by element if each separate mesh element should become its own placement. Add point modifiers above it to edit the resulting system.

All controls

Options.
Options.Click image for full size. Example values are illustrative.
ControlWhat it does
Convert by elementSplit the incoming mesh into elements before conversion.
Detect SimilarShare matching geometry, including repeated elements, while accounting for transforms and pivot differences.
Keep namesStore source names as point named selection sets.
Keep object IDStore source-based ObjectID data on the converted points.
RefreshRebuild conversion from the incoming result.
Move Instances to active layerExpose or move the actual shared shapes to the active scene layer.
StatusRead conversion results or errors.

Related object

Use the object version when you need a list of several scene sources, World/Local placement options, or Hide source objects.

Modifiers

SeaExtract

Create ordinary scene instances from selected point placements.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Result

Workflow

Choose Target and the frame range, inspect the extraction summary, then use Extract. This is an explicit scene operation: it creates nodes when you request extraction. Normal stack evaluation does not create scene nodes.

All controls

Extract.
Extract.Click image for full size. Example values are illustrative.
ControlWhat it does
TargetChoose which points should be extracted.
Min / MaxInclusive frame range. Use the same frame for a static extraction; a range samples animated transforms. Max must be at least Min.
Apply target as selectionAlso apply the target as point selection.
Hide extractedAfter successful extraction, hide the source points and their instances to avoid duplicates. Disable to reveal them again.
ExtractPrepare the operation and create nodes after the tool’s confirmation.
Status / SummaryInspect the planned instance and helper population and frame count.

Result

Extracted geometry uses shared source instances and is added to the active layer. Points without geometry can become point helpers. Animated extraction samples transforms and visibility over the requested range. A large population across many frames can create substantial scene data, so test a small target first.

Modifiers

SeaIsolate

Isolate a point subset and optionally fit it to reference bounds.
On this page · 3 sections
  1. Workflow
  2. Isolate and reference
  3. Position, Rotation, and Scale

Workflow

Choose Target and enable Isolate to focus on that subset. Use Match Bounds when the targeted assembly needs to align or fit a reference object or explicit target box.

Isolate and reference

Isolate.
Isolate.Click image for full size. Example values are illustrative.
ControlWhat it does
Target / IsolateChoose and isolate a subset of the incoming point system.
Enable Match BoundsEnable alignment and fitting.
ModeWorld or Local bounds calculation.
Pick Reference Object / ClearUse another object’s bounds or clear the reference to enter target bounds manually.

Position, Rotation, and Scale

Match Bounds.
Match Bounds.Click image for full size. Example values are illustrative.
ControlWhat it does
Enable PositionEnable bounds position alignment.
Align X/Y/ZChoose None, Min, Center, or Max on the source bounds.
To X/Y/ZAlign to Same, Min, Center, or Max on the destination bounds.
Offset X/Y/ZAdd a positional offset after alignment.
Enable RotationEnable reference rotation matching.
Enable ScaleEnable bounds fitting.
Uniform ScalePreserve proportions with one fit factor.
FitFit Inside, Fill Outside, X, Y, Z, Bounds Perimeter, Bounds Area, or Bounds Volume.
Scale X/Y/ZEnable independent fit axes when uniform scale is off.
Target Position X/Y/Z / Target Size X/Y/ZDefine an explicit target box when no reference is selected.
Modifiers

SeaLeaning

Lean instances toward support geometry or neighboring instance bounds.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Ground and neighbor contact

Workflow

Choose Target, add support geometry to Lean towards geometry, and enable the modifier. Inspect the actual instance size and source pivot because these determine contact. Use the out-of-reach set to find unsupported placements.

All controls

Leaning.
Leaning.Click image for full size. Example values are illustrative.
ControlWhat it does
Enable / TargetActivate the leaning result on the chosen subset.
Lean towards geometry: Pick / Add Selected / RemoveManage support references.
Align width to faceAlign the wider transverse bounds axis parallel to the supporting face before leaning. Uses scaled bounds and the nearest equivalent facing direction.
Contact mode: Geometry onlyUse mesh support geometry.
Contact mode: Bounding boxes (lean on instances)Allow contact with neighboring instance bounds and lift the displayed instance enough to clear its distribution surface. Scatter point positions and source pivots stay unchanged.
Hide out of reachHide instances that cannot reach support.
Create named selection setWrite membership for unsupported instances, including hidden out-of-reach points.
Out-of-reach setName of that selection set. A blank field uses Out of reach.

Ground and neighbor contact

Bounding-box contact accounts for source pivot offsets and the distribution surface. A piece that cannot reach support without intersecting neighbors at its fixed position is marked out of reach. Use Hide out of reach or the named selection set to inspect blocked placements.

Modifiers

SeaPackUnpack

Expose nested point levels for editing, then restore or create parent groups.
On this page · 3 sections
  1. Workflow
  2. All controls
  3. Why this matters

Workflow

  1. Add this modifier to a nested point system, such as a PointRef assembly.
  2. Choose Unpack and set Levels to expose the desired depth.
  3. Add selections and edits above the unpacked level.
  4. Add another Pack / Unpack modifier set to Pack when you want to restore recorded parent levels.

All controls

ControlWhat it does
TargetChoose the nested placements or points to process.
EnableTurn hierarchy processing on or off.
Mode: UnpackExpose deeper point levels.
Mode: PackRestore recorded parent levels, or group targeted points if there is no recorded parent hierarchy.
LevelsNumber of levels to process, from 1 to 16.
Info: PointsPoint count at this modifier’s output, including disabled points.
Info: Unique shapesDistinct sources used at this level, including disabled points. Geometry nested inside a source belongs to a deeper level.
Info: Parent levelsRecorded parent levels available to pack. Parent 1 is the nearest parent.
Parent level / GroupsGroup counts for each recorded parent level.

Why this matters

Unpack exposes the nested point structure without baking all geometry into unique meshes. Check the Info rollout to confirm which level you are editing before targeting a component set.

Modifiers

SeaInstance

Assign source geometry to a targeted subset of points.
On this page · 2 sections
  1. Instances and probabilities
  2. Assignment behavior

Instances and probabilities

Instance source checkboxes, relative probabilities, and Seed.
Instance source checkboxes, relative probabilities, and Seed.Click image for full size.

Choose Target, then Pick, Add, or Remove geometry in Instances. The list initializes from incoming instance sources. Source swatches follow the original wire colors. Each enabled source starts at 100% probability. Values are relative weights and zero excludes a source. Seed makes assignments repeatable. Select several rows to edit their values together. Dynamic rule values apply to current and future matches.

Assignment behavior

An empty source list preserves incoming instances. A list with all weights at zero clears instances on targeted points. Assignments preserve point IDs, transforms, and channels. SeaClusters reads the resulting source palette directly.

Modifiers

SeaPushPull

Move points toward or away from reference geometry or splines.
On this page · 2 sections
  1. Sources, direction, and falloff
  2. Surface constraints and Physics

Sources, direction, and falloff

Choose Target and a Mesh geometry or Splines source list. Pick or add reference objects. Set a signed displacement and shape the influence using Min and Max distance and the curve. Spline distance uses 3D positions. Ignore negative values supports outward displacement along a mesh normal for inside points.

Choose Data Channel to use a Point3 direction for each incoming point. Set the signed Push / Pull amount, then use Strength and Apply softselection as Weights under Options to control the influence.

Surface constraints and Physics

Collision and simulation controls for Push / Pull.
Collision and simulation controls for Push / Pull.Click image for full size.

Use Position to constrain points to their original distribution surface and Orientation to follow its normal. Physics applies the force continuously for the chosen frame count. Select Point, Box, or Convex hull collision, choose surface and explicit colliders, and adjust gravity and motion limits in the shared Physics controls.

While scrubbing, Push/Pull reuses cached physics results when the simulation inputs stay the same.

Shared controls

Target & selection

Choose exactly which incoming points a modifier affects.
On this page · 7 sections
  1. Target modes
  2. Selection and named sets
  3. Data Channel
  4. Object, curve, and point proximity
  5. Paint and Texture targets
  6. Invert and weights
  7. Paint falloff and texture projection

Target modes

ControlWhat it does
AllAffect the entire incoming population. Use this when creating new points with a brush.
SelectionUse points selected in this modifier’s Point subobject level.
Selection (below)Use the selection entering from lower in the stack.
Named Selection SetsUse stored point sets.
Data ChannelChoose points by a numeric, vector, integer, or color channel test.
By Object ProximityUse distance to reference geometry.
By Curve ProximityUse distance to reference splines.
PaintPaint a persistent target region.
TextureUse map brightness as target influence.
By PointsUse reference point centers or instance footprints.
InstanceShapeChoose one or more incoming instance-source slots.

Selection and named sets

ControlWhat it does
Threshold0 includes hard-selected points only. Increasing it includes weaker soft weights; 1 includes every point with positive weight. Unselected points remain excluded.
Set listChoose the named sets you want to target.
Filter setsUse * for any text, ? for one character, [abc] for listed characters, and !pattern to exclude. Separate patterns with semicolons. Matching ignores case.
Index1-based position among visible filtered sets. 0 means no current visible entry.
InstanceShape listSelect source slots. IDs are zero-based as in Point Instance; the internal default pyramid is excluded.

Data Channel

Target — Data Channel.
Target — Data Channel.Click image for full size. Example values are illustrative.
ControlWhat it does
ChannelChoose an incoming Point channel.
SpaceLocal tests stored coordinates. World includes the scatter transform: positions include translation, vectors include rotation/scale, and rotations use XYZ degrees. UVs remain texture coordinates.
AxisX, Y, Z, Magnitude, or Dot Product.
Min / MaxInclusive bounds for the chosen numeric value or component.
ValuesEnter integer IDs or ranges, such as 1,2,5 or 1-7.
Reference ZFor Dot Product, pick an object or helper. Its normalized world Z axis is the reference.
Dot Min / MaxInclusive alignment bounds. Incoming vector magnitude is retained, so values can exceed 1.
Color: Hue / IntensityCompare color hue or average RGB intensity.
Match Color / SimilarityChoose the reference color and tolerance. 0% matches exactly; 100% accepts all hues or intensities.

Object, curve, and point proximity

ControlWhat it does
Reference list / Pick / Add / RemoveManage the geometry, splines, or point references.
Near / Far DistanceFull selection influence through Near, zero at Far. Curve shapes the transition.
Curve / NoiseRemap proximity or displace sampling distance. Curve X runs from 0 at Far to 1 at Near; Y is selection weight. Noise does not move actual points.
Proximity ModeOutside Mesh, Inside Mesh, or Both Sides.
Mesh SamplingVertex (Fast), Face / Triangle (Accurate), or Hybrid (Balanced).
Fill volumeGive interior mesh points full influence.
Spline Side / Fill OppositeBoth Sides, Outside Only, or Inside Only, with optional opposite-side fill.
Points MethodPoints (current) uses 3D center distance. Geometry aware (top view) uses actual mesh footprints in world XY and ignores height.
Footprint Resolution64–4096 px on the longest map side. More detail uses more memory and rebuild time.

Paint and Texture targets

Target — Paint.
Target — Paint.Click image for full size. Example values are illustrative.
ControlWhat it does
Paint: Start Painting / RadiusLeft drag adds area; Shift subtracts; Ctrl + Alt + left drag changes radius.
Paint ProjectionXY, XZ, YZ, or Screen Space. Screen Space captures a persistent view-plane orientation when painting starts.
Paint Min / MaxSigned distance from boundary where weight reaches 0 and 1. Positive is inside. Equal values produce a hard boundary.
Export Boundary / Clear PaintExport the mask boundary or clear the stored target paint.
Texture map / Browse / Clear / RefreshChoose a preset, image, or custom native map; clear it or refresh its preview and sampled data.
MappingUVs uses the map’s assigned channel. Texture Gizmo uses the viewport projection.
ThresholdSet the grayscale cutoff on its own row. The default is 50%. Within valid texture coverage, points pass when sampled brightness meets or exceeds the cutoff.
Link X/Y / Dimensions / Offsets / RotationControl the visible coordinate fields in UV mode. Dimension X/Y are tile extents there.

Invert and weights

Invert reverses the target result. A target chooses eligibility; a modifier’s weight option determines whether fractional influence is used. For example, enable weights in SeaModify to blend transforms through a proximity or texture target.

Paint falloff and texture projection

Target Paint has its own Inside/Outside setting. Outside retains full influence inside the painted boundary and fades outward. Texture mapping uses UVs or Texture Gizmo. UV dimensions begin at 1 × 1 and are stored separately from gizmo dimensions. Use the stack’s Texture Gizmo subobject to position the projection.

On modifiers with Target Outputs, enable Selection to write the target membership to the active point selection, Named Selection Set to store the membership under a name, or Gradient (0–1) to write the target weights to a channel. SeaFilters also has Keep all points for exporting the combined mask without removing rejected points.

Shared controls

Painting & Physics

A complete guide to the Paint object and Paint modifier rollouts.
On this page · 8 sections
  1. Start, finish, and shortcuts
  2. Brush modes
  3. Brush settings
  4. Creation and Instanced Geometry
  5. Physics
  6. Physics Options
  7. Replay and identity
  8. Surface position, orientation, and shortcuts

Start, finish, and shortcuts

Click Start Painting to enter the viewport tool. Right-click or press Enter to finish; Tab cycles brush modes while painting. Ctrl + Alt + left drag adjusts radius. Alt + left drag adjusts creation Z offset. Modifier keys can have brush-specific behavior; use the tool’s current mode when interpreting a stroke.

Brush modes

Brush Tools.
Brush Tools.Click image for full size. Example values are illustrative.
ControlWhat it does
CreatePlace points. Strength is the probability of placing each candidate; Shift erases and Ctrl relaxes.
EraseHide a percentage of points per brush dose. Hold to keep trimming; Shift restores. Falloff reduces influence at the brush edge.
Push/PullPush points apart; Shift pulls them together; Ctrl relaxes.
RelaxSmooth local point spacing.
ScaleApply Add, Multiply, Replace, or Subtract. Scale Value is a delta, factor, or target depending on operation. Shift reverses Add/Subtract.
MoveMove the affected points with a drag.
SmudgeMove points by a percentage of mouse travel, multiplied by brush falloff.
Data ChannelPaint an incoming numeric or color channel. Choose Channel, Axis (X/Y/Z/W/All), Operation (Add/Set/Multiply), Value, or Color. Ctrl averages components independently. Refresh Channels reloads the available list.
InstanceShapePaint chosen source variants onto existing points. Refresh Shapes updates the source palette. Multiple choices are randomized.
ChaosAgitate the affected points. Choose 1 Kick or Continuous Chaos, enable the available agitation components, and set their strengths. Continuous mode keeps agitating while held, including physics substeps.

Brush settings

ControlWhat it does
RadiusOuter brush radius.
FalloffInner falloff region controlling transition toward the outer brush edge.
DensityNumber of candidate points per stamp.
SpacingMinimum spacing while creating points.
StrengthInfluence of Push/Pull and Relax, or creation probability. Smudge has its own percentage of mouse travel.
Erase %Percentage hidden or restored with each dose, from 0–100%.
Brush ShapeCircle, Square, or Sphere.
ProjectionXY, XZ, YZ, or Screen Space fallback plane. Surface hits take priority.
Position / OrientationConstrain point origins to the recorded surface and optionally align instance orientation to its normal.
Force snapPrefer point hits over surface hits. With this off, point hits are used only if no surface is hit.
Preview PointsShow point previews while working.
Clear StrokesRemove the stroke history stored in this object or modifier.

Creation and Instanced Geometry

ControlWhat it does
Min scale / Max scaleRandom scale range for new points.
Randomize rotationsOff, All axes, or Z axis.
Z offsetOffset new points along the painted surface normal. Negative values move into the surface.
Sources: Incoming/DefaultUse the incoming instance sources or default geometry.
Sources: From listUse the explicitly managed geometry list.
Sources: Pick GeometryChoose geometry through the picking workflow.
Pick / Add Selected / RemoveManage the source list.
Source selectionSelected sources are randomized per point. No selection uses every listed source. During a held stroke, move over an expanded list entry to switch geometry, then return to the viewport. Earlier strokes retain their sources and colors.

Physics

ControlWhat it does
PhysicsEnable collision simulation for brush edits and creation settling.
CollisionPoint, Box, or Convex hull.
Collision scaleMultiply collision shape size without changing visible geometry size.
Point radiusScene-unit radius, further multiplied by point scale, object scale, and Collision scale.
On create apply it forSettle only newly created points after release for this number of scene frames. 0 skips settling.
Gravity / MagnitudeDownward world-Z acceleration in scene units per second squared. Surface Position constraints remain active with Gravity.
Use scene objectsAlso collide with geometry visited by the brush. Create remembers surfaces touched during the stroke.
Collision objects: Pick / Add / RemoveManage additional colliders.
Geometry: Convex hullUse solid hulls, placed separately for each point-system instance with its transforms and offsets.
Geometry: MeshUse triangles, preserving holes and concave surfaces.

Physics Options

Physics Options.
Physics Options.Click image for full size. Example values are illustrative.
ControlWhat it does
Simulation speedTime multiplier for held simulation, 0.1–10×. Default is 3×. It does not multiply gravity or change Create frame duration.
Linear dragDamp translational motion; 0 disables drag. Units are inverse seconds.
Angular dragDamp rotation when orientation is unconstrained.
Max speedLimit linear velocity in world scene units per second.
Max spinLimit angular velocity in degrees per second.
Separation speedLimit overlap-correction velocity. Lower values reduce explosive separation impulses.

Replay and identity

Physics and source settings are captured for new strokes. Editing an option does not necessarily resimulate earlier strokes. The Paint modifier’s Strength controls overall edit influence; its ID field chooses particle matching. Use a stable unique ID channel for animated caches when available.

Surface position, orientation, and shortcuts

In Brush Settings, use Position to project touched points onto their recorded surface, including during Physics with Gravity enabled. Orientation aligns instances to the surface normal while preserving heading and scale. The viewport shortcut legend follows the active brush and Max key assignments.

Shared controls

Maps, curves & noise

Use consistent spatial masks and smooth transitions across the tool.
On this page · 4 sections
  1. Map slots
  2. Interpreting brightness
  3. Curves
  4. Noise controls

Map slots

Distribution Map Browser.
Distribution Map Browser.Click image for full size. Example values are illustrative.
ControlWhat it does
Choose mapClick a map slot to browse its presets or native map picker. Where supported, drag in an image or a Material Editor map.
Right-clickBrowse or clear the map. Some map controls also expose coordinate options.
UVsUse the UV channel assigned in the map. Prepare suitable source UVs before using this mode.
Texture GizmoUse the stack gizmo as the projection. Select the corresponding Texture Gizmo subobject and use Max Move, Rotate, and Scale.
Dimension X/YProjection width and height in the visible coordinate workflow. UV dimensions describe tile extent; world projection dimensions use scene units.
Link X/YUse the same dimensions on both axes.
Offset X/Y / RotationTranslate and rotate map coordinates.
Strength / Weight0% removes map influence, 100% applies it fully. The map drives the operation it belongs to: density, selection, transform variation, or an operand.
Refresh MapResample external or changed map content.

Interpreting brightness

SeaPointDistribution and SeaFilters Texture use a brightness cutoff after inversion. On a SeaFilters Texture entry, brightness is tested against Threshold after Invert; Tileable determines whether the mask repeats or is limited to one footprint. For transform ranges, black maps to Min and white maps to Max. For Target, brightness supplies selection weight. For ChannelEdit, brightness becomes an operand and Multiplier can amplify it.

Curves

Transform Curve.
Transform Curve.Click image for full size. Example values are illustrative.

Curves remap a normalized input into an output weight. Read the axis hint in the dialog: proximity curves use X = 0 at Far and 1 at Near; selection falloff uses normalized distance; Retarget uses normalized channel value. A straight rising line preserves the normalized input. Bend it to sharpen, flatten, or delay a transition.

Where Steepness is offered, enable it and choose the number of output intervals to quantize the result. For example, 18 steps across a 0–360° range produces 20° increments.

Noise controls

Distance Noise.
Distance Noise.Click image for full size. Example values are illustrative.

Noise displaces mask or selection distance sampling without moving points. Enable the noise, then choose Simplex, Simplex Fractal, Ridged Fractal, or Turbulence where offered. Scale sets feature size; Strength sets distance displacement; Octaves, Roughness, Lacunarity, and Gain shape detail. Seed changes the repeatable pattern; Phase shifts evolution; Frequency animates evolution per second. A frequency of 0 is static. The remap Curve adjusts contrast.

Shared controls

Workflow & troubleshooting

Resolve common setup problems before increasing scene complexity.
On this page · 7 sections
  1. Nothing appears
  2. My modifier affects the wrong points
  3. The texture or proximity mask looks wrong
  4. Instances intersect or float
  5. Painting changes when the source updates
  6. The viewport is slow
  7. A referenced assembly is difficult to edit

Nothing appears

Check the surface or cache path, point count, active distribution mode, and source size. Temporarily disable masks and culling, use Target: All, and inspect the result with a simple pyramid or bounding-box display. A default pyramid is a point preview rather than your final source geometry.

My modifier affects the wrong points

Target — Data Channel.
Target — Data Channel.Click image for full size. Example values are illustrative.

Check Target and stack order. Selection means this modifier’s own Point subobject selection; Selection (below) means incoming selection. Verify named-set filters and InstanceShape indices. Use Visualization to inspect channel values before building a Data Channel target.

The texture or proximity mask looks wrong

Check UVs versus Texture Gizmo, projection scale, map Strength, Invert, reference lists, and Near/Far distances. Geometry-aware point proximity is a top-view XY footprint and ignores height; use point-center distance when you need a 3D center test.

Instances intersect or float

Check source pivot, bounds, instance scale, creation offset, and the placement of KillOverlaps in the stack. Increase collision precision only as needed. For physics, check touched surfaces or explicit colliders, collision scale, Gravity, and Constraint orientation. Sparse leaf cards may need lower Density Profile density.

Painting changes when the source updates

Use a stable unique particle ID in the Paint modifier. Index follows ordering, and missing or duplicate matching keys are skipped. Keep required source geometry and referenced files available.

The viewport is slow

Instances.
Instances.Click image for full size. Example values are illustrative.

Use Visualization’s Viewport percentage, Max Viewport, and bounding-box or LOD display. Keep Render percentage appropriate to the final shot. Read every in Loader reduces imported points; visualization limits only change display. High footprint resolution, profile quality, ray samples, and complex physics colliders all increase work.

A referenced assembly is difficult to edit

Use PointRef’s stored name/material/group sets. Add Pack / Unpack to expose deeper levels, then target the desired parts. Inspect its Points, Unique shapes, and Parent levels before editing or packing again.

Shared controls

Dynamic source lists

Keep object lists in sync with layers and naming rules.
On this page · 3 sections
  1. Add and edit a rule
  2. Wildcard syntax and live membership
  3. Enable, disable, and edit selected rows

Add and edit a rule

Dynamic sources dialog with the Wildcard scope enabled.
Dynamic sources dialog with the Wildcard scope enabled.Click image for full size.

Right-click Pick or Add and choose Dynamic. Enable Dynamic Layer and check layers in the tree. Add nested layers includes descendants. Enable Wildcard to match scene names. When both switches are enabled, names must match within the checked layer scopes. Double-click a rule in either list view to edit it. Disabled scopes retain their settings.

Wildcard syntax and live membership

Matching ignores case. Use * for any text, ? for one character, [abc] for a character set, and [!abc] for its complement. Separate alternatives with semicolons and prefix exclusions with !. A rule such as Cars*; !Cars_old* includes car names and excludes the old set. Rules follow scene edits and layer renames, deduplicate overlapping references, and count eligible sources. Hidden geometry remains eligible. Private internal nodes and dependency cycles are excluded.

Enable, disable, and edit selected rows

Use the checkbox to pause a source or rule while retaining its order, references, and values. Clicking the checkbox of a selected row applies the change to all selected rows in one undo step. An unselected row changes on its own. Compact and expanded editors support the same selection behavior. In SeaPacking and SeaInstance, selected-row value edits also work with a mix of direct objects and dynamic rules.

Shift-click includes disabled rows in the selected range. Batch visibility changes can apply to those rows as well.