@zaber/motion 4.5.1 → 4.6.0

package/dist/lib/microscopy/microscope.js

@@ -0,0 +1,142 @@
+"use strict";
+// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //
+// ============= DO NOT EDIT DIRECTLY ============= //
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Microscope = void 0;
+const gateway = __importStar(require("../gateway"));
+const axis_1 = require("../ascii/axis");
+const axis_group_1 = require("../ascii/axis_group");
+const device_1 = require("../ascii/device");
+const illuminator_1 = require("./illuminator");
+const objective_changer_1 = require("./objective_changer");
+const microscope_config_1 = require("./microscope_config");
+const filter_changer_1 = require("./filter_changer");
+/**
+ * Represent a microscope.
+ * It is subject to breaking changes without warning until further notice.
+ * Parts of the microscope may or may not be instantiated depending on the configuration.
+ * Requires at least Firmware 7.34.
+ */
+class Microscope {
+    /**
+     * Connection of the microscope.
+     */
+    get connection() {
+        return this._connection;
+    }
+    /**
+     * The illuminator.
+     */
+    get illuminator() {
+        return this._illuminator;
+    }
+    /**
+     * The focus axis.
+     */
+    get focusAxis() {
+        return this._focusAxis;
+    }
+    /**
+     * The X axis.
+     */
+    get xAxis() {
+        return this._xAxis;
+    }
+    /**
+     * The Y axis.
+     */
+    get yAxis() {
+        return this._yAxis;
+    }
+    /**
+     * Axis group consisting of X and Y axes representing the plate of the microscope.
+     */
+    get plate() {
+        return this._plate;
+    }
+    /**
+     * The objective changer.
+     */
+    get objectiveChanger() {
+        return this._objectiveChanger;
+    }
+    /**
+     * The filter changer.
+     */
+    get filterChanger() {
+        return this._filterChanger;
+    }
+    /**
+     * Creates instance of `Microscope` from the given config.
+     * Parts are instantiated depending on device addresses in the config.
+     */
+    constructor(connection, config) {
+        var _a, _b, _c;
+        this._connection = connection;
+        this._config = microscope_config_1.MicroscopeConfig.fromProtobuf(microscope_config_1.MicroscopeConfig.toProtobuf(config).toObject());
+        this._illuminator = config.illuminator ? new illuminator_1.Illuminator(new device_1.Device(connection, config.illuminator)) : undefined;
+        this._focusAxis = ((_a = config.focusAxis) === null || _a === void 0 ? void 0 : _a.device) ? new axis_1.Axis(new device_1.Device(connection, config.focusAxis.device), config.focusAxis.axis) : undefined;
+        this._xAxis = ((_b = config.xAxis) === null || _b === void 0 ? void 0 : _b.device) ? new axis_1.Axis(new device_1.Device(connection, config.xAxis.device), config.xAxis.axis) : undefined;
+        this._yAxis = ((_c = config.yAxis) === null || _c === void 0 ? void 0 : _c.device) ? new axis_1.Axis(new device_1.Device(connection, config.yAxis.device), config.yAxis.axis) : undefined;
+        this._plate = this._xAxis && this._yAxis ? new axis_group_1.AxisGroup([this._xAxis, this._yAxis]) : undefined;
+        this._objectiveChanger = config.objectiveChanger && this._focusAxis ? new objective_changer_1.ObjectiveChanger(new device_1.Device(connection, config.objectiveChanger), this._focusAxis) : undefined;
+        this._filterChanger = config.filterChanger ? new filter_changer_1.FilterChanger(new device_1.Device(connection, config.filterChanger)) : undefined;
+    }
+    /**
+     * Finds a microscope on a connection.
+     * @param connection Connection on which to detect the microscope.
+     * @returns New instance of microscope.
+     */
+    static async find(connection) {
+        const request = new gateway.InterfaceEmptyRequest();
+        request.setInterfaceId(connection.interfaceId);
+        const response = await gateway.callAsync('microscope/detect', request, gateway.MicroscopeConfig);
+        return new Microscope(connection, microscope_config_1.MicroscopeConfig.fromProtobuf(response.toObject()));
+    }
+    /**
+     * Initializes the microscope.
+     * Homes all axes, filter changer, and objective changer.
+     */
+    async initialize() {
+        const request = new gateway.MicroscopeEmptyRequest();
+        request.setInterfaceId(this.connection.interfaceId);
+        request.setConfig(microscope_config_1.MicroscopeConfig.toProtobuf(this._config));
+        await gateway.callAsync('microscope/initialize', request);
+    }
+    /**
+     * Returns a string that represents the microscope.
+     * @returns A string that represents the microscope.
+     */
+    toString() {
+        const request = new gateway.MicroscopeEmptyRequest();
+        request.setInterfaceId(this.connection.interfaceId);
+        request.setConfig(microscope_config_1.MicroscopeConfig.toProtobuf(this._config));
+        const response = gateway.callSync('microscope/to_string', request, gateway.StringResponse);
+        return response.getValue();
+    }
+}
+exports.Microscope = Microscope;
+//# sourceMappingURL=microscope.js.map

