Export (0) Print
Expand All

Windows Live Photo Gallery Publishing Plug-in Registry Settings

The client Windows Live application discovers installed publishing plug-ins by enumerating registry keys in the following location.

HKEY_LOCAL_MACHINE
   \SOFTWARE
      \Microsoft
         \Windows Live
            \PublishPlugins

The name of a publishing plug-in's key is not visible to the user. Each key corresponds to one plug-in and contains the following values:

  • AssemblyPath - The full path to your plug-in assembly. REG_SZ; required.
  • ClassName - The fully qualified class name of your plug-in, including any namespaces. REG_SZ; required.
  • FriendlyName - The display name for the plug-in; this value is displayed on the Publish menu. REG_SZ; required.
  • IconPath - The path and resource ID for an icon to display with your plug-in. REG_SZ; optional.
  • SupportedMediaTypes - The type of media that is supported by the plug-in. Valid values are "Image", "Video", and "Both". Any other value will default to "Both". REG_SZ; optional.
  • MaxItemCount - The maximum number of items that the plug-in can publish in a session. REG_DWORD; optional.
  • MaxFileSize - The maximum file size, in bytes, that the plug-in can publish in a session. REG_DWORD; optional.
  • MaxVideoDuration - The maximum video duration, in milliseconds, that the plug-in can publish in a session. REG_DWORD; optional.

You can also set the default parameters for a plug-in by setting the HKLM\Software\Microsoft\Windows Live\PublishPlugins\PluginId\DefaultParameters registry key. The following table describes the configurable values for this key.

Value Type Description

MaxPhotoWidth

REG_DWORD

The default resolution width to which images will be set when they are converted from one image format to another, or transcoded, while preserving the aspect ratio. A value of 0 indicates that the original size will be used.

MaxPhotoHeight

REG_DWORD

The default resolution height to which to transcode images while preserving aspect ratio. A value of 0 indicates that the original size will be used.

MaxVideoWidth

REG_DWORD

The default resolution width to which to transcode videos while preserving aspect ratio. A value of 0 indicates that the original size will be used.

MaxVideoHeight

REG_DWORD

The default resolution height to which to transcode videos while preserving aspect ratio. A value of 0 indicates that the original size will be used.

MaxVideoBitrate

REG_DWORD

The default bit rate, in kilobits per second (Kbps), to which to transcode video. A value of 0 indicates that the original bit rate will be used.

MaxVideoFramerate

REG_DWORD

The default frame rate, in frames per 100 seconds, to which to transcode video. 0 indicates that the original frame rate will be used.

PreferredVideoWidth

REG_DWORD

The preferred width of the video to upload.

Typically, programs use PreferredVideoWidth to determine how to encode video before uploading it, and use MaxVideoWidth to determine whether it is necessary to transcode the video.

PreferredVideoHeight

REG_DWORD

The preferred height of the video to upload.

Typically, programs use PreferredVideoHeight to determine how to encode video before uploading it, and use MaxVideoHeight to determine whether it is necessary to transcode the video.

PreferredVideoBitrate

REG_DWORD

The preferred bit rate, in Kbps, of the video to upload.

Typically, programs use PreferredVideoBitrate to determine the bit rate at which the video will be encoded before uploading, and use MaxVideoBitrate to determine whether it is necessary to transcode the video.

PreferredVideoFramerate

REG_DWORD

The preferred frame rate, in frames per 100 seconds, of the video to upload.

Typically, programs use PreferredVideoFramerate to determine the bit rate at which the video will be encoded before uploading, and use MaxVideoFramerate to determine whether it is necessary to transcode the video.

When you create icons for the gallery publishing plug-in, use a 48x48 32-bit Portable Network Graphics (PNG) image type with an 8 bit alpha channel to achieve the highest possible image quality. 16x16, 32x32, 60x60, and 72x72 image types are also supported, but reduce the quality of the icon image. For a particular icon, all of the image types in all sizes must be contained in a single ICO file.

The following example shows a plug-in registry entry that uses the name "Your Publishing Plug-in" for the purpose of demonstration.

HKLM\SOFTWARE\Microsoft\Windows Live\PublishPlugins\YourPublishingPlugin
   AssemblyPath="C:\Program Files\YourPublishingPlugin\YourPublishingPlugIn.dll"
   ClassName="YourPublishingPlugin.PublishPlugin"
   FriendlyName="Your Publishing Plug-in"
   IconPath="C:\Program Files\YourPublishingPlugin\YourPublishingPlugIn.dll,-32512"
   SupportedMediaTypes="Both"
Show:
© 2015 Microsoft