Type: BCS.Sym3.IResourceImageManager

Image manager Remarks: Available in Operator only

Properties

BaseProject

  • Description: Gets the project
  • Type: IBaseProject
  • Access: Read

Count

  • Description: Get number of objects
  • Type: Int32
  • Access: Read

DisplayTypeName

  • Description: Gets the display name of the type name of the object. It returns the english display name of the type name.
  • Type: String
  • Access: Read

Id

  • Description: Gets the globally unique identifier (GUID) id of the object. This unique identifier is generated once at the object creation. This id will be kept unique for the entire life of the object, event after saving/loading the project.
  • Type: Guid
  • Access: Read and Write
  • Example:
This example shows how to get the id of an object in a string format. The following script will output a string like 'b3122ae0-dcf7-43b6-b17c-5381afaca5cb'


            strid = Project.Colors.Get("myColor").Id.ToString();
            print(strid)

ManagedObjectType

  • Description: Gets the .Net type of the object that this manager is managing.
  • Type: Type
  • Access: Read

Name

  • Description: Gets or sets the name of the object. All objects of the same type have a unique name.
  • Type: String
  • Access: Read and Write
  • Example:
This example shows how to get and set the name of an object.


            // get the color name
            colorname = Project.Colors.Get("myColor").Name;
            
            // set the color name
            Project.Colors.Get("myColor").Name = "myNewName";

NameSuffix

  • Description: The project explorer will display this after the Name of this object.
  • Type: String
  • Access: Read

Objects

  • Description: Gets the list of objects
  • Type: ObservableCollection`1
  • Access: Read
  • Example:
This example shows how to loop through every object of the manager


            count = Project.Colors.Count;
            for(i=0; i<count; i++)
            {
                print(Project.Colors.Objects[i].Name);
            }
            
            print("USING INDEXERS:")
            for(i=0; i<count; i++)
            {
                // a better practive to access an object is by using indexers:
                print(Project.Colors[i])
            }

TypeName

  • Description: Gets the typename of the object. A type name doesn’t contain any space characters.
  • Type: String
  • Access: Read

UserPropertyInstances

  • Description: Gets a list of all the instances of user properties.
  • Type: ObservableCollection`1
  • Access: Read

Methods

Add(BCS.IBaseObject)

Adds an object in the manager. The object has to be of the correct type.

  • Parameters:
    • value: Object to add

ExportCSV(System.String,System.Char)

Export object to a ‘character’ seperated value text file. By default it will a comma so the exported file will be a CSV

  • Parameters:
    • filename: File name to export to (full path)
    • splitter: Character to use as a splitter - By default il will be a comma
  • Example:
This example shows how to export a CSV and TSV


            // Export in CSV (Comma Separated Values)
            Project.Texts.ExportCSV("C:\\Temp\\Test.csv", ',')
            
            // Export in TSV (Tab Separated Values)
            Project.Texts.ExportCSV("C:\\Temp\\Test.tsv", '\t')

ForceRename(System.String,System.Boolean)

Rename the object.

  • Parameters:
    • value: The new name.
    • fireChangingEvent: If false, no change event will fire. In particular, this disables the check for duplicate names, which can be costly as it has to check every equipment. The caller is responsible for ensuring that value is a unique name, or Bad Things will happen.

FromXmlString(BCS.IToolXmlToObjectHelper)

Init object from IToolXmlToObjectHelper. All properties found in the RootElement of IToolXmlToObjectHelper will be set with the value in the rootElement

  • Parameters:
    • xmlHelperObj: xmlHelperObj IToolXmlToObjectHelper

FromXmlString(System.String)

Init object from xml. All properties found in the xml will be set with the value in the xml file

  • Parameters:
    • xmlText: Xml string

FromXmlString(System.Xml.Linq.XElement)

Init object from root element. All properties found in the XElement will be set with the value in the XElement

  • Parameters:
    • objXml: objXml XElement

Get(System.String)

Gets an object by its name. A better way to access an object is by using indexer. See example.

  • Parameters:
    • id: Name of the object to find
  • Returns:
    • Returns the object. Will return null if the object is not found.
  • Example:
This example shows how to find an object by its name. This example is using the 'Get' method but also shows how to use indexer operator.


            myManager = Project.Colors;
            myColor = myManager.Get("Sym3 Red");
            
            // using the indexer. It is shorter but executes the same code behind the scene.
            myColor = myManager["Sym3 Red"];

GetById(System.Guid)

Gets an object by its unique ID. A better way to access an object is by using indexer. See example.

  • Parameters:
    • id: Unique ID of the object to find
  • Returns:
    • Returns the object. Will return null if the object is not found.
  • Example:
This example shows how to find an object by its id. This example is using the 'GetById' method but also shows how to use indexer operator.


            id = ... // lets say we have an Id
            myManager = Project.Colors;
            myColor = myManager.GetById(id);
            
            // using the indexer. It is shorter but executes the same code behind the scene.
            myColor = myManager[id];

GetCopyPasteXml

Converts the object into an XML string including overrides for for copy/paste functionality

  • Returns:
    • the string that contains xml version of the object for copy/paste

GetUserPropertyInstance(System.String)

Gets the user property instance of the specified name

  • Parameters:
    • userPropertyName: The user property name.
  • Returns:
    • Returns the user property instance object. If not found, the methods returns null.
  • Example:
