IWorkspace interface

The IWorkspace interface represents the Work-Space manager in the Altium Designer which deals with project and documents and their related attributes and options. This interface object is the starting point and upon querying this object, it can return currently open projects, number of projects, installed libraries, and create a new document for example.

public interface IWorkspace : IDMObject

Namespace: EDP · Assembly: Altium.SDK.Interfaces

Inherits: IDMObject

Remarks

Remember the projects need to be compiled first, before you can invoke the GetWorkSpace method to obtain the IWorkSpace interface and its descendant interfaces which represent actual objects in Altium Designer.

It is highly recommended not to hold an interface of the Workspace manager, but re-query the work-space manager every-time the access to the information within is required.

Methods

Method	Returns	Description
DM_AddDocumentToActiveProject	void	This method adds an existing document with its valid full path into an active project within Altium Designer.
DM_AddOutputLine	void	Outputs the line to the output's dialog.
DM_ChangeManager	IChangeManager	Returns the Engineering Change Order Manager interface object which compares with two projects and creates an ECO to perform a pin swapping process to synchronize the specified two projects.
DM_ClearOutputLines	void	Clears out the Output Memo.
DM_CloseProject	void
DM_CreateHarnessDefinitionList_DeviceSheets	IHarnessDefinitionList
DM_CreateNewDocument	string	This method creates a new document based on the Document Kind.
DM_DestroyHarnessDefinitionList	void
DM_DisplayNavigationHint	void
DM_FileOwnership_BulkWarnEnd	void
DM_FileOwnership_BulkWarnRegister	bool
DM_FileOwnership_BulkWarnStart	void
DM_FocusedDocument	IDocument	Returns the focussed document interface object (if any) in Altium Designer.
DM_FocusedProject	IProject	Returns the focussed project (if any) in Altium Designer.
DM_FreeDocumentsProject	IProject	Returns the IProject interface that contains free documents.
DM_GenerateUniqueID	string	Invoke this method, and a generated Unique ID will be returned which can be used for any newly created or existing object in Altium Designer.
DM_GetDefaultPcbType	string
DM_GetDifferenceTypeDescription	string
DM_GetDocumentFromPath	IDocument	Retrieves the IDocument interface object by passing the full document path to this document.
DM_GetOutputCharCount	int
DM_GetOutputJobDocumentByPath	IWSM_OutputJobDocument
DM_GetOutputLine	string
DM_GetOutputLineCount	int	Returns the number of output lines in the Output dialog.
DM_GetProjectDialogsFactory	IProjectDialogsFactory
DM_GetProjectFromPath	IProject	Retrieves the IProject interface object by passing the full project path to this project.
DM_GetRecoveryInterval	int	Returns the number of minutes as the interval when the recovery mechanism kicks in.
DM_GetRecoveryIsEnabled	bool	Returns a Boolean value whether the recovery mechanism is active or not.
DM_GetReleaseManager	IReleaseManager
DM_GetVaultReleaseManager	IVaultConfigurationReleaseManager
DM_HideProject	void
DM_ImageIndexForDocumentKind	int	Returns the image index depending on the document kind for example PCB, CAM etc.
DM_InstalledLibraries	IDocument	Returns an indexed library (currently installed in Altium Designer only), to be used in conjunction with the DM_InstalledLibraryCount.
DM_InstalledLibraryCount	int	Returns the number of installed libraries in Altium Designer.
DM_IsReferencedAsDeviceSheet	bool
DM_LoadProjectHidden	IProject
DM_LocalHistoryManager	ILocalHistoryManager
DM_MessagesManager	IDXPMessagesManager	This method returns you the interface to the Messages panel in Altium Designer.
DM_Navigation_OpenHostDocuments	void
DM_NavigationZoomPrecision	int
DM_NotifyObjectNavigated	void
DM_NotifyObjectsNavigated	void
DM_OpenProject	IProject	Opens a project with the full project path and set this project in focus depending on its Show parameter.
DM_OptionsStorage	IOptionsStorage	Represents a options storage container where Altium Designer can use to retrieve and store options for storing parameters of EDE options such as Toolchain name, folder and default options and project…
DM_PCBReleaseViewDocument	IReleaseViewDocument
DM_Preferences	IWorkspacePreferences
DM_ProjectCount	int	Returns the number of projects open in Altium Designer.
DM_Projects	IProject	Returns the indexed project (currently loaded in Altium Designer only), to be used in conjunction with the DM_ProjectCount interface.
DM_PromptForDefaultPcbType	bool
DM_RegisterDependentDocuments	void
DM_RunOpenDocumentDialog	bool
DM_SetNavigationZoomPrecision	void
DM_SetRecoveryParameters	void	Set the interval when the autosave / recovery mechanism in Altium Designer kicks in.
DM_SetRightClickCompStructure	void
DM_ShowMessageView	void	Invoke this method to refresh the Message panel.
DM_ShowProject	void
DM_ShowToDoList	void	This method displays the To Do List manager panel.
DM_ViolationTypeDescription	string	Returns the violation type description string with the error kind value passed in.
DM_ViolationTypeGroup	TErrorGroup	Returns the error group for which this error kind parameter belongs to.
DM_WorkspaceFileName	string	Returns the filename only of the workspace.
DM_WorkspaceFullPath	string	Returns the full path of the workspace.