package/dist/lib/microscopy/microscope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microscope.js","sourceRoot":"","sources":["../../../src/microscopy/microscope.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtD,oDAAsC;AACtC,wCAAqC;AACrC,oDAAgD;AAChD,4CAAyC;AAEzC,+CAA4C;AAC5C,2DAAuD;AACvD,2DAAuD;AACvD,qDAAiD;AAEjD;;;;;GAKG;AACH,MAAa,UAAU;IACrB;;OAEG;IACH,IAAW,UAAU;QACnB,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAKD;;OAEG;IACH,IAAW,WAAW;QACpB,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAGD;;OAEG;IACH,IAAW,SAAS;QAClB,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAGD;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAGD;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAGD;;OAEG;IACH,IAAW,KAAK;QACd,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAGD;;OAEG;IACH,IAAW,gBAAgB;QACzB,OAAO,IAAI,CAAC,iBAAiB,CAAC;IAChC,CAAC;IAGD;;OAEG;IACH,IAAW,aAAa;QACtB,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAGD;;;OAGG;IACH,YAAY,UAAsB,EAAE,MAAwB;;QAC1D,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,oCAAgB,CAAC,YAAY,CAAC,oCAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC;QAC7F,IAAI,CAAC,YAAY,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,yBAAW,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjH,IAAI,CAAC,UAAU,GAAG,CAAA,MAAA,MAAM,CAAC,SAAS,0CAAE,MAAM,EAAC,CAAC,CAAC,IAAI,WAAI,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1I,IAAI,CAAC,MAAM,GAAG,CAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,MAAM,EAAC,CAAC,CAAC,IAAI,WAAI,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1H,IAAI,CAAC,MAAM,GAAG,CAAA,MAAA,MAAM,CAAC,KAAK,0CAAE,MAAM,EAAC,CAAC,CAAC,IAAI,WAAI,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAC1H,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,sBAAS,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACjG,IAAI,CAAC,iBAAiB,GAAG,MAAM,CAAC,gBAAgB,IAAI,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,oCAAgB,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,gBAAgB,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACzK,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,8BAAa,CAAC,IAAI,eAAM,CAAC,UAAU,EAAE,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC3H,CAAC;IAED;;;;OAIG;IACI,MAAM,CAAC,KAAK,CAAC,IAAI,CACtB,UAAsB;QAEtB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,qBAAqB,EAAE,CAAC;QACpD,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QAE/C,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,SAAS,CACtC,mBAAmB,EACnB,OAAO,EACP,OAAO,CAAC,gBAAgB,CAAC,CAAC;QAC5B,OAAO,IAAI,UAAU,CAAC,UAAU,EAAE,oCAAgB,CAAC,YAAY,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;IAED;;;OAGG;IACI,KAAK,CAAC,UAAU;QACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACpD,OAAO,CAAC,SAAS,CAAC,oCAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7D,MAAM,OAAO,CAAC,SAAS,CAAC,uBAAuB,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACI,QAAQ;QACb,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC;QACrD,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACpD,OAAO,CAAC,SAAS,CAAC,oCAAgB,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;QAE7D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAC/B,sBAAsB,EACtB,OAAO,EACP,OAAO,CAAC,cAAc,CAAC,CAAC;QAC1B,OAAO,QAAQ,CAAC,QAAQ,EAAE,CAAC;IAC7B,CAAC;CACF;AAhID,gCAgIC","sourcesContent":["// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //\n// ============= DO NOT EDIT DIRECTLY ============= //\n\nimport * as gateway from '../gateway';\nimport { Axis } from '../ascii/axis';\nimport { AxisGroup } from '../ascii/axis_group';\nimport { Device } from '../ascii/device';\nimport { Connection } from '../ascii/connection';\nimport { Illuminator } from './illuminator';\nimport { ObjectiveChanger } from './objective_changer';\nimport { MicroscopeConfig } from './microscope_config';\nimport { FilterChanger } from './filter_changer';\n\n/**\n * Represent a microscope.\n * It is subject to breaking changes without warning until further notice.\n * Parts of the microscope may or may not be instantiated depending on the configuration.\n * Requires at least Firmware 7.34.\n */\nexport class Microscope {\n  /**\n   * Connection of the microscope.\n   */\n  public get connection(): Connection {\n    return this._connection;\n  }\n  private _connection: Connection;\n\n  private _config: MicroscopeConfig;\n\n  /**\n   * The illuminator.\n   */\n  public get illuminator(): Illuminator | undefined {\n    return this._illuminator;\n  }\n  private _illuminator: Illuminator | undefined;\n\n  /**\n   * The focus axis.\n   */\n  public get focusAxis(): Axis | undefined {\n    return this._focusAxis;\n  }\n  private _focusAxis: Axis | undefined;\n\n  /**\n   * The X axis.\n   */\n  public get xAxis(): Axis | undefined {\n    return this._xAxis;\n  }\n  private _xAxis: Axis | undefined;\n\n  /**\n   * The Y axis.\n   */\n  public get yAxis(): Axis | undefined {\n    return this._yAxis;\n  }\n  private _yAxis: Axis | undefined;\n\n  /**\n   * Axis group consisting of X and Y axes representing the plate of the microscope.\n   */\n  public get plate(): AxisGroup | undefined {\n    return this._plate;\n  }\n  private _plate: AxisGroup | undefined;\n\n  /**\n   * The objective changer.\n   */\n  public get objectiveChanger(): ObjectiveChanger | undefined {\n    return this._objectiveChanger;\n  }\n  private _objectiveChanger: ObjectiveChanger | undefined;\n\n  /**\n   * The filter changer.\n   */\n  public get filterChanger(): FilterChanger | undefined {\n    return this._filterChanger;\n  }\n  private _filterChanger: FilterChanger | undefined;\n\n  /**\n   * Creates instance of `Microscope` from the given config.\n   * Parts are instantiated depending on device addresses in the config.\n   */\n  constructor(connection: Connection, config: MicroscopeConfig) {\n    this._connection = connection;\n    this._config = MicroscopeConfig.fromProtobuf(MicroscopeConfig.toProtobuf(config).toObject());\n    this._illuminator = config.illuminator ? new Illuminator(new Device(connection, config.illuminator)) : undefined;\n    this._focusAxis = config.focusAxis?.device ? new Axis(new Device(connection, config.focusAxis.device), config.focusAxis.axis) : undefined;\n    this._xAxis = config.xAxis?.device ? new Axis(new Device(connection, config.xAxis.device), config.xAxis.axis) : undefined;\n    this._yAxis = config.yAxis?.device ? new Axis(new Device(connection, config.yAxis.device), config.yAxis.axis) : undefined;\n    this._plate = this._xAxis && this._yAxis ? new AxisGroup([this._xAxis, this._yAxis]) : undefined;\n    this._objectiveChanger = config.objectiveChanger && this._focusAxis ? new ObjectiveChanger(new Device(connection, config.objectiveChanger), this._focusAxis) : undefined;\n    this._filterChanger = config.filterChanger ? new FilterChanger(new Device(connection, config.filterChanger)) : undefined;\n  }\n\n  /**\n   * Finds a microscope on a connection.\n   * @param connection Connection on which to detect the microscope.\n   * @returns New instance of microscope.\n   */\n  public static async find(\n    connection: Connection\n  ): Promise<Microscope> {\n    const request = new gateway.InterfaceEmptyRequest();\n    request.setInterfaceId(connection.interfaceId);\n\n    const response = await gateway.callAsync<gateway.MicroscopeConfig>(\n      'microscope/detect',\n      request,\n      gateway.MicroscopeConfig);\n    return new Microscope(connection, MicroscopeConfig.fromProtobuf(response.toObject()));\n  }\n\n  /**\n   * Initializes the microscope.\n   * Homes all axes, filter changer, and objective changer.\n   */\n  public async initialize(): Promise<void> {\n    const request = new gateway.MicroscopeEmptyRequest();\n    request.setInterfaceId(this.connection.interfaceId);\n    request.setConfig(MicroscopeConfig.toProtobuf(this._config));\n\n    await gateway.callAsync('microscope/initialize', request);\n  }\n\n  /**\n   * Returns a string that represents the microscope.\n   * @returns A string that represents the microscope.\n   */\n  public toString(): string {\n    const request = new gateway.MicroscopeEmptyRequest();\n    request.setInterfaceId(this.connection.interfaceId);\n    request.setConfig(MicroscopeConfig.toProtobuf(this._config));\n\n    const response = gateway.callSync<gateway.StringResponse>(\n      'microscope/to_string',\n      request,\n      gateway.StringResponse);\n    return response.getValue();\n  }\n}\n\nnamespace Microscope {\n}\n"]}

