Interface PickObjectsAtOptions

Options for picking objects from the Giro3D Instance.

interface PickObjectsAtOptions {
    filter?: PickFilterCallback;
    gpuPicking?: boolean;
    limit?: number;
    pickFeatures?: boolean;
    radius?: number;
    raycaster?: Raycaster;
    sortByDistance?: boolean;
    where?: (string | Object3D<Object3DEventMap> | Entity<EntityEventMap, EntityUserData>)[];
}

Hierarchy (view full)

Properties

filter? gpuPicking? limit? pickFeatures? radius? raycaster? sortByDistance? where?

Properties

Optionalfilter

filter?: PickFilterCallback

Filter on the picked results

OptionalgpuPicking

gpuPicking?: boolean

If disabled, picking will using CPU raycasting when possible (rather than GPU picking). Main differences between CPU raycasting and GPU picking:

  • CPU raycasting is generally much faster to execute and does not require blocking the thread to wait for the GPU queue to complete.

Disadvantages:

  • CPU raycasting might give less accurate results in some specific cases,
  • CPU raycasting might not return complete information, only the picked point coordinates.
  • CPU raycasting does not ignore transparent pixels, whereas GPU picking does. It might be a disadvantage or advantage depending on the use case.

Default Value

false

Optionallimit

limit?: number

Maximum number of objects to return.

Default Value

Infinity

OptionalpickFeatures

pickFeatures?: boolean

Indicates if features information are also retrieved from the picked object. On complex objects, this may be slow, and therefore is disabled by default.

Default Value

false

Optionalradius

radius?: number

Radius (in pixels) for picking (default 0).

Picking will happen in a circle centered on the coordinates provided. Radius is the radius of this circle, in pixels.

This is honored by all native Giro3D picking methods, but may not be honored by customized picking methods.

Default Value

0

Optionalraycaster

raycaster?: Raycaster

The optional raycaster to use for raycast-based picking. This is mostly useful in the case of point clouds to fine tune the raycaster parameters, depending on the caracteristics of the dataset (i.e size, shape, point density).

Default Value

new Raycaster()

OptionalsortByDistance

sortByDistance?: boolean

Indicates if the results should be sorted by distance, as Three.js raycasting does. This prevents the limit option to be fully used as it is applied after sorting, thus it may be slow and is disabled by default.

Default Value

false

Optionalwhere

where?: (string | Object3D<Object3DEventMap> | Entity<EntityEventMap, EntityUserData>)[]

List of entities to pick from. If not provided, will pick from all the objects in the scene. Strings consist in the IDs of the object.

Settings

Member Visibility

On This Page

Properties