Titania X3D Editor

It starts with you!

Titania v3.0.4

It starts with you!

X3D Reference

LinePickSensor

LinePickSensor

LinePickSensor uses one or more pickingGeometry line segments to compute intersections with pickTarget shapes. As each line intersection generates a known point in space, useful event information is returned including normal, geometry and texCoord values.

The LinePickSensor node belongs to the Picking component and its container field is children. It is available since X3D version 3.2 or later.

Hierarchy

Fields

SFNode [in, out] metadata NULL [X3DMetadataObject]

Metadata are not part of the X3D world and not interpreted by the X3D browser, but they can be accessed via the ECMAScript interface.

SFBool [in, out] enabled TRUE

Enables/disables node operation.

SFBool [out] isActive

IsActive indicates when the intersecting object is picked by the picking geometry. Output event isActive=true gets sent once a picked item is found. Output event isActive=false gets sent once no picked item is found.

MFString [in, out] objectType "ALL" ["ALL","NONE","TERRAIN",...]

The objectType field specifies a set of labels used in the picking process. Each string specified is treated as an independent label that needs to be matched against the same type in one of the pick sensor instances.

Hints

Authors may define any value for objectType. MFString arrays can have multiple values, so "separate each individual string" "by using quote marks".

SFNode [in, out] pickingGeometry NULL [IndexedLineSet|LineSet]

PickingGeometry specifies the exact geometry coordinates that are used to perform the intersection testing of the picking operation.

MFNode [in, out] pickTarget [ ] [X3DGroupingNode|X3DShapeNode|Inline]

PickTarget specifies the list of nodes against which picking operations are performed. All nodes declared in this field and their descendents are evaluated for intersections.

MFNode [out] pickedGeometry

Output event containing the node or nodes that have been found to intersect with the picking geometry from the last time this node performed a picking operation, given in the local coordinate system.

SFString [ ] intersectionType "BOUNDS" ["GEOMETRY"|"BOUNDS"|...]

IntersectionType specifies precision of the collision computation.

Hint

IntersectionType constants may be extended by the browser to provide additional options.

Warning

Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.

SFString [ ] sortOrder "CLOSEST" ["ANY"|"CLOSEST"|"ALL"|"ALL_SORTED"]

The sortOrder field determines the order provided for picked output events.

Hint

Browser implementations may define additional values and algorithms beyond these four required values.

Warning

Do not wrap extra quotation marks around these SFString enumeration values, since "quotation" "marks" are only used for MFString values.

MFVec3f [out] pickedNormal

Output event containing surface normal vectors computed by the picking intersection computations.

MFVec3f [out] pickedPoint

Output event containing 3D points on surface of underlying pickingGeometry computed by the picking intersection computations, given in the local coordinate system.

MFVec3f [out] pickedTextureCoordinate

Output event containing 3D texture coordinates of surfaces computed by the picking intersection computations. Picked texture coordinates are in three dimensions. If the target texture coordinate has two dimensions, the third coordinate (z component of an SFVec3f) shall be zero.

Warning

If the target object has multiple textures defined, only texture coordinates for the first texture are returned and all other textures are ignored.

Description

Hints

  • Sort order for line picking is based on each pair of coordinates that defining a line segment, with first declared vertex of the segment defined to be the start of the line to which the intersection points are closest.
  • Picking is performed between rendered frames of the event model. An author sets up the picking request in one frame by placing a LinePickSensor in the desired location. At the start of the next frame, any picking intersections are reported by the pick sensor.
  • Picking notification is performed at the start of the frame for all enabled pick sensors once all other sensors are processed.
  • IndexedLineSet or Lineset can be used for pickingGeometry node.

Warning

  • Order of contained nodes is significant, single pickingGeometry node must precede pickTarget node array.

Browser Compatibility

Titania X_ITE
no no