package/dist/lib/microscopy/microscope_config.d.ts

@@ -0,0 +1,34 @@
+import { AxisAddress } from '../axis_address';
+/**
+ * Configuration representing a microscope setup.
+ * Device address of value 0 means that the part is not present.
+ */
+export interface MicroscopeConfig {
+    /**
+     * Focus axis of the microscope.
+     */
+    focusAxis?: AxisAddress;
+    /**
+     * X axis of the microscope.
+     */
+    xAxis?: AxisAddress;
+    /**
+     * Y axis of the microscope.
+     */
+    yAxis?: AxisAddress;
+    /**
+     * Illuminator device address.
+     */
+    illuminator?: number;
+    /**
+     * Filter changer device address.
+     */
+    filterChanger?: number;
+    /**
+     * Objective changer device address.
+     */
+    objectiveChanger?: number;
+}
+export declare namespace MicroscopeConfig {
+    const __type = "MicroscopeConfig";
+}

package/dist/lib/microscopy/microscope_config.js

@@ -0,0 +1,65 @@
+"use strict";
+// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //
+// ============= DO NOT EDIT DIRECTLY ============= //
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MicroscopeConfig = void 0;
+const gateway = __importStar(require("../gateway"));
+const axis_address_1 = require("../axis_address");
+var MicroscopeConfig;
+(function (MicroscopeConfig) {
+    MicroscopeConfig.__type = 'MicroscopeConfig';
+    /** @internal */
+    function fromProtobuf(pbData) {
+        return {
+            focusAxis: pbData.focusAxis != null ? axis_address_1.AxisAddress.fromProtobuf(pbData.focusAxis) : undefined,
+            xAxis: pbData.xAxis != null ? axis_address_1.AxisAddress.fromProtobuf(pbData.xAxis) : undefined,
+            yAxis: pbData.yAxis != null ? axis_address_1.AxisAddress.fromProtobuf(pbData.yAxis) : undefined,
+            illuminator: pbData.illuminator,
+            filterChanger: pbData.filterChanger,
+            objectiveChanger: pbData.objectiveChanger,
+        };
+    }
+    MicroscopeConfig.fromProtobuf = fromProtobuf;
+    /** @internal */
+    function toProtobuf(source) {
+        const pbData = new gateway.MicroscopeConfig();
+        if (source == null) {
+            pbData.setFocusAxis(axis_address_1.AxisAddress.toProtobuf(null));
+            pbData.setXAxis(axis_address_1.AxisAddress.toProtobuf(null));
+            pbData.setYAxis(axis_address_1.AxisAddress.toProtobuf(null));
+            return pbData;
+        }
+        pbData.setFocusAxis(axis_address_1.AxisAddress.toProtobuf(source.focusAxis));
+        pbData.setXAxis(axis_address_1.AxisAddress.toProtobuf(source.xAxis));
+        pbData.setYAxis(axis_address_1.AxisAddress.toProtobuf(source.yAxis));
+        pbData.setIlluminator(source.illuminator);
+        pbData.setFilterChanger(source.filterChanger);
+        pbData.setObjectiveChanger(source.objectiveChanger);
+        return pbData;
+    }
+    MicroscopeConfig.toProtobuf = toProtobuf;
+})(MicroscopeConfig = exports.MicroscopeConfig || (exports.MicroscopeConfig = {}));
+//# sourceMappingURL=microscope_config.js.map

