| Export | GetPreferenceValue | Import | IsClassOf  |
| IsEqualTo | RestoreDefault | SaveChanges | SetPreferenceValue |
Object Hierarchy | Related C++ Class: Preferences
Preferences
v4.0
The Preferences object can be used to manage preferences in Softimage. Each preference is in a category
which is represented by a node under the Preferences object under the Application. To identify a
preference the category must be specified: (category.preference) Ex: "scripting.language".
There are 2 kinds of preferences: native and custom. Native preferences come with Softimage and can be
viewed with the File->Preferences dialog. Initially all preference values are set to the factory
defaults. When the user changes the value of a preference the new value is stored in the default.xsipref
file found in the \Data\Preference directory, and this value overrides the factory setting.
For custom preferences, you can create new preferences in an .xsipref file. However, preferences created
this way have no UI and can only be accessed via scripting.
You can also create custom preferences by creating a CustomProperty object and calling
InstallCustomPreferences. The only way to delete such a custom preference is to delete
the associated Preset file that is found in the \Data\Preferences directory.
Note: Unlike native preferences, custom preferences created in this fashion are also loaded from the Workgroup
location.
Only a subset of parameter types are supported for Custom Preferences, they are siInt4, siString, siBool and
siDouble (see siVariantType).
Many custom plug-ins use a CustomProperty as a way of providing a user interface. For example, a plug-in that
exports data may ask the user to choose the output file and other configuration settings by calling
InspectObj with a CustomProperty. Installing such a CustomProperty as a custom preference
can be useful because the values are not forgotten from one session to the next, the object does not clutter
the current scene and the information is centralized in the Preferences section of the Scene Explorer. However,
because of the limitations of supported parameter types it can often be more flexible to achieve the same thing
by calling SavePreset and LoadPreset directly from within the plug-in.
from win32com.client import constants as cns
app = Application
# Get the preferences object on the application
oPrefs = app.Preferences
# Show the current language
app.LogMessage(oPrefs.GetPreferenceValue ("scripting.language"))
# or
app.LogMessage(oPrefs.Categories("scripting").Language.Value)
# Export all data_management preferences
oPrefs.Export( XSIUtils.BuildPath(app.InstallationPath(cns.siFactoryPath), "myDMprefs.xsipref"), "data_management")
# Now reset all preferences of the category data_management
oPrefs.RestoreDefault("data_management")
# Expected results:
# INFO : Python
# INFO : Python |
/*
This example demonstrates how to temporarily change the user's
AutoInspect preference (if enabled, property pages always pop
up for objects newly created via command). It also illustrates
how Softimage automatically reverts any scripting change to this
preference after the script runs.
*/
var app = Application;
// Current value of AutoInspect
app.LogMessage( app.Preferences.GetPreferenceValue("Interaction.autoinspect") );
// Toggle the orginal value and re-log the value
app.Preferences.SetPreferenceValue(
"Interaction.autoinspect",
!app.Preferences.GetPreferenceValue("Interaction.autoinspect")
);
app.LogMessage( app.Preferences.GetPreferenceValue("Interaction.autoinspect") );
// If your AutoInspect preference was enabled originally, the History Log
// would display the following:
// INFO : True
// INFO : False
// VERBOSE : Restoring preference changed by script: Interaction.autoinspect
// If your AutoInspect preference was disabled originally, the History Log
// would display the following:
// INFO : False
// INFO : True
// VERBOSE : Restoring preference changed by script: Interaction.autoinspect |
' This example show how to navigate in preferences object ' All categories and all preferences in each category will be printed. set oPrefs = Application.Preferences set oCategories = oPrefs.categories For each oCategory in oCategories Application.LogMessage "The preferences for category " & oCategory & " are:" set oPreferences = oCategory.Parameters For each oPref in oPreferences Application.LogMessage " -" & oPref & " = " & oPref.Value Next Next ' The script logs information like the following: ' .... ' INFO : The preferences for category preferences.units are: ' INFO : -preferences.units.colorspace = 1 ' INFO : -preferences.units.length = 2 ' INFO : -preferences.units.angle = 2 ' INFO : -preferences.units.time = 2 ' INFO : -preferences.units.mass = 2 ' .... |