Shutdown progress bar

How to activate ?

The shutdown progress bar must be activated in a mc ini action by setting pbar_shutdown_enabled to 1.

Also on the When tab set the Repeat option to Persistent (needed for mc variables)

The background and logo can be activated by

1. setting in the mc action
   
   the location can be either relative, then it must be placed in the notes client data directory or absolute e.g. c:\notes\client\images\logo.jpg
   
2. by using fixed names for the background and/or logo image
   Please note: pbar_bg and pbar_logo will always override existing images in the notes clients data directory.
   Also pbar_shutdown_enabled must be set via mc action. Else the progress bar won't show up
   Fixed file names supported:
   panagenda_splash.png (the background image with white text color)
   or
   panagenda_splash_light ( the background image with black text color)
   A Panagenda_splash.png logo will be always checked/used first
   Format can be also bmp and jpg, but must have the png extension → panagenda_splash.png
   panagenda_logo.png the logo image

Format and dimensions of the background and logo

MC supports many different formats e.g. (bmp, jpg and png). CMYK JPG format may be non functional up to 5.5.20.

The background image will be centered on screen. The logo will be scaled so that it fills 85% of the width from the background. The height depends of the background logo and the apect ratio of the logo itself. We always keep the aspect ratio intact. The optimal width depends on the background image used.

Example:

Background image dimensions are 800x600. Logo dimensions are 640x350. Logo aspect ratio = 1,82. 800*0,85(85% of width) = 680 → new width. New height = 680/1,82=374

The company logo looks pixelated and or details are missing

From mc 5.5.21 on images will be smoothed / interpolated in high quality for image scaling to fit the given background dimensions.

Workaround for older versions: Manual dimension conversion of the logo in a paint program

Example:

Background image dimensions are 800x600. Logo dimensions are 640x350. Logo aspect ratio = 1,82. 800*0,85(85% of width) = 680 → new width. New height = 680/1,82=374

Some images don't work

Error message in the mc log.xml <le><t>946715</t><l>0</l><i>5</i><c>ERROR</c><f>UI::PBarDialog_Impl::DialogThread</f><m>UI::CustomBaseDialog::CreateScaledImage: could not create scaled image. gdi+ errorcode 2</m></le>

This is due to the lacking support of CMYK format in Microsoft's Gdiplus library.

From 5.5.21 on mc also supports CMYK jpg images

A workaround for older mc versions is to save in RGB/ARGB/PARGB jpg format or in bmp.

The Progress bar won't show up or will display the default background/logo

Please have a look to mc log.xml

This is the normal log output of the shutdown progress bar

<le><t>14234818</t><l>2</l><f>UI::ProgressBar_Impl::Init</f><m>progress bar is enabled</m></le>
<le><t>14234818</t><l>2</l><f>UI::PBarDialog_Impl::PBarDialog_Impl</f><m>creating progress bar dialog</m></le>
<le><t>14234818</t><l>0</l><i>7</i><m>new thread detected; boost ID: 'd114' OS thread ID: '53524'</m></le>
<le><t>14234818</t><l>2</l><i>7</i><f>PGT::Thread::ThreadFunc</f><m>thread 'progress bar dialog': started</m></le>
<le><t>14234898</t><l>2</l><f>UI::PBarDialog_Impl::PBarDialog_Impl</f><m>progress bar dialog created</m></le>

if it fails, then something like this will come up

<le><t>946715</t><l>0</l><i>5</i><c>ERROR</c><f>UI::PBarDialog_Impl::DialogThread</f><m>UI::CustomBaseDialog::CreateScaledImage: could not create scaled image. gdi+ errorcode 2</m></le>

MarveClient will fall back to the default included panagenda background and logo.

All mc variables the shutdown progress bar supports

MC variables can be set in an action. Also When/Repeat has to be set to persistent.