DM_AddDocumentToActiveProject

This method adds an existing document with its valid full path into an active project within Altium Designer.

void DM_AddDocumentToActiveProject(string argDocumentPath);

Parameter	Type	Passing
argDocumentPath	string	value

Returns: nothing (void)

DM_AddOutputLine

Outputs the line to the output's dialog. An Internal operation.

void DM_AddOutputLine(string argMessageLine, bool argReplaceLastLine, bool argUpdateLastLine);

Parameter	Type	Passing
argMessageLine	string	value
argReplaceLastLine	bool	value
argUpdateLastLine	bool	value

Returns: nothing (void)

DM_ChangeManager

Returns the Engineering Change Order Manager interface object which compares with two projects and creates an ECO to perform a pin swapping process to synchronize the specified two projects.

IChangeManager DM_ChangeManager();

Returns: IChangeManager

Extension method of IWorkspaceHelper (using EDP;).

DM_ClearOutputLines

Clears out the Output Memo. An Internal operation.

void DM_ClearOutputLines();

Returns: nothing (void)

DM_CloseProject

No description yet.

void DM_CloseProject(string argProjectPath);

Parameter	Type	Passing
argProjectPath	string	value

Returns: nothing (void)

DM_CreateHarnessDefinitionList_DeviceSheets

No description yet.

IHarnessDefinitionList DM_CreateHarnessDefinitionList_DeviceSheets(string argFolderPath, bool argRecursive);

Parameter	Type	Passing
argFolderPath	string	value
argRecursive	bool	value

Returns: IHarnessDefinitionList

Extension method of IWorkspaceHelper (using EDP;).

DM_CreateNewDocument

This method creates a new document based on the Document Kind. The Kinds include - 'PCBLIB','PCB','SCH','SCHLIB' and so on depending on which document servers are installed in Altium Designer.

string DM_CreateNewDocument(string argDocKind);

Parameter	Type	Passing
argDocKind	string	value

Returns: string

Example: Create a new PCB document.

using DXP;
using EDP;

var workspace = DXP.GlobalVars.Client.GetDXPWorkspace() as IWorkspace;
if (workspace == null)
    return;
workspace.DM_CreateNewDocument("PCB");

Examples: Extension_CreateProject

DM_DestroyHarnessDefinitionList

No description yet.

void DM_DestroyHarnessDefinitionList(IHarnessDefinitionList argHarnessDefinitionList);
void DM_DestroyHarnessDefinitionList(object argHarnessDefinitionList);

Parameter	Type	Passing
argHarnessDefinitionList	IHarnessDefinitionList	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_DisplayNavigationHint

No description yet.

void DM_DisplayNavigationHint(UIntPtr argViewHandle, int argX, int argY, IDMObject argDMObject, UIntPtr argViewNavigatedHandle);
void DM_DisplayNavigationHint(object argViewHandle, int argX, int argY, object argDMObject, object argViewNavigatedHandle);

