Manipulate and read microscope parameters Sample Clauses

Manipulate and read microscope parameters invoke microscope actions To manipulate microscope parameters, you can in principle use all of the three different ways of writing assignment statements that are already described above (only that for simple properties you do not retrieve interface pointers here). In the following examples, we choose the way of writing that stresses the notion of ‘properties’, because it is the easiest to write and because it is most consistent with the remainder of this help. An example: MyProjection->MagnificationIndex = 5; This statement will set the magnification index to a new value (=5). long MyLong; MyLong = MyProjection->MagnificationIndex; reads the current value of the magnification index into the variable MyLong. ‘Compound’ properties are read and set by using the TEM scripting adapter's ‘utility objects’. Thus IlluminationPtr MyIllumination; VectorPtr MyShift; double MyShiftX; MyIllumination = MyInstrument->Illumination; MyShift = MyIllumination->Shift; MyShiftX = MyShift->X; would read the full 2D-beam shift first and then store its x-component into the variable MyShiftX. Be aware that MyShift contains a copy of the actual beam shift. Thus, if you want to get the new actual beam shift at a later moment in time, you have to ask for MyIllumination->Shift again! Setting compound parameters then works as follows: VectorPtr MyNewShift; MyNewShift = MyIllumination->Shift; MyNewShift->X = 0; MyNewShift->Y = 0; MyIllumination->Shift = MyNewShift; The codes first gets a Vector-object by reading a 2D-property, assigns new values (0,0) and then copies it back, thus setting the beam shift to zero.