package/dist/lib/microscopy/microscope_config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"microscope_config.js","sourceRoot":"","sources":["../../../src/microscopy/microscope_config.ts"],"names":[],"mappings":";AAAA,sDAAsD;AACtD,sDAAsD;;;;;;;;;;;;;;;;;;;;;;;;;;AAEtD,oDAAsC;AACtC,kDAA8C;AAuC9C,IAAiB,gBAAgB,CAgChC;AAhCD,WAAiB,gBAAgB;IAClB,uBAAM,GAAG,kBAAkB,CAAC;IAEzC,gBAAgB;IAChB,SAAgB,YAAY,CAAC,MAAyC;QACpE,OAAO;YACL,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,0BAAW,CAAC,YAAY,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5F,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,0BAAW,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,0BAAW,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS;YAChF,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;SAC1C,CAAC;IACJ,CAAC;IATe,6BAAY,eAS3B,CAAA;IACD,gBAAgB;IAChB,SAAgB,UAAU,CAAC,MAA2C;QACpE,MAAM,MAAM,GAAG,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC9C,IAAI,MAAM,IAAI,IAAI,EAAE;YAClB,MAAM,CAAC,YAAY,CAAC,0BAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAClD,MAAM,CAAC,QAAQ,CAAC,0BAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,MAAM,CAAC,QAAQ,CAAC,0BAAW,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;YAC9C,OAAO,MAAM,CAAC;SACf;QAED,MAAM,CAAC,YAAY,CAAC,0BAAW,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9D,MAAM,CAAC,QAAQ,CAAC,0BAAW,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,QAAQ,CAAC,0BAAW,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACtD,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,WAAY,CAAC,CAAC;QAC3C,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,aAAc,CAAC,CAAC;QAC/C,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,gBAAiB,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC;IAChB,CAAC;IAhBe,2BAAU,aAgBzB,CAAA;AACH,CAAC,EAhCgB,gBAAgB,GAAhB,wBAAgB,KAAhB,wBAAgB,QAgChC","sourcesContent":["// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //\n// ============= DO NOT EDIT DIRECTLY ============= //\n\nimport * as gateway from '../gateway';\nimport { AxisAddress } from '../axis_address';\n\n/**\n * Configuration representing a microscope setup.\n * Device address of value 0 means that the part is not present.\n */\nexport interface MicroscopeConfig {\n  /**\n   * Focus axis of the microscope.\n   */\n  focusAxis?: AxisAddress;\n\n  /**\n   * X axis of the microscope.\n   */\n  xAxis?: AxisAddress;\n\n  /**\n   * Y axis of the microscope.\n   */\n  yAxis?: AxisAddress;\n\n  /**\n   * Illuminator device address.\n   */\n  illuminator?: number;\n\n  /**\n   * Filter changer device address.\n   */\n  filterChanger?: number;\n\n  /**\n   * Objective changer device address.\n   */\n  objectiveChanger?: number;\n\n}\n\nexport namespace MicroscopeConfig {\n  export const __type = 'MicroscopeConfig';\n\n  /** @internal */\n  export function fromProtobuf(pbData: gateway.MicroscopeConfig.AsObject): MicroscopeConfig {\n    return {\n      focusAxis: pbData.focusAxis != null ? AxisAddress.fromProtobuf(pbData.focusAxis) : undefined,\n      xAxis: pbData.xAxis != null ? AxisAddress.fromProtobuf(pbData.xAxis) : undefined,\n      yAxis: pbData.yAxis != null ? AxisAddress.fromProtobuf(pbData.yAxis) : undefined,\n      illuminator: pbData.illuminator,\n      filterChanger: pbData.filterChanger,\n      objectiveChanger: pbData.objectiveChanger,\n    };\n  }\n  /** @internal */\n  export function toProtobuf(source: MicroscopeConfig | null | undefined): gateway.MicroscopeConfig {\n    const pbData = new gateway.MicroscopeConfig();\n    if (source == null) {\n      pbData.setFocusAxis(AxisAddress.toProtobuf(null));\n      pbData.setXAxis(AxisAddress.toProtobuf(null));\n      pbData.setYAxis(AxisAddress.toProtobuf(null));\n      return pbData;\n    }\n\n    pbData.setFocusAxis(AxisAddress.toProtobuf(source.focusAxis));\n    pbData.setXAxis(AxisAddress.toProtobuf(source.xAxis));\n    pbData.setYAxis(AxisAddress.toProtobuf(source.yAxis));\n    pbData.setIlluminator(source.illuminator!);\n    pbData.setFilterChanger(source.filterChanger!);\n    pbData.setObjectiveChanger(source.objectiveChanger!);\n    return pbData;\n  }\n}\n"]}

package/dist/lib/microscopy/objective_changer.d.ts

@@ -1,4 +1,5 @@
 import { Connection } from '../ascii/connection';