Parameter	Type	Passing
argViewHandle	UIntPtr	value
argX	int	value
argY	int	value
argDMObject	IDMObject	value
argViewNavigatedHandle	UIntPtr	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_FileOwnership_BulkWarnEnd

No description yet.

void DM_FileOwnership_BulkWarnEnd(TFileOwnershipWarningLevel argWarningLevel);
void DM_FileOwnership_BulkWarnEnd(int argWarningLevel);

Parameter	Type	Passing
argWarningLevel	TFileOwnershipWarningLevel	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_FileOwnership_BulkWarnRegister

No description yet.

bool DM_FileOwnership_BulkWarnRegister(string argFileName);

Parameter	Type	Passing
argFileName	string	value

Returns: bool

DM_FileOwnership_BulkWarnStart

No description yet.

void DM_FileOwnership_BulkWarnStart();

Returns: nothing (void)

DM_FocusedDocument

Returns the focussed document interface object (if any) in Altium Designer. A focussed document is a document that is currently open and in focus (this document is active).

IDocument DM_FocusedDocument();

Returns: IDocument

Extension method of IWorkspaceHelper (using EDP;).

Examples: Extension_TestPortHarnessDev

DM_FocusedProject

Returns the focussed project (if any) in Altium Designer.

IProject DM_FocusedProject();

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

Examples: Ciiva, Extension_AddVariant, Extension_CreateProject, Extension_CreateVariantComponent, Extension_GenerateGerber, Extension_HierarchicalDesign, Extension_RefreshDocument, Extension_TestPortHarnessDev

DM_FreeDocumentsProject

Returns the IProject interface that contains free documents. A free document is a standalone document that lives in the Free Documents project.

IProject DM_FreeDocumentsProject();

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

DM_GenerateUniqueID

Invoke this method, and a generated Unique ID will be returned which can be used for any newly created or existing object in Altium Designer. Objects in Schematic have their own Unique IDs which are tracked by the synchronizator so that the objects on the PCB document are sychronized to their equivalents in a corresponding schematic project.

string DM_GenerateUniqueID();

Returns: string

Example - an incomplete example that assigns new UIDs to Schematic components

Example: Give every component on the current schematic sheet a new unique ID.

using DXP;
using EDP;
using SCH;

// The workspace manager generates the unique IDs.
var workspace = DXP.GlobalVars.Client.GetDXPWorkspace() as IWorkspace;
if (workspace == null)
    return;
ISch_Document currentSheet = SCH.GlobalVars.SchServer?.GetCurrentSchDocument();
if (currentSheet == null)
    return;

// Set up an iterator to look for components on the sheet.
ISch_Iterator iterator = currentSheet.SchIterator_Create();
iterator.AddFilter_ObjectSet(new SCH.TObjectSet { SCH.TObjectId.eSchComponent });
try
{
    for (var component = iterator.FirstSchObject() as ISch_Component; component != null; component = iterator.NextSchObject() as ISch_Component)
        component.SetState_UniqueId(workspace.DM_GenerateUniqueID());
}
finally
{
    currentSheet.SchIterator_Destroy(ref iterator);
}

DM_GetDefaultPcbType

No description yet.

string DM_GetDefaultPcbType();

Returns: string

DM_GetDifferenceTypeDescription

No description yet.

string DM_GetDifferenceTypeDescription(TDifferenceKind argDifferenceKind);
string DM_GetDifferenceTypeDescription(int argDifferenceKind);

Parameter	Type	Passing
argDifferenceKind	TDifferenceKind	value

Returns: string

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_GetDocumentFromPath

Retrieves the IDocument interface object by passing the full document path to this document. With this IDocument interface, you have access to its functionality, such as compiling the document itself.

IDocument DM_GetDocumentFromPath(string argDocumentPath);

Parameter	Type	Passing
argDocumentPath	string	value

Returns: IDocument

Extension method of IWorkspaceHelper (using EDP;).

