t_codeISETPref.m

Matlab preserves information for you in environmental variables.
ISET uses these variables to remember certain preferences.  These
preferences are accessed using the ieSessionGet and ieSessionSet
functions.

See also: t_guiWindowAppearance

Copyright ImagEval Consultants, LLC, 2013

Contents

Check your stored ISET preferences

% At present, there are only a small number of stored preferences.

% Please use the ieSessionGet/Set functions to read and set the
% preferences.

% One variable controls the display of waitbars
ieSessionGet('waitbar')

% A second controls the size of the font in the display windows
ieSessionGet('font size')
ans =

  logical

   0


ans =

    14

The (logical) waitbar preference

% The waitbar preference determines whether or not a waitbar is shown
% during certain potentially long computations.  Examples are various
% oiComputes and sensorComputes.
%
% It is often desirable to have the waitbar suppressed, say you are looping
% through a calculation and just don't want them appearing on your screen
% all the time.
%

% This is a calculation that takes a few seconds.  To see its progress with
% a waitbar, you can run
ieSessionSet('waitbar','on')
s_scielabPatches
drawnow

To suppress the waitbar, you can run

ieSessionSet('waitbar','off')
s_scielabPatches

The font size

% The best font size in the display windows varies enormously across
% platforms.  If the font is too small or large, you can adjust the size in
% most of the windows (e.g., scene, oi, sensor, image).  The adjustment in
% one window will apply to all the windows.  The font size is controlled
% through the preference
ieSessionGet('font size')

% This number is a increment (or decrement) relative to the default fonts
% in the Matlab display windows.  Here is the font size in your current
% scene window
scene = sceneCreate; ieAddObject(scene);
sceneWindow;
drawnow
pause(2)

% To make the font larger, use the pull down  "Edit | Change font size" or
% use this command
d = ieSessionGet('font size');
ieSessionSet('font size',d+2);
sceneWindow
drawnow
pause(2)

% To return it to the previous run
d = ieSessionGet('font size');
ieSessionSet('font size',d-2);
sceneWindow
drawnow
pause(2)
ans =

    14


