Altair EEvision 2025.1 APIs
    Preparing search index...

    Type Alias ExtractOneOptions

    Options for configuring the 1-context extractor of EEvision, see EEvisionAPI.ExtractOne.

    type ExtractOneOptions = {
        extractMax: number;
        ignoreArcs: boolean;
        ignoreGround: boolean;
        ignorePower: boolean;
        markio: boolean;
        preciseAppear: boolean;
        smart: "off" | "only" | "hybrid";
        startColor: string | null;
    }
    Index

    Properties

    extractMax: number

    Maximum number of components to return as a result of the Path Extractor. If its value is 0, the number unlimited.

    0

    ignoreArcs: boolean

    If true, do not follow electrical connections within a component (so-called arcs).

    false

    ignoreGround: boolean

    If true, do not follow ground wires.

    false

    ignorePower: boolean

    If true, do not follow power wires.

    false

    markio: boolean

    If true and if smart extraction is enabled (see {@link ExtractOneOptions}.smart), then the flow direction from the "smartstop" object is shown using small arrows on the wires.

    false

    preciseAppear: boolean

    If true, only the actual terminal object is highlighted, e.g., in case of a component, only the component body, but not its connectors or cavities. If false, the connectors of extracted components are highlighted as well.

    true

    smart: "off" | "only" | "hybrid"

    Enables or disables the “smart” extraction feature of EEvisionAPI.ExtractOne. The smart behavior requires that some EDB components, connectors, or cavities are labeled with the attribute "␣smartstop" (with a leading space!). If an electrical network that is connected to the extracted object contains such a “smartstop” object, only those paths of that network that lead to the “smartstop” object are loaded instead of the whole electrical network. Typical examples are that the power source or the main ground eyelet(s) are marked as smartstop.

    The values have the following meaning:

    • "off" disables the smart behavior, i.e., the extractor loads the whole electrical network that is connected to the cavities of the extracted object.
    • "only" limits the extraction to those electrical networks that actually contain a “smartstop” object; electrical networks without such an object are not extracted.
    • "hybrid" loads, for those networks that contain a “smartstop” object, only the paths to this object; for networks without “smartstop” the whole network is loaded.

    hybrid

    startColor: string | null

    Color that is used to highlight the extracted object. If it is null, the object is not highlighted.

    null