Examples: Ciiva

DM_GetOutputCharCount

No description yet.

int DM_GetOutputCharCount();

Returns: int

DM_GetOutputJobDocumentByPath

No description yet.

IWSM_OutputJobDocument DM_GetOutputJobDocumentByPath(string argPath);

Parameter	Type	Passing
argPath	string	value

Returns: IWSM_OutputJobDocument

Extension method of IWorkspaceHelper (using EDP;).

DM_GetOutputLine

No description yet.

string DM_GetOutputLine(int argIndex);

Parameter	Type	Passing
argIndex	int	value

Returns: string

DM_GetOutputLineCount

Returns the number of output lines in the Output dialog. An Internal operation.

int DM_GetOutputLineCount();

Returns: int

DM_GetProjectDialogsFactory

No description yet.

IProjectDialogsFactory DM_GetProjectDialogsFactory();

Returns: IProjectDialogsFactory

Extension method of IWorkspaceHelper (using EDP;).

DM_GetProjectFromPath

Retrieves the IProject interface object by passing the full project path to this project. With this IProject interface, you have access to its interface methods. A project is a container that has links to associated design documents in an organized manner.

IProject DM_GetProjectFromPath(string argProjectPath);

Parameter	Type	Passing
argProjectPath	string	value

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

Examples: Ciiva

DM_GetRecoveryInterval

Returns the number of minutes as the interval when the recovery mechanism kicks in.

int DM_GetRecoveryInterval();

Returns: int

DM_GetRecoveryIsEnabled

Returns a Boolean value whether the recovery mechanism is active or not.

bool DM_GetRecoveryIsEnabled();

Returns: bool

DM_GetReleaseManager

No description yet.

IReleaseManager DM_GetReleaseManager();

Returns: IReleaseManager

Extension method of IWorkspaceHelper (using EDP;).

DM_GetVaultReleaseManager

No description yet.

IVaultConfigurationReleaseManager DM_GetVaultReleaseManager(IProject argProject, IVaultConfiguration argConfiguration);

Parameter	Type	Passing
argProject	IProject	value
argConfiguration	IVaultConfiguration	value

Returns: IVaultConfigurationReleaseManager

Extension method of IWorkspaceHelper (using EDP;).

DM_HideProject

No description yet.

void DM_HideProject(string argProjectPath);

Parameter	Type	Passing
argProjectPath	string	value

Returns: nothing (void)

DM_ImageIndexForDocumentKind

Returns the image index depending on the document kind for example PCB, CAM etc.

int DM_ImageIndexForDocumentKind(string argDocumentKind);

Parameter	Type	Passing
argDocumentKind	string	value

Returns: int

DM_InstalledLibraries

Returns an indexed library (currently installed in Altium Designer only), to be used in conjunction with the DM_InstalledLibraryCount.

IDocument DM_InstalledLibraries(int argIndex);

Parameter	Type	Passing
argIndex	int	value

Returns: IDocument

Extension method of IWorkspaceHelper (using EDP;).

See also: IWorkspace.DM_InstalledLibraryCount

DM_InstalledLibraryCount

Returns the number of installed libraries in Altium Designer.

int DM_InstalledLibraryCount();

Returns: int

DM_IsReferencedAsDeviceSheet

No description yet.

bool DM_IsReferencedAsDeviceSheet(string argFilePath);

Parameter	Type	Passing
argFilePath	string	value

Returns: bool

DM_LoadProjectHidden

No description yet.

IProject DM_LoadProjectHidden(string argProjectPath);

Parameter	Type	Passing
argProjectPath	string	value

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

DM_LocalHistoryManager

No description yet.

ILocalHistoryManager DM_LocalHistoryManager();

Returns: ILocalHistoryManager

Extension method of IWorkspaceHelper (using EDP;).

DM_MessagesManager

This method returns you the interface to the Messages panel in Altium Designer.

IDXPMessagesManager DM_MessagesManager();

Returns: IDXPMessagesManager

Extension method of IWorkspaceHelper (using EDP;).

DM_Navigation_OpenHostDocuments

No description yet.