ans = 

  sceneWindow_App with properties:

                        figure1: [1×1 Figure]
                       FileMenu: [1×1 Menu]
                   menuFileLoad: [1×1 Menu]
                   menuFileSave: [1×1 Menu]
                  menuSaveImage: [1×1 Menu]
                menuFileRefresh: [1×1 Menu]
                  menuFileClose: [1×1 Menu]
                       menuEdit: [1×1 Menu]
              menuEditSceneName: [1×1 Menu]
               menuEditNewScene: [1×1 Menu]
                  menuCopyScene: [1×1 Menu]
                 menuEditDelete: [1×1 Menu]
             menuEditDeleteSome: [1×1 Menu]
                   menuSpectral: [1×1 Menu]
                     menuSPDdiv: [1×1 Menu]
                    menuSPDMult: [1×1 Menu]
          menuEditSetIlluminant: [1×1 Menu]
               menuResampleWave: [1×1 Menu]
       menuEditAdjustMonochrome: [1×1 Menu]
              menuEditTransform: [1×1 Menu]
              menuEditScaleSize: [1×1 Menu]
                       editCrop: [1×1 Menu]
              menuEditTranspose: [1×1 Menu]
                 menuEditRotate: [1×1 Menu]
                  menuEditRotCW: [1×1 Menu]
                 menuEditRotCCW: [1×1 Menu]
                   menuEditFlip: [1×1 Menu]
         menuEditFlipHorizontal: [1×1 Menu]
           menuEditFlipVertical: [1×1 Menu]
               menuEditFontSize: [1×1 Menu]
            menuEditClearWindow: [1×1 Menu]
                 menuEditViewer: [1×1 Menu]
                       PlotMenu: [1×1 Menu]
               menuPlotRadiance: [1×1 Menu]
              menuPlotRadianceE: [1×1 Menu]
              menuPlotRadImGrid: [1×1 Menu]
           menuPlotIllumPhotons: [1×1 Menu]
             menuPlotIlluminant: [1×1 Menu]
        menuPlotIlluminantImage: [1×1 Menu]
            menuPlotReflectance: [1×1 Menu]
             menuPlotImTrueSize: [1×1 Menu]
            menuPlotMultipleRGB: [1×1 Menu]
          menuPlotImageSpectral: [1×1 Menu]
                  menuPlotDepth: [1×1 Menu]
           menuPlotDepthContour: [1×1 Menu]
                      menuScene: [1×1 Menu]
               menuSceneMacbeth: [1×1 Menu]
       menuSceneMacbethTungsten: [1×1 Menu]
            menuSceneMacbethD50: [1×1 Menu]
            menuSceneMacbethD65: [1×1 Menu]
              menuSceneMacbethC: [1×1 Menu]
    menuSceneMacbethFluorescent: [1×1 Menu]
          menuSceneMacbethVisIR: [1×1 Menu]
                 menuSceneLstar: [1×1 Menu]
                 menuScenesTest: [1×1 Menu]
                menuScenesSweep: [1×1 Menu]
                   menuHarmonic: [1×1 Menu]
            menuSceneFreqOrient: [1×1 Menu]
            menuSceneSlantedBar: [1×1 Menu]
             menuSceneZonePlate: [1×1 Menu]
                menuSceneMackay: [1×1 Menu]
          menuSceneCheckerboard: [1×1 Menu]
            menuScenePointArray: [1×1 Menu]
             menuSceneGridLines: [1×1 Menu]
              menuSceneTestLine: [1×1 Menu]
           menuSceneRadialLines: [1×1 Menu]
                    menuUniform: [1×1 Menu]
         menuSceneUniformPhoton: [1×1 Menu]
             menuSceneUniformEE: [1×1 Menu]
                 menuUniformD65: [1×1 Menu]
      menuSceneUniformEESpecify: [1×1 Menu]
      menuSceneUniformBBspecify: [1×1 Menu]
                 menuScenesRamp: [1×1 Menu]
                 menuSceneNoise: [1×1 Menu]
                  menuSceneFile: [1×1 Menu]
             menuSceneMultiSpec: [1×1 Menu]
             menuSceneChooseRGB: [1×1 Menu]
         menuFileChooseFileMono: [1×1 Menu]
                         menuAn: [1×1 Menu]
                menuAnalyzeLine: [1×1 Menu]
               menuAnalyzeLineH: [1×1 Menu]
               menuAnalyzeLineV: [1×1 Menu]
               menuAnalyzeLFFTH: [1×1 Menu]
               menuAnalyzeLFFTv: [1×1 Menu]
            menuAnalyzeLineWave: [1×1 Menu]
                 menuAnalyzeLWH: [1×1 Menu]
                 menuAnalyzeLWV: [1×1 Menu]
                 menuAnalyzeROI: [1×1 Menu]
                  menuLuminance: [1×1 Menu]
        menuAnalyzeChromaticity: [1×1 Menu]
                  menPlotLumLin: [1×1 Menu]
                  PlotLuminance: [1×1 Menu]
            menuAnIlluminantCCT: [1×1 Menu]
                       menuHelp: [1×1 Menu]
       menuHelpSceneProgrammers: [1×1 Menu]
              menuHelpProgGuide: [1×1 Menu]
               menuHelpAppNotes: [1×1 Menu]
                        UITable: [1×1 Table]
                          Panel: [1×1 Panel]
                     txtMessage: [1×1 Label]
                        Panel_2: [1×1 Panel]
                    popupRender: [1×1 DropDown]
                         text21: [1×1 Label]
                txtDisplayGamma: [1×1 Label]
                      editGamma: [1×1 EditField]
                        btnPrev: [1×1 Button]
                        btnNext: [1×1 Button]
               popupSelectScene: [1×1 DropDown]
                     sceneImage: [1×1 UIAxes]
                 MoreinfoButton: [1×1 Button]
                 boxDescription: [1×1 ButtonGroup]
            txtSceneDescription: [1×1 Label]
                       boxScene: [1×1 ButtonGroup]
                           txtM: [1×1 Label]
                        txtDist: [1×1 Label]
                   editDistance: [1×1 EditField]
                         txtDeg: [1×1 Label]
                         txtFOV: [1×1 Label]
                     editHorFOV: [1×1 EditField]
                        txtCDM2: [1×1 Label]
                         txtLum: [1×1 Label]
                  editLuminance: [1×1 EditField]
                      imageMenu: [1×1 ContextMenu]
                 HorLumLineMenu: [1×1 Menu]
                    RefreshMenu: [1×1 Menu]


