Monthly Archives: March 2007

Using custom logos in ArcGIS Explorer

Mark Bockenhauer of the ArcGIS Explorer team contributed the following post on how to display a custom logo in ArcGIS Explorer.

 

 

It is common with paper maps to display a logo perhaps a company logo or government seal.  The same can be done on digital ArcGIS Explorer maps by leveraging the Home Server.

The Home Server is a user defined server that ArcGIS Explorer connects to when it starts up.  Typically ArcGIS Explorer checks the home server to see if its version is up to date and to get the default map to display.  It does this by referencing information in the ‘explorer’ folder on the server. This folder is part of the ArcGIS Server install.

Download the explorer.zip folder before continuing with this example.  This folder contains example resources for all of the ArcGIS Server Home Server settings that can be applied to ArcGIS Explorer.

Once you have downloaded the file unzip it and place it in the appropriate location on your server.

Default Locations:
.NET  C:InetpubwwwrootArcGISExplorer
JAVA   C:Program FilesArcGISjavaweb_outputExplorer

To display your own custom logo on ArcGIS Explorer applications that specify your server as their home server you will need to modify the following files:

explorerconfige2config.xml
explorerskinsexample_skin_file.xml

In the e2config.xml file the <skins> section is commented out (highlighted in bold below).  Un-comment this section by removing “<!- -“ prior to the section and “- ->” following the section.  You will also want type in the appropriate URL for the <skinurl> tag. 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<E2Config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">

  <Permissions>

    <AddData>true</AddData>

    <OpenDocument>true</OpenDocument>

    <SaveDocument>true</SaveDocument>

    <ManageLayers>true</ManageLayers>

    <ManageTasks>true</ManageTasks>

    <DisplayOptions>true</DisplayOptions>

    <PerformVersionCheck>true</PerformVersionCheck>

    <TaskDownloadInternet>true</TaskDownloadInternet>

    <TaskDownloadLocalIntranet>true</TaskDownloadLocalIntranet>

    <TaskDownloadTrustedSites>true</TaskDownloadTrustedSites>

  </Permissions>

  <!– To use a server skin file, uncomment the 'skins' tags below by removing the exclamation point and hyphens.

     Type your server name into the skin url. The server install contains an example skin file and resources –>

   <!–<skins>

        <skinfile>example_skin_file.xml</skinfile>

        <skinurl>http://TYPE_IN_YOUR_SERVER_NAME_HERE/arcgis/explorer/skins/</skinurl>

    </skins>–>

</E2Config>

 

Next we will modify the skin file referenced in the <skins> tags to display the desired logo. In the explorerskinsexample_skin_file you will see that all of the lines are commented out.  You will also notice that there are two sections to the file.  The tags in the upper section all control the ArcGIS Explorer color scheme.  The tags in the lower section pertain to ArcGIS Explorer graphic elements.  Un-comment this section.
 
<!–

    <HUDFont type="Font">Verdana</HUDFont>

    <ApplicationTitle type="Application">ExampleApplicationTitle</ApplicationTitle>

    <DocumentPrefix type="Application">ExampleDocumentPrefix</DocumentPrefix>

    <SplashScreenBitmap type="Application">example_splash_screen.png</SplashScreenBitmap>

    <SplashMessageCoords type="Application">15,200</SplashMessageCoords>

    <DisplayCustomLogo type="Application">example_custom_logo.png</DisplayCustomLogo>

    <DisplayCustomLogoMaskColor type="Application">RGB(255, 0, 255)</DisplayCustomLogoMaskColor>

    <DisplayCustomLogoTransparency type="Application">75</DisplayCustomLogoTransparency>

    <NorthArrowBitmap type="Application">example_north_arrow.png</NorthArrowBitmap>

     –>

At this point if you start ArcGIS Explorer and specify your server as the Home Server, you will see the Example Custom Logo.

Setting the Home Server to your server.
1.    In Explorer, click File > Set Home Server
2.    Click “Connect to the Home Server located at”, then enter the URL to your server in the format http://<server name>/<instance name> (Example: http://myServer/ArcGIS)
3.    Click the Test button to test the connection, or click OK to return to Explorer.
ArcGIS Explorer will restart and apply the Home Server Settings.

To use your own logo you will want to change the .PNG referenced in the <DisplayCustomLogo> tag.  Your .PNG file should be located in the skins folder with the skin file.

Notice that the example logo makes use of the <DisplayCustomLogoMaskColor> to display a rectangular logo.

Actual .PNG on the left, what is displayed on the Right.

  

For more information on making your server the ArcGIS Explorer Home Server see "Making your system an ArcGIS Explorer Home Server" under "Administering the Server" at:  http://webhelp.esri.com/arcgisserver/9.2/dotNet/  
 

Posted in Services | Tagged | Leave a comment