void DM_Navigation_OpenHostDocuments(IProject argProject, IInterfaceList argObjectsList, TDocumentOpenMode argDocumentOpenMode);
void DM_Navigation_OpenHostDocuments(object argProject, object argObjectsList, int argDocumentOpenMode);

Parameter	Type	Passing
argProject	IProject	value
argObjectsList	IInterfaceList	value
argDocumentOpenMode	TDocumentOpenMode	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_NavigationZoomPrecision

No description yet.

int DM_NavigationZoomPrecision();

Returns: int

DM_NotifyObjectNavigated

No description yet.

void DM_NotifyObjectNavigated(int argCode, IDMObject argDMObject, TNavigationActionSet argNavigationActionSet);
void DM_NotifyObjectNavigated(int argCode, object argDMObject, ITransportSet argNavigationActionSet);

Parameter	Type	Passing
argCode	int	value
argDMObject	IDMObject	value
argNavigationActionSet	TNavigationActionSet	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_NotifyObjectsNavigated

No description yet.

void DM_NotifyObjectsNavigated(int argCode, IDMObject argSourceDMObject, TNavigationActionSet argNavigationActionSet, IInterfaceList argDMObjects);
void DM_NotifyObjectsNavigated(int argCode, object argSourceDMObject, ITransportSet argNavigationActionSet, object argDMObjects);

Parameter	Type	Passing
argCode	int	value
argSourceDMObject	IDMObject	value
argNavigationActionSet	TNavigationActionSet	value
argDMObjects	IInterfaceList	value

Returns: nothing (void)

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_OpenProject

Opens a project with the full project path and set this project in focus depending on its Show parameter.

IProject DM_OpenProject(string argProjectPath, bool argShow);

Parameter	Type	Passing
argProjectPath	string	value
argShow	bool	value

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

DM_OptionsStorage

Represents a options storage container where Altium Designer can use to retrieve and store options for storing parameters of EDE options such as Toolchain name, folder and default options and project options.

IOptionsStorage DM_OptionsStorage();

Returns: IOptionsStorage

Extension method of IWorkspaceHelper (using EDP;).

DM_PCBReleaseViewDocument

No description yet.

IReleaseViewDocument DM_PCBReleaseViewDocument();

Returns: IReleaseViewDocument

Extension method of IWorkspaceHelper (using EDP;).

DM_Preferences

No description yet.

IWorkspacePreferences DM_Preferences();

Returns: IWorkspacePreferences

Extension method of IWorkspaceHelper (using EDP;).

See also: IWorkspacePreferences

Examples: Extension_VariantOptions

DM_ProjectCount

Returns the number of projects open in Altium Designer.

int DM_ProjectCount();

Returns: int

DM_Projects

Returns the indexed project (currently loaded in Altium Designer only), to be used in conjunction with the DM_ProjectCount interface.

IProject DM_Projects(int argIndex);

Parameter	Type	Passing
argIndex	int	value

Returns: IProject

Extension method of IWorkspaceHelper (using EDP;).

DM_PromptForDefaultPcbType

No description yet.

bool DM_PromptForDefaultPcbType(ref string argPcbType);

Parameter	Type	Passing
argPcbType	string	ref

Returns: bool

DM_RegisterDependentDocuments

No description yet.

void DM_RegisterDependentDocuments(string argSourceDocKind, string argDependentExtension);

Parameter	Type	Passing
argSourceDocKind	string	value
argDependentExtension	string	value

Returns: nothing (void)

DM_RunOpenDocumentDialog

No description yet.

bool DM_RunOpenDocumentDialog(string argCaption, bool argllowMultiSelect, ref string argPath, TFilterKind argFilterKind, int argFilterIndex, out IStrings argDocumentPaths);
bool DM_RunOpenDocumentDialog(string argCaption, bool argllowMultiSelect, ref string argPath, int argFilterKind, int argFilterIndex, out IStrings argDocumentPaths);

Parameter	Type	Passing
argCaption	string	value
argllowMultiSelect	bool	value
argPath	string	ref
argFilterKind	TFilterKind	value
argFilterIndex	int	value
argDocumentPaths	IStrings	out