ans = 

  sceneWindow_App with properties:

                        figure1: [1×1 Figure]
                       FileMenu: [1×1 Menu]
                   menuFileLoad: [1×1 Menu]
                   menuFileSave: [1×1 Menu]
                  menuSaveImage: [1×1 Menu]
                menuFileRefresh: [1×1 Menu]
                  menuFileClose: [1×1 Menu]
                       menuEdit: [1×1 Menu]
              menuEditSceneName: [1×1 Menu]
               menuEditNewScene: [1×1 Menu]
                  menuCopyScene: [1×1 Menu]
                 menuEditDelete: [1×1 Menu]
             menuEditDeleteSome: [1×1 Menu]
                   menuSpectral: [1×1 Menu]
                     menuSPDdiv: [1×1 Menu]
                    menuSPDMult: [1×1 Menu]
          menuEditSetIlluminant: [1×1 Menu]
               menuResampleWave: [1×1 Menu]
       menuEditAdjustMonochrome: [1×1 Menu]
              menuEditTransform: [1×1 Menu]
              menuEditScaleSize: [1×1 Menu]
                       editCrop: [1×1 Menu]
              menuEditTranspose: [1×1 Menu]
                 menuEditRotate: [1×1 Menu]
                  menuEditRotCW: [1×1 Menu]
                 menuEditRotCCW: [1×1 Menu]
                   menuEditFlip: [1×1 Menu]
         menuEditFlipHorizontal: [1×1 Menu]
           menuEditFlipVertical: [1×1 Menu]
               menuEditFontSize: [1×1 Menu]
            menuEditClearWindow: [1×1 Menu]
                 menuEditViewer: [1×1 Menu]
                       PlotMenu: [1×1 Menu]
               menuPlotRadiance: [1×1 Menu]
              menuPlotRadianceE: [1×1 Menu]
              menuPlotRadImGrid: [1×1 Menu]
           menuPlotIllumPhotons: [1×1 Menu]
             menuPlotIlluminant: [1×1 Menu]
        menuPlotIlluminantImage: [1×1 Menu]
            menuPlotReflectance: [1×1 Menu]
             menuPlotImTrueSize: [1×1 Menu]
            menuPlotMultipleRGB: [1×1 Menu]
          menuPlotImageSpectral: [1×1 Menu]
                  menuPlotDepth: [1×1 Menu]
           menuPlotDepthContour: [1×1 Menu]
                      menuScene: [1×1 Menu]
               menuSceneMacbeth: [1×1 Menu]
       menuSceneMacbethTungsten: [1×1 Menu]
            menuSceneMacbethD50: [1×1 Menu]
            menuSceneMacbethD65: [1×1 Menu]
              menuSceneMacbethC: [1×1 Menu]
    menuSceneMacbethFluorescent: [1×1 Menu]
          menuSceneMacbethVisIR: [1×1 Menu]
                 menuSceneLstar: [1×1 Menu]
                 menuScenesTest: [1×1 Menu]
                menuScenesSweep: [1×1 Menu]
                   menuHarmonic: [1×1 Menu]
            menuSceneFreqOrient: [1×1 Menu]
            menuSceneSlantedBar: [1×1 Menu]
             menuSceneZonePlate: [1×1 Menu]
                menuSceneMackay: [1×1 Menu]
          menuSceneCheckerboard: [1×1 Menu]
            menuScenePointArray: [1×1 Menu]
             menuSceneGridLines: [1×1 Menu]
              menuSceneTestLine: [1×1 Menu]
           menuSceneRadialLines: [1×1 Menu]
                    menuUniform: [1×1 Menu]
         menuSceneUniformPhoton: [1×1 Menu]
             menuSceneUniformEE: [1×1 Menu]
                 menuUniformD65: [1×1 Menu]
      menuSceneUniformEESpecify: [1×1 Menu]
      menuSceneUniformBBspecify: [1×1 Menu]
                 menuScenesRamp: [1×1 Menu]
                 menuSceneNoise: [1×1 Menu]
                  menuSceneFile: [1×1 Menu]
             menuSceneMultiSpec: [1×1 Menu]
             menuSceneChooseRGB: [1×1 Menu]
         menuFileChooseFileMono: [1×1 Menu]
                         menuAn: [1×1 Menu]
                menuAnalyzeLine: [1×1 Menu]
               menuAnalyzeLineH: [1×1 Menu]
               menuAnalyzeLineV: [1×1 Menu]
               menuAnalyzeLFFTH: [1×1 Menu]
               menuAnalyzeLFFTv: [1×1 Menu]
            menuAnalyzeLineWave: [1×1 Menu]
                 menuAnalyzeLWH: [1×1 Menu]
                 menuAnalyzeLWV: [1×1 Menu]
                 menuAnalyzeROI: [1×1 Menu]
                  menuLuminance: [1×1 Menu]
        menuAnalyzeChromaticity: [1×1 Menu]
                  menPlotLumLin: [1×1 Menu]
                  PlotLuminance: [1×1 Menu]
            menuAnIlluminantCCT: [1×1 Menu]
                       menuHelp: [1×1 Menu]
       menuHelpSceneProgrammers: [1×1 Menu]
              menuHelpProgGuide: [1×1 Menu]
               menuHelpAppNotes: [1×1 Menu]
                        UITable: [1×1 Table]
                          Panel: [1×1 Panel]
                     txtMessage: [1×1 Label]
                        Panel_2: [1×1 Panel]
                    popupRender: [1×1 DropDown]
                         text21: [1×1 Label]
                txtDisplayGamma: [1×1 Label]
                      editGamma: [1×1 EditField]
                        btnPrev: [1×1 Button]
                        btnNext: [1×1 Button]
               popupSelectScene: [1×1 DropDown]
                     sceneImage: [1×1 UIAxes]
                 MoreinfoButton: [1×1 Button]
                 boxDescription: [1×1 ButtonGroup]
            txtSceneDescription: [1×1 Label]
                       boxScene: [1×1 ButtonGroup]
                           txtM: [1×1 Label]
                        txtDist: [1×1 Label]
                   editDistance: [1×1 EditField]
                         txtDeg: [1×1 Label]
                         txtFOV: [1×1 Label]
                     editHorFOV: [1×1 EditField]
                        txtCDM2: [1×1 Label]
                         txtLum: [1×1 Label]
                  editLuminance: [1×1 EditField]
                      imageMenu: [1×1 ContextMenu]
                 HorLumLineMenu: [1×1 Menu]
                    RefreshMenu: [1×1 Menu]

