ITelescope |
Defines the ITelescope Interface
Namespace: ASCOM.DeviceInterface
Assembly: ASCOM.DeviceInterfaces (in ASCOM.DeviceInterfaces.dll) Version: 7.0.0-rc.0+0
SyntaxThe ITelescopeV4 type exposes the following members.
Properties| Name | Description | |
|---|---|---|
 | AlignmentMode | The alignment mode of the mount (Alt/Az, Polar, German Polar). |
| Altitude | The Altitude above the local horizon of the telescope's current position (degrees, positive up) |
| ApertureArea | The area of the telescope's aperture, taking into account any obstructions (square meters) |
| ApertureDiameter | The telescope's effective aperture diameter (meters) |
| AtHome | True if the telescope is stopped in the Home position. Set only following a FindHome operation, and reset with any slew operation. This property must be False if the telescope does not support homing. |
| AtPark | True if the telescope has been put into the parked state by the Park method. Set False by calling the Unpark() method. |
| Azimuth | The azimuth at the local horizon of the telescope's current position (degrees, North-referenced, positive East/clockwise). |
| CanFindHome | True if this telescope is capable of programmed finding its home position (FindHome method). |
| CanPark | True if this telescope is capable of programmed parking (Parkmethod) |
| CanPulseGuide | True if this telescope is capable of software-pulsed guiding (via the PulseGuide(GuideDirections, Int32) method) |
| CanSetDeclinationRate | True if the DeclinationRate property can be changed to provide offset tracking in the declination axis. |
| CanSetGuideRates | True if the guide rate properties used for PulseGuide(GuideDirections, Int32) can be adjusted. |
| CanSetPark | True if this telescope is capable of programmed setting of its park position (SetPark method) |
| CanSetPierSide | True if the SideOfPier property can be set, meaning that the mount can be forced to flip. |
| CanSetRightAscensionRate | True if the RightAscensionRate property can be changed to provide offset tracking in the right ascension axis. |
| CanSetTracking | True if the Tracking property can be changed, turning telescope sidereal tracking on and off. |
| CanSlew | True if this telescope is capable of programmed slewing (synchronous or asynchronous) to equatorial coordinates |
| CanSlewAltAz | True if this telescope is capable of programmed slewing (synchronous or asynchronous) to local horizontal coordinates |
| CanSlewAltAzAsync | True if this telescope is capable of programmed asynchronous slewing to local horizontal coordinates |
| CanSlewAsync | True if this telescope is capable of programmed asynchronous slewing to equatorial coordinates. |
| CanSync | True if this telescope is capable of programmed syncing to equatorial coordinates. |
| CanSyncAltAz | True if this telescope is capable of programmed syncing to local horizontal coordinates |
| CanUnpark | True if this telescope is capable of programmed unparking (Unpark method). |
| Connected | Set True to connect to the device hardware. Set False to disconnect from the device hardware. You can also read the property to check whether it is connected. This reports the current hardware state. |
| Connecting | Returns True while the device is undertaking an asynchronous connect or disconnect operation. |
| Declination | The declination (degrees) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property. Reading the property will raise an error if the value is unavailable. |
| DeclinationRate | The declination tracking rate (arcseconds per SI second, default = 0.0) |
| Description | Returns a description of the device, such as manufacturer and model number. Any ASCII characters may be used. |
| DeviceState | Returns the device's operational state in a single call. |
| DoesRefraction | True if the telescope or driver applies atmospheric refraction to coordinates. |
| DriverInfo | Descriptive and version information about this ASCOM driver. |
| DriverVersion | A string containing only the major and minor version of the driver. |
| EquatorialSystem | Equatorial coordinate system used by this telescope (e.g. Topocentric or J2000). |
| FocalLength | The telescope's focal length, meters |
| GuideRateDeclination | The current Declination movement rate offset for telescope guiding (degrees/sec) |
| GuideRateRightAscension | The current Right Ascension movement rate offset for telescope guiding (degrees/sec) |
| InterfaceVersion | The interface version number that this device supports. Should return 4 for this interface version. |
| IsPulseGuiding | True if a PulseGuide(GuideDirections, Int32) command is in progress, False otherwise |
| Name | The short name of the driver, for display purposes |
| RightAscension | The right ascension (hours) of the telescope's current equatorial coordinates, in the coordinate system given by the EquatorialSystem property |
| RightAscensionRate | The right ascension tracking rate offset from sidereal (seconds per sidereal second, default = 0.0) |
| SideOfPier | Indicates the pointing state of the mount. |
| SiderealTime | The local apparent sidereal time from the telescope's internal clock (hours, sidereal) |
| SiteElevation | The elevation above mean sea level (meters) of the site at which the telescope is located |
| SiteLatitude | The geodetic(map) latitude (degrees, positive North, WGS84) of the site at which the telescope is located. |
| SiteLongitude | The longitude (degrees, positive East, WGS84) of the site at which the telescope is located. |
| Slewing | True if telescope is in the process of moving in response to one of the Slew methods or the MoveAxis(TelescopeAxes, Double) method, False at all other times. |
| SlewSettleTime | Specifies a post-slew settling time (sec.). |
| SupportedActions | Returns the list of custom action names supported by this driver. |
| TargetDeclination | The declination (degrees, positive North) for the target of an equatorial slew or sync operation |
| TargetRightAscension | The right ascension (hours) for the target of an equatorial slew or sync operation |
| Tracking | The state of the telescope's sidereal tracking drive. |
| TrackingRate | The current tracking rate of the telescope's sidereal drive |
| TrackingRates | Returns a collection of supported DriveRates values that describe the permissible values of the TrackingRate property for this telescope type. |
| UTCDate | The UTC date/time of the telescope's internal clock |
Methods| Name | Description | |
|---|---|---|
 | AbortSlew | Stops a slew in progress. |