This example shows how to set the value of a user property by using this method


            cc1 = Project.Equipment.Get("CC1");
            
            // get the value of a user property using the method
            userPropertyInstance = cc1.GetUserPropertyInstance("UserProperty1");
            if(userPropertyInstance != null) {
               userPropertyInstance.Value = 3;
            }

GetUserPropertyValue(System.String)

Gets the value of a user property. A better way to get the value of a user property is to use the indexer operator [], see example. Instead of using the method ‘GetUserPropertyInstance’ and then access the ‘Value’ property of the returned value, this method simplifies the way we get the value of a user property.

  • Parameters:
    • userPropertyName: The name of the user property to set.
  • Returns:
    • Returns null if user property is not found. Otherwise returns the value of the user property.
  • Example:
This example shows how to get the value of a user property using this method and also by using the indexer


            cc1 = Project.Equipment.Get("CC1");
            
            // get the value of a user property using the method
            val = cc1.GetUserPropertyValue("UserProperty1");
            
            // get the value of a user property using the indexer operator
            val = cc1["UserProperty1"];

ImportCSV(System.String,System.Char)

Import a ‘character’ separated value file

  • Parameters:
    • filename: Name of file to import
    • splitter: Character to use as a splitter - By default il will be a comma

IsUserProperty(System.String)

Indicates if the object contains a user property with the name you specify

  • Parameters:
    • userPropertyName: user property name
  • Returns:
    • Returns true if the object contains a user property with the name you specified in parameter.

New

Creates a new object of the specified type. For example if the manager is a IResourceColorManager, a color will be created. A default name will be automatically generated.

  • Returns:
    • Returns the newly created object. Will be null if an error occured.

New(System.String)

Creates a new object of the specified type. For example if the manager is a IResourceColorManager, a color will be created.

  • Parameters:
    • name: Specifies the name of the object that will be created.
  • Returns:
    • Returns the newly created object. Will be null if an error occured.

NewFromFile(System.String)

Creates a new image from an image file on the disk (.jpg; .png; .gif; .bmp)

  • Parameters:
    • filePath: Image file on the disk (.jpg; .png; .gif; .bmp)
  • Returns:
    • The newly created image object

Remove(BCS.IBaseObject)

Removes an object from the manager

  • Parameters:
    • value: Object to remove

RemoveAll

Remove all objects from the manager. The manager will be empty after execution.

RemoveMultiple(System.Collections.ICollection)

Removes an collection of object from the manager

  • Parameters:
    • value: The collection of object to remove

RemoveSilentlyBecauseSomethingIsNotRight(BCS.IBaseObject)

Removes an object from the manager without calling events

  • Parameters:
    • value: Object to remove

SetUserPropertyValue(System.String,System.Object)

Sets the value of a user property. A better way to set the value of a user property is to use the indexer operator [], see example. Instead of using the method ‘GetUserPropertyInstance’ and then access the ‘Value’ property of the returned value, this method simplifies the way we set the value of a user property.

  • Parameters:
    • userPropertyName: The name of the user property to set.
    • value: If the user property is not found, this methods does nothing.
  • Example:
This example shows how to set the value of a user property using this method and also by using the indexer


            cc1 = Project.Equipment.Get("CC1");
            
            // set the value of a user property using the method
            cc1.SetUserPropertyValue("UserProperty1", 3);
            
            // set the value of a user property using the indexer operator
            cc1["UserProperty1"] = 3;

ToCSVString(System.Char)

Returns the object in a CSV string.

  • Returns:
    • A string that contains properties of the object in a CSV format.

ToXmlString

Converts the object in an xml string

  • Returns:
    • the string that contains xml version of the object

Examples:

//******************************************************************************
// HOW TO : Images
//******************************************************************************


//------------------------------------------------------------------------------
// How to create
//------------------------------------------------------------------------------

// create a new entity
var newEntity = Project.Images.NewFromFile("C:\\temp\\MyImage.jpg")
print("A new entity has been created with default name: " + newEntity.Name)



//------------------------------------------------------------------------------
// How to access entity
//------------------------------------------------------------------------------

// get by name using method 'Get'
var entity1 = Project.Images.Get("Image1")
print("Get entity by name: " + entity1.Name)

// get by name using operator []
var entity2 = Project.Images["Image1"]
print("Get entity by name: " + entity2.Name)

// get by index:
var entity3 = Project.Images[1]
print("Get entity by index: " + entity3.Name)


//------------------------------------------------------------------------------
// How to loop
//------------------------------------------------------------------------------


var entities = Project.Images.Objects;
for (var i = 0; i < Project.Images.Count; i++) {
    
    print(entities[i].Name);
}


//------------------------------------------------------------------------------
// How to delete
//------------------------------------------------------------------------------

// remove entity
Project.Images.Remove(newEntity)


//------------------------------------------------------------------------------
// How to edit
//------------------------------------------------------------------------------

var entityToEdit = Project.Images.NewFromFile("C:\\temp\\MyImage.jpg")

// change properties:
entityToEdit.Name = "MyNewImageName";

// get dimension:
var w = entityToEdit.Width;
var h = entityToEdit.Height;

print("Width = " + w);
print("Height = " + h)