+import { Device } from '../ascii/device';
 import { Axis } from '../ascii/axis';
 import { Measurement } from '../measurement';
 /**
@@ -7,27 +8,21 @@ import { Measurement } from '../measurement';
  * Requires at least Firmware 7.32.
  */
 export declare class ObjectiveChanger {
-    /**
-     * Connection of this device.
-     */
-    get connection(): Connection;
-    private _connection;
     /**
      * Device address of the turret.
      */
-    get turretAddress(): number;
-    private _turretAddress;
-    /**
-     * Device address of the focus.
-     */
-    get focusAddress(): number;
-    private _focusAddress;
+    get turret(): Device;
+    private _turret;
     /**
      * The focus axis.
      */
     get focusAxis(): Axis;
     private _focusAxis;
-    constructor(connection: Connection, turretAddress: number, focusAddress: number);
+    /**
+     * Creates instance of `ObjectiveChanger` based on the given device.
+     * If the device is identified, this constructor will ensure it is an objective changer.
+     */
+    constructor(turret: Device, focusAxis: Axis);
     /**
      * Finds an objective changer on a connection.
      * In case of conflict, specify the optional device addresses.
@@ -41,7 +36,7 @@ export declare class ObjectiveChanger {
     /**
      * Changes the objective.
      * Runs a sequence of movements switching from the current objective to the new one.
-     * @param objective Objective number starting from one.
+     * @param objective Objective number starting from 1.
      * @param options.focusOffset Optional focus offset from the datum.
      * If specified, the focus stage will move to the designated offset.
      */
@@ -56,6 +51,20 @@ export declare class ObjectiveChanger {
      * @returns Current objective number starting from 1 or 0 if not applicable.
      */
     getCurrentObjective(): Promise<number>;
+    /**
+     * Gets number of objectives that the turret can accommodate.
+     * @returns Number of positions.
+     */
+    getNumberOfObjectives(): Promise<number>;
+    /**
+     * Checks if this is a objective changer and throws an error if it is not.
+     */
+    private _verifyIsChanger;
+    /**
+     * Returns a string that represents the device.
+     * @returns A string that represents the device.
+     */
+    toString(): string;
 }
 declare namespace ObjectiveChanger {
     interface FindOptions {

package/dist/lib/microscopy/objective_changer.js

@@ -36,23 +36,11 @@ const measurement_1 = require("../measurement");
  * Requires at least Firmware 7.32.
  */
 class ObjectiveChanger {
-    /**
-     * Connection of this device.
-     */
-    get connection() {
-        return this._connection;
-    }
     /**
      * Device address of the turret.
      */
-    get turretAddress() {
-        return this._turretAddress;
-    }
-    /**
-     * Device address of the focus.
-     */
-    get focusAddress() {
-        return this._focusAddress;
+    get turret() {
+        return this._turret;
     }
     /**
      * The focus axis.
@@ -60,11 +48,14 @@ class ObjectiveChanger {
     get focusAxis() {
         return this._focusAxis;
     }
-    constructor(connection, turretAddress, focusAddress) {
-        this._connection = connection;
-        this._turretAddress = turretAddress;
-        this._focusAddress = focusAddress;
-        this._focusAxis = new axis_1.Axis(new device_1.Device(connection, focusAddress), 1);
+    /**
+     * Creates instance of `ObjectiveChanger` based on the given device.
+     * If the device is identified, this constructor will ensure it is an objective changer.
+     */
+    constructor(turret, focusAxis) {
+        this._turret = turret;
+        this._focusAxis = focusAxis;
+        this._verifyIsChanger();
     }
     /**
      * Finds an objective changer on a connection.
@@ -82,21 +73,22 @@ class ObjectiveChanger {
         request.setTurretAddress(turretAddress);
         request.setFocusAddress(focusAddress);
         const response = await gateway.callAsync('objective_changer/detect', request, gateway.ObjectiveChangerCreateResponse);
-        return new ObjectiveChanger(connection, response.getTurret(), response.getFocus());
+        return new ObjectiveChanger(new device_1.Device(connection, response.getTurret()), new axis_1.Axis(new device_1.Device(connection, response.getFocusAddress()), response.getFocusAxis()));
     }
     /**
      * Changes the objective.
      * Runs a sequence of movements switching from the current objective to the new one.
-     * @param objective Objective number starting from one.
+     * @param objective Objective number starting from 1.
      * @param options.focusOffset Optional focus offset from the datum.
      * If specified, the focus stage will move to the designated offset.
      */
     async change(objective, options = {}) {
         const { focusOffset, } = options;
         const request = new gateway.ObjectiveChangerChangeRequest();
-        request.setInterfaceId(this.connection.interfaceId);
-        request.setTurretAddress(this.turretAddress);
-        request.setFocusAddress(this.focusAddress);
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setTurretAddress(this.turret.deviceAddress);
+        request.setFocusAddress(this.focusAxis.device.deviceAddress);
+        request.setFocusAxis(this.focusAxis.axisNumber);
         request.setObjective(objective);
         request.setFocusOffset(measurement_1.Measurement.toProtobuf(focusOffset));
         await gateway.callAsync('objective_changer/change', request);
@@ -106,9 +98,10 @@ class ObjectiveChanger {
      */
     async release() {
         const request = new gateway.ObjectiveChangerRequest();
-        request.setInterfaceId(this.connection.interfaceId);
-        request.setTurretAddress(this.turretAddress);
-        request.setFocusAddress(this.focusAddress);
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setTurretAddress(this.turret.deviceAddress);
+        request.setFocusAddress(this.focusAxis.device.deviceAddress);
+        request.setFocusAxis(this.focusAxis.axisNumber);
         await gateway.callAsync('objective_changer/release', request);
     }
     /**
@@ -117,11 +110,45 @@ class ObjectiveChanger {
      * @returns Current objective number starting from 1 or 0 if not applicable.
      */
     async getCurrentObjective() {
+        const request = new gateway.AxisEmptyRequest();
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setDevice(this.turret.deviceAddress);
+        request.setAxis(1);
+        const response = await gateway.callAsync('device/get_index_position', request, gateway.IntResponse);
+        return response.getValue();
+    }
+    /**
+     * Gets number of objectives that the turret can accommodate.
+     * @returns Number of positions.
+     */
+    async getNumberOfObjectives() {
+        const request = new gateway.AxisEmptyRequest();
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setDevice(this.turret.deviceAddress);
+        request.setAxis(1);
+        const response = await gateway.callAsync('device/get_index_count', request, gateway.IntResponse);
+        return response.getValue();
+    }
+    /**
+     * Checks if this is a objective changer and throws an error if it is not.
+     */
+    _verifyIsChanger() {
         const request = new gateway.ObjectiveChangerRequest();
-        request.setInterfaceId(this.connection.interfaceId);
-        request.setTurretAddress(this.turretAddress);
-        request.setFocusAddress(this.focusAddress);
-        const response = await gateway.callAsync('objective_changer/get_current_objective', request, gateway.ObjectiveChangerGetCurrentResponse);
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setTurretAddress(this.turret.deviceAddress);
+        request.setFocusAddress(this.focusAxis.device.deviceAddress);
+        request.setFocusAxis(this.focusAxis.axisNumber);
+        gateway.callSync('objective_changer/verify', request);
+    }
+    /**
+     * Returns a string that represents the device.
+     * @returns A string that represents the device.
+     */
+    toString() {
+        const request = new gateway.AxisToStringRequest();
+        request.setInterfaceId(this.turret.connection.interfaceId);
+        request.setDevice(this.turret.deviceAddress);
+        const response = gateway.callSync('device/device_to_string', request, gateway.StringResponse);
         return response.getValue();
     }
 }

package/dist/lib/microscopy/objective_changer.js.map

@@ -1 +1 @@
-{"version":3,"file":"objective_changer.js","sourceRoot":"","sources":["../../../src/microscopy/objective_changer.ts"],"names":[],"mappings":"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","sourcesContent":["// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //\n// ============= DO NOT EDIT DIRECTLY ============= //\n\nimport * as gateway from '../gateway';\nimport { Connection } from '../ascii/connection';\nimport { Device } from '../ascii/device';\nimport { Axis } from '../ascii/axis';\nimport { Measurement } from '../measurement';\n\n/**\n * Represents an objective changer of a microscope.\n * Unstable. Expect breaking changes in future releases.\n * Requires at least Firmware 7.32.\n */\nexport class ObjectiveChanger {\n  /**\n   * Connection of this device.\n   */\n  public get connection(): Connection {\n    return this._connection;\n  }\n  private _connection: Connection;\n\n  /**\n   * Device address of the turret.\n   */\n  public get turretAddress(): number {\n    return this._turretAddress;\n  }\n  private _turretAddress: number;\n\n  /**\n   * Device address of the focus.\n   */\n  public get focusAddress(): number {\n    return this._focusAddress;\n  }\n  private _focusAddress: number;\n\n  /**\n   * The focus axis.\n   */\n  public get focusAxis(): Axis {\n    return this._focusAxis;\n  }\n  private _focusAxis: Axis;\n\n  constructor(connection: Connection, turretAddress: number, focusAddress: number) {\n    this._connection = connection;\n    this._turretAddress = turretAddress;\n    this._focusAddress = focusAddress;\n    this._focusAxis = new Axis(new Device(connection, focusAddress), 1);\n  }\n\n  /**\n   * Finds an objective changer on a connection.\n   * In case of conflict, specify the optional device addresses.\n   * Devices on the connection must be identified.\n   * @param connection Connection on which to detect the objective changer.\n   * @param [options.turretAddress=0] Optional device address of the turret device (X-MOR).\n   * @param [options.focusAddress=0] Optional device address of the focus device (X-LDA).\n   * @returns New instance of objective changer.\n   */\n  public static async find(\n    connection: Connection,\n    options: ObjectiveChanger.FindOptions = {}\n  ): Promise<ObjectiveChanger> {\n    const {\n      turretAddress = 0,\n      focusAddress = 0,\n    } = options;\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(connection.interfaceId);\n    request.setTurretAddress(turretAddress);\n    request.setFocusAddress(focusAddress);\n\n    const response = await gateway.callAsync<gateway.ObjectiveChangerCreateResponse>(\n      'objective_changer/detect',\n      request,\n      gateway.ObjectiveChangerCreateResponse);\n    return new ObjectiveChanger(connection, response.getTurret(), response.getFocus());\n  }\n\n  /**\n   * Changes the objective.\n   * Runs a sequence of movements switching from the current objective to the new one.\n   * @param objective Objective number starting from one.\n   * @param options.focusOffset Optional focus offset from the datum.\n   * If specified, the focus stage will move to the designated offset.\n   */\n  public async change(\n    objective: number,\n    options: ObjectiveChanger.ChangeOptions = {}\n  ): Promise<void> {\n    const {\n      focusOffset,\n    } = options;\n    const request = new gateway.ObjectiveChangerChangeRequest();\n    request.setInterfaceId(this.connection.interfaceId);\n    request.setTurretAddress(this.turretAddress);\n    request.setFocusAddress(this.focusAddress);\n    request.setObjective(objective);\n    request.setFocusOffset(Measurement.toProtobuf(focusOffset));\n\n    await gateway.callAsync('objective_changer/change', request);\n  }\n\n  /**\n   * Moves the focus stage out of the turret releasing the current objective.\n   */\n  public async release(): Promise<void> {\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(this.connection.interfaceId);\n    request.setTurretAddress(this.turretAddress);\n    request.setFocusAddress(this.focusAddress);\n\n    await gateway.callAsync('objective_changer/release', request);\n  }\n\n  /**\n   * Returns current objective number starting from 1.\n   * The value of 0 indicates that the position is either unknown or between two objectives.\n   * @returns Current objective number starting from 1 or 0 if not applicable.\n   */\n  public async getCurrentObjective(): Promise<number> {\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(this.connection.interfaceId);\n    request.setTurretAddress(this.turretAddress);\n    request.setFocusAddress(this.focusAddress);\n\n    const response = await gateway.callAsync<gateway.ObjectiveChangerGetCurrentResponse>(\n      'objective_changer/get_current_objective',\n      request,\n      gateway.ObjectiveChangerGetCurrentResponse);\n    return response.getValue();\n  }\n}\n\nnamespace ObjectiveChanger {\n  export interface FindOptions {\n      turretAddress?: number;\n      focusAddress?: number;\n  }\n  export interface ChangeOptions {\n      focusOffset?: Measurement;\n  }\n}\n"]}
+{"version":3,"file":"objective_changer.js","sourceRoot":"","sources":["../../../src/microscopy/objective_changer.ts"],"names":[],"mappings":"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","sourcesContent":["// ==== THIS FILE IS GENERATED FROM A TEMPLATE ==== //\n// ============= DO NOT EDIT DIRECTLY ============= //\n\nimport * as gateway from '../gateway';\nimport { Connection } from '../ascii/connection';\nimport { Device } from '../ascii/device';\nimport { Axis } from '../ascii/axis';\nimport { Measurement } from '../measurement';\n\n/**\n * Represents an objective changer of a microscope.\n * Unstable. Expect breaking changes in future releases.\n * Requires at least Firmware 7.32.\n */\nexport class ObjectiveChanger {\n  /**\n   * Device address of the turret.\n   */\n  public get turret(): Device {\n    return this._turret;\n  }\n  private _turret: Device;\n\n  /**\n   * The focus axis.\n   */\n  public get focusAxis(): Axis {\n    return this._focusAxis;\n  }\n  private _focusAxis: Axis;\n\n  /**\n   * Creates instance of `ObjectiveChanger` based on the given device.\n   * If the device is identified, this constructor will ensure it is an objective changer.\n   */\n  constructor(turret: Device, focusAxis: Axis) {\n    this._turret = turret;\n    this._focusAxis = focusAxis;\n    this._verifyIsChanger();\n  }\n\n  /**\n   * Finds an objective changer on a connection.\n   * In case of conflict, specify the optional device addresses.\n   * Devices on the connection must be identified.\n   * @param connection Connection on which to detect the objective changer.\n   * @param [options.turretAddress=0] Optional device address of the turret device (X-MOR).\n   * @param [options.focusAddress=0] Optional device address of the focus device (X-LDA).\n   * @returns New instance of objective changer.\n   */\n  public static async find(\n    connection: Connection,\n    options: ObjectiveChanger.FindOptions = {}\n  ): Promise<ObjectiveChanger> {\n    const {\n      turretAddress = 0,\n      focusAddress = 0,\n    } = options;\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(connection.interfaceId);\n    request.setTurretAddress(turretAddress);\n    request.setFocusAddress(focusAddress);\n\n    const response = await gateway.callAsync<gateway.ObjectiveChangerCreateResponse>(\n      'objective_changer/detect',\n      request,\n      gateway.ObjectiveChangerCreateResponse);\n    return new ObjectiveChanger(new Device(connection, response.getTurret()), new Axis(new Device(connection, response.getFocusAddress()), response.getFocusAxis()));\n  }\n\n  /**\n   * Changes the objective.\n   * Runs a sequence of movements switching from the current objective to the new one.\n   * @param objective Objective number starting from 1.\n   * @param options.focusOffset Optional focus offset from the datum.\n   * If specified, the focus stage will move to the designated offset.\n   */\n  public async change(\n    objective: number,\n    options: ObjectiveChanger.ChangeOptions = {}\n  ): Promise<void> {\n    const {\n      focusOffset,\n    } = options;\n    const request = new gateway.ObjectiveChangerChangeRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setTurretAddress(this.turret.deviceAddress);\n    request.setFocusAddress(this.focusAxis.device.deviceAddress);\n    request.setFocusAxis(this.focusAxis.axisNumber);\n    request.setObjective(objective);\n    request.setFocusOffset(Measurement.toProtobuf(focusOffset));\n\n    await gateway.callAsync('objective_changer/change', request);\n  }\n\n  /**\n   * Moves the focus stage out of the turret releasing the current objective.\n   */\n  public async release(): Promise<void> {\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setTurretAddress(this.turret.deviceAddress);\n    request.setFocusAddress(this.focusAxis.device.deviceAddress);\n    request.setFocusAxis(this.focusAxis.axisNumber);\n\n    await gateway.callAsync('objective_changer/release', request);\n  }\n\n  /**\n   * Returns current objective number starting from 1.\n   * The value of 0 indicates that the position is either unknown or between two objectives.\n   * @returns Current objective number starting from 1 or 0 if not applicable.\n   */\n  public async getCurrentObjective(): Promise<number> {\n    const request = new gateway.AxisEmptyRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setDevice(this.turret.deviceAddress);\n    request.setAxis(1);\n\n    const response = await gateway.callAsync<gateway.IntResponse>(\n      'device/get_index_position',\n      request,\n      gateway.IntResponse);\n    return response.getValue();\n  }\n\n  /**\n   * Gets number of objectives that the turret can accommodate.\n   * @returns Number of positions.\n   */\n  public async getNumberOfObjectives(): Promise<number> {\n    const request = new gateway.AxisEmptyRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setDevice(this.turret.deviceAddress);\n    request.setAxis(1);\n\n    const response = await gateway.callAsync<gateway.IntResponse>(\n      'device/get_index_count',\n      request,\n      gateway.IntResponse);\n    return response.getValue();\n  }\n\n  /**\n   * Checks if this is a objective changer and throws an error if it is not.\n   */\n  private _verifyIsChanger(): void {\n    const request = new gateway.ObjectiveChangerRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setTurretAddress(this.turret.deviceAddress);\n    request.setFocusAddress(this.focusAxis.device.deviceAddress);\n    request.setFocusAxis(this.focusAxis.axisNumber);\n\n    gateway.callSync('objective_changer/verify', request);\n  }\n\n  /**\n   * Returns a string that represents the device.\n   * @returns A string that represents the device.\n   */\n  public toString(): string {\n    const request = new gateway.AxisToStringRequest();\n    request.setInterfaceId(this.turret.connection.interfaceId);\n    request.setDevice(this.turret.deviceAddress);\n\n    const response = gateway.callSync<gateway.StringResponse>(\n      'device/device_to_string',\n      request,\n      gateway.StringResponse);\n    return response.getValue();\n  }\n}\n\nnamespace ObjectiveChanger {\n  export interface FindOptions {\n      turretAddress?: number;\n      focusAddress?: number;\n  }\n  export interface ChangeOptions {\n      focusOffset?: Measurement;\n  }\n}\n"]}

package/dist/lib/microscopy_ns.d.ts

@@ -2,4 +2,12 @@ import * as microscopyImport from './microscopy';
 export declare namespace microscopy {
     const ObjectiveChanger: typeof microscopyImport.ObjectiveChanger;
     type ObjectiveChanger = microscopyImport.ObjectiveChanger;
+    const Illuminator: typeof microscopyImport.Illuminator;
+    type Illuminator = microscopyImport.Illuminator;
+    const Microscope: typeof microscopyImport.Microscope;
+    type Microscope = microscopyImport.Microscope;
+    const MicroscopeConfig: typeof microscopyImport.MicroscopeConfig;
+    type MicroscopeConfig = microscopyImport.MicroscopeConfig;
+    const FilterChanger: typeof microscopyImport.FilterChanger;
+    type FilterChanger = microscopyImport.FilterChanger;
 }

package/dist/lib/microscopy_ns.js

@@ -28,5 +28,9 @@ const microscopyImport = __importStar(require("./microscopy"));
 var microscopy;
 (function (microscopy) {
     microscopy.ObjectiveChanger = microscopyImport.ObjectiveChanger;
+    microscopy.Illuminator = microscopyImport.Illuminator;
+    microscopy.Microscope = microscopyImport.Microscope;
+    microscopy.MicroscopeConfig = microscopyImport.MicroscopeConfig;
+    microscopy.FilterChanger = microscopyImport.FilterChanger;
 })(microscopy = exports.microscopy || (exports.microscopy = {}));
 //# sourceMappingURL=microscopy_ns.js.map

package/dist/lib/microscopy_ns.js.map

@@ -1 +1 @@
-{"version":3,"file":"microscopy_ns.js","sourceRoot":"","sources":["../../src/microscopy_ns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+DAAiD;AAEjD,IAAiB,UAAU,CAG1B;AAHD,WAAiB,UAAU;IACZ,2BAAgB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;AAEpE,CAAC,EAHgB,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAG1B","sourcesContent":["import * as microscopyImport from './microscopy';\n\nexport namespace microscopy {\n  export const ObjectiveChanger = microscopyImport.ObjectiveChanger;\n  export type ObjectiveChanger = microscopyImport.ObjectiveChanger;\n}\n"]}
+{"version":3,"file":"microscopy_ns.js","sourceRoot":"","sources":["../../src/microscopy_ns.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,+DAAiD;AAEjD,IAAiB,UAAU,CAW1B;AAXD,WAAiB,UAAU;IACZ,2BAAgB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;IAErD,sBAAW,GAAG,gBAAgB,CAAC,WAAW,CAAC;IAE3C,qBAAU,GAAG,gBAAgB,CAAC,UAAU,CAAC;IAEzC,2BAAgB,GAAG,gBAAgB,CAAC,gBAAgB,CAAC;IAErD,wBAAa,GAAG,gBAAgB,CAAC,aAAa,CAAC;AAE9D,CAAC,EAXgB,UAAU,GAAV,kBAAU,KAAV,kBAAU,QAW1B","sourcesContent":["import * as microscopyImport from './microscopy';\n\nexport namespace microscopy {\n  export const ObjectiveChanger = microscopyImport.ObjectiveChanger;\n  export type ObjectiveChanger = microscopyImport.ObjectiveChanger;\n  export const Illuminator = microscopyImport.Illuminator;\n  export type Illuminator = microscopyImport.Illuminator;\n  export const Microscope = microscopyImport.Microscope;\n  export type Microscope = microscopyImport.Microscope;\n  export const MicroscopeConfig = microscopyImport.MicroscopeConfig;\n  export type MicroscopeConfig = microscopyImport.MicroscopeConfig;\n  export const FilterChanger = microscopyImport.FilterChanger;\n  export type FilterChanger = microscopyImport.FilterChanger;\n}\n"]}

package/dist/lib/product/process.d.ts

@@ -136,6 +136,11 @@ export declare class Process {
      * @returns An explanation of why this state cannot be set to this process.
      */
     canSetState(state: string): Promise<string>;
+    /**
+     * Returns a string that represents the process.
+     * @returns A string that represents the process.
+     */
+    toString(): string;
 }
 declare namespace Process {
     interface GenericCommandOptions {

package/dist/lib/product/process.js

@@ -306,6 +306,19 @@ class Process {
         const response = await gateway.callAsync('device/can_set_axis_state', request, gateway.CanSetStateAxisResponse);
         return response.getError();
     }
+    /**
+     * Returns a string that represents the process.
+     * @returns A string that represents the process.
+     */
+    toString() {
+        const request = new gateway.AxisToStringRequest();
+        request.setInterfaceId(this.controller.device.connection.interfaceId);
+        request.setDevice(this.controller.device.deviceAddress);
+        request.setAxis(this.processNumber);
+        request.setTypeOverride('Process');
+        const response = gateway.callSync('device/axis_to_string', request, gateway.StringResponse);
+        return response.getValue();
+    }
 }
 exports.Process = Process;
 //# sourceMappingURL=process.js.map