| Action | Invokes the specified device-specific custom action. |
| AxisRates | Determine the rates at which the telescope may be moved about the specified axis by the MoveAxis(TelescopeAxes, Double) method. |
| CanMoveAxis | True if this telescope can move the requested axis |
| CommandBlind | Transmits an arbitrary string to the device and does not wait for a response. Optionally, protocol framing characters may be added to the string before transmission. |
| CommandBool | Transmits an arbitrary string to the device and waits for a boolean response. Optionally, protocol framing characters may be added to the string before transmission. |
| CommandString | Transmits an arbitrary string to the device and waits for a string response. Optionally, protocol framing characters may be added to the string before transmission. |
| Connect | Connect to the device asynchronously |
| DestinationSideOfPier | Predict side of pier for German equatorial mounts |
| Disconnect | Disconnect from the device asynchronously |
| Dispose | This method is a "clean-up" method that is primarily of use to drivers that are written in languages such as C# and VB.NET where resource clean-up is initially managed by the language's runtime garbage collection mechanic. Driver authors should take care to ensure that a client or runtime calling Dispose() does not adversely affect other connected clients. Applications should not call this method. |
| FindHome | Locates the telescope's "home" position |
| MoveAxis | Move the telescope in one axis at the given rate. |
| Park | Move the telescope to its park position, stop all motion (or restrict to a small safe range), and set AtPark to True. |
| PulseGuide | Moves the scope in the given direction for the given interval or time at the rate given by the corresponding guide rate property |
| SetPark | Sets the telescope's park position to be its current position. |
| SetupDialog | Launches a configuration dialog box for the driver. The call will not return until the user clicks OK or cancel manually. |
| SlewToAltAz | Move the telescope to the given local horizontal coordinates, return when slew is complete |
| SlewToAltAzAsync | This Method must be implemented if CanSlewAltAzAsync returns True. |
| SlewToCoordinates | Move the telescope to the given equatorial coordinates, return when slew is complete |
| SlewToCoordinatesAsync | Move the telescope to the given equatorial coordinates, return immediately after starting the slew. |
| SlewToTarget | Move the telescope to the TargetRightAscension and TargetDeclination coordinates, return when slew complete. |
| SlewToTargetAsync | Move the telescope to the TargetRightAscension and TargetDeclination coordinates, returns immediately after starting the slew. |
| SyncToAltAz | Matches the scope's local horizontal coordinates to the given local horizontal coordinates. |
| SyncToCoordinates | Matches the scope's equatorial coordinates to the given equatorial coordinates. |
| SyncToTarget | Matches the scope's equatorial coordinates to the target equatorial coordinates. |
| Unpark | Takes telescope out of the Parked state. |
See Also