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.

MC variable

values

default value

description

pbar_bg

text

-

Set the shutdown progress bar dialog background image.

Can be relative (e.g. splash.jpg) or absolute (c:\...\splash.jpg)

Note: this setting will always override an existing image with name panagenda_splash.png or panagenda_splash_light.png in the notes clients data directory.

pbar_classic_style

0,1

0

enable the old progress bar dialog style

pbar_content_bottom

numeric

0

value in pixels from bottom to reserve if background has a special format or fixed content that otherwise would be overlapped by progress bars

pbar_content_top

numeric

0

value in pixels from top to reserve if background has a special format or fixed content that otherwise would be overlapped by the logo.

pbar_font_color (=>5.08)

RGB

254,254,254

is reserved

-

Set the font color in RGB style. e.g. 255,255,255

pbar_logo

text

-

Note: this setting will always override an existing image with name panagenda_logo.png in the notes clients data directory.

pbar_refresh_interval

numeric

20

refresh interval of the progress bar in milliseconds

pbar_shutdown_enabled

0,1

0

Enable the shutdown progress bar

pbar_shutdown_header

text

Please wait...

set the progress bar shutdown header

pbar_textshow

0,1

0

Show detailed informations about the current progress above the progress bar