@needle-tools/engine/lib/engine-components/AxesHelper.d.ts

Needle Engine is a web-based runtime for 3D apps. It runs on your machine for development with great integrations into editors like Unity or Blender - and can be deployed onto any device! It is flexible, extensible and networking and XR are built-in.

import { Behaviour } from "./Component.js";
/**
 * The [AxesHelper](https://engine.needle.tools/docs/api/AxesHelper) visualizes the local coordinate axes of an object.
 * Displays colored lines for X (red), Y (green), and Z (blue) axes.
 *
 * **Use cases:**
 * - Debugging object orientation and rotation
 * - Visualizing pivot points
 * - Understanding coordinate systems
 *
 * **Properties:**
 * - `length` - Length of axis lines in world units
 * - `depthTest` - Whether axes are occluded by scene objects
 * - `isGizmo` - Only show when `?gizmos` URL parameter is set
 *
 * @example Add axes visualization
 * ```ts
 * const axes = myObject.addComponent(AxesHelper);
 * axes.length = 2;
 * axes.depthTest = false; // Always visible on top
 * ```
 *
 * @summary Visualizes object axes (X=red, Y=green, Z=blue)
 * @category Helpers
 * @group Components
 * @see {@link GridHelper} for grid visualization
 * @see {@link Gizmos} for debug drawing utilities
 */
export declare class AxesHelper extends Behaviour {
    /**
     * The length of each axis line in scene units.
     */
    length: number;
    /**
     * Whether the axes should be occluded by objects in the scene.
     * When set to false, axes will always appear on top regardless of their depth.
     */
    depthTest: boolean;
    /**
     * When true, this helper will only be visible if the debug flag `?gizmos` is enabled.
     */
    isGizmo: boolean;
    private _axes;
    /**
     * Creates and adds the axes visualization to the scene when the component is enabled.
     * If marked as a gizmo, it will only be shown when gizmos are enabled in the global parameters.
     */
    onEnable(): void;
    /**
     * Removes the axes visualization from the scene when the component is disabled.
     */
    onDisable(): void;
}