Finally, you can see the pref list using the Matlab command getpref

iePref = getpref('ISET')

% But don't do it directly.  Use ieSessionSet/Get as above.
ieSessionGet('waitbar')
% And ...
ieSessionSet('waitbar','on')
iePref = 

  struct with fields:

                        initclear: 0
                          waitbar: 0
                        fontDelta: 8
                             wPos: {7×1 cell}
                         fontSize: 14
                 maxSearchResults: 20
                  openRGBwavelist: [400 410 420 430 440 450 … ] (1×31 double)
                    keepDownloads: 0
                   benchmarkstart: 2.7182e+04
    maxSharingSiteImageResolution: 512
                           wState: {[]  'normal'  'normal'  'normal'  'normal'}
                      customicons: 0
                           tStart: 369376814742920
                     tvsceneStart: 369376836180610
                        useSingle: 1
                      tvsceneTime: 45.2016
                    tvopticsStart: 369114618304515
                     tvopticsTime: 29.2217
                    tvsensorStart: 369143860666969
                     tvsensorTime: 25.4201
                     tvpixelStart: 369169301584421
                      tvpixelTime: 3.9278
                     tvhumanStart: 369173251195648
                      tvhumanTime: 14.1937
                        tvipStart: 369187467012507
                         tvipTime: 7.8952
                   tvmetricsStart: 369195384498678
                    tvmetricsTime: 35.5002
                   tvdisplayStart: 369230972961491
                    tvdisplayTime: 6.6743
                         fastAxes: 0
                  fast_num2string: 0
                        tvciStart: 369230907627415
                         tvciTime: 0.0434


ans =

     0

End