Returns: bool

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_SetNavigationZoomPrecision

No description yet.

void DM_SetNavigationZoomPrecision(int argZoomPrecision);

Parameter	Type	Passing
argZoomPrecision	int	value

Returns: nothing (void)

DM_SetRecoveryParameters

Set the interval when the autosave / recovery mechanism in Altium Designer kicks in. The interval is in minutes, and whether to enable the recovery mechanism.

void DM_SetRecoveryParameters(bool argIsEnabled, int argInterval);

Parameter	Type	Passing
argIsEnabled	bool	value
argInterval	int	value

Returns: nothing (void)

DM_SetRightClickCompStructure

No description yet.

void DM_SetRightClickCompStructure(string argProjectPath, string argLibReference, string argUniqueId);

Parameter	Type	Passing
argProjectPath	string	value
argLibReference	string	value
argUniqueId	string	value

Returns: nothing (void)

DM_ShowMessageView

Invoke this method to refresh the Message panel.

void DM_ShowMessageView();

Returns: nothing (void)

DM_ShowProject

No description yet.

void DM_ShowProject(string argProjectPath);

Parameter	Type	Passing
argProjectPath	string	value

Returns: nothing (void)

DM_ShowToDoList

This method displays the To Do List manager panel. This To Do List panel can be used to define your To Dos.

void DM_ShowToDoList();

Returns: nothing (void)

DM_ViolationTypeDescription

Returns the violation type description string with the error kind value passed in. Check the TErrorKind for its range of values.

string DM_ViolationTypeDescription(TErrorKind argErrorKind);
string DM_ViolationTypeDescription(int argErrorKind);

Parameter	Type	Passing
argErrorKind	TErrorKind	value

Returns: string

The first overload is an extension method of IWorkspaceHelper (using EDP;) with typed parameters; the second is declared by the interface.

DM_ViolationTypeGroup

Returns the error group for which this error kind parameter belongs to. Check the TErrorGroup type for its range of values.

TErrorGroup DM_ViolationTypeGroup(TErrorKind argErrorKind);

Parameter	Type	Passing
argErrorKind	TErrorKind	value

Returns: TErrorGroup

Extension method of IWorkspaceHelper (using EDP;).

DM_WorkspaceFileName

Returns the filename only of the workspace.

string DM_WorkspaceFileName();

Returns: string

DM_WorkspaceFullPath

Returns the full path of the workspace.

string DM_WorkspaceFullPath();

Returns: string

Inherited members

• From IDMObject: DM_CalculateParameterValue, DM_CurrentSheetInstanceNumber, DM_FullCrossProbeString, DM_GeneralField, DM_GetVCSProject, DM_ImageIndex, DM_IsFormulaString, DM_IsInferredObject, DM_LocationString, DM_LocationX, DM_LocationY, DM_LongDescriptorString, DM_NetIndex_Flat, DM_NetIndex_Sheet, DM_NetIndex_SubNet, DM_ObjectKindString, DM_ObjectKindStringForCrossProbe, DM_OwnerDocument, DM_OwnerDocumentFullPath, DM_OwnerDocumentName, DM_ParameterCount, DM_Parameters, DM_PcbHandle, DM_PCBObjectHandle, DM_PCBObjectInterface, DM_PrimaryCrossProbeString, DM_SchHandle, DM_SCHObjectHandle, DM_SCHObjectInterface, DM_SecondaryCrossProbeString, DM_SetVCSProject, DM_SheetIndex_Logical, DM_SheetIndex_Physical, DM_ShortDescriptorString, DM_ValidForNavigation, DM_VHDLEntity

Examples

Used in the SDK examples: Ciiva, Ciiva, Extension_AddVariant, Extension_CreateProject, Extension_CreateVariantComponent, Extension_GenerateGerber, Extension_HierarchicalDesign, Extension_IComponent_To_ISch_Component, Extension_RefreshDocument, Extension_SchTemplate, Extension_TestPortHarnessDev, Extension_VariantOptions.